@faicad/faijs 0.14.1 → 0.16.0

package/dist/api/text.js

@@ -1,101 +0,0 @@
-/**
- * stdlib text — 文字创建库函数（text）
- *
- *
- * dispatchPath 静态判定 brep/mesh，产物经 solid()/fromBrep() 构造器创建。
- */
-import { cad } from '../mesh/index.js';
-import { solidToShape } from '../brep/brep-ops.js';
-import { textToSolid } from '../brep/text/text-to-solid.js';
-import { ensureDefaultFont } from '../brep/text/fontRegistry.js';
-import { getSolidBoundingBox } from '../brep/brep-utils.js';
-import { containsCjk, loadSystemCjkFont } from '../primitives/text/cjk.js';
-import { getBackends } from '../runtime-state.js';
-import { fromBrep } from '../shape.js';
-import { defineOp } from '../sdk.js';
-import { assertPositiveNumber } from './assert.js';
-/**
- * Validate text parameters: `text` must be a non-empty string, and `size` and
- * `depth` must be positive numbers.
- * @param params - the raw text operation parameters.
- */
-export function assertTextParams(params) {
-    if (typeof params.text !== 'string' || params.text.trim() === '') {
-        throw new Error(`[stdlib/text] text must be a non-empty string, got ${JSON.stringify(params.text)}`);
-    }
-    assertPositiveNumber(params.size, 'text.size');
-    assertPositiveNumber(params.depth, 'text.depth');
-}
-/**
- * BREP 路径：opentype.js → OCCT wire/face → extrude → center + fromBrep 登记。
- *
- * 与 mesh 路径一样，当文本包含 CJK 字符但没有 CJK 字体时，
- * 将 CJK 字符替换为 '?' 以实现优雅降级。
- */
-async function textBrep(params) {
-    const kernel = getBackends().kernel.brep;
-    if (!kernel)
-        throw new Error('[stdlib/text] no OCCT kernel');
-    await ensureDefaultFont();
-    const text = params.text;
-    const size = params.size;
-    const depth = params.depth;
-    // 如果文本包含 CJK 字符，检查是否有 CJK 字体
-    let renderText = text;
-    if (containsCjk(text)) {
-        const cjkResult = await loadSystemCjkFont();
-        if (!cjkResult) {
-            // 无 CJK 字体：将 CJK 字符替换为 '?' 以实现优雅降级
-            renderText = text.replace(/[\u4E00-\u9FFF\u3400-\u4DBF\u2F800-\u2FA1F\u3000-\u303F\uFF00-\uFFEF]/g, '?');
-        }
-    }
-    // 将文字转换为 OCCT solid
-    const rawSolid = textToSolid(kernel, renderText, {
-        fontSize: size,
-        depth,
-    });
-    // Center the solid to match mesh path behavior:
-    // X/Z centered at origin, Y bottom aligned to 0
-    const bbox = getSolidBoundingBox(kernel, rawSolid);
-    const cx = (bbox.min[0] + bbox.max[0]) / 2;
-    const cz = (bbox.min[2] + bbox.max[2]) / 2;
-    const centeredSolid = kernel.translate(rawSolid, -cx, -bbox.min[1], -cz);
-    kernel.release(rawSolid);
-    return fromBrep(solidToShape(kernel, centeredSolid), { solid: centeredSolid });
-}
-/** 兼容两种调用形态：`cad.text({ text, size, depth })`（创建类）与
- * `cad.text(part0, { text, size, depth })`（历史 fixture 带输入参数，输入被忽略）。 */
-function textParamsOf(inputOrParams, maybeParams) {
-    return (maybeParams ?? inputOrParams ?? {});
-}
-/**
- * 生成文字零件（文字轮廓挤出，X/Z 居中、Y 底部对齐原点）。
- * @group 创建
- * @inputs 0
- * @async true
- * @qual warn
- * @name text
- * @returns Shape 文字几何，生成独立零件。
- * @param maybeParams - 兼容形态的补充参数（正常不传）。type:Record<string, unknown> required:false
- * @param inputOrParams.text - 要生成的文字。type:string required:true
- * @param inputOrParams.size - 字号（mm）。type:number required:true
- * @param inputOrParams.depth - 挤出深度（mm）。type:number required:true
- * @param inputOrParams.font - 字体。type:string 默认 默认字体
- * @note font 语义未定（当前只有默认字体），⚠️ 暂不要传。兼容 `cad.text(part0, {...})` 带输入形态（输入被忽略），正常写 `cad.text({...})` 即可。
- * @example
- * const t = await cad.text({ text: 'Hello', size: 20, depth: 5 })
-  */
-export const text = defineOp({
-    mesh: async (inputOrParams, maybeParams) => {
-        const params = textParamsOf(inputOrParams, maybeParams);
-        assertTextParams(params);
-        return cad.text({ text: params.text, size: params.size, depth: params.depth });
-    },
-    brep: async (inputOrParams, maybeParams) => {
-        const params = textParamsOf(inputOrParams, maybeParams);
-        assertTextParams(params);
-        return textBrep(params);
-    },
-    naming: { kind: 'construct', newFaces: { via: 'explicit', vocab: [] } },
-});
-//# sourceMappingURL=text.js.map

package/dist/api/text.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/api/text.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * stdlib text — 文字创建库函数（text）\n *\n *\n * dispatchPath 静态判定 brep/mesh，产物经 solid()/fromBrep() 构造器创建。\n */\n\nimport type { Shape } from '../mesh/types'\nimport { cad } from '../mesh'\nimport { solidToShape } from '../brep/brep-ops'\nimport { textToSolid } from '../brep/text/text-to-solid'\nimport { ensureDefaultFont } from '../brep/text/fontRegistry'\nimport { getSolidBoundingBox } from '../brep/brep-utils'\nimport { containsCjk, loadSystemCjkFont } from '../primitives/text/cjk'\nimport { getBackends } from '../runtime-state'\nimport { fromBrep } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { Provenance } from '../topology/naming/lineage'\nimport { assertPositiveNumber } from './assert'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\n\n/**\n * Validate text parameters: `text` must be a non-empty string, and `size` and\n * `depth` must be positive numbers.\n * @param params - the raw text operation parameters.\n */\nexport function assertTextParams(params: Record<string, unknown>): void {\n  if (typeof params.text !== 'string' || params.text.trim() === '') {\n    throw new Error(`[stdlib/text] text must be a non-empty string, got ${JSON.stringify(params.text)}`)\n  }\n  assertPositiveNumber(params.size, 'text.size')\n  assertPositiveNumber(params.depth, 'text.depth')\n}\n\n/**\n * BREP 路径：opentype.js → OCCT wire/face → extrude → center + fromBrep 登记。\n *\n * 与 mesh 路径一样，当文本包含 CJK 字符但没有 CJK 字体时，\n * 将 CJK 字符替换为 '?' 以实现优雅降级。\n */\nasync function textBrep(params: Record<string, unknown>): Promise<Shape> {\n  const kernel = getBackends().kernel.brep as BrepEngineApi | null\n  if (!kernel) throw new Error('[stdlib/text] no OCCT kernel')\n\n  await ensureDefaultFont()\n\n  const text = params.text as string\n  const size = params.size as number\n  const depth = params.depth as number\n\n  // 如果文本包含 CJK 字符，检查是否有 CJK 字体\n  let renderText = text\n  if (containsCjk(text)) {\n    const cjkResult = await loadSystemCjkFont()\n    if (!cjkResult) {\n      // 无 CJK 字体：将 CJK 字符替换为 '?' 以实现优雅降级\n      renderText = text.replace(/[\\u4E00-\\u9FFF\\u3400-\\u4DBF\\u2F800-\\u2FA1F\\u3000-\\u303F\\uFF00-\\uFFEF]/g, '?')\n    }\n  }\n\n  // 将文字转换为 OCCT solid\n  const rawSolid = textToSolid(kernel, renderText, {\n    fontSize: size,\n    depth,\n  })\n\n  // Center the solid to match mesh path behavior:\n  // X/Z centered at origin, Y bottom aligned to 0\n  const bbox = getSolidBoundingBox(kernel, rawSolid)\n  const cx = (bbox.min[0] + bbox.max[0]) / 2\n  const cz = (bbox.min[2] + bbox.max[2]) / 2\n  const centeredSolid = kernel.translate(rawSolid, -cx, -bbox.min[1], -cz)\n  kernel.release(rawSolid)\n\n  return fromBrep(solidToShape(kernel, centeredSolid), { solid: centeredSolid })\n}\n\n/** 兼容两种调用形态：`cad.text({ text, size, depth })`（创建类）与\n * `cad.text(part0, { text, size, depth })`（历史 fixture 带输入参数，输入被忽略）。 */\nfunction textParamsOf(inputOrParams: unknown, maybeParams?: Record<string, unknown>): Record<string, unknown> {\n  return (maybeParams ?? inputOrParams ?? {}) as Record<string, unknown>\n}\n\n/**\n * 生成文字零件（文字轮廓挤出，X/Z 居中、Y 底部对齐原点）。\n * @group 创建\n * @inputs 0\n * @async true\n * @qual warn\n * @name text\n * @returns Shape 文字几何，生成独立零件。\n * @param maybeParams - 兼容形态的补充参数（正常不传）。type:Record<string, unknown> required:false\n * @param inputOrParams.text - 要生成的文字。type:string required:true\n * @param inputOrParams.size - 字号（mm）。type:number required:true\n * @param inputOrParams.depth - 挤出深度（mm）。type:number required:true\n * @param inputOrParams.font - 字体。type:string 默认 默认字体\n * @note font 语义未定（当前只有默认字体），⚠️ 暂不要传。兼容 `cad.text(part0, {...})` 带输入形态（输入被忽略），正常写 `cad.text({...})` 即可。\n * @example\n * const t = await cad.text({ text: 'Hello', size: 20, depth: 5 })\n  */\nexport const text = defineOp({\n  mesh: async (inputOrParams: unknown, maybeParams?: Record<string, unknown>) => {\n    const params = textParamsOf(inputOrParams, maybeParams)\n    assertTextParams(params)\n    return cad.text({ text: params.text as string, size: params.size as number, depth: params.depth as number })\n  },\n  brep: async (inputOrParams: unknown, maybeParams?: Record<string, unknown>) => {\n    const params = textParamsOf(inputOrParams, maybeParams)\n    assertTextParams(params)\n    return textBrep(params)\n  },\n  naming: { kind: 'construct', newFaces: { via: 'explicit', vocab: [] } } as Provenance,\n})\n"]}

package/dist/brep/text/fontTestHelper.d.ts

@@ -1,30 +0,0 @@
-/**
- * 测试环境字体加载器 — Node/vitest 专用
- *
- * 通过 fs.readFileSync 读取字体文件，注入到 fontRegistry。
- *
- * 用法（在测试 beforeAll 中）：
- *   await setupTestFont()  // 设置 loader + 加载字体
- *
- * 或仅设置 loader（字体由 executeText → ensureDefaultFont 惰性加载）：
- *   ensureTestFontLoader()
- *
- * 字体文件唯一真源：src/assets/fonts/OpenSans-Regular.ttf
- */
-/**
- * 设置 fs 字体加载器（幂等，多次调用安全）。
- *
- * 设置后，ensureDefaultFont() 会用此 loader 读取字体文件。
- */
-export declare function ensureTestFontLoader(): void;
-/**
- * 设置 fs 字体加载器并立即加载字体。
- *
- * 适用于直接调用 text-to-solid（不经 executeText）的测试：
- * text-to-solid 内部调用 getFont()，需要字体已注册。
- *
- * 对于经 executeText 的测试，只需 ensureTestFontLoader() 即可，
- * 因为 executeTextBrep 会调用 ensureDefaultFont() 惰性加载。
- */
-export declare function setupTestFont(): Promise<void>;
-//# sourceMappingURL=fontTestHelper.d.ts.map

package/dist/brep/text/fontTestHelper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fontTestHelper.d.ts","sourceRoot":"","sources":["../../../src/brep/text/fontTestHelper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAyBH;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAGnD"}

package/dist/brep/text/fontTestHelper.js

@@ -1,57 +0,0 @@
-/**
- * 测试环境字体加载器 — Node/vitest 专用
- *
- * 通过 fs.readFileSync 读取字体文件，注入到 fontRegistry。
- *
- * 用法（在测试 beforeAll 中）：
- *   await setupTestFont()  // 设置 loader + 加载字体
- *
- * 或仅设置 loader（字体由 executeText → ensureDefaultFont 惰性加载）：
- *   ensureTestFontLoader()
- *
- * 字体文件唯一真源：src/assets/fonts/OpenSans-Regular.ttf
- */
-import { readFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { setFontLoader, ensureDefaultFont } from './fontRegistry.js';
-let fontBuffer = null;
-function getFontBuffer() {
-    if (fontBuffer)
-        return fontBuffer;
-    // 模块相对（P6：与 cwd 无关）
-    const fontPath = fileURLToPath(new URL('../../assets/fonts/OpenSans-Regular.ttf', import.meta.url));
-    const buf = readFileSync(fontPath);
-    fontBuffer = buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);
-    return fontBuffer;
-}
-const fsFontLoader = {
-    async loadDefaultFont() {
-        return getFontBuffer();
-    },
-};
-let loaderSet = false;
-/**
- * 设置 fs 字体加载器（幂等，多次调用安全）。
- *
- * 设置后，ensureDefaultFont() 会用此 loader 读取字体文件。
- */
-export function ensureTestFontLoader() {
-    if (loaderSet)
-        return;
-    loaderSet = true;
-    setFontLoader(fsFontLoader);
-}
-/**
- * 设置 fs 字体加载器并立即加载字体。
- *
- * 适用于直接调用 text-to-solid（不经 executeText）的测试：
- * text-to-solid 内部调用 getFont()，需要字体已注册。
- *
- * 对于经 executeText 的测试，只需 ensureTestFontLoader() 即可，
- * 因为 executeTextBrep 会调用 ensureDefaultFont() 惰性加载。
- */
-export async function setupTestFont() {
-    ensureTestFontLoader();
-    await ensureDefaultFont();
-}
-//# sourceMappingURL=fontTestHelper.js.map

package/dist/brep/text/fontTestHelper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fontTestHelper.js","sourceRoot":"","sources":["../../../src/brep/text/fontTestHelper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAmB,MAAM,gBAAgB,CAAA;AAElF,IAAI,UAAU,GAAuB,IAAI,CAAA;AAEzC,SAAS,aAAa;IACpB,IAAI,UAAU;QAAE,OAAO,UAAU,CAAA;IACjC,oBAAoB;IACpB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,yCAAyC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IACnG,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;IAClC,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAgB,CAAA;IAC7F,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,MAAM,YAAY,GAAe;IAC/B,KAAK,CAAC,eAAe;QACnB,OAAO,aAAa,EAAE,CAAA;IACxB,CAAC;CACF,CAAA;AAED,IAAI,SAAS,GAAG,KAAK,CAAA;AAErB;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,SAAS;QAAE,OAAM;IACrB,SAAS,GAAG,IAAI,CAAA;IAChB,aAAa,CAAC,YAAY,CAAC,CAAA;AAC7B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,oBAAoB,EAAE,CAAA;IACtB,MAAM,iBAAiB,EAAE,CAAA;AAC3B,CAAC","sourcesContent":["/**\n * 测试环境字体加载器 — Node/vitest 专用\n *\n * 通过 fs.readFileSync 读取字体文件，注入到 fontRegistry。\n *\n * 用法（在测试 beforeAll 中）：\n *   await setupTestFont()  // 设置 loader + 加载字体\n *\n * 或仅设置 loader（字体由 executeText → ensureDefaultFont 惰性加载）：\n *   ensureTestFontLoader()\n *\n * 字体文件唯一真源：src/assets/fonts/OpenSans-Regular.ttf\n */\n\nimport { readFileSync } from 'node:fs'\nimport { fileURLToPath } from 'node:url'\nimport { setFontLoader, ensureDefaultFont, type FontLoader } from './fontRegistry'\n\nlet fontBuffer: ArrayBuffer | null = null\n\nfunction getFontBuffer(): ArrayBuffer {\n  if (fontBuffer) return fontBuffer\n  // 模块相对（P6：与 cwd 无关）\n  const fontPath = fileURLToPath(new URL('../../assets/fonts/OpenSans-Regular.ttf', import.meta.url))\n  const buf = readFileSync(fontPath)\n  fontBuffer = buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength) as ArrayBuffer\n  return fontBuffer\n}\n\nconst fsFontLoader: FontLoader = {\n  async loadDefaultFont(): Promise<ArrayBuffer> {\n    return getFontBuffer()\n  },\n}\n\nlet loaderSet = false\n\n/**\n * 设置 fs 字体加载器（幂等，多次调用安全）。\n *\n * 设置后，ensureDefaultFont() 会用此 loader 读取字体文件。\n */\nexport function ensureTestFontLoader(): void {\n  if (loaderSet) return\n  loaderSet = true\n  setFontLoader(fsFontLoader)\n}\n\n/**\n * 设置 fs 字体加载器并立即加载字体。\n *\n * 适用于直接调用 text-to-solid（不经 executeText）的测试：\n * text-to-solid 内部调用 getFont()，需要字体已注册。\n *\n * 对于经 executeText 的测试，只需 ensureTestFontLoader() 即可，\n * 因为 executeTextBrep 会调用 ensureDefaultFont() 惰性加载。\n */\nexport async function setupTestFont(): Promise<void> {\n  ensureTestFontLoader()\n  await ensureDefaultFont()\n}\n"]}

package/dist/cad-runtime/module-executor.d.ts

@@ -1,271 +0,0 @@
-/**
- * module-executor — JS VM 模块加载与增量调度（VM 执行方案 Phase 1）
- *
- *
- * ModuleExecutor 是 VM 执行的核心：
- * - `ctx` 持久变量容器（跨 execute/append/update 存活）
- * - `load(code)` 用 data:/Blob URL 动态 import 编译产物（零 import，两平台同构）
- * - `executeAll/executeIds/executeFrom` 按 deps 拓扑序调度
- * - `reconcileCtx` 回收"定义语句已不在脚本中"的变量并释放其内核资源
- * - `cache` 记录每语句 statementKey + outputContentKey（plan 增量判定）
- */
-import type { CompiledStatementMeta } from '../lang/compile.js';
-import type { StatementIR, ScriptIR } from '../lang/types.js';
-import { type InternalKeepRecord } from '../lang/keep.js';
-import type { Shape } from '../mesh/types.js';
-import type { BrepHandle } from '../brep/engine/types.js';
-import type { PartName, StmtId } from '../identity.js';
-import { type StdlibNamespace } from '../runtime-state.js';
-/**
- * 已装配的命名空间集合（标准库 `cad` + 宿主注册的库）。
- * 编译产物 `fn(ctx, ns)` 经 ns.<binding>.<callee>() 调用——引擎不区分函数来自哪个库。
- */
-export interface Namespaces {
-    readonly cad: StdlibNamespace;
-    readonly [binding: string]: StdlibNamespace;
-}
-/**
- * 执行记账（P5：exec 上下文删除后，ModuleExecutor 只需 beforeStatement + outputCache）。
- * beforeStatement：undo 逐语句快照钩子；outputCache：语句产物缓存（collectResult 消费）。
- */
-export interface ExecBookkeeping {
-    beforeStatement?: (stmtId: string, index: number) => void;
-    outputCache: Map<PartName, Shape>;
-    /** 变更声明（P6：引擎比对推导 + 装配应用记录），collectResult 消费。 */
-    changed: Set<PartName>;
-}
-/** 编译产物中的单条语句（模块文本 `{ id, deps, fn }`）。 */
-export interface CompiledStatement {
-    id: StmtId;
-    deps: StmtId[];
-    fn: (ctx: Record<string, unknown>, ns: Namespaces) => Promise<void>;
-}
-/**
- * Options for constructing a ModuleExecutor, providing the OCCT handle
- * callbacks the executor needs to integrate with the runtime's persistent
- * solid caches.
- */
-export interface ModuleExecutorOptions {
-    /** Release the OCCT handle for a PartName (called when reconcileCtx deletes a variable; no-op without a handle). */
-    releaseSolid?: (partName: PartName) => void;
-    /** Read the OCCT handle currently held for a PartName (used for replacement-release pre-capture). */
-    getSolid?: (partName: PartName) => BrepHandle | undefined;
-    /** Release a previously captured OCCT handle (replacement release: free the old handle after a same-id recompute succeeds). */
-    releaseHandle?: (handle: BrepHandle) => void;
-    /** Sync an identity-slot solid into the PartName-keyed solidCache (relied on by existing runtime logic). */
-    setSolid?: (partName: PartName, solid: BrepHandle) => void;
-    /** Sync an identity-slot faceEvolution into the PartName-keyed faceEvolutionCache. */
-    setFaceEvolution?: (partName: PartName, evo: Map<number, number[]>) => void;
-    /** Sync an identity-slot roleTable into the PartName-keyed roleTableCache (§2.3 naming). */
-    setRoleTable?: (partName: PartName, roleTable: unknown) => void;
-}
-/**
- * ModuleExecutor loads JS VM modules and schedules incremental execution.
- *
- * It is the heart of the VM execution approach: it keeps the persistent `ctx`
- * variable container alive across execute/append/update calls, dynamically
- * imports compiled modules from data:/Blob URLs (zero imports, isomorphic on
- * both platforms), schedules all/selected/from statements in dependency
- * topological order, reclaims variables whose defining statements have left the
- * script, and caches each statement's key + output content key for incremental
- * planning.
- */
-export declare class ModuleExecutor {
-    /** Persistent variable container across incremental executions. */
-    readonly ctx: Record<string, unknown>;
-    private stmts;
-    /** statementKey 缓存（增量判定；key = op|JSON(args)|deps 的 outputContentKey） */
-    private cache;
-    /**
-     * 函数体 keep 登记（keep-syntax 设计 §2.2）：
-     * stmtId → { kept, hidden }。语句执行前清空本条记录，执行中累加；
-     * 本轮未执行（缓存命中）→ 保留上一轮记录（keep 零重算的前提）。
-     */
-    readonly internalKeep: Map<StmtId, InternalKeepRecord>;
-    private sourceById;
-    private metaById;
-    private script;
-    private lastCode;
-    /**
-     * 默认命名空间绑定名（U10/R2）：与 runtime 的 registerLib(…, {default: true}) 声明同步；
-     * statementKey/computeKey 中 namespace 缺省（undefined）的语句按该绑定名计 key。
-     */
-    private defaultNsName;
-    /**
-     * Sync the default namespace binding name (called by runtime.registerLib with {default:true}).
-     * @param name - the namespace binding name to use as default.
-     */
-    setDefaultNsName(name: string): void;
-    private namespaces;
-    /** 库内容身份表（binding → content hash；增量 key 版控，B2 §7.3） */
-    private libIds;
-    /** 本机函数调用嵌套深度（§5.5）：> 0 表示当前在函数体内执行——keep 登记被抑制。 */
-    private userFunctionDepth;
-    private readonly releaseSolid?;
-    private readonly getSolid?;
-    private readonly releaseHandle?;
-    private readonly setSolid?;
-    private readonly setFaceEvolution?;
-    private readonly setRoleTable?;
-    constructor(namespaces: Namespaces, options?: ModuleExecutorOptions);
-    /**
-     * Hot-update the assembled namespace set (after registerLib mounts a new
-     * library).
-     * @param namespaces - the new assembled namespaces.
-     * @param libIds - the library content-identity table (binding → libId), used
-     * to version library-branch statement keys (B2, §7.3).
-     */
-    setNamespaces(namespaces: Namespaces, libIds?: ReadonlyMap<string, string>): void;
-    /**
-     * Update the script and its compiled metadata (ctx stays alive).
-     * @param script - the parsed ScriptIR.
-     * @param compiled - the compiled statement metadata.
-     */
-    setCompiled(script: ScriptIR, compiled: CompiledStatementMeta[]): void;
-    /**
-     * Load the compiled module, skipping a reload when the code is unchanged
-     * (compiled-product cache).
-     * @param code - the compiled module source.
-     */
-    load(code: string): Promise<void>;
-    /**
-     * Execute every statement in dependency topological order (i.e. statement
-     * table order).
-     * @param exec - the execution bookkeeping.
-     */
-    executeAll(exec: ExecBookkeeping): Promise<void>;
-    /**
-     * Execute only the given statements (append: the prefix is already in the
-     * persistent ctx). As in the old interpreter, beforeStatement fires only for
-     * new_shape statements; void/same_shape statements (do_assemble/add_constraint)
-     * do not trigger it (do_assemble's fn delegates internally).
-     * @param ids - the compiled statement ids to execute.
-     * @param exec - the execution bookkeeping.
-     */
-    executeIds(ids: StmtId[], exec: ExecBookkeeping): Promise<void>;
-    /**
-     * Re-execute from the change points on (update: plan derives the stale set).
-     * The stale set is closed over deps (a statement depending on a stale one is
-     * itself stale) and runs in topological order.
-     * @param staleIds - the set of stale statement ids to recompute.
-     * @param exec - the execution bookkeeping.
-     */
-    executeFrom(staleIds: Set<StmtId>, exec: ExecBookkeeping): Promise<void>;
-    /**
-     * Reclaim ctx variables whose defining statement is no longer in the script
-     * and release their kernel resources (a required action after undoing a
-     * statement deletion). Variables in `referencedVars` are kept even when not
-     * written by an active statement (cross-file references to other files'
-     * parts).
-     * @param activeStmtIds - the ids of statements still considered active.
-     * @param writeSets - mapping of statement id to the variable names it writes.
-     * @param referencedVars - variable names still referenced by the active
-     * script; these survive reclaim.
-     */
-    reconcileCtx(activeStmtIds: Set<StmtId>, writeSets: Map<StmtId, PartName[]>, referencedVars?: Set<string>): void;
-    /** 清除所有缓存（key 缓存 + ctx 变量）。测试用：CadRuntime.clearStatementCache 调用。 */
-    clearCache(): void;
-    /**
-     * Read a statement's statementKey cache entry.
-     * @param id - the compiled statement id.
-     * @returns the cached key and output content key, or undefined.
-     */
-    getCachedKey(id: StmtId): {
-        key: string;
-        outputContentKey: string;
-    } | undefined;
-    /**
-     * Read a statement's function-body keep registration (used by the terminal-dag
-     * C1 check); undefined when none exists.
-     * @param id - the compiled statement id.
-     * @returns the internal keep record, or undefined.
-     */
-    getInternalKeep(id: StmtId): InternalKeepRecord | undefined;
-    /**
-     * Register a function-body keep entry into ModuleExecutor.internalKeep,
-     * accumulating during execution.
-     * @param id - the compiled statement id.
-     * @param names - the kept variable names.
-     * @param hidden - whether the kept variables are hidden.
-     */
-    registerKeep(id: StmtId, names: PartName[], hidden: boolean): void;
-    /**
-     * 函数 BREP 域释放（§5.6 / D13）：取走当前域的句柄登记表，收集本语句输出
-     * （返回值）可到达的全部句柄为 keep 集，释放登记域内除 keep 集外的全部句柄。
-     * 函数体内中间体的瞬态句柄在此一次性释放——单次调用内存有界，不逐轮释放。
-     */
-    private releaseFunctionBrepDomain;
-    /**
-     * Read a ctx variable.
-     * @param name - the variable name.
-     * @returns the variable value.
-     */
-    getCtxVar(name: string): unknown;
-    /**
-     * Write a ctx variable (used to sync assembly transforms from outputCache
-     * back into ctx).
-     * @param name - the variable name.
-     * @param value - the value to store.
-     */
-    setCtxVar(name: string, value: unknown): void;
-    /**
-     * All variable names currently held in the persistent ctx (covers parts
-     * executed by previous execute/append/update calls).
-     * @returns the ctx variable names.
-     */
-    listCtxKeys(): string[];
-    /**
-     * Returns the compiled metadata in params + statements order.
-     * @returns the compiled statement metadata array.
-     */
-    getMetas(): CompiledStatementMeta[];
-    /** 清空 ctx 与 statementKey 缓存（CadRuntime.dispose 用）。 */
-    clear(): void;
-    /** 语句执行后：ctx → outputCache 同步 + 身份槽 → solidCache/faceEvolutionCache 同步 + statementKey 缓存 + 装配传播。 */
-    private afterStatement;
-    /**
-     * P6：装配传播——取走全部待应用变换，引擎应用到成员（mesh 原地 + BREP 槽 + solidCache），
-     * 记录 changed，并让依赖成员的下游语句失效重算（DAG 重放，替代 exec.dependentsOf 图遍历）。
-     */
-    private applyPendingAssemblyTransforms;
-    /** 找出依赖给定变量名的语句（装配成员 → 消费它的下游）。 */
-    private computeDownstream;
-    /**
-     * 判定并发 part-brep-lost 事件。
-     *
-     * 判据：语句有几何输入且**全部**输入都在 BREP 链上，但输出**不在**链上
-     * → BREP 链在此断开（mesh-only 函数或 fallthrough）。
-     *
-     * true-JS-subset §4.4.2：几何输入 = positional 中的 VarRefIR + ExprIR.refs
-     * （表达式实参引用的 Shape 变量同样喂进本语句；CallRef 嵌套调用是只读查询不计）。
-     */
-    private emitBrepLost;
-    /**
-     * Compute a statementKey = op | JSON(positional + args without keep) | each
-     * dependency's output content key (parameter statements use the parameter
-     * value). The keep/keepHidden keys are excluded so toggling retain/hide state
-     * triggers no geometric recompute. plan() uses this with the current cache to
-     * compute the expected key for incremental decisions.
-     *
-     * true-JS-subset §4.4.1：位置实参槽入 key——ExprIR 可 JSON 化
-     * （text + refs + params），表达式文本变化即触发重算；表达式引用的上游变量
-     * 变化经 deps 的 outputContentKey 传递。
-     *
-     * 本机函数调用（local）：key 前缀 `local.<callee>#<bodyHash>`（§6.2 / P4 内容寻址）——
-     * 编辑函数体文本 → 所有调用该函数的语句 key 变化 → 下游失效重算；不改函数体零重算。
-     * @param meta - the compiled statement metadata.
-     * @param source - the source statement, or undefined for parameter statements.
-     * @returns the computed statement key string.
-     */
-    computeKey(meta: CompiledStatementMeta, source: StatementIR | undefined): string;
-    /**
-     * 按绑定名查 libId（setNamespaces 已存表；本机函数不含——只适用于库分支 key）。
-     * 库未登记或表缺失 → 'missing'，增量会自动失效重算。
-     * @param binding 命名空间绑定名。
-     * @returns 库的内容身份；`'missing'` 表示该绑定无登记身份。
-     */
-    libIdOf(binding: string): string;
-    /** outputContentKey：shape 语句 = mesh 内容哈希；参数语句 = 参数值。 */
-    private computeOutputContentKey;
-}
-//# sourceMappingURL=module-executor.d.ts.map

package/dist/cad-runtime/module-executor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"module-executor.d.ts","sourceRoot":"","sources":["../../src/cad-runtime/module-executor.ts"],"names":[],"mappings":"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"}