npm - @blueprint-chart/mcp - Versions diffs - 0.1.0 - Mend

@blueprint-chart/mcp 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (75) hide show

package/LICENSE +21 -0
package/README.md +240 -0
package/bin/blueprint-chart-mcp.js +15 -0
package/bin/loader.mjs +36 -0
package/dist/cli.d.ts +1 -0
package/dist/cli.js +123 -0
package/dist/errors.d.ts +28 -0
package/dist/errors.js +16 -0
package/dist/errors.test.d.ts +1 -0
package/dist/errors.test.js +23 -0
package/dist/lib/zodToJsonSchema.d.ts +8 -0
package/dist/lib/zodToJsonSchema.js +9 -0
package/dist/parse.d.ts +5 -0
package/dist/parse.js +25 -0
package/dist/parse.test.d.ts +1 -0
package/dist/parse.test.js +29 -0
package/dist/prompts/authorChart.d.ts +12 -0
package/dist/prompts/authorChart.js +35 -0
package/dist/prompts/authorChart.test.d.ts +1 -0
package/dist/prompts/authorChart.test.js +13 -0
package/dist/render/jsdomEnv.d.ts +12 -0
package/dist/render/jsdomEnv.js +28 -0
package/dist/render/jsdomEnv.test.d.ts +1 -0
package/dist/render/jsdomEnv.test.js +22 -0
package/dist/render/rasterize.d.ts +5 -0
package/dist/render/rasterize.js +14 -0
package/dist/render/rasterize.test.d.ts +1 -0
package/dist/render/rasterize.test.js +24 -0
package/dist/render/renderSceneState.d.ts +21 -0
package/dist/render/renderSceneState.js +71 -0
package/dist/render/renderSceneState.test.d.ts +1 -0
package/dist/render/renderSceneState.test.js +18 -0
package/dist/render/textShim.d.ts +12 -0
package/dist/render/textShim.js +78 -0
package/dist/render/textShim.test.d.ts +1 -0
package/dist/render/textShim.test.js +31 -0
package/dist/resources/docsReader.d.ts +14 -0
package/dist/resources/docsReader.js +50 -0
package/dist/resources/docsReader.test.d.ts +1 -0
package/dist/resources/docsReader.test.js +24 -0
package/dist/resources/index.d.ts +6 -0
package/dist/resources/index.js +11 -0
package/dist/resources/samples.d.ts +13 -0
package/dist/resources/samples.js +21 -0
package/dist/resources/samples.test.d.ts +1 -0
package/dist/resources/samples.test.js +18 -0
package/dist/server.d.ts +2 -0
package/dist/server.js +86 -0
package/dist/server.test.d.ts +1 -0
package/dist/server.test.js +68 -0
package/dist/smoke.test.d.ts +1 -0
package/dist/smoke.test.js +11 -0
package/dist/tools/inspect.d.ts +26 -0
package/dist/tools/inspect.js +37 -0
package/dist/tools/inspect.test.d.ts +1 -0
package/dist/tools/inspect.test.js +29 -0
package/dist/tools/recommend.d.ts +21 -0
package/dist/tools/recommend.js +17 -0
package/dist/tools/recommend.test.d.ts +1 -0
package/dist/tools/recommend.test.js +33 -0
package/dist/tools/render.d.ts +35 -0
package/dist/tools/render.js +63 -0
package/dist/tools/render.test.d.ts +1 -0
package/dist/tools/render.test.js +39 -0
package/dist/tools/validate.d.ts +13 -0
package/dist/tools/validate.js +13 -0
package/dist/tools/validate.test.d.ts +1 -0
package/dist/tools/validate.test.js +27 -0
package/dist/transports/http.d.ts +21 -0
package/dist/transports/http.js +193 -0
package/dist/transports/http.test.d.ts +1 -0
package/dist/transports/http.test.js +85 -0
package/dist/transports/stdio.d.ts +1 -0
package/dist/transports/stdio.js +7 -0
package/package.json +70 -0

package/dist/render/jsdomEnv.d.ts ADDED Viewed

@@ -0,0 +1,12 @@
+import { type DOMWindow } from 'jsdom';
+export interface JsdomEnv {
+    window: DOMWindow;
+    container: HTMLElement;
+    serialize: () => string;
+    cleanup: () => void;
+}
+export interface JsdomEnvOptions {
+    width: number;
+    height: number;
+}
+export declare function createJsdomEnv(opts: JsdomEnvOptions): JsdomEnv;

package/dist/render/jsdomEnv.js ADDED Viewed

@@ -0,0 +1,28 @@
+import { JSDOM, VirtualConsole } from 'jsdom';
+// @blueprint-chart/lib internally calls `canvas.getContext('2d')` for text
+// measurement before falling back to declared widths. jsdom logs that as a
+// "Not implemented" error to stderr even though the lib handles the null
+// return gracefully. Drop just those messages; forward anything else.
+function createQuietVirtualConsole() {
+    const vc = new VirtualConsole();
+    vc.on('jsdomError', (err) => {
+        if (err.message && err.message.startsWith('Not implemented')) {
+            return;
+        }
+        console.error(err);
+    });
+    return vc;
+}
+export function createJsdomEnv(opts) {
+    const dom = new JSDOM(`<!DOCTYPE html><html><body><div id="root" style="width:${opts.width}px;height:${opts.height}px"></div></body></html>`, { pretendToBeVisual: true, virtualConsole: createQuietVirtualConsole() });
+    const container = dom.window.document.getElementById('root');
+    return {
+        window: dom.window,
+        container,
+        serialize: () => {
+            const svg = container.querySelector('svg');
+            return svg ? svg.outerHTML : '';
+        },
+        cleanup: () => dom.window.close(),
+    };
+}

package/dist/render/jsdomEnv.test.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/dist/render/jsdomEnv.test.js ADDED Viewed

@@ -0,0 +1,22 @@
+import { describe, expect, it } from 'vitest';
+import { createJsdomEnv } from './jsdomEnv';
+describe('createJsdomEnv', () => {
+    it('returns a document with an SVG element appended', () => {
+        const env = createJsdomEnv({ width: 600, height: 400 });
+        expect(env.container.tagName).toBe('DIV');
+        expect(env.container.ownerDocument).toBeDefined();
+        expect(env.window.SVGElement).toBeDefined();
+    });
+    it('exposes a serialize() that returns SVG markup', () => {
+        const env = createJsdomEnv({ width: 600, height: 400 });
+        const svg = env.window.document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+        svg.setAttribute('viewBox', '0 0 100 100');
+        env.container.appendChild(svg);
+        expect(env.serialize()).toMatch(/<svg[^>]*viewBox="0 0 100 100"/);
+    });
+    it('cleanup() closes the window', () => {
+        const env = createJsdomEnv({ width: 100, height: 100 });
+        env.cleanup();
+        expect(() => env.window.document.createElement('div')).toThrow();
+    });
+});

package/dist/render/rasterize.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+export interface RasterizeOptions {
+    width?: number;
+    height?: number;
+}
+export declare function rasterizeToPng(svg: string, opts?: RasterizeOptions): Promise<Buffer>;

package/dist/render/rasterize.js ADDED Viewed

@@ -0,0 +1,14 @@
+import { Resvg } from '@resvg/resvg-js';
+export async function rasterizeToPng(svg, opts = {}) {
+    const fitTo = opts.width
+        ? { mode: 'width', value: opts.width }
+        : opts.height
+            ? { mode: 'height', value: opts.height }
+            : { mode: 'original' };
+    const resvg = new Resvg(svg, {
+        fitTo,
+        font: { loadSystemFonts: true },
+    });
+    const image = resvg.render();
+    return Buffer.from(image.asPng());
+}

package/dist/render/rasterize.test.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/dist/render/rasterize.test.js ADDED Viewed

@@ -0,0 +1,24 @@
+import { describe, expect, it } from 'vitest';
+import { rasterizeToPng } from './rasterize';
+const SVG = `<svg xmlns="http://www.w3.org/2000/svg" width="100" height="50">
+  <rect width="100" height="50" fill="red"/>
+  <text x="10" y="30" font-size="14" font-family="sans-serif">Hi</text>
+</svg>`;
+describe('rasterizeToPng', () => {
+    it('returns a PNG buffer for a valid SVG', async () => {
+        const buf = await rasterizeToPng(SVG);
+        expect(buf.length).toBeGreaterThan(100);
+        // PNG file signature
+        expect(buf[0]).toBe(0x89);
+        expect(buf[1]).toBe(0x50);
+        expect(buf[2]).toBe(0x4e);
+        expect(buf[3]).toBe(0x47);
+    });
+    it('throws on invalid SVG', async () => {
+        await expect(rasterizeToPng('not svg at all')).rejects.toThrow();
+    });
+    it('honors width override', async () => {
+        const buf = await rasterizeToPng(SVG, { width: 200 });
+        expect(buf.length).toBeGreaterThan(100);
+    });
+});

package/dist/render/renderSceneState.d.ts ADDED Viewed

@@ -0,0 +1,21 @@
+export interface RenderSceneStateOptions {
+    sceneIndex?: number;
+    width: number;
+    height: number;
+    theme?: string;
+}
+/**
+ * Render a `.bpc` source string to SVG markup in a headless jsdom environment.
+ *
+ * Composition:
+ *  - `createJsdomEnv` provisions a window + container + serialize/cleanup hooks.
+ *  - `installTextShim` patches `window.SVGElement.prototype` so D3 layout
+ *    primitives (axes, legends, annotations) read realistic text widths from
+ *    `@napi-rs/canvas` instead of jsdom's zero defaults.
+ *  - `renderBpc` from `@blueprint-chart/lib` parses the source, resolves the
+ *    requested scene, and mounts SVG into the container via D3.
+ *
+ * Throws when `renderBpc` cannot produce SVG output (invalid source, etc.) —
+ * callers (the `render` tool) catch and translate to a structured ToolResult.
+ */
+export declare function renderSceneState(source: string, opts: RenderSceneStateOptions): string;

package/dist/render/renderSceneState.js ADDED Viewed

@@ -0,0 +1,71 @@
+import { renderBpc } from '@blueprint-chart/lib';
+import { createJsdomEnv } from './jsdomEnv';
+import { installTextShim } from './textShim';
+/**
+ * Globals that `@blueprint-chart/lib` (and the D3 code it bundles) reads at
+ * call time. Verified against `node_modules/@blueprint-chart/lib/dist/index.js`
+ * via:
+ *
+ *   grep -oE '\b(Element|getComputedStyle|requestAnimationFrame|window|document)\b' \
+ *     node_modules/@blueprint-chart/lib/dist/index.js | sort -u
+ *
+ * The lib bundle has no top-level uses of these names — they are only invoked
+ * inside functions reached from `renderBpc` — so swapping the globals around
+ * the call and restoring them in `finally` is sufficient. No module-load
+ * `globals.ts` shim is required.
+ */
+const FORWARDED_GLOBALS = [
+    'window',
+    'document',
+    'Element',
+    'getComputedStyle',
+    'requestAnimationFrame',
+];
+/**
+ * Render a `.bpc` source string to SVG markup in a headless jsdom environment.
+ *
+ * Composition:
+ *  - `createJsdomEnv` provisions a window + container + serialize/cleanup hooks.
+ *  - `installTextShim` patches `window.SVGElement.prototype` so D3 layout
+ *    primitives (axes, legends, annotations) read realistic text widths from
+ *    `@napi-rs/canvas` instead of jsdom's zero defaults.
+ *  - `renderBpc` from `@blueprint-chart/lib` parses the source, resolves the
+ *    requested scene, and mounts SVG into the container via D3.
+ *
+ * Throws when `renderBpc` cannot produce SVG output (invalid source, etc.) —
+ * callers (the `render` tool) catch and translate to a structured ToolResult.
+ */
+export function renderSceneState(source, opts) {
+    const env = createJsdomEnv({ width: opts.width, height: opts.height });
+    try {
+        installTextShim(env.window);
+        const jsdomWindow = env.window;
+        const globals = globalThis;
+        const prev = {};
+        for (const key of FORWARDED_GLOBALS) {
+            prev[key] = globals[key];
+            globals[key] = jsdomWindow[key];
+        }
+        try {
+            renderBpc(env.container, source, {
+                sceneIndex: opts.sceneIndex,
+                thumbnail: true,
+                transition: false,
+                theme: opts.theme,
+            });
+        }
+        finally {
+            for (const key of FORWARDED_GLOBALS) {
+                globals[key] = prev[key];
+            }
+        }
+        const svg = env.serialize();
+        if (!svg) {
+            throw new Error('renderBpc produced no SVG output');
+        }
+        return svg;
+    }
+    finally {
+        env.cleanup();
+    }
+}

package/dist/render/renderSceneState.test.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/dist/render/renderSceneState.test.js ADDED Viewed

@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest';
+import { samples } from '@blueprint-chart/lib';
+import { renderSceneState } from './renderSceneState';
+describe('renderSceneState', () => {
+    it('returns non-empty SVG for the first sample, scene 0', () => {
+        const svg = renderSceneState(samples[0].dsl, { sceneIndex: 0, width: 800, height: 500 });
+        expect(svg).toMatch(/^<svg/);
+        expect(svg).toMatch(/<\/svg>$/);
+        expect(svg.length).toBeGreaterThan(500);
+    });
+    it('clamps sceneIndex when out of bounds', () => {
+        const svg = renderSceneState(samples[0].dsl, { sceneIndex: 999, width: 400, height: 300 });
+        expect(svg).toMatch(/^<svg/);
+    });
+    it('throws for unparseable input (callers catch)', () => {
+        expect(() => renderSceneState('@@@ nope', { width: 400, height: 300 })).toThrow();
+    });
+});

package/dist/render/textShim.d.ts ADDED Viewed

@@ -0,0 +1,12 @@
+import type { DOMWindow } from 'jsdom';
+/**
+ * Patch jsdom's SVG element prototypes so D3 layout primitives that rely on
+ * text measurement (axes, legends, annotations) return realistic widths.
+ *
+ * jsdom 26 does not expose `SVGTextContentElement` and does not subclass
+ * `<svg:text>` from `SVGGraphicsElement` — text elements are plain
+ * `SVGElement` instances. We therefore patch `SVGElement.prototype` so the
+ * methods exist on the actual prototype chain, while also patching the
+ * spec-correct prototypes if they happen to be available.
+ */
+export declare function installTextShim(window: DOMWindow): void;

package/dist/render/textShim.js ADDED Viewed

@@ -0,0 +1,78 @@
+import { createCanvas, GlobalFonts } from '@napi-rs/canvas';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+// Register a bundled font under "sans-serif" so text-width measurements are
+// deterministic regardless of which system fonts the host machine has. Without
+// this, `ctx.measureText` resolves "sans-serif" through fontconfig and picks
+// whatever it finds (DejaVu Sans on Debian/Docker, Noto Sans on Ubuntu CI,
+// system fonts on macOS) — and each one yields slightly different metrics,
+// breaking golden-render snapshots.
+//
+// Path resolves correctly both pre-build (tsx running src/) and post-build
+// (node running dist/) because the build step copies fonts/ alongside the JS.
+const fontsDir = resolve(dirname(fileURLToPath(import.meta.url)), 'fonts');
+GlobalFonts.registerFromPath(resolve(fontsDir, 'DejaVuSans.ttf'), 'sans-serif');
+GlobalFonts.registerFromPath(resolve(fontsDir, 'DejaVuSans-Bold.ttf'), 'sans-serif');
+const canvas = createCanvas(1, 1);
+const ctx = canvas.getContext('2d');
+function measure(text, fontSize, fontFamily, fontWeight) {
+    ctx.font = `${fontWeight} ${fontSize}px ${fontFamily}`;
+    return ctx.measureText(text);
+}
+function fontFor(el) {
+    const fontSize = parseFloat(el.getAttribute('font-size') ?? '12') || 12;
+    const fontFamily = el.getAttribute('font-family') ?? 'sans-serif';
+    const fontWeight = el.getAttribute('font-weight') ?? 'normal';
+    return { fontSize, fontFamily, fontWeight };
+}
+/**
+ * Patch jsdom's SVG element prototypes so D3 layout primitives that rely on
+ * text measurement (axes, legends, annotations) return realistic widths.
+ *
+ * jsdom 26 does not expose `SVGTextContentElement` and does not subclass
+ * `<svg:text>` from `SVGGraphicsElement` — text elements are plain
+ * `SVGElement` instances. We therefore patch `SVGElement.prototype` so the
+ * methods exist on the actual prototype chain, while also patching the
+ * spec-correct prototypes if they happen to be available.
+ */
+export function installTextShim(window) {
+    const svgElementProto = window.SVGElement?.prototype;
+    const computedTextLength = function () {
+        const { fontSize, fontFamily, fontWeight } = fontFor(this);
+        return measure(this.textContent ?? '', fontSize, fontFamily, fontWeight).width;
+    };
+    const subStringLength = function (offset, count) {
+        const txt = (this.textContent ?? '').substring(offset, offset + count);
+        const { fontSize, fontFamily, fontWeight } = fontFor(this);
+        return measure(txt, fontSize, fontFamily, fontWeight).width;
+    };
+    const getBBox = function () {
+        if (this.tagName === 'text') {
+            const { fontSize, fontFamily, fontWeight } = fontFor(this);
+            const m = measure(this.textContent ?? '', fontSize, fontFamily, fontWeight);
+            return { x: 0, y: -fontSize, width: m.width, height: fontSize };
+        }
+        // For non-text elements, fall back to declared attrs.
+        const x = parseFloat(this.getAttribute('x') ?? '0') || 0;
+        const y = parseFloat(this.getAttribute('y') ?? '0') || 0;
+        const width = parseFloat(this.getAttribute('width') ?? '0') || 0;
+        const height = parseFloat(this.getAttribute('height') ?? '0') || 0;
+        return { x, y, width, height };
+    };
+    if (svgElementProto) {
+        svgElementProto.getComputedTextLength = computedTextLength;
+        svgElementProto.getSubStringLength = subStringLength;
+        svgElementProto.getBBox = getBBox;
+    }
+    // Spec-correct prototypes — patch when jsdom (or a future version) exposes them.
+    const textContentProto = window
+        .SVGTextContentElement?.prototype;
+    if (textContentProto) {
+        textContentProto.getComputedTextLength = computedTextLength;
+        textContentProto.getSubStringLength = subStringLength;
+    }
+    const graphicsProto = window.SVGGraphicsElement?.prototype;
+    if (graphicsProto) {
+        graphicsProto.getBBox = getBBox;
+    }
+}

package/dist/render/textShim.test.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/dist/render/textShim.test.js ADDED Viewed

@@ -0,0 +1,31 @@
+import { describe, expect, it } from 'vitest';
+import { createJsdomEnv } from './jsdomEnv';
+import { installTextShim } from './textShim';
+describe('textShim', () => {
+    it('makes getComputedTextLength return a non-zero value for non-empty text', () => {
+        const env = createJsdomEnv({ width: 400, height: 100 });
+        installTextShim(env.window);
+        const svg = env.window.document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+        const text = env.window.document.createElementNS('http://www.w3.org/2000/svg', 'text');
+        text.textContent = 'Hello, world';
+        text.setAttribute('font-size', '14');
+        text.setAttribute('font-family', 'sans-serif');
+        svg.appendChild(text);
+        env.container.appendChild(svg);
+        const length = text.getComputedTextLength();
+        expect(length).toBeGreaterThan(0);
+    });
+    it('getBBox returns width matching getComputedTextLength', () => {
+        const env = createJsdomEnv({ width: 400, height: 100 });
+        installTextShim(env.window);
+        const svg = env.window.document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+        const text = env.window.document.createElementNS('http://www.w3.org/2000/svg', 'text');
+        text.textContent = 'Hi';
+        text.setAttribute('font-size', '14');
+        svg.appendChild(text);
+        env.container.appendChild(svg);
+        const bbox = text.getBBox();
+        const length = text.getComputedTextLength();
+        expect(bbox.width).toBeCloseTo(length, 0);
+    });
+});

package/dist/resources/docsReader.d.ts ADDED Viewed

@@ -0,0 +1,14 @@
+import { type DocEntry } from '@blueprint-chart/docs';
+export interface UriResource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType: string;
+}
+export declare function listAllResources(): UriResource[];
+export declare function readResource(uri: string): {
+    uri: string;
+    mimeType: string;
+    text: string;
+};
+export declare function resourceEntries(): DocEntry[];

package/dist/resources/docsReader.js ADDED Viewed

@@ -0,0 +1,50 @@
+import { getDoc, listDocs } from '@blueprint-chart/docs';
+const GROUP_TO_URI = {
+    'handbook': 'bpc://handbook/',
+    'guide': 'bpc://guide/',
+    'charts': 'bpc://chart-types/',
+    'reference/dsl': 'bpc://reference/dsl/',
+    'reference/api': 'bpc://reference/api/',
+};
+const URI_TO_GROUP = Object.entries(GROUP_TO_URI).map(([group, prefix]) => ({ prefix, group }));
+const GRAMMAR_URI = 'bpc://grammar';
+export function listAllResources() {
+    const groups = Object.keys(GROUP_TO_URI);
+    const docResources = groups.flatMap(group => listDocs(group).map(entry => ({
+        uri: `${GROUP_TO_URI[group]}${entry.slug}`,
+        name: entry.title,
+        description: entry.blurb,
+        mimeType: 'text/markdown',
+    })));
+    return [
+        {
+            uri: GRAMMAR_URI,
+            name: 'BPC Grammar (aggregate)',
+            description: 'Full DSL grammar reference, concatenated from reference/dsl pages.',
+            mimeType: 'text/markdown',
+        },
+        ...docResources,
+    ];
+}
+export function readResource(uri) {
+    if (uri === GRAMMAR_URI) {
+        const pages = listDocs('reference/dsl');
+        const sections = pages.map((entry) => {
+            const { content } = getDoc('reference/dsl', entry.slug);
+            return `# ${entry.title}\n\n${content}`;
+        });
+        return { uri, mimeType: 'text/markdown', text: sections.join('\n\n---\n\n') };
+    }
+    for (const { prefix, group } of URI_TO_GROUP) {
+        if (uri.startsWith(prefix)) {
+            const slug = uri.slice(prefix.length);
+            const { content } = getDoc(group, slug);
+            return { uri, mimeType: 'text/markdown', text: content };
+        }
+    }
+    throw new Error(`Unknown resource URI: ${uri}`);
+}
+export function resourceEntries() {
+    const groups = Object.keys(GROUP_TO_URI);
+    return groups.flatMap(g => listDocs(g));
+}

package/dist/resources/docsReader.test.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/dist/resources/docsReader.test.js ADDED Viewed

@@ -0,0 +1,24 @@
+import { describe, expect, it } from 'vitest';
+import { listAllResources, readResource } from './docsReader';
+describe('docsReader', () => {
+    it('lists handbook entries', () => {
+        const list = listAllResources();
+        expect(list.some(r => r.uri.startsWith('bpc://handbook/'))).toBe(true);
+    });
+    it('reads a known handbook page', () => {
+        const list = listAllResources();
+        const first = list.find(r => r.uri.startsWith('bpc://handbook/'));
+        const doc = readResource(first.uri);
+        expect(doc.mimeType).toBe('text/markdown');
+        expect(doc.text.length).toBeGreaterThan(100);
+    });
+    it('throws on unknown URI', () => {
+        expect(() => readResource('bpc://handbook/does-not-exist')).toThrow();
+    });
+    it('exposes bpc://grammar as an aggregate of reference/dsl pages', () => {
+        const list = listAllResources();
+        expect(list.some(r => r.uri === 'bpc://grammar')).toBe(true);
+        const doc = readResource('bpc://grammar');
+        expect(doc.text.length).toBeGreaterThan(500);
+    });
+});

package/dist/resources/index.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+export declare function listResources(): import("./docsReader").UriResource[];
+export declare function readResource(uri: string): {
+    uri: string;
+    mimeType: string;
+    text: string;
+};

package/dist/resources/index.js ADDED Viewed

@@ -0,0 +1,11 @@
+import { listAllResources as listDocsResources, readResource as readDocsResource } from './docsReader';
+import { listSampleResources, readSampleResource } from './samples';
+export function listResources() {
+    return [...listDocsResources(), ...listSampleResources()];
+}
+export function readResource(uri) {
+    if (uri.startsWith('bpc://samples/')) {
+        return readSampleResource(uri);
+    }
+    return readDocsResource(uri);
+}

package/dist/resources/samples.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+interface SampleResource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType: string;
+}
+export declare function listSampleResources(): SampleResource[];
+export declare function readSampleResource(uri: string): {
+    uri: string;
+    mimeType: string;
+    text: string;
+};
+export {};

package/dist/resources/samples.js ADDED Viewed

@@ -0,0 +1,21 @@
+import { samples } from '@blueprint-chart/lib';
+const PREFIX = 'bpc://samples/';
+export function listSampleResources() {
+    return samples.map(s => ({
+        uri: `${PREFIX}${s.id}`,
+        name: s.title,
+        description: s.description,
+        mimeType: 'text/plain',
+    }));
+}
+export function readSampleResource(uri) {
+    if (!uri.startsWith(PREFIX)) {
+        throw new Error(`Not a sample URI: ${uri}`);
+    }
+    const id = uri.slice(PREFIX.length);
+    const sample = samples.find(s => s.id === id);
+    if (!sample) {
+        throw new Error(`Unknown sample: ${id}`);
+    }
+    return { uri, mimeType: 'text/plain', text: sample.dsl };
+}

package/dist/resources/samples.test.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/dist/resources/samples.test.js ADDED Viewed

@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest';
+import { samples } from '@blueprint-chart/lib';
+import { listSampleResources, readSampleResource } from './samples';
+describe('samples resources', () => {
+    it('lists one resource per lib sample', () => {
+        const list = listSampleResources();
+        expect(list.length).toBe(samples.length);
+    });
+    it('reads a sample as text/plain bpc', () => {
+        const first = listSampleResources()[0];
+        const doc = readSampleResource(first.uri);
+        expect(doc.mimeType).toBe('text/plain');
+        expect(doc.text.length).toBeGreaterThan(20);
+    });
+    it('throws on unknown sample id', () => {
+        expect(() => readSampleResource('bpc://samples/does-not-exist')).toThrow();
+    });
+});

package/dist/server.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
2	+ export declare function createServer(): Server;

package/dist/server.js ADDED Viewed

@@ -0,0 +1,86 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { validateDsl, ValidateInputSchema } from './tools/validate';
+import { inspectDsl, InspectInputSchema } from './tools/inspect';
+import { recommendChartType, RecommendInputSchema } from './tools/recommend';
+import { renderTool, RenderInputSchema } from './tools/render';
+import { listResources, readResource } from './resources/index';
+import { authorChartPrompt } from './prompts/authorChart';
+import { zodToJsonSchema } from './lib/zodToJsonSchema';
+const TOOLS = {
+    validate_dsl: {
+        description: 'Parse a .bpc source string. Return ok or precise parse errors with line/column.',
+        inputSchema: ValidateInputSchema,
+        handler: args => validateDsl(args),
+    },
+    inspect_dsl: {
+        description: 'Parse a .bpc source and return a structured summary: chartType, scenes, series count, annotations, etc.',
+        inputSchema: InspectInputSchema,
+        handler: args => inspectDsl(args),
+    },
+    recommend_chart_type: {
+        description: 'Given an array of column types and a row count, return ranked chart-type recommendations.',
+        inputSchema: RecommendInputSchema,
+        handler: args => recommendChartType(args),
+    },
+    render: {
+        description: 'Render a .bpc source to SVG (default) or PNG. Accepts scene index, width, height.',
+        inputSchema: RenderInputSchema,
+        handler: args => renderTool(args),
+    },
+};
+function formatToolResult(result) {
+    if (result.ok) {
+        return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] };
+    }
+    return {
+        isError: true,
+        content: [{ type: 'text', text: JSON.stringify({ code: result.code, errors: result.errors }, null, 2) }],
+    };
+}
+export function createServer() {
+    const server = new Server({ name: '@blueprint-chart/mcp', version: '0.1.0' }, { capabilities: { tools: {}, resources: {}, prompts: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: Object.entries(TOOLS).map(([name, def]) => ({
+            name,
+            description: def.description,
+            inputSchema: zodToJsonSchema(def.inputSchema),
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const tool = TOOLS[req.params.name];
+        if (!tool) {
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Unknown tool: ${req.params.name}` }],
+            };
+        }
+        const result = await tool.handler(req.params.arguments ?? {});
+        return formatToolResult(result);
+    });
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: listResources(),
+    }));
+    server.setRequestHandler(ReadResourceRequestSchema, async (req) => {
+        const { uri } = req.params;
+        const doc = readResource(uri);
+        return { contents: [{ uri: doc.uri, mimeType: doc.mimeType, text: doc.text }] };
+    });
+    const PROMPTS = {
+        author_chart: authorChartPrompt(),
+    };
+    server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+        prompts: Object.entries(PROMPTS).map(([name, p]) => ({
+            name,
+            description: p.description,
+        })),
+    }));
+    server.setRequestHandler(GetPromptRequestSchema, async (req) => {
+        const prompt = PROMPTS[req.params.name];
+        if (!prompt) {
+            throw new Error(`Unknown prompt: ${req.params.name}`);
+        }
+        return prompt;
+    });
+    return server;
+}

package/dist/server.test.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};