@faicad/faijs 0.29.5 → 0.30.9

package/dist/api/brep-operations/compoundFns.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Self-hosted compat-op implementations — compound feature family
+ * (core-decouple Phase 3, §5.4; drill / pocket / boss / mirrorJoin).
+ *
+ * @platform occt
+ *
+ * Argument contract (post core-decouple; handle extraction lives in
+ * `brepHelpers.ts`):
+ *  - `options.face` supports an omitted default (highest-Z face) or an already
+ *    constructed face handle (`{ wrapped }` / `{ id }`); a finder DSL is not
+ *    supported.
+ *  - `options.profile` must be an already constructed wire handle (`{ wrapped }` /
+ *    `{ id }`); a drawing/sketch DSL is not supported (it is not a core data type).
+ * Intermediates (tool/profile face/positioned face) are released after use.
+ */
+import type { BrepHandle } from '../../brep/engine/types.js';
+import { type Result } from '../../result/result.js';
+/**
+ * Drill — cut a cylinder through the shape.
+ *
+ * @param args - Resolved arguments (shape, drill options).
+ * @returns The drilled shape as a `BrepHandle`.
+ */
+export declare function drillBrep(...args: unknown[]): Result<BrepHandle>;
+/**
+ * Pocket — extrude a profile inward and cut it from the shape.
+ *
+ * @param args - Resolved arguments (shape, pocket options).
+ * @returns The pocketed shape as a `BrepHandle`.
+ */
+export declare function pocketBrep(...args: unknown[]): Result<BrepHandle>;
+/**
+ * Boss — extrude a profile outward and fuse it onto the shape.
+ *
+ * @param args - Resolved arguments (shape, boss options).
+ * @returns The shape with the boss fused as a `BrepHandle`.
+ */
+export declare function bossBrep(...args: unknown[]): Result<BrepHandle>;
+/**
+ * Mirror the shape across a plane and fuse the mirrored copy to the original.
+ *
+ * @param args - Resolved arguments (shape, mirror options).
+ * @returns The shape joined with its mirror as a `BrepHandle`.
+ */
+export declare function mirrorJoinBrep(...args: unknown[]): Result<BrepHandle>;
+//# sourceMappingURL=compoundFns.d.ts.map

package/dist/api/brep-operations/compoundFns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compoundFns.d.ts","sourceRoot":"","sources":["../../../src/api/brep-operations/compoundFns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEzD,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAkHjE;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CA4DhE;AAMD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAmCjE;AAMD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAmC/D;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAwBrE"}

package/dist/api/brep-operations/compoundFns.js

@@ -0,0 +1,299 @@
+/**
+ * Self-hosted compat-op implementations — compound feature family
+ * (core-decouple Phase 3, §5.4; drill / pocket / boss / mirrorJoin).
+ *
+ * @platform occt
+ *
+ * Argument contract (post core-decouple; handle extraction lives in
+ * `brepHelpers.ts`):
+ *  - `options.face` supports an omitted default (highest-Z face) or an already
+ *    constructed face handle (`{ wrapped }` / `{ id }`); a finder DSL is not
+ *    supported.
+ *  - `options.profile` must be an already constructed wire handle (`{ wrapped }` /
+ *    `{ id }`); a drawing/sketch DSL is not supported (it is not a core data type).
+ * Intermediates (tool/profile face/positioned face) are released after use.
+ */
+import { getBrepApi } from '../../brep/handle-bridge.js';
+import { ok, err, isErr } from '../../result/result.js';
+import { kernelError, validationError } from '../../result/errors.js';
+import { resolveArgs } from '../internal/dual-form-args.js';
+import { brepHandleOf, composeAffine, rotationZTo, translationMatrix } from './brepHelpers.js';
+const DRILL_PARAMS = { name: 'drill', params: ['shape', 'options'], formClass: 'A' };
+const POCKET_PARAMS = { name: 'pocket', params: ['shape', 'options'], formClass: 'A' };
+const BOSS_PARAMS = { name: 'boss', params: ['shape', 'options'], formClass: 'A' };
+const MIRROR_JOIN_PARAMS = { name: 'mirrorJoin', params: ['shape', 'options'], formClass: 'A' };
+// ---------------------------------------------------------------------------
+// Vec helpers
+// ---------------------------------------------------------------------------
+function vecIsZero(v) {
+    return v[0] === 0 && v[1] === 0 && v[2] === 0;
+}
+function vecNormalize(v) {
+    const len = Math.hypot(v[0], v[1], v[2]);
+    return [v[0] / len, v[1] / len, v[2] / len];
+}
+function vecScale(v, k) {
+    return [v[0] * k, v[1] * k, v[2] * k];
+}
+// ---------------------------------------------------------------------------
+// Face/profile helpers
+// ---------------------------------------------------------------------------
+/** 构造位于 pos、沿 dir 轴的 cylinder（radius × height），返回句柄（调用方负责释放/消费）。 */
+function cylinderAt(kernel, radius, height, pos, dir) {
+    const base = kernel.makeCylinder(radius, height);
+    const m = composeAffine(rotationZTo(dir), translationMatrix(pos));
+    const placed = kernel.located(base, m);
+    kernel.release(base);
+    return placed;
+}
+/** 解析目标面：省略 → 最高 Z 面（faceCenter 最大）；Face（{wrapped}）→ 直取。 */
+function resolveTargetFace(kernel, shape, faceSpec) {
+    if (faceSpec === undefined || faceSpec === null) {
+        const faces = kernel.getSubShapes(shape, 'face');
+        if (faces.length === 0) {
+            return err(validationError('COMPOUND_NO_FACES', 'compoundOps: shape has no faces'));
+        }
+        let best = faces[0];
+        let bestZ = kernel.surfaceCenterOfMass(best).z;
+        for (let i = 1; i < faces.length; i++) {
+            const z = kernel.surfaceCenterOfMass(faces[i]).z;
+            if (z > bestZ) {
+                best = faces[i];
+                bestZ = z;
+            }
+        }
+        return ok(best);
+    }
+    if (typeof faceSpec === 'object') {
+        try {
+            return ok(brepHandleOf(faceSpec));
+        }
+        catch {
+            return err(validationError('COMPOUND_FACE_NOT_FOUND', 'compoundOps: face spec must be a face handle or omitted'));
+        }
+    }
+    return err(validationError('COMPOUND_FACE_NOT_FOUND', 'compoundOps: face spec must be a face handle or omitted'));
+}
+/** 面法向（uv 中心）。 */
+function faceNormalAt(kernel, face) {
+    const b = kernel.uvBounds(face);
+    const u = 0.5 * (b.uMin + b.uMax);
+    const v = 0.5 * (b.vMin + b.vMax);
+    const n = kernel.surfaceNormal(face, u, v);
+    return [n.x, n.y, n.z];
+}
+/** 面质心。 */
+function faceCenterAt(kernel, face) {
+    const c = kernel.surfaceCenterOfMass(face);
+    return [c.x, c.y, c.z];
+}
+/** profile（wire 句柄）→ face handle。 */
+function profileToFace(kernel, profile) {
+    try {
+        const wire = brepHandleOf(profile);
+        return ok(kernel.makeFace(wire));
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return err(validationError('COMPOUND_PROFILE_INVALID', `compoundOps: profile must be a wire handle (${raw})`));
+    }
+}
+// ---------------------------------------------------------------------------
+// drill — cut a cylinder through the shape
+// ---------------------------------------------------------------------------
+/**
+ * Drill — cut a cylinder through the shape.
+ *
+ * @param args - Resolved arguments (shape, drill options).
+ * @returns The drilled shape as a `BrepHandle`.
+ */
+export function drillBrep(...args) {
+    const [shape, options] = resolveArgs(args, DRILL_PARAMS);
+    const kernel = getBrepApi();
+    const s = brepHandleOf(shape);
+    const { at, radius, axis, depth } = options;
+    const ax = (axis ?? [0, 0, 1]);
+    if (radius <= 0)
+        return err(validationError('DRILL_INVALID_RADIUS', 'Drill radius must be positive'));
+    if (vecIsZero(ax))
+        return err(validationError('DRILL_ZERO_AXIS', 'Drill axis cannot be zero'));
+    const dir = vecNormalize([ax[0], ax[1], ax[2]]);
+    const pos = at.length === 2 ? [at[0], at[1], 0] : [at[0], at[1], at[2]];
+    let tool;
+    try {
+        if (depth !== undefined) {
+            tool = cylinderAt(kernel, radius, depth, pos, dir);
+        }
+        else {
+            // Through-all: project bounding box onto the drill axis, add overshoot.
+            const bb = kernel.getBoundingBox(s);
+            const corners = [
+                [bb.xmin, bb.ymin, bb.zmin],
+                [bb.xmax, bb.ymin, bb.zmin],
+                [bb.xmin, bb.ymax, bb.zmin],
+                [bb.xmax, bb.ymax, bb.zmin],
+                [bb.xmin, bb.ymin, bb.zmax],
+                [bb.xmax, bb.ymin, bb.zmax],
+                [bb.xmin, bb.ymax, bb.zmax],
+                [bb.xmax, bb.ymax, bb.zmax],
+            ];
+            let tMin = Infinity;
+            let tMax = -Infinity;
+            for (const c of corners) {
+                const t = (c[0] - pos[0]) * dir[0] + (c[1] - pos[1]) * dir[1] + (c[2] - pos[2]) * dir[2];
+                if (t < tMin)
+                    tMin = t;
+                if (t > tMax)
+                    tMax = t;
+            }
+            const overshoot = 1;
+            tMin -= overshoot;
+            tMax += overshoot;
+            const d = tMax - tMin;
+            const startPos = [
+                pos[0] + dir[0] * tMin,
+                pos[1] + dir[1] * tMin,
+                pos[2] + dir[2] * tMin,
+            ];
+            tool = cylinderAt(kernel, radius, d, startPos, dir);
+        }
+        return ok(kernel.cut(s, tool));
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return err(kernelError('DRILL_FAILED', `drill failed: ${raw}`, e));
+    }
+    finally {
+        if (tool !== undefined)
+            kernel.release(tool);
+    }
+}
+// ---------------------------------------------------------------------------
+// pocket — extrude a profile inward and cut
+// ---------------------------------------------------------------------------
+/**
+ * Pocket — extrude a profile inward and cut it from the shape.
+ *
+ * @param args - Resolved arguments (shape, pocket options).
+ * @returns The pocketed shape as a `BrepHandle`.
+ */
+export function pocketBrep(...args) {
+    const [shape, options] = resolveArgs(args, POCKET_PARAMS);
+    const kernel = getBrepApi();
+    const s = brepHandleOf(shape);
+    const { profile, depth } = options;
+    if (depth <= 0)
+        return err(validationError('POCKET_INVALID_DEPTH', 'Pocket depth must be positive'));
+    const faceRes = resolveTargetFace(kernel, s, options.face);
+    if (isErr(faceRes))
+        return faceRes;
+    const face = faceRes.value;
+    const normal = faceNormalAt(kernel, face);
+    const center = faceCenterAt(kernel, face);
+    const profRes = profileToFace(kernel, profile);
+    if (isErr(profRes))
+        return profRes;
+    const profFace = profRes.value;
+    let positioned;
+    let tool;
+    try {
+        positioned = kernel.translate(profFace, center[0], center[1], center[2]);
+        kernel.release(profFace);
+        const nn = vecNormalize([normal[0], normal[1], normal[2]]);
+        const extDir = vecScale(nn, -depth);
+        tool = kernel.extrude(positioned, extDir[0], extDir[1], extDir[2]);
+        kernel.release(positioned);
+        return ok(kernel.cut(s, tool));
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return err(kernelError('POCKET_FAILED', `pocket failed: ${raw}`, e));
+    }
+    finally {
+        if (tool !== undefined)
+            kernel.release(tool);
+        if (positioned !== undefined)
+            kernel.release(positioned);
+    }
+}
+// ---------------------------------------------------------------------------
+// boss — extrude a profile outward and fuse
+// ---------------------------------------------------------------------------
+/**
+ * Boss — extrude a profile outward and fuse it onto the shape.
+ *
+ * @param args - Resolved arguments (shape, boss options).
+ * @returns The shape with the boss fused as a `BrepHandle`.
+ */
+export function bossBrep(...args) {
+    const [shape, options] = resolveArgs(args, BOSS_PARAMS);
+    const kernel = getBrepApi();
+    const s = brepHandleOf(shape);
+    const { profile, height } = options;
+    if (height <= 0)
+        return err(validationError('BOSS_INVALID_HEIGHT', 'Boss height must be positive'));
+    const faceRes = resolveTargetFace(kernel, s, options.face);
+    if (isErr(faceRes))
+        return faceRes;
+    const face = faceRes.value;
+    const normal = faceNormalAt(kernel, face);
+    const center = faceCenterAt(kernel, face);
+    const profRes = profileToFace(kernel, profile);
+    if (isErr(profRes))
+        return profRes;
+    const profFace = profRes.value;
+    let positioned;
+    let tool;
+    try {
+        positioned = kernel.translate(profFace, center[0], center[1], center[2]);
+        kernel.release(profFace);
+        const nn = vecNormalize([normal[0], normal[1], normal[2]]);
+        const extDir = vecScale(nn, height);
+        tool = kernel.extrude(positioned, extDir[0], extDir[1], extDir[2]);
+        kernel.release(positioned);
+        return ok(kernel.fuse(s, tool));
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return err(kernelError('BOSS_FAILED', `boss failed: ${raw}`, e));
+    }
+    finally {
+        if (tool !== undefined)
+            kernel.release(tool);
+        if (positioned !== undefined)
+            kernel.release(positioned);
+    }
+}
+// ---------------------------------------------------------------------------
+// mirrorJoin — mirror and fuse in one step
+// ---------------------------------------------------------------------------
+/**
+ * Mirror the shape across a plane and fuse the mirrored copy to the original.
+ *
+ * @param args - Resolved arguments (shape, mirror options).
+ * @returns The shape joined with its mirror as a `BrepHandle`.
+ */
+export function mirrorJoinBrep(...args) {
+    const [shape, options] = resolveArgs(args, MIRROR_JOIN_PARAMS);
+    const kernel = getBrepApi();
+    const s = brepHandleOf(shape);
+    const { normal, at } = (options ?? {});
+    const n = (normal ?? [1, 0, 0]);
+    if (vecIsZero(n))
+        return err(validationError('MIRROR_ZERO_NORMAL', 'Mirror plane normal cannot be zero'));
+    const origin = (at ?? [0, 0, 0]);
+    let mirrored;
+    try {
+        mirrored = kernel.mirror(s, { x: origin[0], y: origin[1], z: origin[2] }, { x: n[0], y: n[1], z: n[2] });
+        return ok(kernel.fuse(s, mirrored));
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return err(kernelError('MIRROR_JOIN_FAILED', `mirrorJoin failed: ${raw}`, e));
+    }
+    finally {
+        if (mirrored !== undefined)
+            kernel.release(mirrored);
+    }
+}
+//# sourceMappingURL=compoundFns.js.map

package/dist/api/brep-operations/compoundFns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compoundFns.js","sourceRoot":"","sources":["../../../src/api/brep-operations/compoundFns.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Self-hosted compat-op implementations — compound feature family\n * (core-decouple Phase 3, §5.4; drill / pocket / boss / mirrorJoin).\n *\n * @platform occt\n *\n * Argument contract (post core-decouple; handle extraction lives in\n * `brepHelpers.ts`):\n *  - `options.face` supports an omitted default (highest-Z face) or an already\n *    constructed face handle (`{ wrapped }` / `{ id }`); a finder DSL is not\n *    supported.\n *  - `options.profile` must be an already constructed wire handle (`{ wrapped }` /\n *    `{ id }`); a drawing/sketch DSL is not supported (it is not a core data type).\n * Intermediates (tool/profile face/positioned face) are released after use.\n */\n\nimport type { BrepHandle } from '../../brep/engine/types'\nimport { getBrepApi } from '../../brep/handle-bridge'\nimport { ok, err, isErr, type Result } from '../../result/result'\nimport { kernelError, validationError } from '../../result/errors'\nimport type { FormClass } from '../internal/dual-form-args'\nimport { resolveArgs } from '../internal/dual-form-args'\nimport type { Vec3 } from '../geom-types/types'\nimport { brepHandleOf, composeAffine, rotationZTo, translationMatrix } from './brepHelpers'\n\nconst DRILL_PARAMS = { name: 'drill', params: ['shape', 'options'], formClass: 'A' as FormClass }\nconst POCKET_PARAMS = { name: 'pocket', params: ['shape', 'options'], formClass: 'A' as FormClass }\nconst BOSS_PARAMS = { name: 'boss', params: ['shape', 'options'], formClass: 'A' as FormClass }\nconst MIRROR_JOIN_PARAMS = { name: 'mirrorJoin', params: ['shape', 'options'], formClass: 'A' as FormClass }\n\n// ---------------------------------------------------------------------------\n// Vec helpers\n// ---------------------------------------------------------------------------\n\nfunction vecIsZero(v: readonly number[]): boolean {\n  return v[0] === 0 && v[1] === 0 && v[2] === 0\n}\n\nfunction vecNormalize(v: readonly [number, number, number]): [number, number, number] {\n  const len = Math.hypot(v[0], v[1], v[2])\n  return [v[0] / len, v[1] / len, v[2] / len]\n}\n\nfunction vecScale(v: readonly [number, number, number], k: number): [number, number, number] {\n  return [v[0] * k, v[1] * k, v[2] * k]\n}\n\n// ---------------------------------------------------------------------------\n// Face/profile helpers\n// ---------------------------------------------------------------------------\n\n/** 构造位于 pos、沿 dir 轴的 cylinder（radius × height），返回句柄（调用方负责释放/消费）。 */\nfunction cylinderAt(\n  kernel: ReturnType<typeof getBrepApi>,\n  radius: number,\n  height: number,\n  pos: [number, number, number],\n  dir: [number, number, number],\n): BrepHandle {\n  const base = kernel.makeCylinder(radius, height)\n  const m = composeAffine(rotationZTo(dir), translationMatrix(pos))\n  const placed = kernel.located(base, m as number[])\n  kernel.release(base)\n  return placed\n}\n\n/** 解析目标面：省略 → 最高 Z 面（faceCenter 最大）；Face（{wrapped}）→ 直取。 */\nfunction resolveTargetFace(\n  kernel: ReturnType<typeof getBrepApi>,\n  shape: BrepHandle,\n  faceSpec: unknown,\n): Result<BrepHandle> {\n  if (faceSpec === undefined || faceSpec === null) {\n    const faces = kernel.getSubShapes(shape, 'face')\n    if (faces.length === 0) {\n      return err(validationError('COMPOUND_NO_FACES', 'compoundOps: shape has no faces'))\n    }\n    let best = faces[0]\n    let bestZ = kernel.surfaceCenterOfMass(best).z\n    for (let i = 1; i < faces.length; i++) {\n      const z = kernel.surfaceCenterOfMass(faces[i]).z\n      if (z > bestZ) {\n        best = faces[i]\n        bestZ = z\n      }\n    }\n    return ok(best)\n  }\n  if (typeof faceSpec === 'object') {\n    try {\n      return ok(brepHandleOf(faceSpec))\n    } catch {\n      return err(\n        validationError('COMPOUND_FACE_NOT_FOUND', 'compoundOps: face spec must be a face handle or omitted'),\n      )\n    }\n  }\n  return err(validationError('COMPOUND_FACE_NOT_FOUND', 'compoundOps: face spec must be a face handle or omitted'))\n}\n\n/** 面法向（uv 中心）。 */\nfunction faceNormalAt(kernel: ReturnType<typeof getBrepApi>, face: BrepHandle): Vec3 {\n  const b = kernel.uvBounds(face)\n  const u = 0.5 * (b.uMin + b.uMax)\n  const v = 0.5 * (b.vMin + b.vMax)\n  const n = kernel.surfaceNormal(face, u, v)\n  return [n.x, n.y, n.z]\n}\n\n/** 面质心。 */\nfunction faceCenterAt(kernel: ReturnType<typeof getBrepApi>, face: BrepHandle): Vec3 {\n  const c = kernel.surfaceCenterOfMass(face)\n  return [c.x, c.y, c.z]\n}\n\n/** profile（wire 句柄）→ face handle。 */\nfunction profileToFace(kernel: ReturnType<typeof getBrepApi>, profile: unknown): Result<BrepHandle> {\n  try {\n    const wire = brepHandleOf(profile)\n    return ok(kernel.makeFace(wire))\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(\n      validationError('COMPOUND_PROFILE_INVALID', `compoundOps: profile must be a wire handle (${raw})`),\n    )\n  }\n}\n\n// ---------------------------------------------------------------------------\n// drill — cut a cylinder through the shape\n// ---------------------------------------------------------------------------\n\n/**\n * Drill — cut a cylinder through the shape.\n *\n * @param args - Resolved arguments (shape, drill options).\n * @returns The drilled shape as a `BrepHandle`.\n */\nexport function drillBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, options] = resolveArgs(args, DRILL_PARAMS)\n  const kernel = getBrepApi()\n  const s = brepHandleOf(shape)\n  const { at, radius, axis, depth } = options as {\n    at: Vec3 | [number, number]\n    radius: number\n    axis?: Vec3\n    depth?: number\n  }\n  const ax = (axis ?? [0, 0, 1]) as Vec3\n\n  if (radius <= 0) return err(validationError('DRILL_INVALID_RADIUS', 'Drill radius must be positive'))\n  if (vecIsZero(ax)) return err(validationError('DRILL_ZERO_AXIS', 'Drill axis cannot be zero'))\n\n  const dir = vecNormalize([ax[0], ax[1], ax[2]])\n  const pos: [number, number, number] = at.length === 2 ? [at[0], at[1], 0] : [at[0], at[1], at[2]]\n\n  let tool: BrepHandle | undefined\n  try {\n    if (depth !== undefined) {\n      tool = cylinderAt(kernel, radius, depth, pos, dir)\n    } else {\n      // Through-all: project bounding box onto the drill axis, add overshoot.\n      const bb = kernel.getBoundingBox(s)\n      const corners: [number, number, number][] = [\n        [bb.xmin, bb.ymin, bb.zmin],\n        [bb.xmax, bb.ymin, bb.zmin],\n        [bb.xmin, bb.ymax, bb.zmin],\n        [bb.xmax, bb.ymax, bb.zmin],\n        [bb.xmin, bb.ymin, bb.zmax],\n        [bb.xmax, bb.ymin, bb.zmax],\n        [bb.xmin, bb.ymax, bb.zmax],\n        [bb.xmax, bb.ymax, bb.zmax],\n      ]\n      let tMin = Infinity\n      let tMax = -Infinity\n      for (const c of corners) {\n        const t = (c[0] - pos[0]) * dir[0] + (c[1] - pos[1]) * dir[1] + (c[2] - pos[2]) * dir[2]\n        if (t < tMin) tMin = t\n        if (t > tMax) tMax = t\n      }\n      const overshoot = 1\n      tMin -= overshoot\n      tMax += overshoot\n      const d = tMax - tMin\n      const startPos: [number, number, number] = [\n        pos[0] + dir[0] * tMin,\n        pos[1] + dir[1] * tMin,\n        pos[2] + dir[2] * tMin,\n      ]\n      tool = cylinderAt(kernel, radius, d, startPos, dir)\n    }\n    return ok(kernel.cut(s, tool))\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('DRILL_FAILED', `drill failed: ${raw}`, e))\n  } finally {\n    if (tool !== undefined) kernel.release(tool)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// pocket — extrude a profile inward and cut\n// ---------------------------------------------------------------------------\n\n/**\n * Pocket — extrude a profile inward and cut it from the shape.\n *\n * @param args - Resolved arguments (shape, pocket options).\n * @returns The pocketed shape as a `BrepHandle`.\n */\nexport function pocketBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, options] = resolveArgs(args, POCKET_PARAMS)\n  const kernel = getBrepApi()\n  const s = brepHandleOf(shape)\n  const { profile, depth } = options as { profile: unknown; depth: number; face?: unknown }\n\n  if (depth <= 0) return err(validationError('POCKET_INVALID_DEPTH', 'Pocket depth must be positive'))\n\n  const faceRes = resolveTargetFace(kernel, s, (options as { face?: unknown }).face)\n  if (isErr(faceRes)) return faceRes\n  const face = faceRes.value\n  const normal = faceNormalAt(kernel, face)\n  const center = faceCenterAt(kernel, face)\n\n  const profRes = profileToFace(kernel, profile)\n  if (isErr(profRes)) return profRes\n  const profFace = profRes.value\n\n  let positioned: BrepHandle | undefined\n  let tool: BrepHandle | undefined\n  try {\n    positioned = kernel.translate(profFace, center[0], center[1], center[2])\n    kernel.release(profFace)\n    const nn = vecNormalize([normal[0], normal[1], normal[2]])\n    const extDir = vecScale(nn, -depth)\n    tool = kernel.extrude(positioned, extDir[0], extDir[1], extDir[2])\n    kernel.release(positioned)\n    return ok(kernel.cut(s, tool))\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('POCKET_FAILED', `pocket failed: ${raw}`, e))\n  } finally {\n    if (tool !== undefined) kernel.release(tool)\n    if (positioned !== undefined) kernel.release(positioned)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// boss — extrude a profile outward and fuse\n// ---------------------------------------------------------------------------\n\n/**\n * Boss — extrude a profile outward and fuse it onto the shape.\n *\n * @param args - Resolved arguments (shape, boss options).\n * @returns The shape with the boss fused as a `BrepHandle`.\n */\nexport function bossBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, options] = resolveArgs(args, BOSS_PARAMS)\n  const kernel = getBrepApi()\n  const s = brepHandleOf(shape)\n  const { profile, height } = options as { profile: unknown; height: number; face?: unknown }\n\n  if (height <= 0) return err(validationError('BOSS_INVALID_HEIGHT', 'Boss height must be positive'))\n\n  const faceRes = resolveTargetFace(kernel, s, (options as { face?: unknown }).face)\n  if (isErr(faceRes)) return faceRes\n  const face = faceRes.value\n  const normal = faceNormalAt(kernel, face)\n  const center = faceCenterAt(kernel, face)\n\n  const profRes = profileToFace(kernel, profile)\n  if (isErr(profRes)) return profRes\n  const profFace = profRes.value\n\n  let positioned: BrepHandle | undefined\n  let tool: BrepHandle | undefined\n  try {\n    positioned = kernel.translate(profFace, center[0], center[1], center[2])\n    kernel.release(profFace)\n    const nn = vecNormalize([normal[0], normal[1], normal[2]])\n    const extDir = vecScale(nn, height)\n    tool = kernel.extrude(positioned, extDir[0], extDir[1], extDir[2])\n    kernel.release(positioned)\n    return ok(kernel.fuse(s, tool))\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('BOSS_FAILED', `boss failed: ${raw}`, e))\n  } finally {\n    if (tool !== undefined) kernel.release(tool)\n    if (positioned !== undefined) kernel.release(positioned)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// mirrorJoin — mirror and fuse in one step\n// ---------------------------------------------------------------------------\n\n/**\n * Mirror the shape across a plane and fuse the mirrored copy to the original.\n *\n * @param args - Resolved arguments (shape, mirror options).\n * @returns The shape joined with its mirror as a `BrepHandle`.\n */\nexport function mirrorJoinBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, options] = resolveArgs(args, MIRROR_JOIN_PARAMS)\n  const kernel = getBrepApi()\n  const s = brepHandleOf(shape)\n  const { normal, at } = (options ?? {}) as { normal?: Vec3; at?: Vec3 }\n  const n = (normal ?? [1, 0, 0]) as Vec3\n\n  if (vecIsZero(n)) return err(validationError('MIRROR_ZERO_NORMAL', 'Mirror plane normal cannot be zero'))\n\n  const origin = (at ?? [0, 0, 0]) as Vec3\n  let mirrored: BrepHandle | undefined\n  try {\n    mirrored = kernel.mirror(\n      s,\n      { x: origin[0], y: origin[1], z: origin[2] },\n      { x: n[0], y: n[1], z: n[2] },\n    )\n    return ok(kernel.fuse(s, mirrored))\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('MIRROR_JOIN_FAILED', `mirrorJoin failed: ${raw}`, e))\n  } finally {\n    if (mirrored !== undefined) kernel.release(mirrored)\n  }\n}\n"]}

package/dist/api/brep-operations/healingFns.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Self-hosted compat-op implementations — shape healing family
+ * (core-decouple Phase 3, §5.4).
+ *
+ * @platform occt
+ *
+ * Brep-shaped implementations for `heal`, `healSolid`, `fixShape`, `autoHeal`,
+ * `fixSelfIntersection`, `simplify`. Semantics mirror brepjs
+ * `topology/healingFns.ts` / `topology/shapeFns.ts` (error codes preserved),
+ * with the brepjs object model (castResultShape / cache invalidation) dropped:
+ * occt-wasm handles only. Platform-native methods (`healFace`, `healWire`,
+ * `simplify`, `fixSelfIntersection`) go through `getOcctKernel()` (D3).
+ */
+import type { BrepHandle } from '../../brep/engine/types.js';
+import { type Result } from '../../result/result.js';
+/** Heal a solid (`ShapeFix_Solid`); error codes match brepjs `healSolid`.
+ *
+ * @param args - Resolved arguments (solid shape).
+ * @returns The healed solid as a `BrepHandle`.
+ */
+export declare function healSolidBrep(...args: unknown[]): Result<BrepHandle>;
+/**
+ * Dispatch healing by shape type (solid/face/wire); other types pass through
+ * unchanged (brepjs `heal`).
+ *
+ * @param args - Resolved arguments (shape).
+ * @returns The healed shape as a `BrepHandle`.
+ */
+export declare function healBrep(...args: unknown[]): Result<BrepHandle>;
+/** General-purpose repair (`ShapeFix_Shape`).
+ *
+ * @param args - Resolved arguments (shape).
+ * @returns The repaired shape as a `BrepHandle`.
+ */
+export declare function fixShapeBrep(...args: unknown[]): Result<BrepHandle>;
+/** Fix wire self-intersection (occt platform method).
+ *
+ * @param args - Resolved arguments (wire shape).
+ * @returns The fixed wire as a `BrepHandle`.
+ */
+export declare function fixSelfIntersectionBrep(...args: unknown[]): Result<BrepHandle>;
+/** Simplify a shape (occt platform method).
+ *
+ * @param args - Resolved arguments (shape).
+ * @returns The simplified shape as a `BrepHandle`.
+ */
+export declare function simplifyBrep(...args: unknown[]): Result<BrepHandle>;
+interface HealingStepDiagnostic {
+    readonly name: string;
+    readonly attempted: boolean;
+    readonly succeeded: boolean;
+    readonly detail?: string;
+}
+interface HealingReport {
+    readonly isValid: boolean;
+    readonly alreadyValid: boolean;
+    readonly wiresHealed: number;
+    readonly facesHealed: number;
+    readonly solidHealed: boolean;
+    readonly steps: ReadonlyArray<string>;
+    readonly diagnostics: ReadonlyArray<HealingStepDiagnostic>;
+}
+/**
+ * Auto-heal pipeline (brepjs `autoHeal`): short-circuit on valid, optional
+ * sew / wire self-intersection pass, shape-level heal, sub-shape delta report.
+ *
+ * The returned record carries the healed shape as a raw BREP handle; the
+ * projection wraps it via `fromHandle` so callers receive a faijs Shape.
+ *
+ * @param args - Resolved arguments (shape, auto-heal options).
+ * @returns The healed shape with a diagnostic healing report.
+ */
+export declare function autoHealBrep(...args: unknown[]): Result<{
+    shape: BrepHandle;
+    report: HealingReport;
+}>;
+export {};
+//# sourceMappingURL=healingFns.d.ts.map

package/dist/api/brep-operations/healingFns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healingFns.d.ts","sourceRoot":"","sources":["../../../src/api/brep-operations/healingFns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAGzD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAqB1D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAoBpE;AA4BD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAQ/D;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAQnE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAW9E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAOnE;AAMD,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAUD,UAAU,aAAa;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACrC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAA;CAC3D;AAOD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC,CA8HrG"}