@unovis/mcp 1.7.0-mcp.1 → 1.7.0-mcp.2

package/README.md

@@ -14,6 +14,7 @@ Read them on the web at [unovis.dev/docs/mcp](https://unovis.dev/docs/mcp), or i
 [chart spec](./docs/chart-spec.md) ·
 [programmatic use](./docs/programmatic.md) ·
 [interactive charts](./docs/interactive.md) ·
+[native WebViews](./docs/webview.md) ·
 [architecture](./docs/architecture.md) ·
 [troubleshooting](./docs/troubleshooting.md)
 
@@ -104,7 +105,7 @@ recipe → ChartSpec ─┬→ headless renderer  → SVG / PNG        (any clie
                     └→ widget bundle      → ui:// resource    (MCP UI clients)
 ```
 
-The browser widget (~665kB, everything inlined) runs the **same materializer** as the headless renderer, so one code path turns a spec into a chart on both sides. It also works as a plain iframe for any web page — point an iframe at the widget with `#embed` and post it a spec:
+The browser widget (everything inlined; documents are ~140kB for XY/radial charts and ~290kB for network/geo ones — the smallest sufficient bundle variant travels as a gzip payload with a self-extracting bootstrap) runs the **same materializer** as the headless renderer, so one code path turns a spec into a chart on both sides. It also works as a plain iframe for any web page — point an iframe at the widget with `#embed` and post it a spec:
 
 ```js
 iframe.contentWindow.postMessage({ type: 'unovis:render', spec }, '*')
@@ -121,7 +122,7 @@ Unovis is a browser-first library — it renders SVG into a live DOM using D3. T
 2. charts render with `duration: 0` (fully synchronous), the frame queue is drained until quiescent, and `onRenderComplete` confirms the chart is final;
 3. a post-processing pass makes the SVG standalone: emotion styles are inlined as attributes, `var()` references baked to literal values (theme-aware), ids rewritten deterministically, and the title/legend header synthesized.
 
-Fonts: on first start the server provisions Inter (Unovis's default font) for text measurement — it downloads the official [Inter release](https://github.com/rsms/inter) once (pinned version, SHA-256 verified, SIL OFL 1.1) into `~/.cache/unovis-mcp/fonts/` and reuses it from there. Offline or with `UNOVIS_MCP_NO_DOWNLOAD=1` it falls back to system fonts (metrics are close, not exact). To use your own fonts, set `UNOVIS_MCP_FONTS_DIR=/path/to/fonts` or drop font files into the package's `fonts/` directory — both take precedence over the download.
+Fonts: on first start the server provisions Inter (Unovis's default font) for text measurement — it downloads the official [Inter release](https://github.com/rsms/inter) once (pinned version, SHA-256 verified, SIL OFL 1.1) into `~/.cache/unovis-ssr/fonts/` and reuses it from there. Offline or with `UNOVIS_MCP_NO_DOWNLOAD=1` it falls back to system fonts (metrics are close, not exact). To use your own fonts, set `UNOVIS_MCP_FONTS_DIR=/path/to/fonts` or drop font files into `@unovis/ssr`'s `fonts/` directory — both take precedence over the download.
 
 ## Programmatic use
 

package/dist/cli.js

@@ -27,6 +27,9 @@ Options:
   --port <port>             HTTP port (default: 3737)
   --endpoint <path>         HTTP endpoint path (default: /mcp)
   --tools <a,b,...>         Only expose these tools
+  --allow-write-dir <dir>   Directory outputPath may write into. stdio default:
+                            anywhere (the user's own machine); http default:
+                            file writes disabled
   --version                 Print version
   --help                    Show this help
 
@@ -37,6 +40,7 @@ async function main() {
     const { values } = parseArgs({
         options: {
             transport: { type: 'string', default: 'stdio' },
+            'allow-write-dir': { type: 'string' },
             host: { type: 'string', default: '127.0.0.1' },
             port: { type: 'string', default: '3737' },
             endpoint: { type: 'string', default: '/mcp' },
@@ -56,6 +60,9 @@ async function main() {
     const filter = {
         disabledTools: (process.env.DISABLED_TOOLS ?? '').split(',').map(s => s.trim()).filter(Boolean),
         enabledTools: values.tools?.split(',').map(s => s.trim()).filter(Boolean),
+        // A local stdio server acts with its user's own authority; an HTTP
+        // endpoint must not be a remote file-write primitive
+        writeDir: values['allow-write-dir'] ?? (values.transport === 'http' ? false : undefined),
     };
     if (values.transport === 'stdio') {
         const server = buildServer(filter);

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/html/document.d.ts

@@ -1,16 +1,29 @@
 import type { ChartSpec } from '../render/spec.js';
-/** The compiled widget bundle (built by scripts/build-widget.mjs) */
-export declare function widgetBundle(): string;
+import type { BundleVariant } from '../widget/variants.js';
+/** The compiled widget bundle */
+export declare function widgetBundle(variant?: BundleVariant): string;
 export interface ChartDocumentOptions {
     /** Document <title>; defaults to the spec title */
     documentTitle?: string;
     /** Animation duration in ms. 0 renders immediately (deterministic tests,
      * and useful when the chart is screenshotted right after load) */
     duration?: number;
+    /** Inline the widget as a gzip+base64 payload with a self-extracting
+     * bootstrap (default true). Set false for a plain-text bundle — e.g. when
+     * a host page's CSP forbids injected script elements */
+    compress?: boolean;
 }
 /** A standalone page that renders `spec` on load */
 export declare function buildChartDocument(spec: ChartSpec, options?: ChartDocumentOptions): string;
 /** A page that renders whatever spec it is sent over postMessage.
  * Protocol: iframe posts `unovis:ready`, host posts `unovis:render` with a
  * spec, iframe posts `unovis:size` after each render. */
-export declare function buildEmbedDocument(): string;
+export interface EmbedDocumentOptions {
+    /** See ChartDocumentOptions.compress (default true) */
+    compress?: boolean;
+    /** Component types this embed will ever render (e.g. ['Line', 'Donut']).
+     * Lets the document carry the smaller standard bundle when the set allows;
+     * omitted, it carries the full bundle so any spec renders */
+    components?: string[];
+}
+export declare function buildEmbedDocument(options?: EmbedDocumentOptions): string;

package/dist/html/document.js

@@ -9,30 +9,61 @@
  */
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
-let cachedBundle;
-/** The compiled widget bundle (built by scripts/build-widget.mjs) */
-export function widgetBundle() {
-    if (cachedBundle)
-        return cachedBundle;
-    // Resolve relative to this module so it works from dist/ and from src/
+import { gzipSync } from 'node:zlib';
+import { bundleVariantFor } from '../widget/variants.js';
+const artifactCache = new Map();
+/** A compiled widget artifact (built by scripts/build-widget.mjs), resolved
+ * relative to this module so it works from dist/ and from src/ */
+function widgetArtifact(name) {
+    const cached = artifactCache.get(name);
+    if (cached)
+        return cached;
     const candidates = [
-        new URL('../widget/bundle.js', import.meta.url),
-        new URL('../../dist/widget/bundle.js', import.meta.url),
+        new URL(`../widget/${name}`, import.meta.url),
+        new URL(`../../dist/widget/${name}`, import.meta.url),
     ];
     for (const candidate of candidates) {
         try {
-            cachedBundle = readFileSync(fileURLToPath(candidate), 'utf8');
-            return cachedBundle;
+            const content = readFileSync(fileURLToPath(candidate), 'utf8');
+            artifactCache.set(name, content);
+            return content;
         }
         catch { /* try the next candidate */ }
     }
-    throw new Error('Widget bundle not found — run `pnpm build:widget`');
+    throw new Error(`Widget artifact ${name} not found — run \`pnpm build:widget\``);
+}
+/** The compiled widget bundle */
+export function widgetBundle(variant = 'full') {
+    return widgetArtifact(variant === 'standard' ? 'bundle.standard.js' : 'bundle.js');
+}
+/** The widget, inlined. Compressed by default: a standalone file never gets
+ * transport compression, so the bundle ships as a gzip+base64 payload with a
+ * ~5kB synchronous bootstrap ahead of it (~3× smaller documents). The spec
+ * and styles stay plain text so committed artifacts remain readable and
+ * diffable. */
+function inlineWidget(compress, variant) {
+    if (!compress)
+        return `<script>${widgetBundle(variant)}</script>`;
+    const key = `${variant}.gz64`;
+    let payload = artifactCache.get(key);
+    if (!payload) {
+        payload = gzipSync(Buffer.from(widgetBundle(variant)), { level: 9 }).toString('base64');
+        artifactCache.set(key, payload);
+    }
+    return `<script type="application/gzip" id="uv-bundle-gz">${payload}</script>
+<script>${widgetArtifact('unpack.js')}</script>`;
 }
 /** `</script` inside embedded JSON would close the host script element */
 const escapeForScript = (json) => json.replace(/</g, '\\u003c');
 const FONT_STACK = 'Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif';
 function styles(spec) {
-    const aspect = spec ? `${spec.width} / ${spec.height}` : '16 / 9';
+    // Interpolated into markup — a hand-built spec could smuggle anything in
+    // these fields, so only finite numbers survive
+    const width = Number(spec?.width);
+    const height = Number(spec?.height);
+    const aspect = Number.isFinite(width) && Number.isFinite(height) && width > 0 && height > 0
+        ? `${width} / ${height}`
+        : '16 / 9';
     return `
   :root { --uv-bg: #ffffff; --uv-fg: #1f2937; --uv-muted: #6b7280; --uv-border: #e5e7eb; }
   :root[data-theme="dark"] { --uv-bg: #292b34; --uv-fg: #f2f4f9; --uv-muted: #aab2c0; --uv-border: #3a3d47; }
@@ -53,8 +84,9 @@ function styles(spec) {
 /** A standalone page that renders `spec` on load */
 export function buildChartDocument(spec, options = {}) {
     const title = options.documentTitle ?? spec.title ?? 'Unovis chart';
+    const variant = bundleVariantFor(spec.components.map(c => c.type));
     return `<!doctype html>
-<html lang="en"${spec.theme === 'dark' ? ' data-theme="dark"' : ''}>
+<html lang="en" data-uv-bundle="${variant}"${spec.theme === 'dark' ? ' data-theme="dark"' : ''}>
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -65,17 +97,15 @@ export function buildChartDocument(spec, options = {}) {
 <div id="uv-root"></div>
 <script type="application/json" id="uv-spec">${escapeForScript(JSON.stringify(spec))}</script>
 <script type="application/json" id="uv-options">${escapeForScript(JSON.stringify({ duration: options.duration ?? 400 }))}</script>
-<script>${widgetBundle()}</script>
+${inlineWidget(options.compress !== false, variant)}
 </body>
 </html>
 `;
 }
-/** A page that renders whatever spec it is sent over postMessage.
- * Protocol: iframe posts `unovis:ready`, host posts `unovis:render` with a
- * spec, iframe posts `unovis:size` after each render. */
-export function buildEmbedDocument() {
+export function buildEmbedDocument(options = {}) {
+    const variant = options.components ? bundleVariantFor(options.components) : 'full';
     return `<!doctype html>
-<html lang="en">
+<html lang="en" data-uv-bundle="${variant}">
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -86,7 +116,7 @@ export function buildEmbedDocument() {
 </head>
 <body>
 <div id="uv-embed-root"></div>
-<script>${widgetBundle()}</script>
+${inlineWidget(options.compress !== false, variant)}
 <script>window.UnovisChart.startEmbed()</script>
 </body>
 </html>

package/dist/html/document.js.map

@@ -1 +1 @@
-{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/html/document.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAIxC,IAAI,YAAgC,CAAA;AAEpC,qEAAqE;AACrE,MAAM,UAAU,YAAY;IAC1B,IAAI,YAAY;QAAE,OAAO,YAAY,CAAA;IACrC,uEAAuE;IACvE,MAAM,UAAU,GAAG;QACjB,IAAI,GAAG,CAAC,qBAAqB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/C,IAAI,GAAG,CAAC,6BAA6B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;KACxD,CAAA;IACD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,YAAY,GAAG,YAAY,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAA;YAC7D,OAAO,YAAY,CAAA;QACrB,CAAC;QAAC,MAAM,CAAC,CAAC,4BAA4B,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;AACtE,CAAC;AAED,0EAA0E;AAC1E,MAAM,eAAe,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;AAE/E,MAAM,UAAU,GAAG,6EAA6E,CAAA;AAEhG,SAAS,MAAM,CAAE,IAAgB;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAA;IACjE,OAAO;;;oGAG2F,UAAU;;;;;2CAKnE,MAAM;;;;;;;mEAOkB,CAAA;AACnE,CAAC;AAUD,oDAAoD;AACpD,MAAM,UAAU,kBAAkB,CAAE,IAAe,EAAE,UAAgC,EAAE;IACrF,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,KAAK,IAAI,cAAc,CAAA;IACnE,OAAO;iBACQ,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE;;;;SAIzD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SAC3B,MAAM,CAAC,IAAI,CAAC;;;;+CAI0B,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;kDAClC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,GAAG,EAAE,CAAC,CAAC;UAC9G,YAAY,EAAE;;;CAGvB,CAAA;AACD,CAAC;AAED;;yDAEyD;AACzD,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;SAMA,MAAM,EAAE;;;;;;UAMP,YAAY,EAAE;;;;CAIvB,CAAA;AACD,CAAC"}
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/html/document.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -7,19 +7,20 @@
  */
 export { renderChart, ChartInputError } from './render/renderer.js';
 export type { RenderOptions } from './render/renderer.js';
-export { renderToSvg } from './render/headless.js';
-export type { HeadlessRenderOptions, BuildContext, RenderedChart, RenderResult } from './render/headless.js';
+export { renderToSvg } from '@unovis/ssr';
+export type { HeadlessRenderOptions, BuildContext, RenderedChart, RenderResult } from '@unovis/ssr';
 export { buildChartDocument, buildEmbedDocument } from './html/document.js';
 export type { ChartDocumentOptions } from './html/document.js';
-export { svgToPng, themeBackground } from './render/rasterize.js';
-export type { RasterizeOptions } from './render/rasterize.js';
+export { svgToPng, themeBackground } from '@unovis/ssr';
+export type { RasterizeOptions } from '@unovis/ssr';
+export { SPEC_VERSION } from './render/spec.js';
 export type { ChartSpec, ComponentSpec, AxisSpec, AccessorRef, LegendItemSpec } from './render/spec.js';
 export { recipes, recipeByName } from './recipes/index.js';
 export type { Recipe, AnyRecipe } from './recipes/index.js';
 export { buildServer } from './server.js';
 export { registerTools, activeRecipes } from './tools/register.js';
 export type { ToolFilterOptions } from './tools/register.js';
-export { getRenderEnv } from './env/index.js';
-export type { RenderEnv, UnovisLib } from './env/index.js';
+export { getRenderEnv } from '@unovis/ssr';
+export type { RenderEnv, UnovisLib } from '@unovis/ssr';
 export { generateCode, formatGeneratedFiles, FRAMEWORKS } from './codegen/index.js';
 export type { Framework, GeneratedFile } from './codegen/index.js';

package/dist/index.js

@@ -7,12 +7,15 @@
  */
 export { renderChart, ChartInputError } from './render/renderer.js';
 // The headless primitive: render any Unovis chart to standalone SVG in Node
-export { renderToSvg } from './render/headless.js';
+// Re-exported from @unovis/ssr, where the headless renderer now lives —
+// existing imports from '@unovis/mcp' keep working
+export { renderToSvg } from '@unovis/ssr';
 export { buildChartDocument, buildEmbedDocument } from './html/document.js';
-export { svgToPng, themeBackground } from './render/rasterize.js';
+export { svgToPng, themeBackground } from '@unovis/ssr';
+export { SPEC_VERSION } from './render/spec.js';
 export { recipes, recipeByName } from './recipes/index.js';
 export { buildServer } from './server.js';
 export { registerTools, activeRecipes } from './tools/register.js';
-export { getRenderEnv } from './env/index.js';
+export { getRenderEnv } from '@unovis/ssr';
 export { generateCode, formatGeneratedFiles, FRAMEWORKS } from './codegen/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEnE,4EAA4E;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAE3E,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAGjE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAE1D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAElE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEnE,4EAA4E;AAC5E,wEAAwE;AACxE,mDAAmD;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAE3E,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAE1D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAElE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/recipes/area.d.ts

@@ -4,6 +4,7 @@ export declare const areaInputShape: {
     width: z.ZodDefault<z.ZodNumber>;
     height: z.ZodDefault<z.ZodNumber>;
     theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    locale: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     framework: z.ZodDefault<z.ZodEnum<["ts", "react", "svelte", "vue", "angular", "solid"]>>;
@@ -23,18 +24,18 @@ export declare const areaInputShape: {
         style: z.ZodDefault<z.ZodEnum<["dashed", "solid", "dotted"]>>;
     }, "strip", z.ZodTypeAny, {
         value: number;
-        style: "solid" | "dashed" | "dotted";
         axis: "x" | "y";
         lineWidth: number;
+        style: "solid" | "dashed" | "dotted";
         label?: string | undefined;
         color?: string | undefined;
     }, {
         value: number;
         label?: string | undefined;
         color?: string | undefined;
-        style?: "solid" | "dashed" | "dotted" | undefined;
         axis?: "x" | "y" | undefined;
         lineWidth?: number | undefined;
+        style?: "solid" | "dashed" | "dotted" | undefined;
     }>, "many">>;
     referenceBands: z.ZodOptional<z.ZodArray<z.ZodObject<{
         axis: z.ZodDefault<z.ZodEnum<["x", "y"]>>;

package/dist/recipes/bar.d.ts

@@ -4,6 +4,7 @@ export declare const barInputShape: {
     width: z.ZodDefault<z.ZodNumber>;
     height: z.ZodDefault<z.ZodNumber>;
     theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    locale: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     framework: z.ZodDefault<z.ZodEnum<["ts", "react", "svelte", "vue", "angular", "solid"]>>;
@@ -23,18 +24,18 @@ export declare const barInputShape: {
         style: z.ZodDefault<z.ZodEnum<["dashed", "solid", "dotted"]>>;
     }, "strip", z.ZodTypeAny, {
         value: number;
-        style: "solid" | "dashed" | "dotted";
         axis: "x" | "y";
         lineWidth: number;
+        style: "solid" | "dashed" | "dotted";
         label?: string | undefined;
         color?: string | undefined;
     }, {
         value: number;
         label?: string | undefined;
         color?: string | undefined;
-        style?: "solid" | "dashed" | "dotted" | undefined;
         axis?: "x" | "y" | undefined;
         lineWidth?: number | undefined;
+        style?: "solid" | "dashed" | "dotted" | undefined;
     }>, "many">>;
     referenceBands: z.ZodOptional<z.ZodArray<z.ZodObject<{
         axis: z.ZodDefault<z.ZodEnum<["x", "y"]>>;

package/dist/recipes/boxplot.d.ts

@@ -4,6 +4,7 @@ export declare const boxplotInputShape: {
     width: z.ZodDefault<z.ZodNumber>;
     height: z.ZodDefault<z.ZodNumber>;
     theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    locale: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     framework: z.ZodDefault<z.ZodEnum<["ts", "react", "svelte", "vue", "angular", "solid"]>>;
@@ -19,18 +20,18 @@ export declare const boxplotInputShape: {
         style: z.ZodDefault<z.ZodEnum<["dashed", "solid", "dotted"]>>;
     }, "strip", z.ZodTypeAny, {
         value: number;
-        style: "solid" | "dashed" | "dotted";
         axis: "x" | "y";
         lineWidth: number;
+        style: "solid" | "dashed" | "dotted";
         label?: string | undefined;
         color?: string | undefined;
     }, {
         value: number;
         label?: string | undefined;
         color?: string | undefined;
-        style?: "solid" | "dashed" | "dotted" | undefined;
         axis?: "x" | "y" | undefined;
         lineWidth?: number | undefined;
+        style?: "solid" | "dashed" | "dotted" | undefined;
     }>, "many">>;
     referenceBands: z.ZodOptional<z.ZodArray<z.ZodObject<{
         axis: z.ZodDefault<z.ZodEnum<["x", "y"]>>;

package/dist/recipes/chord.d.ts

@@ -4,6 +4,7 @@ export declare const chordInputShape: {
     width: z.ZodDefault<z.ZodNumber>;
     height: z.ZodDefault<z.ZodNumber>;
     theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    locale: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     framework: z.ZodDefault<z.ZodEnum<["ts", "react", "svelte", "vue", "angular", "solid"]>>;

package/dist/recipes/choropleth.d.ts

@@ -4,6 +4,7 @@ export declare const choroplethInputShape: {
     width: z.ZodDefault<z.ZodNumber>;
     height: z.ZodDefault<z.ZodNumber>;
     theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    locale: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     framework: z.ZodDefault<z.ZodEnum<["ts", "react", "svelte", "vue", "angular", "solid"]>>;

package/dist/recipes/donut.d.ts

@@ -4,6 +4,7 @@ export declare const donutInputShape: {
     width: z.ZodDefault<z.ZodNumber>;
     height: z.ZodDefault<z.ZodNumber>;
     theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    locale: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     framework: z.ZodDefault<z.ZodEnum<["ts", "react", "svelte", "vue", "angular", "solid"]>>;

package/dist/recipes/graph.d.ts

@@ -4,6 +4,7 @@ export declare const graphInputShape: {
     height: z.ZodDefault<z.ZodNumber>;
     width: z.ZodDefault<z.ZodNumber>;
     theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    locale: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     framework: z.ZodDefault<z.ZodEnum<["ts", "react", "svelte", "vue", "angular", "solid"]>>;

package/dist/recipes/heatmap.d.ts

@@ -4,6 +4,7 @@ export declare const heatmapInputShape: {
     width: z.ZodDefault<z.ZodNumber>;
     height: z.ZodDefault<z.ZodNumber>;
     theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    locale: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     framework: z.ZodDefault<z.ZodEnum<["ts", "react", "svelte", "vue", "angular", "solid"]>>;

package/dist/recipes/index.d.ts

@@ -3,3 +3,5 @@ export type { Recipe, AnyRecipe } from './types.js';
 /** All available chart recipes, in display order */
 export declare const recipes: AnyRecipe[];
 export declare const recipeByName: Map<string, AnyRecipe>;
+export { ChartInputError, assertFieldsExist, baseSpec, categoricalX, dateTickValues, field, seriesLegend, timeTickValuesFromData, xyAxes, } from './shared.js';
+export type { DataRecord } from './shared.js';

package/dist/recipes/index.js

@@ -32,4 +32,7 @@ export const recipes = [
     choroplethRecipe,
 ];
 export const recipeByName = new Map(recipes.map(r => [r.name, r]));
+// Spec-building helpers, so consumers of `@unovis/mcp/recipes` don't have to
+// hand-roll accessors, axes, legends or time ticks that the recipes already do
+export { ChartInputError, assertFieldsExist, baseSpec, categoricalX, dateTickValues, field, seriesLegend, timeTickValuesFromData, xyAxes, } from './shared.js';
 //# sourceMappingURL=index.js.map

package/dist/recipes/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recipes/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAIlD,oDAAoD;AACpD,MAAM,CAAC,MAAM,OAAO,GAAgB;IAClC,UAAU;IACV,UAAU;IACV,SAAS;IACT,aAAa;IACb,WAAW;IACX,cAAc;IACd,aAAa;IACb,YAAY;IACZ,aAAa;IACb,aAAa;IACb,WAAW;IACX,iBAAiB;IACjB,eAAe;IACf,WAAW;IACX,gBAAgB;CACjB,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recipes/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAIlD,oDAAoD;AACpD,MAAM,CAAC,MAAM,OAAO,GAAgB;IAClC,UAAU;IACV,UAAU;IACV,SAAS;IACT,aAAa;IACb,WAAW;IACX,cAAc;IACd,aAAa;IACb,YAAY;IACZ,aAAa;IACb,aAAa;IACb,WAAW;IACX,iBAAiB;IACjB,eAAe;IACf,WAAW;IACX,gBAAgB;CACjB,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;AAElE,6EAA6E;AAC7E,+EAA+E;AAC/E,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,KAAK,EACL,YAAY,EACZ,sBAAsB,EACtB,MAAM,GACP,MAAM,aAAa,CAAA"}

package/dist/recipes/line.d.ts

@@ -4,6 +4,7 @@ export declare const lineInputShape: {
     width: z.ZodDefault<z.ZodNumber>;
     height: z.ZodDefault<z.ZodNumber>;
     theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    locale: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     framework: z.ZodDefault<z.ZodEnum<["ts", "react", "svelte", "vue", "angular", "solid"]>>;
@@ -23,18 +24,18 @@ export declare const lineInputShape: {
         style: z.ZodDefault<z.ZodEnum<["dashed", "solid", "dotted"]>>;
     }, "strip", z.ZodTypeAny, {
         value: number;
-        style: "solid" | "dashed" | "dotted";
         axis: "x" | "y";
         lineWidth: number;
+        style: "solid" | "dashed" | "dotted";
         label?: string | undefined;
         color?: string | undefined;
     }, {
         value: number;
         label?: string | undefined;
         color?: string | undefined;
-        style?: "solid" | "dashed" | "dotted" | undefined;
         axis?: "x" | "y" | undefined;
         lineWidth?: number | undefined;
+        style?: "solid" | "dashed" | "dotted" | undefined;
     }>, "many">>;
     referenceBands: z.ZodOptional<z.ZodArray<z.ZodObject<{
         axis: z.ZodDefault<z.ZodEnum<["x", "y"]>>;

package/dist/recipes/nested-donut.d.ts

@@ -4,6 +4,7 @@ export declare const nestedDonutInputShape: {
     width: z.ZodDefault<z.ZodNumber>;
     height: z.ZodDefault<z.ZodNumber>;
     theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    locale: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     framework: z.ZodDefault<z.ZodEnum<["ts", "react", "svelte", "vue", "angular", "solid"]>>;

package/dist/recipes/radial-bar.d.ts

@@ -4,6 +4,7 @@ export declare const radialBarInputShape: {
     width: z.ZodDefault<z.ZodNumber>;
     height: z.ZodDefault<z.ZodNumber>;
     theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    locale: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     framework: z.ZodDefault<z.ZodEnum<["ts", "react", "svelte", "vue", "angular", "solid"]>>;

package/dist/recipes/sankey.d.ts

@@ -4,6 +4,7 @@ export declare const sankeyInputShape: {
     width: z.ZodDefault<z.ZodNumber>;
     height: z.ZodDefault<z.ZodNumber>;
     theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    locale: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     framework: z.ZodDefault<z.ZodEnum<["ts", "react", "svelte", "vue", "angular", "solid"]>>;

package/dist/recipes/scatter.d.ts

@@ -4,6 +4,7 @@ export declare const scatterInputShape: {
     width: z.ZodDefault<z.ZodNumber>;
     height: z.ZodDefault<z.ZodNumber>;
     theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    locale: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     framework: z.ZodDefault<z.ZodEnum<["ts", "react", "svelte", "vue", "angular", "solid"]>>;
@@ -23,18 +24,18 @@ export declare const scatterInputShape: {
         style: z.ZodDefault<z.ZodEnum<["dashed", "solid", "dotted"]>>;
     }, "strip", z.ZodTypeAny, {
         value: number;
-        style: "solid" | "dashed" | "dotted";
         axis: "x" | "y";
         lineWidth: number;
+        style: "solid" | "dashed" | "dotted";
         label?: string | undefined;
         color?: string | undefined;
     }, {
         value: number;
         label?: string | undefined;
         color?: string | undefined;
-        style?: "solid" | "dashed" | "dotted" | undefined;
         axis?: "x" | "y" | undefined;
         lineWidth?: number | undefined;
+        style?: "solid" | "dashed" | "dotted" | undefined;
     }>, "many">>;
     referenceBands: z.ZodOptional<z.ZodArray<z.ZodObject<{
         axis: z.ZodDefault<z.ZodEnum<["x", "y"]>>;

package/dist/recipes/shared.d.ts

@@ -17,6 +17,7 @@ export declare const commonInput: {
     width: z.ZodDefault<z.ZodNumber>;
     height: z.ZodDefault<z.ZodNumber>;
     theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    locale: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     framework: z.ZodDefault<z.ZodEnum<["ts", "react", "svelte", "vue", "angular", "solid"]>>;
@@ -41,18 +42,18 @@ export declare const xyDecorations: {
         style: z.ZodDefault<z.ZodEnum<["dashed", "solid", "dotted"]>>;
     }, "strip", z.ZodTypeAny, {
         value: number;
-        style: "solid" | "dashed" | "dotted";
         axis: "x" | "y";
         lineWidth: number;
+        style: "solid" | "dashed" | "dotted";
         label?: string | undefined;
         color?: string | undefined;
     }, {
         value: number;
         label?: string | undefined;
         color?: string | undefined;
-        style?: "solid" | "dashed" | "dotted" | undefined;
         axis?: "x" | "y" | undefined;
         lineWidth?: number | undefined;
+        style?: "solid" | "dashed" | "dotted" | undefined;
     }>, "many">>;
     referenceBands: z.ZodOptional<z.ZodArray<z.ZodObject<{
         axis: z.ZodDefault<z.ZodEnum<["x", "y"]>>;
@@ -118,13 +119,7 @@ export declare function categoricalX(data: DataRecord[], fieldName: string, isTi
  * Explicit integer tickValues — approximate d3 tick counts can emit
  * fractional ticks that would round into duplicate category labels. */
 export declare function categoryAxis(base: AxisSpec, categories: string[]): AxisSpec;
-/** Calendar-aligned tick values for date axes. Linear-scale ticks land at
- * arbitrary times of day, which the date formatter would render as
- * time-of-day labels ("08:53 AM" on a 3-month chart) — align ticks to
- * month/day/hour/minute boundaries instead. */
-export declare function dateTickValues(min: number, max: number, target?: number): number[] | undefined;
-/** Tick values for a time axis derived from the data extent of a date field */
-export declare function timeTickValuesFromData(data: DataRecord[], fieldName: string): number[] | undefined;
+export { dateTickValues, timeTickValuesFromData } from '../render/time-ticks.js';
 export declare function seriesLegend(labels: string[], enabled: boolean, colors?: string[]): LegendItemSpec[] | undefined;
 /** Common ChartSpec fields from common tool inputs */
 export declare function baseSpec(input: {
@@ -133,7 +128,8 @@ export declare function baseSpec(input: {
     theme: 'light' | 'dark';
     title?: string;
     colors?: string[];
-}): Pick<ChartSpec, 'width' | 'height' | 'theme' | 'title' | 'colors'>;
+    locale?: string;
+}): Pick<ChartSpec, 'specVersion' | 'width' | 'height' | 'theme' | 'title' | 'colors' | 'locale'>;
 export declare function xyAxes(input: {
     xAxisLabel?: string;
     yAxisLabel?: string;