chart-factory 0.1.2

package/docs/conformance-matrix.md

@@ -0,0 +1,864 @@
+# Conformance matrix
+
+> **Generated file — do not edit.** Source of truth: `metadata/*.mjs`
+> (schema in [metadata/README.md](../metadata/README.md)). Regenerate with
+> `npm run conformance`.
+
+Universal options × builders. Legend: ✓ supported · ✗ intentionally
+unsupported (reason in metadata) · 💥 **defective** (documented universal,
+silently ignored — bug backlog) · `·` not applicable.
+
+**79 builders · 1847 supported · 350 unsupported · 0 defective · 805 n/a**
+
+## Area
+
+| Option | Basic | Diverging | Normalized | Smoothed | Stacked | Streamgraph |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|
+| `xDomain` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `yDomain` | ✓ | ✓ | ✓* | ✓ | ✓ | ✓* |
+| `xFormat` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `yFormat` | ✓ | ✓ | ✓ | ✓ | ✓ | · |
+| `xLabel` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `yLabel` | ✓ | ✓ | ✓ | ✓ | ✓ | · |
+| `color` | ✓ | · | · | ✓ | · | · |
+| `colors` | · | · | ✓ | · | ✓ | ✓ |
+| `colorMap` | · | · | ✗ | · | ✗ | ✗ |
+| `showTooltip` | ✓ | ✓ | ✓* | ✓ | ✓* | ✓* |
+| `tooltipContent` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `tooltipValueFormat` | ✓ | ✓ | ✓* | ✓ | ✓ | ✓ |
+| `annotations` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓* |
+| `extraLayers` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `onRender` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `title` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `subtitle` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `footer` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `story` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `legend` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `featured` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `state` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `emptyMessage` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `errorMessage` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `animate` | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `nullGaps` | ✓ | ✓ | ✓* | ✓ | ✓* | ✓* |
+| `logX` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `logY` | ✗ | ✗ | · | ✗ | ✗ | · |
+| `niceX` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `linkGroup` | ✓ | ✓ | ✓* | ✓ | ✓* | ✓* |
+| `brush` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `showXAxis` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `showYAxis` | ✓ | ✓ | ✓ | ✓ | ✓ | · |
+| `showGridX` | · | · | · | · | · | ✓ |
+| `showGridY` | ✓ | ✓ | ✓ | ✓ | ✓ | · |
+| `showAxisLabels` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `xTickValues` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `yTickValues` | ✓ | ✓ | ✓ | ✓ | ✓ | · |
+
+## Line
+
+| Option | AreaGradient | Basic | BumpChart | Combined | CumulativeVsMoving | DynamicBand | ForecastBand | GrowthRate | Multi | PulseAnomalies | Smoothed | Textures | Yearly | YoY |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| `xDomain` | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `yDomain` | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓* | ✓ | ✓ | ✓ | ✓* | ✓ | ✓ |
+| `xFormat` | ✓ | ✓ | ✓* | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `yFormat` | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `xLabel` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `yLabel` | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `color` | ✓ | ✓ | · | ✗ | ✗ | ✗ | ✗ | ✗ | · | ✗ | ✓ | · | ✓ | · |
+| `colors` | · | · | ✓ | · | · | · | · | · | ✓ | · | · | ✗ | · | ✓ |
+| `colorMap` | · | · | ✗ | · | · | · | · | · | · | · | · | · | · | · |
+| `showTooltip` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓* | ✓ | ✓ | ✓* | ✓ | ✓* |
+| `tooltipContent` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `tooltipValueFormat` | ✓* | ✓* | ✗ | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* |
+| `annotations` | ✓ | ✓ | ✓* | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `extraLayers` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `onRender` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `title` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `subtitle` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `footer` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `story` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `legend` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `featured` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `state` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `emptyMessage` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `errorMessage` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `animate` | ✗ | ✗ | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✓* | ✗ | ✗ | ✗ | ✗ |
+| `nullGaps` | ✓ | ✓ | · | ✓* | ✓* | ✓* | ✓* | ✓ | ✓ | ✓* | ✓* | ✓ | ✓ | ✓ |
+| `logX` | ✓* | ✓* | · | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* |
+| `logY` | ✗ | ✗ | · | ✗ | ✗ | ✗ | ✗ | · | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `niceX` | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `linkGroup` | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓* | ✓ | ✓ |
+| `brush` | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `showXAxis` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `showYAxis` | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `showGridX` | · | · | · | · | · | · | · | · | · | · | · | · | · | · |
+| `showGridY` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `showAxisLabels` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `xTickValues` | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `yTickValues` | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+
+## Slope
+
+| Option | Animated | Bands | Basic | Categorical | Highlight | Indexed | Trend |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| `xDomain` | · | · | · | · | · | · | · |
+| `yDomain` | ✓ | ✓* | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `xFormat` | · | · | · | · | · | · | · |
+| `yFormat` | · | · | · | · | · | · | · |
+| `xLabel` | · | · | · | · | · | · | · |
+| `yLabel` | · | · | · | · | · | · | · |
+| `color` | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `colors` | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `colorMap` | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `showTooltip` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `tooltipContent` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `tooltipValueFormat` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `annotations` | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `extraLayers` | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `onRender` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `title` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `subtitle` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `footer` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `story` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `legend` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `featured` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `state` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `emptyMessage` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `errorMessage` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `animate` | ✓* | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `nullGaps` | · | · | · | · | · | · | · |
+| `logX` | · | · | · | · | · | · | · |
+| `logY` | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `niceX` | · | · | · | · | · | · | · |
+| `linkGroup` | · | · | · | · | · | · | · |
+| `brush` | · | · | · | · | · | · | · |
+| `showXAxis` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `showYAxis` | · | · | · | · | · | · | · |
+| `showGridX` | · | · | · | · | · | · | · |
+| `showGridY` | · | · | · | · | · | · | · |
+| `showAxisLabels` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `xTickValues` | · | · | · | · | · | · | · |
+| `yTickValues` | · | · | · | · | · | · | · |
+
+## Bar
+
+| Option | Basic | Bullet | Diverging | Gantt | Grouped | Inline | LabelAbove | Likert | Progress | Pyramid | Range | Stacked | Vertical | VerticalNormalized | VerticalStacked | Waterfall |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| `xDomain` | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓ | ✓* | ·* | ·* | ·* | ✓* |
+| `yDomain` | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ✓* | ·* | ✓* | ·* |
+| `xFormat` | ·* | ·* | ·* | ✓* | ·* | ·* | ·* | ·* | ·* | ·* | ✓* | ·* | ✓ | ✓ | ✓ | ✓* |
+| `yFormat` | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ✓ | ✗ | ✓ | ·* |
+| `xLabel` | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `yLabel` | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `color` | ✓ | ✓ | ✗ | ✗ | ✗ | ✓ | ✓ | ✗ | ✗ | ✗ | ✓ | ✗ | ✓ | ✗ | ✗ | ✗ |
+| `colors` | · | · | · | · | ✓ | · | · | ✓ | · | ✓ | · | ✓ | · | ✓ | ✓ | · |
+| `colorMap` | · | · | · | ·* | ✗ | · | · | ✗ | ·* | ✗ | ·* | ✗ | · | ✗ | ✗ | ·* |
+| `showTooltip` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `tooltipContent` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓* |
+| `tooltipValueFormat` | ✓ | ✓ | ✓ | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `annotations` | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* |
+| `extraLayers` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `onRender` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `title` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `subtitle` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `footer` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `story` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `legend` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `featured` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `state` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `emptyMessage` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `errorMessage` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `animate` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓* | ✓ | ✓* | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `nullGaps` | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* |
+| `logX` | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ✗ | ·* | ·* | ·* | ·* | ·* |
+| `logY` | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* | ·* |
+| `niceX` | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ·* | ·* | ·* | ✗ |
+| `linkGroup` | · | · | · | ✗ | · | · | · | · | · | · | · | · | · | · | · | · |
+| `brush` | · | · | · | ✗ | · | · | · | · | · | · | · | · | · | · | · | · |
+| `showXAxis` | · | · | · | ✓ | · | · | · | · | · | · | ✓ | · | ✓ | ✓ | ✓ | ✓ |
+| `showYAxis` | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `showGridX` | · | · | · | ✓ | · | · | · | ✓* | · | ✓* | ✓ | · | · | · | · | ✓* |
+| `showGridY` | · | · | · | · | · | · | · | · | · | · | · | · | ✓ | ✓ | ✓ | · |
+| `showAxisLabels` | ✓ | ✓ | ✓ | ✓ | ✓ | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `xTickValues` | · | · | · | ✓* | · | · | · | · | · | · | ✓ | · | · | · | · | ✓ |
+| `yTickValues` | · | · | · | · | · | · | · | · | · | · | · | · | ✓ | ✗ | ✓ | · |
+
+## Scatter
+
+| Option | Animated | Basic | Beeswarm | BeeswarmHorizontal | BeeswarmLogos | BeeswarmVertical | Comet | Contour | Diagonal | Heatmap | Hexbin | KDE | Logos | Marginal | MarginalKDE | MarginalSimple | Quadrant | Trajectory |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| `xDomain` | ✓ | ✓ | ✓ | ✓ | ·* | ·* | ✓* | ✓ | ✓* | ✓* | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `yDomain` | ✓ | ✓ | ·* | ·* | ✓ | ✓ | ✓ | ✓ | ✓ | ✓* | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `xFormat` | ✓ | ✓ | ✗ | ✗ | · | ·* | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `yFormat` | ✓ | ✓ | ·* | · | ✗ | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `xLabel` | ✓ | ✓ | ✗ | ✓ | ·* | ✗ | ✗ | ✓ | ✗ | ✓ | ✓ | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
+| `yLabel` | ✓ | ✓ | ✗ | ·* | ✓ | ✓ | ✗ | ✓ | ✗ | ✓ | ✓ | ✗ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
+| `color` | ✓ | ✓ | ✓ | ✓* | ·* | ✓* | ✓ | · | ✗ | · | · | ✗ | ·* | ✓ | ✓ | ✓ | ✗ | ✓ |
+| `colors` | ✓ | ✓ | ✓ | ✓ | · | ✓ | ✓ | · | · | · | · | · | · | ✓ | ✓ | · | ✓ | ✓ |
+| `colorMap` | ✗ | ✓* | ✗ | ✗ | · | ✗ | ✗ | · | · | · | · | · | · | ✗ | ✗ | · | ✓ | ✗ |
+| `showTooltip` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓* | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `tooltipContent` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓* | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `tooltipValueFormat` | ✗ | ✗* | ✓ | ✓ | ✓ | ✓ | ✗ | ✗ | ✗ | ✓* | ✓* | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `annotations` | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | ✓ | ✓ | ✓ | ✓* | ✓ | ✓ | ✓* | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `extraLayers` | ✓ | ✓ | · | · | · | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `onRender` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `title` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `subtitle` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `footer` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `story` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `legend` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `featured` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `state` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `emptyMessage` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `errorMessage` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `animate` | ✓* | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `nullGaps` | ·* | ·* | ·* | ·* | ·* | ·* | ·* | · | · | · | · | · | ·* | · | · | · | · | ✗ |
+| `logX` | ✓ | ✓ | ✗ | ✗ | · | · | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `logY` | ✓ | ✓ | · | · | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `niceX` | ✗ | ✗ | ✗ | ✗ | ·* | ·* | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `linkGroup` | ✗ | ✓* | · | · | · | · | ✗ | ✗ | ✓* | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✓* | ✗ |
+| `brush` | ✗ | ✓ | · | · | · | · | ✗ | ✗ | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✓ | ✗ |
+| `showXAxis` | ✓ | ✓ | ✓ | ✓ | · | ·* | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `showYAxis` | ✓ | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `showGridX` | ✓ | ✓ | ✓ | ✓* | · | · | ✓ | · | ✓ | · | · | · | ✓ | ✓ | ✓ | ✓ | ✓* | ✓ |
+| `showGridY` | ✓ | ✓ | · | · | ✓* | ✓* | ✓ | · | ✓ | · | · | · | ✓ | ✓ | ✓ | ✓ | ✓* | ✓ |
+| `showAxisLabels` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `xTickValues` | ✓ | ✓ | ✗ | ✗ | · | · | ✓ | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `yTickValues` | ✓ | ✓ | · | · | ✗ | ✗ | ✓ | ✓ | ✓ | · | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+
+## Dot
+
+| Option | Basic | Comet | Confidence | Dumbbell | Gradient | Percentile | UnitHistogram |
+|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
+| `xDomain` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · |
+| `yDomain` | · | · | · | · | · | · | · |
+| `xFormat` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓* | ✗ |
+| `yFormat` | · | · | · | · | · | · | · |
+| `xLabel` | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `yLabel` | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | · |
+| `color` | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✓ |
+| `colors` | ✗ | · | · | · | · | ✗ | ✗ |
+| `colorMap` | ✗ | · | · | · | · | · | ✗ |
+| `showTooltip` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `tooltipContent` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `tooltipValueFormat` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓* |
+| `annotations` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
+| `extraLayers` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ |
+| `onRender` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `title` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `subtitle` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `footer` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `story` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `legend` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `featured` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `state` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `emptyMessage` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `errorMessage` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `animate` | ✗ | ✓ | ✗ | ✗ | ✗ | ✗ | ✓ |
+| `nullGaps` | · | · | · | · | · | · | · |
+| `logX` | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | · |
+| `logY` | · | · | · | · | · | · | · |
+| `niceX` | ✗* | ✗* | ✗* | ✗* | ✗* | ✗* | · |
+| `linkGroup` | · | · | · | · | · | · | · |
+| `brush` | · | · | · | · | · | · | · |
+| `showXAxis` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `showYAxis` | ✓* | ✓* | ✓* | ✓* | ✓* | ✓* | · |
+| `showGridX` | ✓ | ✓ | ✓* | ✓ | ✓ | ✓ | · |
+| `showGridY` | · | · | · | · | · | · | · |
+| `showAxisLabels` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `xTickValues` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | · |
+| `yTickValues` | · | · | · | · | · | · | · |
+
+## Histogram
+
+| Option | Basic | Overlay |
+|---|:---:|:---:|
+| `xDomain` | ✓* | ✓* |
+| `yDomain` | ✓ | ✓ |
+| `xFormat` | ✓ | ✓ |
+| `yFormat` | ✓* | ✓* |
+| `xLabel` | ✓ | ✓ |
+| `yLabel` | ✓ | ✓ |
+| `color` | ✓ | · |
+| `colors` | · | ✓ |
+| `colorMap` | · | ✗ |
+| `showTooltip` | ✓ | ✓ |
+| `tooltipContent` | ✓ | ✓ |
+| `tooltipValueFormat` | ✓* | ✓* |
+| `annotations` | ✓ | ✓ |
+| `extraLayers` | ✓ | ✓ |
+| `onRender` | ✓ | ✓ |
+| `title` | ✓ | ✓ |
+| `subtitle` | ✓ | ✓ |
+| `footer` | ✓ | ✓ |
+| `story` | ✓ | ✓ |
+| `legend` | ✓ | ✓ |
+| `featured` | ✓ | ✓ |
+| `state` | ✓ | ✓ |
+| `emptyMessage` | ✓ | ✓ |
+| `errorMessage` | ✓ | ✓ |
+| `animate` | ✓ | ✓ |
+| `nullGaps` | · | · |
+| `logX` | ✗ | ✗ |
+| `logY` | ✗ | ✗ |
+| `niceX` | · | · |
+| `linkGroup` | ✓* | ✓* |
+| `brush` | ✓ | ✓ |
+| `showXAxis` | ✓ | ✓ |
+| `showYAxis` | ✓ | ✓ |
+| `showGridX` | · | · |
+| `showGridY` | ✓ | ✓ |
+| `showAxisLabels` | ✓ | ✓ |
+| `xTickValues` | ✓ | ✓ |
+| `yTickValues` | ✓ | ✓ |
+
+## Donut
+
+| Option | Basic |
+|---|:---:|
+| `xDomain` | · |
+| `yDomain` | · |
+| `xFormat` | · |
+| `yFormat` | · |
+| `xLabel` | · |
+| `yLabel` | · |
+| `color` | · |
+| `colors` | ✓ |
+| `colorMap` | ✓ |
+| `showTooltip` | ✓ |
+| `tooltipContent` | ✓ |
+| `tooltipValueFormat` | ✓* |
+| `annotations` | · |
+| `extraLayers` | · |
+| `onRender` | ✓ |
+| `title` | ✓ |
+| `subtitle` | ✓ |
+| `footer` | ✓ |
+| `story` | ✓ |
+| `legend` | ✓ |
+| `featured` | ✓ |
+| `state` | ✓ |
+| `emptyMessage` | ✓ |
+| `errorMessage` | ✓ |
+| `animate` | ✓ |
+| `nullGaps` | · |
+| `logX` | · |
+| `logY` | · |
+| `niceX` | · |
+| `linkGroup` | · |
+| `brush` | · |
+| `showXAxis` | · |
+| `showYAxis` | · |
+| `showGridX` | · |
+| `showGridY` | · |
+| `showAxisLabels` | · |
+| `xTickValues` | · |
+| `yTickValues` | · |
+
+## BoxPlot
+
+| Option | Basic |
+|---|:---:|
+| `xDomain` | · |
+| `yDomain` | ✓ |
+| `xFormat` | ✓ |
+| `yFormat` | ✓ |
+| `xLabel` | ✗ |
+| `yLabel` | ✗ |
+| `color` | ✓ |
+| `colors` | ✗ |
+| `colorMap` | ✓ |
+| `showTooltip` | ✓ |
+| `tooltipContent` | ✓ |
+| `tooltipValueFormat` | ✓* |
+| `annotations` | ✓ |
+| `extraLayers` | ✓ |
+| `onRender` | ✓ |
+| `title` | ✓ |
+| `subtitle` | ✓ |
+| `footer` | ✓ |
+| `story` | ✓ |
+| `legend` | ✓ |
+| `featured` | ✓ |
+| `state` | ✓ |
+| `emptyMessage` | ✓ |
+| `errorMessage` | ✓ |
+| `animate` | ✗ |
+| `nullGaps` | · |
+| `logX` | · |
+| `logY` | ✗ |
+| `niceX` | · |
+| `linkGroup` | · |
+| `brush` | · |
+| `showXAxis` | ✓ |
+| `showYAxis` | ✓ |
+| `showGridX` | · |
+| `showGridY` | ✓ |
+| `showAxisLabels` | ✓ |
+| `xTickValues` | · |
+| `yTickValues` | ✓ |
+
+## Calendar
+
+| Option | Heatmap |
+|---|:---:|
+| `xDomain` | · |
+| `yDomain` | · |
+| `xFormat` | · |
+| `yFormat` | · |
+| `xLabel` | · |
+| `yLabel` | · |
+| `color` | · |
+| `colors` | · |
+| `colorMap` | · |
+| `showTooltip` | ✓ |
+| `tooltipContent` | ✓ |
+| `tooltipValueFormat` | ✓* |
+| `annotations` | · |
+| `extraLayers` | · |
+| `onRender` | ✓ |
+| `title` | ✓ |
+| `subtitle` | ✓ |
+| `footer` | ✓ |
+| `story` | ✓ |
+| `legend` | ✓ |
+| `featured` | ✓ |
+| `state` | ✓ |
+| `emptyMessage` | ✓ |
+| `errorMessage` | ✓ |
+| `animate` | ✗ |
+| `nullGaps` | · |
+| `logX` | · |
+| `logY` | · |
+| `niceX` | · |
+| `linkGroup` | · |
+| `brush` | · |
+| `showXAxis` | · |
+| `showYAxis` | · |
+| `showGridX` | · |
+| `showGridY` | · |
+| `showAxisLabels` | · |
+| `xTickValues` | · |
+| `yTickValues` | · |
+
+## Sankey
+
+| Option | Basic |
+|---|:---:|
+| `xDomain` | · |
+| `yDomain` | · |
+| `xFormat` | · |
+| `yFormat` | · |
+| `xLabel` | · |
+| `yLabel` | · |
+| `color` | · |
+| `colors` | ✓ |
+| `colorMap` | ✓ |
+| `showTooltip` | ✓ |
+| `tooltipContent` | ✓ |
+| `tooltipValueFormat` | ✓* |
+| `annotations` | · |
+| `extraLayers` | · |
+| `onRender` | ✓ |
+| `title` | ✓ |
+| `subtitle` | ✓ |
+| `footer` | ✓ |
+| `story` | ✓ |
+| `legend` | ✓ |
+| `featured` | ✓ |
+| `state` | ✓ |
+| `emptyMessage` | ✓ |
+| `errorMessage` | ✓ |
+| `animate` | ✓* |
+| `nullGaps` | · |
+| `logX` | · |
+| `logY` | · |
+| `niceX` | · |
+| `linkGroup` | · |
+| `brush` | · |
+| `showXAxis` | · |
+| `showYAxis` | · |
+| `showGridX` | · |
+| `showGridY` | · |
+| `showAxisLabels` | · |
+| `xTickValues` | · |
+| `yTickValues` | · |
+
+## Table
+
+| Option | Basic | Combined | Sortable | WithBars | WithHeatmap |
+|---|:---:|:---:|:---:|:---:|:---:|
+| `xDomain` | · | · | · | · | · |
+| `yDomain` | · | · | · | · | · |
+| `xFormat` | · | · | · | · | · |
+| `yFormat` | · | · | · | · | · |
+| `xLabel` | · | · | · | · | · |
+| `yLabel` | · | · | · | · | · |
+| `color` | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `colors` | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `colorMap` | · | · | · | · | · |
+| `showTooltip` | ·* | ·* | ·* | ·* | ·* |
+| `tooltipContent` | · | · | · | · | · |
+| `tooltipValueFormat` | · | · | · | · | · |
+| `annotations` | ·* | ·* | ·* | ·* | ·* |
+| `extraLayers` | · | · | · | · | · |
+| `onRender` | ·* | ·* | ·* | ·* | ·* |
+| `title` | · | · | · | · | · |
+| `subtitle` | · | · | · | · | · |
+| `footer` | · | · | · | · | · |
+| `story` | · | · | · | · | · |
+| `legend` | · | · | · | · | · |
+| `featured` | · | · | · | · | · |
+| `state` | · | · | · | · | · |
+| `emptyMessage` | · | · | · | · | · |
+| `errorMessage` | · | · | · | · | · |
+| `animate` | ✗ | ✗ | ✗ | ✗ | ✗ |
+| `nullGaps` | · | · | · | · | · |
+| `logX` | · | · | · | · | · |
+| `logY` | · | · | · | · | · |
+| `niceX` | · | · | · | · | · |
+| `linkGroup` | · | · | · | · | · |
+| `brush` | · | · | · | · | · |
+| `showXAxis` | · | · | · | · | · |
+| `showYAxis` | · | · | · | · | · |
+| `showGridX` | · | · | · | · | · |
+| `showGridY` | · | · | · | · | · |
+| `showAxisLabels` | · | · | · | · | · |
+| `xTickValues` | · | · | · | · | · |
+| `yTickValues` | · | · | · | · | · |
+
+\* has a caveat or defect — details below.
+
+## Defects (0)
+
+None. 🎉
+
+## Caveats (283)
+
+| Builder | Option | Status | Note |
+|---|---|---|---|
+| Area.createNormalized | `yDomain` | supported | Direct opts.yDomain read (bypasses computeYDomain): a lone yMin or yMax is silently ignored — the wrapper only synthesizes yDomain when BOTH ends are present (L11685-11689). |
+| Area.createNormalized | `showTooltip` | supported | Hover-line tooltip over the whole plot — works without point markers. |
+| Area.createNormalized | `tooltipValueFormat` | supported | The formatter receives each key's share FRACTION (0..1), not the raw value; the rounded "NN%" rendering stays the default. |
+| Area.createNormalized | `nullGaps` | supported | Null/NaN key values count as 0 for stack POSITIONING and drop out of the share denominator (offsetExpand normalizes the sanitized values); the affected layer's own area/line break visually at those rows. |
+| Area.createNormalized | `linkGroup` | supported | Crosshair guide + shared x-domain only — no linkPoints probe yet, so linked charts show the guide line without dots/labels. |
+| Area.createStacked | `showTooltip` | supported | Hover-line tooltip over the whole plot — works without point markers. |
+| Area.createStacked | `nullGaps` | supported | Null/NaN key values count as 0 for stack POSITIONING (other layers keep stacking) while the affected layer's own area/line break visually at those rows. |
+| Area.createStacked | `linkGroup` | supported | Crosshair guide + shared x-domain only — no linkPoints probe yet, so linked charts show the guide line without dots/labels. |
+| Area.createStreamgraph | `yDomain` | supported | Y values live in wiggle-offset space (not data units), so the override is mostly useful for adding headroom. |
+| Area.createStreamgraph | `showTooltip` | supported | Hover-line tooltip: keys sorted by value desc, zero values skipped, share bars per row. |
+| Area.createStreamgraph | `annotations` | supported | y-based annotations (yLine/yBand/point y) are positioned in wiggle-stack space, not data units — xLine/xBand are the useful ones here. |
+| Area.createStreamgraph | `nullGaps` | supported | Null/NaN key values count as 0 for stack POSITIONING (the wiggle offset keeps flowing) while the affected layer breaks visually at those rows. |
+| Area.createStreamgraph | `linkGroup` | supported | Crosshair guide + shared x-domain only — no linkPoints probe yet, so linked charts show the guide line without dots/labels. |
+| Bar.createBasic | `xDomain` | supported | Negative values are first-class: the default domain widens to [min*1.1, max*1.1] and bars grow left from a zero baseline (drawn when the domain spans both signs), with value labels at the outer end. With allowNonZeroBaseline and an explicit domain excluding zero, bars grow from the nearest domain edge, clamped to the plot. Zero-baseline guard: an explicit domain excluding zero is clamped back to include 0 (one console warning) unless allowNonZeroBaseline: true. |
+| Bar.createBasic | `yDomain` | na | Y is a categorical band axis of row labels (L4076-4079). |
+| Bar.createBasic | `xFormat` | na | No value axis is rendered — no ticks to format. Bar-end labels use valueFormat. |
+| Bar.createBasic | `yFormat` | na | No y axis; category labels are drawn directly from categoryAccessor. |
+| Bar.createBasic | `annotations` | supported | y is a band scale — yLine/yBand values must be category strings. |
+| Bar.createBasic | `nullGaps` | na | No path geometry. |
+| Bar.createBasic | `logX` | na | Bars measure from a zero baseline — a log value axis is geometrically meaningless. API.md L29 scopes log to Scatter.createBasic and trend x. |
+| Bar.createBasic | `logY` | na | Categorical band axis. |
+| Bar.createBullet | `xDomain` | supported | With allowNonZeroBaseline and a nonzero domain min, measure/range bars still start at the axis (range 0) and widths clamp to ≥0. Zero-baseline guard: an explicit domain excluding zero is clamped back to include 0 (one console warning) unless allowNonZeroBaseline: true. |
+| Bar.createBullet | `yDomain` | na | Y is a categorical band axis (L4617-4620). |
+| Bar.createBullet | `xFormat` | na | No value axis rendered; the tooltip uses valueFormat. |
+| Bar.createBullet | `yFormat` | na | No y axis; category labels come from categoryAccessor. |
+| Bar.createBullet | `annotations` | supported | y is a band scale — yLine/yBand values must be category strings. |
+| Bar.createBullet | `nullGaps` | na | No path geometry. |
+| Bar.createBullet | `logX` | na | Zero-baseline bars — log value axis is geometrically meaningless. |
+| Bar.createBullet | `logY` | na | Categorical band axis. |
+| Bar.createDiverging | `xDomain` | supported | The center stays at value 0 (the label column), so each side scales to its own domain end — an asymmetric override gives the two sides different pixels-per-unit. The returned chart.x is a composite piecewise scale with 0 duplicated in the domain (exact everywhere; 0 maps to the label-column right edge). |
+| Bar.createDiverging | `yDomain` | na | Y is a categorical band axis (L4778-4781). |
+| Bar.createDiverging | `xFormat` | na | No value axis rendered; bar-end labels use valueFormat. |
+| Bar.createDiverging | `yFormat` | na | No y axis; center-column labels come from categoryAccessor. |
+| Bar.createDiverging | `annotations` | supported | chart.x models the center label column explicitly (domain [min, 0, 0, max]) — negative values map onto the left half, 0 and positive values onto the right half, matching the bar geometry exactly on both sides. yLine/yBand values must be category strings (band y). |
+| Bar.createDiverging | `nullGaps` | na | No path geometry. |
+| Bar.createDiverging | `logX` | na | Diverging axis spans negative values — log is undefined. |
+| Bar.createDiverging | `logY` | na | Categorical band axis. |
+| Bar.createGantt | `xDomain` | supported | The documented builder-specific minTime/maxTime keep precedence over the universal spellings. Numeric overrides are coerced to Dates when the axis is time-based. |
+| Bar.createGantt | `yDomain` | na | Y is a band scale over row indices (L5971-5974). |
+| Bar.createGantt | `xFormat` | supported | xFormat only formats the AXIS ticks; dateFormat stays the default and keeps formatting the tooltip range (and the axis when xFormat is absent). |
+| Bar.createGantt | `yFormat` | na | No y axis; row labels come from labelAccessor. |
+| Bar.createGantt | `colorMap` | na | A colorAccessor function can implement any value -> color mapping. |
+| Bar.createGantt | `annotations` | supported | xLine/xBand take Dates on time axes; y is a band scale over row INDICES, so yLine/yBand values are row indices. |
+| Bar.createGantt | `nullGaps` | na | No path geometry. |
+| Bar.createGantt | `logX` | na | Time (or plain linear range) axis — log has no meaning here and is scoped to Scatter.createBasic / trend x (API.md L29). |
+| Bar.createGantt | `logY` | na | Categorical band axis. |
+| Bar.createGantt | `xTickValues` | supported | Date coercion/domain filtering is central (resolveTickValues); values work on both time and plain linear gantt axes. |
+| Bar.createGrouped | `xDomain` | supported | The documented builder-specific maxValue keeps precedence over the universal xMax spelling. With allowNonZeroBaseline and a nonzero domain min, bars still start at the axis (range 0) and widths clamp to ≥0. Zero-baseline guard: an explicit domain excluding zero is clamped back to include 0 (one console warning) unless allowNonZeroBaseline: true. |
+| Bar.createGrouped | `yDomain` | na | Two categorical band axes: y0 (categories, L5211-5214) and y1 (keys within a group, L5216-5219). |
+| Bar.createGrouped | `xFormat` | na | No value axis rendered; bar-end labels use valueFormat. |
+| Bar.createGrouped | `yFormat` | na | No y axis; category labels come from categoryAccessor. |
+| Bar.createGrouped | `annotations` | supported | y is the outer category band scale (y0 alias) — yLine/yBand values must be category strings; a yLine sits at the group top edge. |
+| Bar.createGrouped | `nullGaps` | na | No path geometry. |
+| Bar.createGrouped | `logX` | na | Zero-baseline bars — log value axis is geometrically meaningless. |
+| Bar.createGrouped | `logY` | na | Categorical band axes. |
+| Bar.createInline | `xDomain` | supported | With allowNonZeroBaseline and a nonzero domain min, bars still start at the axis (range 0) and widths clamp to ≥0. Zero-baseline guard: an explicit domain excluding zero is clamped back to include 0 (one console warning) unless allowNonZeroBaseline: true. |
+| Bar.createInline | `yDomain` | na | Y is a categorical band axis (L4204-4207). |
+| Bar.createInline | `xFormat` | na | No value axis rendered; bar-end labels use valueFormat. |
+| Bar.createInline | `yFormat` | na | No y axis; inline category labels come from categoryAccessor. |
+| Bar.createInline | `annotations` | supported | y is a band scale — yLine/yBand values must be category strings. |
+| Bar.createInline | `nullGaps` | na | No path geometry. |
+| Bar.createInline | `logX` | na | Zero-baseline bars — log value axis is geometrically meaningless (API.md L29 scopes log elsewhere). |
+| Bar.createInline | `logY` | na | Categorical band axis. |
+| Bar.createLabelAbove | `xDomain` | supported | With allowNonZeroBaseline and a nonzero domain min, bars still start at the axis (range 0) and widths clamp to ≥0. Zero-baseline guard: an explicit domain excluding zero is clamped back to include 0 (one console warning) unless allowNonZeroBaseline: true. |
+| Bar.createLabelAbove | `yDomain` | na | Rows are positioned by index; the returned y is a categorical band mirror of that layout — no numeric domain to pin. |
+| Bar.createLabelAbove | `xFormat` | na | No value axis rendered; bar-end labels use valueFormat. |
+| Bar.createLabelAbove | `yFormat` | na | No y axis; labels above bars come from categoryAccessor. |
+| Bar.createLabelAbove | `annotations` | supported | y is a band scale — yLine/yBand values must be category strings; a yLine sits at the row top edge. |
+| Bar.createLabelAbove | `nullGaps` | na | No path geometry. |
+| Bar.createLabelAbove | `logX` | na | Zero-baseline bars — log value axis is geometrically meaningless. |
+| Bar.createLabelAbove | `logY` | na | No y scale. |
+| Bar.createLikert | `xDomain` | supported | xMax (alias of the xDomain group) sets maxExtent, the symmetric HALF-width: domain is [-xMax, xMax]. xMin is ignored. Default floor is max(±sums, 50) for survey percentages. |
+| Bar.createLikert | `yDomain` | na | Y is a categorical band axis of questions (L5475-5478). |
+| Bar.createLikert | `xFormat` | na | No tick labels — only dashed grid lines (L5502-5515) and the contextLabels caption row; segment labels use valueFormat. |
+| Bar.createLikert | `yFormat` | na | No y axis; question labels come from categoryAccessor. |
+| Bar.createLikert | `annotations` | supported | x is linear over [-maxExtent, maxExtent] (xLine at 0 = the center axis); y is a band scale of question strings. |
+| Bar.createLikert | `animate` | supported | animate:false renders bars at final size — required when driving frame-to-frame animation via update(). |
+| Bar.createLikert | `nullGaps` | na | No path geometry. |
+| Bar.createLikert | `logX` | na | Diverging axis spans negative values — log is undefined. |
+| Bar.createLikert | `logY` | na | Categorical band axis. |
+| Bar.createLikert | `showGridX` | supported | The emphasized center zero line is part of the same grid group and is removed with it. |
+| Bar.createProgress | `xDomain` | supported | The documented builder-specific maxValue keeps precedence over the universal xMax spelling. With allowNonZeroBaseline and a nonzero domain min, fill bars still start at the axis (range 0) and widths clamp to ≥0; tracks span the full range. Zero-baseline guard: an explicit domain excluding zero is clamped back to include 0 (one console warning) unless allowNonZeroBaseline: true. |
+| Bar.createProgress | `yDomain` | na | Y is a categorical band axis (L4450-4453). |
+| Bar.createProgress | `xFormat` | na | No value axis rendered; value labels use valueFormat. |
+| Bar.createProgress | `yFormat` | na | No y axis; category labels come from categoryAccessor. |
+| Bar.createProgress | `colorMap` | na | Per-value coloring is the colorScale option. |
+| Bar.createProgress | `annotations` | supported | y is a band scale — yLine/yBand values must be category strings. |
+| Bar.createProgress | `nullGaps` | na | No path geometry. |
+| Bar.createProgress | `logX` | na | Zero-baseline progress bars — log value axis is geometrically meaningless. |
+| Bar.createProgress | `logY` | na | Categorical band axis. |
+| Bar.createPyramid | `xDomain` | supported | xMax (alias of the xDomain group) sets maxExtent, the symmetric HALF-width: domain is [-xMax, xMax]. xMin is ignored. Default fits the data (max wing ×1.05) — no Likert 50-percent floor. |
+| Bar.createPyramid | `yDomain` | na | Y is a categorical band axis of categories. |
+| Bar.createPyramid | `xFormat` | na | No tick labels — only dashed grid lines and the contextLabels caption row; segment labels use valueFormat. |
+| Bar.createPyramid | `yFormat` | na | No y axis; category labels come from categoryAccessor. |
+| Bar.createPyramid | `annotations` | supported | x is linear over [-maxExtent, maxExtent] — LEFT-wing positions are negative x values (xLine at 0 = the center axis); y is a band scale of category strings. |
+| Bar.createPyramid | `animate` | supported | animate:false renders bars at final size — required when driving frame-to-frame animation via update(). |
+| Bar.createPyramid | `nullGaps` | na | No path geometry. |
+| Bar.createPyramid | `logX` | na | Diverging axis spans negative values — log is undefined. |
+| Bar.createPyramid | `logY` | na | Categorical band axis. |
+| Bar.createPyramid | `showGridX` | supported | The emphasized center zero line is part of the same grid group and is removed with it. |
+| Bar.createRange | `yDomain` | na | Y is a band scale over row indices. |
+| Bar.createRange | `xFormat` | supported | xFormat only formats the AXIS ticks; valueFormat keeps formatting the tooltip range (and the axis when xFormat is absent). |
+| Bar.createRange | `yFormat` | na | No y axis; row labels come from nameAccessor. |
+| Bar.createRange | `colorMap` | na | A colorAccessor function can implement any value -> color mapping. |
+| Bar.createRange | `annotations` | supported | x is linear over the value axis; y is a band scale over row INDICES, so yLine/yBand values are row indices. |
+| Bar.createRange | `nullGaps` | na | No path geometry. |
+| Bar.createRange | `logY` | na | Categorical band axis. |
+| Bar.createStacked | `xDomain` | supported | With allowNonZeroBaseline and a nonzero domain min, the per-row clip paths clamp segments to the axis (range 0). Zero-baseline guard: an explicit domain excluding zero is clamped back to include 0 (one console warning) unless allowNonZeroBaseline: true. |
+| Bar.createStacked | `yDomain` | na | Y is a categorical band axis (L4991-4994). |
+| Bar.createStacked | `xFormat` | na | No value axis rendered; segment/total labels use valueFormat. |
+| Bar.createStacked | `yFormat` | na | No y axis; category labels come from categoryAccessor. |
+| Bar.createStacked | `annotations` | supported | y is a band scale — yLine/yBand values must be category strings. |
+| Bar.createStacked | `nullGaps` | na | No path geometry. |
+| Bar.createStacked | `logX` | na | Zero-baseline stacked bars — log value axis is geometrically meaningless. |
+| Bar.createStacked | `logY` | na | Categorical band axis. |
+| Bar.createVertical | `xDomain` | na | X is a categorical band axis (L6158-6161). |
+| Bar.createVertical | `yDomain` | supported | Negative values are first-class: the default domain widens to [min*1.1, max*1.1] and columns hang below a zero baseline (drawn when the domain spans both signs), with value labels beneath them. With allowNonZeroBaseline and an explicit domain excluding zero, columns grow from the nearest domain edge, clamped to the plot. Zero-baseline guard: an explicit domain excluding zero is clamped back to include 0 (one console warning) unless allowNonZeroBaseline: true. |
+| Bar.createVertical | `annotations` | supported | x is a band scale — xLine/xBand values must be category strings; yLine takes numbers. |
+| Bar.createVertical | `nullGaps` | na | No path geometry. |
+| Bar.createVertical | `logX` | na | Categorical band axis. |
+| Bar.createVertical | `logY` | na | Zero-baseline columns — a log value axis is geometrically meaningless. |
+| Bar.createVertical | `niceX` | na | Categorical band x. |
+| Bar.createVerticalNormalized | `xDomain` | na | X is a categorical band axis (L6513-6516). |
+| Bar.createVerticalNormalized | `yDomain` | na | Y is definitionally [0, 100] — normalized percentages (L6518-6520); a domain override has no meaning. |
+| Bar.createVerticalNormalized | `annotations` | supported | x is a band scale — xLine/xBand values must be category strings; yLine values are percentages 0-100. |
+| Bar.createVerticalNormalized | `nullGaps` | na | No path geometry. |
+| Bar.createVerticalNormalized | `logX` | na | Categorical band axis. |
+| Bar.createVerticalNormalized | `logY` | na | Fixed 0-100% domain includes 0 — log is undefined. |
+| Bar.createVerticalNormalized | `niceX` | na | Categorical band x. |
+| Bar.createVerticalStacked | `xDomain` | na | X is a categorical band axis (L6318-6321). |
+| Bar.createVerticalStacked | `yDomain` | supported | With allowNonZeroBaseline and a nonzero domain min, the per-category clip paths clamp segments to the baseline. Zero-baseline guard: an explicit domain excluding zero is clamped back to include 0 (one console warning) unless allowNonZeroBaseline: true. |
+| Bar.createVerticalStacked | `annotations` | supported | x is a band scale — xLine/xBand values must be category strings; yLine takes numbers. |
+| Bar.createVerticalStacked | `nullGaps` | na | No path geometry. |
+| Bar.createVerticalStacked | `logX` | na | Categorical band axis. |
+| Bar.createVerticalStacked | `logY` | na | Zero-baseline stacked columns — a log value axis is geometrically meaningless. |
+| Bar.createVerticalStacked | `niceX` | na | Categorical band x. |
+| Bar.createWaterfall | `xDomain` | supported | Overrides the axis window only — bar extents always come from the cumulative math. |
+| Bar.createWaterfall | `yDomain` | na | Y is a band scale over row indices. |
+| Bar.createWaterfall | `xFormat` | supported | xFormat only formats the AXIS ticks; valueFormat keeps formatting the axis when xFormat is absent, plus labels/tooltip. |
+| Bar.createWaterfall | `yFormat` | na | No y axis; row labels come from nameAccessor. |
+| Bar.createWaterfall | `colorMap` | na | A colorAccessor function (receives the computed { start, end, delta, running, kind } step) covers any mapping. |
+| Bar.createWaterfall | `tooltipContent` | supported | tooltipContent(d) receives the step object: the original datum plus computed { start, end, delta, running, kind }. |
+| Bar.createWaterfall | `annotations` | supported | x is linear over the value axis; y is a band scale over row INDICES, so yLine/yBand values are row indices. |
+| Bar.createWaterfall | `nullGaps` | na | No path geometry. |
+| Bar.createWaterfall | `logX` | na | Waterfall bars run through 0 (and running totals can go negative) — log is undefined. |
+| Bar.createWaterfall | `logY` | na | Categorical band axis. |
+| Bar.createWaterfall | `showGridX` | supported | Connector hairlines are separate (.waterfall-connector) and stay; showConnectors: false removes those. |
+| BoxPlot.createBasic | `tooltipValueFormat` | supported | Formatter receives each RAW five-number value (applied per tooltip row). |
+| Calendar.createHeatmap | `tooltipValueFormat` | supported | Formatter receives the RAW aggregated day/period value. |
+| Donut.createBasic | `tooltipValueFormat` | supported | Formatter receives the RAW slice value, not the datum. |
+| Dot.createBasic | `niceX` | unsupported | The rounding itself is documented as the default in the API.md Dot section — only the inability to disable/control it via niceX is the gap. |
+| Dot.createBasic | `showYAxis` | supported | The rowLabel/valueLabel header row and divider are table-style header chrome, not axis elements — they stay. |
+| Dot.createComet | `niceX` | unsupported | The rounding is documented as the default in the API.md Dot section — the gap is that niceX cannot disable/control it. |
+| Dot.createComet | `showYAxis` | supported | The rowLabel/valueLabel header row and divider are table-style header chrome, not axis elements — they stay. |
+| Dot.createConfidence | `niceX` | unsupported | The rounding is documented as the default in the API.md Dot section — the gap is that niceX cannot disable/control it. |
+| Dot.createConfidence | `showYAxis` | supported | The rowLabel/valueLabel header row and divider are table-style header chrome, not axis elements — they stay. |
+| Dot.createConfidence | `showGridX` | supported | The dashed vertical control-reference line is a data annotation, not a gridline — it stays. |
+| Dot.createDumbbell | `niceX` | unsupported | The rounding is documented as the default in the API.md Dot section — the gap is that niceX cannot disable/control it. |
+| Dot.createDumbbell | `showYAxis` | supported | The rowLabel/valueLabel header row and divider are table-style header chrome, not axis elements — they stay. |
+| Dot.createGradient | `niceX` | unsupported | The rounding is documented as the default in the API.md Dot section — the gap is that niceX cannot disable/control it. |
+| Dot.createGradient | `showYAxis` | supported | The rowLabel/valueLabel header row and divider are table-style header chrome, not axis elements — they stay. |
+| Dot.createPercentile | `xFormat` | supported | Axis/label split: xFormat wins for the AXIS ticks only; valueFormat stays the axis default and keeps formatting the drawn value labels and the tooltip fallback. |
+| Dot.createPercentile | `niceX` | unsupported | The padding is documented as the default in the API.md Dot section — the gap is that niceX cannot disable/control it. |
+| Dot.createPercentile | `showYAxis` | supported | The rowLabel/valueLabel header row and divider are table-style header chrome, not axis elements — they stay. |
+| Dot.createUnitHistogram | `tooltipValueFormat` | supported | The formatter receives the bin COUNT; the unitLabel suffix is appended either way. |
+| Histogram.createBasic | `xDomain` | supported | Also pins the binning domain, so bins outside it are cut rather than squeezed. |
+| Histogram.createBasic | `yFormat` | supported | Default depends on mode: counts use ',' grouping; percent/density/cumulative use a % formatter. |
+| Histogram.createBasic | `tooltipValueFormat` | supported | Formatter receives the RAW bin value (count or share), not the datum. |
+| Histogram.createBasic | `linkGroup` | supported | Crosshair guide + shared x-domain only — no linkPoints probe yet, so linked charts show the guide line without dots/labels. |
+| Histogram.createOverlay | `xDomain` | supported | Also pins the shared binning domain across every series. |
+| Histogram.createOverlay | `yFormat` | supported | Default depends on mode: counts use ',' grouping; percent/density/cumulative use a % formatter. |
+| Histogram.createOverlay | `tooltipValueFormat` | supported | Formatter receives the RAW bin value of the hovered series, not the datum. |
+| Histogram.createOverlay | `linkGroup` | supported | Crosshair guide + shared x-domain only — no linkPoints probe yet, so linked charts show the guide line without dots/labels. |
+| Line.createAreaGradient | `tooltipValueFormat` | supported | Formatter receives the DATUM d, not the raw y value (L414). |
+| Line.createAreaGradient | `logX` | supported | Only when x values are numeric — Date/ISO-string detection wins over xScaleType. |
+| Line.createBasic | `tooltipValueFormat` | supported | Formatter receives the DATUM d, not the raw y value (L1566). |
+| Line.createBasic | `logX` | supported | Only when x values are numeric — Date/ISO-string detection wins over xScaleType (L516-523). |
+| Line.createBumpChart | `xFormat` | supported | The formatter receives the raw period STRINGS (point-scale domain values), not numbers/dates. |
+| Line.createBumpChart | `annotations` | supported | x is a point scale — annotation x values must be exact period strings; y values are ranks. |
+| Line.createCombined | `tooltipValueFormat` | supported | Applies to the raw ("Daily") row only and receives the DATUM d (L1919); the moving-average row is hardcoded .toFixed(0) (L1920). |
+| Line.createCombined | `nullGaps` | supported | Raw line only. The moving-average overlay (L1859-1861) has no .defined(), but d3.mean skips invalid values so it only breaks when an entire window is null. |
+| Line.createCombined | `logX` | supported | Only when x values are numeric — Date/ISO-string detection wins over xScaleType. |
+| Line.createCumulativeVsMoving | `tooltipValueFormat` | supported | Formatter receives the RAW NUMBER (applied to cumulative, moving, and the diff note separately) — not the datum. |
+| Line.createCumulativeVsMoving | `nullGaps` | supported | Each line breaks on its own null/NaN; the hot/cold shaded area (and its clip paths) breaks where EITHER series is missing. |
+| Line.createCumulativeVsMoving | `logX` | supported | Only when x values are numeric — Date/ISO-string detection wins over xScaleType. |
+| Line.createDynamicBand | `tooltipValueFormat` | supported | Formatter receives the RAW NUMBER (applied to actual, forecast, lower, upper separately) — not the datum. |
+| Line.createDynamicBand | `nullGaps` | supported | The documented null-padded shape renders cleanly: the forecast line and band break where forecast (or a bound) is null/NaN; the actual line breaks on its own nulls. |
+| Line.createDynamicBand | `logX` | supported | Only when x values are numeric — Date/ISO-string detection wins over xScaleType. |
+| Line.createForecastBand | `tooltipValueFormat` | supported | Formatter receives the RAW NUMBER (applied to actual, lower, upper separately) — not the datum. |
+| Line.createForecastBand | `nullGaps` | supported | The actual line breaks on its own null/NaN; the confidence band breaks where either bound is null/NaN. |
+| Line.createForecastBand | `logX` | supported | Only when x values are numeric — Date/ISO-string detection wins over xScaleType. |
+| Line.createGrowthRate | `yDomain` | supported | Default is symmetric around zero and never .nice()d (nicing could break symmetry). |
+| Line.createGrowthRate | `tooltipValueFormat` | supported | Formatter receives the DATUM d, not the raw value (L2472); default renders "+X.X%". |
+| Line.createGrowthRate | `logX` | supported | Only when x values are numeric — Date/ISO-string detection wins over xScaleType. |
+| Line.createMulti | `showTooltip` | supported | Shared hover-line tooltip works regardless of showPoints; per-point dots only enlarge on hover, they carry no tooltip of their own. |
+| Line.createMulti | `tooltipValueFormat` | supported | Formatter receives the raw y VALUE (L484-486), unlike the single-line builders which pass the datum. |
+| Line.createMulti | `logX` | supported | Only when x values are numeric — Date/ISO-string detection wins over xScaleType. |
+| Line.createPulseAnomalies | `tooltipValueFormat` | supported | Formatter receives the RAW NUMBER (applied to actual, lower, upper separately) — not the datum. |
+| Line.createPulseAnomalies | `animate` | supported | Gates the CONTINUOUS pulse rings (base.css owns the keyframes; prefers-reduced-motion also stops them). No entrance animation — animate: false renders static rings. |
+| Line.createPulseAnomalies | `nullGaps` | supported | The actual line breaks on its own null/NaN; the confidence band breaks where either bound is null/NaN. |
+| Line.createPulseAnomalies | `logX` | supported | Only when x values are numeric — Date/ISO-string detection wins over xScaleType. |
+| Line.createSmoothed | `tooltipValueFormat` | supported | Formatter receives the DATUM d, not the raw y value (L414). |
+| Line.createSmoothed | `nullGaps` | supported | curveBasis interpolates across each defined segment; gaps still split the path. |
+| Line.createSmoothed | `logX` | supported | Only when x values are numeric — Date/ISO-string detection wins over xScaleType. |
+| Line.createTextures | `yDomain` | supported | Reads opts.yDomain only (not computeYDomain). yMin/yMax work only when BOTH are passed — the wrapper synthesizes yDomain from the pair (L11687); a single yMin or yMax alone is ignored. |
+| Line.createTextures | `showTooltip` | supported | Hover looks up the SAME index in every series (L2198) — series need aligned point counts. |
+| Line.createTextures | `tooltipValueFormat` | supported | Formatter receives the DATUM d, not the raw y value (L2206). |
+| Line.createTextures | `logX` | supported | Only when x values are numeric — Date/ISO-string detection wins over xScaleType. |
+| Line.createTextures | `linkGroup` | supported | Crosshair guide + shared x-domain only — no linkPoints probe yet, so linked charts show the guide line without dots/labels. |
+| Line.createYearly | `tooltipValueFormat` | supported | Formatter receives the DATUM d, not the raw y value (L414). |
+| Line.createYearly | `logX` | supported | Only when x values are numeric — Date/ISO-string detection wins over xScaleType. |
+| Line.createYoY | `showTooltip` | supported | Shared addMultiHoverTooltip overlay — per-series nearest-x bisect, so series with unequal point counts are safe. |
+| Line.createYoY | `tooltipValueFormat` | supported | Formatter receives the raw y VALUE (cross-builder convention). |
+| Line.createYoY | `logX` | supported | Only when x values are numeric — Date/ISO-string detection wins over xScaleType. |
+| Sankey.createBasic | `tooltipValueFormat` | supported | Formatter receives the RAW link or node value, not the datum. |
+| Sankey.createBasic | `animate` | supported | Load flow-sweep: roots fade in, links draw column by column (ribbons dash-draw, tapers clip-reveal), each node/label reveals when its last incoming ribbon completes, and the flow pauses at every node before flowing on. |
+| Scatter.createAnimated | `annotations` | supported | Annotations stay anchored to the scales while the random walk moves dots away from their data positions. |
+| Scatter.createAnimated | `animate` | supported | animate:false renders static dots (no interval). The wrapper injects animate:false on resize so the walk does not restart mid-resize, and stopResultAnimation/destroy call stopAnimation() to clear the interval (L11716-11720). Caveat: createBasic's entrance radius transition still replays regardless (see createBasic animate defect). |
+| Scatter.createAnimated | `nullGaps` | na | Point cloud; trails are synthetic animation artifacts, not data paths. |
+| Scatter.createBasic | `colorMap` | supported | Categories missing from the map fall back to the ordinal `colors` palette. |
+| Scatter.createBasic | `tooltipValueFormat` | unsupported | CLAUDE.md claims tooltipValueFormat universally — tension with the API.md scatter carve-out. (The dead `valueFormat` combined formatter was removed 2026-08-22 — tooltip rows use xFormat/yFormat.) |
+| Scatter.createBasic | `annotations` | supported | When the entrance animation runs, point/callout annotations fade in only after their anchor dot's entrance transition lands (matched by data-space x/y via the internal _entranceDelayFor hook read by drawAnnotations; unmatched points wait for the full entrance). Lines/bands draw immediately. |
+| Scatter.createBasic | `nullGaps` | na | Point cloud — no connecting path geometry. |
+| Scatter.createBasic | `linkGroup` | supported | Crosshair guide + shared x-domain only — no linkPoints probe yet, so linked charts show the guide line without dots/labels. |
+| Scatter.createBeeswarm | `yDomain` | na | Y is a categorical band scale (rows); no numeric domain to pin. |
+| Scatter.createBeeswarm | `yFormat` | na | Categorical band axis renders raw category names (d3.axisLeft(yBand), L7739). |
+| Scatter.createBeeswarm | `annotations` | supported | y is the category band scale (yBand alias) — yLine/yBand values must be category names; a yLine sits at the band top edge, not its center. |
+| Scatter.createBeeswarm | `nullGaps` | na | Point cloud — no connecting path geometry. |
+| Scatter.createBeeswarmHorizontal | `yDomain` | na | No y axis — vertical position is the dodge offset around the center line. |
+| Scatter.createBeeswarmHorizontal | `yLabel` | na | No y axis to title. |
+| Scatter.createBeeswarmHorizontal | `color` | supported | colorAccessor wins over color/colors (L8089-8091); in logo mode color has no effect (marks are images). |
+| Scatter.createBeeswarmHorizontal | `annotations` | supported | Use xLine/xBand on the value axis. There is no y axis — y is a constant row-center callable, so yLine/yBand all land on the center line. |
+| Scatter.createBeeswarmHorizontal | `nullGaps` | na | Point cloud — no connecting path geometry. |
+| Scatter.createBeeswarmHorizontal | `showGridX` | supported | The pre-existing builder option showGrid: false skips drawing the grid entirely; the central showGridX removal is then a harmless no-op. |
+| Scatter.createBeeswarmLogos | `xDomain` | na | No x axis — horizontal position is the dodge offset around the center line. |
+| Scatter.createBeeswarmLogos | `xLabel` | na | No x axis to title. |
+| Scatter.createBeeswarmLogos | `color` | na | Marks are images — no color encoding at all in this builder (no colorScale). |
+| Scatter.createBeeswarmLogos | `annotations` | supported | Use yLine/yBand on the value axis. There is no x axis — x is a constant column-center callable, so xLine/xBand all land on the center line. |
+| Scatter.createBeeswarmLogos | `nullGaps` | na | Point cloud (images) — no connecting path geometry. |
+| Scatter.createBeeswarmLogos | `niceX` | na | No x axis. |
+| Scatter.createBeeswarmLogos | `showGridY` | supported | The pre-existing builder option showGrid: false skips drawing the grid entirely; the central showGridY removal is then a harmless no-op. |
+| Scatter.createBeeswarmVertical | `xDomain` | na | X is a categorical band scale (columns) or the single-column center + dodge offset; no numeric x domain. |
+| Scatter.createBeeswarmVertical | `xFormat` | na | Categorical band axis (raw category names, L7871) or no x axis at all in singleColumn mode. |
+| Scatter.createBeeswarmVertical | `color` | supported | colorAccessor wins over color/colors when provided (L7918-7920). |
+| Scatter.createBeeswarmVertical | `annotations` | supported | yLine/yBand on the numeric value axis are the useful ones. x is the category band scale (xLine values must be category names; line at the band left edge) — or a constant column-center callable in singleColumn mode. |
+| Scatter.createBeeswarmVertical | `nullGaps` | na | Point cloud — no connecting path geometry. |
+| Scatter.createBeeswarmVertical | `niceX` | na | Band/categorical x (or none in singleColumn mode). |
+| Scatter.createBeeswarmVertical | `showXAxis` | na | In category mode the band x axis IS tagged .axis-x (L8240) and the central toggle removes it. |
+| Scatter.createBeeswarmVertical | `showGridY` | supported | The pre-existing builder option showGrid: false skips drawing the grid entirely; the central showGridY removal is then a harmless no-op. |
+| Scatter.createComet | `xDomain` | supported | Wave 3 of docs/stress-test.md found this silently ignored; the fix is present — override wins over the padded extent. |
+| Scatter.createComet | `nullGaps` | na | Each comet is a single tail-to-head segment (two fixed endpoints) — no multi-point path for a gap to break. |
+| Scatter.createContour | `tooltipContent` | supported | The datum passed to tooltipContent is the cursor position {x, y} (scale-inverted values, L8834-8836), not a data record. |
+| Scatter.createDiagonal | `xDomain` | supported | reverseX interplay: an explicit xDomain array is used exactly AS GIVEN — reverseX does not re-flip it, the caller controls the order (and passing both xMin AND xMax is normalized into an xDomain by the wrapper, so it behaves the same). A LONE xMin/xMax pins that value end of the padded extent BEFORE the reverseX flip. |
+| Scatter.createDiagonal | `linkGroup` | supported | Crosshair guide + shared x-domain only — no linkPoints probe yet, so linked charts show the guide line without dots/labels. |
+| Scatter.createHeatmap | `xDomain` | supported | Density mode only; defaults to the data extent (lone xMin/xMax pin an end). Categorical mode builds a band scale from the data values; the override is meaningless there. |
+| Scatter.createHeatmap | `yDomain` | supported | Same as xDomain: density mode only, defaults to the data extent; categorical mode is a band scale. |
+| Scatter.createHeatmap | `tooltipValueFormat` | supported | Categorical mode only — the density-mode tooltip hardcodes "{count} points" (L8464-8465) and ignores the formatter. |
+| Scatter.createHeatmap | `annotations` | supported | In categorical mode x/y are band scales: xLine/yLine values must be exact domain members (non-members are skipped as non-finite). |
+| Scatter.createHexbin | `tooltipValueFormat` | supported | The formatter receives the hovered hex's point COUNT; "{n} points" stays the default. |
+| Scatter.createKDE | `showTooltip` | supported | Tooltip only exists when showDots !== false (the whole dot layer including hover targets is skipped otherwise, L9970). |
+| Scatter.createLogos | `color` | na | Marks are images — no color encoding at all in this builder. |
+| Scatter.createLogos | `annotations` | supported | When the entrance fade runs, point/callout annotations fade in only after their anchor logo's entrance lands (matched by data-space x/y via the internal _entranceDelayFor hook read by drawAnnotations; unmatched points wait for the full entrance). Lines/bands draw immediately. |
+| Scatter.createLogos | `nullGaps` | na | Point cloud (images) — no connecting path geometry. |
+| Scatter.createQuadrant | `linkGroup` | supported | Crosshair guide + shared x-domain only — no linkPoints probe yet, so linked charts show the guide line without dots/labels. |
+| Scatter.createQuadrant | `showGridX` | supported | The pre-existing builder option showGrid: false skips drawing BOTH grids; the central showGridX/showGridY removal is then a harmless no-op. With showGrid left on, each central toggle removes only its own grid. |
+| Scatter.createQuadrant | `showGridY` | supported | Same showGrid interplay as showGridX. |
+| Slope.createAnimated | `animate` | supported | Animates by default on this variant; opt out with animate:false. The wrapper-injected animate:false on resize re-renders wins over the default, so entrance animation runs on fresh load only, not on every resize. |
+| Slope.createBands | `yDomain` | supported | Default scale is the bands [0, 100]; yDomain replaces it outright and a lone yMin/yMax pins one end of that default. |
+| Table.createBasic | `showTooltip` | na | No tooltip system in D3Table — the file-header feature list (d3-table.js L10 "Tooltips") is stale; no tooltip code or config read exists. |
+| Table.createBasic | `annotations` | na | No svg/x/y returned; wrapper drawAnnotations requires cartesian scales. |
+| Table.createBasic | `onRender` | na | Wrapper-level hook; Table builders are not responsive-wrapped. |
+| Table.createCombined | `showTooltip` | na | No tooltip system in D3Table — the file-header feature list (d3-table.js L10 "Tooltips") is stale; no tooltip code or config read exists. |
+| Table.createCombined | `annotations` | na | No svg/x/y returned; wrapper drawAnnotations requires cartesian scales. |
+| Table.createCombined | `onRender` | na | Wrapper-level hook; Table builders are not responsive-wrapped. |
+| Table.createSortable | `showTooltip` | na | No tooltip system in D3Table — the file-header feature list (d3-table.js L10 "Tooltips") is stale; no tooltip code or config read exists. |
+| Table.createSortable | `annotations` | na | No svg/x/y returned; wrapper drawAnnotations requires cartesian scales. |
+| Table.createSortable | `onRender` | na | Wrapper-level hook; Table builders are not responsive-wrapped. |
+| Table.createWithBars | `showTooltip` | na | No tooltip system in D3Table — the file-header feature list (d3-table.js L10 "Tooltips") is stale; no tooltip code or config read exists. |
+| Table.createWithBars | `annotations` | na | No svg/x/y returned; wrapper drawAnnotations requires cartesian scales. |
+| Table.createWithBars | `onRender` | na | Wrapper-level hook; Table builders are not responsive-wrapped. |
+| Table.createWithHeatmap | `showTooltip` | na | No tooltip system in D3Table — the file-header feature list (d3-table.js L10 "Tooltips") is stale; no tooltip code or config read exists. |
+| Table.createWithHeatmap | `annotations` | na | No svg/x/y returned; wrapper drawAnnotations requires cartesian scales. |
+| Table.createWithHeatmap | `onRender` | na | Wrapper-level hook; Table builders are not responsive-wrapped. |
+
+## Universal option definitions
+
+| Key | "Supported" means |
+|---|---|
+| `xDomain` | xDomain / xMin / xMax pin the x scale domain (wrapper normalizes spellings; builder must apply) |
+| `yDomain` | yDomain / yMin / yMax pin the y scale domain |
+| `xFormat` | xFormat overrides x axis tick formatting |
+| `yFormat` | yFormat overrides y axis tick formatting |
+| `xLabel` | xLabel renders an x axis title |
+| `yLabel` | yLabel renders a y axis title |
+| `color` | color (singular) overrides the primary color / seeds the categorical range |
+| `colors` | colors (plural) overrides the multi-series palette |
+| `colorMap` | colorMap maps category values to explicit colors |
+| `showTooltip` | showTooltip: false disables the built-in tooltip |
+| `tooltipContent` | tooltipContent(d) replaces the tooltip HTML |
+| `tooltipValueFormat` | tooltipValueFormat (alias tooltipFormat) formats tooltip values |
+| `annotations` | annotations array is drawn post-render (requires returning svg + x + y scales) |
+| `extraLayers` | extraLayers: [{type: 'points'|'line'|'bars', data?, x, y, ...}] draws extra mark series with the chart's live scales post-render, clipped to the plot, re-drawn on resize (requires returning svg + x + y scales) |
+| `onRender` | onRender(chart) fires after every render (wrapper-level; all wrapped builders) |
+| `title` | title renders a shell heading above the chart (wrapper-level; all wrapped builders) |
+| `subtitle` | subtitle renders shell secondary text under the title (wrapper-level) |
+| `footer` | footer renders a shell footer strip below the chart — string or {left, right} (wrapper-level) |
+| `story` | story renders a narrative summary module below the chart, above the footer — html string (shorthand for variant 'panel') or { html, variant: 'panel'|'bubble'|'band', label?, icon?, accent? } (wrapper-level) |
+| `legend` | legend renders a createLegend strip below the chart — {items, colors} or true to derive from keys/labels (wrapper-level) |
+| `featured` | featured: true switches shell title/subtitle from the 15/11 card tier to the 20/14 featured tier (wrapper-level) |
+| `state` | state: 'loading' | 'empty' | 'error' renders a built-in state (family-aware loading skeleton, quiet empty/error messages) instead of the chart; empty data auto-renders 'empty' (wrapper-level) |
+| `emptyMessage` | emptyMessage overrides the empty-state primary text (wrapper-level) |
+| `errorMessage` | errorMessage overrides the error-state primary text (wrapper-level) |
+| `animate` | animate (alias animated) toggles entrance animation |
+| `nullGaps` | null/NaN y values break paths cleanly via .defined() instead of drawing to zero |
+| `logX` | xScaleType: 'log' switches the x scale to log |
+| `logY` | yScaleType: 'log' switches the y scale to log |
+| `niceX` | niceX: true rounds the x domain out to the next tick interval (default: exact data extent) |
+| `linkGroup` | linkGroup: 'name' (or { name, labels?, sharedX? }) enrolls the chart in a linked-hover group: shared snapped crosshair across members (dots + value labels where the builder provides a linkPoints probe) and a shared union x-domain (sharedX: false or an explicit xDomain opts out) |
+| `brush` | brush: true | { mode: 'highlight'|'zoom', onBrush } puts a d3.brushX range selection on the plot; the selection survives re-renders and broadcasts through the chart's linkGroup (highlight = veil outside the range on members; zoom = members pin their x-domain to the range); onBrush(range|null, chart) fires live while the user scrubs and again on gesture end; facade setBrush(range|null) drives it programmatically |
+| `showXAxis` | showXAxis: false removes the x-axis group (.axis-x) on every render (margins unchanged) |
+| `showYAxis` | showYAxis: false removes the y-axis group (.axis-y) |
+| `showGridX` | showGridX: false removes vertical gridlines (.grid-x) |
+| `showGridY` | showGridY: false removes horizontal gridlines (.grid-y, legacy .grid) |
+| `showAxisLabels` | showAxisLabels: false removes tick-label text inside axis groups (tick/domain lines and xLabel/yLabel titles stay) |
+| `xTickValues` | xTickValues: [...] pins explicit tick values on a continuous x axis |
+| `yTickValues` | yTickValues: [...] pins explicit tick values on a continuous y axis |