@unovis/mcp 1.7.0-mcp.0

package/dist/env/computed-style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computed-style.js","sourceRoot":"","sources":["../../src/env/computed-style.ts"],"names":[],"mappings":"AAsBA,MAAM,oBAAoB,GAAG,uDAAuD,CAAA;AACpF,MAAM,kBAAkB,GAAG,MAAM,CAAA;AAEjC,IAAI,OAAO,GAAY,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,CAAA;AAQ5D,IAAI,SAAS,GAAe,EAAE,CAAA;AAE9B,MAAM,UAAU,UAAU,CAAE,IAAa;IACvC,OAAO,GAAG,IAAI,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,YAAY,CAAE,KAA4C;IACxE,SAAS,GAAG,EAAE,CAAA;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAQ;QAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAQ;QAC3C,sDAAsD;QACtD,wEAAwE;QACxE,yEAAyE;QACzE,+BAA+B;QAC/B,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAQ;QAC7C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAA;QAC9C,qEAAqE;QACrE,0BAA0B;QAC1B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,+DAA+D,CAAC,EAAE,CAAC;YACzG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QAC7C,CAAC;QACD,IAAI,YAAY,CAAC,IAAI;YAAE,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAA;IAClF,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAE,EAAW,EAAE,IAAY;IAChD,IAAI,KAAyB,CAAA;IAC7B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC5C,IAAI,QAAQ,KAAK,SAAS;YAAE,SAAQ;QACpC,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAAE,KAAK,GAAG,QAAQ,CAAA,CAAC,qCAAqC;QACvF,CAAC;QAAC,MAAM,CAAC,CAAC,qCAAqC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,iBAAiB,CAAE,QAAkB;IACnD,MAAM,IAAI,GAAG,QAAQ,CAAC,eAAe,CAAA;IACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAA;IAC1B,OAAO,IAAI,EAAE,YAAY,CAAC,YAAY,CAAC,KAAK,MAAM;QAChD,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC;QAChF,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;AACpF,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,cAAc,CAAE,KAAa,EAAE,QAAkB,EAAE,KAAK,GAAG,CAAC;IAC1E,IAAI,KAAK,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAA;IACvD,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IACxC,OAAO,KAAK,CAAC,OAAO,CAAC,kEAAkE,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,QAAiB,EAAE,EAAE;QAC9H,mEAAmE;QACnE,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACtC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAA;QAChF,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3F,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,SAAS,CAAE,IAAY,EAAE,IAAa;IAC7C,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACjE,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AAChC,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAE,IAAY,EAAE,EAAkB,EAAE,QAAkB;IACjF,IAAI,IAAI,GAAmB,EAAE,CAAA;IAC7B,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,KAAK,GAAI,IAAiC,CAAC,KAAK,CAAA;QACtD,MAAM,MAAM,GAAG,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAA;QAC5C,IAAI,MAAM;YAAE,OAAO,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QACnD,IAAI,GAAG,IAAI,CAAC,aAAa,CAAA;IAC3B,CAAC;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC1D,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACnE,CAAC;AAED,SAAS,eAAe,CAAE,EAAW,EAAE,IAAgE,EAAE,QAAgB,EAAE,QAAkB;IAC3I,8DAA8D;IAC9D,MAAM,SAAS,GAAI,EAA+B,CAAC,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAChF,IAAI,SAAS;QAAE,OAAO,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAA;IAEhE,4EAA4E;IAC5E,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAA;QAC1D,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;IAC/B,CAAC;IAED,0EAA0E;IAC1E,IAAI,IAAI,GAAmB,EAAE,CAAA;IAC7B,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAC1C,IAAI,OAAO;YAAE,OAAO,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAA;QAC5D,IAAI,GAAG,IAAI,CAAC,aAAa,CAAA;IAC3B,CAAC;IAED,uEAAuE;IACvE,IAAI,GAAG,EAAE,CAAA;IACT,OAAO,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,IAAI;YAAE,OAAO,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAA;QACtD,MAAM,MAAM,GAAI,IAAmB,CAAC,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAA;QACjE,IAAI,MAAM;YAAE,OAAO,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAA;QAC1D,IAAI,GAAG,IAAI,CAAC,aAAa,CAAA;IAC3B,CAAC;IACD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,WAAW,CAAC,CAAC,OAAO,kBAAkB,CAAA;QAC3C,KAAK,aAAa,CAAC,CAAC,OAAO,cAAc,CAAC,SAAS,CAAC,mBAAmB,EAAE,KAAK,CAAC,IAAI,oBAAoB,EAAE,QAAQ,CAAC,CAAA;QAClH,OAAO,CAAC,CAAC,OAAO,QAAQ,CAAA;IAC1B,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,oBAAoB,CAAE,EAAW,EAAE,QAAkB;IACnE,mEAAmE;IACnE,MAAM,KAAK,GAAG,sBAAsB,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IAClD,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAA;IAClF,MAAM,UAAU,GAAG,eAAe,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAA;IACxF,MAAM,UAAU,GAAG,eAAe,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAA;IACxF,MAAM,SAAS,GAAG,eAAe,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAA;IACrF,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;IAC7C,OAAO,EAAE,IAAI,EAAE,GAAG,SAAS,IAAI,UAAU,IAAI,UAAU,MAAM,UAAU,EAAE,EAAE,UAAU,EAAE,CAAA;AACzF,CAAC;AAED,IAAI,sBAAkG,CAAA;AAEtG,SAAS,sBAAsB,CAAE,EAAW,EAAE,QAAkB;IAC9D,IAAI,CAAC;QACH,OAAO,sBAAsB,EAAE,CAAC,EAAE,CAAC,CAAA;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAE,MAAiB;IACrD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;IAChC,sBAAsB,GAAG,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAE7D,0EAA0E;IAC1E,0EAA0E;IAC1E,6DAA6D;IAC7D,MAAM,IAAI,GAAG,CAAI,EAAW,EAAE,QAAW,EAAK,EAAE;QAC9C,IAAI,CAAC;YACH,OAAO,EAAE,EAAE,CAAA;QACb,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,QAAQ,CAAA;QACjB,CAAC;IACH,CAAC,CAAA;IAED,MAAM,OAAO,GAAG,CAAC,EAAW,EAAE,MAAsB,EAAuB,EAAE;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,sBAAuB,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,SAA4C,CAAC,CAAA;QAC5G,OAAO,IAAI,KAAK,CAAC,CAAC,MAAM,IAAI,EAAE,CAAwB,EAAE;YACtD,GAAG,CAAE,CAAC,EAAE,IAAI;gBACV,IAAI,IAAI,KAAK,kBAAkB,EAAE,CAAC;oBAChC,OAAO,CAAC,IAAY,EAAU,EAAE;wBAC9B,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;4BAAE,OAAO,aAAa,CAAC,IAAI,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAA;wBACnE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;wBAC9D,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;4BAAE,OAAO,eAAe,CAAC,EAAE,EAAE,IAAmB,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAA;wBACxF,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;oBACzE,CAAC,CAAA;gBACH,CAAC;gBACD,IAAI,IAAI,KAAK,UAAU;oBAAE,OAAO,eAAe,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAA;gBACtG,IAAI,IAAI,KAAK,YAAY;oBAAE,OAAO,eAAe,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAA;gBAC5G,IAAI,IAAI,KAAK,YAAY;oBAAE,OAAO,eAAe,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAA;gBAC5G,IAAI,IAAI,KAAK,WAAW;oBAAE,OAAO,eAAe,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAA;gBACzG,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;gBAC5D,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;YAC5D,CAAC;SACF,CAAC,CAAA;IACJ,CAAC,CAGA;IAAC,MAAc,CAAC,gBAAgB,GAAG,OAAO,CAAA;AAC7C,CAAC"}

package/dist/env/fonts.d.ts

@@ -0,0 +1,3 @@
+/** Resolve a directory containing font files for text measurement, or
+ * undefined when none is available (system-font fallback). */
+export declare function ensureFontsDir(): Promise<string | undefined>;

package/dist/env/fonts.js

@@ -0,0 +1,103 @@
+/** Inter font provisioning.
+ *
+ * Unovis defaults to the Inter font stack, and text measurement drives label
+ * trimming, wrapping and axis margins — measuring with the same font the
+ * viewer renders keeps geometry faithful. Fonts are resolved in order:
+ *
+ *  1. `UNOVIS_MCP_FONTS_DIR` (explicit directory of font files)
+ *  2. the package's own `fonts/` directory (manually added / bundled)
+ *  3. a user-level cache, populated once by downloading the official Inter
+ *     release (pinned version + SHA-256 verified) and extracting four static
+ *     TTF faces + the OFL license
+ *
+ * The download is best-effort: offline environments (or
+ * `UNOVIS_MCP_NO_DOWNLOAD=1`) fall back to system fonts with a one-line
+ * stderr note — rendering never fails because of fonts.
+ */
+import { createHash } from 'node:crypto';
+import { mkdirSync, readdirSync, writeFileSync, renameSync, rmSync } from 'node:fs';
+import { tmpdir, homedir } from 'node:os';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { unzipSync } from 'fflate';
+const INTER_VERSION = '4.1';
+const INTER_URL = `https://github.com/rsms/inter/releases/download/v${INTER_VERSION}/Inter-${INTER_VERSION}.zip`;
+const INTER_SHA256 = '9883fdd4a49d4fb66bd8177ba6625ef9a64aa45899767dde3d36aa425756b11e';
+const DOWNLOAD_TIMEOUT_MS = 60_000;
+/** Faces used by chart text: Regular (labels), Medium (ticks, weight 500),
+ * SemiBold (titles), Bold */
+const FACES = ['Inter-Regular.ttf', 'Inter-Medium.ttf', 'Inter-SemiBold.ttf', 'Inter-Bold.ttf'];
+const LICENSE_ENTRY = 'LICENSE.txt';
+const hasFontFiles = (dir) => {
+    try {
+        return readdirSync(dir).some(f => /\.(ttf|otf|woff2?)$/i.test(f));
+    }
+    catch {
+        return false;
+    }
+};
+function cacheDir() {
+    const base = process.env.XDG_CACHE_HOME || join(homedir(), '.cache');
+    return join(base, 'unovis-mcp', 'fonts', `inter-${INTER_VERSION}`);
+}
+async function downloadInter(targetDir) {
+    const response = await fetch(INTER_URL, { signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS), redirect: 'follow' });
+    if (!response.ok)
+        throw new Error(`HTTP ${response.status} for ${INTER_URL}`);
+    const zip = new Uint8Array(await response.arrayBuffer());
+    const digest = createHash('sha256').update(zip).digest('hex');
+    if (digest !== INTER_SHA256)
+        throw new Error(`checksum mismatch for ${INTER_URL}: ${digest}`);
+    const wanted = new Set([...FACES.map(f => `extras/ttf/${f}`), LICENSE_ENTRY]);
+    const entries = unzipSync(zip, { filter: file => wanted.has(file.name) });
+    const missing = [...wanted].filter(name => !entries[name]);
+    if (missing.length)
+        throw new Error(`entries missing from Inter archive: ${missing.join(', ')}`);
+    // Extract to a temp dir and move into place so a killed process can't
+    // leave a half-populated cache behind
+    const staging = join(tmpdir(), `unovis-mcp-fonts-${process.pid}`);
+    rmSync(staging, { recursive: true, force: true });
+    mkdirSync(staging, { recursive: true });
+    for (const [name, data] of Object.entries(entries)) {
+        writeFileSync(join(staging, name.split('/').pop()), data);
+    }
+    mkdirSync(join(targetDir, '..'), { recursive: true });
+    rmSync(targetDir, { recursive: true, force: true });
+    renameSync(staging, targetDir);
+    return true;
+}
+let ensurePromise;
+/** Resolve a directory containing font files for text measurement, or
+ * undefined when none is available (system-font fallback). */
+export function ensureFontsDir() {
+    // eslint-disable-next-line @typescript-eslint/no-use-before-define
+    if (!ensurePromise)
+        ensurePromise = resolveFontsDir();
+    return ensurePromise;
+}
+async function resolveFontsDir() {
+    const explicit = process.env.UNOVIS_MCP_FONTS_DIR;
+    if (explicit) {
+        if (hasFontFiles(explicit))
+            return explicit;
+        console.error(`unovis-mcp: UNOVIS_MCP_FONTS_DIR has no font files: ${explicit}`);
+    }
+    const packageFonts = fileURLToPath(new URL('../../fonts', import.meta.url));
+    if (hasFontFiles(packageFonts))
+        return packageFonts;
+    const cache = cacheDir();
+    if (hasFontFiles(cache))
+        return cache;
+    if (process.env.UNOVIS_MCP_NO_DOWNLOAD)
+        return undefined;
+    try {
+        await downloadInter(cache);
+        console.error(`unovis-mcp: downloaded Inter ${INTER_VERSION} (SIL OFL 1.1) to ${cache}`);
+        return cache;
+    }
+    catch (e) {
+        console.error(`unovis-mcp: Inter download skipped (${e instanceof Error ? e.message : e}) — using system fonts for text measurement`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=fonts.js.map

package/dist/env/fonts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.js","sourceRoot":"","sources":["../../src/env/fonts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACnF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAElC,MAAM,aAAa,GAAG,KAAK,CAAA;AAC3B,MAAM,SAAS,GAAG,oDAAoD,aAAa,UAAU,aAAa,MAAM,CAAA;AAChH,MAAM,YAAY,GAAG,kEAAkE,CAAA;AACvF,MAAM,mBAAmB,GAAG,MAAM,CAAA;AAElC;6BAC6B;AAC7B,MAAM,KAAK,GAAG,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,gBAAgB,CAAC,CAAA;AAC/F,MAAM,aAAa,GAAG,aAAa,CAAA;AAEnC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAW,EAAE;IAC5C,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC,CAAA;AAED,SAAS,QAAQ;IACf,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAA;IACpE,OAAO,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC,CAAA;AACpE,CAAC;AAED,KAAK,UAAU,aAAa,CAAE,SAAiB;IAC7C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAA;IACjH,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,QAAQ,SAAS,EAAE,CAAC,CAAA;IAC7E,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;IAExD,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC7D,IAAI,MAAM,KAAK,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,SAAS,KAAK,MAAM,EAAE,CAAC,CAAA;IAE7F,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC,CAAA;IAC7E,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACzE,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IAC1D,IAAI,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAEhG,sEAAsE;IACtE,sCAAsC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,oBAAoB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IACjE,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACjD,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAY,CAAC,EAAE,IAAI,CAAC,CAAA;IACrE,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACrD,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACnD,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IAC9B,OAAO,IAAI,CAAA;AACb,CAAC;AAED,IAAI,aAAsD,CAAA;AAE1D;8DAC8D;AAC9D,MAAM,UAAU,cAAc;IAC5B,mEAAmE;IACnE,IAAI,CAAC,aAAa;QAAE,aAAa,GAAG,eAAe,EAAE,CAAA;IACrD,OAAO,aAAa,CAAA;AACtB,CAAC;AAED,KAAK,UAAU,eAAe;IAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAA;IACjD,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,YAAY,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAA;QAC3C,OAAO,CAAC,KAAK,CAAC,uDAAuD,QAAQ,EAAE,CAAC,CAAA;IAClF,CAAC;IAED,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC3E,IAAI,YAAY,CAAC,YAAY,CAAC;QAAE,OAAO,YAAY,CAAA;IAEnD,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAA;IACxB,IAAI,YAAY,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAErC,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB;QAAE,OAAO,SAAS,CAAA;IAExD,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,KAAK,CAAC,CAAA;QAC1B,OAAO,CAAC,KAAK,CAAC,gCAAgC,aAAa,qBAAqB,KAAK,EAAE,CAAC,CAAA;QACxF,OAAO,KAAK,CAAA;IACd,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,6CAA6C,CAAC,CAAA;QACrI,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/env/index.d.ts

@@ -0,0 +1,13 @@
+import type { DOMWindow } from 'jsdom';
+import { RafQueue } from './raf-queue.js';
+import type { VarMaps } from './computed-style.js';
+export { defineElementSize } from './size.js';
+export type UnovisLib = typeof import('@unovis/ts');
+export interface RenderEnv {
+    window: DOMWindow;
+    document: Document;
+    lib: UnovisLib;
+    raf: RafQueue;
+    varMaps: VarMaps;
+}
+export declare function getRenderEnv(): Promise<RenderEnv>;

package/dist/env/index.js

@@ -0,0 +1,121 @@
+/** Headless rendering environment for @unovis/ts.
+ *
+ * Creates a single shared jsdom window, installs every browser API the
+ * library needs (in the right order — some are captured at module load),
+ * and only then dynamically imports '@unovis/ts'. Import order matters:
+ *
+ *  - emotion inserts real <style> tags only if `document` exists at import
+ *  - utils/text-measure snapshots a canvas 2D context at module scope
+ *  - d3-timer binds `window.requestAnimationFrame` at module load
+ */
+import { JSDOM } from 'jsdom';
+import { RafQueue } from './raf-queue.js';
+import { installCanvasHook, registerFontsFromDir } from './canvas.js';
+import { ensureFontsDir } from './fonts.js';
+import { installBBoxPolyfills } from './bbox.js';
+import { installComputedStyle, setVarMaps, setFontRules } from './computed-style.js';
+import { collectCssRules } from '../svg/collect-css.js';
+export { defineElementSize } from './size.js';
+/* eslint-disable @typescript-eslint/no-empty-function */
+class NoopResizeObserver {
+    observe() { }
+    unobserve() { }
+    disconnect() { }
+}
+/* eslint-enable @typescript-eslint/no-empty-function */
+function exposeGlobals(window, raf) {
+    const globalNames = [
+        'document', 'location', 'navigator',
+        'Element', 'HTMLElement', 'SVGElement', 'SVGGraphicsElement', 'HTMLCanvasElement',
+        'Node', 'Text', 'DOMParser', 'XMLSerializer', 'MutationObserver',
+        'CSS', 'DOMPoint', 'DOMRect', 'getComputedStyle',
+    ];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const g = globalThis;
+    g.window = window;
+    for (const name of globalNames) {
+        if (!(name in window))
+            continue;
+        try {
+            Object.defineProperty(g, name, { configurable: true, get: () => window[name] });
+        }
+        catch { /* some globals (e.g. navigator on newer Node) may resist redefinition */ }
+    }
+    g.requestAnimationFrame = raf.request;
+    g.cancelAnimationFrame = raf.cancel;
+    g.ResizeObserver = NoopResizeObserver;
+}
+/** Parse all emotion-injected CSS custom properties into light/dark maps */
+function buildVarMapsFromRules(rules) {
+    const light = new Map();
+    const dark = new Map();
+    const darkSelector = /dark-theme|theme-dark|\[data-theme="?dark"?\]/;
+    for (const rule of rules) {
+        const isDark = darkSelector.test(rule.selector);
+        // Only :root-scoped declarations are global defaults. Class-scoped
+        // custom-property overrides (e.g. styleLargeSize from styles/sizes.ts)
+        // must not leak into the global maps.
+        if (!isDark && !rule.selector.includes(':root'))
+            continue;
+        for (const match of rule.block.matchAll(/(--[\w-]+)\s*:\s*([^;}]+)/g)) {
+            const [, name, value] = match;
+            (isDark ? dark : light).set(name, value.trim());
+        }
+    }
+    // The dark palette remap (--vis-colorN → --vis-dark-colorN) is declared
+    // under selectors jsdom can't apply; reproduce it here.
+    for (const [name, value] of light) {
+        const darkEquivalent = name.replace(/^--vis-color(\d+)$/, '--vis-dark-color$1');
+        if (darkEquivalent !== name && light.has(darkEquivalent)) {
+            if (!dark.has(name))
+                dark.set(name, light.get(darkEquivalent));
+        }
+        if (/^--vis-dark-/.test(name)) {
+            const lightName = name.replace('--vis-dark-', '--vis-');
+            if (!dark.has(lightName))
+                dark.set(lightName, value);
+        }
+    }
+    return { light, dark };
+}
+let envPromise;
+export function getRenderEnv() {
+    // eslint-disable-next-line @typescript-eslint/no-use-before-define
+    if (!envPromise)
+        envPromise = createEnv();
+    return envPromise;
+}
+async function createEnv() {
+    // Provision measurement fonts before anything can measure text
+    // (best-effort: falls back to system fonts offline)
+    const fontsDir = await ensureFontsDir();
+    if (fontsDir)
+        registerFontsFromDir(fontsDir);
+    const dom = new JSDOM('<!doctype html><html><body></body></html>', {
+        url: 'http://localhost/',
+        pretendToBeVisual: false,
+    });
+    const window = dom.window;
+    const raf = new RafQueue();
+    // Install shims before the library import — several APIs are captured
+    // at module scope inside @unovis/ts and its dependencies.
+    window.requestAnimationFrame = raf.request;
+    window.cancelAnimationFrame = raf.cancel;
+    window.ResizeObserver = NoopResizeObserver;
+    installCanvasHook(window);
+    installBBoxPolyfills(window);
+    installComputedStyle(window);
+    exposeGlobals(window, raf);
+    const lib = await import('@unovis/ts');
+    const cssRules = collectCssRules(window.document);
+    const varMaps = buildVarMapsFromRules(cssRules);
+    // Unovis estimates text width as chars × fontSize × ratio (default 0.5) when
+    // reserving label space, but trims against real canvas metrics — Inter runs
+    // wider (~0.55), so marginal labels would get clipped. A slightly generous
+    // ratio makes reservations always cover measured text.
+    varMaps.light.set('--vis-font-wh-ratio', '0.58');
+    setVarMaps(varMaps);
+    setFontRules(cssRules);
+    return { window, document: window.document, lib, raf, varMaps };
+}
+//# sourceMappingURL=index.js.map

package/dist/env/index.js.map

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

package/dist/env/raf-queue.d.ts

@@ -0,0 +1,23 @@
+/** Flushable requestAnimationFrame queue.
+ *
+ * Unovis defers rendering to the next animation frame (`ContainerCore.render`),
+ * and several components schedule follow-up frames (axis, scatter, heatmap,
+ * sankey, annotations, text-overlap). Instead of waiting on real timers we
+ * queue callbacks and drain the queue synchronously until no new frames are
+ * scheduled.
+ */
+type FrameCallback = (time: number) => void;
+export declare class RafQueue {
+    private queue;
+    private nextId;
+    /** Errors thrown by frame callbacks (collected so one bad frame can't kill a render) */
+    errors: unknown[];
+    request: (cb: FrameCallback) => number;
+    cancel: (id: number) => void;
+    get size(): number;
+    /** Drain the queue, letting callbacks schedule follow-up frames, until it
+     * stays empty or the iteration cap is reached. Returns rounds executed. */
+    flushAll(cap?: number): number;
+    clear(): void;
+}
+export {};

package/dist/env/raf-queue.js

@@ -0,0 +1,51 @@
+/** Flushable requestAnimationFrame queue.
+ *
+ * Unovis defers rendering to the next animation frame (`ContainerCore.render`),
+ * and several components schedule follow-up frames (axis, scatter, heatmap,
+ * sankey, annotations, text-overlap). Instead of waiting on real timers we
+ * queue callbacks and drain the queue synchronously until no new frames are
+ * scheduled.
+ */
+export class RafQueue {
+    queue = [];
+    nextId = 1;
+    /** Errors thrown by frame callbacks (collected so one bad frame can't kill a render) */
+    errors = [];
+    request = (cb) => {
+        const id = this.nextId++;
+        this.queue.push({ id, cb });
+        return id;
+    };
+    cancel = (id) => {
+        const index = this.queue.findIndex(entry => entry.id === id);
+        if (index >= 0)
+            this.queue.splice(index, 1);
+    };
+    get size() {
+        return this.queue.length;
+    }
+    /** Drain the queue, letting callbacks schedule follow-up frames, until it
+     * stays empty or the iteration cap is reached. Returns rounds executed. */
+    flushAll(cap = 32) {
+        let rounds = 0;
+        while (this.queue.length && rounds < cap) {
+            rounds += 1;
+            const batch = this.queue.splice(0, this.queue.length);
+            const time = performance.now();
+            for (const { cb } of batch) {
+                try {
+                    cb(time);
+                }
+                catch (e) {
+                    this.errors.push(e);
+                }
+            }
+        }
+        return rounds;
+    }
+    clear() {
+        this.queue.length = 0;
+        this.errors.length = 0;
+    }
+}
+//# sourceMappingURL=raf-queue.js.map

package/dist/env/raf-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raf-queue.js","sourceRoot":"","sources":["../../src/env/raf-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,OAAO,QAAQ;IACX,KAAK,GAAwC,EAAE,CAAA;IAC/C,MAAM,GAAG,CAAC,CAAA;IAClB,wFAAwF;IACjF,MAAM,GAAc,EAAE,CAAA;IAE7B,OAAO,GAAG,CAAC,EAAiB,EAAU,EAAE;QACtC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;QACxB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;QAC3B,OAAO,EAAE,CAAA;IACX,CAAC,CAAA;IAED,MAAM,GAAG,CAAC,EAAU,EAAQ,EAAE;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;QAC5D,IAAI,KAAK,IAAI,CAAC;YAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IAC7C,CAAC,CAAA;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;IAC1B,CAAC;IAED;+EAC2E;IAC3E,QAAQ,CAAE,GAAG,GAAG,EAAE;QAChB,IAAI,MAAM,GAAG,CAAC,CAAA;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;YACzC,MAAM,IAAI,CAAC,CAAA;YACX,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;YACrD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;YAC9B,KAAK,MAAM,EAAE,EAAE,EAAE,IAAI,KAAK,EAAE,CAAC;gBAC3B,IAAI,CAAC;oBACH,EAAE,CAAC,IAAI,CAAC,CAAA;gBACV,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;gBACrB,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;QACrB,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;IACxB,CAAC;CACF"}

package/dist/env/size.d.ts

@@ -0,0 +1,9 @@
+/** Element size shims.
+ *
+ * jsdom performs no layout: `clientWidth`/`clientHeight` are always 0 and
+ * `getBoundingClientRect()` returns a zero rect. Unovis containers read both
+ * to size charts (`ContainerCore.containerWidth/Height` — including
+ * `this.element.clientWidth` on the SVG element when explicit width/height
+ * are set in the config), so we define real values per element.
+ */
+export declare function defineElementSize(element: Element, width: number, height: number): void;

package/dist/env/size.js

@@ -0,0 +1,30 @@
+/** Element size shims.
+ *
+ * jsdom performs no layout: `clientWidth`/`clientHeight` are always 0 and
+ * `getBoundingClientRect()` returns a zero rect. Unovis containers read both
+ * to size charts (`ContainerCore.containerWidth/Height` — including
+ * `this.element.clientWidth` on the SVG element when explicit width/height
+ * are set in the config), so we define real values per element.
+ */
+export function defineElementSize(element, width, height) {
+    Object.defineProperties(element, {
+        clientWidth: { configurable: true, get: () => width },
+        clientHeight: { configurable: true, get: () => height },
+    });
+    const rect = {
+        x: 0,
+        y: 0,
+        top: 0,
+        left: 0,
+        right: width,
+        bottom: height,
+        width,
+        height,
+        toJSON: () => ({ width, height }),
+    };
+    Object.defineProperty(element, 'getBoundingClientRect', {
+        configurable: true,
+        value: () => rect,
+    });
+}
+//# sourceMappingURL=size.js.map

package/dist/env/size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.js","sourceRoot":"","sources":["../../src/env/size.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,UAAU,iBAAiB,CAAE,OAAgB,EAAE,KAAa,EAAE,MAAc;IAChF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE;QAC/B,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE;QACrD,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;KACxD,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG;QACX,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,CAAC;QACJ,GAAG,EAAE,CAAC;QACN,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,MAAM;QACd,KAAK;QACL,MAAM;QACN,MAAM,EAAE,GAAY,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;KAC3C,CAAA;IACD,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,uBAAuB,EAAE;QACtD,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI;KAClB,CAAC,CAAA;AACJ,CAAC"}

package/dist/html/document.d.ts

@@ -0,0 +1,16 @@
+import type { ChartSpec } from '../render/spec.js';
+/** The compiled widget bundle (built by scripts/build-widget.mjs) */
+export declare function widgetBundle(): 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;
+}
+/** 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;

package/dist/html/document.js

@@ -0,0 +1,95 @@
+/** Self-contained interactive chart documents.
+ *
+ * Emits one HTML file with the spec, the widget bundle and all styles inlined
+ * — no network, no build step, opens anywhere. Two shapes:
+ *
+ *  - `buildChartDocument(spec)`: renders the spec on load (file deliverable)
+ *  - `buildEmbedDocument()`: waits for a spec over postMessage (iframe/widget
+ *    host, used for the ui:// resource and third-party embedding)
+ */
+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/
+    const candidates = [
+        new URL('../widget/bundle.js', import.meta.url),
+        new URL('../../dist/widget/bundle.js', import.meta.url),
+    ];
+    for (const candidate of candidates) {
+        try {
+            cachedBundle = readFileSync(fileURLToPath(candidate), 'utf8');
+            return cachedBundle;
+        }
+        catch { /* try the next candidate */ }
+    }
+    throw new Error('Widget bundle not found — run `pnpm build:widget`');
+}
+/** `</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';
+    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; }
+  html, body { margin: 0; padding: 0; background: var(--uv-bg); color: var(--uv-fg); font-family: ${FONT_STACK}; }
+  body { padding: 16px; box-sizing: border-box; }
+  .uv-root { display: flex; flex-direction: column; gap: 8px; max-width: 100%; }
+  .uv-title { font-size: 16px; font-weight: 600; }
+  .uv-legend { display: flex; flex-wrap: wrap; }
+  .uv-chart { width: 100%; aspect-ratio: ${aspect}; min-height: 240px; }
+  .uv-error { padding: 16px; border: 1px solid #e35a68; border-radius: 8px; color: #e35a68; font-family: ui-monospace, monospace; font-size: 13px; }
+  /* Tooltip / crosshair content (Unovis provides the container chrome) */
+  .uv-tt-title { font-weight: 600; margin-bottom: 4px; }
+  .uv-tt-row { display: flex; gap: 12px; justify-content: space-between; font-size: 12px; line-height: 1.6; }
+  .uv-tt-key { color: var(--uv-muted); }
+  .uv-tt-val { font-variant-numeric: tabular-nums; font-weight: 500; }
+  @media (max-width: 560px) { .uv-chart { aspect-ratio: 4 / 3; } }`;
+}
+/** A standalone page that renders `spec` on load */
+export function buildChartDocument(spec, options = {}) {
+    const title = options.documentTitle ?? spec.title ?? 'Unovis chart';
+    return `<!doctype html>
+<html lang="en"${spec.theme === 'dark' ? ' data-theme="dark"' : ''}>
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${title.replace(/</g, '&lt;')}</title>
+<style>${styles(spec)}</style>
+</head>
+<body>
+<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>
+</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() {
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Unovis chart</title>
+<style>${styles()}
+  body { padding: 8px; }
+</style>
+</head>
+<body>
+<div id="uv-embed-root"></div>
+<script>${widgetBundle()}</script>
+<script>window.UnovisChart.startEmbed()</script>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=document.js.map

package/dist/html/document.js.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+/** @unovis/mcp — programmatic API.
+ *
+ * The package is primarily a CLI (`unovis-mcp`), but the renderer and server
+ * builder are exported for embedding:
+ *
+ *   import { renderChart, buildServer, recipes } from '@unovis/mcp'
+ */
+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 { 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 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 { generateCode, formatGeneratedFiles, FRAMEWORKS } from './codegen/index.js';
+export type { Framework, GeneratedFile } from './codegen/index.js';

package/dist/index.js

@@ -0,0 +1,18 @@
+/** @unovis/mcp — programmatic API.
+ *
+ * The package is primarily a CLI (`unovis-mcp`), but the renderer and server
+ * builder are exported for embedding:
+ *
+ *   import { renderChart, buildServer, recipes } from '@unovis/mcp'
+ */
+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';
+export { buildChartDocument, buildEmbedDocument } from './html/document.js';
+export { svgToPng, themeBackground } from './render/rasterize.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 { generateCode, formatGeneratedFiles, FRAMEWORKS } from './codegen/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/recipes/area.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import type { Recipe } from './types.js';
+export declare const areaInputShape: {
+    width: z.ZodDefault<z.ZodNumber>;
+    height: z.ZodDefault<z.ZodNumber>;
+    theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    title: z.ZodOptional<z.ZodString>;
+    colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    framework: z.ZodDefault<z.ZodEnum<["ts", "react", "svelte", "vue", "angular", "solid"]>>;
+    outputType: z.ZodDefault<z.ZodEnum<["svg", "png", "html", "interactive", "config", "code"]>>;
+    outputPath: z.ZodOptional<z.ZodString>;
+    scale: z.ZodDefault<z.ZodNumber>;
+    xAxisLabel: z.ZodOptional<z.ZodString>;
+    yAxisLabel: z.ZodOptional<z.ZodString>;
+    showGridLines: z.ZodDefault<z.ZodBoolean>;
+    legend: z.ZodDefault<z.ZodBoolean>;
+    referenceLines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        axis: z.ZodDefault<z.ZodEnum<["x", "y"]>>;
+        value: z.ZodNumber;
+        label: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
+        lineWidth: z.ZodDefault<z.ZodNumber>;
+        style: z.ZodDefault<z.ZodEnum<["dashed", "solid", "dotted"]>>;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+        style: "solid" | "dashed" | "dotted";
+        axis: "x" | "y";
+        lineWidth: number;
+        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;
+    }>, "many">>;
+    referenceBands: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        axis: z.ZodDefault<z.ZodEnum<["x", "y"]>>;
+        from: z.ZodNumber;
+        to: z.ZodNumber;
+        label: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        axis: "x" | "y";
+        from: number;
+        to: number;
+        label?: string | undefined;
+        color?: string | undefined;
+    }, {
+        from: number;
+        to: number;
+        label?: string | undefined;
+        color?: string | undefined;
+        axis?: "x" | "y" | undefined;
+    }>, "many">>;
+    data: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, "many">;
+    x: z.ZodString;
+    y: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+    stacked: z.ZodDefault<z.ZodBoolean>;
+    curve: z.ZodDefault<z.ZodEnum<["linear", "monotoneX", "basis", "natural", "step", "stepAfter", "stepBefore"]>>;
+    xIsTime: z.ZodDefault<z.ZodBoolean>;
+    seriesLabels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+};
+export declare const areaRecipe: Recipe<typeof areaInputShape>;