@faicad/faijs 0.14.1 → 0.16.0

package/dist/lang/symbol-table.generated.js

@@ -10,18 +10,13 @@ export default {
     "cylinder": {},
     "cone": {},
     "wedge": {},
-    "text": {},
     "screw": {},
-    "svgExtrude": {},
     "sketch": {},
     "sdf": {},
-    "load": {},
     "translate": {},
     "rotate_euler": {},
     "scale": {},
     "scale3d": {},
-    "fai_drill": {},
-    "fai_extrude": {},
     "engrave": {},
     "chamfer": {},
     "fillet": {},
@@ -31,10 +26,6 @@ export default {
     "intersect": {},
     "extrude": {},
     "revolve": {},
-    "fai_split": {},
-    "group": {},
-    "assembly": {},
-    "copy": {},
     "faceNormal": {},
     "bboxCenter": {},
     "bboxMin": {},
@@ -52,26 +43,25 @@ export default {
     "cut": {},
     "split": {},
     "linearPattern": {},
+    "circularPattern": {},
+    "gridPattern": {},
+    "rectangularPattern": {},
+    "mirrorJoin": {},
+    "mirror": {},
+    "clone": {},
     "torus": {},
     "fuse": {},
     "viewCamera": {},
     "projectView": {},
     "projectSheet": {},
-    "circularPattern": {},
-    "gridPattern": {},
     "drill": {},
     "pocket": {},
     "boss": {},
-    "mirrorJoin": {},
-    "rectangularPattern": {},
     "convexHull": {},
     "makeBaseBox": {},
     "ellipsoid": {},
     "rotate": {},
-    "mirror": {},
-    "clone": {},
     "applyMatrix": {},
-    "transformCopy": {},
     "locate": {},
     "offset": {},
     "heal": {},

package/dist/lang/symbol-table.generated.js.map

@@ -1 +1 @@
-{"version":3,"file":"symbol-table.generated.js","sourceRoot":"","sources":["../../src/lang/symbol-table.generated.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAe;IACb,KAAK,EAAE,EAAE;IACT,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,EAAE;IACd,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,YAAY,EAAE,EAAE;IAChB,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,EAAE;IACV,WAAW,EAAE,EAAE;IACf,cAAc,EAAE,EAAE;IAClB,OAAO,EAAE,EAAE;IACX,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,EAAE;IACf,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;IACX,UAAU,EAAE,EAAE;IACd,WAAW,EAAE,EAAE;IACf,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,EAAE;IACf,OAAO,EAAE,EAAE;IACX,UAAU,EAAE,EAAE;IACd,MAAM,EAAE,EAAE;IACV,YAAY,EAAE,EAAE;IAChB,YAAY,EAAE,EAAE;IAChB,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,iBAAiB,EAAE,EAAE;IACrB,mBAAmB,EAAE,EAAE;IACvB,cAAc,EAAE,EAAE;IAClB,OAAO,EAAE,EAAE;IACX,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,UAAU,EAAE,EAAE;IACd,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,EAAE;IACX,eAAe,EAAE,EAAE;IACnB,OAAO,EAAE,EAAE;IACX,MAAM,EAAE,EAAE;IACV,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,EAAE;IACjB,cAAc,EAAE,EAAE;IAClB,iBAAiB,EAAE,EAAE;IACrB,aAAa,EAAE,EAAE;IACjB,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,EAAE;IACV,YAAY,EAAE,EAAE;IAChB,oBAAoB,EAAE,EAAE;IACxB,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,EAAE;IACf,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,EAAE;IACX,aAAa,EAAE,EAAE;IACjB,eAAe,EAAE,EAAE;IACnB,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,EAAE;IACV,UAAU,EAAE,EAAE;IACd,UAAU,EAAE,EAAE;IACd,UAAU,EAAE,EAAE;IACd,WAAW,EAAE,EAAE;CAChB,CAAA","sourcesContent":["/**\n * symbol-table 生成文件 — 禁手改。\n * 由 scripts/gen-symbol-table.ts 从 api-namespace 的 cad 命名空间生成（键存在性）。\n * keep-syntax P1 后符号表只承载 check() 符号检查（\"函数不存在\"判定）；\n * 保留语义由 keep 声明表达，不再有 readonly 标注。\n */\nexport default {\n  \"box\": {},\n  \"sphere\": {},\n  \"cylinder\": {},\n  \"cone\": {},\n  \"wedge\": {},\n  \"text\": {},\n  \"screw\": {},\n  \"svgExtrude\": {},\n  \"sketch\": {},\n  \"sdf\": {},\n  \"load\": {},\n  \"translate\": {},\n  \"rotate_euler\": {},\n  \"scale\": {},\n  \"scale3d\": {},\n  \"fai_drill\": {},\n  \"fai_extrude\": {},\n  \"engrave\": {},\n  \"chamfer\": {},\n  \"fillet\": {},\n  \"knurl\": {},\n  \"union\": {},\n  \"subtract\": {},\n  \"intersect\": {},\n  \"extrude\": {},\n  \"revolve\": {},\n  \"fai_split\": {},\n  \"group\": {},\n  \"assembly\": {},\n  \"copy\": {},\n  \"faceNormal\": {},\n  \"bboxCenter\": {},\n  \"bboxMin\": {},\n  \"bboxMax\": {},\n  \"edgeRef\": {},\n  \"faceRef\": {},\n  \"jointTrajectory\": {},\n  \"inverseKinematics\": {},\n  \"mechanismDOF\": {},\n  \"asset\": {},\n  \"import_brep\": {},\n  \"import_step\": {},\n  \"compound\": {},\n  \"place\": {},\n  \"cut\": {},\n  \"split\": {},\n  \"linearPattern\": {},\n  \"torus\": {},\n  \"fuse\": {},\n  \"viewCamera\": {},\n  \"projectView\": {},\n  \"projectSheet\": {},\n  \"circularPattern\": {},\n  \"gridPattern\": {},\n  \"drill\": {},\n  \"pocket\": {},\n  \"boss\": {},\n  \"mirrorJoin\": {},\n  \"rectangularPattern\": {},\n  \"convexHull\": {},\n  \"makeBaseBox\": {},\n  \"ellipsoid\": {},\n  \"rotate\": {},\n  \"mirror\": {},\n  \"clone\": {},\n  \"applyMatrix\": {},\n  \"transformCopy\": {},\n  \"locate\": {},\n  \"offset\": {},\n  \"heal\": {},\n  \"simplify\": {},\n  \"autoHeal\": {},\n  \"fixShape\": {},\n  \"healSolid\": {}\n}\n"]}
+{"version":3,"file":"symbol-table.generated.js","sourceRoot":"","sources":["../../src/lang/symbol-table.generated.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAe;IACb,KAAK,EAAE,EAAE;IACT,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,EAAE;IACd,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,EAAE;IACT,WAAW,EAAE,EAAE;IACf,cAAc,EAAE,EAAE;IAClB,OAAO,EAAE,EAAE;IACX,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;IACX,UAAU,EAAE,EAAE;IACd,WAAW,EAAE,EAAE;IACf,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,YAAY,EAAE,EAAE;IAChB,YAAY,EAAE,EAAE;IAChB,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,iBAAiB,EAAE,EAAE;IACrB,mBAAmB,EAAE,EAAE;IACvB,cAAc,EAAE,EAAE;IAClB,OAAO,EAAE,EAAE;IACX,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,UAAU,EAAE,EAAE;IACd,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,EAAE;IACX,eAAe,EAAE,EAAE;IACnB,iBAAiB,EAAE,EAAE;IACrB,aAAa,EAAE,EAAE;IACjB,oBAAoB,EAAE,EAAE;IACxB,YAAY,EAAE,EAAE;IAChB,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;IACX,MAAM,EAAE,EAAE;IACV,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,EAAE;IACjB,cAAc,EAAE,EAAE;IAClB,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,EAAE;IACV,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,EAAE;IACf,QAAQ,EAAE,EAAE;IACZ,aAAa,EAAE,EAAE;IACjB,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,EAAE;IACV,UAAU,EAAE,EAAE;IACd,UAAU,EAAE,EAAE;IACd,UAAU,EAAE,EAAE;IACd,WAAW,EAAE,EAAE;CAChB,CAAA","sourcesContent":["/**\n * symbol-table 生成文件 — 禁手改。\n * 由 scripts/gen-symbol-table.ts 从 api-namespace 的 cad 命名空间生成（键存在性）。\n * keep-syntax P1 后符号表只承载 check() 符号检查（\"函数不存在\"判定）；\n * 保留语义由 keep 声明表达，不再有 readonly 标注。\n */\nexport default {\n  \"box\": {},\n  \"sphere\": {},\n  \"cylinder\": {},\n  \"cone\": {},\n  \"wedge\": {},\n  \"screw\": {},\n  \"sketch\": {},\n  \"sdf\": {},\n  \"translate\": {},\n  \"rotate_euler\": {},\n  \"scale\": {},\n  \"scale3d\": {},\n  \"engrave\": {},\n  \"chamfer\": {},\n  \"fillet\": {},\n  \"knurl\": {},\n  \"union\": {},\n  \"subtract\": {},\n  \"intersect\": {},\n  \"extrude\": {},\n  \"revolve\": {},\n  \"faceNormal\": {},\n  \"bboxCenter\": {},\n  \"bboxMin\": {},\n  \"bboxMax\": {},\n  \"edgeRef\": {},\n  \"faceRef\": {},\n  \"jointTrajectory\": {},\n  \"inverseKinematics\": {},\n  \"mechanismDOF\": {},\n  \"asset\": {},\n  \"import_brep\": {},\n  \"import_step\": {},\n  \"compound\": {},\n  \"place\": {},\n  \"cut\": {},\n  \"split\": {},\n  \"linearPattern\": {},\n  \"circularPattern\": {},\n  \"gridPattern\": {},\n  \"rectangularPattern\": {},\n  \"mirrorJoin\": {},\n  \"mirror\": {},\n  \"clone\": {},\n  \"torus\": {},\n  \"fuse\": {},\n  \"viewCamera\": {},\n  \"projectView\": {},\n  \"projectSheet\": {},\n  \"drill\": {},\n  \"pocket\": {},\n  \"boss\": {},\n  \"convexHull\": {},\n  \"makeBaseBox\": {},\n  \"ellipsoid\": {},\n  \"rotate\": {},\n  \"applyMatrix\": {},\n  \"locate\": {},\n  \"offset\": {},\n  \"heal\": {},\n  \"simplify\": {},\n  \"autoHeal\": {},\n  \"fixShape\": {},\n  \"healSolid\": {}\n}\n"]}

package/dist/lang/symbol-table.js

@@ -10,10 +10,59 @@
  * 未知第三方函数不在表中时，check() 报"函数不存在"，其它机制不受影响。
  *
  * 生成文件：src/lang/symbol-table.generated.ts（由 scripts/gen-symbol-table.ts 生成，禁手改）。
+ *
+ * P5（2026-09-23 扩展库拆分）：符号表额外接受**宿主注册的扩展条目**
+ * （`registerSymbolTableEntries`）。扩展库（如 `@faicad/faijs-extra`）的 op 不在
+ * 生成表里——生成表的唯一来源是 core 的 `createApiNamespace()` 平台面；扩展库由
+ * 宿主在装配时注入名字清单，使静态分析同样能查到 `cad.fai_drill`。
+ * 扩展条目**不得**覆盖平台函数（真重名即抛错，不静默覆盖）。
  */
 import symbolTable from './symbol-table.generated.js';
 /** 生成的符号表（禁手改，由 scripts/gen-symbol-table.ts 生成） */
 export const SYMBOL_TABLE = symbolTable;
+/**
+ * Host-registered extension entries (library namespaces outside core's platform
+ * surface). Kept apart from `SYMBOL_TABLE` so "platform surface" stays
+ * machine-derivable from the generated table alone.
+ */
+const extensionEntries = new Map();
+/**
+ * Register library function names in the symbol table (P5).
+ *
+ * Idempotent for names already registered as extensions; throws when a name
+ * collides with a platform function, because a silent override would let a
+ * library shadow the platform surface in static analysis.
+ *
+ * @param names - the library's function names (`cad.<name>`).
+ * @throws when a name is already a platform function of the generated table.
+ */
+export function registerSymbolTableEntries(names) {
+    for (const name of names) {
+        if (Object.prototype.hasOwnProperty.call(SYMBOL_TABLE, name)) {
+            throw new Error(`[faijs] symbol-table extension redefines platform function "${name}"`);
+        }
+        extensionEntries.set(name, {});
+    }
+}
+/**
+ * Remove previously registered extension entries (host unloads a library).
+ * Unknown names are ignored.
+ *
+ * @param names - the function names to unregister.
+ */
+export function unregisterSymbolTableEntries(names) {
+    for (const name of names)
+        extensionEntries.delete(name);
+}
+/**
+ * All callee names known to the symbol table: the generated platform table plus
+ * the registered extension entries.
+ *
+ * @returns the union of platform and extension names, platform first.
+ */
+export function symbolTableNames() {
+    return [...new Set([...Object.keys(SYMBOL_TABLE), ...extensionEntries.keys()])];
+}
 /**
  * Look up a callee in the standard-library symbol table. Unknown functions
  * (absent from the table) return undefined, which check() reports as
@@ -22,6 +71,6 @@ export const SYMBOL_TABLE = symbolTable;
  * @returns the matching symbol-table entry, or undefined when unknown.
  */
 export function getFunctionSymbol(callee) {
-    return SYMBOL_TABLE[callee];
+    return SYMBOL_TABLE[callee] ?? extensionEntries.get(callee);
 }
 //# sourceMappingURL=symbol-table.js.map

package/dist/lang/symbol-table.js.map

@@ -1 +1 @@
-{"version":3,"file":"symbol-table.js","sourceRoot":"","sources":["../../src/lang/symbol-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,WAAW,MAAM,0BAA0B,CAAA;AAQlD,mDAAmD;AACnD,MAAM,CAAC,MAAM,YAAY,GAAgB,WAA0B,CAAA;AAEnE;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,YAAY,CAAC,MAAM,CAAC,CAAA;AAC7B,CAAC","sourcesContent":["/**\n * symbol-table — 标准库符号表类型与消费入口（L0 零依赖）\n *\n *\n * 符号表是\"标准库符号表\"（正常语言编译器认识 prelude 的同款机制），\n * 机器生成、均匀查询。keep-syntax P1 之后它只承载一个职责：\n * check() 符号检查判定 callee 是否存在（\"函数不存在\"诊断）。\n * 保留语义（readonlyPositions/readonlyPaths）已删除——保留由 keep 声明\n * （调用点 keep / 函数体 exec.keep）显式表达，不再靠类型标注提取（R7）。\n * 未知第三方函数不在表中时，check() 报\"函数不存在\"，其它机制不受影响。\n *\n * 生成文件：src/lang/symbol-table.generated.ts（由 scripts/gen-symbol-table.ts 生成，禁手改）。\n */\n\nimport symbolTable from './symbol-table.generated'\n\n/** 符号表条目（keep-syntax P1 后为空对象占位，仅承载键存在性）。 */\nexport type FunctionSymbol = Record<string, never>\n\n/** 标准库符号表：callee → 条目。均匀数据，无 per-函数代码。 */\nexport type SymbolTable = Record<string, FunctionSymbol>\n\n/** 生成的符号表（禁手改，由 scripts/gen-symbol-table.ts 生成） */\nexport const SYMBOL_TABLE: SymbolTable = symbolTable as SymbolTable\n\n/**\n * Look up a callee in the standard-library symbol table. Unknown functions\n * (absent from the table) return undefined, which check() reports as\n * \"function does not exist\".\n * @param callee - the callee name to look up.\n * @returns the matching symbol-table entry, or undefined when unknown.\n */\nexport function getFunctionSymbol(callee: string): FunctionSymbol | undefined {\n  return SYMBOL_TABLE[callee]\n}\n"]}
+{"version":3,"file":"symbol-table.js","sourceRoot":"","sources":["../../src/lang/symbol-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,WAAW,MAAM,0BAA0B,CAAA;AAQlD,mDAAmD;AACnD,MAAM,CAAC,MAAM,YAAY,GAAgB,WAA0B,CAAA;AAEnE;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA0B,CAAA;AAE1D;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAwB;IACjE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,+DAA+D,IAAI,GAAG,CAAC,CAAA;QACzF,CAAC;QACD,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAChC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAAwB;IACnE,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;AACjF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AAC7D,CAAC","sourcesContent":["/**\n * symbol-table — 标准库符号表类型与消费入口（L0 零依赖）\n *\n *\n * 符号表是\"标准库符号表\"（正常语言编译器认识 prelude 的同款机制），\n * 机器生成、均匀查询。keep-syntax P1 之后它只承载一个职责：\n * check() 符号检查判定 callee 是否存在（\"函数不存在\"诊断）。\n * 保留语义（readonlyPositions/readonlyPaths）已删除——保留由 keep 声明\n * （调用点 keep / 函数体 exec.keep）显式表达，不再靠类型标注提取（R7）。\n * 未知第三方函数不在表中时，check() 报\"函数不存在\"，其它机制不受影响。\n *\n * 生成文件：src/lang/symbol-table.generated.ts（由 scripts/gen-symbol-table.ts 生成，禁手改）。\n *\n * P5（2026-09-23 扩展库拆分）：符号表额外接受**宿主注册的扩展条目**\n * （`registerSymbolTableEntries`）。扩展库（如 `@faicad/faijs-extra`）的 op 不在\n * 生成表里——生成表的唯一来源是 core 的 `createApiNamespace()` 平台面；扩展库由\n * 宿主在装配时注入名字清单，使静态分析同样能查到 `cad.fai_drill`。\n * 扩展条目**不得**覆盖平台函数（真重名即抛错，不静默覆盖）。\n */\n\nimport symbolTable from './symbol-table.generated'\n\n/** 符号表条目（keep-syntax P1 后为空对象占位，仅承载键存在性）。 */\nexport type FunctionSymbol = Record<string, never>\n\n/** 标准库符号表：callee → 条目。均匀数据，无 per-函数代码。 */\nexport type SymbolTable = Record<string, FunctionSymbol>\n\n/** 生成的符号表（禁手改，由 scripts/gen-symbol-table.ts 生成） */\nexport const SYMBOL_TABLE: SymbolTable = symbolTable as SymbolTable\n\n/**\n * Host-registered extension entries (library namespaces outside core's platform\n * surface). Kept apart from `SYMBOL_TABLE` so \"platform surface\" stays\n * machine-derivable from the generated table alone.\n */\nconst extensionEntries = new Map<string, FunctionSymbol>()\n\n/**\n * Register library function names in the symbol table (P5).\n *\n * Idempotent for names already registered as extensions; throws when a name\n * collides with a platform function, because a silent override would let a\n * library shadow the platform surface in static analysis.\n *\n * @param names - the library's function names (`cad.<name>`).\n * @throws when a name is already a platform function of the generated table.\n */\nexport function registerSymbolTableEntries(names: readonly string[]): void {\n  for (const name of names) {\n    if (Object.prototype.hasOwnProperty.call(SYMBOL_TABLE, name)) {\n      throw new Error(`[faijs] symbol-table extension redefines platform function \"${name}\"`)\n    }\n    extensionEntries.set(name, {})\n  }\n}\n\n/**\n * Remove previously registered extension entries (host unloads a library).\n * Unknown names are ignored.\n *\n * @param names - the function names to unregister.\n */\nexport function unregisterSymbolTableEntries(names: readonly string[]): void {\n  for (const name of names) extensionEntries.delete(name)\n}\n\n/**\n * All callee names known to the symbol table: the generated platform table plus\n * the registered extension entries.\n *\n * @returns the union of platform and extension names, platform first.\n */\nexport function symbolTableNames(): string[] {\n  return [...new Set([...Object.keys(SYMBOL_TABLE), ...extensionEntries.keys()])]\n}\n\n/**\n * Look up a callee in the standard-library symbol table. Unknown functions\n * (absent from the table) return undefined, which check() reports as\n * \"function does not exist\".\n * @param callee - the callee name to look up.\n * @returns the matching symbol-table entry, or undefined when unknown.\n */\nexport function getFunctionSymbol(callee: string): FunctionSymbol | undefined {\n  return SYMBOL_TABLE[callee] ?? extensionEntries.get(callee)\n}\n"]}

package/dist/mesh/creased-normals.d.ts

@@ -0,0 +1,50 @@
+/**
+ * creased-normals.ts — dependency-free creased (folded) normal computation.
+ *
+ * The engine's own port of three's `toCreasedNormals`
+ * (three/examples/jsm/utils/BufferGeometryUtils.js). Why a port instead of an
+ * import: the three helper drags the whole `three` package into any consumer
+ * (weapp main thread cannot hold two three copies — see 3d_editor weapp plan
+ * §1.1.1 "no three via dependency packages"), while the algorithm itself is
+ * pure array math.
+ *
+ * Semantics are aligned with three r162..r184 `toCreasedNormals` line by line:
+ * - input is expanded to non-indexed triangles (indexed geometry is unwound);
+ *   output is always non-indexed (positions count = triangleCount * 3, indices = null);
+ * - a face normal is computed per triangle and pushed onto hash buckets of its
+ *   3 vertices (hash = trunc(x * 100 * (1 + 1e-10)) per component, same
+ *   quantization as three's `hashVertex`);
+ * - each vertex normal = normalize(sum of bucket normals whose dot with the
+ *   face normal exceeds cos(creaseAngleDeg)) — sharp edges split, smooth
+ *   surfaces (drill walls) stay averaged;
+ * - degenerate (zero-area) faces yield NaN normals exactly like three's
+ *   divide-by-zero; callers treat that as invalid geometry upstream.
+ */
+export interface CreasedNormalsInput {
+    /** Triangle positions, xyz interleaved, length = n * 3. */
+    positions: Float32Array;
+    /** Triangle vertex indices, length = n * 3 (n = triangle count). `null` = sequential. */
+    indices: Uint32Array | null;
+    /** Dihedral-angle threshold in degrees above which normals split (default 60). */
+    creaseAngleDeg?: number;
+}
+/**
+ * Creased-normals computation input/output (dependency-free surface).
+ */
+export interface CreasedNormalsResult {
+    /** Non-indexed positions (indexed input is expanded). */
+    positions: Float32Array;
+    /** Per-vertex creased normals, xyz interleaved. */
+    normals: Float32Array;
+    /** Always null — creased normals cannot be expressed on shared vertices. */
+    indices: null;
+}
+/**
+ * Derive creased (folded) normals from raw triangle data — the dependency-free
+ * equivalent of three's `toCreasedNormals`. See the module header for the
+ * aligned semantics.
+ * @param input - positions (+ optional indices) and the crease angle threshold.
+ * @returns non-indexed positions plus per-vertex creased normals.
+ */
+export declare function deriveCreasedNormalsData(input: CreasedNormalsInput): CreasedNormalsResult;
+//# sourceMappingURL=creased-normals.d.ts.map

package/dist/mesh/creased-normals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creased-normals.d.ts","sourceRoot":"","sources":["../../src/mesh/creased-normals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,SAAS,EAAE,YAAY,CAAA;IACvB,yFAAyF;IACzF,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IAC3B,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,SAAS,EAAE,YAAY,CAAA;IACvB,mDAAmD;IACnD,OAAO,EAAE,YAAY,CAAA;IACrB,4EAA4E;IAC5E,OAAO,EAAE,IAAI,CAAA;CACd;AAYD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB,CA8EzF"}

package/dist/mesh/creased-normals.js

@@ -0,0 +1,114 @@
+/**
+ * creased-normals.ts — dependency-free creased (folded) normal computation.
+ *
+ * The engine's own port of three's `toCreasedNormals`
+ * (three/examples/jsm/utils/BufferGeometryUtils.js). Why a port instead of an
+ * import: the three helper drags the whole `three` package into any consumer
+ * (weapp main thread cannot hold two three copies — see 3d_editor weapp plan
+ * §1.1.1 "no three via dependency packages"), while the algorithm itself is
+ * pure array math.
+ *
+ * Semantics are aligned with three r162..r184 `toCreasedNormals` line by line:
+ * - input is expanded to non-indexed triangles (indexed geometry is unwound);
+ *   output is always non-indexed (positions count = triangleCount * 3, indices = null);
+ * - a face normal is computed per triangle and pushed onto hash buckets of its
+ *   3 vertices (hash = trunc(x * 100 * (1 + 1e-10)) per component, same
+ *   quantization as three's `hashVertex`);
+ * - each vertex normal = normalize(sum of bucket normals whose dot with the
+ *   face normal exceeds cos(creaseAngleDeg)) — sharp edges split, smooth
+ *   surfaces (drill walls) stay averaged;
+ * - degenerate (zero-area) faces yield NaN normals exactly like three's
+ *   divide-by-zero; callers treat that as invalid geometry upstream.
+ */
+const HASH_MULTIPLIER = (1 + 1e-10) * 1e2;
+function hashVertex(x, y, z) {
+    // Same truncation semantics as three: `~~` (32-bit trunc) on scaled coords.
+    const hx = ~~(x * HASH_MULTIPLIER);
+    const hy = ~~(y * HASH_MULTIPLIER);
+    const hz = ~~(z * HASH_MULTIPLIER);
+    return `${hx},${hy},${hz}`;
+}
+/**
+ * Derive creased (folded) normals from raw triangle data — the dependency-free
+ * equivalent of three's `toCreasedNormals`. See the module header for the
+ * aligned semantics.
+ * @param input - positions (+ optional indices) and the crease angle threshold.
+ * @returns non-indexed positions plus per-vertex creased normals.
+ */
+export function deriveCreasedNormalsData(input) {
+    const { indices, creaseAngleDeg = 60 } = input;
+    const srcPos = input.positions;
+    const triCount = indices ? indices.length / 3 : srcPos.length / 9;
+    // Expand to non-indexed triangles (three: geometry.toNonIndexed()).
+    const pos = new Float32Array(triCount * 9);
+    for (let t = 0; t < triCount; t++) {
+        for (let v = 0; v < 3; v++) {
+            const srcIdx = indices ? indices[t * 3 + v] : t * 3 + v;
+            pos[t * 9 + v * 3 + 0] = srcPos[srcIdx * 3 + 0];
+            pos[t * 9 + v * 3 + 1] = srcPos[srcIdx * 3 + 1];
+            pos[t * 9 + v * 3 + 2] = srcPos[srcIdx * 3 + 2];
+        }
+    }
+    const creaseDot = Math.cos((creaseAngleDeg * Math.PI) / 180);
+    // Pass 1: face normals into per-vertex hash buckets.
+    const vertexMap = new Map();
+    const fnx = new Float32Array(triCount);
+    const fny = new Float32Array(triCount);
+    const fnz = new Float32Array(triCount);
+    for (let t = 0; t < triCount; t++) {
+        const ax = pos[t * 9 + 0], ay = pos[t * 9 + 1], az = pos[t * 9 + 2];
+        const bx = pos[t * 9 + 3], by = pos[t * 9 + 4], bz = pos[t * 9 + 5];
+        const cx = pos[t * 9 + 6], cy = pos[t * 9 + 7], cz = pos[t * 9 + 8];
+        // cb = c - b, ab = a - b; normal = cb × ab (same edge order as three).
+        const e1x = cx - bx, e1y = cy - by, e1z = cz - bz;
+        const e2x = ax - bx, e2y = ay - by, e2z = az - bz;
+        let nx = e1y * e2z - e1z * e2y;
+        let ny = e1z * e2x - e1x * e2z;
+        let nz = e1x * e2y - e1y * e2x;
+        const len = Math.sqrt(nx * nx + ny * ny + nz * nz);
+        if (len > 0) {
+            nx /= len;
+            ny /= len;
+            nz /= len;
+        }
+        fnx[t] = nx;
+        fny[t] = ny;
+        fnz[t] = nz;
+        for (let v = 0; v < 3; v++) {
+            const h = hashVertex(pos[t * 9 + v * 3], pos[t * 9 + v * 3 + 1], pos[t * 9 + v * 3 + 2]);
+            let bucket = vertexMap.get(h);
+            if (!bucket) {
+                bucket = [];
+                vertexMap.set(h, bucket);
+            }
+            bucket.push([nx, ny, nz]);
+        }
+    }
+    // Pass 2: average bucket normals within the crease threshold.
+    const normals = new Float32Array(triCount * 9);
+    for (let t = 0; t < triCount; t++) {
+        for (let v = 0; v < 3; v++) {
+            const h = hashVertex(pos[t * 9 + v * 3], pos[t * 9 + v * 3 + 1], pos[t * 9 + v * 3 + 2]);
+            const bucket = vertexMap.get(h);
+            let sx = 0, sy = 0, sz = 0;
+            for (let k = 0; k < bucket.length; k++) {
+                const on = bucket[k];
+                // Three uses `>` (strictly greater) — coplanar neighbours merge,
+                // faces at exactly the crease angle do not.
+                if (fnx[t] * on[0] + fny[t] * on[1] + fnz[t] * on[2] > creaseDot) {
+                    sx += on[0];
+                    sy += on[1];
+                    sz += on[2];
+                }
+            }
+            const sl = Math.sqrt(sx * sx + sy * sy + sz * sz);
+            // Divide unconditionally: a zero-length sum yields NaN, matching three's
+            // divide-by-zero behavior on degenerate geometry.
+            normals[t * 9 + v * 3 + 0] = sx / sl;
+            normals[t * 9 + v * 3 + 1] = sy / sl;
+            normals[t * 9 + v * 3 + 2] = sz / sl;
+        }
+    }
+    return { positions: pos, normals, indices: null };
+}
+//# sourceMappingURL=creased-normals.js.map

package/dist/mesh/creased-normals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creased-normals.js","sourceRoot":"","sources":["../../src/mesh/creased-normals.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * creased-normals.ts — dependency-free creased (folded) normal computation.\n *\n * The engine's own port of three's `toCreasedNormals`\n * (three/examples/jsm/utils/BufferGeometryUtils.js). Why a port instead of an\n * import: the three helper drags the whole `three` package into any consumer\n * (weapp main thread cannot hold two three copies — see 3d_editor weapp plan\n * §1.1.1 \"no three via dependency packages\"), while the algorithm itself is\n * pure array math.\n *\n * Semantics are aligned with three r162..r184 `toCreasedNormals` line by line:\n * - input is expanded to non-indexed triangles (indexed geometry is unwound);\n *   output is always non-indexed (positions count = triangleCount * 3, indices = null);\n * - a face normal is computed per triangle and pushed onto hash buckets of its\n *   3 vertices (hash = trunc(x * 100 * (1 + 1e-10)) per component, same\n *   quantization as three's `hashVertex`);\n * - each vertex normal = normalize(sum of bucket normals whose dot with the\n *   face normal exceeds cos(creaseAngleDeg)) — sharp edges split, smooth\n *   surfaces (drill walls) stay averaged;\n * - degenerate (zero-area) faces yield NaN normals exactly like three's\n *   divide-by-zero; callers treat that as invalid geometry upstream.\n */\n\nexport interface CreasedNormalsInput {\n  /** Triangle positions, xyz interleaved, length = n * 3. */\n  positions: Float32Array\n  /** Triangle vertex indices, length = n * 3 (n = triangle count). `null` = sequential. */\n  indices: Uint32Array | null\n  /** Dihedral-angle threshold in degrees above which normals split (default 60). */\n  creaseAngleDeg?: number\n}\n\n/**\n * Creased-normals computation input/output (dependency-free surface).\n */\nexport interface CreasedNormalsResult {\n  /** Non-indexed positions (indexed input is expanded). */\n  positions: Float32Array\n  /** Per-vertex creased normals, xyz interleaved. */\n  normals: Float32Array\n  /** Always null — creased normals cannot be expressed on shared vertices. */\n  indices: null\n}\n\nconst HASH_MULTIPLIER = (1 + 1e-10) * 1e2\n\nfunction hashVertex(x: number, y: number, z: number): string {\n  // Same truncation semantics as three: `~~` (32-bit trunc) on scaled coords.\n  const hx = ~~(x * HASH_MULTIPLIER)\n  const hy = ~~(y * HASH_MULTIPLIER)\n  const hz = ~~(z * HASH_MULTIPLIER)\n  return `${hx},${hy},${hz}`\n}\n\n/**\n * Derive creased (folded) normals from raw triangle data — the dependency-free\n * equivalent of three's `toCreasedNormals`. See the module header for the\n * aligned semantics.\n * @param input - positions (+ optional indices) and the crease angle threshold.\n * @returns non-indexed positions plus per-vertex creased normals.\n */\nexport function deriveCreasedNormalsData(input: CreasedNormalsInput): CreasedNormalsResult {\n  const { indices, creaseAngleDeg = 60 } = input\n  const srcPos = input.positions\n\n  const triCount = indices ? indices.length / 3 : srcPos.length / 9\n\n  // Expand to non-indexed triangles (three: geometry.toNonIndexed()).\n  const pos = new Float32Array(triCount * 9)\n  for (let t = 0; t < triCount; t++) {\n    for (let v = 0; v < 3; v++) {\n      const srcIdx = indices ? indices[t * 3 + v] : t * 3 + v\n      pos[t * 9 + v * 3 + 0] = srcPos[srcIdx * 3 + 0]\n      pos[t * 9 + v * 3 + 1] = srcPos[srcIdx * 3 + 1]\n      pos[t * 9 + v * 3 + 2] = srcPos[srcIdx * 3 + 2]\n    }\n  }\n\n  const creaseDot = Math.cos((creaseAngleDeg * Math.PI) / 180)\n\n  // Pass 1: face normals into per-vertex hash buckets.\n  const vertexMap = new Map<string, number[][]>()\n  const fnx = new Float32Array(triCount)\n  const fny = new Float32Array(triCount)\n  const fnz = new Float32Array(triCount)\n\n  for (let t = 0; t < triCount; t++) {\n    const ax = pos[t * 9 + 0], ay = pos[t * 9 + 1], az = pos[t * 9 + 2]\n    const bx = pos[t * 9 + 3], by = pos[t * 9 + 4], bz = pos[t * 9 + 5]\n    const cx = pos[t * 9 + 6], cy = pos[t * 9 + 7], cz = pos[t * 9 + 8]\n\n    // cb = c - b, ab = a - b; normal = cb × ab (same edge order as three).\n    const e1x = cx - bx, e1y = cy - by, e1z = cz - bz\n    const e2x = ax - bx, e2y = ay - by, e2z = az - bz\n    let nx = e1y * e2z - e1z * e2y\n    let ny = e1z * e2x - e1x * e2z\n    let nz = e1x * e2y - e1y * e2x\n    const len = Math.sqrt(nx * nx + ny * ny + nz * nz)\n    if (len > 0) {\n      nx /= len; ny /= len; nz /= len\n    }\n    fnx[t] = nx; fny[t] = ny; fnz[t] = nz\n\n    for (let v = 0; v < 3; v++) {\n      const h = hashVertex(pos[t * 9 + v * 3], pos[t * 9 + v * 3 + 1], pos[t * 9 + v * 3 + 2])\n      let bucket = vertexMap.get(h)\n      if (!bucket) {\n        bucket = []\n        vertexMap.set(h, bucket)\n      }\n      bucket.push([nx, ny, nz])\n    }\n  }\n\n  // Pass 2: average bucket normals within the crease threshold.\n  const normals = new Float32Array(triCount * 9)\n  for (let t = 0; t < triCount; t++) {\n    for (let v = 0; v < 3; v++) {\n      const h = hashVertex(pos[t * 9 + v * 3], pos[t * 9 + v * 3 + 1], pos[t * 9 + v * 3 + 2])\n      const bucket = vertexMap.get(h)!\n      let sx = 0, sy = 0, sz = 0\n      for (let k = 0; k < bucket.length; k++) {\n        const on = bucket[k]\n        // Three uses `>` (strictly greater) — coplanar neighbours merge,\n        // faces at exactly the crease angle do not.\n        if (fnx[t] * on[0] + fny[t] * on[1] + fnz[t] * on[2] > creaseDot) {\n          sx += on[0]; sy += on[1]; sz += on[2]\n        }\n      }\n      const sl = Math.sqrt(sx * sx + sy * sy + sz * sz)\n      // Divide unconditionally: a zero-length sum yields NaN, matching three's\n      // divide-by-zero behavior on degenerate geometry.\n      normals[t * 9 + v * 3 + 0] = sx / sl\n      normals[t * 9 + v * 3 + 1] = sy / sl\n      normals[t * 9 + v * 3 + 2] = sz / sl\n    }\n  }\n\n  return { positions: pos, normals, indices: null }\n}\n"]}

package/dist/mesh/decoration-provider.d.ts

@@ -0,0 +1,53 @@
+/**
+ * decoration-provider — host-injectable text/SVG decoration geometry.
+ *
+ * The `cad.engrave` op is a platform op (plan §4.2 C) but its decoration input
+ * is text or SVG, whose mesh geometry is produced by three's non-basic chain
+ * (`Shape` / `ExtrudeGeometry` / `SVGLoader`). That chain now lives in
+ * `@faicad/faijs-extra`, so core asks the host for the decoration geometry
+ * instead of importing it — the same capability-injection shape as
+ * `setFontLoader` / `setKnurlTextureLoader`.
+ *
+ * With no provider installed, `cad.engrave` still works on its BREP path
+ * (OCCT `textToSolid` / `svgToSolid`, zero three); only the **mesh** path needs
+ * a provider, and it reports a precise error instead of failing obscurely.
+ */
+import type * as THREE from 'three';
+/** Decoration inputs `cad.engrave` passes to the provider. */
+export interface EngraveDecorationParams {
+    /** Text to engrave (mutually exclusive with `svg`). */
+    text?: string;
+    /** Text size in mm. */
+    textSize?: number;
+    /** SVG source text (mutually exclusive with `text`). */
+    svg?: string;
+    /** SVG long-side target size in mm. */
+    svgSize?: number;
+    /** SVG logical width, used for the scale factor. */
+    svgNaturalWidth?: number;
+    /** SVG logical height, used for the scale factor. */
+    svgNaturalHeight?: number;
+    /** Extrusion depth in mm. */
+    depth: number;
+}
+/**
+ * Produces the decoration geometry (local space, `+Z` = extrusion direction) for
+ * `cad.engrave`'s mesh path.
+ */
+export type EngraveDecorationProvider = (params: EngraveDecorationParams) => Promise<THREE.BufferGeometry>;
+/**
+ * Install (or clear, with `null`) the mesh-decoration provider.
+ * @param next - the provider, or null to uninstall.
+ */
+export declare function setEngraveDecorationProvider(next: EngraveDecorationProvider | null): void;
+/**
+ * Read the installed mesh-decoration provider.
+ *
+ * `cad.engrave`'s mesh path calls this; a null result means the host installed
+ * no provider and the op reports the precise "install a provider" error rather
+ * than failing obscurely.
+ *
+ * @returns the installed mesh-decoration provider, or null when none is set.
+ */
+export declare function getEngraveDecorationProvider(): EngraveDecorationProvider | null;
+//# sourceMappingURL=decoration-provider.d.ts.map

package/dist/mesh/decoration-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoration-provider.d.ts","sourceRoot":"","sources":["../../src/mesh/decoration-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AAEnC,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,CACtC,MAAM,EAAE,uBAAuB,KAC5B,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;AAIlC;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,yBAAyB,GAAG,IAAI,GAAG,IAAI,CAEzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,IAAI,yBAAyB,GAAG,IAAI,CAE/E"}

package/dist/mesh/decoration-provider.js

@@ -0,0 +1,21 @@
+let provider = null;
+/**
+ * Install (or clear, with `null`) the mesh-decoration provider.
+ * @param next - the provider, or null to uninstall.
+ */
+export function setEngraveDecorationProvider(next) {
+    provider = next;
+}
+/**
+ * Read the installed mesh-decoration provider.
+ *
+ * `cad.engrave`'s mesh path calls this; a null result means the host installed
+ * no provider and the op reports the precise "install a provider" error rather
+ * than failing obscurely.
+ *
+ * @returns the installed mesh-decoration provider, or null when none is set.
+ */
+export function getEngraveDecorationProvider() {
+    return provider;
+}
+//# sourceMappingURL=decoration-provider.js.map

package/dist/mesh/decoration-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoration-provider.js","sourceRoot":"","sources":["../../src/mesh/decoration-provider.ts"],"names":[],"mappings":"AA0CA,IAAI,QAAQ,GAAqC,IAAI,CAAA;AAErD;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAsC;IACjF,QAAQ,GAAG,IAAI,CAAA;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,QAAQ,CAAA;AACjB,CAAC","sourcesContent":["/**\n * decoration-provider — host-injectable text/SVG decoration geometry.\n *\n * The `cad.engrave` op is a platform op (plan §4.2 C) but its decoration input\n * is text or SVG, whose mesh geometry is produced by three's non-basic chain\n * (`Shape` / `ExtrudeGeometry` / `SVGLoader`). That chain now lives in\n * `@faicad/faijs-extra`, so core asks the host for the decoration geometry\n * instead of importing it — the same capability-injection shape as\n * `setFontLoader` / `setKnurlTextureLoader`.\n *\n * With no provider installed, `cad.engrave` still works on its BREP path\n * (OCCT `textToSolid` / `svgToSolid`, zero three); only the **mesh** path needs\n * a provider, and it reports a precise error instead of failing obscurely.\n */\nimport type * as THREE from 'three'\n\n/** Decoration inputs `cad.engrave` passes to the provider. */\nexport interface EngraveDecorationParams {\n  /** Text to engrave (mutually exclusive with `svg`). */\n  text?: string\n  /** Text size in mm. */\n  textSize?: number\n  /** SVG source text (mutually exclusive with `text`). */\n  svg?: string\n  /** SVG long-side target size in mm. */\n  svgSize?: number\n  /** SVG logical width, used for the scale factor. */\n  svgNaturalWidth?: number\n  /** SVG logical height, used for the scale factor. */\n  svgNaturalHeight?: number\n  /** Extrusion depth in mm. */\n  depth: number\n}\n\n/**\n * Produces the decoration geometry (local space, `+Z` = extrusion direction) for\n * `cad.engrave`'s mesh path.\n */\nexport type EngraveDecorationProvider = (\n  params: EngraveDecorationParams,\n) => Promise<THREE.BufferGeometry>\n\nlet provider: EngraveDecorationProvider | null = null\n\n/**\n * Install (or clear, with `null`) the mesh-decoration provider.\n * @param next - the provider, or null to uninstall.\n */\nexport function setEngraveDecorationProvider(next: EngraveDecorationProvider | null): void {\n  provider = next\n}\n\n/**\n * Read the installed mesh-decoration provider.\n *\n * `cad.engrave`'s mesh path calls this; a null result means the host installed\n * no provider and the op reports the precise \"install a provider\" error rather\n * than failing obscurely.\n *\n * @returns the installed mesh-decoration provider, or null when none is set.\n */\nexport function getEngraveDecorationProvider(): EngraveDecorationProvider | null {\n  return provider\n}\n"]}

package/dist/mesh/engrave.d.ts

@@ -17,6 +17,10 @@ import type { Shape, EngraveParams, KnurlParams } from './types.js';
  * position it onto a face, then run a boolean union (convex) or subtract
  * (concave).
  *
+ * The decoration geometry itself comes from the host-installed provider
+ * (`setEngraveDecorationProvider`) — three's `Shape`/`ExtrudeGeometry`/`SVGLoader`
+ * chain belongs to `@faicad/faijs-extra`, not to the platform surface.
+ *
  * @param shape - the world-space target shape.
  * @param params - engrave parameters (text/svg, depth, face, mode).
  * @returns the engraved shape in world space.

package/dist/mesh/engrave.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engrave.d.ts","sourceRoot":"","sources":["../../src/mesh/engrave.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEhE;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,CA0EjF;AAED;;;;;;;;;GASG;AACH,wBAAsB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CA8E7E"}
+{"version":3,"file":"engrave.d.ts","sourceRoot":"","sources":["../../src/mesh/engrave.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEhE;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,CAyDjF;AAED;;;;;;;;;GASG;AACH,wBAAsB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CA8E7E"}

package/dist/mesh/engrave.js

@@ -13,50 +13,41 @@
  */
 import * as THREE from 'three';
 import { computeBoolean, geoToManifoldMesh, manifoldMeshToGeo } from '../boolean/csg-backend.js';
-import { svgToExtrudedGeometry } from '../primitives/svg-extrude.js';
+import { getEngraveDecorationProvider } from './decoration-provider.js';
 /**
  * Execute an engraving: generate the decoration geometry (text or SVG),
  * position it onto a face, then run a boolean union (convex) or subtract
  * (concave).
  *
+ * The decoration geometry itself comes from the host-installed provider
+ * (`setEngraveDecorationProvider`) — three's `Shape`/`ExtrudeGeometry`/`SVGLoader`
+ * chain belongs to `@faicad/faijs-extra`, not to the platform surface.
+ *
  * @param shape - the world-space target shape.
  * @param params - engrave parameters (text/svg, depth, face, mode).
  * @returns the engraved shape in world space.
  */
 export async function engrave(shape, params) {
     // 1. 生成装饰几何（局部空间，+Z = 挤出方向）
-    let decorationGeo;
-    if (params.text) {
-        if (!params.text)
-            throw new Error('Text is empty');
-        const { getOpentypeFont, createTextGeometry } = await import('../primitives/text-geometry.js');
-        const { containsCjk, loadSystemCjkFont, createMixedTextGeometry } = await import('../primitives/text/cjk.js');
-        const font = await getOpentypeFont();
-        if (containsCjk(params.text)) {
-            const cjkFont = await loadSystemCjkFont();
-            if (cjkFont) {
-                decorationGeo = await createMixedTextGeometry(params.text, params.textSize ?? 10, params.depth, cjkFont.font, font);
-            }
-            else {
-                decorationGeo = await createTextGeometry(params.text, params.textSize ?? 10, params.depth, font);
-            }
-        }
-        else {
-            decorationGeo = await createTextGeometry(params.text, params.textSize ?? 10, params.depth, font);
-        }
-    }
-    else if (params.svg) {
-        // logo / SVG
-        decorationGeo = svgToExtrudedGeometry(params.svg, {
-            depth: params.depth,
-            targetLongSide: params.svgSize,
-            naturalWidth: params.svgNaturalWidth ?? 0,
-            naturalHeight: params.svgNaturalHeight ?? 0,
-        });
-    }
-    else {
+    if (!params.text && !params.svg) {
         throw new Error('engrave requires either text or svg');
     }
+    const provider = getEngraveDecorationProvider();
+    if (!provider) {
+        throw new Error('engrave: no mesh decoration provider installed — the text/SVG geometry chain ' +
+            'lives in @faicad/faijs-extra; call setEngraveDecorationProvider() (or ' +
+            'installEditorMeshProviders() from @faicad/faijs-extra) before engraving in mesh mode, ' +
+            'or run the op on the BREP path');
+    }
+    const decorationGeo = await provider({
+        text: params.text,
+        textSize: params.textSize,
+        svg: params.svg,
+        svgSize: params.svgSize,
+        svgNaturalWidth: params.svgNaturalWidth,
+        svgNaturalHeight: params.svgNaturalHeight,
+        depth: params.depth,
+    });
     // 2. 定位装饰几何到面
     const faceCenter = new THREE.Vector3(...params.face.center);
     const faceNormal = new THREE.Vector3(...params.face.normal);

package/dist/mesh/engrave.js.map

@@ -1 +1 @@
-{"version":3,"file":"engrave.js","sourceRoot":"","sources":["../../src/mesh/engrave.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * mesh 雕刻 API\n *\n * 提取来源：engine/components/engraving/EngravingCore.ts\n *\n * 从 executeEngraving 中提取纯几何计算部分：\n * 1. 生成装饰几何（文字或 SVG）\n * 2. 定位到面\n * 3. 布尔运算（凸=union，凹=subtract）\n *\n * 不包含：store 读写、commitGeometry、undo snapshot、toast。\n * 这些由执行器负责（P1 不改变现有执行器行为）。\n */\n\nimport * as THREE from 'three'\nimport { computeBoolean, geoToManifoldMesh, manifoldMeshToGeo } from '../boolean/csg-backend'\nimport { svgToExtrudedGeometry } from '../primitives/svg-extrude'\nimport type { Shape, EngraveParams, KnurlParams } from './types'\n\n/**\n * Execute an engraving: generate the decoration geometry (text or SVG),\n * position it onto a face, then run a boolean union (convex) or subtract\n * (concave).\n *\n * @param shape - the world-space target shape.\n * @param params - engrave parameters (text/svg, depth, face, mode).\n * @returns the engraved shape in world space.\n */\nexport async function engrave(shape: Shape, params: EngraveParams): Promise<Shape> {\n  // 1. 生成装饰几何（局部空间，+Z = 挤出方向）\n  let decorationGeo: THREE.BufferGeometry\n\n  if (params.text) {\n    if (!params.text) throw new Error('Text is empty')\n    const { getOpentypeFont, createTextGeometry } = await import(\n      '../primitives/text-geometry'\n    )\n    const { containsCjk, loadSystemCjkFont, createMixedTextGeometry } = await import(\n      '../primitives/text/cjk'\n    )\n    const font = await getOpentypeFont()\n    if (containsCjk(params.text)) {\n      const cjkFont = await loadSystemCjkFont()\n      if (cjkFont) {\n        decorationGeo = await createMixedTextGeometry(\n          params.text, params.textSize ?? 10, params.depth, cjkFont.font, font,\n        )\n      } else {\n        decorationGeo = await createTextGeometry(\n          params.text, params.textSize ?? 10, params.depth, font,\n        )\n      }\n    } else {\n      decorationGeo = await createTextGeometry(\n        params.text, params.textSize ?? 10, params.depth, font,\n      )\n    }\n  } else if (params.svg) {\n    // logo / SVG\n    decorationGeo = svgToExtrudedGeometry(params.svg, {\n      depth: params.depth,\n      targetLongSide: params.svgSize,\n      naturalWidth: params.svgNaturalWidth ?? 0,\n      naturalHeight: params.svgNaturalHeight ?? 0,\n    })\n  } else {\n    throw new Error('engrave requires either text or svg')\n  }\n\n  // 2. 定位装饰几何到面\n  const faceCenter = new THREE.Vector3(...params.face.center)\n  const faceNormal = new THREE.Vector3(...params.face.normal)\n\n  // Center geometry at origin\n  decorationGeo.computeBoundingBox()\n  const center = new THREE.Vector3()\n  decorationGeo.boundingBox!.getCenter(center)\n  decorationGeo.translate(-center.x, -center.y, -center.z)\n\n  // Rotate +Z to align with face normal\n  const quat = new THREE.Quaternion().setFromUnitVectors(\n    new THREE.Vector3(0, 0, 1),\n    faceNormal,\n  )\n  decorationGeo.applyQuaternion(quat)\n\n  // Offset along normal (convex = outward, concave = inward)\n  const offset = params.mode === 'convex' ? params.depth / 2 : -params.depth / 2\n  const pos = faceCenter.clone().add(faceNormal.clone().multiplyScalar(offset))\n  decorationGeo.translate(pos.x, pos.y, pos.z)\n\n  // 3. 转换为 ManifoldMeshData\n  const decorationData = geoToManifoldMesh(decorationGeo)\n\n  // 4. 布尔运算\n  const op = params.mode === 'convex' ? 'union' : 'subtract'\n  const result = await computeBoolean([shape, decorationData], op)\n\n  // 5. 清理\n  decorationGeo.dispose()\n\n  return result\n}\n\n/**\n * Apply a knurling texture displacement to a shape (vertex displacement, not a\n * boolean op). The replay path approximates UI face selection by excluding\n * faces whose normal deviates from the given face normal; the angle limits act\n * as an angular mask.\n *\n * @param shape - the world-space shape to knurl.\n * @param params - knurl parameters (texture height, refine length, UV scale, mapping mode).\n * @returns the displaced shape in world space.\n */\nexport async function knurl(shape: Shape, params: KnurlParams): Promise<Shape> {\n  const { applyKnurlDisplacement, KNURL_DEFAULTS } = await import(\n    './knurl/KnurlGenerator'\n  )\n\n  // 1. Shape → THREE.BufferGeometry\n  const geo = manifoldMeshToGeo(shape, { computeNormals: true })\n\n  // 2. 计算面排除权重：法向与 face.normal 不接近的面标记为排除\n  const posAttr = geo.getAttribute('position')\n  const triCount = posAttr.count / 3\n  const faceNormal = new THREE.Vector3(...params.face.normal).normalize()\n\n  // 计算每个三角形的法向\n  const positions = posAttr.array as Float32Array\n  const indices = geo.index ? (geo.index.array as Uint32Array) : null\n  const faceWeights = new Float32Array(posAttr.count)\n\n  const v0 = new THREE.Vector3()\n  const v1 = new THREE.Vector3()\n  const v2 = new THREE.Vector3()\n  const edge1 = new THREE.Vector3()\n  const edge2 = new THREE.Vector3()\n  const triNormal = new THREE.Vector3()\n\n  for (let t = 0; t < triCount; t++) {\n    const i0 = indices ? indices[t * 3] : t * 3\n    const i1 = indices ? indices[t * 3 + 1] : t * 3 + 1\n    const i2 = indices ? indices[t * 3 + 2] : t * 3 + 2\n\n    v0.set(positions[i0 * 3], positions[i0 * 3 + 1], positions[i0 * 3 + 2])\n    v1.set(positions[i1 * 3], positions[i1 * 3 + 1], positions[i1 * 3 + 2])\n    v2.set(positions[i2 * 3], positions[i2 * 3 + 1], positions[i2 * 3 + 2])\n\n    edge1.subVectors(v1, v0)\n    edge2.subVectors(v2, v0)\n    triNormal.crossVectors(edge1, edge2).normalize()\n\n    // 法向相似度：dot > 0.5 (~60° within) → 不排除\n    const dot = triNormal.dot(faceNormal)\n    if (dot < 0.5) {\n      faceWeights[t * 3] = 1.0\n      faceWeights[t * 3 + 1] = 1.0\n      faceWeights[t * 3 + 2] = 1.0\n    }\n  }\n\n  // 3. 计算包围盒\n  geo.computeBoundingBox()\n  const bb = geo.boundingBox!\n  const partBounds = {\n    min: bb.min.clone(),\n    max: bb.max.clone(),\n    size: new THREE.Vector3().subVectors(bb.max, bb.min),\n    center: new THREE.Vector3().addVectors(bb.min, bb.max).multiplyScalar(0.5),\n  }\n\n  // 4. 调用 applyKnurlDisplacement\n  const resultGeo = await applyKnurlDisplacement(\n    geo,\n    {\n      ...KNURL_DEFAULTS,\n      textureHeight: params.knurlTextureHeight,\n      invertDisplacement: params.knurlInvertDisplacement,\n      refineLength: params.knurlRefineLength,\n      scaleU: params.knurlScaleU,\n      scaleV: params.knurlScaleV,\n      mappingMode: params.knurlMappingMode,\n      faceWeights,\n    },\n    undefined,\n    partBounds,\n  )\n\n  geo.dispose()\n\n  // 5. THREE.BufferGeometry → Shape\n  return geoToManifoldMesh(resultGeo)\n}\n"]}
+{"version":3,"file":"engrave.js","sourceRoot":"","sources":["../../src/mesh/engrave.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * mesh 雕刻 API\n *\n * 提取来源：engine/components/engraving/EngravingCore.ts\n *\n * 从 executeEngraving 中提取纯几何计算部分：\n * 1. 生成装饰几何（文字或 SVG）\n * 2. 定位到面\n * 3. 布尔运算（凸=union，凹=subtract）\n *\n * 不包含：store 读写、commitGeometry、undo snapshot、toast。\n * 这些由执行器负责（P1 不改变现有执行器行为）。\n */\n\nimport * as THREE from 'three'\nimport { computeBoolean, geoToManifoldMesh, manifoldMeshToGeo } from '../boolean/csg-backend'\nimport { getEngraveDecorationProvider } from './decoration-provider'\nimport type { Shape, EngraveParams, KnurlParams } from './types'\n\n/**\n * Execute an engraving: generate the decoration geometry (text or SVG),\n * position it onto a face, then run a boolean union (convex) or subtract\n * (concave).\n *\n * The decoration geometry itself comes from the host-installed provider\n * (`setEngraveDecorationProvider`) — three's `Shape`/`ExtrudeGeometry`/`SVGLoader`\n * chain belongs to `@faicad/faijs-extra`, not to the platform surface.\n *\n * @param shape - the world-space target shape.\n * @param params - engrave parameters (text/svg, depth, face, mode).\n * @returns the engraved shape in world space.\n */\nexport async function engrave(shape: Shape, params: EngraveParams): Promise<Shape> {\n  // 1. 生成装饰几何（局部空间，+Z = 挤出方向）\n  if (!params.text && !params.svg) {\n    throw new Error('engrave requires either text or svg')\n  }\n  const provider = getEngraveDecorationProvider()\n  if (!provider) {\n    throw new Error(\n      'engrave: no mesh decoration provider installed — the text/SVG geometry chain ' +\n      'lives in @faicad/faijs-extra; call setEngraveDecorationProvider() (or ' +\n      'installEditorMeshProviders() from @faicad/faijs-extra) before engraving in mesh mode, ' +\n      'or run the op on the BREP path',\n    )\n  }\n  const decorationGeo: THREE.BufferGeometry = await provider({\n    text: params.text,\n    textSize: params.textSize,\n    svg: params.svg,\n    svgSize: params.svgSize,\n    svgNaturalWidth: params.svgNaturalWidth,\n    svgNaturalHeight: params.svgNaturalHeight,\n    depth: params.depth,\n  })\n\n  // 2. 定位装饰几何到面\n  const faceCenter = new THREE.Vector3(...params.face.center)\n  const faceNormal = new THREE.Vector3(...params.face.normal)\n\n  // Center geometry at origin\n  decorationGeo.computeBoundingBox()\n  const center = new THREE.Vector3()\n  decorationGeo.boundingBox!.getCenter(center)\n  decorationGeo.translate(-center.x, -center.y, -center.z)\n\n  // Rotate +Z to align with face normal\n  const quat = new THREE.Quaternion().setFromUnitVectors(\n    new THREE.Vector3(0, 0, 1),\n    faceNormal,\n  )\n  decorationGeo.applyQuaternion(quat)\n\n  // Offset along normal (convex = outward, concave = inward)\n  const offset = params.mode === 'convex' ? params.depth / 2 : -params.depth / 2\n  const pos = faceCenter.clone().add(faceNormal.clone().multiplyScalar(offset))\n  decorationGeo.translate(pos.x, pos.y, pos.z)\n\n  // 3. 转换为 ManifoldMeshData\n  const decorationData = geoToManifoldMesh(decorationGeo)\n\n  // 4. 布尔运算\n  const op = params.mode === 'convex' ? 'union' : 'subtract'\n  const result = await computeBoolean([shape, decorationData], op)\n\n  // 5. 清理\n  decorationGeo.dispose()\n\n  return result\n}\n\n/**\n * Apply a knurling texture displacement to a shape (vertex displacement, not a\n * boolean op). The replay path approximates UI face selection by excluding\n * faces whose normal deviates from the given face normal; the angle limits act\n * as an angular mask.\n *\n * @param shape - the world-space shape to knurl.\n * @param params - knurl parameters (texture height, refine length, UV scale, mapping mode).\n * @returns the displaced shape in world space.\n */\nexport async function knurl(shape: Shape, params: KnurlParams): Promise<Shape> {\n  const { applyKnurlDisplacement, KNURL_DEFAULTS } = await import(\n    './knurl/KnurlGenerator'\n  )\n\n  // 1. Shape → THREE.BufferGeometry\n  const geo = manifoldMeshToGeo(shape, { computeNormals: true })\n\n  // 2. 计算面排除权重：法向与 face.normal 不接近的面标记为排除\n  const posAttr = geo.getAttribute('position')\n  const triCount = posAttr.count / 3\n  const faceNormal = new THREE.Vector3(...params.face.normal).normalize()\n\n  // 计算每个三角形的法向\n  const positions = posAttr.array as Float32Array\n  const indices = geo.index ? (geo.index.array as Uint32Array) : null\n  const faceWeights = new Float32Array(posAttr.count)\n\n  const v0 = new THREE.Vector3()\n  const v1 = new THREE.Vector3()\n  const v2 = new THREE.Vector3()\n  const edge1 = new THREE.Vector3()\n  const edge2 = new THREE.Vector3()\n  const triNormal = new THREE.Vector3()\n\n  for (let t = 0; t < triCount; t++) {\n    const i0 = indices ? indices[t * 3] : t * 3\n    const i1 = indices ? indices[t * 3 + 1] : t * 3 + 1\n    const i2 = indices ? indices[t * 3 + 2] : t * 3 + 2\n\n    v0.set(positions[i0 * 3], positions[i0 * 3 + 1], positions[i0 * 3 + 2])\n    v1.set(positions[i1 * 3], positions[i1 * 3 + 1], positions[i1 * 3 + 2])\n    v2.set(positions[i2 * 3], positions[i2 * 3 + 1], positions[i2 * 3 + 2])\n\n    edge1.subVectors(v1, v0)\n    edge2.subVectors(v2, v0)\n    triNormal.crossVectors(edge1, edge2).normalize()\n\n    // 法向相似度：dot > 0.5 (~60° within) → 不排除\n    const dot = triNormal.dot(faceNormal)\n    if (dot < 0.5) {\n      faceWeights[t * 3] = 1.0\n      faceWeights[t * 3 + 1] = 1.0\n      faceWeights[t * 3 + 2] = 1.0\n    }\n  }\n\n  // 3. 计算包围盒\n  geo.computeBoundingBox()\n  const bb = geo.boundingBox!\n  const partBounds = {\n    min: bb.min.clone(),\n    max: bb.max.clone(),\n    size: new THREE.Vector3().subVectors(bb.max, bb.min),\n    center: new THREE.Vector3().addVectors(bb.min, bb.max).multiplyScalar(0.5),\n  }\n\n  // 4. 调用 applyKnurlDisplacement\n  const resultGeo = await applyKnurlDisplacement(\n    geo,\n    {\n      ...KNURL_DEFAULTS,\n      textureHeight: params.knurlTextureHeight,\n      invertDisplacement: params.knurlInvertDisplacement,\n      refineLength: params.knurlRefineLength,\n      scaleU: params.knurlScaleU,\n      scaleV: params.knurlScaleV,\n      mappingMode: params.knurlMappingMode,\n      faceWeights,\n    },\n    undefined,\n    partBounds,\n  )\n\n  geo.dispose()\n\n  // 5. THREE.BufferGeometry → Shape\n  return geoToManifoldMesh(resultGeo)\n}\n"]}