Static documentation

Data Visualisation Catalogue Gallery

Rendered markdown notes for the catalogue review, compiler mapping, implementation tracker, and chart method specs.

38 chart methods
10 with reference assets
43 documents

Chart Catalogue Implementation Tracker

This tracker follows the Data Visualisation Catalogue chart types selected for the chart compiler gallery. It is intentionally rough: use it to see whether a chart has documentation, reference assets, a compiler spec, and any remaining faithfulness gaps.

Source review: README.md

Status Key

StatusMeaning
ImplementedPresent in createGalleryChartSpecs() and renderable in the chart compiler gallery.
PartialRenderable, but an important catalogue feature is approximated or missing.
PlannedDocumented and selected, but not implemented in the gallery yet.

Selected Catalogue Charts

ChartStatusGallery idSpec/docReference assetsNotes
Arc DiagramPartialarcDiagramarc-diagram.mdNo local reference asset yetRaw source-target rows compile into ordered nodes and weighted cubic arc paths; richer ordering and directed-edge policies remain follow-ups.
Area GraphImplementedareaGrapharea-graph.mdReference and anatomy PNGsUses a filled path closed to zero plus a separate trend-edge path. Stacked-area behavior remains out of scope.
Bar ChartImplementedbarbar-chart.mdReference and anatomy PNGsExisting rect/band/linear bar example relabeled and positioned as the catalogue bar-chart target.
Box & Whisker PlotImplementedboxWhiskerCompiler gap analysisNo local reference asset yetRaw observations compile to quartile summaries, whiskers, caps, and median marks. Outlier extraction remains a follow-up.
Bubble ChartImplementedbubbleChartbubble-chart.mdReference and anatomy PNGsUses a first-class sqrt scale for area-correct radius mapping.
Bullet GraphImplementedbulletGraphbullet-graph.mdNo local reference asset yetRaw threshold rows compile into qualitative range bands, actual measure bars, and target markers.
CalendarImplementedcalendarcalendar.mdNo local reference asset yetRaw dated rows compile through calendarMonth layout into weekday/week cells with a generated color legend.
Candlestick ChartImplementedcandlestickChartcandlestick-chart.mdNo local reference asset yetRaw ordered dated prices compile through financialInterval into OHLC rows, then render on a time scale as wick lines and candle bodies.
Circle PackingPartialcirclePackingcircle-packing.mdNo local reference asset yetRaw parent-child rows compile through hierarchy and circlePack layout into nested circle geometry; optimal packing remains a follow-up.
Density PlotImplementeddensityPlotdensity-plot.mdNo local reference asset yetRaw observations compile through density into sampled curve rows rendered as a baseline-filled path.
Donut ChartImplementeddonutChartdonut-chart.mdNo local reference asset yetRaw category values compile through polarSectors into annular paths, percentage labels, and legend entries.
Dot Matrix ChartImplementeddotMatrixChartdot-matrix-chart.mdNo local reference asset yetRaw category counts compile through dotMatrix layout into repeated point glyph rows.
Error BarsImplementederrorBarserror-bars.mdNo local reference asset yetRaw grouped observations compile through errorInterval into means and confidence-style bounds.
Gantt ChartImplementedganttChartgantt-chart.mdNo local reference asset yetRaw start/end date rows compile through interval into timeline bars on a generated date axis.
HeatmapImplementedheatmapheatmap.mdReference and anatomy SVGsExisting matrix rect example maps directly to the catalogue chart. Continuous gradients are not implemented; discrete sequential steps are used.
HistogramImplementedhistogramhistogram.mdReference and anatomy PNGsRaw rows compile through bin; bars render on a linear x scale with min/max interval geometry.
Line GraphImplementedlineline-graph.mdReference and anatomy PNGsExisting path and sampled point example maps to the catalogue line graph.
Marimekko ChartImplementedmarimekkoChartmarimekko-chart.mdNo local reference asset yetRaw category/series values compile through mosaic layout into variable-width stacked rectangles.
Multi-set Bar ChartImplementedmultiSetBarmulti-set-bar-chart.mdReference and anatomy PNGsRaw category/series rows compile through grouped layout to produce inner offsets and group centers.
Nightingale Rose ChartImplementednightingaleRoseChartnightingale-rose-chart.mdNo local reference asset yetEqual-angle polarSectors layout derives value-sized radial sector paths from raw category values.
Open-high-low-close ChartImplementedopenHighLowCloseopen-high-low-close-chart.mdNo local reference asset yetReuses the financialInterval OHLC table and renders dated high-low stems with open/close ticks.
Parallel Coordinates PlotImplementedparallelCoordinatesparallel-coordinates-plot.mdNo local reference asset yetRaw multivariate observations compile into per-axis guide rows, ticks, and grouped polyline points.
Pie ChartImplementedpieChartpie-chart.mdNo local reference asset yetRaw category values compile through polarSectors into proportional wedge paths and percentage labels.
Population PyramidImplementedpopulationPyramidpopulation-pyramid.mdNo local reference asset yetRaw positive cohort values compile through diverging layout into signed left/right bars on a symmetric axis.
Proportional Area ChartImplementedproportionalAreaChartproportional-area-chart.mdNo local reference asset yetRaw category values resolve through a sqrt radius scale, with a compiler-generated size legend.
Radar ChartImplementedradarChartradar-chart.mdNo local reference asset yetRaw series/metric rows compile into radial axes, guide rings, closed profile polygons, and vertex points.
Radial Bar ChartImplementedradialBarChartradial-bar-chart.mdNo local reference asset yetRaw category values compile into concentric tracks and value sweep arcs.
Radial Column ChartImplementedradialColumnChartradial-column-chart.mdNo local reference asset yetEqual-angle polarSectors layout derives annular columns with a visible inner baseline.
ScatterplotImplementedscatterplotscatterplot.mdReference and anatomy PNGsUses point glyphs on two linear scales plus a compiler-generated regression path.
Span ChartImplementedspanChartspan-chart.mdNo local reference asset yetRaw paired values compile through interval and render as line spans with endpoint symbols.
Stacked Area GraphImplementedstackedAreaGraphstacked-area-graph.mdNo local reference asset yetRaw period/series rows compile through stack; filled path bands render between generated start and end boundaries.
Stacked Bar GraphImplementedstackedstacked-bar-graph.mdReference and anatomy PNGsExisting stack segment geometry maps directly to the catalogue simple stacked bar. 100 percent stack mode remains a follow-up.
Stream GraphImplementedstreamGraphstream-graph.mdNo local reference asset yetRaw period/series rows compile through stack stream mode; smooth area-band paths render centered flowing layers.
Sunburst DiagramPartialsunburstDiagramsunburst-diagram.mdNo local reference asset yetRaw parent-child rows compile through hierarchy and sunburstSectors layout into annular path sectors.
TimelineImplementedtimelinetimeline.mdNo local reference asset yetDated events render through the first-class time scale and generated date axis.
TimetableImplementedtimetabletimetable.mdNo local reference asset yetRaw day/time events compile into grid cells, day headers, and duration-aware event blocks.
TreemapPartialtreemaptreemap.mdReference and anatomy PNGsFlat raw metric rows compile through a squarified treemap transform; nested hierarchy remains a follow-up.
Tree DiagramPartialtreeDiagramtree-diagram.mdNo local reference asset yetRaw parent-child rows compile through hierarchy, treeNodes, and treeLinks layouts into node/link geometry.
Violin PlotImplementedviolinPlotviolin-plot.mdNo local reference asset yetRaw grouped observations compile through violin layout into mirrored density paths, medians, and IQR guides.

Current Gallery Coverage

The selected catalogue charts are listed first in the compiler gallery via app/src/lib/viz/compiler/gallery-specs.ts:

  1. arcDiagram
  2. areaGraph
  3. bar
  4. boxWhisker
  5. bubbleChart
  6. bulletGraph
  7. calendar
  8. candlestickChart
  9. circlePacking
  10. densityPlot
  11. donutChart
  12. dotMatrixChart
  13. errorBars
  14. ganttChart
  15. heatmap
  16. histogram
  17. line
  18. marimekkoChart
  19. multiSetBar
  20. openHighLowClose
  21. nightingaleRoseChart
  22. parallelCoordinates
  23. pieChart
  24. populationPyramid
  25. proportionalAreaChart
  26. radarChart
  27. radialBarChart
  28. radialColumnChart
  29. scatterplot
  30. spanChart
  31. stackedAreaGraph
  32. stacked
  33. streamGraph
  34. sunburstDiagram
  35. timeline
  36. timetable
  37. treemap
  38. treeDiagram
  39. violinPlot

Existing non-catalogue support surfaces remain after those entries: KPI, generic point stress, overview brush, small multiples, symbol map, and product table.

Next Fidelity Work

PriorityWork
HighAdd richer interval labels for histogram axes and richer calendar/session formatting for temporal axes.
HighGeneralize the grouped-bar layout into nested band scales or broader categorical layout transforms.
HighGeneralize first-pass hierarchy layouts into reusable stratify/tree/partition/pack families with stronger layout policies.
HighExtend calendar, mosaic, dot-matrix, bullet, parallel-coordinate, and timetable layouts with ordering, responsive packing, and label-hiding policies.
MediumGeneralize radar, radial-bar, and arc-diagram layouts into broader polar-coordinate and edge-list layout families.
MediumAdd richer legend layouts, including continuous color ramps and collision-aware placement.
MediumAdd 100 percent normalization mode coverage to stacked bar and stacked area gallery examples.
MediumAdd richer path interpolation policies beyond the first smooth/step pass, including stream-specific ordering/baseline policies.
MediumAdd financial/session formatting for Candlestick and OHLC charts, and date-span support for Span Chart.
MediumAdd polar guide rings, polar labels, and collision policies for pie/donut/radial sector charts.
MediumUpgrade treemap layout from flat squarified rows to nested hierarchy rows.
LowAdd local reference/anatomy assets for newly added box, Gantt, population pyramid, proportional area, stacked area, stream, error bars, candlestick, OHLC, span, density, timeline, pie, donut, Nightingale rose, radial bar, radial column, radar, arc diagram, violin, bullet, parallel-coordinate, timetable, circle packing, sunburst, and tree examples.

Verification Log

DateCheckResult
2026-05-11pnpm -C app type-checkPassed.
2026-05-11Browser smoke test at http://localhost:3004/_internal/chart-compilerPassed: all selected chart labels from that pass were present.
2026-05-11Browser smoke test for selected detail routesPassed: every selected route rendered data layers and no browser console errors were reported.
2026-05-11Visual pass at http://localhost:3003/_internal/chart-compiler/*Corrected numeric path sorting, removed line-graph area fill, changed bar chart to vertical columns, tightened and recolored histogram bins, and adjusted bubble/grouped/stacked colors toward the catalogue samples.
2026-05-11pnpm -C app type-check after visual correctionsPassed.
2026-05-11Axis math and rendering passFixed round tick domains so y-grid intervals render evenly, added x-axis guide lines/labels to cartesian charts, and added compiler tests for y-grid spacing and x-axis presence.
2026-05-11pnpm -C app type-check and pnpm -C app test after axis correctionsPassed.
2026-05-11X-axis gridline and guide-domain auditAdded reusable x-grid/tick-mark layers for numeric x-axis examples, fixed symbol-map guide values that could clamp outside the scale domain, and added tests for guide scale inputs staying inside linear domains.
2026-05-11Interval and grouped-layout passAdded compiler-owned interval and grouped-band layout transforms, updated histogram and multi-set bars to use them, added the Gantt chart, passed pnpm -C app type-check plus pnpm -C app test, and browser-smoked Gantt/histogram/multi-set detail routes.
2026-05-11Diverging domain and population-pyramid passAdded padded/symmetric/reversed domain controls, formatted axis ticks, a diverging-bar layout transform, and the Population Pyramid gallery route; passed pnpm -C app type-check, pnpm -C app test, and browser-smoked /_internal/chart-compiler/populationPyramid.
2026-05-11Generated legend and proportional-area passAdded compiler-owned color/size legend materialization, replaced manual legend rows in selected gallery specs, and added the Proportional Area Chart route.
2026-05-11Area-band and stacked-area passAdded y0/y1 path geometry, updated Area Graph to use area bands, added the Stacked Area Graph route, and exposed path geometry in the gallery stage panel.
2026-05-11pnpm -C app type-check after area-band passPassed.
2026-05-11pnpm -C app test after area-band passPassed: 17 compiler tests, including area-band lineage and stacked-area transform coverage.
2026-05-11Browser smoke test at http://localhost:3000/_internal/chart-compiler/stackedAreaGraphPassed: route text present, areaBand exposed in the stage panel, and the SVG rendered 3 area-band paths plus 3 upper-edge paths.
2026-05-11Statistical/financial interval passAdded errorInterval and financialInterval transforms, explicit numeric domain bounds, and the Error Bars, Candlestick Chart, OHLC Chart, and Span Chart gallery routes; passed pnpm -C app type-check, pnpm -C app test, and browser smoke tests for all four new detail routes at http://localhost:3000/_internal/chart-compiler/*.
2026-05-11Temporal/statistical layout passAdded time, density, regression, and executable squarified treemap support; added Density Plot and Timeline routes; updated Gantt/Candlestick/OHLC/Scatterplot/Treemap specs; passed pnpm -C app type-check, pnpm -C app test, and browser-smoked changed routes at http://localhost:3002/_internal/chart-compiler/* with no console errors.
2026-05-11Calendar/mosaic/dot-matrix layout passAdded calendarMonth, mosaic, and dotMatrix layout executors; added Calendar, Marimekko Chart, and Dot Matrix Chart routes; passed pnpm -C app type-check, pnpm -C app test, and browser-smoked the new detail routes at http://localhost:3002/_internal/chart-compiler/* with no console errors.
2026-05-11Polar-sector path passAdded direct path-data rendering and polarSectors layout execution; added Pie Chart, Donut Chart, Nightingale Rose Chart, and Radial Column Chart routes; passed pnpm -C app type-check, pnpm -C app test, and browser-smoked the new detail routes at http://localhost:3005/_internal/chart-compiler/* with no console errors.
2026-05-11Stream and violin passAdded smooth/step path interpolation, stream stack mode, and violin layout execution; added Stream Graph and Violin Plot routes; passed pnpm -C app type-check, pnpm -C app test, and browser-smoked both new routes at http://localhost:3006/_internal/chart-compiler/* with no console warnings or errors.
2026-05-11Near-fit layout passAdded focused bullet, parallel-coordinate, and timetable layout execution; added Bullet Graph, Parallel Coordinates Plot, and Timetable routes; passed pnpm -C app type-check, pnpm -C app test, and browser-smoked the three new detail routes at http://localhost:3000/_internal/chart-compiler/* with no console warnings or errors.
2026-05-11Hierarchy layout passAdded parent-child hierarchy normalization plus focused tree, sunburst, and circle-pack layouts; added Circle Packing, Sunburst Diagram, and Tree Diagram routes; passed pnpm -C app type-check, pnpm -C app test, and browser-smoked the three new routes at http://localhost:3000/_internal/chart-compiler/* with no console warnings or errors.
2026-05-12Polar-axis and arc layout passAdded focused radar, radial-bar, and arc-diagram layouts; added Arc Diagram, Radar Chart, and Radial Bar Chart routes; passed pnpm -C app type-check, pnpm -C app test, and browser-smoked the three new routes at http://localhost:3007/_internal/chart-compiler/* with no console warnings or errors.