docs -> docs-v2 Issue Punchlist

[cycle4passion]

TODO

Site wide Items

1. fix badge on readme for github, Mostly done, just a weird underline showing

2. utilize custom layer for examples where appropriate. Hard for me to know/do.

3. resize={false} isn't supported by the :example

4. Link icon for Headers gets cut off, see H1 on getting started, or step items.

5. Additional frontmatter - Preferred Layer, and default layertoggle per component to that?

6. Sitewide Prev - Next

7. :example{ ... showCode={false}}, always shows code

8. Should there be a default for seriesColors?

9. Page changes sidebar scroll. Would be better appearing more fixed.

10. Command-K Search functionality

11. llms.txt

12. MCP

13. Open in REPL

14. Live examples for all?

15. Mini-docs on hover

16. Show all / Filter missing on some cats?

17. All defined padding switch to getDefaultPadding?

18. SimpleChart support Title, Subtitle, Caption, AxisLabels w/o drilldown in Axis snippet SveltePlot implementation

• x={{data:"Stock Price"}} data is source, "Stock Price" is x Axis label, default color if able from series, same for Y. Default axis label placement like here

GLOBAL

1. Handle markdown in props

1. docs/src/examples/catalog to .gitignore? same for docs/static/screenshots/index.json (after clean refork many files seen as new).

2. Many WARNINGS: 6:36:11 AM [vite-plugin-svelte] src/lib/components/Example.svelte:39:41 This reference only captures the initial value of component. Did you mean to reference it inside a closure instead?

3. Missing "View all" for some like "Bounds", "ChartClipPath", "RectClipPath", many others

4. Many threshold examples (not all) have single weird brown color on canvas layer. See Area/highlight color based on value using color scale

5. skip basic in show alls, as shown as default.

6. LLMs page to docs ala bits-ui

7. SVGAnimateMotionAttributes, SVGImageAttributes, HTMLAttributes, CommonEvents - what is it? vs tooltip

8. Controls overflow - see TreeMap/Stacked-Zoom w/sidebar expanded - overflow-hidden. Better would be Implement wrap to new line, pr slide out settings like done elsewhere

9. when component or primitive set t ouse layer which is not supported, output something to that effect to screen?

10. pnpm package errors

pnpm package 

> layerchart-monorepo@0.0.1 package /Users/sjr/Documents/Shared/Coding/Svelte/layerchart
> pnpm --filter './packages/*' package


> layerchart@2.0.0-next.43 package /Users/sjr/Documents/Shared/Coding/Svelte/layerchart/packages/layerchart
> svelte-package

d.ts type declaration files for the following files were likely not generated due to the following errors:
/Users/sjr/Documents/Shared/Coding/Svelte/layerchart/packages/layerchart/src/lib/components/TransformContext.svelte.ts
  - Exported variable 'TransformContext' has or is using name 'SpringUpdateOpts' from external module "svelte/motion" but cannot be named.
  - Exported variable 'TransformContext' has or is using name 'TweenedOptions' from external module "svelte/motion" but cannot be named.

1. If I choose an example from the examples catalog, The back button to it's root component. If you came there via examples catalog with is unexpected. It's like a browser back button, and after hitting it, I was like "wait, where am I now?"

• Consider 1 button, check referring page (document.referrer I think) If was from examples "< Return to Examples" else "< Return to ????? Component". Just a thought.

1. Partition>Filterable - doesn’t work with canvas (expected). Tooling to support fallback text “Component Partition does not support Canvas” with link to Layers.

• even better components do it automatically alerting user.

1. Consider View data dropdown (Like show code) instead of modal.

2. Go to top

<a href="#top" class="fixed bottom-4 right-4 p-3">
  <LucideArrowUpCircle />
</a>

1. SVG/Canvas/HTML toggle - user-select:none or TW "select-none"

EXAMPLES

Bar Chart (Horizontal) 11/2/25

• "Color-bars-class" - color switches b/w svg/canvas?
• "labels inside placement" - text color change on layer change?

Bar Chart (Vertical) 11/2/25

• "Tooltip and click handlers for individual stack/grouped bar", Group stacked, group & stacked mode is broken

• "fixed position tooltip" and "Within a paragraph with Tooltip and Highlight" too many decimal places shown

Sparkline 11/2/25

• "fixed position tooltip" and "Within a paragraph with Tooltip and Highlight" too many decimal places shown

• "Draggable globe with EdgeFade" switch between svg/canvas seems to change lofts?

Animated Globe

• controls at right are easy to miss, move to left? more padding for controls
• list is not scrolling with playing video any longer.

Components

ArcChart 11/2/25

• Description - "draws a curved segment on a chart to represent portions of a circle, such as in pie or radial charts."
• "Gradient with text" missing export
• Related components/Chart 404

AreaChart 11/2/25

• "Gradient" apply gradient for visibility
• Move "Stack series with separate data" under stack series, calling attention to 2 ways to provide data?
• Sparkline needs more padding-top or overflow for tooltip
• "Markers" add "Click to Add" Marker to bottom of moving tooltip (remove Blockquote)
• "locking and clickable tooltip", nothing in console?
• "Tooltip below chart and hide delay", more padding-bottom or overlfow needed

Area Simple Chart 11/2/25

• Should this be here? redundant for AreaChart?

BarChart 11/2/25

• "Horizontal" Y Axis Labels needs padding, clipped on Canvas
• "Sparkbar" tooltips clipped, needs overflow
• "Single dimension" needs padding-top or overflow for tooltiips
• Move all radials to bottom? preserve like examples
• Point Annotations Larger Point
• "Group series (labels)" more space b/w items of each group so labels don't abut
• Stacked, stacked & grouped, etc not working
• "Range annotation (value)" - no range seen
• Custom Chart emptying shows
• Related: components/Chart 404

LineChart 11/2/25

• "Sparkline" tooltip clipped, allow overlflow like "Sparkline"
• Move Radars x3, "Large radial series" to bottom? interrupts similar examples
• "Axis label inside" add axis y rule to better demonstrate, also add y rule to example above for comparison
• "Draw turning" off show collapses chart, move {#if show} inside chart
• On this page missing?
• Show control broken out ShowControl.svelte.
• components/Chart 404

Piechart 11/2/25

• "Legend placement" seems like a default, move it to somewhere unexpect like top/vertical
• "Segments" move controls to top for consistency, broken out controls PieChartControls.svelte.
• Broken out ShowControls.svelte for "Motion tween", "Motion spring"

ScatterChart 11/2/25

• Missing On This page?
• "series-tween" no different than "series-legend", does it new ShowControl.svelte?
• added blockquote for "domain-nice to md, but does not show if examples shown. Is the right location for this.

Chart 11/9/25

• Feature doesn't jive with any other pages, Remove?
• Missing On This page?

Axis 11/2/25

• slow to load
• "radial grid", "radial rule" - 12 oclock overlapping labels, limit data to prevent?

Frame 11/9/25

• consider changing "Border" Frame to different Color call attention vs Rule - [ ] stroke-danger/5?

Grid 11/9/25

• "tick-count-reponsive" - blank, note

<!-- TODO: Support `tickSpacing` instead (like Axis) -->
<!-- <Chart
	{data}
	x="date"
	y="value"
	yDomain={[0, 100]}
	padding={{ bottom: 20, left: 20, right: 20 }}
	height={100}
>
	<Layer>
		<Grid x xTicks={mdScreen.current ? 10 : 5} />
		<Axis placement="bottom" rule ticks={mdScreen.current ? 10 : 5} />
	</Layer>
</Chart> -->

• Radials to bottom, interrupts similar examples

Legend 11/2/25

• FEAT - gap prop which adds space between label and individual legend items. current label squished into legend items, and "vertical orientation" could use a little y breathing room.
• "Quantile-svelte" has

<!-- TODO: Fix Legend swatches for scaleQuantile -->
<!-- <Legend
      scale={scaleQuantile(randomNormalData, schemeSpectral[9])}
      title="Height (cm)"
      tickFormat="integer"
      variant="swatches"
/> -->

• "Quantize" has

<!-- TODO: Fix Legend swatches for scaleQuantile -->
<!-- <Legend
      scale={scaleQuantize([1, 10], schemePurples[9])}
      title="Unemployment rate (%)"
      variant="swatches"
/> -->

• "sequential-log" has

<!-- TODO: Update Legend to hide swatches/ticks without labels -->
<!-- <Legend
      scale={scaleSequentialLog([1, 100], interpolateBlues)}
      title="Energy (joules)"
      ticks={10}
      variant="swatches"
/> -->

• "threshold" has

<!-- TODO: Fix Legend swatches for scaleThreshold -->
	<!-- <Legend
      scale={scaleThreshold([2.5, 3.1, 3.5, 3.9, 6, 7, 8, 9.5], schemeRdBu[9])}
      title="Unemployment rate (%)"
      variant="swatches"
/> -->

Rule 11/2/25

• HTML layer "Data x range" y axis labels wrapping, persists despite increasing left padding.

Arc 11/9/25

• needs add slight space between Outer Text, Inner Text and arc.
• centroid text of "playground" and "Label-direction" hardcoded black, handle dark/lightmode

Bar

• No view All
• vertical-customize-individual-styles, vertical-grouped-stacked-or-both-transition, vertical-stagger-tween-on-mount, vertical-stagger-tween-on-mount-rounded-edge, vertical-tooltip-and-click-handlers-for-individual-stack-grouped-bar - 404

Circle 11/2/25

• Similar issues to Ellipse below

Connector 11/2/25

Ellipse 11/2/25

• 1 ellipse not filled/changes w/layout?
• Styling using CSS variables - lose colors on canvas
• [ ]

Group 11/8/25

• text moves when HTML selected

Line 11/2/25

• desription "draws a straight line on a chart to represent trends, connections, or boundaries between points." better than CURRENT " element with tweened properties using motionStore"

Marker 11/8/25

• as you know markers dropping in canvas, also HTML
• "styling using CSS variables" no color on HMTL

Polygon - 11/8/25

• y spacing issue in md for Stars/6-20 via ####
• star naming, example 20 points makes a 10 pointed star, change naming?

Rect 11/8/25

Text 1/25/26

• fix truncate in text playground
• "word wrap with explicit n" - rename to "word wrap with explicit LF"

Area 11/7/25

• "Clip tween on mount" - working?
• on this page empty?

Bars (Marker) 11/7/25

• "horizontal with grid on top mix blend" - different color? to better show different between "horizontal with grid on top"
• "horizontal grouped stacked or both transition" and "horizontal tooltip and click handlers for individual stack grouped bar" both had broke controls before breakout controls.
• "horizontal highlight individual bar" - looks like covering up bar.

Calendar 11/7/25

• Multiple years, weird rendering w/canvas
• Make everything responsive except "fixed cell size"?

Hull 11/2/25

• Hull/Geo - pick canvas, text small top right
• Hull/Scatter - pick canvas, no hull
  • comment says ""

Labels 11/7/25

• no view all
• Bars/Horizontal inside labels - canvas -> white text
• Columns/Vertical Inside Labels -> 404
• Columns/Verical Outside Labels -> 404

Link 11/7/25

• No view all
• ForceSimulation/Grpah-playground - issue to rendering before and after split controls - connections not matching points- at times..

Pie 11/7/25

• Pie.md

  • needs y-spacing fix (see Inner Radius Examples)

• Why Partial range (Chart xRange) - small?

Points 11/7/25

Spline 11/7/25

• canvas layer "multiple-series" and "multiple-series-highlight-on-hover" missing marker text - ? info icon with tooltip - " conditionally show w/canvas layer - "canvas limitation"?
• radials to bottom?

Threshold 11/7/25

• "With labels" label position below/above line depeneding on prior?
• different default curve for "with labels"?

Annotation Line 11/7/25

Annotation Point 11/7/25

AnnotationRange 11/7/25

• Change range appearance to be w little more noticeable?

BrushContext 11/7/25

• export data?

Highlight 11/7/25

Tooltip 11/7/25

• Simple Bars - select Highlight axis both and get error - "Error: attribute height: a negative value is not valid" in console

• Position examples - needs block level spacing; probably required tooling change
  |_ Default (...)
  |_Data Snapping
  |_Multiple Tooltips with Fixed Single Axis
  |_Multiple Tooltips with Fixed Single Axis (scaleBand)

Tooltip Context 11/7/25

TransformContext 11/7/25

• Playground -
  • Curve changes do nothing
  • Tweened and show points work?
  • Does it need a show control?
  • center

Voronoi 11/7/25

GeoCircle 11/7/25

GeoContext 11/7/25

GeoEdgeFade 11/7/25

GeoPath 11/7/25

GeoPoint 11/7/25

GeoSpline 11/7/25

GeoTile 11/7/25

GeoVisible 11/725

Graticule 11/7/25

Tile Image 11/7/25

Dagre 11/7/25

Force Simulation 11/7/25

Pack 11/7/25

Partition 11/7/25

Sankey 11/7/25

Tree 11/7/25

Treemap 11/7/25

• For "complex", breakout controls to use TreemapControls.svelte - something to do with root.copy() breaks control reactivity. Left it separated.

Linear Gradient

• patterns cut off as all are wide, add overflow-x-scroll

Pattern - 1/7/25

• patterns cut off as all are wide, add overflow-x-scroll

Radial Gradient 11/7/25

• wider ones like TW colors cut off, add overflow-x-scroll?

ChartClipPath 11/7/25

• brush examples screenshot tall
• "clip tween on mount" tween supposed to work on canvas?

CircleClipPath 11/7/25

• add example

ClipPath 11/7/25

RectClipPath 11/7/25

• "highlight color based on value using color scale" - colors weird on canvas. Same for "highlight color based on value using tooltip slot prop", "threshold with rectclippath", "threshold with rectclippath over under"
• "threshold with rectclippath over under" acts different on canvas switch

Layers

• HTML example

Blur 11/7/25

Bounds 11/7/25

• should this be svg only? Canvas Blank

ColorRamp 11/7/25

MotionPath 2/1/26

• sync-with-draw - add inView from runes to not draw until visible?