semiotic 3.5.2 → 3.5.4

package/ai/schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "name": "semiotic",
-  "version": "3.5.2",
+  "version": "3.5.4",
   "description": "React data visualization library for charts, networks, and beyond",
   "tools": [
     {
@@ -21,7 +21,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -188,6 +189,13 @@
             "anomaly": {
               "type": "object",
               "description": "Anomaly overlay config — ±σ band + anomaly dot annotations. See AnomalyConfig."
+            },
+            "band": {
+              "type": [
+                "object",
+                "array"
+              ],
+              "description": "Asymmetric min/max envelope drawn under the line. `{ y0Accessor, y1Accessor, style?, perSeries?, interactive? }` or an array of those for percentile fans. Distinct from `forecast`/`anomaly` (computed) — band is pure data passthrough. Hovered datum is enriched with `band: { y0, y1 }` and `bands: [...]`."
             }
           },
           "required": [
@@ -213,7 +221,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -347,6 +356,17 @@
               ],
               "default": "monotoneX"
             },
+            "gradientFill": {
+              "type": [
+                "boolean",
+                "object"
+              ],
+              "description": "Renderer-space area gradient. true uses default opacity; object supports opacity or colorStops."
+            },
+            "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."
+            },
             "areaOpacity": {
               "type": "number",
               "description": "Area fill opacity (0-1)",
@@ -368,6 +388,13 @@
             "anomaly": {
               "type": "object",
               "description": "Anomaly overlay config — ±σ band + anomaly dot annotations. See AnomalyConfig."
+            },
+            "band": {
+              "type": [
+                "object",
+                "array"
+              ],
+              "description": "Asymmetric min/max envelope drawn under the area. See LineChart.band — same shape, same enrichment."
             }
           },
           "required": [
@@ -393,7 +420,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -566,7 +594,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -735,7 +764,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -906,7 +936,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -1040,7 +1071,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -1204,7 +1236,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -1368,7 +1401,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -1535,7 +1569,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -1705,7 +1740,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -1868,7 +1904,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -2026,7 +2063,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -2191,7 +2229,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -2344,7 +2383,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -2510,7 +2550,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -2663,7 +2704,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -2809,7 +2851,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -2968,7 +3011,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -3109,7 +3153,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -3274,7 +3319,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -3402,7 +3448,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -3542,7 +3589,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -3639,6 +3687,10 @@
               "type": "array",
               "description": "Array of { value, color, label? } defining threshold zones. Last value should equal max."
             },
+            "gradientFill": {
+              "type": "object",
+              "description": "Arc-length gradient for the gauge band. Color stops are sampled along the sweep from start to end."
+            },
             "arcWidth": {
               "type": "number",
               "description": "Arc thickness as fraction of radius (0-1)",
@@ -3653,6 +3705,11 @@
               "description": "Arc sweep angle in degrees (gap centered at bottom)",
               "default": 240
             },
+            "fillZones": {
+              "type": "boolean",
+              "description": "When true, the arc fills up to the current value; when false, the full arc is shown.",
+              "default": true
+            },
             "showNeedle": {
               "type": "boolean",
               "default": true
@@ -3660,6 +3717,10 @@
             "needleColor": {
               "type": "string"
             },
+            "color": {
+              "type": "string",
+              "description": "Fallback fill color used when no thresholds are defined"
+            },
             "valueFormat": {
               "type": "function"
             },
@@ -3691,7 +3752,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -3882,7 +3944,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -4078,7 +4141,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -4252,7 +4316,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -4430,7 +4495,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -4574,7 +4640,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -4722,7 +4789,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -5171,6 +5239,15 @@
               "type": "number",
               "description": "Time bin size in milliseconds (required)"
             },
+            "direction": {
+              "type": "string",
+              "enum": [
+                "up",
+                "down"
+              ],
+              "description": "Bar growth direction. Use \"down\" for mirrored histograms; explicit valueExtent is reversed.",
+              "default": "up"
+            },
             "categoryAccessor": {
               "type": [
                 "string",
@@ -5716,7 +5793,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -5888,7 +5966,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -6078,7 +6157,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -6190,7 +6270,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -6298,7 +6379,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -6419,7 +6501,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -6553,7 +6636,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -6676,7 +6760,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -6793,7 +6878,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -7045,7 +7131,8 @@
               "default": 400
             },
             "margin": {
-              "type": "object"
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
             },
             "className": {
               "type": "string"
@@ -7246,6 +7333,178 @@
           "required": []
         }
       }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "TemporalHistogram",
+        "description": "Static-data temporal histogram with binned aggregation. Use when data is a bounded array rather than a push stream.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "data": {
+              "type": "array",
+              "description": "Array of temporal observations"
+            },
+            "binSize": {
+              "type": "number",
+              "description": "Time bin size in milliseconds (required)"
+            },
+            "size": {
+              "type": "array",
+              "description": "[width, height] in pixels"
+            },
+            "width": {
+              "type": "number",
+              "description": "Alias for size[0]"
+            },
+            "height": {
+              "type": "number",
+              "description": "Alias for size[1]"
+            },
+            "margin": {
+              "type": "object",
+              "description": "Object margin. A side value of \"auto\" or null leaves that side available for auto-reservation."
+            },
+            "className": {
+              "type": "string"
+            },
+            "timeAccessor": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "description": "Key for time/x values"
+            },
+            "valueAccessor": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "description": "Key for y values"
+            },
+            "direction": {
+              "type": "string",
+              "enum": [
+                "up",
+                "down"
+              ],
+              "description": "Bar growth direction. Use \"down\" for mirrored histograms; explicit valueExtent is reversed.",
+              "default": "up"
+            },
+            "categoryAccessor": {
+              "type": [
+                "string",
+                "function"
+              ],
+              "description": "Key for category grouping"
+            },
+            "colors": {
+              "type": "object",
+              "description": "Map of category to color string"
+            },
+            "timeExtent": {
+              "type": "array"
+            },
+            "valueExtent": {
+              "type": "array"
+            },
+            "extentPadding": {
+              "type": "number"
+            },
+            "showAxes": {
+              "type": "boolean"
+            },
+            "background": {
+              "type": "string"
+            },
+            "enableHover": {
+              "type": [
+                "boolean",
+                "object"
+              ]
+            },
+            "tooltip": {
+              "type": [
+                "function",
+                "object"
+              ],
+              "description": "Tooltip content function or config"
+            },
+            "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"
+                ]
+              }
+            },
+            "fill": {
+              "type": "string"
+            },
+            "stroke": {
+              "type": "string"
+            },
+            "strokeWidth": {
+              "type": "number"
+            },
+            "gap": {
+              "type": "number"
+            },
+            "linkedHover": {
+              "type": [
+                "boolean",
+                "string",
+                "object"
+              ]
+            },
+            "linkedBrush": {
+              "type": [
+                "string",
+                "object"
+              ],
+              "description": "Cross-chart brush coordination via LinkedCharts. String: selection name. Object: { name, xField, yField }."
+            },
+            "brush": {
+              "type": [
+                "boolean",
+                "string",
+                "object"
+              ],
+              "description": "Enable brush selection. true defaults to { dimension: \"x\", snap: \"bin\" }. String: \"x\". Object: { dimension, snap: \"continuous\"|\"bin\", snapDuring }."
+            }
+          },
+          "required": [
+            "data",
+            "binSize"
+          ]
+        }
+      }
     }
   ]
 }

package/ai/system-prompt.md

@@ -2,7 +2,7 @@
 
 <!-- semiotic-bundle-sizes:start -->
 <!-- Auto-generated by scripts/sync-bundle-sizes.mjs — do not edit by hand. -->
-**Use sub-path imports** — `semiotic/xy` (83KB gz), `semiotic/ordinal` (67KB gz), `semiotic/network` (62KB gz), `semiotic/geo` (50KB gz), `semiotic/realtime` (88KB gz), `semiotic/server` (114KB gz), `semiotic/utils` (22KB gz), `semiotic/recipes` (5KB gz), `semiotic/themes` (4KB gz), `semiotic/data` (3KB gz), `semiotic/ai` (184KB gz). Full `semiotic` is 183KB gz.
+**Use sub-path imports** — `semiotic/xy` (85KB gz), `semiotic/ordinal` (69KB gz), `semiotic/network` (63KB gz), `semiotic/geo` (52KB gz), `semiotic/realtime` (90KB gz), `semiotic/server` (122KB gz), `semiotic/utils` (22KB gz), `semiotic/recipes` (5KB gz), `semiotic/themes` (4KB gz), `semiotic/data` (3KB gz), `semiotic/ai` (189KB gz). Full `semiotic` is 188KB gz.
 <!-- semiotic-bundle-sizes:end -->
 
 ## Flat Array Data (`data: object[]`)