@svgrid/mcp 3.0.1 → 3.0.3

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  * SvGrid MCP server (stdio).
  *
  * Gives an MCP-capable client accurate, version-pinned answers about SvGrid -
- * the real exported API, the shipped docs, 375 runnable demos - and, uniquely,
+ * the real exported API, the shipped docs, 400+ runnable demos - and, uniquely,
  * a way to CHECK generated code against that surface before a user ever sees
  * it.
  *

package/dist/index.js

@@ -3,7 +3,7 @@
  * SvGrid MCP server (stdio).
  *
  * Gives an MCP-capable client accurate, version-pinned answers about SvGrid -
- * the real exported API, the shipped docs, 375 runnable demos - and, uniquely,
+ * the real exported API, the shipped docs, 400+ runnable demos - and, uniquely,
  * a way to CHECK generated code against that surface before a user ever sees
  * it.
  *

package/dist/preview.d.ts

@@ -8,7 +8,7 @@ export declare const UI_RESOURCE_URI = "ui://svgrid/preview.html";
  * start failing in a way nobody is watching for. `tools/mcp-tools.test.ts` checks these
  * against the workspace so they cannot quietly rot either.
  */
-export declare const PREVIEW_GRID_WC_VERSION = "3.0.0";
+export declare const PREVIEW_GRID_WC_VERSION = "3.0.3";
 export declare function previewResource(): {
     uri: string;
     name: string;

package/dist/preview.js

@@ -27,7 +27,7 @@ const UI_RESOURCE_META_KEY = 'ui/resourceUri';
  * start failing in a way nobody is watching for. `tools/mcp-tools.test.ts` checks these
  * against the workspace so they cannot quietly rot either.
  */
-export const PREVIEW_GRID_WC_VERSION = '3.0.0';
+export const PREVIEW_GRID_WC_VERSION = '3.0.3';
 const EXT_APPS_VERSION = '1.7.5';
 const CDN = 'https://cdn.jsdelivr.net/npm';
 /**

package/dist/prompts.js

@@ -7,6 +7,14 @@ export const PROMPTS = [
             { name: 'description', description: 'The data and behaviour you want, in plain language.', required: true },
         ],
     },
+    {
+        name: 'build_sheet',
+        title: 'Build a spreadsheet',
+        description: 'Scaffold an Excel-style spreadsheet on the SvSheet shell (@svgrid/enterprise) for a described workbook: sheets, formulas, formats, rules, protection.',
+        arguments: [
+            { name: 'description', description: 'The sheets, the cells and formulas, and what the user may do, in plain language.', required: true },
+        ],
+    },
     {
         name: 'explain_api',
         title: 'Explain a SvGrid API',
@@ -41,6 +49,28 @@ export function getPrompt(name, args) {
                 'and touch the grid rather than just read it.'),
         };
     }
+    if (name === 'build_sheet') {
+        return {
+            description: 'Build a verified spreadsheet on SvSheet',
+            ...messages(`Build a spreadsheet on the SvSheet shell for: ${arg('description')}\n\n` +
+                'SvSheet is in `@svgrid/enterprise`, a component that owns a workbook and a document; ' +
+                'confirm the package is installed before importing it. Work in this order:\n' +
+                '1. Call `svgrid_search` for "spreadsheet shell" and for each part this needs ' +
+                '(formulas, data validation, conditional formatting, comments, protection, xlsx). ' +
+                'Do not rely on memory of the API.\n' +
+                '2. Call `svgrid_get` on the closest spreadsheet demo (ids 452 to 466 and 484 to 494) and follow ' +
+                'its structure: `createWorkbook` for the cells as raw text with formulas as `=...` strings, ' +
+                '`createSheetDocument` for everything that is not a cell, `<SvSheet document={doc}>`.\n' +
+                '3. Write the component. Rectangles are `[minRow, minCol, maxRow, maxCol]`, 0-based; ' +
+                'a write from outside goes through `cmd.setCellValue` in `onAction` or is followed by ' +
+                '`refresh()`; addresses in `formats` for another sheet are qualified (`Orders!F2`).\n' +
+                '4. Call `svgrid_check_code` on what you wrote and use the `fixed` source it returns, ' +
+                'repeating until it is clean, BEFORE showing me the code.\n' +
+                '5. Say which formulas the engine evaluates and which it does not, from the search ' +
+                'results rather than from memory: the library is Excel-shaped but not complete, and ' +
+                'dynamic arrays spill while the spill operator (`D2#`) and array constants do not parse.'),
+        };
+    }
     if (name === 'explain_api') {
         return {
             description: 'Explain a SvGrid API from the shipped docs',

package/dist/validate.d.ts

@@ -64,6 +64,15 @@ export type ApiSurface = {
     };
     readonly props: readonly TypeMember[];
     readonly columnDef: readonly TypeMember[];
+    /** The chart spec's vocabulary; absent on a surface built before it existed. */
+    readonly chartSpec?: {
+        readonly keys: readonly string[];
+        readonly seriesKeys: readonly string[];
+        readonly types: readonly string[];
+        readonly seriesTypes: readonly string[];
+        readonly overlays: readonly string[];
+        readonly overlayPatterns: readonly string[];
+    };
     /** Methods on the free `SvGridApi`. */
     readonly apiMethods: readonly string[];
     /** Methods `installEnterprise(api)` adds on top. */

package/dist/validate.js

@@ -194,7 +194,7 @@ const PROP_RENAMES = {
 };
 const PROP_RENAME_NOTES = {
     defaultColDef: 'SvGrid has no shared column default; set the key on each column, or map over your columns to add it.',
-    rowModelType: 'SvGrid always renders from `data`. For server-side paging/sorting, build the rows with `createServerDataSource` and feed its result into `data`.',
+    rowModelType: 'SvGrid has no row-model switch. Build the rows with `createServerDataSource` and pass the controller as `rowModel` - add `mode: "infinite"` for block-loaded scrolling. Server-side grouping, tree data, pivot, transactions and selection across unloaded rows are `createServerRowModel` in @svgrid/enterprise, on the same contract and the same prop.',
     theme: 'Themes are stylesheets, not a prop: import one, e.g. `import "@svgrid/grid/themes/shadcn.css"`.',
 };
 const COLUMN_RENAMES = {
@@ -1006,6 +1006,251 @@ export function applyFixes(source, diagnostics) {
 function escapeRegExp(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
+/**
+ * Parse an object literal the way a spec is usually written by hand: quoted
+ * or bare keys, single or double quotes, trailing commas, numbers, booleans,
+ * null, nested objects and arrays. Anything else (an identifier, a call, a
+ * template literal, a spread, an arrow, a comment) means the value is not
+ * static, and the whole literal is left alone: the check is only ever run on
+ * what can be read completely, so it never guesses.
+ */
+function parseStaticLiteral(src, start) {
+    let i = start;
+    const keyOffsets = new Map();
+    const fail = () => { throw new Error('not static'); };
+    const ws = () => { while (i < src.length && /\s/.test(src[i]))
+        i++; };
+    const value = (path) => {
+        ws();
+        const c = src[i];
+        if (c === '{')
+            return object(path);
+        if (c === '[')
+            return array(path);
+        if (c === '"' || c === "'")
+            return string();
+        if (c === '-' || (c >= '0' && c <= '9'))
+            return number();
+        if (src.startsWith('true', i)) {
+            i += 4;
+            return true;
+        }
+        if (src.startsWith('false', i)) {
+            i += 5;
+            return false;
+        }
+        if (src.startsWith('null', i)) {
+            i += 4;
+            return null;
+        }
+        return fail();
+    };
+    const string = () => {
+        const q = src[i];
+        let j = i + 1;
+        let out = '';
+        while (j < src.length && src[j] !== q) {
+            if (src[j] === '\\') {
+                out += src[j + 1];
+                j += 2;
+                continue;
+            }
+            if (src[j] === '\n')
+                fail();
+            out += src[j];
+            j++;
+        }
+        if (src[j] !== q)
+            fail();
+        i = j + 1;
+        return out;
+    };
+    const number = () => {
+        const m = /^-?\d+(?:\.\d+)?(?:e[+-]?\d+)?/i.exec(src.slice(i, i + 40));
+        if (!m)
+            fail();
+        i += m[0].length;
+        return Number(m[0]);
+    };
+    const array = (path) => {
+        i++;
+        const out = [];
+        for (;;) {
+            ws();
+            if (src[i] === ']') {
+                i++;
+                return out;
+            }
+            out.push(value(`${path}[${out.length}]`));
+            ws();
+            if (src[i] === ',') {
+                i++;
+                continue;
+            }
+            if (src[i] === ']') {
+                i++;
+                return out;
+            }
+            fail();
+        }
+    };
+    const object = (path) => {
+        i++;
+        const out = {};
+        for (;;) {
+            ws();
+            if (src[i] === '}') {
+                i++;
+                return out;
+            }
+            const keyAt = i;
+            let key;
+            if (src[i] === '"' || src[i] === "'")
+                key = string();
+            else {
+                const m = /^[A-Za-z_$][\w$]*/.exec(src.slice(i, i + 80));
+                if (!m)
+                    fail();
+                key = m[0];
+                i += key.length;
+            }
+            ws();
+            if (src[i] !== ':')
+                fail();
+            i++;
+            const p = path ? `${path}.${key}` : key;
+            keyOffsets.set(p, keyAt);
+            out[key] = value(p);
+            ws();
+            if (src[i] === ',') {
+                i++;
+                continue;
+            }
+            if (src[i] === '}') {
+                i++;
+                return out;
+            }
+            fail();
+        }
+    };
+    try {
+        return { value: object(''), keyOffsets };
+    }
+    catch {
+        return null;
+    }
+}
+/** The offset of the `{` that closes back onto `}` at `close`, or -1. */
+function openingBrace(src, close) {
+    let depth = 0;
+    for (let i = close; i >= 0; i--) {
+        if (src[i] === '}')
+            depth++;
+        else if (src[i] === '{') {
+            depth--;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
+/**
+ * Chart specs written as static literals: a `ChartSpec`-typed const, a
+ * `satisfies ChartSpec` expression, or `spec={{ ... }}` on a chart tag.
+ * Only a literal the parser reads completely is checked; one with a variable
+ * or a call in it is skipped, so a finding is never a guess.
+ */
+function checkChartSpecs(ctx) {
+    const vocab = ctx.surface.chartSpec;
+    if (!vocab)
+        return;
+    const raw = ctx.raw;
+    const starts = [];
+    for (const m of raw.matchAll(/:\s*ChartSpec\s*=\s*\{/g))
+        starts.push(m.index + m[0].length - 1);
+    for (const m of raw.matchAll(/\}\s*satisfies\s+ChartSpec\b/g)) {
+        const open = openingBrace(raw, m.index);
+        if (open >= 0)
+            starts.push(open);
+    }
+    for (const m of raw.matchAll(/<(?:SvChart|SvGridChart)\b[^>]*?\sspec=\{\{/g))
+        starts.push(m.index + m[0].length - 1);
+    const seen = new Set();
+    for (const start of starts) {
+        if (seen.has(start))
+            continue;
+        seen.add(start);
+        const lit = parseStaticLiteral(raw, start);
+        if (!lit || typeof lit.value !== 'object' || lit.value === null)
+            continue;
+        const spec = lit.value;
+        const lineOf = (path) => lineAt(raw, lit.keyOffsets.get(path) ?? start);
+        const see = 'help/charts/api';
+        for (const key of Object.keys(spec)) {
+            if (vocab.keys.includes(key))
+                continue;
+            const guess = nearest(key, vocab.keys);
+            push(ctx, {
+                rule: 'svgrid/chart-unknown-key',
+                severity: 'warning',
+                line: lineOf(key),
+                message: guess ? `ChartSpec has no field "${key}"; did you mean "${guess}"?` : `ChartSpec has no field "${key}"; it is ignored`,
+                ...(guess ? { fix: `rename "${key}" to "${guess}"`, rename: { from: key, to: guess } } : {}),
+                see,
+            });
+        }
+        const type = spec.type;
+        if (typeof type === 'string' && !vocab.types.includes(type)) {
+            const guess = nearest(type, vocab.types);
+            push(ctx, {
+                rule: 'svgrid/chart-unknown-type',
+                severity: 'error',
+                line: lineOf('type'),
+                message: guess ? `"${type}" is not a chart type; did you mean "${guess}"?` : `"${type}" is not a chart type`,
+                ...(guess ? { fix: `use type: '${guess}'`, rename: { from: type, to: guess } } : {}),
+                see,
+            });
+        }
+        const categories = Array.isArray(spec.categories) ? spec.categories : null;
+        const freeLength = typeof type === 'string' && ['scatter', 'gauge', 'treemap', 'sankey', 'calendar', 'sunburst', 'chord', 'histogram'].includes(type);
+        if (Array.isArray(spec.series)) {
+            spec.series.forEach((s, i) => {
+                if (typeof s !== 'object' || s === null || Array.isArray(s))
+                    return;
+                const sr = s;
+                const p = `series[${i}]`;
+                for (const key of Object.keys(sr)) {
+                    if (vocab.seriesKeys.includes(key))
+                        continue;
+                    const guess = nearest(key, vocab.seriesKeys);
+                    push(ctx, {
+                        rule: 'svgrid/chart-unknown-series-key',
+                        severity: 'warning',
+                        line: lineOf(`${p}.${key}`),
+                        message: guess ? `a chart series has no field "${key}"; did you mean "${guess}"?` : `a chart series has no field "${key}"; it is ignored`,
+                        ...(guess ? { fix: `rename "${key}" to "${guess}"`, rename: { from: key, to: guess } } : {}),
+                        see,
+                    });
+                }
+                if (categories && !freeLength && Array.isArray(sr.values) && sr.values.length !== categories.length && !(Array.isArray(sr.points) && sr.values.length === 0)) {
+                    push(ctx, {
+                        rule: 'svgrid/chart-series-length',
+                        severity: 'error',
+                        line: lineOf(`${p}.values`),
+                        message: `series "${String(sr.label ?? i)}" has ${sr.values.length} values for ${categories.length} categories; they run in parallel`,
+                        see,
+                    });
+                }
+                if (sr.axis !== undefined && sr.axis !== 'left' && sr.axis !== 'right') {
+                    push(ctx, { rule: 'svgrid/chart-axis', severity: 'error', line: lineOf(`${p}.axis`), message: `a series axis is 'left' or 'right', not "${String(sr.axis)}"`, see });
+                }
+                if (typeof sr.overlay === 'string' && !vocab.overlays.includes(sr.overlay) && !vocab.overlayPatterns.some((re) => new RegExp(re).test(sr.overlay))) {
+                    push(ctx, { rule: 'svgrid/chart-overlay', severity: 'error', line: lineOf(`${p}.overlay`), message: `"${sr.overlay}" is not an overlay; expected ${vocab.overlays.join(', ')} or one of ${vocab.overlayPatterns.map((r) => r.replace(/^\^|\$/g, '').replace(/\\d\+\(\?:\\\.\\d\+\)\?/g, 'N')).join(', ')}`, see });
+                }
+            });
+        }
+    }
+}
 export function checkStatic(source, surface, filename = 'Component.svelte') {
     const ctx = {
         raw: source,
@@ -1025,6 +1270,7 @@ export function checkStatic(source, surface, filename = 'Component.svelte') {
     checkKnownTraps(ctx);
     checkEnterpriseUsage(ctx);
     checkFeatures(ctx);
+    checkChartSpecs(ctx);
     const rank = { error: 0, warning: 1, info: 2 };
     const unique = new Map();
     for (const d of ctx.out)

package/package.json

@@ -5,7 +5,7 @@
     "type": "commercial",
     "url": "https://svgrid.com/pricing"
   },
-  "version": "3.0.1",
+  "version": "3.0.3",
   "description": "Model Context Protocol server for SvGrid, the Svelte 5 data grid: checks the code your AI writes against the real API surface, plus version-pinned docs, API reference and 373 demo sources.",
   "license": "MIT",
   "author": "jQWidgets <sales@jqwidgets.com>",
@@ -33,7 +33,7 @@
     "@modelcontextprotocol/sdk": "^1.0.4",
     "svelte": "^5.55.5",
     "zod": "^3.23.8",
-    "@svgrid/enterprise": "^3.0.0"
+    "@svgrid/enterprise": "^3.0.3"
   },
   "devDependencies": {
     "@types/node": "^22.10.7",

package/server.json

@@ -3,7 +3,7 @@
   "name": "com.svgrid/svgrid",
   "title": "SvGrid",
   "description": "Checks AI-written SvGrid code against the real API, plus version-pinned Svelte 5 grid docs.",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "websiteUrl": "https://svgrid.com/docs/help/mcp-server/",
   "repository": {
     "url": "https://github.com/sv-grid/sv-grid",
@@ -15,7 +15,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@svgrid/mcp",
-      "version": "3.0.1",
+      "version": "3.0.3",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"