@faicad/faijs 0.16.0 → 0.17.0

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

@@ -12,6 +12,8 @@ export default {
     "wedge": {},
     "screw": {},
     "sketch": {},
+    "wire": {},
+    "helix": {},
     "sdf": {},
     "translate": {},
     "rotate_euler": {},
@@ -21,11 +23,25 @@ export default {
     "chamfer": {},
     "fillet": {},
     "knurl": {},
+    "shell": {},
+    "draft": {},
+    "thicken": {},
+    "filletVariable": {},
+    "splitByPlane": {},
+    "sectionByPlane": {},
+    "defeature": {},
+    "reverseShape": {},
+    "unifySameDomain": {},
+    "sew": {},
+    "sewAndSolidify": {},
+    "removeHolesFromFace": {},
     "union": {},
     "subtract": {},
     "intersect": {},
     "extrude": {},
     "revolve": {},
+    "sweep": {},
+    "loft": {},
     "faceNormal": {},
     "bboxCenter": {},
     "bboxMin": {},
@@ -51,12 +67,21 @@ export default {
     "clone": {},
     "torus": {},
     "fuse": {},
+    "inspectMassProps": {},
+    "area": {},
+    "length": {},
+    "volume": {},
+    "centerOfMass": {},
     "viewCamera": {},
     "projectView": {},
     "projectSheet": {},
+    "complexExtrude": {},
+    "twistExtrude": {},
+    "roof": {},
     "drill": {},
     "pocket": {},
     "boss": {},
+    "thread": {},
     "convexHull": {},
     "makeBaseBox": {},
     "ellipsoid": {},
@@ -66,8 +91,11 @@ export default {
     "offset": {},
     "heal": {},
     "simplify": {},
+    "isValid": {},
+    "isSameShape": {},
     "autoHeal": {},
     "fixShape": {},
-    "healSolid": {}
+    "healSolid": {},
+    "fixSelfIntersection": {}
 };
 //# sourceMappingURL=symbol-table.generated.js.map

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,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"]}
+{"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,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,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,OAAO,EAAE,EAAE;IACX,SAAS,EAAE,EAAE;IACb,gBAAgB,EAAE,EAAE;IACpB,cAAc,EAAE,EAAE;IAClB,gBAAgB,EAAE,EAAE;IACpB,WAAW,EAAE,EAAE;IACf,cAAc,EAAE,EAAE;IAClB,iBAAiB,EAAE,EAAE;IACrB,KAAK,EAAE,EAAE;IACT,gBAAgB,EAAE,EAAE;IACpB,qBAAqB,EAAE,EAAE;IACzB,OAAO,EAAE,EAAE;IACX,UAAU,EAAE,EAAE;IACd,WAAW,EAAE,EAAE;IACf,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,OAAO,EAAE,EAAE;IACX,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,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,kBAAkB,EAAE,EAAE;IACtB,MAAM,EAAE,EAAE;IACV,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,cAAc,EAAE,EAAE;IAClB,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,EAAE;IACjB,cAAc,EAAE,EAAE;IAClB,gBAAgB,EAAE,EAAE;IACpB,cAAc,EAAE,EAAE;IAClB,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,EAAE;IACV,QAAQ,EAAE,EAAE;IACZ,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,SAAS,EAAE,EAAE;IACb,aAAa,EAAE,EAAE;IACjB,UAAU,EAAE,EAAE;IACd,UAAU,EAAE,EAAE;IACd,WAAW,EAAE,EAAE;IACf,qBAAqB,EAAE,EAAE;CAC1B,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  \"wire\": {},\n  \"helix\": {},\n  \"sdf\": {},\n  \"translate\": {},\n  \"rotate_euler\": {},\n  \"scale\": {},\n  \"scale3d\": {},\n  \"engrave\": {},\n  \"chamfer\": {},\n  \"fillet\": {},\n  \"knurl\": {},\n  \"shell\": {},\n  \"draft\": {},\n  \"thicken\": {},\n  \"filletVariable\": {},\n  \"splitByPlane\": {},\n  \"sectionByPlane\": {},\n  \"defeature\": {},\n  \"reverseShape\": {},\n  \"unifySameDomain\": {},\n  \"sew\": {},\n  \"sewAndSolidify\": {},\n  \"removeHolesFromFace\": {},\n  \"union\": {},\n  \"subtract\": {},\n  \"intersect\": {},\n  \"extrude\": {},\n  \"revolve\": {},\n  \"sweep\": {},\n  \"loft\": {},\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  \"inspectMassProps\": {},\n  \"area\": {},\n  \"length\": {},\n  \"volume\": {},\n  \"centerOfMass\": {},\n  \"viewCamera\": {},\n  \"projectView\": {},\n  \"projectSheet\": {},\n  \"complexExtrude\": {},\n  \"twistExtrude\": {},\n  \"roof\": {},\n  \"drill\": {},\n  \"pocket\": {},\n  \"boss\": {},\n  \"thread\": {},\n  \"convexHull\": {},\n  \"makeBaseBox\": {},\n  \"ellipsoid\": {},\n  \"rotate\": {},\n  \"applyMatrix\": {},\n  \"locate\": {},\n  \"offset\": {},\n  \"heal\": {},\n  \"simplify\": {},\n  \"isValid\": {},\n  \"isSameShape\": {},\n  \"autoHeal\": {},\n  \"fixShape\": {},\n  \"healSolid\": {},\n  \"fixSelfIntersection\": {}\n}\n"]}

package/dist/occt-kernel/highLevelApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"highLevelApi.d.ts","sourceRoot":"","sources":["../../src/occt-kernel/highLevelApi.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EAEV,mBAAmB,EACnB,IAAI,EACJ,qBAAqB,EACtB,MAAM,cAAc,CAAA;AAMrB,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,KAAK,EAAE,KAAK,CAAA;IACZ,mFAAmF;IACnF,KAAK,EAAE,WAAW,CAAA;IAClB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;CACvC;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,WAAW,GAAG,UAAU,GAC9B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAiCjC;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,KAAK,EAAE,KAAK,CAAA;IACZ,gDAAgD;IAChD,MAAM,EAAE,mBAAmB,EAAE,CAAA;IAC7B,oEAAoE;IACpE,KAAK,EAAE,WAAW,CAAA;IAClB,sDAAsD;IACtD,cAAc,EAAE,IAAI,CAAA;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,WAAW,GAAG,UAAU,GAAG,MAAM,EACxC,MAAM,GAAE,MAAM,GAAG,MAAe,EAChC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAmC3B;AAID,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAMR;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAErD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,eAAe,EAAE,GACzB,OAAO,CAAC,WAAW,CAAC,CAGtB;AAID;;;;;GAKG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,UAAU,CAAC,CAE5D;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAGD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAA"}
+{"version":3,"file":"highLevelApi.d.ts","sourceRoot":"","sources":["../../src/occt-kernel/highLevelApi.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EAEV,mBAAmB,EACnB,IAAI,EACJ,qBAAqB,EACtB,MAAM,cAAc,CAAA;AAMrB,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,KAAK,EAAE,KAAK,CAAA;IACZ,mFAAmF;IACnF,KAAK,EAAE,WAAW,CAAA;IAClB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;CACvC;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,WAAW,GAAG,UAAU,GAC9B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAiCjC;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,KAAK,EAAE,KAAK,CAAA;IACZ,gDAAgD;IAChD,MAAM,EAAE,mBAAmB,EAAE,CAAA;IAC7B,oEAAoE;IACpE,KAAK,EAAE,WAAW,CAAA;IAClB,sDAAsD;IACtD,cAAc,EAAE,IAAI,CAAA;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,WAAW,GAAG,UAAU,GAAG,MAAM,EACxC,MAAM,GAAE,MAAM,GAAG,MAAe,EAChC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAmC3B;AAID,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAMR;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAErD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,eAAe,EAAE,GACzB,OAAO,CAAC,WAAW,CAAC,CAKtB;AAID;;;;;GAKG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,UAAU,CAAC,CAE5D;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAGD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/occt-kernel/highLevelApi.js

@@ -9,6 +9,7 @@
  */
 import { initOcctWasm, disposeOcctWasm, importStepToMesh, importBrepToMesh, meshesToStep, releaseShape, importAssemblyFromStep, collectLeafParts, releaseAssemblyTree, computeEffectiveDeflection, } from './occtKernel.js';
 import { exportStepFromSolids } from '../brep/export/step.js';
+import { createOcctPrimitives } from './occt-primitives.js';
 /**
  * High-level: import multi-part mesh + solid from a STEP file byte stream.
  *
@@ -19,7 +20,7 @@ import { exportStepFromSolids } from '../brep/export/step.js';
  * @returns an array of per-part import results
  */
 export async function importStepMultiPart(bytes) {
-    const kernel = (await initOcctWasm());
+    const kernel = await initOcctWasm();
     // XCAF 解析 → 装配树
     const nodes = await importAssemblyFromStep(bytes);
     const leaves = collectLeafParts(nodes);
@@ -126,8 +127,10 @@ export function releaseSolid(solid) {
  * @returns STEP file content as ArrayBuffer
  */
 export async function exportStepFromSolidsHighLevel(entries) {
-    const kernel = await ensureOcctKernel();
-    return exportStepFromSolids(kernel, entries);
+    // step.ts consumes the L1 contract — pass the adapter, not the raw kernel
+    // (no cross-layer assertion; narrowing plan §Phase 3).
+    const primitives = await createOcctPrimitives();
+    return exportStepFromSolids(primitives, entries);
 }
 // ── 管理函数 ──
 /**

package/dist/occt-kernel/highLevelApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"highLevelApi.js","sourceRoot":"","sources":["../../src/occt-kernel/highLevelApi.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * OCCT 高层 API — E12.2\n *\n * 宿主不应再直接 import 底层 OCCT kernel 函数（initOcctWasm/importStepToMesh/meshesToStep 等），\n * 而是使用这些高层 API。\n *\n * 高层 API 封装了初始化、导入、导出的完整流程，\n * 返回标准化的 Shape / 拓扑数据 / STEP 字节流。\n */\n\nimport {\n  initOcctWasm,\n  disposeOcctWasm,\n  importStepToMesh,\n  importBrepToMesh,\n  meshesToStep,\n  releaseShape,\n  importAssemblyFromStep,\n  collectLeafParts,\n  releaseAssemblyTree,\n  computeEffectiveDeflection,\n} from './occtKernel'\nimport type { Shape } from '../mesh/types'\nimport { exportStepFromSolids } from '../brep/export/step'\nimport type { StepExportEntry } from '../brep/export/step'\nimport type {\n  ShapeHandle,\n  OcctKernel,\n  WasmImportResult,\n  WasmTessellatedMesh,\n  Mesh,\n  MeshDeflectionOptions,\n} from './occtKernel'\nimport type { BrepHandle } from '../brep/engine/types'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\n\n// ── 导入 API ──\n\n/** Result of importing a single part from a multi-part STEP file. */\nexport interface ImportStepPartResult {\n  /** The part's mesh (positions + indices). */\n  shape: Shape\n  /** OCCT solid handle (with location, for later BREP operations or STEP export). */\n  solid: ShapeHandle\n  /** Part name (from the XCAF label). */\n  name: string\n  /** Part color [r,g,b] in 0..1, or null when there is no color. */\n  color: [number, number, number] | null\n}\n\n/**\n * High-level: import multi-part mesh + solid from a STEP file byte stream.\n *\n * Uses XCAF assembly-tree parsing, keeping each part's mesh and solid independent.\n * Unlike importStep, this does not merge meshes — each part returns its own shape.\n *\n * @param bytes - STEP file byte stream\n * @returns an array of per-part import results\n */\nexport async function importStepMultiPart(\n  bytes: ArrayBuffer | Uint8Array,\n): Promise<ImportStepPartResult[]> {\n  const kernel = (await initOcctWasm()) as unknown as OcctKernel\n\n  // XCAF 解析 → 装配树\n  const nodes = await importAssemblyFromStep(bytes)\n  const leaves = collectLeafParts(nodes)\n\n  const results: ImportStepPartResult[] = []\n  for (const leaf of leaves) {\n    if (!leaf.shapeHandle) continue\n\n    const eff = computeEffectiveDeflection(kernel as unknown as BrepEngineApi, leaf.shapeHandle as unknown as BrepHandle)\n    const mesh = kernel.meshShape(leaf.shapeHandle, {\n      linearDeflection: eff.linearDeflection,\n      angularDeflection: eff.angularDeflection,\n    })\n\n    results.push({\n      shape: {\n        positions: mesh.positions,\n        indices: mesh.indices,\n      },\n      solid: leaf.shapeHandle,\n      name: leaf.name,\n      color: leaf.color,\n    })\n  }\n\n  // 释放装配树中非 leaf 的 shapeHandle（assembly 节点的已由 walkLabel 释放）\n  // leaf 的 shapeHandle 由返回结果持有，调用方负责释放\n  releaseAssemblyTree(kernel as unknown as BrepEngineApi, nodes.filter(n => n.isAssembly))\n\n  return results\n}\n\n/** Result of importing a STEP/BREP file. */\nexport interface ImportStepResult {\n  /** The merged mesh (all parts' positions/indices combined). */\n  shape: Shape\n  /** Each part's mesh (for topology building). */\n  meshes: WasmTessellatedMesh[]\n  /** OCCT solid handle (for later BREP operations or STEP export). */\n  solid: ShapeHandle\n  /** Face-group information (for topology building). */\n  meshWithGroups: Mesh\n}\n\n/**\n * High-level: import mesh + solid from a STEP/BREP file byte stream.\n *\n * Wraps the full importStepToMesh/importBrepToMesh + mesh merge flow.\n * Hosts no longer need to operate the OCCT kernel directly.\n *\n * @param bytes - STEP/BREP file byte stream\n * @param format - the file format: 'step' | 'brep'\n * @param options - optional mesh deflection options\n * @returns the import result\n */\nexport async function importStep(\n  bytes: ArrayBuffer | Uint8Array | string,\n  format: 'step' | 'brep' = 'step',\n  options?: MeshDeflectionOptions,\n): Promise<ImportStepResult> {\n  const result: WasmImportResult = format === 'brep'\n    ? await importBrepToMesh(bytes as string, options)\n    : await importStepToMesh(bytes as ArrayBuffer | Uint8Array, options)\n\n  // 合并所有 mesh 的 positions/indices\n  let totalPositions = 0\n  let totalIndices = 0\n  for (const mesh of result.meshes) {\n    totalPositions += mesh.positions.length\n    totalIndices += mesh.indices.length\n  }\n\n  const positions = new Float32Array(totalPositions)\n  const indices = new Uint32Array(totalIndices)\n  let posOffset = 0\n  let idxOffset = 0\n  let idxBase = 0\n  for (const mesh of result.meshes) {\n    positions.set(mesh.positions, posOffset)\n    posOffset += mesh.positions.length\n    // 需要偏移索引\n    for (let i = 0; i < mesh.indices.length; i++) {\n      indices[idxOffset + i] = mesh.indices[i] + idxBase\n    }\n    idxOffset += mesh.indices.length\n    idxBase += mesh.positions.length / 3\n  }\n\n  return {\n    shape: { positions, indices },\n    meshes: result.meshes,\n    solid: result.shapeHandle,\n    meshWithGroups: result.meshWithGroups,\n  }\n}\n\n// ── 导出 API ──\n\n/** Options for exporting mesh data to a STEP string. */\nexport interface ExportStepOptions {\n  /** Sewing tolerance. */\n  tolerance?: number\n}\n\n/**\n * High-level: export mesh data as a STEP string.\n *\n * Wraps the full meshesToStep flow. Hosts no longer need to operate the OCCT kernel directly.\n *\n * @param shape - mesh data (positions + indices)\n * @param options - optional export options (sewing tolerance)\n * @returns the STEP file text content\n */\nexport function exportStep(\n  shape: Shape,\n  options?: ExportStepOptions,\n): string {\n  return meshesToStep(\n    shape.positions,\n    shape.indices,\n    options?.tolerance ?? 0.01,\n  )\n}\n\n/**\n * High-level: release an OCCT solid handle.\n *\n * Wraps the full releaseShape flow.\n *\n * @param solid - the solid handle to release\n */\nexport function releaseSolid(solid: ShapeHandle): void {\n  releaseShape(solid)\n}\n\n/**\n * High-level: multi-solid STEP export (zero fuse).\n *\n * Each entry is exported as an independent entity in the STEP (independent XCAF\n * label / PRODUCT), preserving name and color. Multiple solids are never fused.\n *\n * Wraps the full ensureOcctKernel + exportStepFromSolids flow.\n * Hosts no longer need to operate the OCCT kernel directly.\n *\n * @param entries - parts to export; each becomes its own independent entity\n * @returns STEP file content as ArrayBuffer\n */\nexport async function exportStepFromSolidsHighLevel(\n  entries: StepExportEntry[],\n): Promise<ArrayBuffer> {\n  const kernel = await ensureOcctKernel()\n  return exportStepFromSolids(kernel as unknown as BrepEngineApi, entries)\n}\n\n// ── 管理函数 ──\n\n/**\n * High-level: initialize the OCCT kernel.\n * Returns the cached instance if already initialized.\n *\n * @returns the initialized OCCT kernel\n */\nexport async function ensureOcctKernel(): Promise<OcctKernel> {\n  return initOcctWasm() as unknown as Promise<OcctKernel>\n}\n\n/**\n * High-level: dispose the OCCT kernel.\n * Call when unloading the page or releasing WASM memory.\n */\nexport function disposeOcct(): void {\n  disposeOcctWasm()\n}\n\n// Re-export 底层类型供高层 API 用户使用\nexport type { OcctKernel, ShapeHandle, WasmTessellatedMesh, Mesh, MeshDeflectionOptions }\n"]}
+{"version":3,"file":"highLevelApi.js","sourceRoot":"","sources":["../../src/occt-kernel/highLevelApi.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * OCCT 高层 API — E12.2\n *\n * 宿主不应再直接 import 底层 OCCT kernel 函数（initOcctWasm/importStepToMesh/meshesToStep 等），\n * 而是使用这些高层 API。\n *\n * 高层 API 封装了初始化、导入、导出的完整流程，\n * 返回标准化的 Shape / 拓扑数据 / STEP 字节流。\n */\n\nimport {\n  initOcctWasm,\n  disposeOcctWasm,\n  importStepToMesh,\n  importBrepToMesh,\n  meshesToStep,\n  releaseShape,\n  importAssemblyFromStep,\n  collectLeafParts,\n  releaseAssemblyTree,\n  computeEffectiveDeflection,\n} from './occtKernel'\nimport type { Shape } from '../mesh/types'\nimport { exportStepFromSolids } from '../brep/export/step'\nimport type { StepExportEntry } from '../brep/export/step'\nimport type {\n  ShapeHandle,\n  OcctKernel,\n  WasmImportResult,\n  WasmTessellatedMesh,\n  Mesh,\n  MeshDeflectionOptions,\n} from './occtKernel'\n\nimport { createOcctPrimitives } from './occt-primitives'\n\n// ── 导入 API ──\n\n/** Result of importing a single part from a multi-part STEP file. */\nexport interface ImportStepPartResult {\n  /** The part's mesh (positions + indices). */\n  shape: Shape\n  /** OCCT solid handle (with location, for later BREP operations or STEP export). */\n  solid: ShapeHandle\n  /** Part name (from the XCAF label). */\n  name: string\n  /** Part color [r,g,b] in 0..1, or null when there is no color. */\n  color: [number, number, number] | null\n}\n\n/**\n * High-level: import multi-part mesh + solid from a STEP file byte stream.\n *\n * Uses XCAF assembly-tree parsing, keeping each part's mesh and solid independent.\n * Unlike importStep, this does not merge meshes — each part returns its own shape.\n *\n * @param bytes - STEP file byte stream\n * @returns an array of per-part import results\n */\nexport async function importStepMultiPart(\n  bytes: ArrayBuffer | Uint8Array,\n): Promise<ImportStepPartResult[]> {\n  const kernel = await initOcctWasm()\n\n  // XCAF 解析 → 装配树\n  const nodes = await importAssemblyFromStep(bytes)\n  const leaves = collectLeafParts(nodes)\n\n  const results: ImportStepPartResult[] = []\n  for (const leaf of leaves) {\n    if (!leaf.shapeHandle) continue\n\n    const eff = computeEffectiveDeflection(kernel, leaf.shapeHandle)\n    const mesh = kernel.meshShape(leaf.shapeHandle, {\n      linearDeflection: eff.linearDeflection,\n      angularDeflection: eff.angularDeflection,\n    })\n\n    results.push({\n      shape: {\n        positions: mesh.positions,\n        indices: mesh.indices,\n      },\n      solid: leaf.shapeHandle,\n      name: leaf.name,\n      color: leaf.color,\n    })\n  }\n\n  // 释放装配树中非 leaf 的 shapeHandle（assembly 节点的已由 walkLabel 释放）\n  // leaf 的 shapeHandle 由返回结果持有，调用方负责释放\n  releaseAssemblyTree(kernel, nodes.filter(n => n.isAssembly))\n\n  return results\n}\n\n/** Result of importing a STEP/BREP file. */\nexport interface ImportStepResult {\n  /** The merged mesh (all parts' positions/indices combined). */\n  shape: Shape\n  /** Each part's mesh (for topology building). */\n  meshes: WasmTessellatedMesh[]\n  /** OCCT solid handle (for later BREP operations or STEP export). */\n  solid: ShapeHandle\n  /** Face-group information (for topology building). */\n  meshWithGroups: Mesh\n}\n\n/**\n * High-level: import mesh + solid from a STEP/BREP file byte stream.\n *\n * Wraps the full importStepToMesh/importBrepToMesh + mesh merge flow.\n * Hosts no longer need to operate the OCCT kernel directly.\n *\n * @param bytes - STEP/BREP file byte stream\n * @param format - the file format: 'step' | 'brep'\n * @param options - optional mesh deflection options\n * @returns the import result\n */\nexport async function importStep(\n  bytes: ArrayBuffer | Uint8Array | string,\n  format: 'step' | 'brep' = 'step',\n  options?: MeshDeflectionOptions,\n): Promise<ImportStepResult> {\n  const result: WasmImportResult = format === 'brep'\n    ? await importBrepToMesh(bytes as string, options)\n    : await importStepToMesh(bytes as ArrayBuffer | Uint8Array, options)\n\n  // 合并所有 mesh 的 positions/indices\n  let totalPositions = 0\n  let totalIndices = 0\n  for (const mesh of result.meshes) {\n    totalPositions += mesh.positions.length\n    totalIndices += mesh.indices.length\n  }\n\n  const positions = new Float32Array(totalPositions)\n  const indices = new Uint32Array(totalIndices)\n  let posOffset = 0\n  let idxOffset = 0\n  let idxBase = 0\n  for (const mesh of result.meshes) {\n    positions.set(mesh.positions, posOffset)\n    posOffset += mesh.positions.length\n    // 需要偏移索引\n    for (let i = 0; i < mesh.indices.length; i++) {\n      indices[idxOffset + i] = mesh.indices[i] + idxBase\n    }\n    idxOffset += mesh.indices.length\n    idxBase += mesh.positions.length / 3\n  }\n\n  return {\n    shape: { positions, indices },\n    meshes: result.meshes,\n    solid: result.shapeHandle,\n    meshWithGroups: result.meshWithGroups,\n  }\n}\n\n// ── 导出 API ──\n\n/** Options for exporting mesh data to a STEP string. */\nexport interface ExportStepOptions {\n  /** Sewing tolerance. */\n  tolerance?: number\n}\n\n/**\n * High-level: export mesh data as a STEP string.\n *\n * Wraps the full meshesToStep flow. Hosts no longer need to operate the OCCT kernel directly.\n *\n * @param shape - mesh data (positions + indices)\n * @param options - optional export options (sewing tolerance)\n * @returns the STEP file text content\n */\nexport function exportStep(\n  shape: Shape,\n  options?: ExportStepOptions,\n): string {\n  return meshesToStep(\n    shape.positions,\n    shape.indices,\n    options?.tolerance ?? 0.01,\n  )\n}\n\n/**\n * High-level: release an OCCT solid handle.\n *\n * Wraps the full releaseShape flow.\n *\n * @param solid - the solid handle to release\n */\nexport function releaseSolid(solid: ShapeHandle): void {\n  releaseShape(solid)\n}\n\n/**\n * High-level: multi-solid STEP export (zero fuse).\n *\n * Each entry is exported as an independent entity in the STEP (independent XCAF\n * label / PRODUCT), preserving name and color. Multiple solids are never fused.\n *\n * Wraps the full ensureOcctKernel + exportStepFromSolids flow.\n * Hosts no longer need to operate the OCCT kernel directly.\n *\n * @param entries - parts to export; each becomes its own independent entity\n * @returns STEP file content as ArrayBuffer\n */\nexport async function exportStepFromSolidsHighLevel(\n  entries: StepExportEntry[],\n): Promise<ArrayBuffer> {\n  // step.ts consumes the L1 contract — pass the adapter, not the raw kernel\n  // (no cross-layer assertion; narrowing plan §Phase 3).\n  const primitives = await createOcctPrimitives()\n  return exportStepFromSolids(primitives, entries)\n}\n\n// ── 管理函数 ──\n\n/**\n * High-level: initialize the OCCT kernel.\n * Returns the cached instance if already initialized.\n *\n * @returns the initialized OCCT kernel\n */\nexport async function ensureOcctKernel(): Promise<OcctKernel> {\n  return initOcctWasm() as unknown as Promise<OcctKernel>\n}\n\n/**\n * High-level: dispose the OCCT kernel.\n * Call when unloading the page or releasing WASM memory.\n */\nexport function disposeOcct(): void {\n  disposeOcctWasm()\n}\n\n// Re-export 底层类型供高层 API 用户使用\nexport type { OcctKernel, ShapeHandle, WasmTessellatedMesh, Mesh, MeshDeflectionOptions }\n"]}

package/dist/occt-kernel/hullGeometry.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pure-TS 3D convex hull (QuickHull).
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 2 §5.1）：复制自 brepjs
+ * `src/kernel/hullGeometry.ts`（同源复制，签名不变；brepjs 包 Phase 5 删除后
+ * 仍由本文件承担）。
+ *
+ * Kernel-agnostic: operates on plain {x,y,z} points and returns triangle
+ * indices. Shared by the occt and occt-wasm adapters, which supply their own
+ * vertex extraction and BREP reconstruction around it.
+ */
+export interface Vec3 {
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+}
+/** Result of a QuickHull computation: hull triangle indices and deduplicated points. */
+export interface HullResult {
+    readonly faces: ReadonlyArray<readonly [number, number, number]>;
+    readonly points: readonly Vec3[];
+}
+/**
+ * Compute the 3D convex hull of a point set.
+ *
+ * @param inputPoints - Input points to build the hull from.
+ * @param tolerance - Coincidence tolerance for point deduplication.
+ * @returns The hull faces (triangle indices) and deduplicated points.
+ * @throws if fewer than 4 non-coincident, non-coplanar points are supplied.
+ */
+export declare function quickHull(inputPoints: Vec3[], tolerance: number): HullResult;
+//# sourceMappingURL=hullGeometry.d.ts.map

package/dist/occt-kernel/hullGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hullGeometry.d.ts","sourceRoot":"","sources":["../../src/occt-kernel/hullGeometry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wFAAwF;AACxF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC;CAClC;AAyLD;;;;;;;GAOG;AAEH,wBAAgB,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAsK5E"}

package/dist/occt-kernel/hullGeometry.js

@@ -0,0 +1,319 @@
+/**
+ * Pure-TS 3D convex hull (QuickHull).
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 2 §5.1）：复制自 brepjs
+ * `src/kernel/hullGeometry.ts`（同源复制，签名不变；brepjs 包 Phase 5 删除后
+ * 仍由本文件承担）。
+ *
+ * Kernel-agnostic: operates on plain {x,y,z} points and returns triangle
+ * indices. Shared by the occt and occt-wasm adapters, which supply their own
+ * vertex extraction and BREP reconstruction around it.
+ */
+// ---------------------------------------------------------------------------
+// Vector math helpers
+// ---------------------------------------------------------------------------
+function sub(a, b) {
+    return { x: a.x - b.x, y: a.y - b.y, z: a.z - b.z };
+}
+function cross(a, b) {
+    return {
+        x: a.y * b.z - a.z * b.y,
+        y: a.z * b.x - a.x * b.z,
+        z: a.x * b.y - a.y * b.x,
+    };
+}
+function dot(a, b) {
+    return a.x * b.x + a.y * b.y + a.z * b.z;
+}
+function lengthVec(v) {
+    return Math.sqrt(v.x * v.x + v.y * v.y + v.z * v.z);
+}
+function distSq(a, b) {
+    const dx = a.x - b.x;
+    const dy = a.y - b.y;
+    const dz = a.z - b.z;
+    return dx * dx + dy * dy + dz * dz;
+}
+/** Safe array access — throws on out-of-bounds instead of returning undefined. */
+function at(arr, i) {
+    const v = arr[i];
+    if (v === undefined)
+        throw new Error(`Index ${i} out of bounds`);
+    return v;
+}
+/** Safe number array access. */
+function atN(arr, i) {
+    const v = arr[i];
+    if (v === undefined)
+        throw new Error(`Index ${i} out of bounds`);
+    return v;
+}
+function makeFace(points, a, b, c) {
+    const normal = cross(sub(at(points, b), at(points, a)), sub(at(points, c), at(points, a)));
+    const len = lengthVec(normal);
+    const n = len > 1e-14 ? { x: normal.x / len, y: normal.y / len, z: normal.z / len } : normal;
+    return {
+        a,
+        b,
+        c,
+        normal: n,
+        offset: dot(n, at(points, a)),
+        alive: true,
+        outsidePoints: [],
+    };
+}
+function signedDist(face, point) {
+    return dot(face.normal, point) - face.offset;
+}
+// ---------------------------------------------------------------------------
+// Deduplication
+// ---------------------------------------------------------------------------
+function deduplicatePoints(points, tolerance) {
+    const tolSq = tolerance * tolerance;
+    const result = [];
+    for (const p of points) {
+        let isDuplicate = false;
+        for (const q of result) {
+            if (distSq(p, q) < tolSq) {
+                isDuplicate = true;
+                break;
+            }
+        }
+        if (!isDuplicate)
+            result.push(p);
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Initial tetrahedron
+// ---------------------------------------------------------------------------
+function findInitialTetrahedron(points) {
+    const n = points.length;
+    if (n < 4)
+        return null;
+    // Find two most distant points along each axis, pick the pair with max distance
+    let i0 = 0;
+    let i1 = 1;
+    let maxDist = distSq(at(points, 0), at(points, 1));
+    for (let i = 0; i < n; i++) {
+        for (let j = i + 1; j < n; j++) {
+            const d = distSq(at(points, i), at(points, j));
+            if (d > maxDist) {
+                maxDist = d;
+                i0 = i;
+                i1 = j;
+            }
+        }
+    }
+    if (maxDist < 1e-20)
+        return null;
+    // Find point most distant from line i0-i1
+    const lineDir = sub(at(points, i1), at(points, i0));
+    let i2 = -1;
+    let maxLineDist = -1;
+    for (let i = 0; i < n; i++) {
+        if (i === i0 || i === i1)
+            continue;
+        const v = sub(at(points, i), at(points, i0));
+        const c = cross(lineDir, v);
+        const d = dot(c, c);
+        if (d > maxLineDist) {
+            maxLineDist = d;
+            i2 = i;
+        }
+    }
+    if (i2 === -1 || maxLineDist < 1e-20)
+        return null;
+    // Find point most distant from plane i0-i1-i2
+    const planeNormal = cross(sub(at(points, i1), at(points, i0)), sub(at(points, i2), at(points, i0)));
+    const planeLen = lengthVec(planeNormal);
+    if (planeLen < 1e-14)
+        return null;
+    const pn = {
+        x: planeNormal.x / planeLen,
+        y: planeNormal.y / planeLen,
+        z: planeNormal.z / planeLen,
+    };
+    const planeOffset = dot(pn, at(points, i0));
+    let i3 = -1;
+    let maxPlaneDist = -1;
+    for (let i = 0; i < n; i++) {
+        if (i === i0 || i === i1 || i === i2)
+            continue;
+        const d = Math.abs(dot(pn, at(points, i)) - planeOffset);
+        if (d > maxPlaneDist) {
+            maxPlaneDist = d;
+            i3 = i;
+        }
+    }
+    if (i3 === -1 || maxPlaneDist < 1e-14)
+        return null;
+    // Orient tetrahedron so that i3 is "above" the base triangle
+    const sd = dot(pn, at(points, i3)) - planeOffset;
+    if (sd > 0) {
+        return [i0, i2, i1, i3]; // flip base winding
+    }
+    return [i0, i1, i2, i3];
+}
+// ---------------------------------------------------------------------------
+// QuickHull
+// ---------------------------------------------------------------------------
+/**
+ * Compute the 3D convex hull of a point set.
+ *
+ * @param inputPoints - Input points to build the hull from.
+ * @param tolerance - Coincidence tolerance for point deduplication.
+ * @returns The hull faces (triangle indices) and deduplicated points.
+ * @throws if fewer than 4 non-coincident, non-coplanar points are supplied.
+ */
+// brepjs-patterns-disable: max-function-lines -- cohesive QuickHull main loop; splitting hurts readability
+export function quickHull(inputPoints, tolerance) {
+    const points = deduplicatePoints(inputPoints, tolerance);
+    if (points.length < 4) {
+        throw new Error(points.length === 0
+            ? 'No points provided for convex hull'
+            : 'Fewer than 4 non-coincident points; cannot form a 3D convex hull');
+    }
+    const tet = findInitialTetrahedron(points);
+    if (tet === null) {
+        throw new Error('All points are coplanar; cannot form a 3D convex hull');
+    }
+    const [t0, t1, t2, t3] = tet;
+    // Centroid of initial tetrahedron for ensuring outward normals
+    const centroid = {
+        x: (at(points, t0).x + at(points, t1).x + at(points, t2).x + at(points, t3).x) / 4,
+        y: (at(points, t0).y + at(points, t1).y + at(points, t2).y + at(points, t3).y) / 4,
+        z: (at(points, t0).z + at(points, t1).z + at(points, t2).z + at(points, t3).z) / 4,
+    };
+    // Build initial 4 faces of tetrahedron, ensuring outward normals
+    function makeOutwardFace(a, b, c) {
+        const face = makeFace(points, a, b, c);
+        // If normal points toward centroid, flip the winding
+        const faceCenter = {
+            x: (at(points, a).x + at(points, b).x + at(points, c).x) / 3,
+            y: (at(points, a).y + at(points, b).y + at(points, c).y) / 3,
+            z: (at(points, a).z + at(points, b).z + at(points, c).z) / 3,
+        };
+        const toCentroid = sub(centroid, faceCenter);
+        if (dot(face.normal, toCentroid) > 0) {
+            // Normal points inward, flip
+            return makeFace(points, a, c, b);
+        }
+        return face;
+    }
+    const faces = [
+        makeOutwardFace(t0, t1, t2),
+        makeOutwardFace(t0, t2, t3),
+        makeOutwardFace(t0, t3, t1),
+        makeOutwardFace(t1, t3, t2),
+    ];
+    const tetSet = new Set([t0, t1, t2, t3]);
+    // Use a small geometric epsilon for "outside" tests, independent of mesh tolerance.
+    // Mesh tolerance controls deduplication; hull geometry uses a much tighter epsilon.
+    const epsilon = 1e-10;
+    // Assign each non-tet point to the first visible face
+    for (let i = 0; i < points.length; i++) {
+        if (tetSet.has(i))
+            continue;
+        for (const face of faces) {
+            if (signedDist(face, at(points, i)) > epsilon) {
+                face.outsidePoints.push(i);
+                break;
+            }
+        }
+    }
+    for (let iteration = 0; iteration < points.length * 4; iteration++) {
+        // Find a face with outside points
+        let currentFace = null;
+        for (const face of faces) {
+            if (face.alive && face.outsidePoints.length > 0) {
+                currentFace = face;
+                break;
+            }
+        }
+        if (currentFace === null)
+            break;
+        // Find the furthest point from this face
+        let furthestIdx = atN(currentFace.outsidePoints, 0);
+        let furthestDist = signedDist(currentFace, at(points, furthestIdx));
+        for (let i = 1; i < currentFace.outsidePoints.length; i++) {
+            const idx = atN(currentFace.outsidePoints, i);
+            const d = signedDist(currentFace, at(points, idx));
+            if (d > furthestDist) {
+                furthestDist = d;
+                furthestIdx = idx;
+            }
+        }
+        // Find all visible faces from this point
+        const visibleFaces = [];
+        for (const face of faces) {
+            if (face.alive && signedDist(face, at(points, furthestIdx)) > epsilon) {
+                visibleFaces.push(face);
+            }
+        }
+        // Find horizon edges (edges shared by exactly one visible face)
+        const edgeCount = new Map();
+        for (const face of visibleFaces) {
+            const edges = [
+                [face.a, face.b],
+                [face.b, face.c],
+                [face.c, face.a],
+            ];
+            for (const [ea, eb] of edges) {
+                const key = ea < eb ? `${ea}-${eb}` : `${eb}-${ea}`;
+                const entry = edgeCount.get(key);
+                if (entry) {
+                    entry.count++;
+                }
+                else {
+                    // Store in the order from the visible face
+                    edgeCount.set(key, { a: ea, b: eb, count: 1 });
+                }
+            }
+        }
+        const horizonEdges = [];
+        for (const entry of edgeCount.values()) {
+            if (entry.count === 1) {
+                // Keep edge in same direction as the visible face; makeFace with apex
+                // produces outward normal by winding convention
+                horizonEdges.push({ a: entry.a, b: entry.b });
+            }
+        }
+        // Collect orphaned outside points from visible faces
+        const orphanedPoints = [];
+        for (const face of visibleFaces) {
+            for (const idx of face.outsidePoints) {
+                if (idx !== furthestIdx) {
+                    orphanedPoints.push(idx);
+                }
+            }
+            face.alive = false;
+            face.outsidePoints = [];
+        }
+        // Create new faces from horizon edges to the furthest point
+        const newFaces = [];
+        for (const edge of horizonEdges) {
+            const newFaceObj = makeFace(points, edge.a, edge.b, furthestIdx);
+            newFaces.push(newFaceObj);
+            faces.push(newFaceObj);
+        }
+        // Reassign orphaned points to new faces
+        for (const idx of orphanedPoints) {
+            for (const face of newFaces) {
+                if (signedDist(face, at(points, idx)) > epsilon) {
+                    face.outsidePoints.push(idx);
+                    break;
+                }
+            }
+        }
+    }
+    // Collect alive faces
+    const resultFaces = [];
+    for (const face of faces) {
+        if (face.alive) {
+            resultFaces.push([face.a, face.b, face.c]);
+        }
+    }
+    return { faces: resultFaces, points };
+}
+//# sourceMappingURL=hullGeometry.js.map

package/dist/occt-kernel/hullGeometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hullGeometry.js","sourceRoot":"","sources":["../../src/occt-kernel/hullGeometry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Pure-TS 3D convex hull (QuickHull).\n *\n * 第一方模块（2026-09-25 core-decouple Phase 2 §5.1）：复制自 brepjs\n * `src/kernel/hullGeometry.ts`（同源复制，签名不变；brepjs 包 Phase 5 删除后\n * 仍由本文件承担）。\n *\n * Kernel-agnostic: operates on plain {x,y,z} points and returns triangle\n * indices. Shared by the occt and occt-wasm adapters, which supply their own\n * vertex extraction and BREP reconstruction around it.\n */\n\nexport interface Vec3 {\n  readonly x: number;\n  readonly y: number;\n  readonly z: number;\n}\n\n/** Result of a QuickHull computation: hull triangle indices and deduplicated points. */\nexport interface HullResult {\n  readonly faces: ReadonlyArray<readonly [number, number, number]>;\n  readonly points: readonly Vec3[];\n}\n\n// ---------------------------------------------------------------------------\n// Vector math helpers\n// ---------------------------------------------------------------------------\n\nfunction sub(a: Vec3, b: Vec3): Vec3 {\n  return { x: a.x - b.x, y: a.y - b.y, z: a.z - b.z };\n}\n\nfunction cross(a: Vec3, b: Vec3): Vec3 {\n  return {\n    x: a.y * b.z - a.z * b.y,\n    y: a.z * b.x - a.x * b.z,\n    z: a.x * b.y - a.y * b.x,\n  };\n}\n\nfunction dot(a: Vec3, b: Vec3): number {\n  return a.x * b.x + a.y * b.y + a.z * b.z;\n}\n\nfunction lengthVec(v: Vec3): number {\n  return Math.sqrt(v.x * v.x + v.y * v.y + v.z * v.z);\n}\n\nfunction distSq(a: Vec3, b: Vec3): number {\n  const dx = a.x - b.x;\n  const dy = a.y - b.y;\n  const dz = a.z - b.z;\n  return dx * dx + dy * dy + dz * dz;\n}\n\n/** Safe array access — throws on out-of-bounds instead of returning undefined. */\nfunction at(arr: readonly Vec3[], i: number): Vec3 {\n  const v = arr[i];\n  if (v === undefined) throw new Error(`Index ${i} out of bounds`);\n  return v;\n}\n\n/** Safe number array access. */\nfunction atN(arr: readonly number[], i: number): number {\n  const v = arr[i];\n  if (v === undefined) throw new Error(`Index ${i} out of bounds`);\n  return v;\n}\n\n// ---------------------------------------------------------------------------\n// QuickHull face\n// ---------------------------------------------------------------------------\n\ninterface HullFace {\n  readonly a: number; // indices into points array\n  readonly b: number;\n  readonly c: number;\n  readonly normal: Vec3;\n  readonly offset: number; // dot(normal, points[a])\n  alive: boolean;\n  outsidePoints: number[];\n}\n\nfunction makeFace(points: readonly Vec3[], a: number, b: number, c: number): HullFace {\n  const normal = cross(sub(at(points, b), at(points, a)), sub(at(points, c), at(points, a)));\n  const len = lengthVec(normal);\n  const n = len > 1e-14 ? { x: normal.x / len, y: normal.y / len, z: normal.z / len } : normal;\n  return {\n    a,\n    b,\n    c,\n    normal: n,\n    offset: dot(n, at(points, a)),\n    alive: true,\n    outsidePoints: [],\n  };\n}\n\nfunction signedDist(face: HullFace, point: Vec3): number {\n  return dot(face.normal, point) - face.offset;\n}\n\n// ---------------------------------------------------------------------------\n// Deduplication\n// ---------------------------------------------------------------------------\n\nfunction deduplicatePoints(points: Vec3[], tolerance: number): Vec3[] {\n  const tolSq = tolerance * tolerance;\n  const result: Vec3[] = [];\n  for (const p of points) {\n    let isDuplicate = false;\n    for (const q of result) {\n      if (distSq(p, q) < tolSq) {\n        isDuplicate = true;\n        break;\n      }\n    }\n    if (!isDuplicate) result.push(p);\n  }\n  return result;\n}\n\n// ---------------------------------------------------------------------------\n// Initial tetrahedron\n// ---------------------------------------------------------------------------\n\nfunction findInitialTetrahedron(points: readonly Vec3[]): [number, number, number, number] | null {\n  const n = points.length;\n  if (n < 4) return null;\n\n  // Find two most distant points along each axis, pick the pair with max distance\n  let i0 = 0;\n  let i1 = 1;\n  let maxDist = distSq(at(points, 0), at(points, 1));\n\n  for (let i = 0; i < n; i++) {\n    for (let j = i + 1; j < n; j++) {\n      const d = distSq(at(points, i), at(points, j));\n      if (d > maxDist) {\n        maxDist = d;\n        i0 = i;\n        i1 = j;\n      }\n    }\n  }\n\n  if (maxDist < 1e-20) return null;\n\n  // Find point most distant from line i0-i1\n  const lineDir = sub(at(points, i1), at(points, i0));\n  let i2 = -1;\n  let maxLineDist = -1;\n\n  for (let i = 0; i < n; i++) {\n    if (i === i0 || i === i1) continue;\n    const v = sub(at(points, i), at(points, i0));\n    const c = cross(lineDir, v);\n    const d = dot(c, c);\n    if (d > maxLineDist) {\n      maxLineDist = d;\n      i2 = i;\n    }\n  }\n\n  if (i2 === -1 || maxLineDist < 1e-20) return null;\n\n  // Find point most distant from plane i0-i1-i2\n  const planeNormal = cross(\n    sub(at(points, i1), at(points, i0)),\n    sub(at(points, i2), at(points, i0))\n  );\n  const planeLen = lengthVec(planeNormal);\n  if (planeLen < 1e-14) return null;\n\n  const pn = {\n    x: planeNormal.x / planeLen,\n    y: planeNormal.y / planeLen,\n    z: planeNormal.z / planeLen,\n  };\n  const planeOffset = dot(pn, at(points, i0));\n\n  let i3 = -1;\n  let maxPlaneDist = -1;\n\n  for (let i = 0; i < n; i++) {\n    if (i === i0 || i === i1 || i === i2) continue;\n    const d = Math.abs(dot(pn, at(points, i)) - planeOffset);\n    if (d > maxPlaneDist) {\n      maxPlaneDist = d;\n      i3 = i;\n    }\n  }\n\n  if (i3 === -1 || maxPlaneDist < 1e-14) return null;\n\n  // Orient tetrahedron so that i3 is \"above\" the base triangle\n  const sd = dot(pn, at(points, i3)) - planeOffset;\n  if (sd > 0) {\n    return [i0, i2, i1, i3]; // flip base winding\n  }\n  return [i0, i1, i2, i3];\n}\n\n// ---------------------------------------------------------------------------\n// QuickHull\n// ---------------------------------------------------------------------------\n\n/**\n * Compute the 3D convex hull of a point set.\n *\n * @param inputPoints - Input points to build the hull from.\n * @param tolerance - Coincidence tolerance for point deduplication.\n * @returns The hull faces (triangle indices) and deduplicated points.\n * @throws if fewer than 4 non-coincident, non-coplanar points are supplied.\n */\n// brepjs-patterns-disable: max-function-lines -- cohesive QuickHull main loop; splitting hurts readability\nexport function quickHull(inputPoints: Vec3[], tolerance: number): HullResult {\n  const points = deduplicatePoints(inputPoints, tolerance);\n\n  if (points.length < 4) {\n    throw new Error(\n      points.length === 0\n        ? 'No points provided for convex hull'\n        : 'Fewer than 4 non-coincident points; cannot form a 3D convex hull'\n    );\n  }\n\n  const tet = findInitialTetrahedron(points);\n  if (tet === null) {\n    throw new Error('All points are coplanar; cannot form a 3D convex hull');\n  }\n\n  const [t0, t1, t2, t3] = tet;\n\n  // Centroid of initial tetrahedron for ensuring outward normals\n  const centroid: Vec3 = {\n    x: (at(points, t0).x + at(points, t1).x + at(points, t2).x + at(points, t3).x) / 4,\n    y: (at(points, t0).y + at(points, t1).y + at(points, t2).y + at(points, t3).y) / 4,\n    z: (at(points, t0).z + at(points, t1).z + at(points, t2).z + at(points, t3).z) / 4,\n  };\n\n  // Build initial 4 faces of tetrahedron, ensuring outward normals\n  function makeOutwardFace(a: number, b: number, c: number): HullFace {\n    const face = makeFace(points, a, b, c);\n    // If normal points toward centroid, flip the winding\n    const faceCenter: Vec3 = {\n      x: (at(points, a).x + at(points, b).x + at(points, c).x) / 3,\n      y: (at(points, a).y + at(points, b).y + at(points, c).y) / 3,\n      z: (at(points, a).z + at(points, b).z + at(points, c).z) / 3,\n    };\n    const toCentroid = sub(centroid, faceCenter);\n    if (dot(face.normal, toCentroid) > 0) {\n      // Normal points inward, flip\n      return makeFace(points, a, c, b);\n    }\n    return face;\n  }\n\n  const faces: HullFace[] = [\n    makeOutwardFace(t0, t1, t2),\n    makeOutwardFace(t0, t2, t3),\n    makeOutwardFace(t0, t3, t1),\n    makeOutwardFace(t1, t3, t2),\n  ];\n\n  const tetSet = new Set([t0, t1, t2, t3]);\n\n  // Use a small geometric epsilon for \"outside\" tests, independent of mesh tolerance.\n  // Mesh tolerance controls deduplication; hull geometry uses a much tighter epsilon.\n  const epsilon = 1e-10;\n\n  // Assign each non-tet point to the first visible face\n  for (let i = 0; i < points.length; i++) {\n    if (tetSet.has(i)) continue;\n    for (const face of faces) {\n      if (signedDist(face, at(points, i)) > epsilon) {\n        face.outsidePoints.push(i);\n        break;\n      }\n    }\n  }\n\n  for (let iteration = 0; iteration < points.length * 4; iteration++) {\n    // Find a face with outside points\n    let currentFace: HullFace | null = null;\n    for (const face of faces) {\n      if (face.alive && face.outsidePoints.length > 0) {\n        currentFace = face;\n        break;\n      }\n    }\n    if (currentFace === null) break;\n\n    // Find the furthest point from this face\n    let furthestIdx = atN(currentFace.outsidePoints, 0);\n    let furthestDist = signedDist(currentFace, at(points, furthestIdx));\n    for (let i = 1; i < currentFace.outsidePoints.length; i++) {\n      const idx = atN(currentFace.outsidePoints, i);\n      const d = signedDist(currentFace, at(points, idx));\n      if (d > furthestDist) {\n        furthestDist = d;\n        furthestIdx = idx;\n      }\n    }\n\n    // Find all visible faces from this point\n    const visibleFaces: HullFace[] = [];\n    for (const face of faces) {\n      if (face.alive && signedDist(face, at(points, furthestIdx)) > epsilon) {\n        visibleFaces.push(face);\n      }\n    }\n\n    // Find horizon edges (edges shared by exactly one visible face)\n    const edgeCount = new Map<string, { a: number; b: number; count: number }>();\n    for (const face of visibleFaces) {\n      const edges: [number, number][] = [\n        [face.a, face.b],\n        [face.b, face.c],\n        [face.c, face.a],\n      ];\n      for (const [ea, eb] of edges) {\n        const key = ea < eb ? `${ea}-${eb}` : `${eb}-${ea}`;\n        const entry = edgeCount.get(key);\n        if (entry) {\n          entry.count++;\n        } else {\n          // Store in the order from the visible face\n          edgeCount.set(key, { a: ea, b: eb, count: 1 });\n        }\n      }\n    }\n\n    const horizonEdges: Array<{ a: number; b: number }> = [];\n    for (const entry of edgeCount.values()) {\n      if (entry.count === 1) {\n        // Keep edge in same direction as the visible face; makeFace with apex\n        // produces outward normal by winding convention\n        horizonEdges.push({ a: entry.a, b: entry.b });\n      }\n    }\n\n    // Collect orphaned outside points from visible faces\n    const orphanedPoints: number[] = [];\n    for (const face of visibleFaces) {\n      for (const idx of face.outsidePoints) {\n        if (idx !== furthestIdx) {\n          orphanedPoints.push(idx);\n        }\n      }\n      face.alive = false;\n      face.outsidePoints = [];\n    }\n\n    // Create new faces from horizon edges to the furthest point\n    const newFaces: HullFace[] = [];\n    for (const edge of horizonEdges) {\n      const newFaceObj = makeFace(points, edge.a, edge.b, furthestIdx);\n      newFaces.push(newFaceObj);\n      faces.push(newFaceObj);\n    }\n\n    // Reassign orphaned points to new faces\n    for (const idx of orphanedPoints) {\n      for (const face of newFaces) {\n        if (signedDist(face, at(points, idx)) > epsilon) {\n          face.outsidePoints.push(idx);\n          break;\n        }\n      }\n    }\n  }\n\n  // Collect alive faces\n  const resultFaces: Array<readonly [number, number, number]> = [];\n  for (const face of faces) {\n    if (face.alive) {\n      resultFaces.push([face.a, face.b, face.c] as const);\n    }\n  }\n\n  return { faces: resultFaces, points };\n}\n"]}

package/dist/occt-kernel/hullOps.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Convex hull operations for the faijs occt kernel（第一方模块）。
+ *
+ * 2026-09-25 core-decouple Phase 2 §5.1：最小闭包移植——算法复制自 brepjs
+ * `src/kernel/occtWasm/hullOps.ts` + `src/kernel/occtWasm/constructionOps.ts#buildSolidFromFaces`，
+ * BREP 重建改为 core 的 occt-wasm 原生直调（`buildTriFace` / `sewAndSolidify` /
+ * `fixFaceOrientations` / `release`，occt-wasm index.d.ts 形态——ShapeHandle[]、
+ * Vec3 对象），**不 import brepjs**。occt-wasm 无原生 hull（Phase 0 实证），
+ * 故不直调原生 hull；QuickHull 由 `./hullGeometry` 承担。
+ */
+import type { OcctKernel } from 'occt-wasm';
+import type { BrepHandle } from '../brep/engine/types.js';
+import { type Vec3 } from './hullGeometry.js';
+/**
+ * 由点集构造凸包实体（brepjs 原语义：quickHull → 三角面 → 缝合 → 修复朝向 → solid）。
+ *
+ * @param k - OCCT kernel used for BREP reconstruction.
+ * @param points - Input points to build the hull from.
+ * @param tolerance - Point coincidence tolerance for QuickHull.
+ * @returns The constructed hull solid handle.
+ * @throws 点数不足 4 或退化（面 < 4）——与 brepjs 原实现一致。
+ */
+export declare function hullFromPoints(k: OcctKernel, points: Vec3[], tolerance: number): BrepHandle;
+//# sourceMappingURL=hullOps.d.ts.map

package/dist/occt-kernel/hullOps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hullOps.d.ts","sourceRoot":"","sources":["../../src/occt-kernel/hullOps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,WAAW,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAa,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAErD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,CAAC,EAAE,UAAU,EACb,MAAM,EAAE,IAAI,EAAE,EACd,SAAS,EAAE,MAAM,GAChB,UAAU,CAyBZ"}