semiotic 3.5.4 → 3.7.0

package/ai/schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "name": "semiotic",
-  "version": "3.5.4",
+  "version": "3.7.0",
   "description": "React data visualization library for charts, networks, and beyond",
   "tools": [
     {
@@ -94,6 +94,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -294,6 +302,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -493,6 +509,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -667,6 +691,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -837,6 +869,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -880,7 +920,29 @@
             },
             "quadrants": {
               "type": "object",
-              "description": "Configuration for the four quadrants: { topRight, topLeft, bottomRight, bottomLeft }, each with { label, color, opacity? }"
+              "description": "Optional configuration overrides for the four quadrants: { topRight, topLeft, bottomRight, bottomLeft }, each with partial { label, color, opacity }. Omitted quadrants and fields use built-in defaults.",
+              "default": {
+                "topLeft": {
+                  "label": "Low / High",
+                  "color": "#E9C46A",
+                  "opacity": 0.08
+                },
+                "topRight": {
+                  "label": "High / High",
+                  "color": "#2A9D8F",
+                  "opacity": 0.08
+                },
+                "bottomLeft": {
+                  "label": "Low / Low",
+                  "color": "#E76F51",
+                  "opacity": 0.08
+                },
+                "bottomRight": {
+                  "label": "High / Low",
+                  "color": "#86BBD8",
+                  "opacity": 0.08
+                }
+              }
             },
             "showQuadrantLabels": {
               "type": "boolean",
@@ -913,9 +975,7 @@
               "default": 0.8
             }
           },
-          "required": [
-            "quadrants"
-          ]
+          "required": []
         }
       }
     },
@@ -1008,6 +1068,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -1144,6 +1212,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -1309,6 +1385,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -1477,6 +1561,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -1642,6 +1734,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -1813,6 +1913,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -1978,6 +2086,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -2136,6 +2252,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -2160,7 +2284,14 @@
             },
             "levels": {
               "type": "array",
-              "description": "Ordered response labels, most negative to most positive (required). Odd count = center is neutral."
+              "description": "Ordered response labels, most negative to most positive. Defaults to a 5-point Very Low to Very High scale. Odd count = center is neutral.",
+              "default": [
+                "Very Low",
+                "Low",
+                "Neutral",
+                "High",
+                "Very High"
+              ]
             },
             "categoryAccessor": {
               "type": [
@@ -2206,9 +2337,7 @@
               "default": 20
             }
           },
-          "required": [
-            "levels"
-          ]
+          "required": []
         }
       }
     },
@@ -2303,6 +2432,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -2456,6 +2593,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -2623,6 +2768,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -2777,6 +2930,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -2924,6 +3085,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -3084,6 +3253,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -3226,6 +3403,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -3392,6 +3577,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -3521,6 +3714,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -3662,6 +3863,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -3825,6 +4034,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -4017,6 +4234,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -4214,6 +4439,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -4389,6 +4622,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -4568,6 +4809,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -4713,6 +4962,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -4862,6 +5119,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -5074,6 +5339,13 @@
                 ]
               }
             },
+            "autoPlaceAnnotations": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Opt-in annotation placement pass for note-like annotations without manual offsets."
+            },
             "decay": {
               "type": "object",
               "description": "Decay config: { type, halfLife, minOpacity }"
@@ -5223,6 +5495,13 @@
                 ]
               }
             },
+            "autoPlaceAnnotations": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Opt-in annotation placement pass for note-like annotations without manual offsets."
+            },
             "decay": {
               "type": "object",
               "description": "Decay config: { type, halfLife, minOpacity }"
@@ -5420,6 +5699,13 @@
                 ]
               }
             },
+            "autoPlaceAnnotations": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Opt-in annotation placement pass for note-like annotations without manual offsets."
+            },
             "decay": {
               "type": "object",
               "description": "Decay config: { type, halfLife, minOpacity }"
@@ -5584,6 +5870,13 @@
                 ]
               }
             },
+            "autoPlaceAnnotations": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Opt-in annotation placement pass for note-like annotations without manual offsets."
+            },
             "decay": {
               "type": "object",
               "description": "Decay config: { type, halfLife, minOpacity }"
@@ -5745,6 +6038,13 @@
                 ]
               }
             },
+            "autoPlaceAnnotations": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Opt-in annotation placement pass for note-like annotations without manual offsets."
+            },
             "decay": {
               "type": "object",
               "description": "Decay config: { type, halfLife, minOpacity }"
@@ -5866,6 +6166,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -6039,6 +6347,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -6230,6 +6546,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -6343,6 +6667,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -6451,6 +6783,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -6574,6 +6914,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -6709,6 +7057,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -6833,6 +7189,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -6951,6 +7315,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -7204,6 +7576,14 @@
                 ]
               }
             },
+            "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
+            },
             "axisExtent": {
               "type": "string",
               "enum": [
@@ -7464,6 +7844,13 @@
                 ]
               }
             },
+            "autoPlaceAnnotations": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Opt-in annotation placement pass for note-like annotations without manual offsets."
+            },
             "fill": {
               "type": "string"
             },
@@ -7505,6 +7892,224 @@
           ]
         }
       }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "BigNumber",
+        "description": "Focal-value display: one number, optionally with comparison / target / threshold zones (mapped to semantic theme roles) / four layout modes (tile / presentation / inline / thumbnail). Ships with NO chart-family dependency — embed your own Semiotic chart via two slots: `trendSlot` for wide / rectangular charts (LineChart, AreaChart) under the value, and `chartSlot` for square charts (DonutChart, PieChart, Scatterplot, Treemap) beside the value. The slot context exposes the resolved threshold colour + sentiment + push buffer so embedded charts can theme-link. Forward-looking POC for a future SingleValueFrame.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "width": {
+              "type": [
+                "number",
+                "string"
+              ],
+              "description": "Reserved width in pixels (or any CSS length). Mode-keyed defaults: 280 (tile) / 540 (presentation) / unset (inline / thumbnail).",
+              "default": 280
+            },
+            "height": {
+              "type": [
+                "number",
+                "string"
+              ],
+              "description": "Reserved height in pixels (or any CSS length). Mode-keyed defaults: 184 (tile) / 320 (presentation) / unset (inline / thumbnail).",
+              "default": 184
+            },
+            "className": {
+              "type": "string",
+              "description": "Composed with the BEM root class on the outer container."
+            },
+            "value": {
+              "type": "number",
+              "description": "The focal number this card exists to display"
+            },
+            "label": {
+              "type": "string",
+              "description": "Top-line descriptor rendered above the value"
+            },
+            "caption": {
+              "type": "string",
+              "description": "Secondary descriptor, smaller, below the label"
+            },
+            "format": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "enum": [
+                "number",
+                "currency",
+                "percent",
+                "compact",
+                "duration"
+              ],
+              "description": "Number-format shortcut or custom (value) => string",
+              "default": "number"
+            },
+            "locale": {
+              "type": "string",
+              "description": "BCP-47 locale for Intl.NumberFormat",
+              "default": "en-US"
+            },
+            "currency": {
+              "type": "string",
+              "description": "ISO 4217 code for format: \"currency\"",
+              "default": "USD"
+            },
+            "precision": {
+              "type": "number",
+              "description": "maximumFractionDigits passed to Intl.NumberFormat"
+            },
+            "prefix": {
+              "type": "string",
+              "description": "Prepend to formatted value"
+            },
+            "suffix": {
+              "type": "string",
+              "description": "Append to formatted value"
+            },
+            "unit": {
+              "type": "string",
+              "description": "Unit label rendered after the value as small text (e.g. \"USD\", \"req/s\")"
+            },
+            "comparison": {
+              "type": "object",
+              "description": "Comparison value: { value, label?, format?, direction? }. Drives the delta when explicit delta is not set."
+            },
+            "target": {
+              "type": "object",
+              "description": "Target value: { value, label?, format?, direction? }. Renders \"X% of target\" next to the comparison row."
+            },
+            "delta": {
+              "type": "number",
+              "description": "Explicit delta override; bypasses comparison-derived subtraction"
+            },
+            "deltaFormat": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "enum": [
+                "number",
+                "currency",
+                "percent",
+                "compact",
+                "duration"
+              ],
+              "description": "Format the delta; defaults to format"
+            },
+            "showDeltaPercent": {
+              "type": "boolean",
+              "description": "Render percent change next to absolute delta when a comparison is present",
+              "default": true
+            },
+            "direction": {
+              "type": "string",
+              "enum": [
+                "higher-is-better",
+                "lower-is-better",
+                "neutral"
+              ],
+              "description": "Default direction used to infer sentiment from the sign of the delta",
+              "default": "higher-is-better"
+            },
+            "sentiment": {
+              "type": "string",
+              "enum": [
+                "auto",
+                "positive",
+                "negative",
+                "neutral"
+              ],
+              "description": "Force sentiment; \"auto\" infers from direction + delta sign",
+              "default": "auto"
+            },
+            "thresholds": {
+              "type": "array",
+              "description": "Threshold zones: [{ at, level, color?, label? }] ordered ascending by `at`. Resolved by highest `at` ≤ value. `level` maps to a semantic CSS variable (--semiotic-{success|warning|danger|info})."
+            },
+            "chartSize": {
+              "type": "number",
+              "description": "Pixel size reserved for chartSlot (rendered as a square). Mode-keyed defaults: 44 (tile) / 80 (presentation) — sparkline scale; pass a larger value for a hero anchor."
+            },
+            "windowSize": {
+              "type": "number",
+              "description": "Cap on the trend buffer when fed via push API",
+              "default": 60
+            },
+            "mode": {
+              "type": "string",
+              "enum": [
+                "tile",
+                "presentation",
+                "inline",
+                "thumbnail"
+              ],
+              "description": "Layout mode — chrome envelope around the value",
+              "default": "tile"
+            },
+            "align": {
+              "type": "string",
+              "enum": [
+                "start",
+                "center",
+                "end"
+              ],
+              "description": "Horizontal alignment within the card"
+            },
+            "padding": {
+              "type": [
+                "number",
+                "object"
+              ],
+              "description": "Inner padding: number for uniform, or { top, right, bottom, left }"
+            },
+            "emphasis": {
+              "type": "string",
+              "enum": [
+                "primary",
+                "secondary"
+              ],
+              "description": "Visual emphasis hint; \"primary\" spans two ChartGrid columns"
+            },
+            "color": {
+              "type": "string",
+              "description": "Override the value text colour. CSS variables work."
+            },
+            "background": {
+              "type": "string",
+              "description": "Card background. CSS variables work."
+            },
+            "borderColor": {
+              "type": "string"
+            },
+            "borderRadius": {
+              "type": [
+                "number",
+                "string"
+              ]
+            },
+            "animate": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Tween between value changes. true = 300ms ease-out + intro. Object: { duration?, easing?: \"linear\"|\"ease-out\", intro? }"
+            },
+            "stalenessThreshold": {
+              "type": "number",
+              "description": "Mark stale (dimmed) when no push occurs for this many ms"
+            },
+            "staleLabel": {
+              "type": "string",
+              "default": "stale"
+            }
+          },
+          "required": []
+        }
+      }
     }
   ]
 }