npm - semiotic - Versions diffs - 3.8.6 → 3.8.7 - Mend

semiotic 3.8.6 → 3.8.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (213) hide show

package/ai/schema.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "name": "semiotic",
-  "version": "3.8.6",
+  "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",
@@ -308,6 +337,23 @@
               "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."
@@ -322,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": [
@@ -388,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
@@ -604,6 +679,14 @@
               ],
               "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": "object",
               "description": "Line-to-baseline gradient: { stops: [{ offset: 0-1, color?, opacity? }] }. Offset 0 is the line/top and offset 1 is the baseline."
@@ -635,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."
@@ -649,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": [
@@ -715,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
@@ -940,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": [
@@ -1011,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
@@ -1234,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",
@@ -1315,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
@@ -1565,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": []
@@ -1629,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
@@ -1881,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
@@ -2095,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": [
@@ -2162,18 +2463,39 @@
             "showLegend": {
               "type": "boolean"
             },
-            "showGrid": {
-              "type": "boolean",
-              "default": false
-            },
-            "colorBy": {
+            "legendInteraction": {
               "type": "string",
-              "x-semiotic-runtime-types": [
-                "string",
-                "function"
-              ]
-            },
-            "colorScheme": {
+              "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": {
               "type": [
                 "string",
                 "array",
@@ -2375,6 +2697,22 @@
               "type": "string",
               "default": "white"
             },
+            "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",
@@ -2449,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
@@ -2651,11 +3010,6 @@
               "description": "Display numeric values in cells",
               "default": false
             },
-            "valueFormat": {
-              "x-semiotic-runtime-types": [
-                "function"
-              ]
-            },
             "cellBorderColor": {
               "type": "string",
               "default": "#fff"
@@ -2664,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": [
@@ -2740,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
@@ -2953,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",
@@ -3034,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
@@ -3182,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",
@@ -3312,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
@@ -3460,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",
@@ -3580,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
@@ -3728,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",
@@ -3859,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
@@ -4007,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",
@@ -4122,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
@@ -4270,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",
@@ -4407,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
@@ -4555,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",
@@ -4666,7 +5174,28 @@
             "showLegend": {
               "type": "boolean"
             },
-            "showGrid": {
+            "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
             },
@@ -4814,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",
@@ -4918,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
@@ -5066,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",
@@ -5183,6 +5731,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
@@ -5331,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",
@@ -5430,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
@@ -5578,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",
@@ -5705,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
@@ -5937,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
@@ -6181,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
@@ -6337,7 +6988,27 @@
             },
             "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",
@@ -6369,11 +7040,6 @@
             "needleColor": {
               "type": "string"
             },
-            "valueFormat": {
-              "x-semiotic-runtime-types": [
-                "function"
-              ]
-            },
             "showScaleLabels": {
               "type": "boolean",
               "default": true
@@ -6443,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
@@ -6593,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",
@@ -6669,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",
@@ -6758,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
@@ -7062,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
@@ -7344,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
@@ -7628,7 +8386,28 @@
             "showLegend": {
               "type": "boolean"
             },
-            "showGrid": {
+            "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
             },
@@ -7878,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
@@ -8132,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
@@ -9380,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
@@ -9528,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",
@@ -9576,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": [
@@ -9656,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
@@ -9804,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",
@@ -9877,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": [
@@ -9956,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
@@ -10170,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
@@ -10380,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
@@ -10603,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
@@ -10771,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",
@@ -10842,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
@@ -11074,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
@@ -11306,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
@@ -11528,16 +12518,6 @@
                 "function"
               ]
             },
-            "legendPosition": {
-              "type": "string",
-              "enum": [
-                "right",
-                "left",
-                "top",
-                "bottom"
-              ],
-              "default": "right"
-            },
             "pairing": {
               "type": "string",
               "enum": [
@@ -11668,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
@@ -12176,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"
@@ -12197,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",
@@ -12398,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"
             },
@@ -12534,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"
             },
@@ -12626,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",
@@ -12653,6 +13722,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"
             },
@@ -12780,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"
             },
@@ -12886,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",
@@ -12941,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
@@ -13269,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"
             },
@@ -13428,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"
             },
@@ -13589,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"
             },
@@ -13637,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.",
@@ -14612,6 +15824,25 @@
             "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
@@ -14875,29 +16106,264 @@
             "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."
             },
-            "legendInteraction": {
+            "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": [
-                "highlight",
-                "isolate",
-                "none"
+                "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"
               ],
-              "default": "none"
+              "description": "Tooltip content function/config, true for the default body tooltip, or false to disable hover tooltips.",
+              "x-semiotic-runtime-types": [
+                "boolean",
+                "function",
+                "object"
+              ]
             },
-            "legendPosition": {
+            "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": [
-                "right",
-                "left",
-                "top",
-                "bottom"
+                "snapshot",
+                "replay",
+                "mechanical"
               ],
-              "default": "right"
+              "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"
+            "data",
+            "taskIDAccessor",
+            "labelAccessor",
+            "laneAccessor",
+            "dependencyAccessor"
           ]
         }
       }