@faicad/faijs 0.31.1 → 0.32.3

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

@@ -1,300 +0,0 @@
-/**
- * Self-hosted compat-op implementations — compound feature family
- * (core-decouple Phase 3, §5.4; drill / pocket / boss / mirrorJoin).
- *
- * @platform occt
- *
- * Semantics mirror brepjs `operations/compoundOpsFns.ts` with the brepjs
- * object model dropped:
- *  - `options.face` supports an omitted default (highest-Z face) or an already
- *    constructed brepjs Face (`{ wrapped }`); FinderFn (brepjs finder DSL) is
- *    not supported after selfhosting.
- *  - `options.profile` must be an already constructed brepjs Wire (`{ wrapped }`);
- *    DrawingLike (sketchOnPlane) is not supported (sketch DSL is the brepjs
- *    compat surface, 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 (brepjs vecOps)
-// ---------------------------------------------------------------------------
-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 brepjs Face handle or omitted'));
-        }
-    }
-    return err(validationError('COMPOUND_FACE_NOT_FOUND', 'compoundOps: face spec must be a brepjs Face handle or omitted'));
-}
-/** 面法向（uv 中心，brepjs normalAt）。 */
-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];
-}
-/** 面质心（brepjs faceCenter）。 */
-function faceCenterAt(kernel, face) {
-    const c = kernel.surfaceCenterOfMass(face);
-    return [c.x, c.y, c.z];
-}
-/** profile（brepjs 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 brepjs Wire (${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-mirror/compoundFns.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"compoundFns.js","sourceRoot":"","sources":["../../../src/api/brep-mirror/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 * Semantics mirror brepjs `operations/compoundOpsFns.ts` with the brepjs\n * object model dropped:\n *  - `options.face` supports an omitted default (highest-Z face) or an already\n *    constructed brepjs Face (`{ wrapped }`); FinderFn (brepjs finder DSL) is\n *    not supported after selfhosting.\n *  - `options.profile` must be an already constructed brepjs Wire (`{ wrapped }`);\n *    DrawingLike (sketchOnPlane) is not supported (sketch DSL is the brepjs\n *    compat surface, 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 '../brepjs-compat/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 (brepjs vecOps)\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 brepjs Face handle or omitted'),\n      )\n    }\n  }\n  return err(validationError('COMPOUND_FACE_NOT_FOUND', 'compoundOps: face spec must be a brepjs Face handle or omitted'))\n}\n\n/** 面法向（uv 中心，brepjs normalAt）。 */\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/** 面质心（brepjs faceCenter）。 */\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（brepjs 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 brepjs Wire (${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-mirror/healingFns.d.ts

@@ -1,78 +0,0 @@
-/**
- * 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-mirror/healingFns.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"healingFns.d.ts","sourceRoot":"","sources":["../../../src/api/brep-mirror/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"}