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
| Status | Meaning |
|---|---|
| Implemented | Present in createGalleryChartSpecs() and renderable in the chart compiler gallery. |
| Partial | Renderable, but an important catalogue feature is approximated or missing. |
| Planned | Documented and selected, but not implemented in the gallery yet. |
Selected Catalogue Charts
| Chart | Status | Gallery id | Spec/doc | Reference assets | Notes |
|---|---|---|---|---|---|
| Arc Diagram | Partial | arcDiagram | arc-diagram.md | No local reference asset yet | Raw source-target rows compile into ordered nodes and weighted cubic arc paths; richer ordering and directed-edge policies remain follow-ups. |
| Area Graph | Implemented | areaGraph | area-graph.md | Reference and anatomy PNGs | Uses a filled path closed to zero plus a separate trend-edge path. Stacked-area behavior remains out of scope. |
| Bar Chart | Implemented | bar | bar-chart.md | Reference and anatomy PNGs | Existing rect/band/linear bar example relabeled and positioned as the catalogue bar-chart target. |
| Box & Whisker Plot | Implemented | boxWhisker | Compiler gap analysis | No local reference asset yet | Raw observations compile to quartile summaries, whiskers, caps, and median marks. Outlier extraction remains a follow-up. |
| Bubble Chart | Implemented | bubbleChart | bubble-chart.md | Reference and anatomy PNGs | Uses a first-class sqrt scale for area-correct radius mapping. |
| Bullet Graph | Implemented | bulletGraph | bullet-graph.md | No local reference asset yet | Raw threshold rows compile into qualitative range bands, actual measure bars, and target markers. |
| Calendar | Implemented | calendar | calendar.md | No local reference asset yet | Raw dated rows compile through calendarMonth layout into weekday/week cells with a generated color legend. |
| Candlestick Chart | Implemented | candlestickChart | candlestick-chart.md | No local reference asset yet | Raw ordered dated prices compile through financialInterval into OHLC rows, then render on a time scale as wick lines and candle bodies. |
| Circle Packing | Partial | circlePacking | circle-packing.md | No local reference asset yet | Raw parent-child rows compile through hierarchy and circlePack layout into nested circle geometry; optimal packing remains a follow-up. |
| Density Plot | Implemented | densityPlot | density-plot.md | No local reference asset yet | Raw observations compile through density into sampled curve rows rendered as a baseline-filled path. |
| Donut Chart | Implemented | donutChart | donut-chart.md | No local reference asset yet | Raw category values compile through polarSectors into annular paths, percentage labels, and legend entries. |
| Dot Matrix Chart | Implemented | dotMatrixChart | dot-matrix-chart.md | No local reference asset yet | Raw category counts compile through dotMatrix layout into repeated point glyph rows. |
| Error Bars | Implemented | errorBars | error-bars.md | No local reference asset yet | Raw grouped observations compile through errorInterval into means and confidence-style bounds. |
| Gantt Chart | Implemented | ganttChart | gantt-chart.md | No local reference asset yet | Raw start/end date rows compile through interval into timeline bars on a generated date axis. |
| Heatmap | Implemented | heatmap | heatmap.md | Reference and anatomy SVGs | Existing matrix rect example maps directly to the catalogue chart. Continuous gradients are not implemented; discrete sequential steps are used. |
| Histogram | Implemented | histogram | histogram.md | Reference and anatomy PNGs | Raw rows compile through bin; bars render on a linear x scale with min/max interval geometry. |
| Line Graph | Implemented | line | line-graph.md | Reference and anatomy PNGs | Existing path and sampled point example maps to the catalogue line graph. |
| Marimekko Chart | Implemented | marimekkoChart | marimekko-chart.md | No local reference asset yet | Raw category/series values compile through mosaic layout into variable-width stacked rectangles. |
| Multi-set Bar Chart | Implemented | multiSetBar | multi-set-bar-chart.md | Reference and anatomy PNGs | Raw category/series rows compile through grouped layout to produce inner offsets and group centers. |
| Nightingale Rose Chart | Implemented | nightingaleRoseChart | nightingale-rose-chart.md | No local reference asset yet | Equal-angle polarSectors layout derives value-sized radial sector paths from raw category values. |
| Open-high-low-close Chart | Implemented | openHighLowClose | open-high-low-close-chart.md | No local reference asset yet | Reuses the financialInterval OHLC table and renders dated high-low stems with open/close ticks. |
| Parallel Coordinates Plot | Implemented | parallelCoordinates | parallel-coordinates-plot.md | No local reference asset yet | Raw multivariate observations compile into per-axis guide rows, ticks, and grouped polyline points. |
| Pie Chart | Implemented | pieChart | pie-chart.md | No local reference asset yet | Raw category values compile through polarSectors into proportional wedge paths and percentage labels. |
| Population Pyramid | Implemented | populationPyramid | population-pyramid.md | No local reference asset yet | Raw positive cohort values compile through diverging layout into signed left/right bars on a symmetric axis. |
| Proportional Area Chart | Implemented | proportionalAreaChart | proportional-area-chart.md | No local reference asset yet | Raw category values resolve through a sqrt radius scale, with a compiler-generated size legend. |
| Radar Chart | Implemented | radarChart | radar-chart.md | No local reference asset yet | Raw series/metric rows compile into radial axes, guide rings, closed profile polygons, and vertex points. |
| Radial Bar Chart | Implemented | radialBarChart | radial-bar-chart.md | No local reference asset yet | Raw category values compile into concentric tracks and value sweep arcs. |
| Radial Column Chart | Implemented | radialColumnChart | radial-column-chart.md | No local reference asset yet | Equal-angle polarSectors layout derives annular columns with a visible inner baseline. |
| Scatterplot | Implemented | scatterplot | scatterplot.md | Reference and anatomy PNGs | Uses point glyphs on two linear scales plus a compiler-generated regression path. |
| Span Chart | Implemented | spanChart | span-chart.md | No local reference asset yet | Raw paired values compile through interval and render as line spans with endpoint symbols. |
| Stacked Area Graph | Implemented | stackedAreaGraph | stacked-area-graph.md | No local reference asset yet | Raw period/series rows compile through stack; filled path bands render between generated start and end boundaries. |
| Stacked Bar Graph | Implemented | stacked | stacked-bar-graph.md | Reference and anatomy PNGs | Existing stack segment geometry maps directly to the catalogue simple stacked bar. 100 percent stack mode remains a follow-up. |
| Stream Graph | Implemented | streamGraph | stream-graph.md | No local reference asset yet | Raw period/series rows compile through stack stream mode; smooth area-band paths render centered flowing layers. |
| Sunburst Diagram | Partial | sunburstDiagram | sunburst-diagram.md | No local reference asset yet | Raw parent-child rows compile through hierarchy and sunburstSectors layout into annular path sectors. |
| Timeline | Implemented | timeline | timeline.md | No local reference asset yet | Dated events render through the first-class time scale and generated date axis. |
| Timetable | Implemented | timetable | timetable.md | No local reference asset yet | Raw day/time events compile into grid cells, day headers, and duration-aware event blocks. |
| Treemap | Partial | treemap | treemap.md | Reference and anatomy PNGs | Flat raw metric rows compile through a squarified treemap transform; nested hierarchy remains a follow-up. |
| Tree Diagram | Partial | treeDiagram | tree-diagram.md | No local reference asset yet | Raw parent-child rows compile through hierarchy, treeNodes, and treeLinks layouts into node/link geometry. |
| Violin Plot | Implemented | violinPlot | violin-plot.md | No local reference asset yet | Raw 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:
arcDiagramareaGraphbarboxWhiskerbubbleChartbulletGraphcalendarcandlestickChartcirclePackingdensityPlotdonutChartdotMatrixCharterrorBarsganttChartheatmaphistogramlinemarimekkoChartmultiSetBaropenHighLowClosenightingaleRoseChartparallelCoordinatespieChartpopulationPyramidproportionalAreaChartradarChartradialBarChartradialColumnChartscatterplotspanChartstackedAreaGraphstackedstreamGraphsunburstDiagramtimelinetimetabletreemaptreeDiagramviolinPlot
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
| Priority | Work |
|---|---|
| High | Add richer interval labels for histogram axes and richer calendar/session formatting for temporal axes. |
| High | Generalize the grouped-bar layout into nested band scales or broader categorical layout transforms. |
| High | Generalize first-pass hierarchy layouts into reusable stratify/tree/partition/pack families with stronger layout policies. |
| High | Extend calendar, mosaic, dot-matrix, bullet, parallel-coordinate, and timetable layouts with ordering, responsive packing, and label-hiding policies. |
| Medium | Generalize radar, radial-bar, and arc-diagram layouts into broader polar-coordinate and edge-list layout families. |
| Medium | Add richer legend layouts, including continuous color ramps and collision-aware placement. |
| Medium | Add 100 percent normalization mode coverage to stacked bar and stacked area gallery examples. |
| Medium | Add richer path interpolation policies beyond the first smooth/step pass, including stream-specific ordering/baseline policies. |
| Medium | Add financial/session formatting for Candlestick and OHLC charts, and date-span support for Span Chart. |
| Medium | Add polar guide rings, polar labels, and collision policies for pie/donut/radial sector charts. |
| Medium | Upgrade treemap layout from flat squarified rows to nested hierarchy rows. |
| Low | Add 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
| Date | Check | Result |
|---|---|---|
| 2026-05-11 | pnpm -C app type-check | Passed. |
| 2026-05-11 | Browser smoke test at http://localhost:3004/_internal/chart-compiler | Passed: all selected chart labels from that pass were present. |
| 2026-05-11 | Browser smoke test for selected detail routes | Passed: every selected route rendered data layers and no browser console errors were reported. |
| 2026-05-11 | Visual 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-11 | pnpm -C app type-check after visual corrections | Passed. |
| 2026-05-11 | Axis math and rendering pass | Fixed 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-11 | pnpm -C app type-check and pnpm -C app test after axis corrections | Passed. |
| 2026-05-11 | X-axis gridline and guide-domain audit | Added 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-11 | Interval and grouped-layout pass | Added 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-11 | Diverging domain and population-pyramid pass | Added 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-11 | Generated legend and proportional-area pass | Added compiler-owned color/size legend materialization, replaced manual legend rows in selected gallery specs, and added the Proportional Area Chart route. |
| 2026-05-11 | Area-band and stacked-area pass | Added 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-11 | pnpm -C app type-check after area-band pass | Passed. |
| 2026-05-11 | pnpm -C app test after area-band pass | Passed: 17 compiler tests, including area-band lineage and stacked-area transform coverage. |
| 2026-05-11 | Browser smoke test at http://localhost:3000/_internal/chart-compiler/stackedAreaGraph | Passed: route text present, areaBand exposed in the stage panel, and the SVG rendered 3 area-band paths plus 3 upper-edge paths. |
| 2026-05-11 | Statistical/financial interval pass | Added 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-11 | Temporal/statistical layout pass | Added 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-11 | Calendar/mosaic/dot-matrix layout pass | Added 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-11 | Polar-sector path pass | Added 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-11 | Stream and violin pass | Added 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-11 | Near-fit layout pass | Added 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-11 | Hierarchy layout pass | Added 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-12 | Polar-axis and arc layout pass | Added 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. |