@faicad/faijs 0.32.3 → 0.33.2

package/dist/brep/export/step.js.map

@@ -1 +1 @@
-{"version":3,"file":"step.js","sourceRoot":"","sources":["../../../src/brep/export/step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAA;AAC5E,OAAO,EAAE,aAAa,EAAoB,MAAM,8BAA8B,CAAA;AAE9E,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAC/E,OAAO,EAAE,mBAAmB,EAAsB,MAAM,eAAe,CAAA;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AA6BvC;;;;;;;;;GASG;AACH,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,EAAE,GAAG,CAAC,CAAA;AACtE,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,eAAe,CAAC,CAAW;IAClC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAA;IACvD,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,GAAG,QAAQ,EAAE,CAAC;QAC/B,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,EAAE,CAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,CAAA;IAC5E,CAAC;IACD,0CAA0C;IAC1C,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAA;AACrD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,CAA4B;IACvD,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IACxB,MAAM,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAA;IAChC,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC,CAAA;IACzC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAA;AACzD,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAC5B,IAAuB,EACvB,OAAwB,EACxB,GAA+E;IAE/E,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAC/D,MAAM,KAAK,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAA;QACvE,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,qBAAqB,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;QAC/C,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC,CAAA;QACzD,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,CAAW;IAC/B,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;WACtD,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;WACpD,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;AAC7D,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAS,sBAAsB,CAC7B,MAAqB,EACrB,GAAiB,EACjB,KAAsB,EACtB,YAA0B;IAE1B,MAAM,YAAY,GAAG,CAAC,CAAkB,EAAc,EAAE;QACtD,IAAI,CAAC,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC,KAAK,CAAA;QAC3B,IAAI,CAAC,CAAC,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;QACjF,MAAM,CAAC,GAAG,wBAAwB,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC5E,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACpB,OAAO,CAAC,CAAA;IACV,CAAC,CAAA;IACD,MAAM,IAAI,GAAG,CAAC,CAAkB,EAAE,CAAkB,EAAc,EAAE;QAClE,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,CAAA;QAC5B,IAAI,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAA;QACtC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACxC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACzB,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;IACD,MAAM,MAAM,GAAG,CAAC,CAAuC,EAAwC,EAAE,CAC/F,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAE9E,MAAM,MAAM,GAA+E,EAAE,CAAA;IAC7F,qBAAqB,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;IACzD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;IAEnF,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAA;IAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAM,CAAC,KAAK,EAAE,KAAM,CAAC,KAAK,CAA2B,EAAE;QACrF,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,KAAM,CAAC,KAAK,CAAC,IAAI;QACrC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,KAAM,CAAC,KAAK,CAAC,KAAK,CAAC;KACjD,CAAC,CAAA;IACF,uCAAuC;IACvC,0CAA0C;IAC1C,wCAAwC;IACxC,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,KAAiB,CAAA;QACrB,IAAI,QAAgG,CAAA;QACpG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,oCAAoC;YACpC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;QACtC,CAAC;aAAM,CAAC;YACN,wDAAwD;YACxD,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAChC,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACtD,CAAC;QACD,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,KAA+B,EAAE;YACnD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACnE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9E,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;SAChD,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,IAAI,KAAM,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,KAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACxE,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QACrC,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,KAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACnC,MAAM,KAAK,GAAG,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAA;YACvC,IAAI,KAAK;gBAAE,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,KAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAClD,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAqB,EACrB,OAA0B,EAC1B,QAAmB;IAEnB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC,kBAAkB,EAAE,CAAA;IAChD,gDAAgD;IAChD,0CAA0C;IAC1C,MAAM,YAAY,GAAiB,EAAE,CAAA;IAErC,IAAI,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,wDAAwD;YACxD,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChD,sBAAsB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,CAAC,CAAA;gBACxD,SAAQ;YACV,CAAC;YACD,oCAAoC;YACpC,IAAI,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;YACvB,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oBAChB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;gBACtE,CAAC;gBACD,KAAK,GAAG,wBAAwB,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;gBAClF,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAC1B,CAAC;YAED,uDAAuD;YACvD,8CAA8C;YAC9C,uDAAuD;YACvD,kDAAkD;YAClD,sDAAsD;YACtD,2BAA2B;YAC3B,IAAI,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YAC9C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YAC5C,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;YAC3C,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;YAC3C,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,0DAA0D;gBAC1D,wDAAwD;gBACxD,8CAA8C;gBAC9C,0DAA0D;gBAC1D,iCAAiC;gBACjC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;YAChB,CAAC;YACD,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;gBACxC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAA;gBACpB,mCAAmC;gBACnC,IAAI,KAAK,KAAK,GAAG;oBAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACzC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;oBAC1B,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,MAAM,KAAK,EAAE,GAAG,CAAC,GAAG;oBACvC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAA;gBACd,yDAAyD;gBACzD,6CAA6C;gBAC7C,MAAM,KAAK,GAAyC,KAAK,CAAC,KAAK;oBAC7D,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC5F,CAAC,CAAC,SAAS,CAAA;gBACb,4DAA4D;gBAC5D,sBAAsB;gBACtB,GAAG,CAAC,QAAQ,CAAC,GAA6B,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;YAC9D,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,EAAE,CAAA;QACjC,mEAAmE;QACnE,wDAAwD;QACxD,MAAM,GAAG,GAAG,QAAQ,IAAI,uBAAuB,CAAC,QAAQ,CAAC;YACvD,CAAC,CAAC,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC;YACvC,CAAC,CAAC,QAAQ,CAAA;QACZ,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAA;IAC7C,CAAC;YAAS,CAAC;QACT,2BAA2B;QAC3B,GAAG,CAAC,KAAK,EAAE,CAAA;QACX,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,mBAAmB;YACrB,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAiB,EACjB,MAAqB;IAErB,OAAO,oBAAoB,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;AAClD,CAAC","sourcesContent":["/**\n * exportStepFromSolids — L1 STEP 导出（从 OCCT solid 句柄，多实体、零 fuse）\n *\n * @platform occt — 本文件 import occt-kernel（createXCAFDocument/XCAF label 写入是\n * occt-only 平台面，D3）。文件级标注满足守卫①（平台 import 自证身份）。\n *\n * 每个 entry 作为 STEP 中一个独立实体（独立 XCAF label / PRODUCT）导出，\n * 保留名称与颜色。多实体之间绝不 fuse —— 这是硬性约定：\n * fuse 只允许作为用户脚本里的几何布尔运算，禁止作为导出时的实体合并手段。\n *\n * 导出 → 再导入身份闭环：导入侧 importAssemblyFromStep（XCAF）会把\n * 多实体 STEP 还原为多个 part；多 solid compound 拆分出的子节点命名为\n * `name [n]`，与本节点的展平命名规则一致。\n */\n\nimport type { BrepHandle } from '../engine/types'\nimport type { BrepEngineApi } from '../engine/primitives'\nimport type { XCAFDocument } from 'occt-wasm'\nimport { reconstructSolidFromMesh } from '../../occt-kernel/meshReconstruct'\nimport { getOcctKernel, type ShapeHandle } from '../../occt-kernel/occtKernel'\nimport type { FileMeta } from '../../api/meta'\nimport { rewriteStepHeader, fileMetaHasHeaderFields } from './step-meta-header'\nimport { transformToMatrix12, type NodeTransform } from './transform12'\nimport { composeMatrix12 } from './stl'\n\n/** STEP 导出条目：一个 part（精确 BREP 形状或三角网格，二选一）或一个装配容器。 */\nexport interface StepExportEntry {\n  /** 精确 BREP 形状（solid/shell/face/compound，来自宿主导出缓存）。与 mesh 二选一，solid 优先。 */\n  solid?: BrepHandle\n  /** 三角网格（世界坐标、已按单位缩放），经 reconstructSolidFromMesh 重建为实体。 */\n  mesh?: { positions: Float32Array; indices: Uint32Array }\n  /** 实体名称（写入 label name，导出为 PRODUCT 名称）。 */\n  name?: string\n  /** RGB 0..1 颜色（sRGB 编码，如宿主材质 base color）。写入前转 linear。 */\n  color?: [number, number, number]\n  /**\n   * 装配子节点（方案 2026-10-08 步骤 7 / P3）：非空时本条目按**真装配容器**写出\n   * （XCAF assembly + component），不再展平为平级 PRODUCT。容器自身不贡献几何\n   * （compound 几何 == 成员并集，写出会重复）。\n   *\n   * 写出语义：直接子叶的完整位姿（平移 + 旋转）走 XCAF component location；\n   * 首叶位姿烘进晋升几何；嵌套容器的叶递归收集后作为顶层容器的直接组件\n   * （子装配分组待 wasm 提供空装配 label 原语后升级）。\n   */\n  children?: StepExportEntry[]\n  /**\n   * 本节点相对父的位姿（与 `Shape.transform` 同形态，坐标已按单位刻度换算）。\n   * 直接子节点写 XCAF component location；更深层的叶子烘进几何。\n   */\n  transform?: NodeTransform\n}\n\n/**\n * sRGB → linear 转换。\n *\n * OCCT XCAF 内部按 linear RGB 存储颜色，STEP writer（xcafExportSTEP）\n * 导出时做 linear→sRGB 编码写 COLOUR_RGB。为了让\"宿主传入的 sRGB 颜色 ==\n * STEP 文件中的 COLOUR_RGB == 回读颜色\"，写入前必须先转 linear。\n *\n * @param c sRGB 编码值（0..1）\n * @returns linear 值（0..1）\n */\nfunction srgbToLinear(c: number): number {\n  return c <= 0.04045 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4)\n}\n\n/**\n * 3×3 行主序旋转矩阵 → Euler 角（弧度）。\n *\n * 约定 **R = Rz(rz)·Ry(ry)·Rx(rx)**（X 先转，Z 最后）——这是 occt-wasm\n * `xcafAddComponent` 的合成约定（`trsf = rotZ * rotY * rotX`），由\n * `xcaf-step-assembly-fidelity.test.ts`（occt-wasm 仓）的 Rz/Rx 往返测试与\n * 本仓 step-export 装配测试共同钉住：若 wasm 侧改约定，两边测试先红。\n */\nfunction rotationToEuler(m: number[]): { rx: number; ry: number; rz: number } {\n  const ry = -Math.asin(Math.max(-1, Math.min(1, m[8]!)))\n  if (Math.abs(m[8]!) < 0.999999) {\n    return { rx: Math.atan2(m[9]!, m[10]!), ry, rz: Math.atan2(m[4]!, m[0]!) }\n  }\n  // 万向锁：m[8] = ±1 时 rx/rz 耦合，取 rz = 0 的退化解。\n  return { rx: Math.atan2(-m[6]!, m[5]!), ry, rz: 0 }\n}\n\n/**\n * 节点位姿 → wasm `addChild({location})` 的分量形态：平移 + Euler 角（弧度）。\n *\n * 完整位姿走 location（旋转分量经 occt-wasm `xcaf-step-assembly-fidelity`\n * 往返测试证实保真，不再烘进几何）。坐标刻度由调用方保证（export-model\n * 映射时已按单位换算平移分量）。\n */\nfunction transformToLocation(t: NodeTransform | undefined): { tx: number; ty: number; tz: number; rx: number; ry: number; rz: number } | undefined {\n  if (!t) return undefined\n  const m = transformToMatrix12(t)\n  const { rx, ry, rz } = rotationToEuler(m)\n  return { tx: m[3]!, ty: m[7]!, tz: m[11]!, rx, ry, rz }\n}\n\n/**\n * 装配容器的叶子收集：嵌套容器递归展开，位姿沿树复合（行主序 3×4）。\n * `nested` = 该叶经过了嵌套容器（非顶层容器的直接子节点）。\n */\nfunction collectAssemblyLeaves(\n  list: StepExportEntry[],\n  parentM: number[] | null,\n  out: Array<{ entry: StepExportEntry; world: number[] | null; nested: boolean }>,\n): void {\n  for (const c of list) {\n    const m = c.transform ? transformToMatrix12(c.transform) : null\n    const world = m && parentM ? composeMatrix12(parentM, m) : m ?? parentM\n    if (c.children && c.children.length > 0) {\n      collectAssemblyLeaves(c.children, world, out)\n    } else {\n      out.push({ entry: c, world, nested: parentM !== null })\n    }\n  }\n}\n\nfunction isIdentity12(m: number[]): boolean {\n  return m[0] === 1 && m[1] === 0 && m[2] === 0 && m[3] === 0\n    && m[4] === 0 && m[5] === 1 && m[6] === 0 && m[7] === 0\n    && m[8] === 0 && m[9] === 0 && m[10] === 1 && m[11] === 0\n}\n\n/**\n * 写一个装配容器为真装配（XCAF assembly + component，方案步骤 7 / P3）。\n *\n * XCAF 原语约束：`addChild` 只收 shape 句柄、且「part 在首个 child 加入时转为\n * assembly，原几何移入 identity 首组件」。因此：\n * - 首叶几何升起为容器 label 的初始 part，其位姿烘进几何（晋升强制 identity\n *   location，首叶位姿只能烘焙）；\n * - 其余**直接**子叶经 `addChild({location})` 写**完整位姿**（平移 + 旋转）；\n * - 嵌套容器的叶（`nested`）位姿复合后烘进几何、以 identity 位置加入——几何与\n *   名色保真，子装配分组待 wasm 提供空装配 label 原语后升级。\n *\n * 名字保真：容器名优先升起为容器/原型名；容器名与首叶名不同时，在晋升完成后\n * 把首叶名补写回首组件及其原型（setName 必须在 addChild 之后调用——晋升发生\n * 在首个 addChild，此前 getChildren 为空）。组件名与原型名均过 STEP 往返\n * （occt-wasm `xcaf-step-assembly-fidelity.test.ts` 钉住）。\n */\nfunction writeAssemblyContainer(\n  kernel: BrepEngineApi,\n  doc: XCAFDocument,\n  entry: StepExportEntry,\n  ownedHandles: BrepHandle[],\n): void {\n  const resolveSolid = (e: StepExportEntry): BrepHandle => {\n    if (e.solid) return e.solid\n    if (!e.mesh) throw new Error('StepExportEntry must provide either solid or mesh')\n    const s = reconstructSolidFromMesh(kernel, e.mesh.positions, e.mesh.indices)\n    ownedHandles.push(s)\n    return s\n  }\n  const bake = (e: StepExportEntry, m: number[] | null): BrepHandle => {\n    const base = resolveSolid(e)\n    if (!m || isIdentity12(m)) return base\n    const placed = kernel.transform(base, m)\n    ownedHandles.push(placed)\n    return placed\n  }\n  const linear = (c: [number, number, number] | undefined): [number, number, number] | undefined =>\n    c ? [srgbToLinear(c[0]), srgbToLinear(c[1]), srgbToLinear(c[2])] : undefined\n\n  const leaves: Array<{ entry: StepExportEntry; world: number[] | null; nested: boolean }> = []\n  collectAssemblyLeaves(entry.children ?? [], null, leaves)\n  if (leaves.length === 0) throw new Error('Assembly container has no leaf geometry')\n\n  const [first, ...rest] = leaves\n  const label = doc.addShape(bake(first!.entry, first!.world) as unknown as ShapeHandle, {\n    name: entry.name ?? first!.entry.name,\n    color: linear(entry.color ?? first!.entry.color),\n  })\n  // 名字保真：容器名优先升起为容器/原型名；容器名与首叶名不同时，晋升完成后\n  // 把首叶名补写回首组件及其原型（必须在 addChild 之后——晋升发生在首个\n  // addChild，此前 getChildren 为空，过早调用是空操作）。\n  for (const leaf of rest) {\n    let solid: BrepHandle\n    let location: { tx: number; ty: number; tz: number; rx: number; ry: number; rz: number } | undefined\n    if (leaf.nested) {\n      // 嵌套容器的叶：位姿全量复合后烘进几何，identity 位置加入。\n      solid = bake(leaf.entry, leaf.world)\n    } else {\n      // 直接子叶：完整位姿走 location（旋转经 Euler 分解，wasm 按 Rz·Ry·Rx 合成）。\n      solid = resolveSolid(leaf.entry)\n      location = transformToLocation(leaf.entry.transform)\n    }\n    doc.addChild(label, solid as unknown as ShapeHandle, {\n      ...(leaf.entry.name === undefined ? {} : { name: leaf.entry.name }),\n      ...(leaf.entry.color === undefined ? {} : { color: linear(leaf.entry.color) }),\n      ...(location === undefined ? {} : { location }),\n    })\n  }\n  if (entry.name && first!.entry.name && entry.name !== first!.entry.name) {\n    const own = doc.getChildren(label)[0]\n    if (own) {\n      doc.setName(own, first!.entry.name)\n      const proto = doc.getReferredLabel(own)\n      if (proto) doc.setName(proto, first!.entry.name)\n    }\n  }\n}\n\n/**\n * Export multiple BREP solids (and/or triangle meshes) to STEP, one\n * independent entity per entry — no fuse, no string splicing.\n *\n * @param kernel  OCCT kernel (must match the one that created the solids)\n * @param entries parts to export; each becomes its own XCAF label\n * @param fileMeta optional file-level metadata; mapped to the P21 header\n *                 (`FILE_NAME`/`FILE_DESCRIPTION`) via text rewrite\n *                 (`rewriteStepHeader`). No effect on geometry/DATA entities.\n * @returns STEP file content as ArrayBuffer\n * @throws if entries is empty, or a mesh entry fails to reconstruct\n */\nexport function exportStepFromSolids(\n  kernel: BrepEngineApi,\n  entries: StepExportEntry[],\n  fileMeta?: FileMeta,\n): ArrayBuffer {\n  if (entries.length === 0) {\n    throw new Error('No exportable geometry')\n  }\n\n  const doc = getOcctKernel().createXCAFDocument()\n  // 本函数创建的句柄（展平出的子 solid + mesh 重建的 solid），导出后释放。\n  // 缓存里的原 solid（entry.solid）绝不释放，归调用方/缓存所有。\n  const ownedHandles: BrepHandle[] = []\n\n  try {\n    for (const entry of entries) {\n      // 0. 装配容器 → 真装配写入（XCAF assembly + component，步骤 7 / P3）。\n      if (entry.children && entry.children.length > 0) {\n        writeAssemblyContainer(kernel, doc, entry, ownedHandles)\n        continue\n      }\n      // 1. 解析 solid：优先用精确 solid；无则从三角网格重建\n      let solid = entry.solid\n      if (!solid) {\n        if (!entry.mesh) {\n          throw new Error('StepExportEntry must provide either solid or mesh')\n        }\n        solid = reconstructSolidFromMesh(kernel, entry.mesh.positions, entry.mesh.indices)\n        ownedHandles.push(solid)\n      }\n\n      // 2. 展平 Compound（多 solid 导入的 part 其 solid 是 Compound）；\n      //    纯 solid 时 getSubShapes('solid') 返回 [自身]。\n      //    形状类型分派：solid → shell → face → edge。ref 侧（cadquery\n      //    Shape.exportStep）可导出任意类型的形状，面/壳/边 compound（如\n      //    Shape.faces('>Z') / shape.edges('>Z') 的结果）同样要能写进\n      //    STEP（U22，2026-09-09）。\n      let subs = kernel.getSubShapes(solid, 'solid')\n      if (subs.length === 0) {\n        subs = kernel.getSubShapes(solid, 'shell')\n      }\n      if (subs.length === 0) {\n        subs = kernel.getSubShapes(solid, 'face')\n      }\n      if (subs.length === 0) {\n        subs = kernel.getSubShapes(solid, 'edge')\n      }\n      if (subs.length === 0) {\n        // wasm getSubShapes 不展开 compound 层（TopExp_Explorer 默认跳过），\n        // 纯面/壳/边 compound（如 Shape.siblings / faces('>Z') 结果）在这里\n        // 拿不到子形状。把 compound 整体作为单个 XCAF label 写入（STEP\n        // writer 支持 compound 形状，与 ref 侧 cadquery Shape.exportStep\n        // 对 faces/edges compound 的行为一致）。\n        subs = [solid]\n      }\n      for (let si = 0; si < subs.length; si++) {\n        const sub = subs[si]\n        // 展平出的子句柄若不属于调用方缓存，记入 ownedHandles\n        if (solid !== sub) ownedHandles.push(sub)\n        const name = subs.length > 1\n          ? `${entry.name ?? 'part'} [${si + 1}]`\n          : entry.name\n        // sRGB → linear：XCAF 按 linear 存储，STEP writer 输出时线性→sRGB，\n        // 转换后 STEP 文件里的 COLOUR_RGB 才是宿主传入的原始 sRGB 值。\n        const color: [number, number, number] | undefined = entry.color\n          ? [srgbToLinear(entry.color[0]), srgbToLinear(entry.color[1]), srgbToLinear(entry.color[2])]\n          : undefined\n        // 平台面（D3）：XCAF label 写入是 occt-only。BrepHandle ↔ ShapeHandle\n        // 运行时同构，品牌转换只发生在平台边界。\n        doc.addShape(sub as unknown as ShapeHandle, { name, color })\n      }\n    }\n\n    // 3. 导出（每个 label 一个独立 PRODUCT，保留名称/颜色）\n    const stepText = doc.exportSTEP()\n    // 文件级 meta → P21 header 重写（title/creationDate/createor/author/org/\n    // application/description）。无 header 字段时不重写。文本层只改声明不碰几何。\n    const out = fileMeta && fileMetaHasHeaderFields(fileMeta)\n      ? rewriteStepHeader(stepText, fileMeta)\n      : stepText\n    return new TextEncoder().encode(out).buffer\n  } finally {\n    // 4. 释放顺序：先关文档，再释放本函数创建的句柄\n    doc.close()\n    for (const h of ownedHandles) {\n      try {\n        kernel.release(h)\n      } catch {\n        // already released\n      }\n    }\n  }\n}\n\n/**\n * Export a BREP solid (OCCT native) to STEP format.\n *\n * 单实体导出 = exportStepFromSolids 的单条目特例（同一实现，无第二真源）。\n *\n * @param solid   OCCT solid handle\n * @param kernel  OCCT kernel (must match the one that created the solid)\n * @returns STEP file content as ArrayBuffer\n */\nexport function exportStepFromSolid(\n  solid: BrepHandle,\n  kernel: BrepEngineApi,\n): ArrayBuffer {\n  return exportStepFromSolids(kernel, [{ solid }])\n}"]}
+{"version":3,"file":"step.js","sourceRoot":"","sources":["../../../src/brep/export/step.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * exportStepFromSolids — L1 STEP 导出（从 OCCT solid 句柄，多实体、零 fuse）\n *\n * @platform occt — 本文件 import occt-kernel（createXCAFDocument/XCAF label 写入是\n * occt-only 平台面，D3）。文件级标注满足守卫①（平台 import 自证身份）。\n *\n * 每个 entry 作为 STEP 中一个独立实体（独立 XCAF label / PRODUCT）导出，\n * 保留名称与颜色。多实体之间绝不 fuse —— 这是硬性约定：\n * fuse 只允许作为用户脚本里的几何布尔运算，禁止作为导出时的实体合并手段。\n *\n * 导出 → 再导入身份闭环：导入侧 importAssemblyFromStep（XCAF）会把\n * 多实体 STEP 还原为多个 part；多 solid compound 拆分出的子节点命名为\n * `name [n]`，与本节点的展平命名规则一致。\n */\n\nimport type { BrepHandle, BrepSubShapeType } from '../engine/types'\nimport type { BrepEngineApi } from '../engine/primitives'\nimport type { XCAFDocument } from 'occt-wasm'\nimport { reconstructSolidFromMesh } from '../../occt-kernel/meshReconstruct'\nimport { getOcctKernel, type ShapeHandle } from '../../occt-kernel/occtKernel'\nimport type { FileMeta } from '../../api/meta'\nimport { rewriteStepHeader, fileMetaHasHeaderFields } from './step-meta-header'\nimport { transformToMatrix12, type NodeTransform } from './transform12'\nimport { composeMatrix12 } from './stl'\n\n/** STEP 导出条目：一个 part（精确 BREP 形状或三角网格，二选一）或一个装配容器。 */\nexport interface StepExportEntry {\n  /** 精确 BREP 形状（solid/shell/face/compound，来自宿主导出缓存）。与 mesh 二选一，solid 优先。 */\n  solid?: BrepHandle\n  /** 三角网格（世界坐标、已按单位缩放），经 reconstructSolidFromMesh 重建为实体。 */\n  mesh?: { positions: Float32Array; indices: Uint32Array }\n  /** 实体名称（写入 label name，导出为 PRODUCT 名称）。 */\n  name?: string\n  /** RGB 0..1 颜色（sRGB 编码，如宿主材质 base color）。写入前转 linear。 */\n  color?: [number, number, number]\n  /**\n   * 装配子节点（方案 2026-10-08 步骤 7 / P3）：非空时本条目按**真装配容器**写出\n   * （XCAF assembly + component），不再展平为平级 PRODUCT。容器自身不贡献几何\n   * （compound 几何 == 成员并集，写出会重复）。\n   *\n   * 写出语义：直接子叶的完整位姿（平移 + 旋转）走 XCAF component location；\n   * 首叶位姿烘进晋升几何；嵌套容器的叶递归收集后作为顶层容器的直接组件\n   * （子装配分组待 wasm 提供空装配 label 原语后升级）。\n   */\n  children?: StepExportEntry[]\n  /**\n   * 本节点相对父的位姿（与 `Shape.transform` 同形态，坐标已按单位刻度换算）。\n   * 直接子节点写 XCAF component location；更深层的叶子烘进几何。\n   */\n  transform?: NodeTransform\n}\n\n/**\n * sRGB → linear 转换。\n *\n * OCCT XCAF 内部按 linear RGB 存储颜色，STEP writer（xcafExportSTEP）\n * 导出时做 linear→sRGB 编码写 COLOUR_RGB。为了让\"宿主传入的 sRGB 颜色 ==\n * STEP 文件中的 COLOUR_RGB == 回读颜色\"，写入前必须先转 linear。\n *\n * @param c sRGB 编码值（0..1）\n * @returns linear 值（0..1）\n */\nfunction srgbToLinear(c: number): number {\n  return c <= 0.04045 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4)\n}\n\n/**\n * 3×3 行主序旋转矩阵 → Euler 角（弧度）。\n *\n * 约定 **R = Rz(rz)·Ry(ry)·Rx(rx)**（X 先转，Z 最后）——这是 occt-wasm\n * `xcafAddComponent` 的合成约定（`trsf = rotZ * rotY * rotX`），由\n * `xcaf-step-assembly-fidelity.test.ts`（occt-wasm 仓）的 Rz/Rx 往返测试与\n * 本仓 step-export 装配测试共同钉住：若 wasm 侧改约定，两边测试先红。\n */\nfunction rotationToEuler(m: number[]): { rx: number; ry: number; rz: number } {\n  const ry = -Math.asin(Math.max(-1, Math.min(1, m[8]!)))\n  if (Math.abs(m[8]!) < 0.999999) {\n    return { rx: Math.atan2(m[9]!, m[10]!), ry, rz: Math.atan2(m[4]!, m[0]!) }\n  }\n  // 万向锁：m[8] = ±1 时 rx/rz 耦合，取 rz = 0 的退化解。\n  return { rx: Math.atan2(-m[6]!, m[5]!), ry, rz: 0 }\n}\n\n/**\n * 节点位姿 → wasm `addChild({location})` 的分量形态：平移 + Euler 角（弧度）。\n *\n * 完整位姿走 location（旋转分量经 occt-wasm `xcaf-step-assembly-fidelity`\n * 往返测试证实保真，不再烘进几何）。坐标刻度由调用方保证（export-model\n * 映射时已按单位换算平移分量）。\n */\nfunction transformToLocation(t: NodeTransform | undefined): { tx: number; ty: number; tz: number; rx: number; ry: number; rz: number } | undefined {\n  if (!t) return undefined\n  const m = transformToMatrix12(t)\n  const { rx, ry, rz } = rotationToEuler(m)\n  return { tx: m[3]!, ty: m[7]!, tz: m[11]!, rx, ry, rz }\n}\n\n/**\n * 装配容器的叶子收集：嵌套容器递归展开，位姿沿树复合（行主序 3×4）。\n * `nested` = 该叶经过了嵌套容器（非顶层容器的直接子节点）。\n */\nfunction collectAssemblyLeaves(\n  list: StepExportEntry[],\n  parentM: number[] | null,\n  out: Array<{ entry: StepExportEntry; world: number[] | null; nested: boolean }>,\n): void {\n  for (const c of list) {\n    const m = c.transform ? transformToMatrix12(c.transform) : null\n    const world = m && parentM ? composeMatrix12(parentM, m) : m ?? parentM\n    if (c.children && c.children.length > 0) {\n      collectAssemblyLeaves(c.children, world, out)\n    } else {\n      out.push({ entry: c, world, nested: parentM !== null })\n    }\n  }\n}\n\nfunction isIdentity12(m: number[]): boolean {\n  return m[0] === 1 && m[1] === 0 && m[2] === 0 && m[3] === 0\n    && m[4] === 0 && m[5] === 1 && m[6] === 0 && m[7] === 0\n    && m[8] === 0 && m[9] === 0 && m[10] === 1 && m[11] === 0\n}\n\n/**\n * 写一个装配容器为真装配（XCAF assembly + component，方案步骤 7 / P3）。\n *\n * XCAF 原语约束：`addChild` 只收 shape 句柄、且「part 在首个 child 加入时转为\n * assembly，原几何移入 identity 首组件」。因此：\n * - 首叶几何升起为容器 label 的初始 part，其位姿烘进几何（晋升强制 identity\n *   location，首叶位姿只能烘焙）；\n * - 其余**直接**子叶经 `addChild({location})` 写**完整位姿**（平移 + 旋转）；\n * - 嵌套容器的叶（`nested`）位姿复合后烘进几何、以 identity 位置加入——几何与\n *   名色保真，子装配分组待 wasm 提供空装配 label 原语后升级。\n *\n * 名字保真：容器名优先升起为容器/原型名；容器名与首叶名不同时，在晋升完成后\n * 把首叶名补写回首组件及其原型（setName 必须在 addChild 之后调用——晋升发生\n * 在首个 addChild，此前 getChildren 为空）。组件名与原型名均过 STEP 往返\n * （occt-wasm `xcaf-step-assembly-fidelity.test.ts` 钉住）。\n */\nfunction writeAssemblyContainer(\n  kernel: BrepEngineApi,\n  doc: XCAFDocument,\n  entry: StepExportEntry,\n  ownedHandles: BrepHandle[],\n): void {\n  const resolveSolid = (e: StepExportEntry): BrepHandle => {\n    if (e.solid !== undefined) return e.solid\n    if (!e.mesh) throw new Error('StepExportEntry must provide either solid or mesh')\n    const s = reconstructSolidFromMesh(kernel, e.mesh.positions, e.mesh.indices)\n    ownedHandles.push(s)\n    return s\n  }\n  const bake = (e: StepExportEntry, m: number[] | null): BrepHandle => {\n    const base = resolveSolid(e)\n    if (!m || isIdentity12(m)) return base\n    const placed = kernel.transform(base, m)\n    ownedHandles.push(placed)\n    return placed\n  }\n  const linear = (c: [number, number, number] | undefined): [number, number, number] | undefined =>\n    c ? [srgbToLinear(c[0]), srgbToLinear(c[1]), srgbToLinear(c[2])] : undefined\n\n  const leaves: Array<{ entry: StepExportEntry; world: number[] | null; nested: boolean }> = []\n  collectAssemblyLeaves(entry.children ?? [], null, leaves)\n  if (leaves.length === 0) throw new Error('Assembly container has no leaf geometry')\n\n  const [first, ...rest] = leaves\n  const label = doc.addShape(bake(first!.entry, first!.world) as unknown as ShapeHandle, {\n    name: entry.name ?? first!.entry.name,\n    color: linear(entry.color ?? first!.entry.color),\n  })\n  // 名字保真：容器名优先升起为容器/原型名；容器名与首叶名不同时，晋升完成后\n  // 把首叶名补写回首组件及其原型（必须在 addChild 之后——晋升发生在首个\n  // addChild，此前 getChildren 为空，过早调用是空操作）。\n  for (const leaf of rest) {\n    let solid: BrepHandle\n    let location: { tx: number; ty: number; tz: number; rx: number; ry: number; rz: number } | undefined\n    if (leaf.nested) {\n      // 嵌套容器的叶：位姿全量复合后烘进几何，identity 位置加入。\n      solid = bake(leaf.entry, leaf.world)\n    } else {\n      // 直接子叶：完整位姿走 location（旋转经 Euler 分解，wasm 按 Rz·Ry·Rx 合成）。\n      solid = resolveSolid(leaf.entry)\n      location = transformToLocation(leaf.entry.transform)\n    }\n    doc.addChild(label, solid as unknown as ShapeHandle, {\n      ...(leaf.entry.name === undefined ? {} : { name: leaf.entry.name }),\n      ...(leaf.entry.color === undefined ? {} : { color: linear(leaf.entry.color) }),\n      ...(location === undefined ? {} : { location }),\n    })\n  }\n  if (entry.name && first!.entry.name && entry.name !== first!.entry.name) {\n    const own = doc.getChildren(label)[0]\n    if (own) {\n      doc.setName(own, first!.entry.name)\n      const proto = doc.getReferredLabel(own)\n      if (proto) doc.setName(proto, first!.entry.name)\n    }\n  }\n}\n\n/**\n * Export multiple BREP solids (and/or triangle meshes) to STEP, one\n * independent entity per entry — no fuse, no string splicing.\n *\n * @param kernel  OCCT kernel (must match the one that created the solids)\n * @param entries parts to export; each becomes its own XCAF label\n * @param fileMeta optional file-level metadata; mapped to the P21 header\n *                 (`FILE_NAME`/`FILE_DESCRIPTION`) via text rewrite\n *                 (`rewriteStepHeader`). No effect on geometry/DATA entities.\n * @returns STEP file content as ArrayBuffer\n * @throws if entries is empty, or a mesh entry fails to reconstruct\n */\nexport function exportStepFromSolids(\n  kernel: BrepEngineApi,\n  entries: StepExportEntry[],\n  fileMeta?: FileMeta,\n): ArrayBuffer {\n  if (entries.length === 0) {\n    throw new Error('No exportable geometry')\n  }\n\n  const doc = getOcctKernel().createXCAFDocument()\n  // 本函数创建的句柄（展平出的子 solid + mesh 重建的 solid），导出后释放。\n  // 缓存里的原 solid（entry.solid）绝不释放，归调用方/缓存所有。\n  const ownedHandles: BrepHandle[] = []\n\n  try {\n    for (const entry of entries) {\n      // 0. 装配容器 → 真装配写入（XCAF assembly + component，步骤 7 / P3）。\n      if (entry.children && entry.children.length > 0) {\n        writeAssemblyContainer(kernel, doc, entry, ownedHandles)\n        continue\n      }\n      // 1. 解析 solid：优先用精确 solid；无则从三角网格重建\n      let solid = entry.solid\n      if (solid === undefined) {\n        if (!entry.mesh) {\n          throw new Error('StepExportEntry must provide either solid or mesh')\n        }\n        solid = reconstructSolidFromMesh(kernel, entry.mesh.positions, entry.mesh.indices)\n        ownedHandles.push(solid)\n      }\n\n      // 2. 展平 Compound（多 solid 导入的 part 其 solid 是 Compound）；\n      //    纯 solid 时 getSubShapes('solid') 返回 [自身]。\n      //    形状类型分派：solid → shell → face → edge，取首个非空层级。\n      //    ref 侧（cadquery Shape.exportStep）可导出任意类型的形状，面/壳/边\n      //    compound（如 Shape.faces('>Z') / shape.edges('>Z') 的结果）同样要能\n      //    写进 STEP（U22，2026-09-09）。\n      //\n      //    ⚠️ 级联只选一个层级会丢掉平级的更低层级形状：sew 产物常是\n      //    「一个 shell + 一张游离 face」的混合 compound，命中 shell 后那张\n      //    游离 face 拿不到 XCAF label、导出丢面（cq-compat test_sewing__res3）。\n      //    故选中某层级后，再补齐**未被任何已选形状覆盖**的更低层级形状。\n      const levels: BrepSubShapeType[] = ['solid', 'shell', 'face', 'edge']\n      let subs: BrepHandle[] = []\n      let chosenLevel = -1\n      for (let li = 0; li < levels.length; li++) {\n        const found = kernel.getSubShapes(solid, levels[li])\n        if (found.length > 0) {\n          subs = found\n          chosenLevel = li\n          break\n        }\n      }\n      if (chosenLevel < 0) {\n        // 各层全空：wasm getSubShapes 未展开该 compound（如个别纯面/边\n        // compound）。整体作为单个 XCAF label 写入（STEP writer 支持 compound\n        // 形状，与 ref 侧 cadquery Shape.exportStep 对 faces/edges compound\n        // 的行为一致）。\n        subs = [solid]\n      } else {\n        // 补齐游离的更低层级形状：候选与「已选形状（含此前补入者）的同类\n        // 子形状」做 isSame 覆盖判定，不被覆盖者才追加。\n        for (let li = chosenLevel + 1; li < levels.length; li++) {\n          const lower = kernel.getSubShapes(solid, levels[li])\n          if (lower.length === 0) continue\n          const covered: BrepHandle[] = []\n          for (const s of subs) covered.push(...kernel.getSubShapes(s, levels[li]))\n          for (const cand of lower) {\n            if (!covered.some((c) => kernel.isSame(c, cand))) subs.push(cand)\n          }\n        }\n      }\n      for (let si = 0; si < subs.length; si++) {\n        const sub = subs[si]\n        // 展平出的子句柄若不属于调用方缓存，记入 ownedHandles\n        if (solid !== sub) ownedHandles.push(sub)\n        const name = subs.length > 1\n          ? `${entry.name ?? 'part'} [${si + 1}]`\n          : entry.name\n        // sRGB → linear：XCAF 按 linear 存储，STEP writer 输出时线性→sRGB，\n        // 转换后 STEP 文件里的 COLOUR_RGB 才是宿主传入的原始 sRGB 值。\n        const color: [number, number, number] | undefined = entry.color\n          ? [srgbToLinear(entry.color[0]), srgbToLinear(entry.color[1]), srgbToLinear(entry.color[2])]\n          : undefined\n        // 平台面（D3）：XCAF label 写入是 occt-only。BrepHandle ↔ ShapeHandle\n        // 运行时同构，品牌转换只发生在平台边界。\n        doc.addShape(sub as unknown as ShapeHandle, { name, color })\n      }\n    }\n\n    // 3. 导出（每个 label 一个独立 PRODUCT，保留名称/颜色）\n    const stepText = doc.exportSTEP()\n    // 文件级 meta → P21 header 重写（title/creationDate/createor/author/org/\n    // application/description）。无 header 字段时不重写。文本层只改声明不碰几何。\n    const out = fileMeta && fileMetaHasHeaderFields(fileMeta)\n      ? rewriteStepHeader(stepText, fileMeta)\n      : stepText\n    return new TextEncoder().encode(out).buffer\n  } finally {\n    // 4. 释放顺序：先关文档，再释放本函数创建的句柄\n    doc.close()\n    for (const h of ownedHandles) {\n      try {\n        kernel.release(h)\n      } catch {\n        // already released\n      }\n    }\n  }\n}\n\n/**\n * Export a BREP solid (OCCT native) to STEP format.\n *\n * 单实体导出 = exportStepFromSolids 的单条目特例（同一实现，无第二真源）。\n *\n * @param solid   OCCT solid handle\n * @param kernel  OCCT kernel (must match the one that created the solid)\n * @returns STEP file content as ArrayBuffer\n */\nexport function exportStepFromSolid(\n  solid: BrepHandle,\n  kernel: BrepEngineApi,\n): ArrayBuffer {\n  return exportStepFromSolids(kernel, [{ solid }])\n}"]}

package/dist/brep/handle-bridge.d.ts

@@ -2,10 +2,10 @@
  * handle-bridge — OCCT 句柄 → faijs Shape 的 SDK 桥接（B1）
  *
  *
- * 第三方库要造 BREP 产物，需要"OCCT handle → mesh"。`src/brep/brep-ops.ts:17`
- * 有 `import * as THREE from 'three'`，SDK 绝不能 import 它（会把 three 拉进
- * SDK bundle，违反 `src/sdk.test.ts` 的零 heavy 依赖守卫）。本文件在**新建的
- * 零依赖模块**中实现，直接调运行时注入的 `kernel.meshShape`。
+ * 第三方库要造 BREP 产物，需要"OCCT handle → mesh"。SDK 绝不能 import
+ * heavy 几何库（会把它们拉进 SDK bundle，违反 `src/sdk.test.ts` 的零 heavy
+ * 依赖守卫）。本文件在**新建的零依赖模块**中实现，直接调运行时注入的
+ * `kernel.meshShape`。
  *
  * 依赖约束（硬性）：只允许 import `runtime-state`、`api/shape`、type-only
  * `mesh/types`——任何新增依赖必须保持 dist/sdk.js 零 heavy 依赖守卫通过。

package/dist/brep/handle-bridge.js

@@ -2,10 +2,10 @@
  * handle-bridge — OCCT 句柄 → faijs Shape 的 SDK 桥接（B1）
  *
  *
- * 第三方库要造 BREP 产物，需要"OCCT handle → mesh"。`src/brep/brep-ops.ts:17`
- * 有 `import * as THREE from 'three'`，SDK 绝不能 import 它（会把 three 拉进
- * SDK bundle，违反 `src/sdk.test.ts` 的零 heavy 依赖守卫）。本文件在**新建的
- * 零依赖模块**中实现，直接调运行时注入的 `kernel.meshShape`。
+ * 第三方库要造 BREP 产物，需要"OCCT handle → mesh"。SDK 绝不能 import
+ * heavy 几何库（会把它们拉进 SDK bundle，违反 `src/sdk.test.ts` 的零 heavy
+ * 依赖守卫）。本文件在**新建的零依赖模块**中实现，直接调运行时注入的
+ * `kernel.meshShape`。
  *
  * 依赖约束（硬性）：只允许 import `runtime-state`、`api/shape`、type-only
  * `mesh/types`——任何新增依赖必须保持 dist/sdk.js 零 heavy 依赖守卫通过。

package/dist/brep/handle-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"handle-bridge.js","sourceRoot":"","sources":["../../src/brep/handle-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAWnC;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAA;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAA;IAC5G,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAA;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAA;IACH,CAAC;IACD,OAAO,MAAuB,CAAA;AAChC,CAAC;AAYD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAK,CAA8B,CAAC,UAAU,KAAK,IAAI,CAAA;AACnG,CAAC;AAED;0CAC0C;AAC1C,SAAS,YAAY,CAAC,CAAU;IAC9B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,CAAA;AACjD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,MAAe,EAAE,MAAc;IACpD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,yDAAyD;YAC/E,kCAAkC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,MAAM,IAAI;YAC9E,wDAAwD,CAC3D,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAe,EAAE,IAAwB;IAClE,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACnC,MAAM,MAAM,GAAG,SAAS,EAAoB,CAAA;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE;QACpC,gBAAgB,EAAE,IAAI,EAAE,gBAAgB,IAAI,GAAG;QAC/C,iBAAiB,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;KACrE,CAAC,CAAA;IACF,OAAO;QACL,SAAS,EAAE,IAAI,YAAY,CAAC,IAAI,CAAC,SAA8B,CAAC;QAChE,OAAO,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,OAA4B,CAAC;KAC5D,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,MAAe,EAAE,IAAwB;IAClE,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACnC,OAAO,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;AAC9D,CAAC","sourcesContent":["/**\n * handle-bridge — OCCT 句柄 → faijs Shape 的 SDK 桥接（B1）\n *\n *\n * 第三方库要造 BREP 产物，需要\"OCCT handle → mesh\"。`src/brep/brep-ops.ts:17`\n * 有 `import * as THREE from 'three'`，SDK 绝不能 import 它（会把 three 拉进\n * SDK bundle，违反 `src/sdk.test.ts` 的零 heavy 依赖守卫）。本文件在**新建的\n * 零依赖模块**中实现，直接调运行时注入的 `kernel.meshShape`。\n *\n * 依赖约束（硬性）：只允许 import `runtime-state`、`api/shape`、type-only\n * `mesh/types`——任何新增依赖必须保持 dist/sdk.js 零 heavy 依赖守卫通过。\n */\n\nimport type { Shape } from '../mesh/types'\nimport { getBackends } from '../runtime-state'\nimport { fromBrep } from '../shape'\nimport type { BrepEngineApi } from './engine/primitives'\n\n/** 结构化内核接口（不 import occt-wasm，只做结构匹配，避免 heavy 依赖） */\ninterface MeshableKernel {\n  meshShape(\n    handle: unknown,\n    opts: { linearDeflection: number; angularDeflection: number },\n  ): { positions: ArrayLike<number>; indices: ArrayLike<number> }\n}\n\n/**\n * Get the currently injected BREP kernel instance (untyped escape hatch).\n * @deprecated D12: this exit predates the engine-neutral L1 surface and its name\n * (\"OCCT kernel\") no longer matches what it returns — the current engine's raw\n * kernel, whatever engine that is. Prefer `getBrepApi()` (typed, engine-neutral,\n * same file) for neutral ops; platform-only code (L2 face) should use\n * `getOcctKernel()` (D3). Kept for compat-face bridging and existing tests.\n * @returns the current BREP engine's kernel instance.\n * @throws when the kernel is not ready (mesh mode or uninitialized) — never silently returns null.\n */\nexport function getKernel(): unknown {\n  const kernel = getBackends().kernel.brep\n  if (!kernel) {\n    throw new Error('[faijs/bridge] OCCT kernel not available: BREP operations require an initialized kernel')\n  }\n  return kernel\n}\n\n/**\n * Get the current BREP engine as the **L1 core surface** (`BrepEngineApi`).\n *\n * 2026-09-24 narrowing plan（D12）：中立 op 的取内核唯一出口——取代\n * `getBackends().kernel.brep as BrepEngineApi` 的逐点断言。本文件是 L1 契约\n * 的注册点（`registerBrepEngine` 注入的就是 `BrepEngineApi` 实例），此处断言\n * 诚实；平台面（L1 之外的 occt 独有能力）仍走 `getOcctKernel()`（D3）。\n *\n * @returns the current engine's L1 contract surface (`BrepEngineApi`) — typed, engine-neutral.\n * @throws when no BREP engine is registered (uninitialized) — never silently returns null.\n */\nexport function getBrepApi(): BrepEngineApi {\n  const kernel = getBackends().kernel.brep\n  if (!kernel) {\n    throw new Error(\n      '[faijs/bridge] BREP engine API not available: BREP operations require an initialized engine',\n    )\n  }\n  return kernel as BrepEngineApi\n}\n\n/**\n * Options controlling how a handle is tessellated.\n */\nexport interface MeshHandleOptions {\n  /** linear deflection (mm), default 0.1 — matches the built-in ops (src/brep/brep-ops.ts:27). */\n  linearDeflection?: number\n  /** angular segment count, default 32 — angularDeflection = 2π / segments. */\n  segments?: number\n}\n\n/**\n * OCC 句柄身份契约判别（单一真源）。\n *\n * occt-wasm 的 `handle()` 工厂（occtWasm helpers.ts:25）构造的句柄对象\n * 统一携带 `__occtWasm: true`。本叶子是 faijs 侧唯一允许的判据：\n * define-op 的 `wrapBrepOne` 用它区分\"几何句柄\"与\"纯数据记录\"，本文件\n * `fromHandle`/`meshHandle` 入口用它做形态断言。禁止在其他文件硬编码\n * `'__occtWasm' in v` 字符串直查——句柄/数据判定的任何新消费点都必须引用本叶子。\n * @param v - 待判别的值。\n * @returns `true` 当且仅当 `v` 是携带 `__occtWasm: true` 标记的句柄对象。\n */\nexport function isOcctHandle(v: unknown): boolean {\n  return typeof v === 'object' && v !== null && (v as { __occtWasm?: unknown }).__occtWasm === true\n}\n\n/** 合法句柄输入：branded numeric id（occt-wasm 的 `ShapeHandle` 运行时形态）或\n *  `__occtWasm` 标记对象（`handle()` 工厂产物）。 */\nfunction isHandleLike(v: unknown): boolean {\n  return typeof v === 'number' || isOcctHandle(v)\n}\n\n/**\n * 入口形态断言：拒绝把纯数据记录当句柄三角化。\n * 纯数据记录（无 `__occtWasm` 标记的 plain object，如 sheetmetal part 数据）\n * 必须在 SDK 边界被显式拒绝（E_BAD_HANDLE），而不是在 kernel 深处以\n * `OcctError: meshShape: Invalid shape ID 0` 崩溃——define-op 的 wrapBrepOne\n * 已在第一道透传过滤，本断言是第二道防线（防未来未带标记的新句柄形态漏网）。\n */\nfunction requireHandle(handle: unknown, caller: string): void {\n  if (!isHandleLike(handle)) {\n    throw new Error(\n      `[faijs/bridge] ${caller}: E_BAD_HANDLE: expected an OCCT handle (numeric id or ` +\n        `__occtWasm-tagged object); got ${handle === null ? 'null' : typeof handle}. ` +\n        `Plain data records must not be tessellated as handles.`,\n    )\n  }\n}\n\n/**\n * Tessellate an OCCT handle into a Shape (without registering a BREP slot).\n * @param handle - the OCCT solid handle to tessellate (numeric id or `__occtWasm`-tagged object).\n * @param opts - optional tessellation options.\n * @returns the tessellated Shape.\n */\nexport function meshHandle(handle: unknown, opts?: MeshHandleOptions): Shape {\n  requireHandle(handle, 'meshHandle')\n  const kernel = getKernel() as MeshableKernel\n  const mesh = kernel.meshShape(handle, {\n    linearDeflection: opts?.linearDeflection ?? 0.1,\n    angularDeflection: (2 * Math.PI) / Math.max(3, opts?.segments ?? 32),\n  })\n  return {\n    positions: new Float32Array(mesh.positions as ArrayLike<number>),\n    indices: new Uint32Array(mesh.indices as ArrayLike<number>),\n  }\n}\n\n/**\n * Default path (recommended): tessellate + register the BREP slot in one step.\n * Equivalent to meshHandle(h) + fromBrep(sh, { solid: h }).\n * Library authors only fall back to the meshHandle + fromBrep combination when\n * they need custom tessellation precision.\n * @param handle - the OCCT solid handle to bridge (numeric id or `__occtWasm`-tagged object).\n * @param opts - optional tessellation options.\n * @returns the registered Shape, as returned by fromBrep.\n */\nexport function fromHandle(handle: unknown, opts?: MeshHandleOptions): ReturnType<typeof fromBrep> {\n  requireHandle(handle, 'fromHandle')\n  return fromBrep(meshHandle(handle, opts), { solid: handle })\n}\n"]}
+{"version":3,"file":"handle-bridge.js","sourceRoot":"","sources":["../../src/brep/handle-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAWnC;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAA;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAA;IAC5G,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAA;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAA;IACH,CAAC;IACD,OAAO,MAAuB,CAAA;AAChC,CAAC;AAYD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAK,CAA8B,CAAC,UAAU,KAAK,IAAI,CAAA;AACnG,CAAC;AAED;0CAC0C;AAC1C,SAAS,YAAY,CAAC,CAAU;IAC9B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,CAAA;AACjD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,MAAe,EAAE,MAAc;IACpD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,yDAAyD;YAC/E,kCAAkC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,MAAM,IAAI;YAC9E,wDAAwD,CAC3D,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAe,EAAE,IAAwB;IAClE,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACnC,MAAM,MAAM,GAAG,SAAS,EAAoB,CAAA;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE;QACpC,gBAAgB,EAAE,IAAI,EAAE,gBAAgB,IAAI,GAAG;QAC/C,iBAAiB,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;KACrE,CAAC,CAAA;IACF,OAAO;QACL,SAAS,EAAE,IAAI,YAAY,CAAC,IAAI,CAAC,SAA8B,CAAC;QAChE,OAAO,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,OAA4B,CAAC;KAC5D,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,MAAe,EAAE,IAAwB;IAClE,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACnC,OAAO,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;AAC9D,CAAC","sourcesContent":["/**\n * handle-bridge — OCCT 句柄 → faijs Shape 的 SDK 桥接（B1）\n *\n *\n * 第三方库要造 BREP 产物，需要\"OCCT handle → mesh\"。SDK 绝不能 import\n * heavy 几何库（会把它们拉进 SDK bundle，违反 `src/sdk.test.ts` 的零 heavy\n * 依赖守卫）。本文件在**新建的零依赖模块**中实现，直接调运行时注入的\n * `kernel.meshShape`。\n *\n * 依赖约束（硬性）：只允许 import `runtime-state`、`api/shape`、type-only\n * `mesh/types`——任何新增依赖必须保持 dist/sdk.js 零 heavy 依赖守卫通过。\n */\n\nimport type { Shape } from '../mesh/types'\nimport { getBackends } from '../runtime-state'\nimport { fromBrep } from '../shape'\nimport type { BrepEngineApi } from './engine/primitives'\n\n/** 结构化内核接口（不 import occt-wasm，只做结构匹配，避免 heavy 依赖） */\ninterface MeshableKernel {\n  meshShape(\n    handle: unknown,\n    opts: { linearDeflection: number; angularDeflection: number },\n  ): { positions: ArrayLike<number>; indices: ArrayLike<number> }\n}\n\n/**\n * Get the currently injected BREP kernel instance (untyped escape hatch).\n * @deprecated D12: this exit predates the engine-neutral L1 surface and its name\n * (\"OCCT kernel\") no longer matches what it returns — the current engine's raw\n * kernel, whatever engine that is. Prefer `getBrepApi()` (typed, engine-neutral,\n * same file) for neutral ops; platform-only code (L2 face) should use\n * `getOcctKernel()` (D3). Kept for compat-face bridging and existing tests.\n * @returns the current BREP engine's kernel instance.\n * @throws when the kernel is not ready (mesh mode or uninitialized) — never silently returns null.\n */\nexport function getKernel(): unknown {\n  const kernel = getBackends().kernel.brep\n  if (!kernel) {\n    throw new Error('[faijs/bridge] OCCT kernel not available: BREP operations require an initialized kernel')\n  }\n  return kernel\n}\n\n/**\n * Get the current BREP engine as the **L1 core surface** (`BrepEngineApi`).\n *\n * 2026-09-24 narrowing plan（D12）：中立 op 的取内核唯一出口——取代\n * `getBackends().kernel.brep as BrepEngineApi` 的逐点断言。本文件是 L1 契约\n * 的注册点（`registerBrepEngine` 注入的就是 `BrepEngineApi` 实例），此处断言\n * 诚实；平台面（L1 之外的 occt 独有能力）仍走 `getOcctKernel()`（D3）。\n *\n * @returns the current engine's L1 contract surface (`BrepEngineApi`) — typed, engine-neutral.\n * @throws when no BREP engine is registered (uninitialized) — never silently returns null.\n */\nexport function getBrepApi(): BrepEngineApi {\n  const kernel = getBackends().kernel.brep\n  if (!kernel) {\n    throw new Error(\n      '[faijs/bridge] BREP engine API not available: BREP operations require an initialized engine',\n    )\n  }\n  return kernel as BrepEngineApi\n}\n\n/**\n * Options controlling how a handle is tessellated.\n */\nexport interface MeshHandleOptions {\n  /** linear deflection (mm), default 0.1 — matches the built-in ops (src/brep/brep-ops.ts:27). */\n  linearDeflection?: number\n  /** angular segment count, default 32 — angularDeflection = 2π / segments. */\n  segments?: number\n}\n\n/**\n * OCC 句柄身份契约判别（单一真源）。\n *\n * occt-wasm 的 `handle()` 工厂（occtWasm helpers.ts:25）构造的句柄对象\n * 统一携带 `__occtWasm: true`。本叶子是 faijs 侧唯一允许的判据：\n * define-op 的 `wrapBrepOne` 用它区分\"几何句柄\"与\"纯数据记录\"，本文件\n * `fromHandle`/`meshHandle` 入口用它做形态断言。禁止在其他文件硬编码\n * `'__occtWasm' in v` 字符串直查——句柄/数据判定的任何新消费点都必须引用本叶子。\n * @param v - 待判别的值。\n * @returns `true` 当且仅当 `v` 是携带 `__occtWasm: true` 标记的句柄对象。\n */\nexport function isOcctHandle(v: unknown): boolean {\n  return typeof v === 'object' && v !== null && (v as { __occtWasm?: unknown }).__occtWasm === true\n}\n\n/** 合法句柄输入：branded numeric id（occt-wasm 的 `ShapeHandle` 运行时形态）或\n *  `__occtWasm` 标记对象（`handle()` 工厂产物）。 */\nfunction isHandleLike(v: unknown): boolean {\n  return typeof v === 'number' || isOcctHandle(v)\n}\n\n/**\n * 入口形态断言：拒绝把纯数据记录当句柄三角化。\n * 纯数据记录（无 `__occtWasm` 标记的 plain object，如 sheetmetal part 数据）\n * 必须在 SDK 边界被显式拒绝（E_BAD_HANDLE），而不是在 kernel 深处以\n * `OcctError: meshShape: Invalid shape ID 0` 崩溃——define-op 的 wrapBrepOne\n * 已在第一道透传过滤，本断言是第二道防线（防未来未带标记的新句柄形态漏网）。\n */\nfunction requireHandle(handle: unknown, caller: string): void {\n  if (!isHandleLike(handle)) {\n    throw new Error(\n      `[faijs/bridge] ${caller}: E_BAD_HANDLE: expected an OCCT handle (numeric id or ` +\n        `__occtWasm-tagged object); got ${handle === null ? 'null' : typeof handle}. ` +\n        `Plain data records must not be tessellated as handles.`,\n    )\n  }\n}\n\n/**\n * Tessellate an OCCT handle into a Shape (without registering a BREP slot).\n * @param handle - the OCCT solid handle to tessellate (numeric id or `__occtWasm`-tagged object).\n * @param opts - optional tessellation options.\n * @returns the tessellated Shape.\n */\nexport function meshHandle(handle: unknown, opts?: MeshHandleOptions): Shape {\n  requireHandle(handle, 'meshHandle')\n  const kernel = getKernel() as MeshableKernel\n  const mesh = kernel.meshShape(handle, {\n    linearDeflection: opts?.linearDeflection ?? 0.1,\n    angularDeflection: (2 * Math.PI) / Math.max(3, opts?.segments ?? 32),\n  })\n  return {\n    positions: new Float32Array(mesh.positions as ArrayLike<number>),\n    indices: new Uint32Array(mesh.indices as ArrayLike<number>),\n  }\n}\n\n/**\n * Default path (recommended): tessellate + register the BREP slot in one step.\n * Equivalent to meshHandle(h) + fromBrep(sh, { solid: h }).\n * Library authors only fall back to the meshHandle + fromBrep combination when\n * they need custom tessellation precision.\n * @param handle - the OCCT solid handle to bridge (numeric id or `__occtWasm`-tagged object).\n * @param opts - optional tessellation options.\n * @returns the registered Shape, as returned by fromBrep.\n */\nexport function fromHandle(handle: unknown, opts?: MeshHandleOptions): ReturnType<typeof fromBrep> {\n  requireHandle(handle, 'fromHandle')\n  return fromBrep(meshHandle(handle, opts), { solid: handle })\n}\n"]}

package/dist/brep/svg/svg-to-solid.d.ts

@@ -25,7 +25,9 @@
 import type { BrepHandle } from '../engine/types.js';
 import type { BrepEngineApi } from '../engine/primitives.js';
 import { parseSvgNaturalSize } from '../../primitives/parse-svg-size.js';
+import { extractSvgPaths } from '../../primitives/svg/svg-path.js';
 export { parseSvgNaturalSize };
+export { extractSvgPaths };
 /** 3D 点（OCCT Vec3 格式） */
 interface Pt {
     x: number;
@@ -48,16 +50,6 @@ interface ClosedSubpath {
     /** 对应的 OCCT wire */
     wire: BrepHandle;
 }
-/**
- * 从 SVG 字符串中提取所有图形元素的 path `d` 属性。
- *
- * 支持：<path>, <rect>, <circle>, <ellipse>, <line>, <polyline>, <polygon>。
- * 使用正则提取，无 DOMParser 依赖（可在 Web Worker / Node 中运行）。
- *
- * @param svgString - the raw SVG markup to extract paths from.
- * @returns an array of path `d` strings.
- */
-export declare function extractSvgPaths(svgString: string): string[];
 /**
  * 解析 SVG path `d` 字符串，构建 OCCT wire 列表。
  *
@@ -76,13 +68,7 @@ interface ContourGroup {
     holes: BrepHandle[];
 }
 /**
- * 将闭合子路径分类为外轮廓 + 孔洞的分组。
- *
- * 算法：
- * 1. 按有符号面积绝对值降序排（大轮廓优先）
- * 2. 对每条子路径 A，找到直接包含它的最小外轮廓 B
- * 3. A 是 B 的孔洞
- * 4. 没有外轮廓的子路径是独立外轮廓
+ * 将闭合子路径分类为外轮廓 + 孔洞的分组（复用共享 classifyNested，支持多层嵌套岛）。
  *
  * @param subpaths - the closed subpaths to classify.
  * @returns the contour groups of outer wires and their hole wires.

package/dist/brep/svg/svg-to-solid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"svg-to-solid.d.ts","sourceRoot":"","sources":["../../../src/brep/svg/svg-to-solid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AAErE,OAAO,EAAE,mBAAmB,EAAE,CAAA;AAI9B,yBAAyB;AACzB,UAAU,EAAE;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE;AAQhD,sBAAsB;AACtB,UAAU,aAAa;IACrB,sBAAsB;IACtB,MAAM,EAAE,EAAE,EAAE,CAAA;IACZ,UAAU;IACV,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAChE,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,oBAAoB;IACpB,IAAI,EAAE,UAAU,CAAA;CACjB;AAID;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAyB3D;AA6PD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,aAAa,EAAE,CA+TjB;AA6DD,UAAU,YAAY;IACpB,eAAe;IACf,KAAK,EAAE,UAAU,CAAA;IACjB,iBAAiB;IACjB,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,YAAY,EAAE,CA6DvE;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,GACA,UAAU,CAqGZ"}
+{"version":3,"file":"svg-to-solid.d.ts","sourceRoot":"","sources":["../../../src/brep/svg/svg-to-solid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,EACL,eAAe,EAMhB,MAAM,+BAA+B,CAAA;AAGtC,OAAO,EAAE,mBAAmB,EAAE,CAAA;AAG9B,OAAO,EAAE,eAAe,EAAE,CAAA;AAI1B,yBAAyB;AACzB,UAAU,EAAE;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE;AAEhD,sBAAsB;AACtB,UAAU,aAAa;IACrB,sBAAsB;IACtB,MAAM,EAAE,EAAE,EAAE,CAAA;IACZ,UAAU;IACV,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAChE,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,oBAAoB;IACpB,IAAI,EAAE,UAAU,CAAA;CACjB;AAwFD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,aAAa,EAAE,CA+TjB;AAOD,UAAU,YAAY;IACpB,eAAe;IACf,KAAK,EAAE,UAAU,CAAA;IACjB,iBAAiB;IACjB,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,YAAY,EAAE,CAMvE;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,GACA,UAAU,CAqGZ"}

package/dist/brep/svg/svg-to-solid.js

@@ -24,180 +24,16 @@
  */
 import { getSolidBoundingBox } from '../brep-utils.js';
 import { parseSvgNaturalSize } from '../../primitives/parse-svg-size.js';
+import { extractSvgPaths, tokenizeSvgPath, extractGroupTransform, classifyNested, computeBBox, computeSignedArea, } from '../../primitives/svg/svg-path.js';
 export { parseSvgNaturalSize };
-// ─── SVG 元素提取（将 <rect>/<circle>/… 转为 <path d>） ───
-/**
- * 从 SVG 字符串中提取所有图形元素的 path `d` 属性。
- *
- * 支持：<path>, <rect>, <circle>, <ellipse>, <line>, <polyline>, <polygon>。
- * 使用正则提取，无 DOMParser 依赖（可在 Web Worker / Node 中运行）。
- *
- * @param svgString - the raw SVG markup to extract paths from.
- * @returns an array of path `d` strings.
- */
-export function extractSvgPaths(svgString) {
-    const paths = [];
-    // <path d="...">
-    extractPathDAttributes(svgString, paths);
-    // <rect>
-    extractRectPaths(svgString, paths);
-    // <circle>
-    extractCirclePaths(svgString, paths);
-    // <ellipse>
-    extractEllipsePaths(svgString, paths);
-    // <line>
-    extractLinePaths(svgString, paths);
-    // <polyline>
-    extractPolylinePaths(svgString, paths, false);
-    // <polygon>
-    extractPolylinePaths(svgString, paths, true);
-    return paths;
-}
-function extractPathDAttributes(svg, out) {
-    const re = /<path\b[^>]*\bd\s*=\s*(?:"([^"]*)"|'([^']*)')[^>]*>/gi;
-    let m;
-    while ((m = re.exec(svg)) !== null) {
-        const d = m[1] ?? m[2];
-        if (d)
-            out.push(d);
-    }
-}
-function extractRectPaths(svg, out) {
-    const re = /<rect\b([^>]*)\/?>/gi;
-    let m;
-    while ((m = re.exec(svg)) !== null) {
-        const attrs = parseAttrs(m[1] ?? '');
-        const x = parseFloat(attrs.x ?? '0');
-        const y = parseFloat(attrs.y ?? '0');
-        const w = parseFloat(attrs.width ?? '0');
-        const h = parseFloat(attrs.height ?? '0');
-        const rx = parseFloat(attrs.rx ?? '0');
-        const ry = parseFloat(attrs.ry ?? '0');
-        if (w <= 0 || h <= 0)
-            continue;
-        // 如果 rect 有 transform 属性，将变换应用到四个角点后输出为 path d
-        const rectTransform = attrs.transform ? parseSvgTransform(attrs.transform) : undefined;
-        if (rectTransform) {
-            const corners = [
-                [x, y], [x + w, y], [x + w, y + h], [x, y + h],
-            ];
-            const tc = corners.map(([cx, cy]) => [
-                rectTransform[0] * cx + rectTransform[2] * cy + rectTransform[4],
-                rectTransform[1] * cx + rectTransform[3] * cy + rectTransform[5],
-            ]);
-            let d = `M ${tc[0][0]},${tc[0][1]}`;
-            for (let i = 1; i < tc.length; i++)
-                d += ` L ${tc[i][0]},${tc[i][1]}`;
-            out.push(d + ' Z');
-        }
-        else if (rx > 0 || ry > 0) {
-            const r = Math.min(rx || ry, w / 2, h / 2);
-            out.push(rectToPathRounded(x, y, w, h, r));
-        }
-        else {
-            out.push(`M ${x},${y} h ${w} v ${h} h ${-w} Z`);
-        }
-    }
-}
-function rectToPathRounded(x, y, w, h, r) {
-    return [
-        `M ${x + r},${y}`,
-        `h ${w - 2 * r}`,
-        `A ${r},${r} 0 0 1 ${x + w},${y + r}`,
-        `v ${h - 2 * r}`,
-        `A ${r},${r} 0 0 1 ${x + w - r},${y + h}`,
-        `h ${-(w - 2 * r)}`,
-        `A ${r},${r} 0 0 1 ${x},${y + h - r}`,
-        `v ${-(h - 2 * r)}`,
-        `A ${r},${r} 0 0 1 ${x + r},${y}`,
-        'Z',
-    ].join(' ');
-}
-function extractCirclePaths(svg, out) {
-    const re = /<circle\b([^>]*)\/?>/gi;
-    let m;
-    while ((m = re.exec(svg)) !== null) {
-        const attrs = parseAttrs(m[1] ?? '');
-        const cx = parseFloat(attrs.cx ?? '0');
-        const cy = parseFloat(attrs.cy ?? '0');
-        const r = parseFloat(attrs.r ?? '0');
-        if (r <= 0)
-            continue;
-        // 两个半圆弧组成完整圆
-        out.push(`M ${cx - r},${cy} A ${r},${r} 0 1 0 ${cx + r},${cy} A ${r},${r} 0 1 0 ${cx - r},${cy} Z`);
-    }
-}
-function extractEllipsePaths(svg, out) {
-    const re = /<ellipse\b([^>]*)\/?>/gi;
-    let m;
-    while ((m = re.exec(svg)) !== null) {
-        const attrs = parseAttrs(m[1] ?? '');
-        const cx = parseFloat(attrs.cx ?? '0');
-        const cy = parseFloat(attrs.cy ?? '0');
-        const rx = parseFloat(attrs.rx ?? '0');
-        const ry = parseFloat(attrs.ry ?? '0');
-        if (rx <= 0 || ry <= 0)
-            continue;
-        out.push(`M ${cx - rx},${cy} A ${rx},${ry} 0 1 0 ${cx + rx},${cy} A ${rx},${ry} 0 1 0 ${cx - rx},${cy} Z`);
-    }
-}
-function extractLinePaths(svg, out) {
-    const re = /<line\b([^>]*)\/?>/gi;
-    let m;
-    while ((m = re.exec(svg)) !== null) {
-        const attrs = parseAttrs(m[1] ?? '');
-        const x1 = parseFloat(attrs.x1 ?? '0');
-        const y1 = parseFloat(attrs.y1 ?? '0');
-        const x2 = parseFloat(attrs.x2 ?? '0');
-        const y2 = parseFloat(attrs.y2 ?? '0');
-        out.push(`M ${x1},${y1} L ${x2},${y2}`);
-    }
-}
-function extractPolylinePaths(svg, out, closed) {
-    const tag = closed ? 'polygon' : 'polyline';
-    const re = new RegExp(`<${tag}\\b([^>]*)\\/??>`, 'gi');
-    let m;
-    while ((m = re.exec(svg)) !== null) {
-        const attrs = parseAttrs(m[1] ?? '');
-        const pointsStr = attrs.points ?? '';
-        const nums = pointsStr.split(/[\s,]+/).filter(s => s.length > 0).map(Number);
-        if (nums.length < 4)
-            continue;
-        let d = `M ${nums[0]},${nums[1]}`;
-        for (let i = 2; i + 1 < nums.length; i += 2) {
-            d += ` L ${nums[i]},${nums[i + 1]}`;
-        }
-        if (closed)
-            d += ' Z';
-        out.push(d);
-    }
-}
-function parseAttrs(attrStr) {
-    const attrs = {};
-    const re = /(\w[\w-]*)\s*=\s*(?:"([^"]*)"|'([^']*)')/g;
-    let m;
-    while ((m = re.exec(attrStr)) !== null) {
-        attrs[m[1].toLowerCase()] = m[2] ?? m[3] ?? '';
-    }
-    return attrs;
-}
-/** 解析 SVG transform 字符串（仅支持 matrix 形式） */
-function parseSvgTransform(transformStr) {
-    const m = transformStr.match(/matrix\s*\(\s*([-\d.eE+]+)\s*,\s*([-\d.eE+]+)\s*,\s*([-\d.eE+]+)\s*,\s*([-\d.eE+]+)\s*,\s*([-\d.eE+]+)\s*,\s*([-\d.eE+]+)\s*\)/);
-    if (m) {
-        return [parseFloat(m[1]), parseFloat(m[2]), parseFloat(m[3]), parseFloat(m[4]), parseFloat(m[5]), parseFloat(m[6])];
-    }
-    return undefined;
-}
-/** 从 SVG 字符串中提取 <g transform="matrix(...)"> 的变换矩阵 */
-function extractGroupTransform(svgString) {
-    const m = svgString.match(/<g\b[^>]*\btransform\s*=\s*(?:"([^"]*)"|'([^']*)')[^>]*>/i);
-    if (m) {
-        return parseSvgTransform(m[1] ?? m[2] ?? '');
-    }
-    return undefined;
-}
-/** 将 SVG 2D 变换转为 OCCT 3x4 row-major 仿射矩阵（考虑 Y 翻转） */
+// 兼容导出：语法层共享实现（extractSvgPaths 等的历史入口仍在 brep 面可用）
+export { extractSvgPaths };
+// ─── SVG 元素提取 / transform / tokenizer ───
+// 与 mesh 链共享同一实现（primitives/svg/svg-path.ts）：
+// extractSvgPaths / parseSvgTransform / extractGroupTransform / tokenizeSvgPath。
+// brep 链保留精确几何语义（Bezier→OCCT 曲线、Arc→三点圆弧），
+// 语法层（元素提取、矩阵解析、tokenizer）不重复实现。
+// ─── SVG transform 处理（OCCT 矩阵适配，brep 链特有） ───
 function svgTransformToOcctMatrix(gt) {
     // SVG: x' = a*x + c*y + e, y' = b*x + d*y + f
     // OCCT 点的 Y 已翻转 (y_occt = -y_svg)，所以：
@@ -220,25 +56,6 @@ function applySvgTransformToOcctPoint(p, gt) {
     return { x: tx, y: -ty, z: 0 };
 }
 // ─── SVG path tokenizer ───
-function tokenizeSVGPath(d) {
-    const tokens = [];
-    const re = /([MmLlHhVvCcSsQqTtAaZz])([^MmLlHhVvCcSsQqTtAaZz]*)/g;
-    let match;
-    while ((match = re.exec(d)) !== null) {
-        const command = match[1] ?? '';
-        const argStr = (match[2] ?? '').trim();
-        const args = [];
-        if (argStr) {
-            const numRe = /[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?/g;
-            let numMatch;
-            while ((numMatch = numRe.exec(argStr)) !== null) {
-                args.push(parseFloat(numMatch[0]));
-            }
-        }
-        tokens.push({ command, args });
-    }
-    return tokens;
-}
 // ─── SVG path → OCCT edges ───
 /** Y 轴翻转：SVG Y-down → OCCT Y-up */
 function flipY(x, y) {
@@ -285,7 +102,7 @@ function arcMidPoint(fromX, fromY, toX, toY, rx, ry, largeArc, sweepFlag) {
  * @returns 闭合子路径列表（含 wire + 几何信息）
  */
 export function parseSVGPathToWires(kernel, pathD) {
-    const tokens = tokenizeSVGPath(pathD);
+    const tokens = tokenizeSvgPath(pathD);
     const subpaths = [];
     const cursor = {
         cx: 0, cy: 0, sx: 0, sy: 0,
@@ -598,136 +415,18 @@ export function parseSVGPathToWires(kernel, pathD) {
     }
     return subpaths;
 }
-// ─── 几何工具 ───
-function computeBBox(points) {
-    let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
-    for (const p of points) {
-        if (p.x < minX)
-            minX = p.x;
-        if (p.y < minY)
-            minY = p.y;
-        if (p.x > maxX)
-            maxX = p.x;
-        if (p.y > maxY)
-            maxY = p.y;
-    }
-    return { minX, minY, maxX, maxY };
-}
-/** Shoelace 公式计算有符号面积（正=CCW，负=CW） */
-function computeSignedArea(points) {
-    let area = 0;
-    const n = points.length;
-    if (n < 3)
-        return 0;
-    for (let i = 0; i < n; i++) {
-        const j = (i + 1) % n;
-        area += points[i].x * points[j].y;
-        area -= points[j].x * points[i].y;
-    }
-    return area / 2;
-}
-/** 点在多边形内（ray casting） */
-function pointInPolygon(pt, polygon) {
-    const n = polygon.length;
-    if (n < 3)
-        return false;
-    let inside = false;
-    for (let i = 0, j = n - 1; i < n; j = i++) {
-        const xi = polygon[i].x, yi = polygon[i].y;
-        const xj = polygon[j].x, yj = polygon[j].y;
-        const intersect = ((yi > pt.y) !== (yj > pt.y)) &&
-            (pt.x < (xj - xi) * (pt.y - yi) / (yj - yi + 1e-12) + xi);
-        if (intersect)
-            inside = !inside;
-    }
-    return inside;
-}
-/** 计算多边形质心 */
-function polygonCentroid(points) {
-    let cx = 0, cy = 0;
-    for (const p of points) {
-        cx += p.x;
-        cy += p.y;
-    }
-    return { x: cx / points.length, y: cy / points.length, z: 0 };
-}
-function bboxContains(outer, inner) {
-    return inner.minX >= outer.minX && inner.maxX <= outer.maxX &&
-        inner.minY >= outer.minY && inner.maxY <= outer.maxY;
-}
 /**
- * 将闭合子路径分类为外轮廓 + 孔洞的分组。
- *
- * 算法：
- * 1. 按有符号面积绝对值降序排（大轮廓优先）
- * 2. 对每条子路径 A，找到直接包含它的最小外轮廓 B
- * 3. A 是 B 的孔洞
- * 4. 没有外轮廓的子路径是独立外轮廓
+ * 将闭合子路径分类为外轮廓 + 孔洞的分组（复用共享 classifyNested，支持多层嵌套岛）。
  *
  * @param subpaths - the closed subpaths to classify.
  * @returns the contour groups of outer wires and their hole wires.
  */
 export function classifyHoles(subpaths) {
-    // 按面积绝对值降序排
-    const sorted = [...subpaths].sort((a, b) => Math.abs(b.signedArea) - Math.abs(a.signedArea));
-    // 为每条子路径找直接外轮廓
-    const parentOf = new Array(sorted.length).fill(-1);
-    for (let i = 0; i < sorted.length; i++) {
-        let bestParent = -1;
-        let bestParentArea = Infinity;
-        const centroid = polygonCentroid(sorted[i].points);
-        for (let j = 0; j < sorted.length; j++) {
-            if (i === j)
-                continue;
-            // j 的面积必须大于 i
-            if (Math.abs(sorted[j].signedArea) <= Math.abs(sorted[i].signedArea))
-                continue;
-            // j 的 bbox 必须包含 i 的 bbox
-            if (!bboxContains(sorted[j].bbox, sorted[i].bbox))
-                continue;
-            // i 的质心必须在 j 的多边形内
-            if (!pointInPolygon(centroid, sorted[j].points))
-                continue;
-            // 选面积最小的外轮廓（直接包含者）
-            if (Math.abs(sorted[j].signedArea) < bestParentArea) {
-                bestParentArea = Math.abs(sorted[j].signedArea);
-                bestParent = j;
-            }
-        }
-        parentOf[i] = bestParent;
-    }
-    // 构建分组
-    const groups = [];
-    for (let i = 0; i < sorted.length; i++) {
-        if (parentOf[i] === -1) {
-            // 外轮廓
-            groups.push({ outer: sorted[i].wire, holes: [] });
-        }
-    }
-    // 为每个孔洞找到对应的外轮廓
-    for (let i = 0; i < sorted.length; i++) {
-        if (parentOf[i] !== -1) {
-            // 找到 groups 中对应的外轮廓
-            const parentIdx = parentOf[i];
-            // parentIdx 是 sorted 中的索引，需要找到对应的 group
-            // 外轮廓在 sorted 中的索引 → groups 中的索引
-            let groupIdx = -1;
-            let outerCount = 0;
-            for (let k = 0; k < sorted.length; k++) {
-                if (parentOf[k] === -1) {
-                    if (k === parentIdx) {
-                        groupIdx = outerCount;
-                        break;
-                    }
-                    outerCount++;
-                }
-            }
-            if (groupIdx >= 0 && groupIdx < groups.length) {
-                groups[groupIdx].holes.push(sorted[i].wire);
-            }
-        }
-    }
-    return groups;
+    const groups = classifyNested(subpaths);
+    return groups.map((g) => ({
+        outer: subpaths[g.outerIdx].wire,
+        holes: g.holes.map((h) => subpaths[h].wire),
+    }));
 }
 // ─── SVG → Solid ───
 /**