@faicad/faijs 0.16.1 → 0.18.0

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

@@ -0,0 +1,40 @@
+/**
+ * Self-hosted compat-op implementations — boolean / section
+ * (core-decouple Phase 3, §5.4).
+ *
+ * @platform occt
+ *
+ * Brep-shaped implementation for `section`. Semantics mirror vendored
+ * `topology/booleanFns.ts` `section` (NULL_SHAPE_INPUT guard, plane resolution
+ * from PlaneInput, kernel section via a planar tool, compound result) using the
+ * L1 `sectionByPlane` (occt-wasm `BRepAlgoAPI_Section` + edge/wire downcast).
+ */
+import type { BrepHandle } from '../../brep/engine/types.js';
+import { type Result } from '../../result/result.js';
+/**
+ * Section a shape with a plane (vendored `section(shape, plane, options?)`).
+ *
+ * The plane is resolved from `PlaneInput` (named plane or explicit Plane); the
+ * L1 `sectionByPlane` builds the planar tool, runs `BRepAlgoAPI_Section`, and
+ * downcasts the result compound to edge/wire handles, which are re-combined
+ * into a compound to match the vendored product shape. `options` (approximation
+ * / planeSize) is accepted for signature compatibility; the occt native
+ * section uses its default approximation.
+ *
+ * @param args - Resolved arguments (shape, plane).
+ * @returns The section result compound as a `BrepHandle`.
+ */
+export declare function sectionBrep(...args: unknown[]): Result<BrepHandle>;
+/**
+ * Fuse (union) two shapes into one.
+ * @param args - Resolved arguments (a, b).
+ * @returns The fused shape as a `BrepHandle`.
+ */
+export declare function fuseBrep(...args: unknown[]): Result<BrepHandle>;
+/**
+ * Split a shape with one or more tool shapes.
+ * @param args - Resolved arguments (shape, tools).
+ * @returns The split result as a `BrepHandle`.
+ */
+export declare function splitBrep(...args: unknown[]): Result<BrepHandle>;
+//# sourceMappingURL=booleanFns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"booleanFns.d.ts","sourceRoot":"","sources":["../../../src/api/brep-mirror/booleanFns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAGzD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAU1D;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAiClE;AASD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAW/D;AAQD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAoBhE"}

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

@@ -0,0 +1,104 @@
+/**
+ * Self-hosted compat-op implementations — boolean / section
+ * (core-decouple Phase 3, §5.4).
+ *
+ * @platform occt
+ *
+ * Brep-shaped implementation for `section`. Semantics mirror vendored
+ * `topology/booleanFns.ts` `section` (NULL_SHAPE_INPUT guard, plane resolution
+ * from PlaneInput, kernel section via a planar tool, compound result) using the
+ * L1 `sectionByPlane` (occt-wasm `BRepAlgoAPI_Section` + edge/wire downcast).
+ */
+import { getBrepApi } from '../../brep/handle-bridge.js';
+import { getOcctKernel } from '../../occt-kernel/occtKernel.js';
+import { ok, err } from '../../result/result.js';
+import { kernelError } from '../../result/errors.js';
+import { resolveArgs } from '../internal/dual-form-args.js';
+import { resolvePlane } from '../brepjs-compat/planeOps.js';
+import { brepHandleOf } from './brepHelpers.js';
+const SECTION_PARAMS = { name: 'section', params: ['shape', 'plane'], formClass: 'A' };
+/**
+ * Section a shape with a plane (vendored `section(shape, plane, options?)`).
+ *
+ * The plane is resolved from `PlaneInput` (named plane or explicit Plane); the
+ * L1 `sectionByPlane` builds the planar tool, runs `BRepAlgoAPI_Section`, and
+ * downcasts the result compound to edge/wire handles, which are re-combined
+ * into a compound to match the vendored product shape. `options` (approximation
+ * / planeSize) is accepted for signature compatibility; the occt native
+ * section uses its default approximation.
+ *
+ * @param args - Resolved arguments (shape, plane).
+ * @returns The section result compound as a `BrepHandle`.
+ */
+export function sectionBrep(...args) {
+    const [shape, plane] = resolveArgs(args, SECTION_PARAMS);
+    const kernel = getBrepApi();
+    const h = brepHandleOf(shape);
+    // NOTE: 2026-09-26 brepkit 降级——移除 getOcctKernel().IsNull 平台耦合。
+    // 空/坏句柄由下游 sectionByPlane 内核抛错并被下方 try/catch 捕获为 SECTION_FAILED
+    // （occt 的 sectionByPlane 对空结果本就返回 []，行为等价；brepkit 对坏句柄抛
+    // "invalid solid handle"，诚实报错而非崩溃）。
+    const resolved = resolvePlane(plane);
+    if (!resolved.ok)
+        return resolved;
+    const p = resolved.value;
+    try {
+        const parts = kernel.sectionByPlane(h, { x: p.origin[0], y: p.origin[1], z: p.origin[2] }, { x: p.zDir[0], y: p.zDir[1], z: p.zDir[2] });
+        // 语义差异（如实登记）：occt sectionByPlane 返回 edge/wire 句柄组（1D 剖面线）；
+        // brepkit sectionByPlane 返回 face 句柄组（2D 剖面面）。两侧都包成 compound 产物，
+        // 下游 meshShape/wireframe 已按已知集合分发（brepkit makeCompound 对非 solid 子句柄走
+        // 虚拟 compound 路径）。
+        return ok(kernel.makeCompound(parts));
+    }
+    catch (e) {
+        return err(kernelError('SECTION_FAILED', `Section with plane failed: ${e instanceof Error ? e.message : String(e)}`, e, { operation: 'section' }, 'The cutting plane may not intersect the shape. Verify plane position relative to shape bounds.'));
+    }
+}
+// ---------------------------------------------------------------------------
+// fuse — union two shapes (vendored topology/booleanFns.ts#fuse)
+// ---------------------------------------------------------------------------
+const FUSE_PARAMS = { name: 'fuse', params: ['a', 'b', 'options'], formClass: 'A' };
+/**
+ * Fuse (union) two shapes into one.
+ * @param args - Resolved arguments (a, b).
+ * @returns The fused shape as a `BrepHandle`.
+ */
+export function fuseBrep(...args) {
+    const [a, b] = resolveArgs(args, FUSE_PARAMS);
+    const kernel = getBrepApi();
+    const ha = brepHandleOf(a);
+    const hb = brepHandleOf(b);
+    try {
+        return ok(kernel.fuse(ha, hb));
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return err(kernelError('FUSE_FAILED', `fuse failed: ${raw}`, e));
+    }
+}
+// ---------------------------------------------------------------------------
+// split — split a shape with tool(s) (vendored topology/api.ts#split → booleanFns.split)
+// ---------------------------------------------------------------------------
+const SPLIT_PARAMS = { name: 'split', params: ['shape', 'tools'], formClass: 'A' };
+/**
+ * Split a shape with one or more tool shapes.
+ * @param args - Resolved arguments (shape, tools).
+ * @returns The split result as a `BrepHandle`.
+ */
+export function splitBrep(...args) {
+    const [shape, toolsRaw] = resolveArgs(args, SPLIT_PARAMS);
+    const h = brepHandleOf(shape);
+    const tools = (toolsRaw ?? []);
+    if (tools.length === 0)
+        return ok(h);
+    const toolHandles = tools.map((t) => brepHandleOf(t));
+    try {
+        const result = getOcctKernel().split(h, toolHandles);
+        return ok(result);
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return err(kernelError('SPLIT_FAILED', `Split operation failed on ${tools.length} tool(s): ${raw}`, e, { operation: 'split', toolCount: tools.length }));
+    }
+}
+//# sourceMappingURL=booleanFns.js.map

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 } 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  // NOTE: 2026-09-26 brepkit 降级——移除 getOcctKernel().IsNull 平台耦合。\n  // 空/坏句柄由下游 sectionByPlane 内核抛错并被下方 try/catch 捕获为 SECTION_FAILED\n  // （occt 的 sectionByPlane 对空结果本就返回 []，行为等价；brepkit 对坏句柄抛\n  // \"invalid solid handle\"，诚实报错而非崩溃）。\n  const resolved = resolvePlane(plane as PlaneInput)\n  if (!resolved.ok) return resolved\n  const p = resolved.value\n  try {\n    const parts = 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    // 语义差异（如实登记）：occt sectionByPlane 返回 edge/wire 句柄组（1D 剖面线）；\n    // brepkit sectionByPlane 返回 face 句柄组（2D 剖面面）。两侧都包成 compound 产物，\n    // 下游 meshShape/wireframe 已按已知集合分发（brepkit makeCompound 对非 solid 子句柄走\n    // 虚拟 compound 路径）。\n    return ok(kernel.makeCompound(parts))\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"}