semiotic 3.5.3 → 3.6.0

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.6.0",
   "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"
@@ -864,7 +880,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",
@@ -897,9 +935,7 @@
               "default": 0.8
             }
           },
-          "required": [
-            "quadrants"
-          ]
+          "required": []
         }
       }
     },
@@ -920,7 +956,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 +1091,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 +1256,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 +1421,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 +1589,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 +1760,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 +1924,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 +2083,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"
@@ -2136,7 +2180,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": [
@@ -2182,9 +2233,7 @@
               "default": 20
             }
           },
-          "required": [
-            "levels"
-          ]
+          "required": []
         }
       }
     },
@@ -2205,7 +2254,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 +2408,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 +2575,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 +2729,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 +2876,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 +3036,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 +3178,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 +3344,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 +3473,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 +3614,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 +3712,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 +3730,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 +3742,10 @@
             "needleColor": {
               "type": "string"
             },
+            "color": {
+              "type": "string",
+              "description": "Fallback fill color used when no thresholds are defined"
+            },
             "valueFormat": {
               "type": "function"
             },
@@ -3705,7 +3777,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 +3969,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 +4166,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 +4341,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 +4520,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 +4665,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 +4814,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 +5264,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 +5818,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 +5991,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 +6182,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 +6295,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 +6404,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 +6526,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 +6661,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 +6785,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 +6903,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 +7156,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 +7358,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"
+          ]
+        }
+      }
     }
   ]
 }