@faicad/faijs 0.22.2 → 0.29.3

package/dist/node-host/font-family-index.d.ts

@@ -0,0 +1,93 @@
+/**
+ * System-font family index (Node host only).
+ *
+ * CadQuery resolves `font="Arial"` through OCC's `Font_FontMgr`, which consults
+ * the operating system's installed fonts. faijs has no such service, so a
+ * name-based `font=` cannot be honoured unless the *host* provides one. This
+ * module is that provider for the Node host: it walks the OS font directories
+ * and maps a normalised family name to the font file, so
+ * `NodeFontProvider.resolveFont('Arial')` can return the bytes.
+ *
+ * Design notes
+ * ------------
+ * - **Only the `name` table is read.** Parsing a font with opentype.js costs
+ *   milliseconds; a system font directory holds hundreds to thousands of files,
+ *   so a full parse per file would add seconds to every first text call. The
+ *   `name` table sits a few hundred bytes into the file, so a small `readSync`
+ *   per file is enough.
+ * - **`.ttc`/`.woff`/`.woff2` are skipped**: TrueType collections need a
+ *   per-face offset table and the WOFF formats are compressed — neither is a
+ *   plain `name` table read.
+ * - Nothing here runs unless a caller explicitly asks for a font *by name*;
+ *   the bundled default font stays the single source of truth for `default`.
+ */
+/** Names of one font file. */
+export interface FontFileNames {
+    /** Typographic family (name ID 16) when present, else family (name ID 1). */
+    family: string;
+    /** Subfamily (name ID 17 when present, else name ID 2), e.g. "Regular". */
+    subfamily: string;
+}
+/**
+ * Normalise a font name for matching: lower-case, letters/digits only.
+ *
+ * `"DejaVu Sans"`, `"DejaVuSans"` and `"dejavu-sans"` all collapse to
+ * `"dejavusans"`, which is what makes file-name based keys and real family
+ * names interchangeable.
+ *
+ * @param name - raw font name
+ * @returns the normalised comparison key
+ */
+export declare function normalizeFontName(name: string): string;
+/**
+ * Parse a `name` table that starts at `base` inside `buf`.
+ *
+ * Windows (platform 3) and Unicode (platform 0) records are UTF-16BE; Macintosh
+ * (platform 1) records are single-byte. Windows/en records win when a name is
+ * present more than once. Typographic names (16/17) win over legacy (1/2).
+ *
+ * @param buf - buffer containing the table
+ * @param base - offset of the table inside `buf`
+ * @returns the names, or null when the table is unreadable
+ */
+export declare function parseNameTable(buf: Buffer, base: number): FontFileNames | null;
+/**
+ * Read the family/subfamily names out of a complete font file buffer.
+ *
+ * @param buf - the whole font file
+ * @returns the names, or null when the file has no readable `name` table
+ */
+export declare function readFontFileNames(buf: Buffer): FontFileNames | null;
+/** Locate a font file whose `name` table names it `family`. */
+export interface FontFamilyMatch {
+    /** Absolute path of the best (Regular-preferred) file for the family. */
+    path: string;
+}
+/**
+ * The OS font directories to scan, in search order (Windows / macOS / Linux).
+ *
+ * @returns the platform's standard font directories present in the environment,
+ *   with unavailable ones filtered out (may be empty on a stripped-down host)
+ */
+export declare function defaultSystemFontDirs(): string[];
+/** normalized family name -> best file path found so far. */
+export type FontFamilyIndex = Map<string, string>;
+/**
+ * Build a normalised-family → file-path index for the given directories.
+ *
+ * When a family has several files (Regular/Bold/Italic…), the Regular one wins;
+ * otherwise the first file seen is kept. Also indexes each file's *file stem*,
+ * so a host pointed at a bare directory of renamed files still resolves them.
+ *
+ * @param dirs - font directories to scan (missing directories are skipped)
+ * @returns the index (empty when nothing readable was found)
+ */
+export declare function buildFontFamilyIndex(dirs: readonly string[]): FontFamilyIndex;
+/**
+ * PATH-style helper: split a user-supplied directory list.
+ *
+ * @param dirs - a path-delimiter-separated directory list (`;` on Windows, `:` elsewhere)
+ * @returns the non-empty entries, in the order given
+ */
+export declare function splitDirList(dirs: string): string[];
+//# sourceMappingURL=font-family-index.d.ts.map

package/dist/node-host/font-family-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-family-index.d.ts","sourceRoot":"","sources":["../../src/node-host/font-family-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAWH,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAA;IACd,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAkCD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAyC9E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAInE;AA6BD,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAwBhD;AA2BD,6DAA6D;AAC7D,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEjD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAgB7E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEnD"}

package/dist/node-host/font-family-index.js

@@ -0,0 +1,273 @@
+/**
+ * System-font family index (Node host only).
+ *
+ * CadQuery resolves `font="Arial"` through OCC's `Font_FontMgr`, which consults
+ * the operating system's installed fonts. faijs has no such service, so a
+ * name-based `font=` cannot be honoured unless the *host* provides one. This
+ * module is that provider for the Node host: it walks the OS font directories
+ * and maps a normalised family name to the font file, so
+ * `NodeFontProvider.resolveFont('Arial')` can return the bytes.
+ *
+ * Design notes
+ * ------------
+ * - **Only the `name` table is read.** Parsing a font with opentype.js costs
+ *   milliseconds; a system font directory holds hundreds to thousands of files,
+ *   so a full parse per file would add seconds to every first text call. The
+ *   `name` table sits a few hundred bytes into the file, so a small `readSync`
+ *   per file is enough.
+ * - **`.ttc`/`.woff`/`.woff2` are skipped**: TrueType collections need a
+ *   per-face offset table and the WOFF formats are compressed — neither is a
+ *   plain `name` table read.
+ * - Nothing here runs unless a caller explicitly asks for a font *by name*;
+ *   the bundled default font stays the single source of truth for `default`.
+ */
+import { readdirSync, readSync, openSync, closeSync, statSync, existsSync } from 'node:fs';
+import { join, extname, delimiter } from 'node:path';
+/** A file we can index by reading its `name` table directly. */
+const INDEXABLE_EXT = new Set(['.ttf', '.otf']);
+/** sfnt version tags that start with a standard table directory. */
+const SFNT_TRUE_TYPE = 0x00010000;
+/**
+ * Normalise a font name for matching: lower-case, letters/digits only.
+ *
+ * `"DejaVu Sans"`, `"DejaVuSans"` and `"dejavu-sans"` all collapse to
+ * `"dejavusans"`, which is what makes file-name based keys and real family
+ * names interchangeable.
+ *
+ * @param name - raw font name
+ * @returns the normalised comparison key
+ */
+export function normalizeFontName(name) {
+    return name.toLowerCase().replace(/[^a-z0-9]+/g, '');
+}
+/** Decode a UTF-16BE string out of `buf` (Node has no utf16be codec). */
+function utf16beToString(buf, start, byteLength) {
+    const chars = [];
+    for (let i = 0; i + 1 < byteLength; i += 2) {
+        chars.push(String.fromCharCode(buf.readUInt16BE(start + i)));
+    }
+    return chars.join('');
+}
+/**
+ * Locate the `name` table inside a font's table directory.
+ *
+ * @param buf - buffer holding at least the sfnt header + table directory
+ * @returns the table's byte offset and length, or null for an unsupported file
+ */
+function findNameTable(buf) {
+    if (buf.length < 12)
+        return null;
+    const sfnt = buf.readUInt32BE(0);
+    const tag = buf.toString('latin1', 0, 4);
+    if (sfnt !== SFNT_TRUE_TYPE && tag !== 'OTTO' && tag !== 'true' && tag !== 'typ1')
+        return null;
+    const numTables = buf.readUInt16BE(4);
+    for (let i = 0; i < numTables; i++) {
+        const rec = 12 + i * 16;
+        if (rec + 16 > buf.length)
+            break;
+        if (buf.toString('latin1', rec, rec + 4) === 'name') {
+            return { offset: buf.readUInt32BE(rec + 8), length: buf.readUInt32BE(rec + 12) };
+        }
+    }
+    return null;
+}
+/**
+ * Parse a `name` table that starts at `base` inside `buf`.
+ *
+ * Windows (platform 3) and Unicode (platform 0) records are UTF-16BE; Macintosh
+ * (platform 1) records are single-byte. Windows/en records win when a name is
+ * present more than once. Typographic names (16/17) win over legacy (1/2).
+ *
+ * @param buf - buffer containing the table
+ * @param base - offset of the table inside `buf`
+ * @returns the names, or null when the table is unreadable
+ */
+export function parseNameTable(buf, base) {
+    if (base + 6 > buf.length)
+        return null;
+    const count = buf.readUInt16BE(base + 2);
+    const storage = base + buf.readUInt16BE(base + 4);
+    // nameID -> best (highest-priority) decoded value
+    const best = new Map();
+    for (let i = 0; i < count; i++) {
+        const rec = base + 6 + i * 12;
+        if (rec + 12 > buf.length)
+            break;
+        const platform = buf.readUInt16BE(rec);
+        const language = buf.readUInt16BE(rec + 4);
+        const nameId = buf.readUInt16BE(rec + 6);
+        const len = buf.readUInt16BE(rec + 8);
+        const off = buf.readUInt16BE(rec + 10);
+        if (len === 0 || (nameId !== 1 && nameId !== 2 && nameId !== 16 && nameId !== 17))
+            continue;
+        const start = storage + off;
+        if (start + len > buf.length)
+            continue;
+        let value = null;
+        let score = 0;
+        if (platform === 3 || platform === 0) {
+            value = utf16beToString(buf, start, len);
+            score = platform === 3 ? (language === 0x0409 ? 3 : 2) : 1;
+        }
+        else if (platform === 1) {
+            value = buf.toString('latin1', start, start + len);
+            score = 1;
+        }
+        if (value === null)
+            continue;
+        value = value.replace(/\0/g, '').trim();
+        if (!value)
+            continue;
+        const prior = best.get(nameId);
+        if (!prior || score > prior.score)
+            best.set(nameId, { score, value });
+    }
+    const family = best.get(16)?.value ?? best.get(1)?.value;
+    if (!family)
+        return null;
+    return {
+        family,
+        subfamily: best.get(17)?.value ?? best.get(2)?.value ?? '',
+    };
+}
+/**
+ * Read the family/subfamily names out of a complete font file buffer.
+ *
+ * @param buf - the whole font file
+ * @returns the names, or null when the file has no readable `name` table
+ */
+export function readFontFileNames(buf) {
+    const table = findNameTable(buf);
+    if (!table || table.offset + 6 > buf.length)
+        return null;
+    return parseNameTable(buf, table.offset);
+}
+/**
+ * Scan one font file and return its names (null when unreadable).
+ *
+ * Two-phase read: the sfnt header + table directory first, then exactly the
+ * `name` table. Reading a fixed head window is not enough — in a large font
+ * (`glyf`/`loca` are megabytes) the `name` table sits far past any small prefix
+ * (Arial's is at ~0x0F0000), which silently made the whole system index miss.
+ */
+function namesOf(path) {
+    let fd;
+    try {
+        fd = openSync(path, 'r');
+        const size = statSync(path).size;
+        const head = Buffer.alloc(Math.min(size, 4096));
+        readSync(fd, head, 0, head.length, 0);
+        const table = findNameTable(head);
+        if (!table || table.length === 0 || table.offset + table.length > size)
+            return null;
+        const tbl = Buffer.alloc(table.length);
+        readSync(fd, tbl, 0, table.length, table.offset);
+        return parseNameTable(tbl, 0);
+    }
+    catch {
+        return null;
+    }
+    finally {
+        if (fd !== undefined)
+            closeSync(fd);
+    }
+}
+/**
+ * The OS font directories to scan, in search order (Windows / macOS / Linux).
+ *
+ * @returns the platform's standard font directories present in the environment,
+ *   with unavailable ones filtered out (may be empty on a stripped-down host)
+ */
+export function defaultSystemFontDirs() {
+    const win = process.env.WINDIR || process.env.SystemRoot;
+    if (process.platform === 'win32') {
+        return [
+            win ? join(win, 'Fonts') : '',
+            process.env.LOCALAPPDATA ? join(process.env.LOCALAPPDATA, 'Microsoft', 'Windows', 'Fonts') : '',
+        ].filter(Boolean);
+    }
+    if (process.platform === 'darwin') {
+        return [
+            '/System/Library/Fonts',
+            '/Library/Fonts',
+            process.env.HOME ? join(process.env.HOME, 'Library', 'Fonts') : '',
+        ].filter(Boolean);
+    }
+    // Linux / other unix: fontconfig's usual roots.
+    const xdg = process.env.XDG_DATA_HOME;
+    return [
+        '/usr/share/fonts',
+        '/usr/local/share/fonts',
+        xdg ? join(xdg, 'fonts') : '',
+        process.env.HOME ? join(process.env.HOME, '.fonts') : '',
+        process.env.HOME ? join(process.env.HOME, '.local', 'share', 'fonts') : '',
+    ].filter(Boolean);
+}
+/** Every indexable font file under `dir`, depth-first and depth-capped. */
+function* walkFontFiles(dir, depth = 4) {
+    if (depth <= 0 || !existsSync(dir))
+        return;
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const p = join(dir, entry);
+        let st;
+        try {
+            st = statSync(p);
+        }
+        catch {
+            continue;
+        }
+        if (st.isDirectory()) {
+            yield* walkFontFiles(p, depth - 1);
+        }
+        else if (INDEXABLE_EXT.has(extname(entry).toLowerCase())) {
+            yield p;
+        }
+    }
+}
+/**
+ * Build a normalised-family → file-path index for the given directories.
+ *
+ * When a family has several files (Regular/Bold/Italic…), the Regular one wins;
+ * otherwise the first file seen is kept. Also indexes each file's *file stem*,
+ * so a host pointed at a bare directory of renamed files still resolves them.
+ *
+ * @param dirs - font directories to scan (missing directories are skipped)
+ * @returns the index (empty when nothing readable was found)
+ */
+export function buildFontFamilyIndex(dirs) {
+    const index = new Map();
+    for (const dir of dirs) {
+        for (const file of walkFontFiles(dir)) {
+            const names = namesOf(file);
+            if (!names)
+                continue;
+            const key = normalizeFontName(names.family);
+            const isRegular = normalizeFontName(names.subfamily) === 'regular';
+            if (key && (!index.has(key) || isRegular))
+                index.set(key, file);
+            // Also allow lookup by file stem ("arial" -> arial.ttf).
+            const stem = normalizeFontName(file.replace(/^.*[\\/]/, '').replace(/\.[^.]+$/, ''));
+            if (stem && !index.has(stem))
+                index.set(stem, file);
+        }
+    }
+    return index;
+}
+/**
+ * PATH-style helper: split a user-supplied directory list.
+ *
+ * @param dirs - a path-delimiter-separated directory list (`;` on Windows, `:` elsewhere)
+ * @returns the non-empty entries, in the order given
+ */
+export function splitDirList(dirs) {
+    return dirs.split(delimiter).filter(Boolean);
+}
+//# sourceMappingURL=font-family-index.js.map

package/dist/node-host/font-family-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-family-index.js","sourceRoot":"","sources":["../../src/node-host/font-family-index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * System-font family index (Node host only).\n *\n * CadQuery resolves `font=\"Arial\"` through OCC's `Font_FontMgr`, which consults\n * the operating system's installed fonts. faijs has no such service, so a\n * name-based `font=` cannot be honoured unless the *host* provides one. This\n * module is that provider for the Node host: it walks the OS font directories\n * and maps a normalised family name to the font file, so\n * `NodeFontProvider.resolveFont('Arial')` can return the bytes.\n *\n * Design notes\n * ------------\n * - **Only the `name` table is read.** Parsing a font with opentype.js costs\n *   milliseconds; a system font directory holds hundreds to thousands of files,\n *   so a full parse per file would add seconds to every first text call. The\n *   `name` table sits a few hundred bytes into the file, so a small `readSync`\n *   per file is enough.\n * - **`.ttc`/`.woff`/`.woff2` are skipped**: TrueType collections need a\n *   per-face offset table and the WOFF formats are compressed — neither is a\n *   plain `name` table read.\n * - Nothing here runs unless a caller explicitly asks for a font *by name*;\n *   the bundled default font stays the single source of truth for `default`.\n */\n\nimport { readdirSync, readSync, openSync, closeSync, statSync, existsSync } from 'node:fs'\nimport { join, extname, delimiter } from 'node:path'\n\n/** A file we can index by reading its `name` table directly. */\nconst INDEXABLE_EXT = new Set(['.ttf', '.otf'])\n\n/** sfnt version tags that start with a standard table directory. */\nconst SFNT_TRUE_TYPE = 0x00010000\n\n/** Names of one font file. */\nexport interface FontFileNames {\n  /** Typographic family (name ID 16) when present, else family (name ID 1). */\n  family: string\n  /** Subfamily (name ID 17 when present, else name ID 2), e.g. \"Regular\". */\n  subfamily: string\n}\n\n/**\n * Normalise a font name for matching: lower-case, letters/digits only.\n *\n * `\"DejaVu Sans\"`, `\"DejaVuSans\"` and `\"dejavu-sans\"` all collapse to\n * `\"dejavusans\"`, which is what makes file-name based keys and real family\n * names interchangeable.\n *\n * @param name - raw font name\n * @returns the normalised comparison key\n */\nexport function normalizeFontName(name: string): string {\n  return name.toLowerCase().replace(/[^a-z0-9]+/g, '')\n}\n\n/** Decode a UTF-16BE string out of `buf` (Node has no utf16be codec). */\nfunction utf16beToString(buf: Buffer, start: number, byteLength: number): string {\n  const chars: string[] = []\n  for (let i = 0; i + 1 < byteLength; i += 2) {\n    chars.push(String.fromCharCode(buf.readUInt16BE(start + i)))\n  }\n  return chars.join('')\n}\n\n/**\n * Locate the `name` table inside a font's table directory.\n *\n * @param buf - buffer holding at least the sfnt header + table directory\n * @returns the table's byte offset and length, or null for an unsupported file\n */\nfunction findNameTable(buf: Buffer): { offset: number; length: number } | null {\n  if (buf.length < 12) return null\n  const sfnt = buf.readUInt32BE(0)\n  const tag = buf.toString('latin1', 0, 4)\n  if (sfnt !== SFNT_TRUE_TYPE && tag !== 'OTTO' && tag !== 'true' && tag !== 'typ1') return null\n\n  const numTables = buf.readUInt16BE(4)\n  for (let i = 0; i < numTables; i++) {\n    const rec = 12 + i * 16\n    if (rec + 16 > buf.length) break\n    if (buf.toString('latin1', rec, rec + 4) === 'name') {\n      return { offset: buf.readUInt32BE(rec + 8), length: buf.readUInt32BE(rec + 12) }\n    }\n  }\n  return null\n}\n\n/**\n * Parse a `name` table that starts at `base` inside `buf`.\n *\n * Windows (platform 3) and Unicode (platform 0) records are UTF-16BE; Macintosh\n * (platform 1) records are single-byte. Windows/en records win when a name is\n * present more than once. Typographic names (16/17) win over legacy (1/2).\n *\n * @param buf - buffer containing the table\n * @param base - offset of the table inside `buf`\n * @returns the names, or null when the table is unreadable\n */\nexport function parseNameTable(buf: Buffer, base: number): FontFileNames | null {\n  if (base + 6 > buf.length) return null\n  const count = buf.readUInt16BE(base + 2)\n  const storage = base + buf.readUInt16BE(base + 4)\n\n  // nameID -> best (highest-priority) decoded value\n  const best = new Map<number, { score: number; value: string }>()\n  for (let i = 0; i < count; i++) {\n    const rec = base + 6 + i * 12\n    if (rec + 12 > buf.length) break\n    const platform = buf.readUInt16BE(rec)\n    const language = buf.readUInt16BE(rec + 4)\n    const nameId = buf.readUInt16BE(rec + 6)\n    const len = buf.readUInt16BE(rec + 8)\n    const off = buf.readUInt16BE(rec + 10)\n    if (len === 0 || (nameId !== 1 && nameId !== 2 && nameId !== 16 && nameId !== 17)) continue\n    const start = storage + off\n    if (start + len > buf.length) continue\n\n    let value: string | null = null\n    let score = 0\n    if (platform === 3 || platform === 0) {\n      value = utf16beToString(buf, start, len)\n      score = platform === 3 ? (language === 0x0409 ? 3 : 2) : 1\n    } else if (platform === 1) {\n      value = buf.toString('latin1', start, start + len)\n      score = 1\n    }\n    if (value === null) continue\n    value = value.replace(/\\0/g, '').trim()\n    if (!value) continue\n    const prior = best.get(nameId)\n    if (!prior || score > prior.score) best.set(nameId, { score, value })\n  }\n\n  const family = best.get(16)?.value ?? best.get(1)?.value\n  if (!family) return null\n  return {\n    family,\n    subfamily: best.get(17)?.value ?? best.get(2)?.value ?? '',\n  }\n}\n\n/**\n * Read the family/subfamily names out of a complete font file buffer.\n *\n * @param buf - the whole font file\n * @returns the names, or null when the file has no readable `name` table\n */\nexport function readFontFileNames(buf: Buffer): FontFileNames | null {\n  const table = findNameTable(buf)\n  if (!table || table.offset + 6 > buf.length) return null\n  return parseNameTable(buf, table.offset)\n}\n\n/**\n * Scan one font file and return its names (null when unreadable).\n *\n * Two-phase read: the sfnt header + table directory first, then exactly the\n * `name` table. Reading a fixed head window is not enough — in a large font\n * (`glyf`/`loca` are megabytes) the `name` table sits far past any small prefix\n * (Arial's is at ~0x0F0000), which silently made the whole system index miss.\n */\nfunction namesOf(path: string): FontFileNames | null {\n  let fd: number | undefined\n  try {\n    fd = openSync(path, 'r')\n    const size = statSync(path).size\n    const head = Buffer.alloc(Math.min(size, 4096))\n    readSync(fd, head, 0, head.length, 0)\n    const table = findNameTable(head)\n    if (!table || table.length === 0 || table.offset + table.length > size) return null\n    const tbl = Buffer.alloc(table.length)\n    readSync(fd, tbl, 0, table.length, table.offset)\n    return parseNameTable(tbl, 0)\n  } catch {\n    return null\n  } finally {\n    if (fd !== undefined) closeSync(fd)\n  }\n}\n\n/** Locate a font file whose `name` table names it `family`. */\nexport interface FontFamilyMatch {\n  /** Absolute path of the best (Regular-preferred) file for the family. */\n  path: string\n}\n\n/**\n * The OS font directories to scan, in search order (Windows / macOS / Linux).\n *\n * @returns the platform's standard font directories present in the environment,\n *   with unavailable ones filtered out (may be empty on a stripped-down host)\n */\nexport function defaultSystemFontDirs(): string[] {\n  const win = process.env.WINDIR || process.env.SystemRoot\n  if (process.platform === 'win32') {\n    return [\n      win ? join(win, 'Fonts') : '',\n      process.env.LOCALAPPDATA ? join(process.env.LOCALAPPDATA, 'Microsoft', 'Windows', 'Fonts') : '',\n    ].filter(Boolean)\n  }\n  if (process.platform === 'darwin') {\n    return [\n      '/System/Library/Fonts',\n      '/Library/Fonts',\n      process.env.HOME ? join(process.env.HOME, 'Library', 'Fonts') : '',\n    ].filter(Boolean)\n  }\n  // Linux / other unix: fontconfig's usual roots.\n  const xdg = process.env.XDG_DATA_HOME\n  return [\n    '/usr/share/fonts',\n    '/usr/local/share/fonts',\n    xdg ? join(xdg, 'fonts') : '',\n    process.env.HOME ? join(process.env.HOME, '.fonts') : '',\n    process.env.HOME ? join(process.env.HOME, '.local', 'share', 'fonts') : '',\n  ].filter(Boolean)\n}\n\n/** Every indexable font file under `dir`, depth-first and depth-capped. */\nfunction* walkFontFiles(dir: string, depth = 4): Generator<string> {\n  if (depth <= 0 || !existsSync(dir)) return\n  let entries: string[]\n  try {\n    entries = readdirSync(dir)\n  } catch {\n    return\n  }\n  for (const entry of entries) {\n    const p = join(dir, entry)\n    let st\n    try {\n      st = statSync(p)\n    } catch {\n      continue\n    }\n    if (st.isDirectory()) {\n      yield* walkFontFiles(p, depth - 1)\n    } else if (INDEXABLE_EXT.has(extname(entry).toLowerCase())) {\n      yield p\n    }\n  }\n}\n\n/** normalized family name -> best file path found so far. */\nexport type FontFamilyIndex = Map<string, string>\n\n/**\n * Build a normalised-family → file-path index for the given directories.\n *\n * When a family has several files (Regular/Bold/Italic…), the Regular one wins;\n * otherwise the first file seen is kept. Also indexes each file's *file stem*,\n * so a host pointed at a bare directory of renamed files still resolves them.\n *\n * @param dirs - font directories to scan (missing directories are skipped)\n * @returns the index (empty when nothing readable was found)\n */\nexport function buildFontFamilyIndex(dirs: readonly string[]): FontFamilyIndex {\n  const index: FontFamilyIndex = new Map()\n  for (const dir of dirs) {\n    for (const file of walkFontFiles(dir)) {\n      const names = namesOf(file)\n      if (!names) continue\n      const key = normalizeFontName(names.family)\n      const isRegular = normalizeFontName(names.subfamily) === 'regular'\n      if (key && (!index.has(key) || isRegular)) index.set(key, file)\n\n      // Also allow lookup by file stem (\"arial\" -> arial.ttf).\n      const stem = normalizeFontName(file.replace(/^.*[\\\\/]/, '').replace(/\\.[^.]+$/, ''))\n      if (stem && !index.has(stem)) index.set(stem, file)\n    }\n  }\n  return index\n}\n\n/**\n * PATH-style helper: split a user-supplied directory list.\n *\n * @param dirs - a path-delimiter-separated directory list (`;` on Windows, `:` elsewhere)\n * @returns the non-empty entries, in the order given\n */\nexport function splitDirList(dirs: string): string[] {\n  return dirs.split(delimiter).filter(Boolean)\n}\n"]}

package/dist/node-host/fs-asset-resolver.d.ts

@@ -13,7 +13,7 @@
  *     "logo_svg_key": { "path": "assets/logo.svg", "format": "svg" }
  *   }
  *
- * 或简单目录模式（无 manifest）：key = 文件名（不含扩展名）
+ * 或简单目录模式（无 manifest）：key = 完整文件名（含扩展名，P8 资产按文件名注册）
  */
 import type { AssetResolver } from '../cad-runtime/ports.js';
 /** Options for constructing an FsAssetResolver. */
@@ -37,13 +37,18 @@ export interface FsAssetResolverOptions {
  *     "logo_svg_key": { "path": "assets/logo.svg", "format": "svg" }
  *   }
  *
- * Or a plain directory mode (no manifest): key = file name without extension.
+ * Or a plain directory mode (no manifest): key = full file name (with extension, P8: assets are registered by file name).
  */
 export declare class FsAssetResolver implements AssetResolver {
     private assetsDir;
     private manifest;
     constructor(opts?: FsAssetResolverOptions);
-    /** 扫描目录，按文件名（不含扩展名）注册 key */
+    /**
+     * 扫描目录，注册两种 key（同一文件的两个命名空间，非内部逻辑回退）：
+     * - 完整文件名（含扩展名）：P8 起 `cad.load({ file })` 的寻址载体；
+     * - 无扩展名 basename：`cad.import_brep({ asset })` 的平台 BREP 资产约定
+     *   （asset 引用 `<stem>.brp` 的 `<stem>`，容器资产名）。
+     */
     private scanDirectory;
     resolveByKey(key: string): Promise<{
         bytes: ArrayBuffer;

package/dist/node-host/fs-asset-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs-asset-resolver.d.ts","sourceRoot":"","sources":["../../src/node-host/fs-asset-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAwBzD,mDAAmD;AACnD,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAgB,YAAW,aAAa;IACnD,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,QAAQ,CAAe;gBAEnB,IAAI,CAAC,EAAE,sBAAsB;IAezC,6BAA6B;IAC7B,OAAO,CAAC,aAAa;IAWf,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAmB3E,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ/C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAOpD"}
+{"version":3,"file":"fs-asset-resolver.d.ts","sourceRoot":"","sources":["../../src/node-host/fs-asset-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAwBzD,mDAAmD;AACnD,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAgB,YAAW,aAAa;IACnD,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,QAAQ,CAAe;gBAEnB,IAAI,CAAC,EAAE,sBAAsB;IAezC;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAcf,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAmB3E,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ/C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAOpD"}

package/dist/node-host/fs-asset-resolver.js

@@ -13,7 +13,7 @@
  *     "logo_svg_key": { "path": "assets/logo.svg", "format": "svg" }
  *   }
  *
- * 或简单目录模式（无 manifest）：key = 文件名（不含扩展名）
+ * 或简单目录模式（无 manifest）：key = 完整文件名（含扩展名，P8 资产按文件名注册）
  */
 import { readFileSync, existsSync, statSync, readdirSync } from 'node:fs';
 import { resolve, extname, basename } from 'node:path';
@@ -46,7 +46,7 @@ function inferFormat(filePath) {
  *     "logo_svg_key": { "path": "assets/logo.svg", "format": "svg" }
  *   }
  *
- * Or a plain directory mode (no manifest): key = file name without extension.
+ * Or a plain directory mode (no manifest): key = full file name (with extension, P8: assets are registered by file name).
  */
 export class FsAssetResolver {
     assetsDir;
@@ -63,14 +63,22 @@ export class FsAssetResolver {
             this.scanDirectory(this.assetsDir);
         }
     }
-    /** 扫描目录，按文件名（不含扩展名）注册 key */
+    /**
+     * 扫描目录，注册两种 key（同一文件的两个命名空间，非内部逻辑回退）：
+     * - 完整文件名（含扩展名）：P8 起 `cad.load({ file })` 的寻址载体；
+     * - 无扩展名 basename：`cad.import_brep({ asset })` 的平台 BREP 资产约定
+     *   （asset 引用 `<stem>.brp` 的 `<stem>`，容器资产名）。
+     */
     scanDirectory(dir) {
         const files = readdirSync(dir);
         for (const file of files) {
             const fullPath = resolve(dir, file);
             if (statSync(fullPath).isFile()) {
-                const key = basename(file, extname(file));
-                this.manifest[key] = { path: fullPath, format: inferFormat(fullPath) };
+                this.manifest[file] = { path: fullPath, format: inferFormat(fullPath) };
+                const stem = basename(file, extname(file));
+                if (stem !== file) {
+                    this.manifest[stem] = { path: fullPath, format: inferFormat(fullPath) };
+                }
             }
         }
     }

package/dist/node-host/fs-asset-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs-asset-resolver.js","sourceRoot":"","sources":["../../src/node-host/fs-asset-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * FsAssetResolver — Node 端资产解析（fs 目录/manifest）\n *\n *\n * 实现 AssetResolver 接口：\n * - resolveByKey(key): 从 --assets 目录/manifest 解析 key → 文件路径 → ArrayBuffer\n * - resolveFile(path): 直接读取本地文件\n * - resolveUrl(url): fetch（Node 18+ 内置 fetch）\n *\n * manifest 格式（JSON）：\n *   {\n *     \"file_abc123\": { \"path\": \"models/box.step\", \"format\": \"step\" },\n *     \"logo_svg_key\": { \"path\": \"assets/logo.svg\", \"format\": \"svg\" }\n *   }\n *\n * 或简单目录模式（无 manifest）：key = 文件名（不含扩展名）\n */\n\nimport { readFileSync, existsSync, statSync, readdirSync } from 'node:fs'\nimport { resolve, extname, basename } from 'node:path'\nimport type { AssetResolver } from '../cad-runtime/ports'\n\ninterface ManifestEntry {\n  path: string\n  format?: string\n}\n\ntype Manifest = Record<string, ManifestEntry>\n\n/** 从文件扩展名推断格式 */\nfunction inferFormat(filePath: string): string | undefined {\n  if (filePath.toLowerCase().endsWith('.fai.js')) return 'faijs'\n  const ext = extname(filePath).toLowerCase().slice(1)\n  const formatMap: Record<string, string> = {\n    step: 'step',\n    stp: 'step',\n    '3mf': '3mf',\n    stl: 'stl',\n    obj: 'obj',\n    svg: 'svg',\n  }\n  return formatMap[ext]\n}\n\n/** Options for constructing an FsAssetResolver. */\nexport interface FsAssetResolverOptions {\n  /** Asset root directory. */\n  assetsDir?: string\n  /** Manifest file path (JSON, key -> {path, format?}). */\n  manifestPath?: string\n}\n\n/**\n * Node-side asset resolver backed by the filesystem (directory/manifest).\n *\n * Implements the AssetResolver interface:\n * - resolveByKey(key): resolve a key from the --assets directory/manifest to a file path and return its bytes\n * - resolveFile(path): read a local file directly\n * - resolveUrl(url): fetch a URL (Node 18+ built-in fetch)\n *\n * Manifest format (JSON):\n *   {\n *     \"file_abc123\": { \"path\": \"models/box.step\", \"format\": \"step\" },\n *     \"logo_svg_key\": { \"path\": \"assets/logo.svg\", \"format\": \"svg\" }\n *   }\n *\n * Or a plain directory mode (no manifest): key = file name without extension.\n */\nexport class FsAssetResolver implements AssetResolver {\n  private assetsDir: string | undefined\n  private manifest: Manifest = {}\n\n  constructor(opts?: FsAssetResolverOptions) {\n    this.assetsDir = opts?.assetsDir\n    const manifestPath = opts?.manifestPath ?? (this.assetsDir ? resolve(this.assetsDir, 'manifest.json') : undefined)\n\n    if (manifestPath && existsSync(manifestPath)) {\n      const raw = readFileSync(manifestPath, 'utf-8')\n      this.manifest = JSON.parse(raw) as Manifest\n    }\n\n    // 如果没有 manifest 但有 assetsDir，自动扫描目录\n    if (Object.keys(this.manifest).length === 0 && this.assetsDir && existsSync(this.assetsDir)) {\n      this.scanDirectory(this.assetsDir)\n    }\n  }\n\n  /** 扫描目录，按文件名（不含扩展名）注册 key */\n  private scanDirectory(dir: string): void {\n    const files = readdirSync(dir)\n    for (const file of files) {\n      const fullPath = resolve(dir, file)\n      if (statSync(fullPath).isFile()) {\n        const key = basename(file, extname(file))\n        this.manifest[key] = { path: fullPath, format: inferFormat(fullPath) }\n      }\n    }\n  }\n\n  async resolveByKey(key: string): Promise<{ bytes: ArrayBuffer; format?: string }> {\n    const entry = this.manifest[key]\n    if (!entry) {\n      throw new Error(`[FsAssetResolver] asset key \"${key}\" not found in manifest or directory`)\n    }\n\n    const fullPath = this.assetsDir\n      ? resolve(this.assetsDir, entry.path)\n      : entry.path\n\n    if (!existsSync(fullPath)) {\n      throw new Error(`[FsAssetResolver] asset file not found: ${fullPath}`)\n    }\n\n    const buf = readFileSync(fullPath)\n    const arrayBuffer = buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength) as ArrayBuffer\n    return { bytes: arrayBuffer, format: entry.format ?? inferFormat(fullPath) }\n  }\n\n  async resolveFile(path: string): Promise<ArrayBuffer> {\n    if (!existsSync(path)) {\n      throw new Error(`[FsAssetResolver] file not found: ${path}`)\n    }\n    const buf = readFileSync(path)\n    return buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength) as ArrayBuffer\n  }\n\n  async resolveUrl(url: string): Promise<ArrayBuffer> {\n    const response = await fetch(url)\n    if (!response.ok) {\n      throw new Error(`[FsAssetResolver] fetch failed: ${url} (${response.status} ${response.statusText})`)\n    }\n    return response.arrayBuffer()\n  }\n}\n"]}
+{"version":3,"file":"fs-asset-resolver.js","sourceRoot":"","sources":["../../src/node-host/fs-asset-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * FsAssetResolver — Node 端资产解析（fs 目录/manifest）\n *\n *\n * 实现 AssetResolver 接口：\n * - resolveByKey(key): 从 --assets 目录/manifest 解析 key → 文件路径 → ArrayBuffer\n * - resolveFile(path): 直接读取本地文件\n * - resolveUrl(url): fetch（Node 18+ 内置 fetch）\n *\n * manifest 格式（JSON）：\n *   {\n *     \"file_abc123\": { \"path\": \"models/box.step\", \"format\": \"step\" },\n *     \"logo_svg_key\": { \"path\": \"assets/logo.svg\", \"format\": \"svg\" }\n *   }\n *\n * 或简单目录模式（无 manifest）：key = 完整文件名（含扩展名，P8 资产按文件名注册）\n */\n\nimport { readFileSync, existsSync, statSync, readdirSync } from 'node:fs'\nimport { resolve, extname, basename } from 'node:path'\nimport type { AssetResolver } from '../cad-runtime/ports'\n\ninterface ManifestEntry {\n  path: string\n  format?: string\n}\n\ntype Manifest = Record<string, ManifestEntry>\n\n/** 从文件扩展名推断格式 */\nfunction inferFormat(filePath: string): string | undefined {\n  if (filePath.toLowerCase().endsWith('.fai.js')) return 'faijs'\n  const ext = extname(filePath).toLowerCase().slice(1)\n  const formatMap: Record<string, string> = {\n    step: 'step',\n    stp: 'step',\n    '3mf': '3mf',\n    stl: 'stl',\n    obj: 'obj',\n    svg: 'svg',\n  }\n  return formatMap[ext]\n}\n\n/** Options for constructing an FsAssetResolver. */\nexport interface FsAssetResolverOptions {\n  /** Asset root directory. */\n  assetsDir?: string\n  /** Manifest file path (JSON, key -> {path, format?}). */\n  manifestPath?: string\n}\n\n/**\n * Node-side asset resolver backed by the filesystem (directory/manifest).\n *\n * Implements the AssetResolver interface:\n * - resolveByKey(key): resolve a key from the --assets directory/manifest to a file path and return its bytes\n * - resolveFile(path): read a local file directly\n * - resolveUrl(url): fetch a URL (Node 18+ built-in fetch)\n *\n * Manifest format (JSON):\n *   {\n *     \"file_abc123\": { \"path\": \"models/box.step\", \"format\": \"step\" },\n *     \"logo_svg_key\": { \"path\": \"assets/logo.svg\", \"format\": \"svg\" }\n *   }\n *\n * Or a plain directory mode (no manifest): key = full file name (with extension, P8: assets are registered by file name).\n */\nexport class FsAssetResolver implements AssetResolver {\n  private assetsDir: string | undefined\n  private manifest: Manifest = {}\n\n  constructor(opts?: FsAssetResolverOptions) {\n    this.assetsDir = opts?.assetsDir\n    const manifestPath = opts?.manifestPath ?? (this.assetsDir ? resolve(this.assetsDir, 'manifest.json') : undefined)\n\n    if (manifestPath && existsSync(manifestPath)) {\n      const raw = readFileSync(manifestPath, 'utf-8')\n      this.manifest = JSON.parse(raw) as Manifest\n    }\n\n    // 如果没有 manifest 但有 assetsDir，自动扫描目录\n    if (Object.keys(this.manifest).length === 0 && this.assetsDir && existsSync(this.assetsDir)) {\n      this.scanDirectory(this.assetsDir)\n    }\n  }\n\n  /**\n   * 扫描目录，注册两种 key（同一文件的两个命名空间，非内部逻辑回退）：\n   * - 完整文件名（含扩展名）：P8 起 `cad.load({ file })` 的寻址载体；\n   * - 无扩展名 basename：`cad.import_brep({ asset })` 的平台 BREP 资产约定\n   *   （asset 引用 `<stem>.brp` 的 `<stem>`，容器资产名）。\n   */\n  private scanDirectory(dir: string): void {\n    const files = readdirSync(dir)\n    for (const file of files) {\n      const fullPath = resolve(dir, file)\n      if (statSync(fullPath).isFile()) {\n        this.manifest[file] = { path: fullPath, format: inferFormat(fullPath) }\n        const stem = basename(file, extname(file))\n        if (stem !== file) {\n          this.manifest[stem] = { path: fullPath, format: inferFormat(fullPath) }\n        }\n      }\n    }\n  }\n\n  async resolveByKey(key: string): Promise<{ bytes: ArrayBuffer; format?: string }> {\n    const entry = this.manifest[key]\n    if (!entry) {\n      throw new Error(`[FsAssetResolver] asset key \"${key}\" not found in manifest or directory`)\n    }\n\n    const fullPath = this.assetsDir\n      ? resolve(this.assetsDir, entry.path)\n      : entry.path\n\n    if (!existsSync(fullPath)) {\n      throw new Error(`[FsAssetResolver] asset file not found: ${fullPath}`)\n    }\n\n    const buf = readFileSync(fullPath)\n    const arrayBuffer = buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength) as ArrayBuffer\n    return { bytes: arrayBuffer, format: entry.format ?? inferFormat(fullPath) }\n  }\n\n  async resolveFile(path: string): Promise<ArrayBuffer> {\n    if (!existsSync(path)) {\n      throw new Error(`[FsAssetResolver] file not found: ${path}`)\n    }\n    const buf = readFileSync(path)\n    return buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength) as ArrayBuffer\n  }\n\n  async resolveUrl(url: string): Promise<ArrayBuffer> {\n    const response = await fetch(url)\n    if (!response.ok) {\n      throw new Error(`[FsAssetResolver] fetch failed: ${url} (${response.status} ${response.statusText})`)\n    }\n    return response.arrayBuffer()\n  }\n}\n"]}

package/dist/node-host/index.d.ts

@@ -25,6 +25,14 @@ export interface CreateNodePortsOptions {
     fontsDir?: string;
     /** Default font path (falls back to the project single source of truth when omitted). */
     defaultFontPath?: string;
+    /**
+     * Look up font *family names* in the OS font directories (default `true`).
+     *
+     * This is what makes `text(font: 'Arial')` behave like CadQuery, whose
+     * `Font_FontMgr` resolves names against the installed fonts. Set `false` for a
+     * hermetic host: name lookups then miss and fall back to the default font.
+     */
+    systemFonts?: boolean;
 }
 /**
  * Create Node-side HostPorts (for injecting into CadRuntime).

package/dist/node-host/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node-host/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAQrD,4CAA4C;AAC5C,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAqBxE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node-host/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAQrD,4CAA4C;AAC5C,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAsBxE"}

package/dist/node-host/index.js

@@ -38,6 +38,7 @@ export function createNodePorts(opts) {
     const fontProvider = new NodeFontProvider({
         defaultFontPath: opts?.defaultFontPath,
         fontsDir: opts?.fontsDir,
+        systemFonts: opts?.systemFonts,
     });
     // 连接 NodeFontProvider 到 fontRegistry
     setFontLoader(fontProvider);

package/dist/node-host/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node-host/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAG/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAczD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,IAA6B;IAC3D,MAAM,YAAY,GAAG,IAAI,gBAAgB,CAAC;QACxC,eAAe,EAAE,IAAI,EAAE,eAAe;QACtC,QAAQ,EAAE,IAAI,EAAE,QAAQ;KACzB,CAAC,CAAA;IAEF,qCAAqC;IACrC,aAAa,CAAC,YAAY,CAAC,CAAA;IAE3B,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,SAAS,EAAE,IAAI,EAAE,SAAS;QAC1B,YAAY,EAAE,IAAI,EAAE,YAAY;KACjC,CAAC,CAAA;IAEF,OAAO;QACL,GAAG,EAAE,IAAI,gBAAgB,EAAE;QAC3B,GAAG,EAAE,IAAI,gBAAgB,EAAE;QAC3B,KAAK,EAAE,YAAY;QACnB,MAAM;QACN,MAAM,EAAE,IAAI,YAAY,EAAE;KAC3B,CAAA;AACH,CAAC","sourcesContent":["/**\n * node-host — L3 Node host 公开 API\n *\n *\n * Node host 负责：\n * - 创建 CadRuntime 实例（注入 node Ports：InlineCsgBackend / InlineSdfBackend / ...）\n * - 连接 NodeFontProvider 到 fontRegistry\n * - CLI 入口\n */\n\nexport { InlineCsgBackend } from '../browser-host/inline-csg-backend'\nexport { InlineSdfBackend } from '../browser-host/inline-sdf-backend'\nexport { NodeFontProvider } from './node-font-provider'\nexport type { NodeFontProviderOptions } from './node-font-provider'\nexport { FsAssetResolver } from './fs-asset-resolver'\nexport type { FsAssetResolverOptions } from './fs-asset-resolver'\nexport { CliEventSink } from './cli-event-sink'\n\nimport type { HostPorts } from '../cad-runtime/ports'\nimport { InlineCsgBackend } from '../browser-host/inline-csg-backend'\nimport { InlineSdfBackend } from '../browser-host/inline-sdf-backend'\nimport { NodeFontProvider } from './node-font-provider'\nimport { FsAssetResolver } from './fs-asset-resolver'\nimport { CliEventSink } from './cli-event-sink'\nimport { setFontLoader } from '../brep/text/fontRegistry'\n\n/** Options for creating Node host ports. */\nexport interface CreateNodePortsOptions {\n  /** Asset directory (used by FsAssetResolver). */\n  assetsDir?: string\n  /** Manifest file path. */\n  manifestPath?: string\n  /** Extra fonts directory. */\n  fontsDir?: string\n  /** Default font path (falls back to the project single source of truth when omitted). */\n  defaultFontPath?: string\n}\n\n/**\n * Create Node-side HostPorts (for injecting into CadRuntime).\n *\n * Assembles all inline backends into HostPorts:\n * - csg: InlineCsgBackend (runs manifold-3d directly on the main thread)\n * - sdf: InlineSdfBackend (runs directly on the main thread)\n * - fonts: NodeFontProvider (fs font loading)\n * - assets: FsAssetResolver (fs asset resolution)\n * - events: CliEventSink (writes to stderr + collects)\n *\n * Also connects the NodeFontProvider to fontRegistry (setFontLoader), so that\n * brep/text's ensureDefaultFont() can load fonts via the filesystem.\n *\n * @param opts - options controlling the ports (assets/fonts directories, default font path)\n * @returns the assembled HostPorts\n */\nexport function createNodePorts(opts?: CreateNodePortsOptions): HostPorts {\n  const fontProvider = new NodeFontProvider({\n    defaultFontPath: opts?.defaultFontPath,\n    fontsDir: opts?.fontsDir,\n  })\n\n  // 连接 NodeFontProvider 到 fontRegistry\n  setFontLoader(fontProvider)\n\n  const assets = new FsAssetResolver({\n    assetsDir: opts?.assetsDir,\n    manifestPath: opts?.manifestPath,\n  })\n\n  return {\n    csg: new InlineCsgBackend(),\n    sdf: new InlineSdfBackend(),\n    fonts: fontProvider,\n    assets,\n    events: new CliEventSink(),\n  }\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node-host/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAG/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAsBzD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,IAA6B;IAC3D,MAAM,YAAY,GAAG,IAAI,gBAAgB,CAAC;QACxC,eAAe,EAAE,IAAI,EAAE,eAAe;QACtC,QAAQ,EAAE,IAAI,EAAE,QAAQ;QACxB,WAAW,EAAE,IAAI,EAAE,WAAW;KAC/B,CAAC,CAAA;IAEF,qCAAqC;IACrC,aAAa,CAAC,YAAY,CAAC,CAAA;IAE3B,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,SAAS,EAAE,IAAI,EAAE,SAAS;QAC1B,YAAY,EAAE,IAAI,EAAE,YAAY;KACjC,CAAC,CAAA;IAEF,OAAO;QACL,GAAG,EAAE,IAAI,gBAAgB,EAAE;QAC3B,GAAG,EAAE,IAAI,gBAAgB,EAAE;QAC3B,KAAK,EAAE,YAAY;QACnB,MAAM;QACN,MAAM,EAAE,IAAI,YAAY,EAAE;KAC3B,CAAA;AACH,CAAC","sourcesContent":["/**\n * node-host — L3 Node host 公开 API\n *\n *\n * Node host 负责：\n * - 创建 CadRuntime 实例（注入 node Ports：InlineCsgBackend / InlineSdfBackend / ...）\n * - 连接 NodeFontProvider 到 fontRegistry\n * - CLI 入口\n */\n\nexport { InlineCsgBackend } from '../browser-host/inline-csg-backend'\nexport { InlineSdfBackend } from '../browser-host/inline-sdf-backend'\nexport { NodeFontProvider } from './node-font-provider'\nexport type { NodeFontProviderOptions } from './node-font-provider'\nexport { FsAssetResolver } from './fs-asset-resolver'\nexport type { FsAssetResolverOptions } from './fs-asset-resolver'\nexport { CliEventSink } from './cli-event-sink'\n\nimport type { HostPorts } from '../cad-runtime/ports'\nimport { InlineCsgBackend } from '../browser-host/inline-csg-backend'\nimport { InlineSdfBackend } from '../browser-host/inline-sdf-backend'\nimport { NodeFontProvider } from './node-font-provider'\nimport { FsAssetResolver } from './fs-asset-resolver'\nimport { CliEventSink } from './cli-event-sink'\nimport { setFontLoader } from '../brep/text/fontRegistry'\n\n/** Options for creating Node host ports. */\nexport interface CreateNodePortsOptions {\n  /** Asset directory (used by FsAssetResolver). */\n  assetsDir?: string\n  /** Manifest file path. */\n  manifestPath?: string\n  /** Extra fonts directory. */\n  fontsDir?: string\n  /** Default font path (falls back to the project single source of truth when omitted). */\n  defaultFontPath?: string\n  /**\n   * Look up font *family names* in the OS font directories (default `true`).\n   *\n   * This is what makes `text(font: 'Arial')` behave like CadQuery, whose\n   * `Font_FontMgr` resolves names against the installed fonts. Set `false` for a\n   * hermetic host: name lookups then miss and fall back to the default font.\n   */\n  systemFonts?: boolean\n}\n\n/**\n * Create Node-side HostPorts (for injecting into CadRuntime).\n *\n * Assembles all inline backends into HostPorts:\n * - csg: InlineCsgBackend (runs manifold-3d directly on the main thread)\n * - sdf: InlineSdfBackend (runs directly on the main thread)\n * - fonts: NodeFontProvider (fs font loading)\n * - assets: FsAssetResolver (fs asset resolution)\n * - events: CliEventSink (writes to stderr + collects)\n *\n * Also connects the NodeFontProvider to fontRegistry (setFontLoader), so that\n * brep/text's ensureDefaultFont() can load fonts via the filesystem.\n *\n * @param opts - options controlling the ports (assets/fonts directories, default font path)\n * @returns the assembled HostPorts\n */\nexport function createNodePorts(opts?: CreateNodePortsOptions): HostPorts {\n  const fontProvider = new NodeFontProvider({\n    defaultFontPath: opts?.defaultFontPath,\n    fontsDir: opts?.fontsDir,\n    systemFonts: opts?.systemFonts,\n  })\n\n  // 连接 NodeFontProvider 到 fontRegistry\n  setFontLoader(fontProvider)\n\n  const assets = new FsAssetResolver({\n    assetsDir: opts?.assetsDir,\n    manifestPath: opts?.manifestPath,\n  })\n\n  return {\n    csg: new InlineCsgBackend(),\n    sdf: new InlineSdfBackend(),\n    fonts: fontProvider,\n    assets,\n    events: new CliEventSink(),\n  }\n}\n"]}

package/dist/node-host/node-font-provider.d.ts

@@ -18,6 +18,18 @@ export interface NodeFontProviderOptions {
     defaultFontPath?: string;
     /** Extra fonts directory: all .ttf/.otf files are registered by file name (without extension) as keys. */
     fontsDir?: string;
+    /**
+     * Enable name-based lookup against the OS font directories (default `true`).
+     *
+     * Needed to honour a font *family name* (`resolveFont('Arial')`) the way
+     * CadQuery's `font=` does through OCC's system font manager. Only consulted
+     * when a caller names a font that is not already registered, so the bundled
+     * default font path is unaffected. Set `false` to keep the host fully
+     * hermetic (name lookups then always miss and fall back to the default).
+     */
+    systemFonts?: boolean;
+    /** Override the system font directories to scan (PATH-separated string or array). */
+    systemFontDirs?: string[] | string;
 }
 /**
  * Node-side font provider (fs loading).
@@ -37,6 +49,10 @@ export declare class NodeFontProvider implements FontProvider, FontLoader {
     private keyToPath;
     /** 缓存的 ArrayBuffer（避免重复读磁盘） */
     private cache;
+    /** System font dirs to scan for a font *family name* (empty ⇒ disabled). */
+    private systemFontDirs;
+    /** Lazily built normalized-family → path index (null until first name miss). */
+    private familyIndex;
     constructor(opts?: NodeFontProviderOptions);
     /** FontProvider.loadFont: load font bytes by key. */
     loadFont(key: string): Promise<ArrayBuffer>;
@@ -44,6 +60,18 @@ export declare class NodeFontProvider implements FontProvider, FontLoader {
     loadDefaultFont(): Promise<ArrayBuffer>;
     /** FontProvider.listFonts: list the available font keys. */
     listFonts(): string[];
+    /**
+     * FontLoader.resolveFont: resolve a font family name or a file path.
+     *
+     * Order: an existing file path wins, then a registered key (exact, then
+     * normalised so `"Arial"` matches the `arial.ttf` stem), then the OS font
+     * family index. Returns `null` — never throws — when nothing matches, so the
+     * caller can fall back to the default font the way OCC does.
+     *
+     * @param nameOrPath - font family name or font file path
+     * @returns the font bytes, or null when the name cannot be resolved here
+     */
+    resolveFont(nameOrPath: string): Promise<ArrayBuffer | null>;
     /** 读取文件并缓存 */
     private loadFile;
 }