semiotic 3.8.4 → 3.8.6

package/ai/schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "name": "semiotic",
-  "version": "3.8.4",
+  "version": "3.8.6",
   "description": "React data visualization library for charts, networks, and beyond",
   "tools": [
     {
@@ -304,6 +304,10 @@
               "description": "Opacity of the filled area (0-1)",
               "default": 0.3
             },
+            "lineGradient": {
+              "type": "object",
+              "description": "Left-to-right stroke gradient: { stops: [{ offset: 0-1, color?, opacity? }] }."
+            },
             "forecast": {
               "type": "object",
               "description": "Forecast overlay config — tagged training/observed/forecast region with optional envelope. See ForecastConfig."
@@ -601,15 +605,21 @@
               "default": "monotoneX"
             },
             "gradientFill": {
-              "type": [
-                "boolean",
-                "object"
-              ],
-              "description": "Renderer-space area gradient. true uses default opacity; object supports opacity or colorStops."
+              "type": "object",
+              "description": "Line-to-baseline gradient: { stops: [{ offset: 0-1, color?, opacity? }] }. Offset 0 is the line/top and offset 1 is the baseline."
             },
             "semanticGradient": {
-              "type": "array",
-              "description": "User-facing gradient stops: [{ at: 0-100, color, opacity? }], where 0 is baseline and 100 is line/top. Takes precedence over gradientFill."
+              "type": "object",
+              "description": "Value-anchored gradient: { stops: [{ offset: 0-1, color?, opacity? }] }. Offset 0 is the y-domain minimum and offset 1 is the maximum. Takes precedence over gradientFill."
+            },
+            "semanticLine": {
+              "type": "boolean",
+              "description": "Mirror semanticGradient on the area's top-edge stroke as solid, hard-edged value bands. Set false to keep the normal stroke or lineGradient.",
+              "default": true
+            },
+            "lineGradient": {
+              "type": "object",
+              "description": "Left-to-right stroke gradient: { stops: [{ offset: 0-1, color?, opacity? }] }."
             },
             "areaOpacity": {
               "type": "number",
@@ -3224,6 +3234,10 @@
               "type": "number",
               "default": 40
             },
+            "gradientFill": {
+              "type": "object",
+              "description": "Tip-to-base gradient: { stops: [{ offset: 0-1, color?, opacity? }] }."
+            },
             "regression": {
               "type": [
                 "boolean",
@@ -3495,6 +3509,10 @@
             "barPadding": {
               "type": "number",
               "default": 40
+            },
+            "gradientFill": {
+              "type": "object",
+              "description": "Tip-to-base gradient: { stops: [{ offset: 0-1, color?, opacity? }] }."
             }
           },
           "required": [
@@ -4033,6 +4051,10 @@
             "barPadding": {
               "type": "number",
               "default": 60
+            },
+            "gradientFill": {
+              "type": "object",
+              "description": "Tip-to-base gradient: { stops: [{ offset: 0-1, color?, opacity? }] }."
             }
           },
           "required": [
@@ -6319,7 +6341,7 @@
             },
             "gradientFill": {
               "type": "object",
-              "description": "Arc-length gradient for the gauge band. Color stops are sampled along the sweep from start to end."
+              "description": "Sweep gradient: { stops: [{ offset: 0-1, color?, opacity? }] }. Offset 0 is the sweep start and offset 1 is the sweep end."
             },
             "arcWidth": {
               "type": "number",
@@ -9835,6 +9857,10 @@
               "type": "number",
               "description": "Rounded corner radius (px) applied to the outermost ends of each lane — left+right for horizontal, top+bottom for vertical. Middle segments stay square; single-segment lanes round all four corners."
             },
+            "gradientFill": {
+              "type": "object",
+              "description": "Tip-to-base gradient: { stops: [{ offset: 0-1, color?, opacity? }] }."
+            },
             "brush": {
               "type": "boolean",
               "description": "Enable value-axis brush selection"
@@ -11206,6 +11232,14 @@
             "showRingLabels": {
               "type": "boolean",
               "description": "Show numeric distance-ring labels; defaults off in context and sparkline modes."
+            },
+            "cartogramLayout": {
+              "type": "string",
+              "enum": [
+                "radial",
+                "strip"
+              ],
+              "description": "Cost encoding: radial polar cartogram (default) or strip (Langren 1D cost axis). Sparkline mode defaults to strip."
             }
           },
           "required": [
@@ -11888,11 +11922,8 @@
               "default": 0.6
             },
             "gradientFill": {
-              "type": [
-                "boolean",
-                "object"
-              ],
-              "description": "Tip→base gradient across each segment; same shape as AreaChart.gradientFill"
+              "type": "object",
+              "description": "Tip-to-base gradient: { stops: [{ offset: 0-1, color?, opacity? }] }."
             },
             "xExtent": {
               "type": "array",
@@ -13527,6 +13558,1349 @@
           ]
         }
       }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "CrucibleChart",
+        "description": "Physics-backed authored treatment chart. A bounded source charge passes through explicit phases and events into declared product molds and reason-labelled outlets; physics presents formation and separation but never discovers the program or products.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "data": {
+              "type": "array",
+              "description": "Array of source records. Each record becomes one or more simulated bodies."
+            },
+            "size": {
+              "type": "array",
+              "description": "[width, height] in pixels"
+            },
+            "width": {
+              "type": "number",
+              "description": "Alias for size[0]"
+            },
+            "height": {
+              "type": "number",
+              "description": "Alias for size[1]"
+            },
+            "className": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "responsiveWidth": {
+              "type": "boolean"
+            },
+            "responsiveHeight": {
+              "type": "boolean"
+            },
+            "colorBy": {
+              "type": "string",
+              "description": "Color sources by category, status, outlet, product, or a categorical accessor.",
+              "default": "category",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "seed": {
+              "type": [
+                "number",
+                "string"
+              ],
+              "description": "Deterministic placement seed. It cannot change events, products, or destinations.",
+              "default": 1
+            },
+            "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 semantic playback without altering authored time or terminal accounting.",
+              "default": false
+            },
+            "tooltip": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Tooltip content function/config, true for the default body tooltip, or false to disable hover tooltips.",
+              "x-semiotic-runtime-types": [
+                "boolean",
+                "function",
+                "object"
+              ]
+            },
+            "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.",
+              "minItems": 1,
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "duration": {
+                    "type": "number",
+                    "exclusiveMinimum": 0
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "description": {
+                    "type": "string"
+                  },
+                  "intensity": {
+                    "type": "number"
+                  },
+                  "motion": {
+                    "type": "string",
+                    "enum": [
+                      "charge",
+                      "mix",
+                      "hold",
+                      "press",
+                      "bind",
+                      "separate",
+                      "pour",
+                      "quench"
+                    ]
+                  },
+                  "color": {
+                    "type": "string"
+                  },
+                  "metrics": {
+                    "type": "object"
+                  }
+                },
+                "required": [
+                  "id",
+                  "duration"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "products": {
+              "type": "array",
+              "description": "Declared product molds referenced by combine, contribute, complete-product, and split effects. Products are never inferred from collisions or flat rows.",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "description": {
+                    "type": "string"
+                  },
+                  "category": {
+                    "type": "string"
+                  },
+                  "amount": {
+                    "type": "number",
+                    "minimum": 0
+                  },
+                  "color": {
+                    "type": "string"
+                  },
+                  "metrics": {
+                    "type": "object",
+                    "additionalProperties": {
+                      "type": "number"
+                    }
+                  },
+                  "outletId": {
+                    "type": "string"
+                  },
+                  "order": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "events": {
+              "type": "array",
+              "description": "Serializable authored event tape. Each event has a stable id, a time or phase/progress position, and explicit effects.",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "at": {
+                    "oneOf": [
+                      {
+                        "type": "object",
+                        "properties": {
+                          "time": {
+                            "type": "number",
+                            "minimum": 0
+                          }
+                        },
+                        "required": [
+                          "time"
+                        ],
+                        "additionalProperties": false
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "phaseId": {
+                            "type": "string"
+                          },
+                          "progress": {
+                            "type": "number",
+                            "minimum": 0,
+                            "maximum": 1
+                          }
+                        },
+                        "required": [
+                          "phaseId"
+                        ],
+                        "additionalProperties": false
+                      }
+                    ]
+                  },
+                  "effects": {
+                    "type": "array",
+                    "items": {
+                      "oneOf": [
+                        {
+                          "type": "object",
+                          "description": "Change the explicit semantic state of selected source components.",
+                          "properties": {
+                            "type": {
+                              "const": "set-state"
+                            },
+                            "select": {
+                              "type": "object",
+                              "properties": {
+                                "ids": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string"
+                                  },
+                                  "minItems": 1
+                                },
+                                "categories": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string"
+                                  },
+                                  "minItems": 1
+                                },
+                                "statuses": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string",
+                                    "enum": [
+                                      "queued",
+                                      "active",
+                                      "transformed",
+                                      "consumed",
+                                      "retained",
+                                      "ejected",
+                                      "failed",
+                                      "recovered"
+                                    ]
+                                  },
+                                  "minItems": 1
+                                },
+                                "outletIds": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string"
+                                  },
+                                  "minItems": 1
+                                },
+                                "count": {
+                                  "type": "integer",
+                                  "minimum": 0
+                                }
+                              },
+                              "additionalProperties": false
+                            },
+                            "state": {
+                              "type": "string",
+                              "enum": [
+                                "queued",
+                                "active",
+                                "transformed",
+                                "retained",
+                                "ejected",
+                                "failed",
+                                "recovered"
+                              ]
+                            },
+                            "outletId": {
+                              "type": "string"
+                            },
+                            "reason": {
+                              "type": "string"
+                            },
+                            "metricsDelta": {
+                              "type": "object",
+                              "additionalProperties": {
+                                "type": "number"
+                              }
+                            }
+                          },
+                          "required": [
+                            "type",
+                            "select",
+                            "state"
+                          ],
+                          "additionalProperties": false
+                        },
+                        {
+                          "type": "object",
+                          "description": "Author a visible relation; physics never discovers one.",
+                          "properties": {
+                            "type": {
+                              "const": "set-relation"
+                            },
+                            "relation": {
+                              "type": "object",
+                              "properties": {
+                                "id": {
+                                  "type": "string"
+                                },
+                                "sourceIds": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string"
+                                  },
+                                  "minItems": 2
+                                },
+                                "label": {
+                                  "type": "string"
+                                },
+                                "category": {
+                                  "type": "string"
+                                },
+                                "strength": {
+                                  "type": "number"
+                                },
+                                "metrics": {
+                                  "type": "object",
+                                  "additionalProperties": {
+                                    "type": "number"
+                                  }
+                                }
+                              },
+                              "required": [
+                                "id",
+                                "sourceIds"
+                              ],
+                              "additionalProperties": false
+                            }
+                          },
+                          "required": [
+                            "type",
+                            "relation"
+                          ],
+                          "additionalProperties": false
+                        },
+                        {
+                          "type": "object",
+                          "description": "Resolve previously authored relations.",
+                          "properties": {
+                            "type": {
+                              "const": "resolve-relation"
+                            },
+                            "relationIds": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              },
+                              "minItems": 1
+                            },
+                            "resolution": {
+                              "type": "string",
+                              "enum": [
+                                "combined",
+                                "rejected",
+                                "expired"
+                              ]
+                            },
+                            "reason": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "type",
+                            "relationIds",
+                            "resolution"
+                          ],
+                          "additionalProperties": false
+                        },
+                        {
+                          "type": "object",
+                          "description": "Combine named sources into a declared product. Set complete=false before later contribute effects.",
+                          "properties": {
+                            "type": {
+                              "const": "combine"
+                            },
+                            "sourceIds": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              },
+                              "minItems": 1
+                            },
+                            "productId": {
+                              "type": "string"
+                            },
+                            "basisRelationIds": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              },
+                              "minItems": 1
+                            },
+                            "loss": {
+                              "type": "object",
+                              "properties": {
+                                "amount": {
+                                  "type": "number",
+                                  "minimum": 0
+                                },
+                                "metrics": {
+                                  "type": "object",
+                                  "additionalProperties": {
+                                    "type": "number"
+                                  }
+                                },
+                                "label": {
+                                  "type": "string"
+                                }
+                              },
+                              "additionalProperties": false
+                            },
+                            "complete": {
+                              "type": "boolean",
+                              "default": true
+                            }
+                          },
+                          "required": [
+                            "type",
+                            "sourceIds",
+                            "productId"
+                          ],
+                          "additionalProperties": false
+                        },
+                        {
+                          "type": "object",
+                          "description": "Add named sources to an explicitly forming product.",
+                          "properties": {
+                            "type": {
+                              "const": "contribute"
+                            },
+                            "sourceIds": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              },
+                              "minItems": 1
+                            },
+                            "productId": {
+                              "type": "string"
+                            },
+                            "basisRelationIds": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              },
+                              "minItems": 1
+                            },
+                            "loss": {
+                              "type": "object",
+                              "properties": {
+                                "amount": {
+                                  "type": "number",
+                                  "minimum": 0
+                                },
+                                "metrics": {
+                                  "type": "object",
+                                  "additionalProperties": {
+                                    "type": "number"
+                                  }
+                                },
+                                "label": {
+                                  "type": "string"
+                                }
+                              },
+                              "additionalProperties": false
+                            }
+                          },
+                          "required": [
+                            "type",
+                            "sourceIds",
+                            "productId"
+                          ],
+                          "additionalProperties": false
+                        },
+                        {
+                          "type": "object",
+                          "description": "Complete a forming product and optionally route it to a declared outlet.",
+                          "properties": {
+                            "type": {
+                              "const": "complete-product"
+                            },
+                            "productId": {
+                              "type": "string"
+                            },
+                            "outletId": {
+                              "type": "string"
+                            },
+                            "reason": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "type",
+                            "productId"
+                          ],
+                          "additionalProperties": false
+                        },
+                        {
+                          "type": "object",
+                          "description": "Split one named source into explicit product allocations.",
+                          "properties": {
+                            "type": {
+                              "const": "split"
+                            },
+                            "sourceId": {
+                              "type": "string"
+                            },
+                            "products": {
+                              "type": "array",
+                              "items": {
+                                "type": "object",
+                                "properties": {
+                                  "productId": {
+                                    "type": "string"
+                                  },
+                                  "amount": {
+                                    "type": "number",
+                                    "minimum": 0
+                                  },
+                                  "metrics": {
+                                    "type": "object",
+                                    "additionalProperties": {
+                                      "type": "number"
+                                    }
+                                  }
+                                },
+                                "required": [
+                                  "productId"
+                                ],
+                                "additionalProperties": false
+                              },
+                              "minItems": 1
+                            },
+                            "loss": {
+                              "type": "object",
+                              "properties": {
+                                "amount": {
+                                  "type": "number",
+                                  "minimum": 0
+                                },
+                                "metrics": {
+                                  "type": "object",
+                                  "additionalProperties": {
+                                    "type": "number"
+                                  }
+                                },
+                                "label": {
+                                  "type": "string"
+                                }
+                              },
+                              "additionalProperties": false
+                            }
+                          },
+                          "required": [
+                            "type",
+                            "sourceId",
+                            "products"
+                          ],
+                          "additionalProperties": false
+                        },
+                        {
+                          "type": "object",
+                          "description": "Route selected source components to a declared outlet with a reason.",
+                          "properties": {
+                            "type": {
+                              "const": "eject"
+                            },
+                            "select": {
+                              "type": "object",
+                              "properties": {
+                                "ids": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string"
+                                  },
+                                  "minItems": 1
+                                },
+                                "categories": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string"
+                                  },
+                                  "minItems": 1
+                                },
+                                "statuses": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string",
+                                    "enum": [
+                                      "queued",
+                                      "active",
+                                      "transformed",
+                                      "consumed",
+                                      "retained",
+                                      "ejected",
+                                      "failed",
+                                      "recovered"
+                                    ]
+                                  },
+                                  "minItems": 1
+                                },
+                                "outletIds": {
+                                  "type": "array",
+                                  "items": {
+                                    "type": "string"
+                                  },
+                                  "minItems": 1
+                                },
+                                "count": {
+                                  "type": "integer",
+                                  "minimum": 0
+                                }
+                              },
+                              "additionalProperties": false
+                            },
+                            "outletId": {
+                              "type": "string"
+                            },
+                            "state": {
+                              "type": "string",
+                              "enum": [
+                                "ejected",
+                                "failed",
+                                "retained",
+                                "recovered"
+                              ]
+                            },
+                            "reason": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "type",
+                            "select",
+                            "outletId"
+                          ],
+                          "additionalProperties": false
+                        },
+                        {
+                          "type": "object",
+                          "description": "Apply an explicit numeric metric delta to the run, sources, or products.",
+                          "properties": {
+                            "type": {
+                              "const": "set-metric"
+                            },
+                            "target": {
+                              "oneOf": [
+                                {
+                                  "const": "run"
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "components": {
+                                      "type": "object",
+                                      "properties": {
+                                        "ids": {
+                                          "type": "array",
+                                          "items": {
+                                            "type": "string"
+                                          },
+                                          "minItems": 1
+                                        },
+                                        "categories": {
+                                          "type": "array",
+                                          "items": {
+                                            "type": "string"
+                                          },
+                                          "minItems": 1
+                                        },
+                                        "statuses": {
+                                          "type": "array",
+                                          "items": {
+                                            "type": "string",
+                                            "enum": [
+                                              "queued",
+                                              "active",
+                                              "transformed",
+                                              "consumed",
+                                              "retained",
+                                              "ejected",
+                                              "failed",
+                                              "recovered"
+                                            ]
+                                          },
+                                          "minItems": 1
+                                        },
+                                        "outletIds": {
+                                          "type": "array",
+                                          "items": {
+                                            "type": "string"
+                                          },
+                                          "minItems": 1
+                                        },
+                                        "count": {
+                                          "type": "integer",
+                                          "minimum": 0
+                                        }
+                                      },
+                                      "additionalProperties": false
+                                    }
+                                  },
+                                  "required": [
+                                    "components"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                {
+                                  "type": "object",
+                                  "properties": {
+                                    "productIds": {
+                                      "type": "array",
+                                      "items": {
+                                        "type": "string"
+                                      },
+                                      "minItems": 1
+                                    }
+                                  },
+                                  "required": [
+                                    "productIds"
+                                  ],
+                                  "additionalProperties": false
+                                }
+                              ]
+                            },
+                            "metricsDelta": {
+                              "type": "object",
+                              "additionalProperties": {
+                                "type": "number"
+                              }
+                            }
+                          },
+                          "required": [
+                            "type",
+                            "target",
+                            "metricsDelta"
+                          ],
+                          "additionalProperties": false
+                        },
+                        {
+                          "type": "object",
+                          "description": "Record an authored run-level outcome and optional summary.",
+                          "properties": {
+                            "type": {
+                              "const": "set-outcome"
+                            },
+                            "outcome": {
+                              "type": "string"
+                            },
+                            "summary": {
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "type",
+                            "outcome"
+                          ],
+                          "additionalProperties": false
+                        }
+                      ]
+                    },
+                    "minItems": 1
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "description": {
+                    "type": "string"
+                  },
+                  "summary": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id",
+                  "at",
+                  "effects"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "outlets": {
+              "type": "array",
+              "description": "Explicit reason-labelled destinations referenced by product completions and eject effects.",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "description": {
+                    "type": "string"
+                  },
+                  "side": {
+                    "type": "string",
+                    "enum": [
+                      "left",
+                      "right",
+                      "bottom"
+                    ]
+                  },
+                  "color": {
+                    "type": "string"
+                  },
+                  "order": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "idAccessor": {
+              "type": "string",
+              "description": "Stable source-component id. Event selectors and product provenance reference these resolved ids.",
+              "default": "id",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "labelAccessor": {
+              "type": "string",
+              "description": "Human-readable source-component label.",
+              "default": "label",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "categoryAccessor": {
+              "type": "string",
+              "description": "Categorical source field used for color and projection grouping.",
+              "default": "category",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "amountAccessor": {
+              "type": "string",
+              "description": "Optional non-negative amount conserved through explicit product, loss, and outlet accounting.",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "metricsAccessor": {
+              "type": "string",
+              "description": "Optional per-source numeric metric map used by authored effects and evidence.",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "initialStateAccessor": {
+              "type": "string",
+              "description": "Optional initial semantic component status; defaults to active.",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "metrics": {
+              "type": "object",
+              "description": "Run-level numeric metrics present before the event tape begins."
+            },
+            "amountLabel": {
+              "type": "string",
+              "description": "Display unit for source, product, loss, and conservation amounts."
+            },
+            "conservation": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Optional exact amount/metric balance check, or false to disable it."
+            },
+            "projection": {
+              "type": "object",
+              "description": "Settled truth layer: { groupBy: status|outlet|category|product, measure: count|amount|metric, order?, showInputBaseline?, showDelta? }."
+            },
+            "playback": {
+              "type": "string",
+              "enum": [
+                "replay",
+                "snapshot"
+              ],
+              "description": "Replay the authored tape, or render one deterministic snapshot without intermediate animation.",
+              "default": "replay"
+            },
+            "snapshotAt": {
+              "type": [
+                "number",
+                "object"
+              ],
+              "description": "Snapshot time in semantic seconds or { phaseId, progress? }; used only with playback=snapshot."
+            },
+            "controls": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Built-in play/pause, reset, phase-step, timeline, and speed controls.",
+              "default": false
+            },
+            "playbackRate": {
+              "type": "number",
+              "description": "Positive wall-clock multiplier for authored semantic playback; 0.5 is half speed and 2 is double speed.",
+              "default": 1
+            },
+            "rerunMS": {
+              "type": [
+                "number",
+                "null"
+              ],
+              "description": "Replay from a fresh deterministic mount this many milliseconds after settling. Null or omission disables looping; zero uses the next timer turn."
+            },
+            "bodyRadius": {
+              "type": "number",
+              "description": "Fixed source-body radius. Per-row radius accessors are outside the bounded V1 contract.",
+              "default": 7
+            },
+            "radiusRange": {
+              "type": "array",
+              "description": "Minimum and maximum source-body radii when amountAccessor drives area.",
+              "default": [
+                5,
+                18
+              ]
+            },
+            "showBonds": {
+              "type": "boolean",
+              "description": "Draw authored provisional relations and product-member bonds.",
+              "default": true
+            },
+            "showChrome": {
+              "type": "boolean",
+              "description": "Draw the phase rail, vessel, declared molds, and reason-labelled outlets.",
+              "default": true
+            },
+            "showProjection": {
+              "type": "boolean",
+              "description": "Draw the exact settled projection alongside the physical treatment.",
+              "default": true
+            },
+            "initialSpawnPacing": {
+              "type": "object",
+              "description": "Optional presentation-only pacing for the initial source charge."
+            },
+            "loading": {
+              "type": "boolean",
+              "description": "Show a loading state instead of starting the authored run."
+            }
+          },
+          "required": [
+            "data",
+            "phases"
+          ]
+        }
+      }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "BumpChart",
+        "description": "Ranked series trajectories across ordered or time-based columns, with optional magnitude-encoded ribbons.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "mode": {
+              "type": "string",
+              "enum": [
+                "primary",
+                "context",
+                "sparkline",
+                "mobile"
+              ],
+              "description": "Display mode controlling default size, decoration, margins, labels, and interaction.",
+              "default": "primary"
+            },
+            "width": {
+              "type": "number",
+              "default": 600
+            },
+            "height": {
+              "type": "number",
+              "default": 400
+            },
+            "margin": {
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
+            },
+            "className": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string",
+              "description": "Visible chart title and the chart's accessible name."
+            },
+            "description": {
+              "type": "string",
+              "description": "Concise accessible description that overrides the chart's generated aria-label."
+            },
+            "summary": {
+              "type": "string",
+              "description": "Screen-reader-only summary of the chart's key takeaway; include keyboard interaction guidance when relevant."
+            },
+            "accessibleTable": {
+              "type": "boolean",
+              "description": "Expose the chart data through Semiotic's screen-reader data table.",
+              "default": true
+            },
+            "enableHover": {
+              "type": "boolean",
+              "default": true
+            },
+            "showLegend": {
+              "type": "boolean"
+            },
+            "showGrid": {
+              "type": "boolean",
+              "default": false
+            },
+            "colorBy": {
+              "type": "string",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "colorScheme": {
+              "type": [
+                "string",
+                "array",
+                "object"
+              ],
+              "default": "category10"
+            },
+            "tooltip": {
+              "type": [
+                "boolean",
+                "object",
+                "string"
+              ],
+              "x-semiotic-runtime-types": [
+                "boolean",
+                "function",
+                "object",
+                "string"
+              ]
+            },
+            "annotations": {
+              "type": "array",
+              "description": "Annotation objects to render on the chart. Each must have a `type` field. Position using your data field names (e.g. { type: \"widget\", month: \"Jan\", revenue: 500 }). Supported types: \"widget\" (arbitrary HTML/React content via foreignObject — v3 replacement for htmlAnnotationRules), \"label\" (callout with connector), \"callout\" (circle + label), \"text\" (plain label), \"y-threshold\" (horizontal reference line), \"x-threshold\" (vertical reference line), \"band\" (shaded y-region), \"enclose\" (circle around points), \"rect-enclose\" (rect around points), \"highlight\" (colored dots on filtered points), \"trend\" (regression line), \"envelope\" (upper/lower bounds), \"anomaly-band\" (mean ± stddev), \"forecast\" (extrapolated trend). Widget annotations accept: content (ReactNode), dx, dy, width, height, anchor (\"fixed\"|\"latest\"|\"sticky\"). Threshold annotations accept: value, label, color, strokeWidth, strokeDasharray. Enclose annotations accept: coordinates (array of data objects), label, color, padding.",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "widget",
+                      "label",
+                      "callout",
+                      "text",
+                      "bracket",
+                      "y-threshold",
+                      "x-threshold",
+                      "band",
+                      "enclose",
+                      "rect-enclose",
+                      "highlight",
+                      "trend",
+                      "envelope",
+                      "anomaly-band",
+                      "forecast"
+                    ],
+                    "description": "Annotation type"
+                  }
+                },
+                "required": [
+                  "type"
+                ]
+              }
+            },
+            "autoPlaceAnnotations": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Opt-in annotation placement pass. Chooses dx/dy for note-like annotations without manual offsets and avoids note/mark/edge overlaps where possible.",
+              "default": false
+            },
+            "responsiveRules": {
+              "type": "array",
+              "description": "Semantic responsive transforms applied before chart-mode defaults."
+            },
+            "mobileSemantics": {
+              "type": "object",
+              "description": "Phone/mobile contract consumed by audits, recipes, adapters, and agents."
+            },
+            "mobileInteraction": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Touch-first interaction policy for phone-sized chart slots."
+            },
+            "axisExtent": {
+              "type": "string",
+              "enum": [
+                "nice",
+                "exact"
+              ],
+              "description": "Tick endpoint mode. \"nice\" rounds endpoints to readable values; \"exact\" pins the first and last tick to the actual data min and max with equidistant intermediates. Affects XY x/y axes and ordinal value axis only.",
+              "default": "nice"
+            },
+            "animate": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Enable mark transitions (boolean or {duration?, easing?, intro?})."
+            },
+            "loading": {
+              "type": "boolean",
+              "description": "Show loading skeleton / loadingContent."
+            },
+            "hoverHighlight": {
+              "type": [
+                "boolean",
+                "string"
+              ],
+              "enum": [
+                "series"
+              ],
+              "default": true
+            },
+            "chartId": {
+              "type": "string",
+              "description": "Stable id for linked selection / observation / nav sync."
+            },
+            "emphasis": {
+              "type": "string",
+              "enum": [
+                "primary",
+                "secondary"
+              ]
+            },
+            "responsiveWidth": {
+              "type": "boolean"
+            },
+            "responsiveHeight": {
+              "type": "boolean"
+            },
+            "color": {
+              "type": "string",
+              "description": "Uniform mark fill (primitive styling)."
+            },
+            "stroke": {
+              "type": "string"
+            },
+            "strokeWidth": {
+              "type": "number"
+            },
+            "opacity": {
+              "type": "number"
+            },
+            "data": {
+              "type": "array",
+              "description": "Flat observations containing one magnitude per series and ranking column."
+            },
+            "xAccessor": {
+              "type": "string",
+              "description": "Ordered or temporal ranking-column accessor.",
+              "default": "x",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "yAccessor": {
+              "type": "string",
+              "description": "Numeric magnitude used to calculate rank and ribbon width.",
+              "default": "y",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "xLabel": {
+              "type": "string"
+            },
+            "yLabel": {
+              "type": "string",
+              "default": "Rank"
+            },
+            "lineBy": {
+              "type": "string",
+              "description": "Series identity accessor.",
+              "default": "series",
+              "x-semiotic-runtime-types": [
+                "string",
+                "function"
+              ]
+            },
+            "rankDirection": {
+              "type": "string",
+              "enum": [
+                "descending",
+                "ascending"
+              ],
+              "default": "descending"
+            },
+            "ribbon": {
+              "type": "boolean",
+              "description": "Encode the original magnitude as trajectory width.",
+              "default": false
+            },
+            "curve": {
+              "type": "string",
+              "enum": [
+                "smooth",
+                "linear"
+              ],
+              "default": "smooth"
+            },
+            "ribbonSizeRange": {
+              "type": "array",
+              "description": "Minimum and maximum full ribbon width in pixels.",
+              "default": [
+                4,
+                28
+              ]
+            },
+            "samplesPerSegment": {
+              "type": "number",
+              "default": 12
+            },
+            "lineWidth": {
+              "type": "number",
+              "description": "Fixed trajectory width when ribbon is false.",
+              "default": 3
+            },
+            "highlightTop": {
+              "type": "number",
+              "description": "Use categorical colors for the N series with the best overall mean rank."
+            },
+            "neutralColor": {
+              "type": "string",
+              "description": "Color for trajectories outside highlightTop. Defaults to the theme's secondary text color."
+            },
+            "ribbonOpacity": {
+              "type": "number",
+              "default": 0.82
+            },
+            "lineOpacity": {
+              "type": "number",
+              "default": 0.9
+            },
+            "showPoints": {
+              "type": "boolean",
+              "default": false
+            },
+            "pointRadius": {
+              "type": "number",
+              "default": 3
+            },
+            "showLabels": {
+              "type": [
+                "boolean",
+                "string"
+              ],
+              "enum": [
+                "start",
+                "end",
+                "both"
+              ],
+              "default": true
+            },
+            "showAxes": {
+              "type": "boolean",
+              "default": true
+            },
+            "legendInteraction": {
+              "type": "string",
+              "enum": [
+                "highlight",
+                "isolate",
+                "none"
+              ],
+              "default": "none"
+            },
+            "legendPosition": {
+              "type": "string",
+              "enum": [
+                "right",
+                "left",
+                "top",
+                "bottom"
+              ],
+              "default": "right"
+            }
+          },
+          "required": [
+            "data"
+          ]
+        }
+      }
     }
   ]
 }