@nowline/export-core 0.5.0 → 0.6.0

package/dist/fonts/browser.d.ts

@@ -0,0 +1,10 @@
+import type { ResolvedFontPair } from '../types.js';
+/**
+ * Return the canonical bundled DejaVu font pair decoded with browser-compatible
+ * APIs (`atob`). Result is cached after the first call so the ~1 MB decode only
+ * runs once per page. Safe to call before wasm initialization.
+ */
+export declare function loadBundledFontsForBrowser(): ResolvedFontPair;
+/** Test seam: drop the cached pair so isolated tests start fresh. */
+export declare function _clearBrowserFontsCache(): void;
+//# sourceMappingURL=browser.d.ts.map

package/dist/fonts/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/fonts/browser.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAWpD;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,gBAAgB,CAY7D;AAED,qEAAqE;AACrE,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/fonts/browser.js

@@ -0,0 +1,43 @@
+// Browser-compatible bundled font loader.
+//
+// Same bundled DejaVu bytes as loadBundledSans/loadBundledMono (Node), but
+// decoded with `atob()` instead of Node's `Buffer.from()` so the module
+// bundles cleanly for the browser (the Free/Pro web apps, Playwright legs).
+//
+// Usage: `loadBundledFontsForBrowser()` returns a cached `ResolvedFontPair`
+// synchronously after the first call. Call it once at module init or lazy-once
+// inside your `loadWasm` / font-loading step.
+//
+// Node callers: use `loadBundledSans()` / `loadBundledMono()` from bundled.ts.
+import { MONO_BASE64, SANS_BASE64 } from '../generated/bundled-fonts.js';
+function b64ToBytes(b64) {
+    const binary = atob(b64);
+    const out = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++)
+        out[i] = binary.charCodeAt(i);
+    return out;
+}
+let cachedFonts;
+/**
+ * Return the canonical bundled DejaVu font pair decoded with browser-compatible
+ * APIs (`atob`). Result is cached after the first call so the ~1 MB decode only
+ * runs once per page. Safe to call before wasm initialization.
+ */
+export function loadBundledFontsForBrowser() {
+    if (!cachedFonts) {
+        cachedFonts = {
+            sans: { name: 'DejaVu Sans', bytes: b64ToBytes(SANS_BASE64), source: 'bundled' },
+            mono: {
+                name: 'DejaVu Sans Mono',
+                bytes: b64ToBytes(MONO_BASE64),
+                source: 'bundled',
+            },
+        };
+    }
+    return cachedFonts;
+}
+/** Test seam: drop the cached pair so isolated tests start fresh. */
+export function _clearBrowserFontsCache() {
+    cachedFonts = undefined;
+}
+//# sourceMappingURL=browser.js.map

package/dist/fonts/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/fonts/browser.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,EAAE;AACF,2EAA2E;AAC3E,wEAAwE;AACxE,4EAA4E;AAC5E,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,8CAA8C;AAC9C,EAAE;AACF,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAGzE,SAAS,UAAU,CAAC,GAAW;IAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACtE,OAAO,GAAG,CAAC;AACf,CAAC;AAED,IAAI,WAAyC,CAAC;AAE9C;;;;GAIG;AACH,MAAM,UAAU,0BAA0B;IACtC,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,WAAW,GAAG;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE;YAChF,IAAI,EAAE;gBACF,IAAI,EAAE,kBAAkB;gBACxB,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC;gBAC9B,MAAM,EAAE,SAAS;aACpB;SACJ,CAAC;IACN,CAAC;IACD,OAAO,WAAW,CAAC;AACvB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,uBAAuB;IACnC,WAAW,GAAG,SAAS,CAAC;AAC5B,CAAC"}

package/dist/fonts/bundled.d.ts

@@ -1,5 +1,13 @@
 export declare const BUNDLED_SANS_PATH: string;
 export declare const BUNDLED_MONO_PATH: string;
+/**
+ * Family names stamped on the bundled DejaVu faces. The resolver's
+ * `ResolvedFont.name`, the renderer's pinned `font-family`, the resvg family
+ * hints, and the live-preview `@font-face` must all use these exact strings
+ * so preview and raster export name the same face (the WYSIWYG contract).
+ */
+export declare const BUNDLED_SANS_FAMILY = "DejaVu Sans";
+export declare const BUNDLED_MONO_FAMILY = "DejaVu Sans Mono";
 export declare function loadBundledSans(): Promise<Uint8Array>;
 export declare function loadBundledMono(): Promise<Uint8Array>;
 /** Test seam: drop cached bytes so platform-mocked tests start fresh. */

package/dist/fonts/bundled.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundled.d.ts","sourceRoot":"","sources":["../../src/fonts/bundled.ts"],"names":[],"mappings":"AA+BA,eAAO,MAAM,iBAAiB,QAA0C,CAAC;AACzE,eAAO,MAAM,iBAAiB,QAA8C,CAAC;AAU7E,wBAAsB,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC,CAI3D;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC,CAI3D;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC"}
+{"version":3,"file":"bundled.d.ts","sourceRoot":"","sources":["../../src/fonts/bundled.ts"],"names":[],"mappings":"AA8CA,eAAO,MAAM,iBAAiB,QAA0C,CAAC;AACzE,eAAO,MAAM,iBAAiB,QAA8C,CAAC;AAE7E;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AACjD,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AAUtD,wBAAsB,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC,CAI3D;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC,CAI3D;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC"}

package/dist/fonts/bundled.js

@@ -16,16 +16,40 @@
 import * as path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { MONO_BASE64, SANS_BASE64 } from '../generated/bundled-fonts.js';
-const HERE = path.dirname(fileURLToPath(import.meta.url));
-// dist/fonts/bundled.js → ../../assets/fonts/
-//   src/fonts/bundled.ts → ../../assets/fonts/
-const ASSETS_DIR = path.resolve(HERE, '..', '..', 'assets', 'fonts');
+// Resolve the on-disk assets/fonts directory from this module's location.
+// `import.meta.url` is rewritten to `undefined` when this module is bundled
+// into a CommonJS context — esbuild collapses `import.meta` to `{}` for the VS
+// Code extension's `dist/extension.cjs`. The two exported paths below are
+// informational only (the runtime decodes the embedded base64 above, never
+// reads these files), so degrade to a bare relative directory instead of
+// throwing `ERR_INVALID_ARG_TYPE` at module load — which would crash the
+// extension before it can activate. See packages/vscode-extension.
+function bundledFontsDir() {
+    try {
+        // dist/fonts/bundled.js → ../../assets/fonts/
+        //   src/fonts/bundled.ts → ../../assets/fonts/
+        const here = path.dirname(fileURLToPath(import.meta.url));
+        return path.resolve(here, '..', '..', 'assets', 'fonts');
+    }
+    catch {
+        return path.join('assets', 'fonts');
+    }
+}
+const ASSETS_DIR = bundledFontsDir();
 // Informational: where the source-of-truth TTFs live on disk for users
 // running under Node. Not the runtime load source — `loadBundledSans` and
 // `loadBundledMono` decode from the embedded base64 instead. Inside a bun
 // --compile binary these paths are phantom (the assets are not on disk).
 export const BUNDLED_SANS_PATH = path.join(ASSETS_DIR, 'DejaVuSans.ttf');
 export const BUNDLED_MONO_PATH = path.join(ASSETS_DIR, 'DejaVuSansMono.ttf');
+/**
+ * Family names stamped on the bundled DejaVu faces. The resolver's
+ * `ResolvedFont.name`, the renderer's pinned `font-family`, the resvg family
+ * hints, and the live-preview `@font-face` must all use these exact strings
+ * so preview and raster export name the same face (the WYSIWYG contract).
+ */
+export const BUNDLED_SANS_FAMILY = 'DejaVu Sans';
+export const BUNDLED_MONO_FAMILY = 'DejaVu Sans Mono';
 let cachedSans;
 let cachedMono;
 function decodeBase64(b64) {

package/dist/fonts/bundled.js.map

@@ -1 +1 @@
-{"version":3,"file":"bundled.js","sourceRoot":"","sources":["../../src/fonts/bundled.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,EAAE;AACF,uDAAuD;AACvD,EAAE;AACF,6EAA6E;AAC7E,0EAA0E;AAC1E,6EAA6E;AAC7E,SAAS;AACT,EAAE;AACF,2DAA2D;AAC3D,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,qEAAqE;AACrE,2BAA2B;AAE3B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEzE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,8CAA8C;AAC9C,+CAA+C;AAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAErE,uEAAuE;AACvE,0EAA0E;AAC1E,0EAA0E;AAC1E,yEAAyE;AACzE,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;AAE7E,IAAI,UAAkC,CAAC;AACvC,IAAI,UAAkC,CAAC;AAEvC,SAAS,YAAY,CAAC,GAAW;IAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACvC,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACjC,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,UAAU,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACvC,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACjC,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,UAAU,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACvC,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,iBAAiB;IAC7B,UAAU,GAAG,SAAS,CAAC;IACvB,UAAU,GAAG,SAAS,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"bundled.js","sourceRoot":"","sources":["../../src/fonts/bundled.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,EAAE;AACF,uDAAuD;AACvD,EAAE;AACF,6EAA6E;AAC7E,0EAA0E;AAC1E,6EAA6E;AAC7E,SAAS;AACT,EAAE;AACF,2DAA2D;AAC3D,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,qEAAqE;AACrE,2BAA2B;AAE3B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEzE,0EAA0E;AAC1E,4EAA4E;AAC5E,+EAA+E;AAC/E,0EAA0E;AAC1E,2EAA2E;AAC3E,yEAAyE;AACzE,yEAAyE;AACzE,mEAAmE;AACnE,SAAS,eAAe;IACpB,IAAI,CAAC;QACD,8CAA8C;QAC9C,+CAA+C;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,GAAG,eAAe,EAAE,CAAC;AAErC,uEAAuE;AACvE,0EAA0E;AAC1E,0EAA0E;AAC1E,yEAAyE;AACzE,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAEtD,IAAI,UAAkC,CAAC;AACvC,IAAI,UAAkC,CAAC;AAEvC,SAAS,YAAY,CAAC,GAAW;IAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACvC,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACjC,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,UAAU,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACvC,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACjC,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,UAAU,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACvC,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,iBAAiB;IAC7B,UAAU,GAAG,SAAS,CAAC;IACvB,UAAU,GAAG,SAAS,CAAC;AAC3B,CAAC"}

package/dist/fonts/index.d.ts

@@ -1,3 +1,4 @@
+export { _clearBrowserFontsCache, loadBundledFontsForBrowser } from './browser.js';
 export { BUNDLED_MONO_PATH, BUNDLED_SANS_PATH, clearBundledCache, loadBundledMono, loadBundledSans, } from './bundled.js';
 export { ALIASES, aliasCandidate, type FontCandidate, isAlias, type PlatformProbe, probeListFor, } from './probe-list.js';
 export type { ResolveOptions, ResolveResult } from './resolve.js';

package/dist/fonts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fonts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,OAAO,EACP,cAAc,EACd,KAAK,aAAa,EAClB,OAAO,EACP,KAAK,aAAa,EAClB,YAAY,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fonts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EACH,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,OAAO,EACP,cAAc,EACd,KAAK,aAAa,EAClB,OAAO,EACP,KAAK,aAAa,EAClB,YAAY,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/fonts/index.js

@@ -1,3 +1,4 @@
+export { _clearBrowserFontsCache, loadBundledFontsForBrowser } from './browser.js';
 export { BUNDLED_MONO_PATH, BUNDLED_SANS_PATH, clearBundledCache, loadBundledMono, loadBundledSans, } from './bundled.js';
 export { ALIASES, aliasCandidate, isAlias, probeListFor, } from './probe-list.js';
 export { FontResolveError, resolveFonts } from './resolve.js';

package/dist/fonts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fonts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,OAAO,EACP,cAAc,EAEd,OAAO,EAEP,YAAY,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fonts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EACH,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,OAAO,EACP,cAAc,EAEd,OAAO,EAEP,YAAY,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/fonts/resolve.d.ts

@@ -5,9 +5,18 @@ export interface ResolveOptions {
     /** Path or alias for the mono role. */
     fontMono?: string;
     /**
-     * Skip steps 4–5; go straight to step 5 (bundled DejaVu pair). Implied by
+     * Opt in to the platform font probe (step 4). Off by default: the
+     * resolver is bundled-first, so the default (no flag/env) is the bundled
+     * DejaVu pair on every OS. With this set the probe runs and the first
+     * STATIC system font wins (variable fonts are skipped), bundled if none.
+     */
+    useSystemFonts?: boolean;
+    /**
+     * Skip the probe; go straight to the bundled DejaVu pair. Implied by
      * `NOWLINE_HEADLESS=1` and by `CI=true` without a TTY (unless
-     * `disableAutoHeadless` is set).
+     * `disableAutoHeadless` is set). Largely redundant now that bundled is the
+     * default, but retained so an explicit `--headless` still forces bundled
+     * even alongside `useSystemFonts`.
      */
     headless?: boolean;
     /** Disable the CI-no-TTY auto-headless heuristic. Defaults to false. */
@@ -22,11 +31,20 @@ export interface ResolveResult {
     sans: ResolvedFont;
     mono: ResolvedFont;
     /**
-     * True when EITHER role landed at step 5 without explicit `--headless`.
-     * Callers (CLI) emit a `--strict` warning on this.
+     * True when a role landed on bundled DejaVu *after an opted-in probe found
+     * nothing usable* (`useSystemFonts` set, no static system font present).
+     * The bundled-first default is the intended path, not a fallback, so it
+     * does NOT set this. Callers (CLI) emit a `--strict` warning on this.
      */
     sansFellBackToBundled: boolean;
     monoFellBackToBundled: boolean;
+    /**
+     * True when an explicitly requested font (flag / env / alias) was a
+     * variable font and was replaced by the bundled DejaVu (raster cannot
+     * render a VF). Callers warn; the CLI errors under `--strict`.
+     */
+    sansVariableFontSubstituted: boolean;
+    monoVariableFontSubstituted: boolean;
 }
 export declare function resolveFonts(options?: ResolveOptions): Promise<ResolveResult>;
 export declare class FontResolveError extends Error {

package/dist/fonts/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/fonts/resolve.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAwB,YAAY,EAAE,MAAM,aAAa,CAAC;AAKtE,MAAM,WAAW,cAAc;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACpC,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB;;;OAGG;IACH,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;CAClC;AAED,wBAAsB,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAgCvF;AAyID,qBAAa,gBAAiB,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI9B"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/fonts/resolve.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAwB,YAAY,EAAE,MAAM,aAAa,CAAC;AAUtE,MAAM,WAAW,cAAc;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACpC,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB;;;;;OAKG;IACH,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,2BAA2B,EAAE,OAAO,CAAC;IACrC,2BAA2B,EAAE,OAAO,CAAC;CACxC;AAED,wBAAsB,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAqCvF;AA6KD,qBAAa,gBAAiB,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI9B"}

package/dist/fonts/resolve.js

@@ -1,18 +1,32 @@
-// 5-step font resolver shared by PDF and PNG.
+// Bundled-first font resolver shared by PDF and PNG.
 //
-// Spec: specs/handoffs/m2c.md § 10 "Font strategy — system first, one
-// bundled headless fallback".
+// Spec: specs/handoffs/m2c.md § 10 "Font strategy — bundled first, system
+// fonts opt-in".
+//
+// The resolver defaults to the bundled static DejaVu pair on every OS so that
+// preview and raster export look identical everywhere and we never hand
+// `@resvg/resvg-wasm` a variable font (which it cannot rasterize — see
+// `sfns.ts`). System fonts are an explicit opt-in.
 //
 // Resolution order (run independently for sans / mono — first hit wins):
 //   1. Explicit flag    — `--font-sans <path|alias>` / `--font-mono <path|alias>`
 //   2. Environment      — NOWLINE_FONT_SANS / NOWLINE_FONT_MONO
-//   3. Headless override — `--headless`, NOWLINE_HEADLESS=1, or auto in CI
-//                          without a TTY
-//   4. Platform probe   — first existing entry from `probe-list.ts`
-//   5. Bundled fallback — DejaVuSans.ttf / DejaVuSansMono.ttf
+//   3. Headless / default — `--headless`, NOWLINE_HEADLESS=1, auto in CI
+//                          without a TTY, OR the plain default (no
+//                          `useSystemFonts`): bundled DejaVu pair, no probe.
+//   4. Platform probe   — opt-in via `useSystemFonts`; first existing STATIC
+//                          entry from `probe-list.ts` (variable fonts skipped).
+//   5. Bundled fallback — DejaVuSans.ttf / DejaVuSansMono.ttf (after an
+//                          opted-in probe found nothing usable).
+//
+// Variable-font guard: an explicitly requested font (flag/env/alias) that
+// turns out to be a variable font is substituted with the bundled DejaVu and
+// flagged (`*VariableFontSubstituted`), because raster export cannot render a
+// VF and there is no runtime instancer. On the opt-in probe path, variable
+// candidates are skipped in favor of the next static system font.
 import { existsSync as defaultExistsSync, promises as fs } from 'node:fs';
 import * as path from 'node:path';
-import { loadBundledMono, loadBundledSans } from './bundled.js';
+import { BUNDLED_MONO_FAMILY, BUNDLED_SANS_FAMILY, loadBundledMono, loadBundledSans, } from './bundled.js';
 import { aliasCandidate, isAlias, probeListFor } from './probe-list.js';
 import { isVariableFontBytes } from './sfns.js';
 export async function resolveFonts(options = {}) {
@@ -22,11 +36,13 @@ export async function resolveFonts(options = {}) {
     const readFileBytes = options.readFileBytes ?? defaultReadFileBytes;
     const probe = probeListFor(platform, env);
     const headlessRequested = isHeadlessRequested(options, env);
+    const useSystemFonts = options.useSystemFonts ?? false;
     const sans = await resolveRole({
         role: 'sans',
         flag: options.fontSans,
         envValue: env.NOWLINE_FONT_SANS,
         headless: headlessRequested,
+        useSystemFonts,
         probe,
         fileExists,
         readFileBytes,
@@ -36,15 +52,18 @@ export async function resolveFonts(options = {}) {
         flag: options.fontMono,
         envValue: env.NOWLINE_FONT_MONO,
         headless: headlessRequested,
+        useSystemFonts,
         probe,
         fileExists,
         readFileBytes,
     });
     return {
-        sans,
-        mono,
-        sansFellBackToBundled: sans.source === 'bundled' && !headlessRequested,
-        monoFellBackToBundled: mono.source === 'bundled' && !headlessRequested,
+        sans: sans.font,
+        mono: mono.font,
+        sansFellBackToBundled: sans.fellBack,
+        monoFellBackToBundled: mono.fellBack,
+        sansVariableFontSubstituted: sans.variableSubstituted,
+        monoVariableFontSubstituted: mono.variableSubstituted,
     };
 }
 function isHeadlessRequested(options, env) {
@@ -61,30 +80,58 @@ function isHeadlessRequested(options, env) {
 async function resolveRole(args) {
     // Step 1 — flag (path or alias)
     if (args.flag) {
-        return loadFlag(args.flag, args.role, 'flag', args);
+        return guardExplicit(await loadFlag(args.flag, args.role, 'flag', args), args);
     }
     // Step 2 — environment
     if (args.envValue) {
-        return loadFlag(args.envValue, args.role, 'env', args);
+        return guardExplicit(await loadFlag(args.envValue, args.role, 'env', args), args);
     }
-    // Step 3 — headless: skip probe, go to bundled
+    // Step 3 — explicit headless: skip probe, go to bundled.
     if (args.headless) {
-        return loadBundled(args.role, 'headless');
+        const font = await loadBundled(args.role, 'headless');
+        return { font, fellBack: false, variableSubstituted: false };
     }
-    // Step 4 — platform probe
+    // Step 3 (default) — bundled-first: with no explicit system opt-in the
+    // default is the bundled DejaVu pair on every OS. This is the intended
+    // path (not a fallback), so it does not set `fellBack`.
+    if (!args.useSystemFonts) {
+        const font = await loadBundled(args.role, 'bundled');
+        return { font, fellBack: false, variableSubstituted: false };
+    }
+    // Step 4 — platform probe (opt-in). Skip variable candidates so we land on
+    // the next STATIC system font (resvg/raster cannot render a VF).
     for (const candidate of args.probe[args.role]) {
-        if (args.fileExists(candidate.path)) {
-            const bytes = await args.readFileBytes(candidate.path);
-            return decorate(bytes, {
+        if (!args.fileExists(candidate.path))
+            continue;
+        const bytes = await args.readFileBytes(candidate.path);
+        if (isVariableFontBytes(bytes))
+            continue;
+        return {
+            font: decorate(bytes, {
                 name: candidate.name,
                 source: 'probe',
                 path: candidate.path,
                 face: candidate.face,
-            });
-        }
+            }),
+            fellBack: false,
+            variableSubstituted: false,
+        };
+    }
+    // Step 5 — bundled fallback after an opted-in probe found nothing usable.
+    const font = await loadBundled(args.role, 'bundled');
+    return { font, fellBack: true, variableSubstituted: false };
+}
+/**
+ * Guard an explicitly resolved font (flag / env / alias). A variable font
+ * cannot be rasterized and we have no runtime instancer, so substitute the
+ * bundled DejaVu and flag it; the caller decides whether to warn or error.
+ */
+async function guardExplicit(font, args) {
+    if (font.isVariableFont) {
+        const bundled = await loadBundled(args.role, 'bundled');
+        return { font: bundled, fellBack: false, variableSubstituted: true };
     }
-    // Step 5 — bundled fallback
-    return loadBundled(args.role, 'bundled');
+    return { font, fellBack: false, variableSubstituted: false };
 }
 async function loadFlag(raw, role, source, args) {
     if (path.isAbsolute(raw) ||
@@ -128,7 +175,7 @@ async function loadFlag(raw, role, source, args) {
 async function loadBundled(role, source) {
     const bytes = role === 'sans' ? await loadBundledSans() : await loadBundledMono();
     return decorate(bytes, {
-        name: role === 'sans' ? 'DejaVu Sans' : 'DejaVu Sans Mono',
+        name: role === 'sans' ? BUNDLED_SANS_FAMILY : BUNDLED_MONO_FAMILY,
         source,
     });
 }

package/dist/fonts/resolve.js.map

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

package/dist/fonts/sfns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sfns.d.ts","sourceRoot":"","sources":["../../src/fonts/sfns.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAkB9D"}
+{"version":3,"file":"sfns.d.ts","sourceRoot":"","sources":["../../src/fonts/sfns.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAkB9D"}

package/dist/fonts/sfns.js

@@ -1,11 +1,13 @@
-// SF Pro variable-font handling.
+// Variable-font detection.
 //
-// Spec: specs/handoffs/m2c.md § 10 "Variable-font handling (SFNS.ttf)".
+// Spec: specs/handoffs/m2c.md § 10 "Font strategy — bundled first, system
+// fonts opt-in".
 //
-// Detection only — actual VF instancing for PDF embedding lives in
-// @nowline/export-pdf, which depends on fontkit directly. The resolver
-// surfaces `isVariableFont: true` so consumers know they may need to
-// pre-instance.
+// Detection only — the resolver uses this to guard explicit VF requests
+// (substituting the bundled DejaVu and setting `variableSubstituted`) and to
+// skip VF candidates on the opt-in system-font probe. There is no runtime
+// instancer; any VF that reaches export would rasterize as blank in
+// `@resvg/resvg-wasm`.
 const FVAR_TAG = 0x66766172; // 'fvar'
 /**
  * Returns true when the given TTF/OTF byte buffer carries an `fvar` table —

package/dist/fonts/sfns.js.map

@@ -1 +1 @@
-{"version":3,"file":"sfns.js","sourceRoot":"","sources":["../../src/fonts/sfns.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,wEAAwE;AACxE,EAAE;AACF,mEAAmE;AACnE,uEAAuE;AACvE,qEAAqE;AACrE,gBAAgB;AAEhB,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,SAAS;AAEtC;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAiB;IACjD,IAAI,KAAK,CAAC,UAAU,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACtC,uEAAuE;IACvE,MAAM,MAAM,GAAG,WAAW,KAAK,UAAU,IAAI,WAAW,KAAK,UAAU,CAAC;IACxE,MAAM,YAAY,GAAG,WAAW,KAAK,UAAU,CAAC,CAAC,8BAA8B;IAC/E,IAAI,CAAC,MAAM,IAAI,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,YAAY;QAAE,OAAO,KAAK,CAAC,CAAC,gDAAgD;IAEhF,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;QACjC,IAAI,YAAY,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACzC,IAAI,GAAG,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC"}
+{"version":3,"file":"sfns.js","sourceRoot":"","sources":["../../src/fonts/sfns.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,EAAE;AACF,0EAA0E;AAC1E,iBAAiB;AACjB,EAAE;AACF,wEAAwE;AACxE,6EAA6E;AAC7E,0EAA0E;AAC1E,oEAAoE;AACpE,uBAAuB;AAEvB,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,SAAS;AAEtC;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAiB;IACjD,IAAI,KAAK,CAAC,UAAU,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACtC,uEAAuE;IACvE,MAAM,MAAM,GAAG,WAAW,KAAK,UAAU,IAAI,WAAW,KAAK,UAAU,CAAC;IACxE,MAAM,YAAY,GAAG,WAAW,KAAK,UAAU,CAAC,CAAC,8BAA8B;IAC/E,IAAI,CAAC,MAAM,IAAI,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,YAAY;QAAE,OAAO,KAAK,CAAC,CAAC,gDAAgD;IAEhF,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;QACjC,IAAI,YAAY,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACzC,IAAI,GAAG,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { displayLabel, getProp, getProps, hasProp, type PropertyHost, roadmapTitle, } from './ast-helpers.js';
-export { BUNDLED_MONO_PATH, BUNDLED_SANS_PATH, clearBundledCache, loadBundledMono, loadBundledSans, } from './fonts/bundled.js';
+export { _clearBrowserFontsCache, loadBundledFontsForBrowser } from './fonts/browser.js';
+export { BUNDLED_MONO_FAMILY, BUNDLED_MONO_PATH, BUNDLED_SANS_FAMILY, BUNDLED_SANS_PATH, clearBundledCache, loadBundledMono, loadBundledSans, } from './fonts/bundled.js';
 export { ALIASES, aliasCandidate, type FontCandidate, isAlias, type PlatformProbe, probeListFor, } from './fonts/probe-list.js';
 export { FontResolveError, type ResolveOptions, type ResolveResult, resolveFonts, } from './fonts/resolve.js';
 export { isVariableFontBytes } from './fonts/sfns.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,OAAO,EACP,KAAK,YAAY,EACjB,YAAY,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,OAAO,EACP,cAAc,EACd,KAAK,aAAa,EAClB,OAAO,EACP,KAAK,aAAa,EAClB,YAAY,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACH,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,YAAY,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EACH,KAAK,YAAY,EACjB,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,KAAK,YAAY,EACjB,WAAW,EACX,cAAc,GACjB,MAAM,eAAe,CAAC;AACvB,YAAY,EACR,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,YAAY,EACZ,gBAAgB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,cAAc,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,OAAO,EACP,KAAK,YAAY,EACjB,YAAY,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EACH,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,OAAO,EACP,cAAc,EACd,KAAK,aAAa,EAClB,OAAO,EACP,KAAK,aAAa,EAClB,YAAY,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACH,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,YAAY,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EACH,KAAK,YAAY,EACjB,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,KAAK,YAAY,EACjB,WAAW,EACX,cAAc,GACjB,MAAM,eAAe,CAAC;AACvB,YAAY,EACR,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,YAAY,EACZ,gBAAgB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,cAAc,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export { displayLabel, getProp, getProps, hasProp, roadmapTitle, } from './ast-helpers.js';
-export { BUNDLED_MONO_PATH, BUNDLED_SANS_PATH, clearBundledCache, loadBundledMono, loadBundledSans, } from './fonts/bundled.js';
+export { _clearBrowserFontsCache, loadBundledFontsForBrowser } from './fonts/browser.js';
+export { BUNDLED_MONO_FAMILY, BUNDLED_MONO_PATH, BUNDLED_SANS_FAMILY, BUNDLED_SANS_PATH, clearBundledCache, loadBundledMono, loadBundledSans, } from './fonts/bundled.js';
 export { ALIASES, aliasCandidate, isAlias, probeListFor, } from './fonts/probe-list.js';
 export { FontResolveError, resolveFonts, } from './fonts/resolve.js';
 export { isVariableFontBytes } from './fonts/sfns.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,OAAO,EAEP,YAAY,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,OAAO,EACP,cAAc,EAEd,OAAO,EAEP,YAAY,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACH,gBAAgB,EAGhB,YAAY,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAEH,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,WAAW,EAEX,WAAW,EACX,cAAc,GACjB,MAAM,eAAe,CAAC;AAavB,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,cAAc,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,OAAO,EAEP,YAAY,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EACH,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,OAAO,EACP,cAAc,EAEd,OAAO,EAEP,YAAY,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACH,gBAAgB,EAGhB,YAAY,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAEH,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,WAAW,EAEX,WAAW,EACX,cAAc,GACjB,MAAM,eAAe,CAAC;AAavB,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,cAAc,GACjB,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nowline/export-core",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Nowline export-core — shared types, font resolver, unit converter, PDF page-size types",
   "license": "Apache-2.0",
   "engines": {
@@ -34,8 +34,8 @@
     "assets/"
   ],
   "dependencies": {
-    "@nowline/core": "0.5.0",
-    "@nowline/layout": "0.5.0"
+    "@nowline/core": "0.6.0",
+    "@nowline/layout": "0.6.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",

package/src/fonts/browser.ts

@@ -0,0 +1,47 @@
+// Browser-compatible bundled font loader.
+//
+// Same bundled DejaVu bytes as loadBundledSans/loadBundledMono (Node), but
+// decoded with `atob()` instead of Node's `Buffer.from()` so the module
+// bundles cleanly for the browser (the Free/Pro web apps, Playwright legs).
+//
+// Usage: `loadBundledFontsForBrowser()` returns a cached `ResolvedFontPair`
+// synchronously after the first call. Call it once at module init or lazy-once
+// inside your `loadWasm` / font-loading step.
+//
+// Node callers: use `loadBundledSans()` / `loadBundledMono()` from bundled.ts.
+
+import { MONO_BASE64, SANS_BASE64 } from '../generated/bundled-fonts.js';
+import type { ResolvedFontPair } from '../types.js';
+
+function b64ToBytes(b64: string): Uint8Array {
+    const binary = atob(b64);
+    const out = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) out[i] = binary.charCodeAt(i);
+    return out;
+}
+
+let cachedFonts: ResolvedFontPair | undefined;
+
+/**
+ * Return the canonical bundled DejaVu font pair decoded with browser-compatible
+ * APIs (`atob`). Result is cached after the first call so the ~1 MB decode only
+ * runs once per page. Safe to call before wasm initialization.
+ */
+export function loadBundledFontsForBrowser(): ResolvedFontPair {
+    if (!cachedFonts) {
+        cachedFonts = {
+            sans: { name: 'DejaVu Sans', bytes: b64ToBytes(SANS_BASE64), source: 'bundled' },
+            mono: {
+                name: 'DejaVu Sans Mono',
+                bytes: b64ToBytes(MONO_BASE64),
+                source: 'bundled',
+            },
+        };
+    }
+    return cachedFonts;
+}
+
+/** Test seam: drop the cached pair so isolated tests start fresh. */
+export function _clearBrowserFontsCache(): void {
+    cachedFonts = undefined;
+}

package/src/fonts/bundled.ts

@@ -19,11 +19,26 @@ import { fileURLToPath } from 'node:url';
 
 import { MONO_BASE64, SANS_BASE64 } from '../generated/bundled-fonts.js';
 
-const HERE = path.dirname(fileURLToPath(import.meta.url));
+// Resolve the on-disk assets/fonts directory from this module's location.
+// `import.meta.url` is rewritten to `undefined` when this module is bundled
+// into a CommonJS context — esbuild collapses `import.meta` to `{}` for the VS
+// Code extension's `dist/extension.cjs`. The two exported paths below are
+// informational only (the runtime decodes the embedded base64 above, never
+// reads these files), so degrade to a bare relative directory instead of
+// throwing `ERR_INVALID_ARG_TYPE` at module load — which would crash the
+// extension before it can activate. See packages/vscode-extension.
+function bundledFontsDir(): string {
+    try {
+        // dist/fonts/bundled.js → ../../assets/fonts/
+        //   src/fonts/bundled.ts → ../../assets/fonts/
+        const here = path.dirname(fileURLToPath(import.meta.url));
+        return path.resolve(here, '..', '..', 'assets', 'fonts');
+    } catch {
+        return path.join('assets', 'fonts');
+    }
+}
 
-// dist/fonts/bundled.js → ../../assets/fonts/
-//   src/fonts/bundled.ts → ../../assets/fonts/
-const ASSETS_DIR = path.resolve(HERE, '..', '..', 'assets', 'fonts');
+const ASSETS_DIR = bundledFontsDir();
 
 // Informational: where the source-of-truth TTFs live on disk for users
 // running under Node. Not the runtime load source — `loadBundledSans` and
@@ -32,6 +47,15 @@ const ASSETS_DIR = path.resolve(HERE, '..', '..', 'assets', 'fonts');
 export const BUNDLED_SANS_PATH = path.join(ASSETS_DIR, 'DejaVuSans.ttf');
 export const BUNDLED_MONO_PATH = path.join(ASSETS_DIR, 'DejaVuSansMono.ttf');
 
+/**
+ * Family names stamped on the bundled DejaVu faces. The resolver's
+ * `ResolvedFont.name`, the renderer's pinned `font-family`, the resvg family
+ * hints, and the live-preview `@font-face` must all use these exact strings
+ * so preview and raster export name the same face (the WYSIWYG contract).
+ */
+export const BUNDLED_SANS_FAMILY = 'DejaVu Sans';
+export const BUNDLED_MONO_FAMILY = 'DejaVu Sans Mono';
+
 let cachedSans: Uint8Array | undefined;
 let cachedMono: Uint8Array | undefined;
 

package/src/fonts/index.ts

@@ -1,3 +1,4 @@
+export { _clearBrowserFontsCache, loadBundledFontsForBrowser } from './browser.js';
 export {
     BUNDLED_MONO_PATH,
     BUNDLED_SANS_PATH,

package/src/fonts/resolve.ts

@@ -1,21 +1,40 @@
-// 5-step font resolver shared by PDF and PNG.
+// Bundled-first font resolver shared by PDF and PNG.
 //
-// Spec: specs/handoffs/m2c.md § 10 "Font strategy — system first, one
-// bundled headless fallback".
+// Spec: specs/handoffs/m2c.md § 10 "Font strategy — bundled first, system
+// fonts opt-in".
+//
+// The resolver defaults to the bundled static DejaVu pair on every OS so that
+// preview and raster export look identical everywhere and we never hand
+// `@resvg/resvg-wasm` a variable font (which it cannot rasterize — see
+// `sfns.ts`). System fonts are an explicit opt-in.
 //
 // Resolution order (run independently for sans / mono — first hit wins):
 //   1. Explicit flag    — `--font-sans <path|alias>` / `--font-mono <path|alias>`
 //   2. Environment      — NOWLINE_FONT_SANS / NOWLINE_FONT_MONO
-//   3. Headless override — `--headless`, NOWLINE_HEADLESS=1, or auto in CI
-//                          without a TTY
-//   4. Platform probe   — first existing entry from `probe-list.ts`
-//   5. Bundled fallback — DejaVuSans.ttf / DejaVuSansMono.ttf
+//   3. Headless / default — `--headless`, NOWLINE_HEADLESS=1, auto in CI
+//                          without a TTY, OR the plain default (no
+//                          `useSystemFonts`): bundled DejaVu pair, no probe.
+//   4. Platform probe   — opt-in via `useSystemFonts`; first existing STATIC
+//                          entry from `probe-list.ts` (variable fonts skipped).
+//   5. Bundled fallback — DejaVuSans.ttf / DejaVuSansMono.ttf (after an
+//                          opted-in probe found nothing usable).
+//
+// Variable-font guard: an explicitly requested font (flag/env/alias) that
+// turns out to be a variable font is substituted with the bundled DejaVu and
+// flagged (`*VariableFontSubstituted`), because raster export cannot render a
+// VF and there is no runtime instancer. On the opt-in probe path, variable
+// candidates are skipped in favor of the next static system font.
 
 import { existsSync as defaultExistsSync, promises as fs } from 'node:fs';
 import * as path from 'node:path';
 
 import type { FontRole, FontSource, ResolvedFont } from '../types.js';
-import { loadBundledMono, loadBundledSans } from './bundled.js';
+import {
+    BUNDLED_MONO_FAMILY,
+    BUNDLED_SANS_FAMILY,
+    loadBundledMono,
+    loadBundledSans,
+} from './bundled.js';
 import { aliasCandidate, isAlias, type PlatformProbe, probeListFor } from './probe-list.js';
 import { isVariableFontBytes } from './sfns.js';
 
@@ -25,9 +44,18 @@ export interface ResolveOptions {
     /** Path or alias for the mono role. */
     fontMono?: string;
     /**
-     * Skip steps 4–5; go straight to step 5 (bundled DejaVu pair). Implied by
+     * Opt in to the platform font probe (step 4). Off by default: the
+     * resolver is bundled-first, so the default (no flag/env) is the bundled
+     * DejaVu pair on every OS. With this set the probe runs and the first
+     * STATIC system font wins (variable fonts are skipped), bundled if none.
+     */
+    useSystemFonts?: boolean;
+    /**
+     * Skip the probe; go straight to the bundled DejaVu pair. Implied by
      * `NOWLINE_HEADLESS=1` and by `CI=true` without a TTY (unless
-     * `disableAutoHeadless` is set).
+     * `disableAutoHeadless` is set). Largely redundant now that bundled is the
+     * default, but retained so an explicit `--headless` still forces bundled
+     * even alongside `useSystemFonts`.
      */
     headless?: boolean;
     /** Disable the CI-no-TTY auto-headless heuristic. Defaults to false. */
@@ -44,11 +72,20 @@ export interface ResolveResult {
     sans: ResolvedFont;
     mono: ResolvedFont;
     /**
-     * True when EITHER role landed at step 5 without explicit `--headless`.
-     * Callers (CLI) emit a `--strict` warning on this.
+     * True when a role landed on bundled DejaVu *after an opted-in probe found
+     * nothing usable* (`useSystemFonts` set, no static system font present).
+     * The bundled-first default is the intended path, not a fallback, so it
+     * does NOT set this. Callers (CLI) emit a `--strict` warning on this.
      */
     sansFellBackToBundled: boolean;
     monoFellBackToBundled: boolean;
+    /**
+     * True when an explicitly requested font (flag / env / alias) was a
+     * variable font and was replaced by the bundled DejaVu (raster cannot
+     * render a VF). Callers warn; the CLI errors under `--strict`.
+     */
+    sansVariableFontSubstituted: boolean;
+    monoVariableFontSubstituted: boolean;
 }
 
 export async function resolveFonts(options: ResolveOptions = {}): Promise<ResolveResult> {
@@ -59,11 +96,13 @@ export async function resolveFonts(options: ResolveOptions = {}): Promise<Resolv
     const probe = probeListFor(platform, env);
 
     const headlessRequested = isHeadlessRequested(options, env);
+    const useSystemFonts = options.useSystemFonts ?? false;
     const sans = await resolveRole({
         role: 'sans',
         flag: options.fontSans,
         envValue: env.NOWLINE_FONT_SANS,
         headless: headlessRequested,
+        useSystemFonts,
         probe,
         fileExists,
         readFileBytes,
@@ -73,15 +112,18 @@ export async function resolveFonts(options: ResolveOptions = {}): Promise<Resolv
         flag: options.fontMono,
         envValue: env.NOWLINE_FONT_MONO,
         headless: headlessRequested,
+        useSystemFonts,
         probe,
         fileExists,
         readFileBytes,
     });
     return {
-        sans,
-        mono,
-        sansFellBackToBundled: sans.source === 'bundled' && !headlessRequested,
-        monoFellBackToBundled: mono.source === 'bundled' && !headlessRequested,
+        sans: sans.font,
+        mono: mono.font,
+        sansFellBackToBundled: sans.fellBack,
+        monoFellBackToBundled: mono.fellBack,
+        sansVariableFontSubstituted: sans.variableSubstituted,
+        monoVariableFontSubstituted: mono.variableSubstituted,
     };
 }
 
@@ -99,38 +141,74 @@ interface RoleArgs {
     flag?: string;
     envValue?: string;
     headless: boolean;
+    useSystemFonts: boolean;
     probe: PlatformProbe;
     fileExists: (p: string) => boolean;
     readFileBytes: (p: string) => Promise<Uint8Array>;
 }
 
-async function resolveRole(args: RoleArgs): Promise<ResolvedFont> {
+interface RoleResolution {
+    font: ResolvedFont;
+    /** Bundled because an opted-in probe found no usable system font. */
+    fellBack: boolean;
+    /** An explicit VF request was replaced by the bundled DejaVu. */
+    variableSubstituted: boolean;
+}
+
+async function resolveRole(args: RoleArgs): Promise<RoleResolution> {
     // Step 1 — flag (path or alias)
     if (args.flag) {
-        return loadFlag(args.flag, args.role, 'flag', args);
+        return guardExplicit(await loadFlag(args.flag, args.role, 'flag', args), args);
     }
     // Step 2 — environment
     if (args.envValue) {
-        return loadFlag(args.envValue, args.role, 'env', args);
+        return guardExplicit(await loadFlag(args.envValue, args.role, 'env', args), args);
     }
-    // Step 3 — headless: skip probe, go to bundled
+    // Step 3 — explicit headless: skip probe, go to bundled.
     if (args.headless) {
-        return loadBundled(args.role, 'headless');
+        const font = await loadBundled(args.role, 'headless');
+        return { font, fellBack: false, variableSubstituted: false };
+    }
+    // Step 3 (default) — bundled-first: with no explicit system opt-in the
+    // default is the bundled DejaVu pair on every OS. This is the intended
+    // path (not a fallback), so it does not set `fellBack`.
+    if (!args.useSystemFonts) {
+        const font = await loadBundled(args.role, 'bundled');
+        return { font, fellBack: false, variableSubstituted: false };
     }
-    // Step 4 — platform probe
+    // Step 4 — platform probe (opt-in). Skip variable candidates so we land on
+    // the next STATIC system font (resvg/raster cannot render a VF).
     for (const candidate of args.probe[args.role]) {
-        if (args.fileExists(candidate.path)) {
-            const bytes = await args.readFileBytes(candidate.path);
-            return decorate(bytes, {
+        if (!args.fileExists(candidate.path)) continue;
+        const bytes = await args.readFileBytes(candidate.path);
+        if (isVariableFontBytes(bytes)) continue;
+        return {
+            font: decorate(bytes, {
                 name: candidate.name,
                 source: 'probe',
                 path: candidate.path,
                 face: candidate.face,
-            });
-        }
+            }),
+            fellBack: false,
+            variableSubstituted: false,
+        };
+    }
+    // Step 5 — bundled fallback after an opted-in probe found nothing usable.
+    const font = await loadBundled(args.role, 'bundled');
+    return { font, fellBack: true, variableSubstituted: false };
+}
+
+/**
+ * Guard an explicitly resolved font (flag / env / alias). A variable font
+ * cannot be rasterized and we have no runtime instancer, so substitute the
+ * bundled DejaVu and flag it; the caller decides whether to warn or error.
+ */
+async function guardExplicit(font: ResolvedFont, args: RoleArgs): Promise<RoleResolution> {
+    if (font.isVariableFont) {
+        const bundled = await loadBundled(args.role, 'bundled');
+        return { font: bundled, fellBack: false, variableSubstituted: true };
     }
-    // Step 5 — bundled fallback
-    return loadBundled(args.role, 'bundled');
+    return { font, fellBack: false, variableSubstituted: false };
 }
 
 async function loadFlag(
@@ -187,7 +265,7 @@ async function loadFlag(
 async function loadBundled(role: FontRole, source: FontSource): Promise<ResolvedFont> {
     const bytes = role === 'sans' ? await loadBundledSans() : await loadBundledMono();
     return decorate(bytes, {
-        name: role === 'sans' ? 'DejaVu Sans' : 'DejaVu Sans Mono',
+        name: role === 'sans' ? BUNDLED_SANS_FAMILY : BUNDLED_MONO_FAMILY,
         source,
     });
 }

package/src/fonts/sfns.ts

@@ -1,11 +1,13 @@
-// SF Pro variable-font handling.
+// Variable-font detection.
 //
-// Spec: specs/handoffs/m2c.md § 10 "Variable-font handling (SFNS.ttf)".
+// Spec: specs/handoffs/m2c.md § 10 "Font strategy — bundled first, system
+// fonts opt-in".
 //
-// Detection only — actual VF instancing for PDF embedding lives in
-// @nowline/export-pdf, which depends on fontkit directly. The resolver
-// surfaces `isVariableFont: true` so consumers know they may need to
-// pre-instance.
+// Detection only — the resolver uses this to guard explicit VF requests
+// (substituting the bundled DejaVu and setting `variableSubstituted`) and to
+// skip VF candidates on the opt-in system-font probe. There is no runtime
+// instancer; any VF that reaches export would rasterize as blank in
+// `@resvg/resvg-wasm`.
 
 const FVAR_TAG = 0x66766172; // 'fvar'
 

package/src/index.ts

@@ -6,8 +6,11 @@ export {
     type PropertyHost,
     roadmapTitle,
 } from './ast-helpers.js';
+export { _clearBrowserFontsCache, loadBundledFontsForBrowser } from './fonts/browser.js';
 export {
+    BUNDLED_MONO_FAMILY,
     BUNDLED_MONO_PATH,
+    BUNDLED_SANS_FAMILY,
     BUNDLED_SANS_PATH,
     clearBundledCache,
     loadBundledMono,