@svgrid/mcp 3.0.0 → 3.0.2

package/LICENSE

@@ -1,40 +1,40 @@
-MIT License
-
-Copyright (c) 2026 jQWidgets Ltd
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
-------------------------------------------------------------------------
-
-NOTE ON BUNDLED CONTENT
-
-This package embeds SvGrid documentation, API reference, and example sources
-so the server can answer questions offline. That material is Copyright (c)
-2026 jQWidgets Ltd and is also published openly at https://svgrid.com/docs/,
-https://svgrid.com/llms.txt and https://svgrid.com/llms-full.txt for exactly
-this purpose. The MIT grant above covers it.
-
-SvGrid(TM) and sv-grid(TM) are trademarks of jQWidgets Ltd. This license
-covers the source code and bundled content only; it grants no rights to the
-SvGrid / sv-grid names or logos.
-
-Some tools exposed by this server generate SvGrid Studio projects. Studio
-itself is a commercial product (https://svgrid.com/pricing) and needs a
-license key to use in production, but this server, and asking it questions,
-are free.
+MIT License
+
+Copyright (c) 2026 jQWidgets Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+------------------------------------------------------------------------
+
+NOTE ON BUNDLED CONTENT
+
+This package embeds SvGrid documentation, API reference, and example sources
+so the server can answer questions offline. That material is Copyright (c)
+2026 jQWidgets Ltd and is also published openly at https://svgrid.com/docs/,
+https://svgrid.com/llms.txt and https://svgrid.com/llms-full.txt for exactly
+this purpose. The MIT grant above covers it.
+
+SvGrid(TM) and sv-grid(TM) are trademarks of jQWidgets Ltd. This license
+covers the source code and bundled content only; it grants no rights to the
+SvGrid / sv-grid names or logos.
+
+Some tools exposed by this server generate SvGrid Studio projects. Studio
+itself is a commercial product (https://svgrid.com/pricing) and needs a
+license key to use in production, but this server, and asking it questions,
+are free.

package/README.md

@@ -32,7 +32,7 @@ tools, 79% of them Studio tools most sessions never call once.
 
 | Tool | Purpose |
 | --- | --- |
-| `svgrid_search` | Search the docs, all 375 demos and the API surface **in one call**. No arguments returns an index. |
+| `svgrid_search` | Search the docs, all 400+ demos and the API surface **in one call**. No arguments returns an index. |
 | `svgrid_get` | Read one thing in full: a doc slug, a demo id, or `api`. |
 | `svgrid_check_code` | **Verify** a file against the real API surface + the Svelte compiler. |
 | `svgrid_scaffold` | Studio: turn a Drizzle schema, sample rows or an `EntitySchema` into runnable SvelteKit files. |
@@ -90,7 +90,7 @@ What it checks:
   "no errors" is never mistaken for "this compiles".
 
 It is tuned to shut up when the code is right: it reports **nothing** across all
-375 demos in this repo, which is what a CI test asserts. A verifier that cries
+400+ demos in this repo, which is what a CI test asserts. A verifier that cries
 wolf is worse than none, because a model will happily "fix" working code.
 
 ### Studio: drive the app model (agent co-designer)

package/dist/core-tools.d.ts

@@ -53,11 +53,11 @@ export declare const CORE_TOOLS: readonly [{
         readonly properties: {
             readonly ref: {
                 readonly type: "string";
-                readonly description: "A doc slug, a demo id, or \"api\". The kind is inferred; pass `kind` to force it.";
+                readonly description: "A doc slug, a demo id, \"api\", or a schema id such as \"chart-spec\" (or \"chart spec schema\"). The kind is inferred; pass `kind` to force it.";
             };
             readonly kind: {
                 readonly type: "string";
-                readonly enum: readonly ["auto", "doc", "example", "api"];
+                readonly enum: readonly ["auto", "doc", "example", "api", "schema"];
                 readonly description: "Override the inferred kind. Default \"auto\".";
                 readonly default: "auto";
             };

package/dist/core-tools.js

@@ -13,7 +13,7 @@
  * response is capped and paged, because returning all 375 examples cost ~31k
  * tokens on the call the old description invited a model to start with.
  */
-import { apiReference, apiSurface, docs, examples } from './data.js';
+import { apiReference, apiSurface, docs, examples, schemas } from './data.js';
 import { meaningfulTerms, rankDocs } from './search.js';
 const DOCS_FOOTER = '\n\nSvGrid reference: full docs & 375 live demos at https://svgrid.com/docs';
 const text = (body) => ({ content: [{ type: 'text', text: body }] });
@@ -107,11 +107,11 @@ export const CORE_TOOLS = [
             properties: {
                 ref: {
                     type: 'string',
-                    description: 'A doc slug, a demo id, or "api". The kind is inferred; pass `kind` to force it.',
+                    description: 'A doc slug, a demo id, "api", or a schema id such as "chart-spec" (or "chart spec schema"). The kind is inferred; pass `kind` to force it.',
                 },
                 kind: {
                     type: 'string',
-                    enum: ['auto', 'doc', 'example', 'api'],
+                    enum: ['auto', 'doc', 'example', 'api', 'schema'],
                     description: 'Override the inferred kind. Default "auto".',
                     default: 'auto',
                 },
@@ -340,6 +340,16 @@ function get(args) {
         }
         return withDocs(json(apiReference));
     }
+    // A JSON schema by id ("chart-spec"), or by asking for "the chart spec
+    // schema" in words: every schema id's words must appear in the request.
+    if (kind === 'schema' || (kind === 'auto' && /schema/i.test(ref))) {
+        const words = ref.toLowerCase().replace(/schema/g, ' ').split(/[^a-z0-9]+/).filter(Boolean);
+        const hit = schemas.find((s) => s.id === ref) ?? schemas.find((s) => s.id.split('-').every((w) => words.includes(w)));
+        if (hit)
+            return text(clip(hit.json));
+        if (kind === 'schema')
+            return fail(`No schema "${ref}". Available: ${schemas.map((s) => s.id).join(', ')}.`);
+    }
     if (kind === 'doc' || kind === 'auto') {
         const doc = docs.find((d) => d.slug === ref);
         if (doc)

package/dist/data.d.ts

@@ -29,3 +29,9 @@ export declare const apiReference: {
     readonly utilities: readonly ["getKeyboardIntent", "getNextActiveCell", "parseEditorValue", "applyExcelFilter", "formatNumericWithConfig", "resolveDatePattern"];
 };
 export declare const apiSurface: ApiSurface;
+/** The JSON schemas under https://svgrid.com/schemas/, by id. */
+export declare const schemas: ReadonlyArray<{
+    id: string;
+    describes: string;
+    json: string;
+}>;