@faicad/faijs 0.13.0

package/dist/cad-runtime/browser-lib-loader.js

@@ -0,0 +1,113 @@
+/**
+ * browser-lib-loader — 浏览器通用 `LibLoader` 工厂（D3-Browser，§9.4）
+ *
+ * 与 node 侧 `cliPortsLibLoader`（`node-host/cli.ts`）对称：都实现 `LibLoader`
+ * 契约（`loadLib` / `listLibs` / `options.autoLiftFor`），差别只在装载通道——
+ * node 用 `import(pkg)` 从 `node_modules` 解析，浏览器用**动态 `import()`** 取 CDN。
+ *
+ * 两条通路（Q8 定稿的 a/b 混合，共用同一 `CDN_BASE`）：
+ * - **方案 a（importmap）**：不提供 `versions` 时，用**已解析的包名**做裸 specifier
+ *   动态 `import(pkg)`，由页面 `<script type="importmap">` 的 scope
+ *   （`"@faicad/": "CDN_BASE/*@faicad/"`）在后端按依赖图取版。零版本表，dev / playground 用。
+ * - **方案 b（精确 pin）**：提供 `versions`（`versions.json`）时拼
+ *   `` `${cdnBase}${pkg}@${version}/+esm` `` 直链，版本精确 pin 到已发布版本，保证
+ *   可复现与缓存命中；release 产物用。
+ *
+ * 别名归一：脚本 specifier 常是短名（demo 的 `.fai.js` 写 `gear-lib-demo` /
+ * `sheetmetal`），而 CDN 上是 npm 全名（`@faicad/gear-lib-demo`）。`aliases` 把
+ * specifier 映到包名后再装载，与 node 侧 `CLI_LIB_ALIASES` 同一职责。
+ *
+ * `autoLiftFor` 是**同步**回调（`runtime.ts` 在装载后立即取值），所以逐库
+ * `faijs.autoLift` 必须**预先**可用：主机从构建期产物 `lib-meta.json`
+ * （`scripts/gen-importmap.mjs` 生成）经 `meta` 传入；也可调 `prefetchMeta()`
+ * 在网络可达时抓各库 `package.json` 预热（失败静默回落推断式）。
+ *
+ * 本工厂**不**被 `createBrowserPorts` 默认装配——demo 走源码 alias 的 HMR 路径
+ * 必须保持零网络；CDN 装载仅服务「从 npm 消费已发布包」的场景，由主机显式注入。
+ */
+/** 默认 CDN base（Q8 定稿：jsDelivr npm 镜像；ESM 取 `+esm`）。 */
+export const DEFAULT_CDN_BASE = 'https://cdn.jsdelivr.net/npm/';
+/** 归一 CDN base：保证尾随 `/`，避免拼接出 `.../npm@1.0.0` 这类坏 URL。 */
+function withTrailingSlash(base) {
+    return base.endsWith('/') ? base : `${base}/`;
+}
+/**
+ * 创建浏览器通用 `LibLoader`。
+ *
+ * 装载顺序：`name` → `aliases` 归一为 npm 包名 → 白名单校验 → 方案 b 直链（有
+ * `versions[pkg]` 且未 `forceImportMap`）或方案 a 裸 specifier → 动态 `import()`；
+ * 同一包名并发/重复装载共享同一 in-flight promise（CDN 只取一次）。
+ * @param opts - CDN base、版本表 / 别名 / 元数据，以及测试用注入点。
+ * @returns 满足 `LibLoader` 契约、并附加 `prefetchMeta()` 的浏览器装载器。
+ */
+export function createBrowserLibLoader(opts = {}) {
+    const cdnBase = withTrailingSlash(opts.cdnBase ?? DEFAULT_CDN_BASE);
+    const aliases = { ...(opts.aliases ?? {}) };
+    const versions = opts.versions;
+    const allow = opts.libs ? new Set(opts.libs) : undefined;
+    const meta = { ...(opts.meta ?? {}) };
+    const importModule = opts.importModule ?? ((url) => import(/* @vite-ignore */ url));
+    const fetchImpl = opts.fetchImpl ?? (typeof fetch !== 'undefined' ? fetch : undefined);
+    /** specifier → npm 包名。 */
+    const pkgOf = (name) => aliases[name] ?? name;
+    /** 已知 specifier 集合：别名键 ∪ 显式 libs ∪ 版本表键（后两者本身即合法 specifier）。 */
+    const specifiers = new Set([
+        ...Object.keys(aliases),
+        ...(opts.libs ?? []),
+        ...Object.keys(versions ?? {}),
+    ]);
+    /** 方案 b 的直链；返回 `undefined` 表示走方案 a。 */
+    const urlOf = (pkg) => {
+        if (opts.forceImportMap)
+            return undefined;
+        const v = versions?.[pkg];
+        return v ? `${cdnBase}${pkg}@${v}/+esm` : undefined;
+    };
+    const pending = new Map();
+    return {
+        loadLib: (name) => {
+            const pkg = pkgOf(name);
+            if (allow && !allow.has(pkg)) {
+                return Promise.reject(new Error(`package "${pkg}" (from specifier "${name}") is not in the browser library whitelist`));
+            }
+            const cached = pending.get(pkg);
+            if (cached)
+                return cached;
+            const url = urlOf(pkg);
+            const job = importModule(url ?? pkg).then((mod) => mod);
+            pending.set(pkg, job);
+            // 装载失败不留毒缓存：清掉后可重试（如网络恢复）。
+            job.catch(() => pending.delete(pkg));
+            return job;
+        },
+        listLibs: () => [...specifiers],
+        options: {
+            ...(opts.autoLift === undefined ? {} : { autoLift: opts.autoLift }),
+            // 逐库 autoLift 优先于全局：未声明 → undefined → 回落全局 / runtime 推断式。
+            autoLiftFor: (name) => meta[pkgOf(name)]?.autoLift,
+        },
+        prefetchMeta: async () => {
+            if (!fetchImpl)
+                return;
+            const pkgs = new Set([...specifiers].map(pkgOf));
+            await Promise.all([...pkgs].map(async (pkg) => {
+                if (meta[pkg])
+                    return;
+                const v = versions?.[pkg];
+                try {
+                    const res = await fetchImpl(`${cdnBase}${pkg}${v ? `@${v}` : ''}/package.json`);
+                    if (!res.ok)
+                        return;
+                    const pj = (await res.json());
+                    const lifted = pj.faijs?.autoLift;
+                    if (typeof lifted === 'boolean')
+                        meta[pkg] = { autoLift: lifted };
+                }
+                catch {
+                    // 网络不可达 / 非法 JSON → 保持未声明，交由 runtime 推断式。
+                }
+            }));
+        },
+    };
+}
+//# sourceMappingURL=browser-lib-loader.js.map

package/dist/cad-runtime/browser-lib-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-lib-loader.js","sourceRoot":"","sources":["../../src/cad-runtime/browser-lib-loader.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * browser-lib-loader — 浏览器通用 `LibLoader` 工厂（D3-Browser，§9.4）\n *\n * 与 node 侧 `cliPortsLibLoader`（`node-host/cli.ts`）对称：都实现 `LibLoader`\n * 契约（`loadLib` / `listLibs` / `options.autoLiftFor`），差别只在装载通道——\n * node 用 `import(pkg)` 从 `node_modules` 解析，浏览器用**动态 `import()`** 取 CDN。\n *\n * 两条通路（Q8 定稿的 a/b 混合，共用同一 `CDN_BASE`）：\n * - **方案 a（importmap）**：不提供 `versions` 时，用**已解析的包名**做裸 specifier\n *   动态 `import(pkg)`，由页面 `<script type=\"importmap\">` 的 scope\n *   （`\"@faicad/\": \"CDN_BASE/*@faicad/\"`）在后端按依赖图取版。零版本表，dev / playground 用。\n * - **方案 b（精确 pin）**：提供 `versions`（`versions.json`）时拼\n *   `` `${cdnBase}${pkg}@${version}/+esm` `` 直链，版本精确 pin 到已发布版本，保证\n *   可复现与缓存命中；release 产物用。\n *\n * 别名归一：脚本 specifier 常是短名（demo 的 `.fai.js` 写 `gear-lib-demo` /\n * `sheetmetal`），而 CDN 上是 npm 全名（`@faicad/gear-lib-demo`）。`aliases` 把\n * specifier 映到包名后再装载，与 node 侧 `CLI_LIB_ALIASES` 同一职责。\n *\n * `autoLiftFor` 是**同步**回调（`runtime.ts` 在装载后立即取值），所以逐库\n * `faijs.autoLift` 必须**预先**可用：主机从构建期产物 `lib-meta.json`\n * （`scripts/gen-importmap.mjs` 生成）经 `meta` 传入；也可调 `prefetchMeta()`\n * 在网络可达时抓各库 `package.json` 预热（失败静默回落推断式）。\n *\n * 本工厂**不**被 `createBrowserPorts` 默认装配——demo 走源码 alias 的 HMR 路径\n * 必须保持零网络；CDN 装载仅服务「从 npm 消费已发布包」的场景，由主机显式注入。\n */\n\nimport type { LibLoader } from './ports'\nimport type { StdlibNamespace } from '../runtime-state'\n\n/** 默认 CDN base（Q8 定稿：jsDelivr npm 镜像；ESM 取 `+esm`）。 */\nexport const DEFAULT_CDN_BASE = 'https://cdn.jsdelivr.net/npm/'\n\n/** 逐库元数据（与 `lib-meta.json` 键形一致）。 */\nexport interface BrowserLibMeta {\n  /** `package.json` 的 `faijs.autoLift` 外置字段（D3-autoLift）。 */\n  autoLift?: boolean\n}\n\n/** `createBrowserLibLoader` 的选项。 */\nexport interface CreateBrowserLibLoaderOptions {\n  /** CDN base，须以 `/` 结尾（缺省 `DEFAULT_CDN_BASE`）。 */\n  cdnBase?: string\n  /** 方案 b：精确 pin 的 `packageName → version`（`versions.json`）；提供即走直链。 */\n  versions?: Record<string, string>\n  /** 别名表：脚本 import specifier → npm 包名（如 `gear-lib-demo` → `@faicad/gear-lib-demo`）。 */\n  aliases?: Record<string, string>\n  /** 允许装载的 **npm 包名**白名单；缺省不限制（生产建议显式给）。 */\n  libs?: string[]\n  /** 逐库元数据（`lib-meta.json`），喂 `options.autoLiftFor`。 */\n  meta?: Record<string, BrowserLibMeta>\n  /** 全局 autoLift 缺省（喂 `options.autoLift`）；缺省交由 runtime 推断式决定。 */\n  autoLift?: boolean\n  /** 强制方案 a（即使提供了 `versions` 也用裸 specifier，依赖 importmap）。 */\n  forceImportMap?: boolean\n  /** 注入的动态 import 实现（测试用）；缺省为原生动态 `import()`。 */\n  importModule?: (url: string) => Promise<unknown>\n  /** 注入的 fetch（`prefetchMeta` 用）；缺省全局 `fetch`，无则 `prefetchMeta` 为空操作。 */\n  fetchImpl?: typeof fetch\n}\n\n/** 浏览器 `LibLoader`（在契约上附加元数据预热）。 */\nexport interface BrowserLibLoader extends LibLoader {\n  /**\n   * 抓取已知各库的 `package.json`，把 `faijs.autoLift` 填进内部 meta 缓存。\n   * 网络失败静默跳过（保持未声明 → 回落推断式）。在 `execute` 前 await 一次即可。\n   * @returns promise resolving when all known libs have been probed.\n   */\n  prefetchMeta(): Promise<void>\n}\n\n/** 归一 CDN base：保证尾随 `/`，避免拼接出 `.../npm@1.0.0` 这类坏 URL。 */\nfunction withTrailingSlash(base: string): string {\n  return base.endsWith('/') ? base : `${base}/`\n}\n\n/**\n * 创建浏览器通用 `LibLoader`。\n *\n * 装载顺序：`name` → `aliases` 归一为 npm 包名 → 白名单校验 → 方案 b 直链（有\n * `versions[pkg]` 且未 `forceImportMap`）或方案 a 裸 specifier → 动态 `import()`；\n * 同一包名并发/重复装载共享同一 in-flight promise（CDN 只取一次）。\n * @param opts - CDN base、版本表 / 别名 / 元数据，以及测试用注入点。\n * @returns 满足 `LibLoader` 契约、并附加 `prefetchMeta()` 的浏览器装载器。\n */\nexport function createBrowserLibLoader(opts: CreateBrowserLibLoaderOptions = {}): BrowserLibLoader {\n  const cdnBase = withTrailingSlash(opts.cdnBase ?? DEFAULT_CDN_BASE)\n  const aliases: Record<string, string> = { ...(opts.aliases ?? {}) }\n  const versions = opts.versions\n  const allow = opts.libs ? new Set(opts.libs) : undefined\n  const meta: Record<string, BrowserLibMeta> = { ...(opts.meta ?? {}) }\n  const importModule =\n    opts.importModule ?? ((url: string): Promise<unknown> => import(/* @vite-ignore */ url))\n  const fetchImpl = opts.fetchImpl ?? (typeof fetch !== 'undefined' ? fetch : undefined)\n\n  /** specifier → npm 包名。 */\n  const pkgOf = (name: string): string => aliases[name] ?? name\n\n  /** 已知 specifier 集合：别名键 ∪ 显式 libs ∪ 版本表键（后两者本身即合法 specifier）。 */\n  const specifiers = new Set<string>([\n    ...Object.keys(aliases),\n    ...(opts.libs ?? []),\n    ...Object.keys(versions ?? {}),\n  ])\n\n  /** 方案 b 的直链；返回 `undefined` 表示走方案 a。 */\n  const urlOf = (pkg: string): string | undefined => {\n    if (opts.forceImportMap) return undefined\n    const v = versions?.[pkg]\n    return v ? `${cdnBase}${pkg}@${v}/+esm` : undefined\n  }\n\n  const pending = new Map<string, Promise<StdlibNamespace>>()\n\n  return {\n    loadLib: (name: string): Promise<StdlibNamespace> => {\n      const pkg = pkgOf(name)\n      if (allow && !allow.has(pkg)) {\n        return Promise.reject(\n          new Error(`package \"${pkg}\" (from specifier \"${name}\") is not in the browser library whitelist`),\n        )\n      }\n      const cached = pending.get(pkg)\n      if (cached) return cached\n      const url = urlOf(pkg)\n      const job = importModule(url ?? pkg).then((mod) => mod as StdlibNamespace)\n      pending.set(pkg, job)\n      // 装载失败不留毒缓存：清掉后可重试（如网络恢复）。\n      job.catch(() => pending.delete(pkg))\n      return job\n    },\n\n    listLibs: () => [...specifiers],\n\n    options: {\n      ...(opts.autoLift === undefined ? {} : { autoLift: opts.autoLift }),\n      // 逐库 autoLift 优先于全局：未声明 → undefined → 回落全局 / runtime 推断式。\n      autoLiftFor: (name: string) => meta[pkgOf(name)]?.autoLift,\n    },\n\n    prefetchMeta: async (): Promise<void> => {\n      if (!fetchImpl) return\n      const pkgs = new Set<string>([...specifiers].map(pkgOf))\n      await Promise.all(\n        [...pkgs].map(async (pkg) => {\n          if (meta[pkg]) return\n          const v = versions?.[pkg]\n          try {\n            const res = await fetchImpl(`${cdnBase}${pkg}${v ? `@${v}` : ''}/package.json`)\n            if (!res.ok) return\n            const pj = (await res.json()) as { faijs?: { autoLift?: boolean } }\n            const lifted = pj.faijs?.autoLift\n            if (typeof lifted === 'boolean') meta[pkg] = { autoLift: lifted }\n          } catch {\n            // 网络不可达 / 非法 JSON → 保持未声明，交由 runtime 推断式。\n          }\n        }),\n      )\n    },\n  }\n}\n"]}

package/dist/cad-runtime/content-key.d.ts

@@ -0,0 +1,30 @@
+/**
+ * content-key — mesh 内容哈希（statementKey / plan 增量判定共用）
+ *
+ * 从 runtime.ts 提取为独立模块，供 CadRuntime 与 DirectExecutor 共享。
+ */
+/**
+ * Compute the mesh content key (hash of positions and indices) used to decide
+ * incremental execution.
+ * @param positions - the mesh vertex positions.
+ * @param indices - the mesh triangle indices.
+ * @returns the content key string.
+ */
+export declare function computeContentKey(positions: Float32Array, indices: Uint32Array): string;
+/**
+ * Compute a deterministic fingerprint for an arbitrary value, used by the
+ * incremental update gates (G6/G7/G8) to detect whether params, libIds, or
+ * partTransform have changed since the last successful execution.
+ *
+ * Design constraints:
+ * - `undefined` and `null` are normalized to `null` (so "no params" and
+ *   "empty object params" are not treated as different).
+ * - Object keys are sorted before hashing (iteration order independent).
+ * - Circular references are detected and represented stably (no infinite loop).
+ * - Functions and Symbols have a deterministic degradation rule (type-tagged).
+ * - Arrays preserve element order (position-sensitive).
+ * @param value - the value to fingerprint (params / libIds / partTransform).
+ * @returns a hex string fingerprint.
+ */
+export declare function stableFingerprint(value: unknown): string;
+//# sourceMappingURL=content-key.d.ts.map

package/dist/cad-runtime/content-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-key.d.ts","sourceRoot":"","sources":["../../src/cad-runtime/content-key.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CAIvF;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAyExD"}

package/dist/cad-runtime/content-key.js

@@ -0,0 +1,134 @@
+/**
+ * content-key — mesh 内容哈希（statementKey / plan 增量判定共用）
+ *
+ * 从 runtime.ts 提取为独立模块，供 CadRuntime 与 DirectExecutor 共享。
+ */
+/** FNV-1a 哈希（typed array 逐元素） */
+function hashTypedArray(arr) {
+    let hash = 0x811c9dc5;
+    const len = arr.length;
+    for (let i = 0; i < len; i++) {
+        hash ^= arr[i];
+        hash = Math.imul(hash, 0x01000193);
+    }
+    hash ^= len;
+    hash = Math.imul(hash, 0x01000193);
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}
+/**
+ * Compute the mesh content key (hash of positions and indices) used to decide
+ * incremental execution.
+ * @param positions - the mesh vertex positions.
+ * @param indices - the mesh triangle indices.
+ * @returns the content key string.
+ */
+export function computeContentKey(positions, indices) {
+    const posHash = hashTypedArray(positions);
+    const idxHash = hashTypedArray(indices);
+    return `${posHash}_${idxHash}_${positions.length}_${indices.length}`;
+}
+// ── stableFingerprint (P0-3) ──
+/**
+ * Compute a deterministic fingerprint for an arbitrary value, used by the
+ * incremental update gates (G6/G7/G8) to detect whether params, libIds, or
+ * partTransform have changed since the last successful execution.
+ *
+ * Design constraints:
+ * - `undefined` and `null` are normalized to `null` (so "no params" and
+ *   "empty object params" are not treated as different).
+ * - Object keys are sorted before hashing (iteration order independent).
+ * - Circular references are detected and represented stably (no infinite loop).
+ * - Functions and Symbols have a deterministic degradation rule (type-tagged).
+ * - Arrays preserve element order (position-sensitive).
+ * @param value - the value to fingerprint (params / libIds / partTransform).
+ * @returns a hex string fingerprint.
+ */
+export function stableFingerprint(value) {
+    const seen = new WeakSet();
+    let hash = 0x811c9dc5;
+    const mix = (s) => {
+        for (let i = 0; i < s.length; i++) {
+            hash ^= s.charCodeAt(i);
+            hash = Math.imul(hash, 0x01000193);
+        }
+    };
+    const visit = (v, depth) => {
+        if (depth > 50) {
+            mix('!depth!');
+            return;
+        }
+        // Normalize undefined/null to null
+        if (v === undefined || v === null) {
+            mix('null');
+            return;
+        }
+        const t = typeof v;
+        if (t === 'boolean') {
+            mix(v ? 'B1' : 'B0');
+            return;
+        }
+        if (t === 'number') {
+            mix('N:' + v);
+            return;
+        }
+        if (t === 'string') {
+            mix('S:' + v);
+            return;
+        }
+        if (t === 'bigint') {
+            mix('G:' + v.toString());
+            return;
+        }
+        if (t === 'symbol') {
+            mix('SYM:' + (v.description ?? ''));
+            return;
+        }
+        if (t === 'function') {
+            mix('FN');
+            return;
+        }
+        // Object / array
+        const obj = v;
+        if (seen.has(obj)) {
+            mix('!cycle!');
+            return;
+        }
+        seen.add(obj);
+        if (Array.isArray(v)) {
+            mix('A[' + v.length + ']');
+            for (const el of v)
+                visit(el, depth + 1);
+            return;
+        }
+        // Map: sort by key string for stable order
+        if (v instanceof Map) {
+            const entries = [...v.entries()].sort((a, b) => String(a[0]) < String(b[0]) ? -1 : String(a[0]) > String(b[0]) ? 1 : 0);
+            mix('M[' + entries.length + ']');
+            for (const [k, val] of entries) {
+                mix('K:' + String(k) + ':');
+                visit(val, depth + 1);
+            }
+            return;
+        }
+        // Set: sort members for stable order
+        if (v instanceof Set) {
+            const members = [...v].sort((a, b) => String(a) < String(b) ? -1 : String(a) > String(b) ? 1 : 0);
+            mix('SET[' + members.length + ']');
+            for (const m of members)
+                visit(m, depth + 1);
+            return;
+        }
+        // Plain object: sort keys
+        const keys = Object.keys(obj).sort();
+        mix('O{' + keys.length + '}');
+        for (const k of keys) {
+            mix('k:' + k + ':');
+            visit(obj[k], depth + 1);
+        }
+    };
+    visit(value, 0);
+    hash ^= 0xff;
+    hash = Math.imul(hash, 0x01000193);
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}
+//# sourceMappingURL=content-key.js.map

package/dist/cad-runtime/content-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-key.js","sourceRoot":"","sources":["../../src/cad-runtime/content-key.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * content-key — mesh 内容哈希（statementKey / plan 增量判定共用）\n *\n * 从 runtime.ts 提取为独立模块，供 CadRuntime 与 DirectExecutor 共享。\n */\n\n/** FNV-1a 哈希（typed array 逐元素） */\nfunction hashTypedArray(arr: Float32Array | Uint32Array): string {\n  let hash = 0x811c9dc5\n  const len = arr.length\n  for (let i = 0; i < len; i++) {\n    hash ^= arr[i]\n    hash = Math.imul(hash, 0x01000193)\n  }\n  hash ^= len\n  hash = Math.imul(hash, 0x01000193)\n  return (hash >>> 0).toString(16).padStart(8, '0')\n}\n\n/**\n * Compute the mesh content key (hash of positions and indices) used to decide\n * incremental execution.\n * @param positions - the mesh vertex positions.\n * @param indices - the mesh triangle indices.\n * @returns the content key string.\n */\nexport function computeContentKey(positions: Float32Array, indices: Uint32Array): string {\n  const posHash = hashTypedArray(positions)\n  const idxHash = hashTypedArray(indices)\n  return `${posHash}_${idxHash}_${positions.length}_${indices.length}`\n}\n\n// ── stableFingerprint (P0-3) ──\n\n/**\n * Compute a deterministic fingerprint for an arbitrary value, used by the\n * incremental update gates (G6/G7/G8) to detect whether params, libIds, or\n * partTransform have changed since the last successful execution.\n *\n * Design constraints:\n * - `undefined` and `null` are normalized to `null` (so \"no params\" and\n *   \"empty object params\" are not treated as different).\n * - Object keys are sorted before hashing (iteration order independent).\n * - Circular references are detected and represented stably (no infinite loop).\n * - Functions and Symbols have a deterministic degradation rule (type-tagged).\n * - Arrays preserve element order (position-sensitive).\n * @param value - the value to fingerprint (params / libIds / partTransform).\n * @returns a hex string fingerprint.\n */\nexport function stableFingerprint(value: unknown): string {\n  const seen = new WeakSet<object>()\n  let hash = 0x811c9dc5\n\n  const mix = (s: string): void => {\n    for (let i = 0; i < s.length; i++) {\n      hash ^= s.charCodeAt(i)\n      hash = Math.imul(hash, 0x01000193)\n    }\n  }\n\n  const visit = (v: unknown, depth: number): void => {\n    if (depth > 50) { mix('!depth!'); return }\n\n    // Normalize undefined/null to null\n    if (v === undefined || v === null) { mix('null'); return }\n\n    const t = typeof v\n\n    if (t === 'boolean') { mix(v ? 'B1' : 'B0'); return }\n    if (t === 'number') { mix('N:' + v); return }\n    if (t === 'string') { mix('S:' + v); return }\n    if (t === 'bigint') { mix('G:' + v.toString()); return }\n    if (t === 'symbol') { mix('SYM:' + ((v as symbol).description ?? '')); return }\n    if (t === 'function') { mix('FN'); return }\n\n    // Object / array\n    const obj = v as object\n    if (seen.has(obj)) { mix('!cycle!'); return }\n    seen.add(obj)\n\n    if (Array.isArray(v)) {\n      mix('A[' + v.length + ']')\n      for (const el of v) visit(el, depth + 1)\n      return\n    }\n\n    // Map: sort by key string for stable order\n    if (v instanceof Map) {\n      const entries = [...v.entries()].sort((a, b) =>\n        String(a[0]) < String(b[0]) ? -1 : String(a[0]) > String(b[0]) ? 1 : 0,\n      )\n      mix('M[' + entries.length + ']')\n      for (const [k, val] of entries) {\n        mix('K:' + String(k) + ':')\n        visit(val, depth + 1)\n      }\n      return\n    }\n\n    // Set: sort members for stable order\n    if (v instanceof Set) {\n      const members = [...v].sort((a, b) =>\n        String(a) < String(b) ? -1 : String(a) > String(b) ? 1 : 0,\n      )\n      mix('SET[' + members.length + ']')\n      for (const m of members) visit(m, depth + 1)\n      return\n    }\n\n    // Plain object: sort keys\n    const keys = Object.keys(obj).sort()\n    mix('O{' + keys.length + '}')\n    for (const k of keys) {\n      mix('k:' + k + ':')\n      visit((obj as Record<string, unknown>)[k], depth + 1)\n    }\n  }\n\n  visit(value, 0)\n  hash ^= 0xff\n  hash = Math.imul(hash, 0x01000193)\n  return (hash >>> 0).toString(16).padStart(8, '0')\n}\n"]}

package/dist/cad-runtime/createRuntimeWithCad.d.ts

@@ -0,0 +1,22 @@
+/**
+ * createRuntimeWithCad — D1（2026-09-19）：cad 默认命名空间内置引擎。
+ *
+ * faijs 的定位是「引擎 + 标准库」。cad 经 defineOp 注册为均匀库数据，与第三方库
+ * 走完全相同的 registerLib 路径，引擎并不对其特判（K5 不违反）。因此宿主拿到
+ * createRuntime 即带 cad，无需再经独立的门面包注入——这正是删除门面（D2-A）的前提。
+ *
+ * 需要「不带 cad 的纯引擎」的宿主（如只想用 parser / runtime 框架自注册别的 op 集）
+ * 可直接用 cad-runtime/runtime 的 createRuntime（不带 cad 注册）。
+ */
+import { type CadRuntime, type CadRuntimeOptions } from './runtime.js';
+import type { ExecutionMode, HostPorts } from './ports.js';
+export { CadRuntime, computeContentKey, AppendPrefixError } from './runtime.js';
+/**
+ * 创建带内置 `cad` 库的 CadRuntime（D1）。
+ * @param ports - host ports (io/env/kernel backends) supplied by the embedding host.
+ * @param mode - execution mode ('auto' | 'brep' | 'mesh'); defaults to the runtime's own logic.
+ * @param options - additional CadRuntime options (forwarded to the core runtime).
+ * @returns a CadRuntime with the `cad` namespace pre-registered as the default lib.
+ */
+export declare function createRuntime(ports: HostPorts, mode?: ExecutionMode, options?: CadRuntimeOptions): CadRuntime;
+//# sourceMappingURL=createRuntimeWithCad.d.ts.map

package/dist/cad-runtime/createRuntimeWithCad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRuntimeWithCad.d.ts","sourceRoot":"","sources":["../../src/cad-runtime/createRuntimeWithCad.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAsC,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAA;AACvG,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAGvD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAE5E;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAO7G"}

package/dist/cad-runtime/createRuntimeWithCad.js

@@ -0,0 +1,29 @@
+/**
+ * createRuntimeWithCad — D1（2026-09-19）：cad 默认命名空间内置引擎。
+ *
+ * faijs 的定位是「引擎 + 标准库」。cad 经 defineOp 注册为均匀库数据，与第三方库
+ * 走完全相同的 registerLib 路径，引擎并不对其特判（K5 不违反）。因此宿主拿到
+ * createRuntime 即带 cad，无需再经独立的门面包注入——这正是删除门面（D2-A）的前提。
+ *
+ * 需要「不带 cad 的纯引擎」的宿主（如只想用 parser / runtime 框架自注册别的 op 集）
+ * 可直接用 cad-runtime/runtime 的 createRuntime（不带 cad 注册）。
+ */
+import { createRuntime as createRuntimeCore } from './runtime.js';
+import { createApiNamespace } from '../api/api-namespace.js';
+export { CadRuntime, computeContentKey, AppendPrefixError } from './runtime.js';
+/**
+ * 创建带内置 `cad` 库的 CadRuntime（D1）。
+ * @param ports - host ports (io/env/kernel backends) supplied by the embedding host.
+ * @param mode - execution mode ('auto' | 'brep' | 'mesh'); defaults to the runtime's own logic.
+ * @param options - additional CadRuntime options (forwarded to the core runtime).
+ * @returns a CadRuntime with the `cad` namespace pre-registered as the default lib.
+ */
+export function createRuntime(ports, mode, options) {
+    const rt = createRuntimeCore(ports, mode, undefined, options);
+    rt.registerLib('cad', createApiNamespace(), {
+        default: true,
+        packageName: '@faicad/faijs',
+    });
+    return rt;
+}
+//# sourceMappingURL=createRuntimeWithCad.js.map

package/dist/cad-runtime/createRuntimeWithCad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRuntimeWithCad.js","sourceRoot":"","sources":["../../src/cad-runtime/createRuntimeWithCad.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAA2C,MAAM,WAAW,CAAA;AAEvG,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAEzD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAE5E;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAgB,EAAE,IAAoB,EAAE,OAA2B;IAC/F,MAAM,EAAE,GAAG,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;IAC7D,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,kBAAkB,EAAE,EAAE;QAC1C,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,eAAe;KAC7B,CAAC,CAAA;IACF,OAAO,EAAE,CAAA;AACX,CAAC","sourcesContent":["/**\n * createRuntimeWithCad — D1（2026-09-19）：cad 默认命名空间内置引擎。\n *\n * faijs 的定位是「引擎 + 标准库」。cad 经 defineOp 注册为均匀库数据，与第三方库\n * 走完全相同的 registerLib 路径，引擎并不对其特判（K5 不违反）。因此宿主拿到\n * createRuntime 即带 cad，无需再经独立的门面包注入——这正是删除门面（D2-A）的前提。\n *\n * 需要「不带 cad 的纯引擎」的宿主（如只想用 parser / runtime 框架自注册别的 op 集）\n * 可直接用 cad-runtime/runtime 的 createRuntime（不带 cad 注册）。\n */\nimport { createRuntime as createRuntimeCore, type CadRuntime, type CadRuntimeOptions } from './runtime'\nimport type { ExecutionMode, HostPorts } from './ports'\nimport { createApiNamespace } from '../api/api-namespace'\n\nexport { CadRuntime, computeContentKey, AppendPrefixError } from './runtime'\n\n/**\n * 创建带内置 `cad` 库的 CadRuntime（D1）。\n * @param ports - host ports (io/env/kernel backends) supplied by the embedding host.\n * @param mode - execution mode ('auto' | 'brep' | 'mesh'); defaults to the runtime's own logic.\n * @param options - additional CadRuntime options (forwarded to the core runtime).\n * @returns a CadRuntime with the `cad` namespace pre-registered as the default lib.\n */\nexport function createRuntime(ports: HostPorts, mode?: ExecutionMode, options?: CadRuntimeOptions): CadRuntime {\n  const rt = createRuntimeCore(ports, mode, undefined, options)\n  rt.registerLib('cad', createApiNamespace(), {\n    default: true,\n    packageName: '@faicad/faijs',\n  })\n  return rt\n}\n"]}