@cascivo/mcp 0.1.6 → 0.1.8

package/dist/registry.json

@@ -1,6 +1,6 @@
 {
   "version": "0.0.0",
-  "generatedAt": "2026-06-23",
+  "generatedAt": "2026-06-25",
   "components": [
     {
       "name": "accordion",
@@ -17491,7 +17491,8 @@
           {
             "name": "series",
             "type": "BarChartSeries<Datum>[]",
-            "required": true
+            "required": true,
+            "description": "Series array. Each series accepts an optional `color` (any CSS color) overriding the positional palette for that series/stacked layer."
           },
           {
             "name": "x",
@@ -17547,11 +17548,28 @@
             "required": false,
             "default": "5"
           },
+          {
+            "name": "xLabelEvery",
+            "type": "number",
+            "required": false,
+            "description": "Show every Nth category label (always the last) to thin a crowded x-axis."
+          },
           {
             "name": "legend",
             "type": "boolean",
             "required": false
           },
+          {
+            "name": "tooltip",
+            "type": "boolean",
+            "required": false
+          },
+          {
+            "name": "tooltipFormat",
+            "type": "(p: ChartPoint) => string",
+            "required": false,
+            "description": "Custom tooltip formatter. The stacked default lists \"label · total\" + each non-zero layer in its color."
+          },
           {
             "name": "className",
             "type": "string",
@@ -17565,6 +17583,108 @@
             "description": "Marks only — no axes, grid lines, or legend. For micro/inline charts."
           }
         ],
+        "typeDefs": [
+          {
+            "name": "BarChartSeries<Datum>",
+            "description": "One series (a set of bars). Pass an array via the `series` prop.",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": true,
+                "description": "Stable series identity."
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": true,
+                "description": "Legend + tooltip label."
+              },
+              {
+                "name": "data",
+                "type": "readonly Datum[]",
+                "required": true,
+                "description": "Row data read by the `x`/`y` accessors."
+              },
+              {
+                "name": "color",
+                "type": "string",
+                "required": false,
+                "description": "Any CSS color overriding the positional palette (--cascivo-chart-N) for this series / stacked layer."
+              }
+            ]
+          },
+          {
+            "name": "StackedRow",
+            "description": "Row-oriented input to the `toStackedSeries(rows)` pivot helper.",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true,
+                "description": "Category (one bar)."
+              },
+              {
+                "name": "segments",
+                "type": "StackedSegment[]",
+                "required": true,
+                "description": "Per-layer values: { key, value, color? }. First non-undefined color per key wins."
+              }
+            ]
+          },
+          {
+            "name": "StackedSegment",
+            "description": "One layer of a stacked bar within a StackedRow.",
+            "fields": [
+              {
+                "name": "key",
+                "type": "string",
+                "required": true,
+                "description": "Layer key — becomes the series id/label (e.g. \"Done\")."
+              },
+              {
+                "name": "value",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "color",
+                "type": "string",
+                "required": false,
+                "description": "Optional CSS color for this layer."
+              }
+            ]
+          },
+          {
+            "name": "ChartPoint",
+            "description": "Argument passed to the `tooltipFormat` callback.",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true,
+                "description": "Category label."
+              },
+              {
+                "name": "value",
+                "type": "number | string",
+                "required": true
+              },
+              {
+                "name": "color",
+                "type": "string",
+                "required": false,
+                "description": "Resolved mark color (the default tooltip tints its text with this)."
+              },
+              {
+                "name": "segments",
+                "type": "readonly { label: string; value: number; color?: string }[]",
+                "required": false,
+                "description": "Per-layer breakdown for a stacked category; the default stacked tooltip lists these."
+              }
+            ]
+          }
+        ],
         "tokens": [
           "--cascivo-chart-1",
           "--cascivo-chart-2",
@@ -17584,6 +17704,10 @@
           {
             "title": "Basic bar chart",
             "code": "import { BarChart } from '@cascivo/charts'\n\nconst series = [{ id: 'a', label: 'Sales', data: [{x:'Jan',y:100},{x:'Feb',y:150}] }]\n<BarChart series={series} x={d => d.x} y={d => d.y} title=\"Sales\" />"
+          },
+          {
+            "title": "Stacked bar from row-oriented data",
+            "code": "import { BarChart, toStackedSeries } from '@cascivo/charts'\n\n// Pivot { label, segments[] } rows into series + x/y. Per-segment color is preserved.\nconst rows = [\n  { label: 'Mon', segments: [\n    { key: 'Done', value: 5, color: 'var(--cascivo-color-success)' },\n    { key: 'Blocked', value: 2, color: 'var(--cascivo-color-destructive)' },\n  ] },\n  { label: 'Tue', segments: [\n    { key: 'Done', value: 8, color: 'var(--cascivo-color-success)' },\n    { key: 'Blocked', value: 1, color: 'var(--cascivo-color-destructive)' },\n  ] },\n]\n// Tooltip shows \"Mon · 7\" then each non-zero layer in its color.\n<BarChart mode=\"stacked\" tooltip {...toStackedSeries(rows)} title=\"Throughput\" />"
           }
         ],
         "dependencies": ["@cascivo/charts"],
@@ -18675,7 +18799,7 @@
             "name": "data",
             "type": "PieChartDatum[]",
             "required": true,
-            "description": "Array of { label, value } datums"
+            "description": "Array of { id, label, value, color? } datums. Optional per-datum `color` (any CSS color) overrides the positional palette for that slice."
           },
           {
             "name": "title",
@@ -18704,6 +18828,54 @@
             "required": false,
             "default": "300"
           },
+          {
+            "name": "size",
+            "type": "number",
+            "required": false,
+            "description": "Square shorthand: sets width === height. Explicit width/height win."
+          },
+          {
+            "name": "thickness",
+            "type": "number",
+            "required": false,
+            "description": "Ring width in px (donut only); defaults to 0.4 × radius."
+          },
+          {
+            "name": "innerRadius",
+            "type": "number",
+            "required": false,
+            "description": "Inner radius in px (donut only); takes precedence over thickness; clamped to [0, outerRadius)."
+          },
+          {
+            "name": "centerValue",
+            "type": "string",
+            "required": false,
+            "description": "Center value text rendered in the donut hole (donut only)."
+          },
+          {
+            "name": "centerLabel",
+            "type": "string",
+            "required": false,
+            "description": "Center label text rendered below the value (donut only)."
+          },
+          {
+            "name": "centerSlot",
+            "type": "ReactNode",
+            "required": false,
+            "description": "Arbitrary content for the donut hole; takes precedence over centerValue/centerLabel."
+          },
+          {
+            "name": "emptyLabel",
+            "type": "string",
+            "required": false,
+            "description": "Visible placeholder text when data is empty. Defaults to the i18n \"No data\"."
+          },
+          {
+            "name": "tooltipFormat",
+            "type": "(p: ChartPoint) => string",
+            "required": false,
+            "description": "Custom tooltip formatter. Defaults to \"value (pct%)\" in the slice color."
+          },
           {
             "name": "legend",
             "type": "boolean",
@@ -18722,6 +18894,65 @@
             "description": "Marks only — no axes, grid lines, or legend. For micro/inline charts."
           }
         ],
+        "typeDefs": [
+          {
+            "name": "PieChartDatum",
+            "description": "One slice. Pass via the `data` prop.",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": false,
+                "description": "Stable identity (used for legend toggle state)."
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "value",
+                "type": "number",
+                "required": true
+              },
+              {
+                "name": "color",
+                "type": "string",
+                "required": false,
+                "description": "Any CSS color overriding the positional palette (--cascivo-chart-N) for this slice."
+              }
+            ]
+          },
+          {
+            "name": "ChartPoint",
+            "description": "Argument passed to the `tooltipFormat` callback.",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true,
+                "description": "Slice label."
+              },
+              {
+                "name": "value",
+                "type": "number | string",
+                "required": true
+              },
+              {
+                "name": "percent",
+                "type": "number",
+                "required": false,
+                "description": "Share of the whole, 0–100. Used by the default \"value (pct%)\" formatter."
+              },
+              {
+                "name": "color",
+                "type": "string",
+                "required": false,
+                "description": "Resolved slice color (the default tooltip tints its text with this)."
+              }
+            ]
+          }
+        ],
         "tokens": [
           "--cascivo-chart-1",
           "--cascivo-chart-2",
@@ -18741,6 +18972,14 @@
           {
             "title": "Basic pie chart",
             "code": "import { PieChart } from '@cascivo/charts'\n\n<PieChart data={[{label:'A',value:60},{label:'B',value:40}]} title=\"Market share\" />"
+          },
+          {
+            "title": "Donut with center total and custom thickness",
+            "code": "import { PieChart } from '@cascivo/charts'\n\n<PieChart\n  donut\n  size={220}\n  thickness={28}\n  centerValue=\"142\"\n  centerLabel=\"Total tasks\"\n  data={[\n    { id: 'done', label: 'Done', value: 92, color: 'var(--cascivo-color-success)' },\n    { id: 'wip', label: 'In progress', value: 34, color: 'var(--cascivo-color-warning)' },\n    { id: 'blocked', label: 'Blocked', value: 16, color: 'var(--cascivo-color-destructive)' },\n  ]}\n  title=\"Task status\"\n/>"
+          },
+          {
+            "title": "Percentage tooltip + empty state",
+            "code": "import { PieChart } from '@cascivo/charts'\n\n// Default tooltip shows \"value (pct%)\" in the slice color; pass tooltipFormat to override.\n<PieChart data={[{id:'a',label:'A',value:60},{id:'b',label:'B',value:40}]} title=\"Share\" />\n\n// Empty data renders a visible \"No data\" placeholder (override via emptyLabel).\n<PieChart data={[]} title=\"Share\" emptyLabel=\"Nothing tracked yet\" />"
           }
         ],
         "dependencies": ["@cascivo/charts"],
@@ -19326,6 +19565,43 @@
             "required": false,
             "description": "Accessible label (defaults to the i18n \"Code editor\")"
           },
+          {
+            "name": "onSave",
+            "type": "(value: string) => void",
+            "required": false,
+            "description": "Called on Mod-S; the browser save dialog is suppressed"
+          },
+          {
+            "name": "bracketMatching",
+            "type": "boolean",
+            "required": false,
+            "default": "false",
+            "description": "Highlight the bracket matching the one adjacent to the caret"
+          },
+          {
+            "name": "theme",
+            "type": "EditorTheme",
+            "required": false,
+            "description": "Per-instance --cascivo-editor-* overrides; swapping it re-themes live"
+          },
+          {
+            "name": "keymap",
+            "type": "KeyMap",
+            "required": false,
+            "description": "Extra key bindings merged over the built-ins (user wins on a chord)"
+          },
+          {
+            "name": "decorations",
+            "type": "Decoration[] | ((value: string) => Decoration[])",
+            "required": false,
+            "description": "Extra offset-range → CSS class decorations"
+          },
+          {
+            "name": "ref",
+            "type": "Ref<CodeEditorHandle>",
+            "required": false,
+            "description": "Imperative handle: applyEdit / getSelection / focus / undo / redo / openFind"
+          },
           {
             "name": "className",
             "type": "string",
@@ -19337,14 +19613,26 @@
           "--cascivo-editor-fg",
           "--cascivo-editor-gutter-bg",
           "--cascivo-editor-gutter-fg",
+          "--cascivo-editor-gutter-active",
           "--cascivo-editor-current-line",
           "--cascivo-editor-selection",
-          "--cascivo-editor-border"
+          "--cascivo-editor-border",
+          "--cascivo-editor-match",
+          "--cascivo-editor-match-current",
+          "--cascivo-editor-bracket"
         ],
         "accessibility": {
           "role": "textbox",
           "wcag": "2.1-AA",
-          "keyboard": ["Tab (indent)", "Shift+Tab (dedent)", "Standard textarea editing"],
+          "keyboard": [
+            "Tab (indent)",
+            "Shift+Tab (dedent)",
+            "Mod+Z / Mod+Shift+Z (undo / redo)",
+            "Mod+F (find)",
+            "Mod+Alt+F (replace)",
+            "Mod+S (save)",
+            "Standard textarea editing"
+          ],
           "reducedMotion": true,
           "forcedColors": true
         },
@@ -19356,6 +19644,10 @@
           {
             "title": "Controlled",
             "code": "<CodeEditor language=\"json\" value={value} onValueChange={setValue} />"
+          },
+          {
+            "title": "Notes editing — find, save, brackets",
+            "code": "<CodeEditor\n  language=\"markdown\"\n  value={doc}\n  onValueChange={setDoc}\n  onSave={save} // Mod-S\n  bracketMatching\n/> // Mod-F to search"
           }
         ],
         "dependencies": ["@cascivo/core", "@cascivo/i18n"],
@@ -19363,11 +19655,15 @@
         "intent": {
           "whenToUse": [
             "Editing code or config inline — JSON, snippets, web languages — with line numbers and syntax colors",
-            "A lightweight, themeable code field where a full IDE editor (Monaco/CodeMirror) would be overkill"
+            "A lightweight, themeable code field where a full IDE editor (Monaco/CodeMirror) would be overkill",
+            "Editing Markdown notes — find/replace, real undo/redo, save, and selection-preserving external sync",
+            "Editing long-form Markdown — generated docs, concatenated books, big notes — windowed (viewport-scoped) tokenization keeps scrolling/typing smooth well past ~5,000 lines"
           ],
           "whenNotToUse": [
             "You need IntelliSense/LSP, multi-cursor, folding, a minimap, or diff view — use a full editor framework",
-            "Plain prose or a single-line value — use Textarea or Input"
+            "Plain prose or a single-line value — use Textarea or Input",
+            "Sustained editing of 100k+-line documents — use a full editor framework / dedicated worker pipeline (the windowed tokenizer keeps per-render work O(viewport), but a worker offload is intentionally out of scope)",
+            "Soft-wrap (wrap) on a very large document — rendering is O(n) under wrap; disable wrap above ~10k lines for sustained editing"
           ],
           "antiPatterns": [
             {
@@ -19394,6 +19690,11 @@
               "area": "languages",
               "level": "flexible",
               "note": "Ships a small grammar set; registerGrammar adds custom languages without bundle bloat"
+            },
+            {
+              "area": "large documents",
+              "level": "flexible",
+              "note": "Windowed tokenization (tokenizeRange + LineStateIndex) makes per-render work O(viewport) and per-edit work O(changed suffix); long Markdown edits well past ~5,000 lines. Worker offload / 100k+-line sustained editing stay out of scope"
             }
           ]
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cascivo/mcp",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "private": false,
   "description": "MCP server exposing the cascivo component registry to AI agents",
   "keywords": [