semiotic 3.5.1 → 3.5.2

package/ai/schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "name": "semiotic",
-  "version": "3.5.1",
+  "version": "3.5.2",
   "description": "React data visualization library for charts, networks, and beyond",
   "tools": [
     {
@@ -93,6 +93,15 @@
                 ]
               }
             },
+            "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"
+            },
             "xLabel": {
               "type": "string"
             },
@@ -171,6 +180,14 @@
               "type": "number",
               "description": "Opacity of the filled area (0-1)",
               "default": 0.3
+            },
+            "forecast": {
+              "type": "object",
+              "description": "Forecast overlay config — tagged training/observed/forecast region with optional envelope. See ForecastConfig."
+            },
+            "anomaly": {
+              "type": "object",
+              "description": "Anomaly overlay config — ±σ band + anomaly dot annotations. See AnomalyConfig."
             }
           },
           "required": [
@@ -268,6 +285,15 @@
                 ]
               }
             },
+            "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"
+            },
             "xLabel": {
               "type": "string"
             },
@@ -334,6 +360,14 @@
             "lineWidth": {
               "type": "number",
               "default": 2
+            },
+            "forecast": {
+              "type": "object",
+              "description": "Forecast overlay config — tagged training/observed/forecast region with optional envelope. See ForecastConfig."
+            },
+            "anomaly": {
+              "type": "object",
+              "description": "Anomaly overlay config — ±σ band + anomaly dot annotations. See AnomalyConfig."
             }
           },
           "required": [
@@ -431,6 +465,15 @@
                 ]
               }
             },
+            "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"
+            },
             "xLabel": {
               "type": "string"
             },
@@ -595,6 +638,15 @@
                 ]
               }
             },
+            "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"
+            },
             "xLabel": {
               "type": "string"
             },
@@ -642,6 +694,22 @@
             "pointOpacity": {
               "type": "number",
               "default": 0.8
+            },
+            "regression": {
+              "type": [
+                "boolean",
+                "string",
+                "object"
+              ],
+              "description": "Overlay a regression line. true = linear, 'linear' | 'polynomial' | 'loess' = method, or full RegressionConfig object. Sugar over the trend annotation."
+            },
+            "forecast": {
+              "type": "object",
+              "description": "Forecast overlay config — tagged future points + optional envelope. See ForecastConfig."
+            },
+            "anomaly": {
+              "type": "object",
+              "description": "Anomaly overlay config — ±σ band + anomaly dot annotations. See AnomalyConfig."
             }
           },
           "required": [
@@ -739,6 +807,15 @@
                 ]
               }
             },
+            "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"
+            },
             "xLabel": {
               "type": "string"
             },
@@ -900,6 +977,15 @@
                 ]
               }
             },
+            "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"
+            },
             "xLabel": {
               "type": "string"
             },
@@ -1026,6 +1112,15 @@
                 ]
               }
             },
+            "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"
+            },
             "xLabel": {
               "type": "string"
             },
@@ -1181,6 +1276,15 @@
                 ]
               }
             },
+            "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"
+            },
             "xLabel": {
               "type": "string"
             },
@@ -1230,6 +1334,14 @@
             "bubbleStrokeColor": {
               "type": "string",
               "default": "white"
+            },
+            "regression": {
+              "type": [
+                "boolean",
+                "string",
+                "object"
+              ],
+              "description": "Overlay a regression line on the bubbles. Same shape as Scatterplot's regression prop."
             }
           },
           "required": [
@@ -1331,6 +1443,15 @@
                 ]
               }
             },
+            "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"
+            },
             "xLabel": {
               "type": "string"
             },
@@ -1486,6 +1607,15 @@
                 ]
               }
             },
+            "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"
+            },
             "xLabel": {
               "type": "string"
             },
@@ -1534,6 +1664,22 @@
                 "function"
               ],
               "description": "Accessor for unique point IDs, used by point-anchored annotations"
+            },
+            "regression": {
+              "type": [
+                "boolean",
+                "string",
+                "object"
+              ],
+              "description": "Overlay a regression line under the connected path. Same shape as Scatterplot's regression prop."
+            },
+            "forecast": {
+              "type": "object",
+              "description": "Forecast overlay config — same shape as LineChart's forecast prop."
+            },
+            "anomaly": {
+              "type": "object",
+              "description": "Anomaly overlay config — ±σ band + anomaly dot annotations."
             }
           },
           "required": [
@@ -1631,6 +1777,15 @@
                 ]
               }
             },
+            "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"
+            },
             "categoryLabel": {
               "type": "string"
             },
@@ -1680,6 +1835,14 @@
             "barPadding": {
               "type": "number",
               "default": 40
+            },
+            "regression": {
+              "type": [
+                "boolean",
+                "string",
+                "object"
+              ],
+              "description": "Overlay a regression line through the bar tops. Accepts true (linear), a method ('linear' | 'polynomial' | 'loess'), or a full RegressionConfig. Pixels resolve through the band scale."
             }
           },
           "required": [
@@ -1778,6 +1941,15 @@
                 ]
               }
             },
+            "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"
+            },
             "categoryLabel": {
               "type": "string"
             },
@@ -1926,6 +2098,15 @@
                 ]
               }
             },
+            "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"
+            },
             "categoryLabel": {
               "type": "string"
             },
@@ -2083,6 +2264,15 @@
                 ]
               }
             },
+            "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"
+            },
             "categoryLabel": {
               "type": "string"
             },
@@ -2226,6 +2416,15 @@
                 ]
               }
             },
+            "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"
+            },
             "categoryLabel": {
               "type": "string"
             },
@@ -2383,6 +2582,15 @@
                 ]
               }
             },
+            "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"
+            },
             "categoryLabel": {
               "type": "string"
             },
@@ -2527,6 +2735,15 @@
                 ]
               }
             },
+            "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"
+            },
             "categoryLabel": {
               "type": "string"
             },
@@ -2664,6 +2881,15 @@
                 ]
               }
             },
+            "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"
+            },
             "categoryLabel": {
               "type": "string"
             },
@@ -2814,6 +3040,15 @@
                 ]
               }
             },
+            "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"
+            },
             "categoryLabel": {
               "type": "string"
             },
@@ -2946,6 +3181,15 @@
                 ]
               }
             },
+            "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"
+            },
             "categoryLabel": {
               "type": "string"
             },
@@ -2997,6 +3241,14 @@
             "categoryPadding": {
               "type": "number",
               "default": 10
+            },
+            "regression": {
+              "type": [
+                "boolean",
+                "string",
+                "object"
+              ],
+              "description": "Overlay a regression line through the dots. Same shape as Scatterplot's regression prop."
             }
           },
           "required": [
@@ -3094,6 +3346,15 @@
                 ]
               }
             },
+            "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"
+            },
             "data": {
               "type": "array",
               "description": "Array of data objects"
@@ -3213,6 +3474,15 @@
                 ]
               }
             },
+            "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"
+            },
             "data": {
               "type": "array",
               "description": "Array of data objects"
@@ -3344,6 +3614,15 @@
                 ]
               }
             },
+            "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"
+            },
             "value": {
               "type": "number",
               "description": "Current gauge value"
@@ -3365,6 +3644,10 @@
               "description": "Arc thickness as fraction of radius (0-1)",
               "default": 0.3
             },
+            "cornerRadius": {
+              "type": "number",
+              "description": "Pixel radius for rounded segment ends. Same semantics as DonutChart's cornerRadius. Omit for sharp corners."
+            },
             "sweep": {
               "type": "number",
               "description": "Arc sweep angle in degrees (gap centered at bottom)",
@@ -3480,6 +3763,15 @@
                 ]
               }
             },
+            "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"
+            },
             "nodes": {
               "type": "array",
               "description": "Array of node objects"
@@ -3662,6 +3954,15 @@
                 ]
               }
             },
+            "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"
+            },
             "edges": {
               "type": "array",
               "description": "Array of edge objects with source, target, and value"
@@ -3849,6 +4150,15 @@
                 ]
               }
             },
+            "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"
+            },
             "edges": {
               "type": "array",
               "description": "Array of edge objects with source, target, and value"
@@ -4014,6 +4324,15 @@
                 ]
               }
             },
+            "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"
+            },
             "data": {
               "type": "object",
               "description": "Root node object with nested children"
@@ -4183,6 +4502,15 @@
                 ]
               }
             },
+            "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"
+            },
             "data": {
               "type": "object",
               "description": "Root node object with nested children"
@@ -4318,6 +4646,15 @@
                 ]
               }
             },
+            "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"
+            },
             "data": {
               "type": "object",
               "description": "Root node object with nested children"
@@ -4457,6 +4794,15 @@
                 ]
               }
             },
+            "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"
+            },
             "data": {
               "type": "object",
               "description": "Hierarchical root object with children: { name: 'root', children: [...] }"
@@ -5442,6 +5788,15 @@
                 ]
               }
             },
+            "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"
+            },
             "categoryLabel": {
               "type": "string"
             },
@@ -5605,6 +5960,15 @@
                 ]
               }
             },
+            "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"
+            },
             "categoryLabel": {
               "type": "string"
             },
@@ -5655,6 +6019,10 @@
               "description": "Padding between lanes in pixels",
               "default": 40
             },
+            "roundedTop": {
+              "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."
+            },
             "brush": {
               "type": "boolean",
               "description": "Enable value-axis brush selection"
@@ -5782,6 +6150,15 @@
                 ]
               }
             },
+            "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"
+            },
             "data": {
               "type": "array"
             },
@@ -5885,6 +6262,15 @@
                 ]
               }
             },
+            "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"
+            },
             "data": {
               "type": "array"
             }
@@ -5983,6 +6369,15 @@
                 ]
               }
             },
+            "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"
+            },
             "areas": {
               "type": [
                 "array",
@@ -6096,6 +6491,15 @@
                 ]
               }
             },
+            "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"
+            },
             "points": {
               "type": "array"
             },
@@ -6221,6 +6625,15 @@
                 ]
               }
             },
+            "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"
+            },
             "flows": {
               "type": "array"
             },
@@ -6232,6 +6645,12 @@
                 "string",
                 "function"
               ]
+            },
+            "lineIdAccessor": {
+              "type": [
+                "string",
+                "function"
+              ]
             }
           },
           "required": [
@@ -6329,6 +6748,15 @@
                 ]
               }
             },
+            "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"
+            },
             "points": {
               "type": "array"
             },
@@ -6347,6 +6775,477 @@
           ]
         }
       }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "ProcessSankey",
+        "description": "Temporal sankey with a real time x-axis. Edges carry startTime/endTime; nodes can declare an explicit xExtent lifetime. Use for timestamped flow events (PR commits, campaign-finance contributions, supply-chain shipments).",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "width": {
+              "type": "number",
+              "default": 600
+            },
+            "height": {
+              "type": "number",
+              "default": 400
+            },
+            "margin": {
+              "type": "object"
+            },
+            "className": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "enableHover": {
+              "type": "boolean",
+              "default": true
+            },
+            "showLegend": {
+              "type": "boolean"
+            },
+            "showGrid": {
+              "type": "boolean",
+              "default": false
+            },
+            "colorBy": {
+              "type": [
+                "string",
+                "function"
+              ]
+            },
+            "colorScheme": {
+              "type": [
+                "string",
+                "array"
+              ],
+              "default": "category10"
+            },
+            "tooltip": {
+              "type": [
+                "boolean",
+                "function",
+                "object"
+              ]
+            },
+            "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"
+                ]
+              }
+            },
+            "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"
+            },
+            "edges": {
+              "type": "array",
+              "description": "Array of timed edge records with source, target, value, startTime, endTime. Omit for push-mode."
+            },
+            "nodes": {
+              "type": "array",
+              "description": "Optional array of node objects. Nodes may carry an `xExtent: [start, end]` to bound the lane explicitly."
+            },
+            "domain": {
+              "type": "array",
+              "description": "[tStart, tEnd] of the chart's x-axis (required)."
+            },
+            "axisTicks": {
+              "type": "array",
+              "description": "Optional [{ date, label }] tick array for the time axis."
+            },
+            "sourceAccessor": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "default": "source"
+            },
+            "targetAccessor": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "default": "target"
+            },
+            "valueAccessor": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "default": "value"
+            },
+            "nodeIdAccessor": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "default": "id"
+            },
+            "startTimeAccessor": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "default": "startTime"
+            },
+            "endTimeAccessor": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "default": "endTime"
+            },
+            "xExtentAccessor": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "default": "xExtent"
+            },
+            "edgeIdAccessor": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "default": "id"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "default": "right"
+            },
+            "pairing": {
+              "type": "string",
+              "enum": [
+                "value",
+                "temporal"
+              ],
+              "description": "Edge-side pairing strategy at transit nodes.",
+              "default": "temporal"
+            },
+            "packing": {
+              "type": "string",
+              "enum": [
+                "off",
+                "reuse"
+              ],
+              "description": "Lane reuse — pack lifetime-disjoint nodes into the same row.",
+              "default": "reuse"
+            },
+            "laneOrder": {
+              "type": "string",
+              "enum": [
+                "insertion",
+                "crossing-min",
+                "inside-out",
+                "crossing-min+inside-out"
+              ],
+              "default": "crossing-min"
+            },
+            "ribbonLane": {
+              "type": "string",
+              "enum": [
+                "source",
+                "target",
+                "both"
+              ],
+              "default": "both"
+            },
+            "lifetimeMode": {
+              "type": "string",
+              "enum": [
+                "full",
+                "half"
+              ],
+              "default": "half"
+            },
+            "showLaneRails": {
+              "type": "boolean",
+              "default": false
+            },
+            "showQualityReadout": {
+              "type": "boolean",
+              "default": false
+            },
+            "edgeOpacity": {
+              "type": "number",
+              "default": 0.35
+            },
+            "showParticles": {
+              "type": "boolean",
+              "default": false
+            },
+            "particleStyle": {
+              "type": "object",
+              "description": "ParticleStyle config — same shape as SankeyDiagram. Defaults from DEFAULT_PARTICLE_STYLE (radius 3, opacity 0.7, spawnRate 0.1, maxPerEdge 50)."
+            }
+          },
+          "required": [
+            "domain"
+          ]
+        }
+      }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "DifferenceChart",
+        "description": "Two-series difference chart: fills the area between series A and series B with a color that switches at each crossover — A's color where A > B, B's color where B > A. Crossovers are linearly interpolated so segments meet at zero-width vertices. Both series can be drawn as overlay lines on top of the fill. Classic uses: temperature anomaly (actual vs. normal), forecast accuracy (actual vs. predicted), budget variance.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "width": {
+              "type": "number",
+              "default": 600
+            },
+            "height": {
+              "type": "number",
+              "default": 400
+            },
+            "margin": {
+              "type": "object"
+            },
+            "className": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "enableHover": {
+              "type": "boolean",
+              "default": true
+            },
+            "showLegend": {
+              "type": "boolean"
+            },
+            "showGrid": {
+              "type": "boolean",
+              "default": false
+            },
+            "colorBy": {
+              "type": [
+                "string",
+                "function"
+              ]
+            },
+            "colorScheme": {
+              "type": [
+                "string",
+                "array"
+              ],
+              "default": "category10"
+            },
+            "tooltip": {
+              "type": [
+                "boolean",
+                "function",
+                "object"
+              ]
+            },
+            "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"
+                ]
+              }
+            },
+            "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"
+            },
+            "xLabel": {
+              "type": "string"
+            },
+            "yLabel": {
+              "type": "string"
+            },
+            "data": {
+              "type": "array",
+              "description": "Array of `{x, a, b}` objects. Omit for push API mode."
+            },
+            "xAccessor": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "description": "Key for x values",
+              "default": "x"
+            },
+            "seriesAAccessor": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "description": "Key for series A values",
+              "default": "a"
+            },
+            "seriesBAccessor": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "description": "Key for series B values",
+              "default": "b"
+            },
+            "seriesALabel": {
+              "type": "string",
+              "description": "Display label for series A in legend + tooltip",
+              "default": "A"
+            },
+            "seriesBLabel": {
+              "type": "string",
+              "description": "Display label for series B",
+              "default": "B"
+            },
+            "seriesAColor": {
+              "type": "string",
+              "description": "Fill color when series A is higher. Defaults to var(--semiotic-danger)."
+            },
+            "seriesBColor": {
+              "type": "string",
+              "description": "Fill color when series B is higher. Defaults to var(--semiotic-info)."
+            },
+            "showLines": {
+              "type": "boolean",
+              "description": "Draw the two series as overlay lines on top of the fill",
+              "default": true
+            },
+            "lineWidth": {
+              "type": "number",
+              "default": 1.5
+            },
+            "showPoints": {
+              "type": "boolean",
+              "description": "Show points at each data vertex on the overlay lines",
+              "default": false
+            },
+            "pointRadius": {
+              "type": "number",
+              "default": 3
+            },
+            "curve": {
+              "type": "string",
+              "enum": [
+                "linear",
+                "monotoneX",
+                "monotoneY",
+                "step",
+                "stepAfter",
+                "stepBefore",
+                "basis",
+                "cardinal",
+                "catmullRom"
+              ],
+              "default": "linear"
+            },
+            "areaOpacity": {
+              "type": "number",
+              "description": "Difference fill opacity (0-1)",
+              "default": 0.6
+            },
+            "gradientFill": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Tip→base gradient across each segment; same shape as AreaChart.gradientFill"
+            },
+            "xExtent": {
+              "type": "array",
+              "description": "Fixed x domain `[min, max]`. Either bound may be `undefined`."
+            },
+            "yExtent": {
+              "type": "array",
+              "description": "Fixed y domain `[min, max]`. Either bound may be `undefined`."
+            },
+            "pointIdAccessor": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "description": "Stable ID for push-mode remove()/update()"
+            },
+            "windowSize": {
+              "type": "number",
+              "description": "Max raw rows in the push buffer; older rows evict FIFO. Recommended for long-running streams."
+            }
+          },
+          "required": []
+        }
+      }
     }
   ]
 }