semiotic 3.5.3 → 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.3",
+  "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"
@@ -220,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"
@@ -354,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)",
@@ -407,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"
@@ -580,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"
@@ -749,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"
@@ -920,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"
@@ -1054,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"
@@ -1218,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"
@@ -1382,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"
@@ -1549,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"
@@ -1719,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"
@@ -1882,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"
@@ -2040,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"
@@ -2205,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"
@@ -2358,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"
@@ -2524,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"
@@ -2677,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"
@@ -2823,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"
@@ -2982,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"
@@ -3123,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"
@@ -3288,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"
@@ -3416,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"
@@ -3556,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"
@@ -3653,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)",
@@ -3667,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
@@ -3674,6 +3717,10 @@
             "needleColor": {
               "type": "string"
             },
+            "color": {
+              "type": "string",
+              "description": "Fallback fill color used when no thresholds are defined"
+            },
             "valueFormat": {
               "type": "function"
             },
@@ -3705,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"
@@ -3896,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"
@@ -4092,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"
@@ -4266,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"
@@ -4444,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"
@@ -4588,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"
@@ -4736,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"
@@ -5185,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",
@@ -5730,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"
@@ -5902,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"
@@ -6092,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"
@@ -6204,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"
@@ -6312,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"
@@ -6433,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"
@@ -6567,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"
@@ -6690,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"
@@ -6807,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"
@@ -7059,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"
@@ -7260,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` (85KB gz), `semiotic/ordinal` (68KB gz), `semiotic/network` (63KB gz), `semiotic/geo` (51KB gz), `semiotic/realtime` (90KB gz), `semiotic/server` (117KB gz), `semiotic/utils` (22KB gz), `semiotic/recipes` (5KB gz), `semiotic/themes` (4KB gz), `semiotic/data` (3KB gz), `semiotic/ai` (188KB gz). Full `semiotic` is 186KB 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[]`)

package/dist/components/charts/index.d.ts

@@ -13,7 +13,7 @@ export type { ConnectedScatterplotProps } from "./xy/ConnectedScatterplot";
 export { LineChart } from "./xy/LineChart";
 export type { LineChartProps } from "./xy/LineChart";
 export { AreaChart } from "./xy/AreaChart";
-export type { AreaChartProps } from "./xy/AreaChart";
+export type { AreaChartProps, SemanticGradientStop } from "./xy/AreaChart";
 export { DifferenceChart } from "./xy/DifferenceChart";
 export type { DifferenceChartProps } from "./xy/DifferenceChart";
 export { StackedAreaChart } from "./xy/StackedAreaChart";
@@ -88,8 +88,8 @@ export { OrbitDiagram } from "./network/OrbitDiagram";
 export type { OrbitDiagramProps, OrbitNode } from "./network/OrbitDiagram";
 export { RealtimeLineChart } from "./realtime/RealtimeLineChart";
 export type { RealtimeLineChartProps } from "./realtime/RealtimeLineChart";
-export { RealtimeTemporalHistogram, RealtimeHistogram } from "./realtime/RealtimeHistogram";
-export type { RealtimeTemporalHistogramProps, RealtimeHistogramProps } from "./realtime/RealtimeHistogram";
+export { RealtimeTemporalHistogram, RealtimeHistogram, TemporalHistogram } from "./realtime/RealtimeHistogram";
+export type { RealtimeTemporalHistogramProps, RealtimeHistogramProps, TemporalHistogramProps } from "./realtime/RealtimeHistogram";
 export { RealtimeSwarmChart } from "./realtime/RealtimeSwarmChart";
 export type { RealtimeSwarmChartProps } from "./realtime/RealtimeSwarmChart";
 export { RealtimeWaterfallChart } from "./realtime/RealtimeWaterfallChart";