@faicad/faijs 0.16.0 → 0.17.0

package/dist/api/brep-mirror/booleanFns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"booleanFns.js","sourceRoot":"","sources":["../../../src/api/brep-mirror/booleanFns.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Self-hosted compat-op implementations — boolean / section\n * (core-decouple Phase 3, §5.4).\n *\n * @platform occt\n *\n * Brep-shaped implementation for `section`. Semantics mirror vendored\n * `topology/booleanFns.ts` `section` (NULL_SHAPE_INPUT guard, plane resolution\n * from PlaneInput, kernel section via a planar tool, compound result) using the\n * L1 `sectionByPlane` (occt-wasm `BRepAlgoAPI_Section` + edge/wire downcast).\n */\n\nimport type { BrepHandle } from '../../brep/engine/types'\nimport { getBrepApi } from '../../brep/handle-bridge'\nimport { getOcctKernel } from '../../occt-kernel/occtKernel'\nimport { ok, err, 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 { PlaneInput } from '../brepjs-compat/planeTypes'\nimport { resolvePlane } from '../brepjs-compat/planeOps'\nimport { brepHandleOf } from './brepHelpers'\n\nconst SECTION_PARAMS = { name: 'section', params: ['shape', 'plane'], formClass: 'A' as FormClass }\n\n/**\n * Section a shape with a plane (vendored `section(shape, plane, options?)`).\n *\n * The plane is resolved from `PlaneInput` (named plane or explicit Plane); the\n * L1 `sectionByPlane` builds the planar tool, runs `BRepAlgoAPI_Section`, and\n * downcasts the result compound to edge/wire handles, which are re-combined\n * into a compound to match the vendored product shape. `options` (approximation\n * / planeSize) is accepted for signature compatibility; the occt native\n * section uses its default approximation.\n *\n * @param args - Resolved arguments (shape, plane).\n * @returns The section result compound as a `BrepHandle`.\n */\nexport function sectionBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, plane] = resolveArgs(args, SECTION_PARAMS)\n  const kernel = getBrepApi()\n  const h = brepHandleOf(shape)\n  if (getOcctKernel().isNull(h as never)) {\n    return err(validationError('NULL_SHAPE_INPUT', 'section: shape is a null shape'))\n  }\n  const resolved = resolvePlane(plane as PlaneInput)\n  if (!resolved.ok) return resolved\n  const p = resolved.value\n  try {\n    const edges = kernel.sectionByPlane(\n      h,\n      { x: p.origin[0], y: p.origin[1], z: p.origin[2] },\n      { x: p.zDir[0], y: p.zDir[1], z: p.zDir[2] },\n    )\n    return ok(kernel.makeCompound(edges))\n  } catch (e) {\n    return err(\n      kernelError(\n        'SECTION_FAILED',\n        `Section with plane failed: ${e instanceof Error ? e.message : String(e)}`,\n        e,\n        { operation: 'section' },\n        'The cutting plane may not intersect the shape. Verify plane position relative to shape bounds.',\n      ),\n    )\n  }\n}\n\n\n// ---------------------------------------------------------------------------\n// fuse — union two shapes (vendored topology/booleanFns.ts#fuse)\n// ---------------------------------------------------------------------------\n\nconst FUSE_PARAMS = { name: 'fuse', params: ['a', 'b', 'options'], formClass: 'A' as FormClass }\n\n/**\n * Fuse (union) two shapes into one.\n * @param args - Resolved arguments (a, b).\n * @returns The fused shape as a `BrepHandle`.\n */\nexport function fuseBrep(...args: unknown[]): Result<BrepHandle> {\n  const [a, b] = resolveArgs(args, FUSE_PARAMS)\n  const kernel = getBrepApi()\n  const ha = brepHandleOf(a)\n  const hb = brepHandleOf(b)\n  try {\n    return ok(kernel.fuse(ha, hb))\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('FUSE_FAILED', `fuse failed: ${raw}`, e))\n  }\n}\n\n// ---------------------------------------------------------------------------\n// split — split a shape with tool(s) (vendored topology/api.ts#split → booleanFns.split)\n// ---------------------------------------------------------------------------\n\nconst SPLIT_PARAMS = { name: 'split', params: ['shape', 'tools'], formClass: 'A' as FormClass }\n\n/**\n * Split a shape with one or more tool shapes.\n * @param args - Resolved arguments (shape, tools).\n * @returns The split result as a `BrepHandle`.\n */\nexport function splitBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, toolsRaw] = resolveArgs(args, SPLIT_PARAMS)\n  const h = brepHandleOf(shape)\n  const tools = (toolsRaw ?? []) as unknown[]\n  if (tools.length === 0) return ok(h)\n  const toolHandles = tools.map((t) => brepHandleOf(t))\n  try {\n    const result = getOcctKernel().split(h as never, toolHandles as never)\n    return ok(result as unknown as BrepHandle)\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(\n      kernelError(\n        'SPLIT_FAILED',\n        `Split operation failed on ${tools.length} tool(s): ${raw}`,\n        e,\n        { operation: 'split', toolCount: tools.length },\n      ),\n    )\n  }\n}\n"]}

package/dist/api/brep-mirror/brepHelpers.d.ts

@@ -0,0 +1,55 @@
+/**
+ * brep-mirror helpers — shared utilities for self-hosted compat-op implementations
+ * (core-decouple Phase 3, §5.4).
+ *
+ * @module
+ */
+import type { BrepHandle } from '../../brep/engine/types.js';
+/**
+ * Extract a core BREP handle from an op argument.
+ *
+ * Accepts (in order of preference):
+ *  - a raw branded number (BrepHandle),
+ *  - a brepjs-style kernel handle object `{ id }`,
+ *  - a brepjs-style shape wrapper `{ wrapped }`,
+ *  - a faijs Shape whose brep slot carries the handle.
+ *
+ * @param v - the op argument (positional, post D11 normalization).
+ * @returns the numeric BREP handle.
+ * @throws when no handle can be extracted (E_BREP_INPUT).
+ */
+export declare function brepHandleOf(v: unknown): BrepHandle;
+/** Identity 3×4 row-major affine matrix (12 elements). */
+export declare const IDENTITY_3X4: readonly number[];
+/**
+ * Compose two 3×4 row-major affine matrices: `a` applied first, then `b`
+ * (column-vector convention: p' = b·(a·p)).
+ *
+ * @param a - first matrix (12 elements).
+ * @param b - second matrix (12 elements).
+ * @returns the composed 12-element matrix.
+ */
+export declare function composeAffine(a: readonly number[], b: readonly number[]): number[];
+/**
+ * 3×4 translation matrix for a vector.
+ * @param v - Translation vector.
+ * @returns The 3×4 translation matrix.
+ */
+export declare function translationMatrix(v: readonly [number, number, number]): number[];
+/**
+ * 3×4 rotation matrix rotating `angleDeg` degrees around the axis (unit-ized)
+ * passing through `center`. Rodrigues formula, column-vector convention.
+ *
+ * @param axis - Rotation axis (unit-ized internally).
+ * @param center - Point the rotation passes through.
+ * @param angleDeg - Rotation angle in degrees.
+ * @returns The 3×4 rotation matrix.
+ */
+export declare function rotationMatrix(axis: readonly [number, number, number], center: readonly [number, number, number], angleDeg: number): number[];
+/**
+ * 3×4 matrix rotating the +Z axis onto `axis` (unit-ized), origin-centered.
+ * @param axis - Target axis direction.
+ * @returns The 3×4 rotation matrix.
+ */
+export declare function rotationZTo(axis: readonly [number, number, number]): number[];
+//# sourceMappingURL=brepHelpers.d.ts.map

package/dist/api/brep-mirror/brepHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brepHelpers.d.ts","sourceRoot":"","sources":["../../../src/api/brep-mirror/brepHelpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAGzD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,UAAU,CAUnD;AAED,0DAA0D;AAC1D,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAAyC,CAAA;AAEnF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAWlF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAEhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACvC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACzC,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,CA4BV;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAsB7E"}

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

@@ -0,0 +1,131 @@
+/**
+ * brep-mirror helpers — shared utilities for self-hosted compat-op implementations
+ * (core-decouple Phase 3, §5.4).
+ *
+ * @module
+ */
+import { brepOf } from '../../shape.js';
+/**
+ * Extract a core BREP handle from an op argument.
+ *
+ * Accepts (in order of preference):
+ *  - a raw branded number (BrepHandle),
+ *  - a brepjs-style kernel handle object `{ id }`,
+ *  - a brepjs-style shape wrapper `{ wrapped }`,
+ *  - a faijs Shape whose brep slot carries the handle.
+ *
+ * @param v - the op argument (positional, post D11 normalization).
+ * @returns the numeric BREP handle.
+ * @throws when no handle can be extracted (E_BREP_INPUT).
+ */
+export function brepHandleOf(v) {
+    if (typeof v === 'number')
+        return v;
+    if (v !== null && typeof v === 'object') {
+        const rec = v;
+        if (typeof rec.id === 'number')
+            return rec.id;
+        if ('wrapped' in rec)
+            return brepHandleOf(rec.wrapped);
+        const solid = brepOf(v);
+        if (typeof solid === 'number')
+            return solid;
+    }
+    throw new Error('[brep-mirror] E_BREP_INPUT: argument carries no BREP handle');
+}
+/** Identity 3×4 row-major affine matrix (12 elements). */
+export const IDENTITY_3X4 = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0];
+/**
+ * Compose two 3×4 row-major affine matrices: `a` applied first, then `b`
+ * (column-vector convention: p' = b·(a·p)).
+ *
+ * @param a - first matrix (12 elements).
+ * @param b - second matrix (12 elements).
+ * @returns the composed 12-element matrix.
+ */
+export function composeAffine(a, b) {
+    const out = new Array(12);
+    for (let r = 0; r < 3; r++) {
+        const a0 = a[r * 4], a1 = a[r * 4 + 1], a2 = a[r * 4 + 2], a3 = a[r * 4 + 3];
+        for (let c = 0; c < 3; c++)
+            out[r * 4 + c] = a0 * b[c] + a1 * b[4 + c] + a2 * b[8 + c];
+        out[r * 4 + 3] = a0 * b[3] + a1 * b[7] + a2 * b[11] + a3;
+    }
+    return out;
+}
+/**
+ * 3×4 translation matrix for a vector.
+ * @param v - Translation vector.
+ * @returns The 3×4 translation matrix.
+ */
+export function translationMatrix(v) {
+    return [1, 0, 0, v[0], 0, 1, 0, v[1], 0, 0, 1, v[2]];
+}
+/**
+ * 3×4 rotation matrix rotating `angleDeg` degrees around the axis (unit-ized)
+ * passing through `center`. Rodrigues formula, column-vector convention.
+ *
+ * @param axis - Rotation axis (unit-ized internally).
+ * @param center - Point the rotation passes through.
+ * @param angleDeg - Rotation angle in degrees.
+ * @returns The 3×4 rotation matrix.
+ */
+export function rotationMatrix(axis, center, angleDeg) {
+    let [ux, uy, uz] = axis;
+    const len = Math.hypot(ux, uy, uz);
+    if (len < 1e-12)
+        throw new Error('[brep-mirror] rotation: zero-length axis');
+    ux /= len;
+    uy /= len;
+    uz /= len;
+    const th = (angleDeg * Math.PI) / 180;
+    const c = Math.cos(th);
+    const s = Math.sin(th);
+    const t = 1 - c;
+    const [cx, cy, cz] = center;
+    const r00 = t * ux * ux + c;
+    const r01 = t * ux * uy - s * uz;
+    const r02 = t * ux * uz + s * uy;
+    const r10 = t * ux * uy + s * uz;
+    const r11 = t * uy * uy + c;
+    const r12 = t * uy * uz - s * ux;
+    const r20 = t * ux * uz - s * uy;
+    const r21 = t * uy * uz + s * ux;
+    const r22 = t * uz * uz + c;
+    return [
+        r00, r01, r02, cx - r00 * cx - r01 * cy - r02 * cz,
+        r10, r11, r12, cy - r10 * cx - r11 * cy - r12 * cz,
+        r20, r21, r22, cz - r20 * cx - r21 * cy - r22 * cz,
+    ];
+}
+/**
+ * 3×4 matrix rotating the +Z axis onto `axis` (unit-ized), origin-centered.
+ * @param axis - Target axis direction.
+ * @returns The 3×4 rotation matrix.
+ */
+export function rotationZTo(axis) {
+    const [x, y, z] = axis;
+    const len = Math.hypot(x, y, z);
+    if (len < 1e-12)
+        throw new Error('[brep-mirror] rotationZTo: zero-length axis');
+    const nx = x / len;
+    const ny = y / len;
+    const nz = z / len;
+    if (Math.abs(nz - 1) < 1e-9)
+        return [...IDENTITY_3X4];
+    // Rodrigues rotation from [0,0,1] to [nx,ny,nz].
+    const cross = [-ny, nx, 0]; // [0,0,1] × axis
+    const crossLen = Math.hypot(...cross);
+    const kx = cross[0] / crossLen;
+    const ky = cross[1] / crossLen;
+    const kz = cross[2] / crossLen;
+    const cosA = nz;
+    const sinA = Math.hypot(nx, ny);
+    const t = 1 - cosA;
+    return [
+        t * kx * kx + cosA, t * kx * ky - sinA * kz, t * kx * kz + sinA * ky, 0,
+        t * kx * ky + sinA * kz, t * ky * ky + cosA, t * ky * kz - sinA * kx, 0,
+        t * kx * kz - sinA * ky, t * ky * kz + sinA * kx, t * kz * kz + cosA, 0,
+    ];
+}
+//# sourceMappingURL=brepHelpers.js.map

package/dist/api/brep-mirror/brepHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brepHelpers.js","sourceRoot":"","sources":["../../../src/api/brep-mirror/brepHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * brep-mirror helpers — shared utilities for self-hosted compat-op implementations\n * (core-decouple Phase 3, §5.4).\n *\n * @module\n */\n\nimport type { BrepHandle } from '../../brep/engine/types'\nimport { brepOf } from '../../shape'\n\n/**\n * Extract a core BREP handle from an op argument.\n *\n * Accepts (in order of preference):\n *  - a raw branded number (BrepHandle),\n *  - a brepjs-style kernel handle object `{ id }`,\n *  - a brepjs-style shape wrapper `{ wrapped }`,\n *  - a faijs Shape whose brep slot carries the handle.\n *\n * @param v - the op argument (positional, post D11 normalization).\n * @returns the numeric BREP handle.\n * @throws when no handle can be extracted (E_BREP_INPUT).\n */\nexport function brepHandleOf(v: unknown): BrepHandle {\n  if (typeof v === 'number') return v as BrepHandle\n  if (v !== null && typeof v === 'object') {\n    const rec = v as Record<string, unknown>\n    if (typeof rec.id === 'number') return rec.id as BrepHandle\n    if ('wrapped' in rec) return brepHandleOf(rec.wrapped)\n    const solid = brepOf(v as never)\n    if (typeof solid === 'number') return solid as BrepHandle\n  }\n  throw new Error('[brep-mirror] E_BREP_INPUT: argument carries no BREP handle')\n}\n\n/** Identity 3×4 row-major affine matrix (12 elements). */\nexport const IDENTITY_3X4: readonly number[] = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0]\n\n/**\n * Compose two 3×4 row-major affine matrices: `a` applied first, then `b`\n * (column-vector convention: p' = b·(a·p)).\n *\n * @param a - first matrix (12 elements).\n * @param b - second matrix (12 elements).\n * @returns the composed 12-element matrix.\n */\nexport function composeAffine(a: readonly number[], b: readonly number[]): number[] {\n  const out = new Array<number>(12)\n  for (let r = 0; r < 3; r++) {\n    const a0 = a[r * 4],\n      a1 = a[r * 4 + 1],\n      a2 = a[r * 4 + 2],\n      a3 = a[r * 4 + 3]\n    for (let c = 0; c < 3; c++) out[r * 4 + c] = a0 * b[c] + a1 * b[4 + c] + a2 * b[8 + c]\n    out[r * 4 + 3] = a0 * b[3] + a1 * b[7] + a2 * b[11] + a3\n  }\n  return out\n}\n\n/**\n * 3×4 translation matrix for a vector.\n * @param v - Translation vector.\n * @returns The 3×4 translation matrix.\n */\nexport function translationMatrix(v: readonly [number, number, number]): number[] {\n  return [1, 0, 0, v[0], 0, 1, 0, v[1], 0, 0, 1, v[2]]\n}\n\n/**\n * 3×4 rotation matrix rotating `angleDeg` degrees around the axis (unit-ized)\n * passing through `center`. Rodrigues formula, column-vector convention.\n *\n * @param axis - Rotation axis (unit-ized internally).\n * @param center - Point the rotation passes through.\n * @param angleDeg - Rotation angle in degrees.\n * @returns The 3×4 rotation matrix.\n */\nexport function rotationMatrix(\n  axis: readonly [number, number, number],\n  center: readonly [number, number, number],\n  angleDeg: number,\n): number[] {\n  let [ux, uy, uz] = axis\n  const len = Math.hypot(ux, uy, uz)\n  if (len < 1e-12) throw new Error('[brep-mirror] rotation: zero-length axis')\n  ux /= len\n  uy /= len\n  uz /= len\n  const th = (angleDeg * Math.PI) / 180\n  const c = Math.cos(th)\n  const s = Math.sin(th)\n  const t = 1 - c\n  const [cx, cy, cz] = center\n\n  const r00 = t * ux * ux + c\n  const r01 = t * ux * uy - s * uz\n  const r02 = t * ux * uz + s * uy\n  const r10 = t * ux * uy + s * uz\n  const r11 = t * uy * uy + c\n  const r12 = t * uy * uz - s * ux\n  const r20 = t * ux * uz - s * uy\n  const r21 = t * uy * uz + s * ux\n  const r22 = t * uz * uz + c\n\n  return [\n    r00, r01, r02, cx - r00 * cx - r01 * cy - r02 * cz,\n    r10, r11, r12, cy - r10 * cx - r11 * cy - r12 * cz,\n    r20, r21, r22, cz - r20 * cx - r21 * cy - r22 * cz,\n  ]\n}\n\n/**\n * 3×4 matrix rotating the +Z axis onto `axis` (unit-ized), origin-centered.\n * @param axis - Target axis direction.\n * @returns The 3×4 rotation matrix.\n */\nexport function rotationZTo(axis: readonly [number, number, number]): number[] {\n  const [x, y, z] = axis\n  const len = Math.hypot(x, y, z)\n  if (len < 1e-12) throw new Error('[brep-mirror] rotationZTo: zero-length axis')\n  const nx = x / len\n  const ny = y / len\n  const nz = z / len\n  if (Math.abs(nz - 1) < 1e-9) return [...IDENTITY_3X4]\n  // Rodrigues rotation from [0,0,1] to [nx,ny,nz].\n  const cross = [-ny, nx, 0] // [0,0,1] × axis\n  const crossLen = Math.hypot(...cross)\n  const kx = cross[0] / crossLen\n  const ky = cross[1] / crossLen\n  const kz = cross[2] / crossLen\n  const cosA = nz\n  const sinA = Math.hypot(nx, ny)\n  const t = 1 - cosA\n  return [\n    t * kx * kx + cosA, t * kx * ky - sinA * kz, t * kx * kz + sinA * ky, 0,\n    t * kx * ky + sinA * kz, t * ky * ky + cosA, t * ky * kz - sinA * kx, 0,\n    t * kx * kz - sinA * ky, t * ky * kz + sinA * kx, t * kz * kz + cosA, 0,\n  ]\n}\n"]}

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

@@ -0,0 +1,47 @@
+/**
+ * Self-hosted compat-op implementations — compound feature family
+ * (core-decouple Phase 3, §5.4; drill / pocket / boss / mirrorJoin).
+ *
+ * @platform occt
+ *
+ * Semantics mirror vendored `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 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-mirror/compoundFns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compoundFns.d.ts","sourceRoot":"","sources":["../../../src/api/brep-mirror/compoundFns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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-mirror/compoundFns.js

@@ -0,0 +1,300 @@
+/**
+ * Self-hosted compat-op implementations — compound feature family
+ * (core-decouple Phase 3, §5.4; drill / pocket / boss / mirrorJoin).
+ *
+ * @platform occt
+ *
+ * Semantics mirror vendored `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 (vendored 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 中心，vendored 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];
+}
+/** 面质心（vendored 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

@@ -0,0 +1 @@
+{"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 vendored `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 (vendored 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 中心，vendored 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/** 面质心（vendored 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"]}