semiotic 3.8.5 → 3.8.7

package/ai/schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "name": "semiotic",
-  "version": "3.8.5",
+  "version": "3.8.7",
   "description": "React data visualization library for charts, networks, and beyond",
   "tools": [
     {
@@ -62,6 +62,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -234,7 +255,7 @@
             },
             "xAccessor": {
               "type": "string",
-              "description": "Key or accessor function for x-axis values",
+              "description": "Key or accessor function for x-axis values. Functions can derive a value, e.g. `d => d.timestamp`.",
               "default": "x",
               "x-semiotic-runtime-types": [
                 "string",
@@ -243,7 +264,7 @@
             },
             "yAccessor": {
               "type": "string",
-              "description": "Key or accessor function for y-axis values",
+              "description": "Key or accessor function for y-axis values. Functions support dynamic lookups, e.g. `d => d[d.metricLabel]`.",
               "default": "y",
               "x-semiotic-runtime-types": [
                 "string",
@@ -294,6 +315,14 @@
               "description": "Radius of point markers when showPoints is true",
               "default": 3
             },
+            "pointIdAccessor": {
+              "type": "string",
+              "description": "Stable ID for point annotations and push-mode remove()/update().",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
             "fillArea": {
               "type": "boolean",
               "description": "Fill the area under the line",
@@ -304,6 +333,27 @@
               "description": "Opacity of the filled area (0-1)",
               "default": 0.3
             },
+            "lineGradient": {
+              "type": "object",
+              "description": "Left-to-right stroke gradient: { stops: [{ offset: 0-1, color?, opacity? }] }."
+            },
+            "directLabel": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Place series labels at their start or end points instead of relying only on a legend."
+            },
+            "gapStrategy": {
+              "type": "string",
+              "enum": [
+                "break",
+                "interpolate",
+                "zero"
+              ],
+              "description": "How missing y values are rendered: break the line, interpolate across them, or drop to zero.",
+              "default": "break"
+            },
             "forecast": {
               "type": "object",
               "description": "Forecast overlay config — tagged training/observed/forecast region with optional envelope. See ForecastConfig."
@@ -318,6 +368,14 @@
                 "array"
               ],
               "description": "Asymmetric min/max envelope drawn under the line. `{ y0Accessor, y1Accessor, style?, perSeries?, interactive? }` or an array of those for percentile fans. Distinct from `forecast`/`anomaly` (computed) — band is pure data passthrough. Hovered datum is enriched with `band: { y0, y1 }` and `bands: [...]`."
+            },
+            "xExtent": {
+              "type": "array",
+              "description": "Fixed x domain `[min, max]`; either bound may be omitted."
+            },
+            "yExtent": {
+              "type": "array",
+              "description": "Fixed y domain `[min, max]`; either bound may be omitted."
             }
           },
           "required": [
@@ -384,6 +442,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -600,16 +679,30 @@
               ],
               "default": "monotoneX"
             },
+            "y0Accessor": {
+              "type": "string",
+              "description": "Lower bound accessor for a ribbon/interval area instead of the chart baseline.",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
             "gradientFill": {
-              "type": [
-                "boolean",
-                "object"
-              ],
-              "description": "Renderer-space area gradient. true uses default opacity; object supports opacity or colorStops."
+              "type": "object",
+              "description": "Line-to-baseline gradient: { stops: [{ offset: 0-1, color?, opacity? }] }. Offset 0 is the line/top and offset 1 is the baseline."
             },
             "semanticGradient": {
-              "type": "array",
-              "description": "User-facing gradient stops: [{ at: 0-100, color, opacity? }], where 0 is baseline and 100 is line/top. Takes precedence over gradientFill."
+              "type": "object",
+              "description": "Value-anchored gradient: { stops: [{ offset: 0-1, color?, opacity? }] }. Offset 0 is the y-domain minimum and offset 1 is the maximum. Takes precedence over gradientFill."
+            },
+            "semanticLine": {
+              "type": "boolean",
+              "description": "Mirror semanticGradient on the area's top-edge stroke as solid, hard-edged value bands. Set false to keep the normal stroke or lineGradient.",
+              "default": true
+            },
+            "lineGradient": {
+              "type": "object",
+              "description": "Left-to-right stroke gradient: { stops: [{ offset: 0-1, color?, opacity? }] }."
             },
             "areaOpacity": {
               "type": "number",
@@ -625,6 +718,23 @@
               "type": "number",
               "default": 2
             },
+            "showPoints": {
+              "type": "boolean",
+              "description": "Show point markers along area lines.",
+              "default": false
+            },
+            "pointRadius": {
+              "type": "number",
+              "default": 3
+            },
+            "pointIdAccessor": {
+              "type": "string",
+              "description": "Stable ID for point annotations and push-mode remove()/update().",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
             "forecast": {
               "type": "object",
               "description": "Forecast overlay config — tagged training/observed/forecast region with optional envelope. See ForecastConfig."
@@ -639,6 +749,14 @@
                 "array"
               ],
               "description": "Asymmetric min/max envelope drawn under the area. See LineChart.band — same shape, same enrichment."
+            },
+            "xExtent": {
+              "type": "array",
+              "description": "Fixed x domain `[min, max]`; either bound may be omitted."
+            },
+            "yExtent": {
+              "type": "array",
+              "description": "Fixed y domain `[min, max]`; either bound may be omitted."
             }
           },
           "required": [
@@ -705,6 +823,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -930,10 +1069,58 @@
               "type": "number",
               "default": 2
             },
+            "showPoints": {
+              "type": "boolean",
+              "description": "Show point markers along stacked area lines.",
+              "default": false
+            },
+            "pointRadius": {
+              "type": "number",
+              "default": 3
+            },
             "normalize": {
               "type": "boolean",
               "description": "Normalize stacks to 100%",
               "default": false
+            },
+            "baseline": {
+              "type": "string",
+              "enum": [
+                "zero",
+                "wiggle",
+                "silhouette",
+                "diverging"
+              ],
+              "description": "Stack baseline; use wiggle or silhouette for a streamgraph.",
+              "default": "zero"
+            },
+            "stackOrder": {
+              "type": "string",
+              "enum": [
+                "key",
+                "input",
+                "insideOut",
+                "asc",
+                "desc"
+              ],
+              "description": "Series ordering within the stack.",
+              "default": "key"
+            },
+            "pointIdAccessor": {
+              "type": "string",
+              "description": "Stable ID for point annotations and push-mode remove()/update().",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "xExtent": {
+              "type": "array",
+              "description": "Fixed x domain `[min, max]`; either bound may be omitted."
+            },
+            "yExtent": {
+              "type": "array",
+              "description": "Fixed y domain `[min, max]`; either bound may be omitted."
             }
           },
           "required": [
@@ -1001,6 +1188,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -1224,6 +1432,22 @@
               "type": "number",
               "default": 0.8
             },
+            "pointIdAccessor": {
+              "type": "string",
+              "description": "Stable ID for point annotations and push-mode remove()/update().",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "xExtent": {
+              "type": "array",
+              "description": "Fixed x domain `[min, max]`; either bound may be omitted."
+            },
+            "yExtent": {
+              "type": "array",
+              "description": "Fixed y domain `[min, max]`; either bound may be omitted."
+            },
             "regression": {
               "type": [
                 "boolean",
@@ -1305,6 +1529,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -1555,6 +1800,14 @@
             "pointOpacity": {
               "type": "number",
               "default": 0.8
+            },
+            "pointIdAccessor": {
+              "type": "string",
+              "description": "Stable ID for point annotations and push-mode remove()/update().",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
             }
           },
           "required": []
@@ -1619,6 +1872,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -1871,6 +2145,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -2085,6 +2380,22 @@
             "candlestickStyle": {
               "type": "object",
               "description": "Style overrides."
+            },
+            "pointIdAccessor": {
+              "type": "string",
+              "description": "Stable ID for point annotations and push-mode remove()/update().",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "xExtent": {
+              "type": "array",
+              "description": "Fixed x domain `[min, max]`; either bound may be omitted."
+            },
+            "yExtent": {
+              "type": "array",
+              "description": "Fixed y domain `[min, max]`; either bound may be omitted."
             }
           },
           "required": [
@@ -2152,6 +2463,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -2365,15 +2697,31 @@
               "type": "string",
               "default": "white"
             },
-            "regression": {
-              "type": [
-                "boolean",
+            "pointIdAccessor": {
+              "type": "string",
+              "description": "Stable ID for point annotations and push-mode remove()/update().",
+              "x-semiotic-runtime-types": [
                 "string",
-                "object"
-              ],
-              "description": "Overlay a regression line on the bubbles. Same shape as Scatterplot's regression prop."
-            }
-          },
+                "function"
+              ]
+            },
+            "xExtent": {
+              "type": "array",
+              "description": "Fixed x domain `[min, max]`; either bound may be omitted."
+            },
+            "yExtent": {
+              "type": "array",
+              "description": "Fixed y domain `[min, max]`; either bound may be omitted."
+            },
+            "regression": {
+              "type": [
+                "boolean",
+                "string",
+                "object"
+              ],
+              "description": "Overlay a regression line on the bubbles. Same shape as Scatterplot's regression prop."
+            }
+          },
           "required": [
             "data",
             "sizeBy"
@@ -2439,6 +2787,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position of the gradient legend",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -2641,11 +3010,6 @@
               "description": "Display numeric values in cells",
               "default": false
             },
-            "valueFormat": {
-              "x-semiotic-runtime-types": [
-                "function"
-              ]
-            },
             "cellBorderColor": {
               "type": "string",
               "default": "#fff"
@@ -2654,16 +3018,21 @@
               "type": "number",
               "default": 1
             },
-            "legendPosition": {
+            "pointIdAccessor": {
               "type": "string",
-              "enum": [
-                "right",
-                "left",
-                "top",
-                "bottom"
-              ],
-              "description": "Position of the gradient legend",
-              "default": "right"
+              "description": "Stable ID for point annotations and push-mode remove()/update().",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "xExtent": {
+              "type": "array",
+              "description": "Fixed x domain `[min, max]`; either bound may be omitted."
+            },
+            "yExtent": {
+              "type": "array",
+              "description": "Fixed y domain `[min, max]`; either bound may be omitted."
             }
           },
           "required": [
@@ -2730,6 +3099,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -2943,6 +3333,14 @@
                 "function"
               ]
             },
+            "xExtent": {
+              "type": "array",
+              "description": "Fixed x domain `[min, max]`; either bound may be omitted."
+            },
+            "yExtent": {
+              "type": "array",
+              "description": "Fixed y domain `[min, max]`; either bound may be omitted."
+            },
             "regression": {
               "type": [
                 "boolean",
@@ -3024,6 +3422,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -3172,10 +3591,9 @@
             "valueLabel": {
               "type": "string"
             },
-            "valueFormat": {
-              "x-semiotic-runtime-types": [
-                "function"
-              ]
+            "showCategoryTicks": {
+              "type": "boolean",
+              "description": "Show category labels on the ordinal axis."
             },
             "data": {
               "type": "array",
@@ -3224,6 +3642,10 @@
               "type": "number",
               "default": 40
             },
+            "gradientFill": {
+              "type": "object",
+              "description": "Tip-to-base gradient: { stops: [{ offset: 0-1, color?, opacity? }] }."
+            },
             "regression": {
               "type": [
                 "boolean",
@@ -3298,6 +3720,27 @@
               "type": "boolean",
               "default": true
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -3446,10 +3889,9 @@
             "valueLabel": {
               "type": "string"
             },
-            "valueFormat": {
-              "x-semiotic-runtime-types": [
-                "function"
-              ]
+            "showCategoryTicks": {
+              "type": "boolean",
+              "description": "Show category labels on the ordinal axis."
             },
             "data": {
               "type": "array",
@@ -3495,6 +3937,10 @@
             "barPadding": {
               "type": "number",
               "default": 40
+            },
+            "gradientFill": {
+              "type": "object",
+              "description": "Tip-to-base gradient: { stops: [{ offset: 0-1, color?, opacity? }] }."
             }
           },
           "required": [
@@ -3562,6 +4008,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -3710,10 +4177,9 @@
             "valueLabel": {
               "type": "string"
             },
-            "valueFormat": {
-              "x-semiotic-runtime-types": [
-                "function"
-              ]
+            "showCategoryTicks": {
+              "type": "boolean",
+              "description": "Show category labels on the ordinal axis."
             },
             "data": {
               "type": "array",
@@ -3841,6 +4307,27 @@
               "type": "boolean",
               "default": true
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -3989,10 +4476,9 @@
             "valueLabel": {
               "type": "string"
             },
-            "valueFormat": {
-              "x-semiotic-runtime-types": [
-                "function"
-              ]
+            "showCategoryTicks": {
+              "type": "boolean",
+              "description": "Show category labels on the ordinal axis."
             },
             "data": {
               "type": "array",
@@ -4033,6 +4519,10 @@
             "barPadding": {
               "type": "number",
               "default": 60
+            },
+            "gradientFill": {
+              "type": "object",
+              "description": "Tip-to-base gradient: { stops: [{ offset: 0-1, color?, opacity? }] }."
             }
           },
           "required": [
@@ -4100,6 +4590,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -4248,10 +4759,9 @@
             "valueLabel": {
               "type": "string"
             },
-            "valueFormat": {
-              "x-semiotic-runtime-types": [
-                "function"
-              ]
+            "showCategoryTicks": {
+              "type": "boolean",
+              "description": "Show category labels on the ordinal axis."
             },
             "data": {
               "type": "array",
@@ -4385,6 +4895,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -4533,10 +5064,9 @@
             "valueLabel": {
               "type": "string"
             },
-            "valueFormat": {
-              "x-semiotic-runtime-types": [
-                "function"
-              ]
+            "showCategoryTicks": {
+              "type": "boolean",
+              "description": "Show category labels on the ordinal axis."
             },
             "data": {
               "type": "array",
@@ -4644,6 +5174,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -4792,10 +5343,9 @@
             "valueLabel": {
               "type": "string"
             },
-            "valueFormat": {
-              "x-semiotic-runtime-types": [
-                "function"
-              ]
+            "showCategoryTicks": {
+              "type": "boolean",
+              "description": "Show category labels on the ordinal axis."
             },
             "data": {
               "type": "array",
@@ -4896,6 +5446,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -5044,10 +5615,9 @@
             "valueLabel": {
               "type": "string"
             },
-            "valueFormat": {
-              "x-semiotic-runtime-types": [
-                "function"
-              ]
+            "showCategoryTicks": {
+              "type": "boolean",
+              "description": "Show category labels on the ordinal axis."
             },
             "data": {
               "type": "array",
@@ -5161,15 +5731,36 @@
             "showLegend": {
               "type": "boolean"
             },
-            "showGrid": {
-              "type": "boolean",
-              "default": false
-            },
-            "colorBy": {
+            "legendInteraction": {
               "type": "string",
-              "x-semiotic-runtime-types": [
-                "string",
-                "function"
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
+            "showGrid": {
+              "type": "boolean",
+              "default": false
+            },
+            "colorBy": {
+              "type": "string",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
               ]
             },
             "colorScheme": {
@@ -5309,10 +5900,9 @@
             "valueLabel": {
               "type": "string"
             },
-            "valueFormat": {
-              "x-semiotic-runtime-types": [
-                "function"
-              ]
+            "showCategoryTicks": {
+              "type": "boolean",
+              "description": "Show category labels on the ordinal axis."
             },
             "data": {
               "type": "array",
@@ -5408,6 +5998,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": true
@@ -5556,10 +6167,9 @@
             "valueLabel": {
               "type": "string"
             },
-            "valueFormat": {
-              "x-semiotic-runtime-types": [
-                "function"
-              ]
+            "showCategoryTicks": {
+              "type": "boolean",
+              "description": "Show category labels on the ordinal axis."
             },
             "data": {
               "type": "array",
@@ -5683,6 +6293,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -5915,6 +6546,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -6159,6 +6811,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -6315,11 +6988,31 @@
             },
             "thresholds": {
               "type": "array",
-              "description": "Array of { value, color, label? } defining threshold zones. Last value should equal max."
+              "description": "Array of { value, color, label? } defining threshold zones. This is GaugeChart's wire format; BigNumber instead uses { at, level, color?, label? }. Last value should equal max.",
+              "minItems": 1,
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "value",
+                  "color"
+                ],
+                "properties": {
+                  "value": {
+                    "type": "number"
+                  },
+                  "color": {
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  }
+                }
+              }
             },
             "gradientFill": {
               "type": "object",
-              "description": "Arc-length gradient for the gauge band. Color stops are sampled along the sweep from start to end."
+              "description": "Sweep gradient: { stops: [{ offset: 0-1, color?, opacity? }] }. Offset 0 is the sweep start and offset 1 is the sweep end."
             },
             "arcWidth": {
               "type": "number",
@@ -6347,11 +7040,6 @@
             "needleColor": {
               "type": "string"
             },
-            "valueFormat": {
-              "x-semiotic-runtime-types": [
-                "function"
-              ]
-            },
             "showScaleLabels": {
               "type": "boolean",
               "default": true
@@ -6421,6 +7109,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -6571,7 +7280,7 @@
               "type": "array",
               "description": "Array of edge objects with source and target"
             },
-            "nodeIDAccessor": {
+            "nodeIdAccessor": {
               "type": "string",
               "description": "Key for node unique identifier",
               "default": "id",
@@ -6647,6 +7356,14 @@
               "type": "number",
               "default": 0.6
             },
+            "nodeStroke": {
+              "type": "string",
+              "description": "Node-only outline color; overrides the generic stroke for nodes."
+            },
+            "nodeStrokeWidth": {
+              "type": "number",
+              "description": "Node-only outline width; overrides generic strokeWidth for nodes."
+            },
             "iterations": {
               "type": "number",
               "description": "Force simulation iterations",
@@ -6736,6 +7453,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -7040,6 +7778,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -7322,6 +8081,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -7606,6 +8386,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -7856,6 +8657,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -8110,6 +8932,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -9358,6 +10201,25 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ]
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -9506,10 +10368,10 @@
             "valueLabel": {
               "type": "string"
             },
-            "valueFormat": {
-              "x-semiotic-runtime-types": [
-                "function"
-              ]
+            "showCategoryTicks": {
+              "type": "boolean",
+              "description": "Show category tick labels on ordinal axis",
+              "default": false
             },
             "data": {
               "type": "array",
@@ -9554,20 +10416,6 @@
               "type": "number",
               "description": "Opacity of trapezoid connectors between steps (0-1). Horizontal orientation only.",
               "default": 0.3
-            },
-            "showCategoryTicks": {
-              "type": "boolean",
-              "description": "Show category tick labels on ordinal axis",
-              "default": false
-            },
-            "legendPosition": {
-              "type": "string",
-              "enum": [
-                "right",
-                "left",
-                "top",
-                "bottom"
-              ]
             }
           },
           "required": [
@@ -9634,6 +10482,25 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ]
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -9782,10 +10649,9 @@
             "valueLabel": {
               "type": "string"
             },
-            "valueFormat": {
-              "x-semiotic-runtime-types": [
-                "function"
-              ]
+            "showCategoryTicks": {
+              "type": "boolean",
+              "description": "Show lane labels on the category axis"
             },
             "data": {
               "type": "array",
@@ -9835,6 +10701,10 @@
               "type": "number",
               "description": "Rounded corner radius (px) applied to the outermost ends of each lane — left+right for horizontal, top+bottom for vertical. Middle segments stay square; single-segment lanes round all four corners."
             },
+            "gradientFill": {
+              "type": "object",
+              "description": "Tip-to-base gradient: { stops: [{ offset: 0-1, color?, opacity? }] }."
+            },
             "brush": {
               "type": "boolean",
               "description": "Enable value-axis brush selection"
@@ -9851,19 +10721,6 @@
                 "object"
               ],
               "description": "LinkedCharts brush integration name"
-            },
-            "showCategoryTicks": {
-              "type": "boolean",
-              "description": "Show lane labels on the category axis"
-            },
-            "legendPosition": {
-              "type": "string",
-              "enum": [
-                "right",
-                "left",
-                "top",
-                "bottom"
-              ]
             }
           },
           "required": [
@@ -9930,6 +10787,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -10144,6 +11022,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -10354,6 +11253,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -10577,6 +11497,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -10745,6 +11686,19 @@
                 "function"
               ]
             },
+            "sizeRange": {
+              "type": "array",
+              "description": "Minimum and maximum symbol radius in pixels.",
+              "default": [
+                3,
+                30
+              ],
+              "minItems": 2,
+              "maxItems": 2,
+              "items": {
+                "type": "number"
+              }
+            },
             "areas": {
               "type": [
                 "array",
@@ -10816,6 +11770,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -11048,6 +12023,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -11280,6 +12276,26 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -11502,16 +12518,6 @@
                 "function"
               ]
             },
-            "legendPosition": {
-              "type": "string",
-              "enum": [
-                "right",
-                "left",
-                "top",
-                "bottom"
-              ],
-              "default": "right"
-            },
             "pairing": {
               "type": "string",
               "enum": [
@@ -11642,6 +12648,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -11896,11 +12923,8 @@
               "default": 0.6
             },
             "gradientFill": {
-              "type": [
-                "boolean",
-                "object"
-              ],
-              "description": "Tip→base gradient across each segment; same shape as AreaChart.gradientFill"
+              "type": "object",
+              "description": "Tip-to-base gradient: { stops: [{ offset: 0-1, color?, opacity? }] }."
             },
             "xExtent": {
               "type": "array",
@@ -12153,6 +13177,22 @@
               "type": "string",
               "description": "Composed with the BEM root class on the outer container."
             },
+            "chartId": {
+              "type": "string",
+              "description": "Stable identifier surfaced on observation events."
+            },
+            "description": {
+              "type": "string",
+              "description": "Override the auto-generated accessible label sentence."
+            },
+            "summary": {
+              "type": "string",
+              "description": "Screen-reader-only supplement appended after the accessible label."
+            },
+            "loading": {
+              "type": "boolean",
+              "description": "Show the loading skeleton overlay."
+            },
             "value": {
               "type": "number",
               "description": "The focal number this card exists to display"
@@ -12174,7 +13214,7 @@
                 "compact",
                 "duration"
               ],
-              "description": "Number-format shortcut or custom (value) => string",
+              "description": "Number-format shortcut or React-only custom formatter. Percent treats the value as a ratio and multiplies by 100.",
               "default": "number",
               "x-semiotic-runtime-types": [
                 "string",
@@ -12375,6 +13415,32 @@
             "title": {
               "type": "string"
             },
+            "description": {
+              "type": "string",
+              "description": "Concise accessible description that overrides the generated aria-label."
+            },
+            "summary": {
+              "type": "string",
+              "description": "Screen-reader-only takeaway and interaction guidance."
+            },
+            "accessibleTable": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Expose source data through Semiotic's screen-reader data table."
+            },
+            "chartId": {
+              "type": "string",
+              "description": "Stable chart identity for linked observation and navigation."
+            },
+            "emphasis": {
+              "type": "string",
+              "enum": [
+                "primary",
+                "secondary"
+              ]
+            },
             "responsiveWidth": {
               "type": "boolean"
             },
@@ -12511,6 +13577,32 @@
             "title": {
               "type": "string"
             },
+            "description": {
+              "type": "string",
+              "description": "Concise accessible description that overrides the generated aria-label."
+            },
+            "summary": {
+              "type": "string",
+              "description": "Screen-reader-only takeaway and interaction guidance."
+            },
+            "accessibleTable": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Expose source data through Semiotic's screen-reader data table."
+            },
+            "chartId": {
+              "type": "string",
+              "description": "Stable chart identity for linked observation and navigation."
+            },
+            "emphasis": {
+              "type": "string",
+              "enum": [
+                "primary",
+                "secondary"
+              ]
+            },
             "responsiveWidth": {
               "type": "boolean"
             },
@@ -12603,7 +13695,7 @@
     {
       "type": "function",
       "function": {
-        "name": "PhysicsPileChart",
+        "name": "UnitPileChart",
         "description": "Physics-backed unit pile chart. Numeric values are unitized into repeated bodies that settle into category piles.",
         "parameters": {
           "type": "object",
@@ -12630,24 +13722,50 @@
             "title": {
               "type": "string"
             },
-            "responsiveWidth": {
-              "type": "boolean"
-            },
-            "responsiveHeight": {
-              "type": "boolean"
-            },
-            "colorBy": {
+            "description": {
               "type": "string",
-              "description": "Categorical field or accessor used to color simulated bodies.",
-              "x-semiotic-runtime-types": [
-                "string",
-                "function"
-              ]
+              "description": "Concise accessible description that overrides the generated aria-label."
             },
-            "seed": {
-              "type": "number",
-              "description": "Deterministic simulation seed.",
-              "default": 1
+            "summary": {
+              "type": "string",
+              "description": "Screen-reader-only takeaway and interaction guidance."
+            },
+            "accessibleTable": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Expose source data through Semiotic's screen-reader data table."
+            },
+            "chartId": {
+              "type": "string",
+              "description": "Stable chart identity for linked observation and navigation."
+            },
+            "emphasis": {
+              "type": "string",
+              "enum": [
+                "primary",
+                "secondary"
+              ]
+            },
+            "responsiveWidth": {
+              "type": "boolean"
+            },
+            "responsiveHeight": {
+              "type": "boolean"
+            },
+            "colorBy": {
+              "type": "string",
+              "description": "Categorical field or accessor used to color simulated bodies.",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "seed": {
+              "type": "number",
+              "description": "Deterministic simulation seed.",
+              "default": 1
             },
             "ballRadius": {
               "type": "number",
@@ -12757,6 +13875,32 @@
             "title": {
               "type": "string"
             },
+            "description": {
+              "type": "string",
+              "description": "Concise accessible description that overrides the generated aria-label."
+            },
+            "summary": {
+              "type": "string",
+              "description": "Screen-reader-only takeaway and interaction guidance."
+            },
+            "accessibleTable": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Expose source data through Semiotic's screen-reader data table."
+            },
+            "chartId": {
+              "type": "string",
+              "description": "Stable chart identity for linked observation and navigation."
+            },
+            "emphasis": {
+              "type": "string",
+              "enum": [
+                "primary",
+                "secondary"
+              ]
+            },
             "responsiveWidth": {
               "type": "boolean"
             },
@@ -12863,7 +14007,7 @@
     {
       "type": "function",
       "function": {
-        "name": "PhysicalFlowChart",
+        "name": "PacketFlowChart",
         "description": "Experimental physics-backed flow chart. Packets move along authored node coordinates or link paths while a static throughput layer keeps the route quantities readable.",
         "parameters": {
           "type": "object",
@@ -12918,6 +14062,27 @@
             "showLegend": {
               "type": "boolean"
             },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "description": "Legend interaction mode: highlight on hover, isolate on click, or none.",
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "description": "Position the legend beside or above/below the plot.",
+              "default": "right"
+            },
             "showGrid": {
               "type": "boolean",
               "default": false
@@ -13246,6 +14411,32 @@
             "title": {
               "type": "string"
             },
+            "description": {
+              "type": "string",
+              "description": "Concise accessible description that overrides the generated aria-label."
+            },
+            "summary": {
+              "type": "string",
+              "description": "Screen-reader-only takeaway and interaction guidance."
+            },
+            "accessibleTable": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Expose source data through Semiotic's screen-reader data table."
+            },
+            "chartId": {
+              "type": "string",
+              "description": "Stable chart identity for linked observation and navigation."
+            },
+            "emphasis": {
+              "type": "string",
+              "enum": [
+                "primary",
+                "secondary"
+              ]
+            },
             "responsiveWidth": {
               "type": "boolean"
             },
@@ -13405,6 +14596,32 @@
             "title": {
               "type": "string"
             },
+            "description": {
+              "type": "string",
+              "description": "Concise accessible description that overrides the generated aria-label."
+            },
+            "summary": {
+              "type": "string",
+              "description": "Screen-reader-only takeaway and interaction guidance."
+            },
+            "accessibleTable": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Expose source data through Semiotic's screen-reader data table."
+            },
+            "chartId": {
+              "type": "string",
+              "description": "Stable chart identity for linked observation and navigation."
+            },
+            "emphasis": {
+              "type": "string",
+              "enum": [
+                "primary",
+                "secondary"
+              ]
+            },
             "responsiveWidth": {
               "type": "boolean"
             },
@@ -13566,6 +14783,32 @@
             "title": {
               "type": "string"
             },
+            "description": {
+              "type": "string",
+              "description": "Accessible description of the authored charge, treatment, and terminal accounting."
+            },
+            "summary": {
+              "type": "string",
+              "description": "Screen-reader summary of the final products, outlets, and any conservation result."
+            },
+            "accessibleTable": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Expose source data through Semiotic's screen-reader data table."
+            },
+            "chartId": {
+              "type": "string",
+              "description": "Stable chart identity for linked observation and navigation."
+            },
+            "emphasis": {
+              "type": "string",
+              "enum": [
+                "primary",
+                "secondary"
+              ]
+            },
             "responsiveWidth": {
               "type": "boolean"
             },
@@ -13614,14 +14857,6 @@
                 "object"
               ]
             },
-            "description": {
-              "type": "string",
-              "description": "Accessible description of the authored charge, treatment, and terminal accounting."
-            },
-            "summary": {
-              "type": "string",
-              "description": "Screen-reader summary of the final products, outlets, and any conservation result."
-            },
             "phases": {
               "type": "array",
               "description": "Required ordered furnace program. Supply unique phase ids, positive durations, labels, and optional authored motion/intensity; phases are never inferred from data.",
@@ -14530,6 +15765,608 @@
           ]
         }
       }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "BumpChart",
+        "description": "Ranked series trajectories across ordered or time-based columns, with optional magnitude-encoded ribbons.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "mode": {
+              "type": "string",
+              "enum": [
+                "primary",
+                "context",
+                "sparkline",
+                "mobile"
+              ],
+              "description": "Display mode controlling default size, decoration, margins, labels, and interaction.",
+              "default": "primary"
+            },
+            "width": {
+              "type": "number",
+              "default": 600
+            },
+            "height": {
+              "type": "number",
+              "default": 400
+            },
+            "margin": {
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
+            },
+            "className": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string",
+              "description": "Visible chart title and the chart's accessible name."
+            },
+            "description": {
+              "type": "string",
+              "description": "Concise accessible description that overrides the chart's generated aria-label."
+            },
+            "summary": {
+              "type": "string",
+              "description": "Screen-reader-only summary of the chart's key takeaway; include keyboard interaction guidance when relevant."
+            },
+            "accessibleTable": {
+              "type": "boolean",
+              "description": "Expose the chart data through Semiotic's screen-reader data table.",
+              "default": true
+            },
+            "enableHover": {
+              "type": "boolean",
+              "default": true
+            },
+            "showLegend": {
+              "type": "boolean"
+            },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "default": "right"
+            },
+            "showGrid": {
+              "type": "boolean",
+              "default": false
+            },
+            "colorBy": {
+              "type": "string",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "colorScheme": {
+              "type": [
+                "string",
+                "array",
+                "object"
+              ],
+              "default": "category10"
+            },
+            "tooltip": {
+              "type": [
+                "boolean",
+                "object",
+                "string"
+              ],
+              "x-semiotic-runtime-types": [
+                "boolean",
+                "function",
+                "object",
+                "string"
+              ]
+            },
+            "annotations": {
+              "type": "array",
+              "description": "Annotation objects to render on the chart. Each must have a `type` field. Position using your data field names (e.g. { type: \"widget\", month: \"Jan\", revenue: 500 }). Supported types: \"widget\" (arbitrary HTML/React content via foreignObject — v3 replacement for htmlAnnotationRules), \"label\" (callout with connector), \"callout\" (circle + label), \"text\" (plain label), \"y-threshold\" (horizontal reference line), \"x-threshold\" (vertical reference line), \"band\" (shaded y-region), \"enclose\" (circle around points), \"rect-enclose\" (rect around points), \"highlight\" (colored dots on filtered points), \"trend\" (regression line), \"envelope\" (upper/lower bounds), \"anomaly-band\" (mean ± stddev), \"forecast\" (extrapolated trend). Widget annotations accept: content (ReactNode), dx, dy, width, height, anchor (\"fixed\"|\"latest\"|\"sticky\"). Threshold annotations accept: value, label, color, strokeWidth, strokeDasharray. Enclose annotations accept: coordinates (array of data objects), label, color, padding.",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "widget",
+                      "label",
+                      "callout",
+                      "text",
+                      "bracket",
+                      "y-threshold",
+                      "x-threshold",
+                      "band",
+                      "enclose",
+                      "rect-enclose",
+                      "highlight",
+                      "trend",
+                      "envelope",
+                      "anomaly-band",
+                      "forecast"
+                    ],
+                    "description": "Annotation type"
+                  }
+                },
+                "required": [
+                  "type"
+                ]
+              }
+            },
+            "autoPlaceAnnotations": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Opt-in annotation placement pass. Chooses dx/dy for note-like annotations without manual offsets and avoids note/mark/edge overlaps where possible.",
+              "default": false
+            },
+            "responsiveRules": {
+              "type": "array",
+              "description": "Semantic responsive transforms applied before chart-mode defaults."
+            },
+            "mobileSemantics": {
+              "type": "object",
+              "description": "Phone/mobile contract consumed by audits, recipes, adapters, and agents."
+            },
+            "mobileInteraction": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Touch-first interaction policy for phone-sized chart slots."
+            },
+            "axisExtent": {
+              "type": "string",
+              "enum": [
+                "nice",
+                "exact"
+              ],
+              "description": "Tick endpoint mode. \"nice\" rounds endpoints to readable values; \"exact\" pins the first and last tick to the actual data min and max with equidistant intermediates. Affects XY x/y axes and ordinal value axis only.",
+              "default": "nice"
+            },
+            "animate": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Enable mark transitions (boolean or {duration?, easing?, intro?})."
+            },
+            "loading": {
+              "type": "boolean",
+              "description": "Show loading skeleton / loadingContent."
+            },
+            "hoverHighlight": {
+              "type": [
+                "boolean",
+                "string"
+              ],
+              "enum": [
+                "series"
+              ],
+              "default": true
+            },
+            "chartId": {
+              "type": "string",
+              "description": "Stable id for linked selection / observation / nav sync."
+            },
+            "emphasis": {
+              "type": "string",
+              "enum": [
+                "primary",
+                "secondary"
+              ]
+            },
+            "responsiveWidth": {
+              "type": "boolean"
+            },
+            "responsiveHeight": {
+              "type": "boolean"
+            },
+            "color": {
+              "type": "string",
+              "description": "Uniform mark fill (primitive styling)."
+            },
+            "stroke": {
+              "type": "string"
+            },
+            "strokeWidth": {
+              "type": "number"
+            },
+            "opacity": {
+              "type": "number"
+            },
+            "data": {
+              "type": "array",
+              "description": "Flat observations containing one magnitude per series and ranking column."
+            },
+            "xAccessor": {
+              "type": "string",
+              "description": "Ordered or temporal ranking-column accessor.",
+              "default": "x",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "yAccessor": {
+              "type": "string",
+              "description": "Numeric magnitude used to calculate rank and ribbon width.",
+              "default": "y",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "xLabel": {
+              "type": "string"
+            },
+            "yLabel": {
+              "type": "string",
+              "default": "Rank"
+            },
+            "lineBy": {
+              "type": "string",
+              "description": "Series identity accessor.",
+              "default": "series",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "rankDirection": {
+              "type": "string",
+              "enum": [
+                "descending",
+                "ascending"
+              ],
+              "default": "descending"
+            },
+            "ribbon": {
+              "type": "boolean",
+              "description": "Encode the original magnitude as trajectory width.",
+              "default": false
+            },
+            "curve": {
+              "type": "string",
+              "enum": [
+                "smooth",
+                "linear"
+              ],
+              "default": "smooth"
+            },
+            "ribbonSizeRange": {
+              "type": "array",
+              "description": "Minimum and maximum full ribbon width in pixels.",
+              "default": [
+                4,
+                28
+              ]
+            },
+            "samplesPerSegment": {
+              "type": "number",
+              "default": 12
+            },
+            "lineWidth": {
+              "type": "number",
+              "description": "Fixed trajectory width when ribbon is false.",
+              "default": 3
+            },
+            "highlightTop": {
+              "type": "number",
+              "description": "Use categorical colors for the N series with the best overall mean rank."
+            },
+            "neutralColor": {
+              "type": "string",
+              "description": "Color for trajectories outside highlightTop. Defaults to the theme's secondary text color."
+            },
+            "ribbonOpacity": {
+              "type": "number",
+              "default": 0.82
+            },
+            "lineOpacity": {
+              "type": "number",
+              "default": 0.9
+            },
+            "showPoints": {
+              "type": "boolean",
+              "default": false
+            },
+            "pointRadius": {
+              "type": "number",
+              "default": 3
+            },
+            "showLabels": {
+              "type": [
+                "boolean",
+                "string"
+              ],
+              "enum": [
+                "start",
+                "end",
+                "both"
+              ],
+              "default": true
+            },
+            "showAxes": {
+              "type": "boolean",
+              "default": true
+            }
+          },
+          "required": [
+            "data"
+          ]
+        }
+      }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "ChainReactionChart",
+        "description": "Physics-backed dependency chain reaction. Tasks are placed by workstream lane and dependency depth; a completed task releases one delivery ball per outgoing dependency, and a downstream task arms only once every prerequisite ball has arrived. The settled reading is task state plus each blocker's downstream reach.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "data": {
+              "type": "array",
+              "description": "Array of source records. Each record becomes one or more simulated bodies."
+            },
+            "size": {
+              "type": "array",
+              "description": "[width, height] in pixels"
+            },
+            "width": {
+              "type": "number",
+              "description": "Alias for size[0]"
+            },
+            "height": {
+              "type": "number",
+              "description": "Alias for size[1]"
+            },
+            "className": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string",
+              "description": "Concise accessible description that overrides the generated aria-label."
+            },
+            "summary": {
+              "type": "string",
+              "description": "Screen-reader-only takeaway and interaction guidance."
+            },
+            "accessibleTable": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Expose source data through Semiotic's screen-reader data table."
+            },
+            "chartId": {
+              "type": "string",
+              "description": "Stable chart identity for linked observation and navigation."
+            },
+            "emphasis": {
+              "type": "string",
+              "enum": [
+                "primary",
+                "secondary"
+              ]
+            },
+            "responsiveWidth": {
+              "type": "boolean"
+            },
+            "responsiveHeight": {
+              "type": "boolean"
+            },
+            "colorBy": {
+              "type": "string",
+              "description": "Categorical field or accessor used to color simulated bodies.",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "seed": {
+              "type": "number",
+              "description": "Deterministic seed for delivery-ball motion.",
+              "default": 31
+            },
+            "ballRadius": {
+              "type": "number",
+              "description": "Radius of each simulated circular body in pixels."
+            },
+            "hoverRadius": {
+              "type": "number",
+              "description": "Pixel hit radius for body hover tooltips."
+            },
+            "paused": {
+              "type": "boolean",
+              "description": "Pause the simulation at mount or on prop update."
+            },
+            "tooltip": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Tooltip content function/config, true for the default body tooltip, or false to disable hover tooltips.",
+              "x-semiotic-runtime-types": [
+                "boolean",
+                "function",
+                "object"
+              ]
+            },
+            "taskIDAccessor": {
+              "type": "string",
+              "description": "Stable task id. Dependency arrays reference these resolved ids.",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "labelAccessor": {
+              "type": "string",
+              "description": "Human-readable task name used in labels and the data table.",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "laneAccessor": {
+              "type": "string",
+              "description": "Workstream the task belongs to. Lanes become the chart's columns.",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "dependencyAccessor": {
+              "type": "string",
+              "description": "Array of prerequisite task ids. Edges are never inferred; a task with the wrong prerequisites reads as a different claim.",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "startAccessor": {
+              "type": "string",
+              "description": "Planned start time (number or Date).",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "endAccessor": {
+              "type": "string",
+              "description": "Planned end time (number or Date).",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "progressAccessor": {
+              "type": "string",
+              "description": "Fractional completion 0–1, shown on the task body.",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "statusAccessor": {
+              "type": "string",
+              "description": "Authored task status (done / blocked / waiting / active). Completion is an explicit data event, never something the simulation discovers.",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "completionTimeAccessor": {
+              "type": "string",
+              "description": "When the task actually completed. Drives replay ordering against currentTime.",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "blockerAccessor": {
+              "type": "string",
+              "description": "Reason this task is blocked. A blocked task never arms its downstream dependents.",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "milestoneAccessor": {
+              "type": "string",
+              "description": "Marks a task as a milestone for emphasis.",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "mode": {
+              "type": "string",
+              "enum": [
+                "snapshot",
+                "replay",
+                "mechanical"
+              ],
+              "description": "snapshot derives the settled state at currentTime without animating; replay animates deliveries forward from the earliest recorded completion; mechanical demonstrates the apparatus.",
+              "default": "snapshot"
+            },
+            "insight": {
+              "type": "string",
+              "enum": [
+                "none",
+                "blocker-amplification"
+              ],
+              "description": "Which derived reading to surface. blocker-amplification reports how many unfinished tasks and lanes each blocker reaches.",
+              "default": "blocker-amplification"
+            },
+            "currentTime": {
+              "type": [
+                "number",
+                "object"
+              ],
+              "description": "Clock position used to derive the settled state (number or Date)."
+            },
+            "controls": {
+              "type": [
+                "boolean",
+                "array"
+              ],
+              "description": "Replay control buttons: true for all, or a subset of play / pause / step / reset / settle."
+            },
+            "mechanism": {
+              "type": "string",
+              "enum": [
+                "domino-ball"
+              ],
+              "description": "Delivery mechanism used to represent a satisfied prerequisite.",
+              "default": "domino-ball"
+            },
+            "orientation": {
+              "type": "string",
+              "enum": [
+                "vertical"
+              ],
+              "description": "Lane orientation. Lanes run as vertical columns.",
+              "default": "vertical"
+            },
+            "reducedMotion": {
+              "type": "string",
+              "enum": [
+                "settle"
+              ],
+              "description": "Force the settled reading instead of a replay. The frame also honors prefers-reduced-motion automatically."
+            }
+          },
+          "required": [
+            "data",
+            "taskIDAccessor",
+            "labelAccessor",
+            "laneAccessor",
+            "dependencyAccessor"
+          ]
+        }
+      }
     }
   ]
 }