decantr 0.9.0

package/src/registry/chart.json

@@ -0,0 +1,136 @@
+{
+  "$schema": "https://decantr.ai/schemas/module.v1.json",
+  "module": "decantr/chart",
+  "file": "src/chart/index.js",
+  "exports": {
+    "Chart": {
+      "params": [
+        {
+          "name": "spec",
+          "type": "Object",
+          "properties": {
+            "type": { "type": "string", "enum": ["line", "bar", "area", "pie", "scatter", "bubble", "histogram", "box-plot", "candlestick", "waterfall", "range-bar", "range-area", "heatmap", "combination", "radar", "radial", "gauge", "funnel", "treemap", "sunburst", "sankey", "chord", "swimlane", "org-chart"], "default": "line" },
+            "data": { "type": "Object[]|() => Object[]", "required": true },
+            "x": { "type": "string", "description": "Field name for x-axis values" },
+            "y": { "type": "string|string[]", "description": "Field name(s) for y-axis values" },
+            "y2": { "type": "string", "description": "Secondary y-axis field" },
+            "series": { "type": "string", "description": "Field to split data into series" },
+            "title": { "type": "string|() => string" },
+            "xFormat": { "type": "(value) => string", "description": "Custom x-axis label formatter" },
+            "yFormat": { "type": "(value) => string", "description": "Custom y-axis label formatter" },
+            "tooltip": { "type": "boolean|((point) => HTMLElement)", "default": true },
+            "legend": { "type": "boolean", "default": true },
+            "grid": { "type": "boolean", "default": true },
+            "stacked": { "type": "boolean", "default": false },
+            "horizontal": { "type": "boolean", "default": false, "description": "Swap axes for horizontal orientation" },
+            "donut": { "type": "boolean", "default": true, "description": "Pie chart inner radius (false = full pie)" },
+            "smooth": { "type": "boolean", "default": true, "description": "Smooth curve interpolation (Catmull-Rom)" },
+            "dots": { "type": "boolean", "default": true, "description": "Show data point dots on line/area charts (suppressed when points > 50)" },
+            "axisLine": { "type": "boolean", "default": false, "description": "Show axis lines (hidden by default for minimal ShadCN aesthetic)" },
+            "labels": { "type": "boolean", "default": false, "description": "Show data point labels" },
+            "animate": { "type": "boolean", "default": true },
+            "zoom": { "type": "boolean", "default": false, "description": "Enable zoom/pan" },
+            "brush": { "type": "boolean|string", "enum": [false, "x", "y", "xy", true], "default": false, "description": "Brush selection mode" },
+            "crosshair": { "type": "boolean", "default": false, "description": "Enable crosshair guides" },
+            "live": { "type": "boolean", "default": false, "description": "Streaming mode optimizations" },
+            "interactive": { "type": "boolean", "default": false, "description": "Enable drag/drop, expand/collapse" },
+            "annotations": { "type": "Object[]", "description": "Annotation overlays. Three sub-types: line ({type:'line', axis:'x'|'y', value, label?, color?, dash?}), band ({type:'band', axis:'x'|'y', from, to, label?, color?}), point ({type:'point', x, y, label?, color?}). Rendered after data elements. Uses CSS classes .d-chart-annotation-line, .d-chart-annotation-band, .d-chart-annotation-label." },
+            "colorScale": { "type": "Function", "description": "Continuous color mapping for heatmap/treemap" },
+            "renderer": { "type": "string", "enum": ["auto", "svg", "canvas", "webgpu"], "default": "auto" },
+            "width": { "type": "string", "description": "Explicit chart width" },
+            "height": { "type": "string", "default": "300px" },
+            "tableAlt": { "type": "boolean", "default": true, "description": "Accessible data table fallback" },
+            "onClick": { "type": "Function", "description": "Click callback ({point, series, event})" },
+            "onBrush": { "type": "Function", "description": "Brush selection callback ({range})" },
+            "onZoom": { "type": "Function", "description": "Zoom callback ({domain})" },
+            "onMove": { "type": "Function", "description": "Drag reorder callback ({item, from, to}) — swimlane" },
+            "onToggle": { "type": "Function", "description": "Expand/collapse callback ({node, expanded}) — org-chart/sunburst" },
+            "onDrillDown": { "type": "Function", "description": "Drill-down callback ({node, depth}) — treemap/sunburst" },
+            "onLegendToggle": { "type": "Function", "description": "Legend toggle callback ({series, visible})" },
+            "aria-label": { "type": "string" },
+            "class": { "type": "string" }
+          }
+        }
+      ],
+      "returns": "HTMLElement",
+      "description": "Create a themed, reactive chart from a declarative spec."
+    },
+    "Sparkline": {
+      "params": [
+        {
+          "name": "spec",
+          "type": "Object",
+          "properties": {
+            "data": { "type": "number[]|Object[]|() => number[]", "required": true },
+            "x": { "type": "string", "description": "Field for x values (if object data)" },
+            "y": { "type": "string", "description": "Field for y values (if object data)" },
+            "height": { "type": "string", "default": "32px" },
+            "width": { "type": "string", "default": "120px" },
+            "aria-label": { "type": "string" },
+            "class": { "type": "string" }
+          }
+        }
+      ],
+      "returns": "HTMLElement",
+      "description": "Inline sparkline — no axes, no legend, no title."
+    },
+    "chartSpec": {
+      "params": [
+        { "name": "overrides", "type": "Object", "default": "{}" }
+      ],
+      "returns": "Object",
+      "description": "Validate and fill defaults for a chart spec."
+    },
+    "chartColor": {
+      "params": [
+        { "name": "index", "type": "number" }
+      ],
+      "returns": "string",
+      "description": "Get CSS variable reference for chart color at series index."
+    },
+    "PALETTE_SIZE": {
+      "type": "number",
+      "value": 8,
+      "description": "Number of chart palette colors (--d-chart-0 through --d-chart-7)."
+    },
+    "createStream": {
+      "params": [
+        { "name": "opts", "type": "Object", "properties": { "maxPoints": { "type": "number", "default": 500 } } }
+      ],
+      "returns": "{ append, data, window, destroy }",
+      "description": "Create streaming data source for live charts."
+    },
+    "colorScale": {
+      "params": [
+        { "name": "domain", "type": "number[]" },
+        { "name": "stops", "type": "string[]" }
+      ],
+      "returns": "(value: number) => string",
+      "description": "Continuous color scale for heatmaps/treemaps."
+    },
+    "resolvePalette": {
+      "params": [
+        { "name": "count", "type": "number" },
+        { "name": "el", "type": "HTMLElement", "optional": true }
+      ],
+      "returns": "string[]",
+      "description": "Resolve palette to hex values for Canvas/WebGPU."
+    },
+    "registerChartType": {
+      "params": [
+        { "name": "type", "type": "string" },
+        { "name": "layoutFn", "type": "Function" }
+      ],
+      "returns": "void",
+      "description": "Register a custom chart type layout."
+    },
+    "registerRenderer": {
+      "params": [
+        { "name": "type", "type": "string", "enum": ["webgpu"] },
+        { "name": "renderFn", "type": "Function" }
+      ],
+      "returns": "void",
+      "description": "Register a renderer implementation."
+    }
+  }
+}