@faicad/faijs 0.29.5 → 0.31.1

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

@@ -10,7 +10,7 @@
  * faijs Shapes (or raw handles) and results are returned as BREP handles
  * (wrapped by `wrapBrepOne` → `fromHandle`).
  *
- * Semantics mirror the vendored brepjs fns (`topology/transformFns.ts`,
+ * Semantics mirror the early brepjs fns (`topology/transformFns.ts`,
  * `topology/shapeFns.ts`) with the brepjs object model (castResultShape,
  * metadata propagation, evolution tracking) dropped: occt-wasm handles only.
  */
@@ -19,7 +19,7 @@ import { type Result } from '../../result/result.js';
 /**
  * Apply a 4×4 affine matrix (OpenSCAD `multmatrix` equivalent).
  *
- * The vendored fn splits orthogonal (evolution-tracked) and non-orthogonal
+ * The brepjs fn splits orthogonal (evolution-tracked) and non-orthogonal
  * (`gp_GTrsf`) paths; the core path uses the single L1 `generalTransform`
  * (occt-wasm `gp_GTrsf`, geometrically equivalent for both classes) since
  * `applyMatrix` carries identity naming and needs no face evolution.
@@ -51,21 +51,21 @@ export declare function locateBrep(...args: unknown[]): Result<BrepHandle>;
  */
 export declare function mirrorBrep(...args: unknown[]): Result<BrepHandle>;
 /**
- * Rotate the shape around an axis (vendored topology/api.js#rotate + transformFns.ts#rotate).
+ * Rotate the shape around an axis (brepjs topology/api.js#rotate + transformFns.ts#rotate).
  *
  * @param args - Resolved arguments (shape, angle in degrees, axis options).
  * @returns The rotated shape as a `BrepHandle`.
  */
 export declare function rotateBrep(...args: unknown[]): Result<BrepHandle>;
 /**
- * Shell — hollow the shape by removing faces (vendored topology/api.js#shell + modifierFns.ts#shell).
+ * Shell — hollow the shape by removing faces (brepjs topology/api.js#shell + modifierFns.ts#shell).
  *
  * @param args - Resolved arguments (shape, faces, thickness, options).
  * @returns The shelled (hollowed) shape as a `BrepHandle`.
  */
 export declare function shellBrep(...args: unknown[]): Result<BrepHandle>;
 /**
- * Offset all faces of the shape (vendored topology/api.js#offset + modifierFns.ts#offset).
+ * Offset all faces of the shape (brepjs topology/api.js#offset + modifierFns.ts#offset).
  *
  * @param args - Resolved arguments (shape, distance, options).
  * @returns The offset shape as a `BrepHandle`.

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

@@ -10,7 +10,7 @@
  * faijs Shapes (or raw handles) and results are returned as BREP handles
  * (wrapped by `wrapBrepOne` → `fromHandle`).
  *
- * Semantics mirror the vendored brepjs fns (`topology/transformFns.ts`,
+ * Semantics mirror the early brepjs fns (`topology/transformFns.ts`,
  * `topology/shapeFns.ts`) with the brepjs object model (castResultShape,
  * metadata propagation, evolution tracking) dropped: occt-wasm handles only.
  */
@@ -47,7 +47,7 @@ const APPLY_MATRIX_PARAMS = { name: 'applyMatrix', params: ['shape', 'matrix'],
 /**
  * Apply a 4×4 affine matrix (OpenSCAD `multmatrix` equivalent).
  *
- * The vendored fn splits orthogonal (evolution-tracked) and non-orthogonal
+ * The brepjs fn splits orthogonal (evolution-tracked) and non-orthogonal
  * (`gp_GTrsf`) paths; the core path uses the single L1 `generalTransform`
  * (occt-wasm `gp_GTrsf`, geometrically equivalent for both classes) since
  * `applyMatrix` carries identity naming and needs no face evolution.
@@ -172,10 +172,10 @@ export function mirrorBrep(...args) {
     }
 }
 // ---------------------------------------------------------------------------
-// rotate — 绕轴旋转（vendored topology/api.js#rotate + transformFns.ts#rotate）// ---------------------------------------------------------------------------
+// rotate — 绕轴旋转（brepjs topology/api.js#rotate + transformFns.ts#rotate）// ---------------------------------------------------------------------------
 const ROTATE_PARAMS = { name: 'rotate', params: ['shape', 'angle', 'options'], formClass: 'A' };
 /**
- * Rotate the shape around an axis (vendored topology/api.js#rotate + transformFns.ts#rotate).
+ * Rotate the shape around an axis (brepjs topology/api.js#rotate + transformFns.ts#rotate).
  *
  * @param args - Resolved arguments (shape, angle in degrees, axis options).
  * @returns The rotated shape as a `BrepHandle`.
@@ -218,10 +218,10 @@ export function rotateBrep(...args) {
     }
 }
 // ---------------------------------------------------------------------------
-// shell — 去面掏空（vendored topology/api.js#shell + modifierFns.ts#shell）// ---------------------------------------------------------------------------
+// shell — 去面掏空（brepjs topology/api.js#shell + modifierFns.ts#shell）// ---------------------------------------------------------------------------
 const SHELL_PARAMS = { name: 'shell', params: ['shape', 'faces', 'thickness', 'options'], formClass: 'A' };
 /**
- * Shell — hollow the shape by removing faces (vendored topology/api.js#shell + modifierFns.ts#shell).
+ * Shell — hollow the shape by removing faces (brepjs topology/api.js#shell + modifierFns.ts#shell).
  *
  * @param args - Resolved arguments (shape, faces, thickness, options).
  * @returns The shelled (hollowed) shape as a `BrepHandle`.
@@ -248,10 +248,10 @@ export function shellBrep(...args) {
     }
 }
 // ---------------------------------------------------------------------------
-// offset — 全表面偏移（vendored topology/api.js#offset + modifierFns.ts#offset）// ---------------------------------------------------------------------------
+// offset — 全表面偏移（brepjs topology/api.js#offset + modifierFns.ts#offset）// ---------------------------------------------------------------------------
 const OFFSET_PARAMS = { name: 'offset', params: ['shape', 'distance', 'options'], formClass: 'A' };
 /**
- * Offset all faces of the shape (vendored topology/api.js#offset + modifierFns.ts#offset).
+ * Offset all faces of the shape (brepjs topology/api.js#offset + modifierFns.ts#offset).
  *
  * @param args - Resolved arguments (shape, distance, options).
  * @returns The offset shape as a `BrepHandle`.

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

@@ -1 +1 @@
-{"version":3,"file":"topologyFns.js","sourceRoot":"","sources":["../../../src/api/brep-mirror/topologyFns.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Self-hosted compat-op implementations — topology transform family\n * (core-decouple Phase 3, §5.4).\n *\n * @platform occt\n *\n * Each export is a \"brep-shaped\" implementation consumed by the generated\n * compat-op projection (defineOp + D11 arg normalization). Inputs are the\n * normalized positional arguments of the op's params table; shapes arrive as\n * faijs Shapes (or raw handles) and results are returned as BREP handles\n * (wrapped by `wrapBrepOne` → `fromHandle`).\n *\n * Semantics mirror the vendored brepjs fns (`topology/transformFns.ts`,\n * `topology/shapeFns.ts`) with the brepjs object model (castResultShape,\n * metadata propagation, evolution tracking) dropped: occt-wasm handles only.\n */\n\nimport type { BrepHandle } from '../../brep/engine/types'\nimport { getBrepApi } from '../../brep/handle-bridge'\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 { MatrixInput, Vec3 } from '../brepjs-compat/types'\nimport { brepHandleOf, composeAffine, IDENTITY_3X4, rotationMatrix, translationMatrix } from './brepHelpers'\nimport { getOcctKernel } from '../../occt-kernel/occtKernel'\n\nconst VALIDATION_FAILED = 'VALIDATION_FAILED'\n\n// ---------------------------------------------------------------------------\n// Matrix input parsing (vendored `parseMatrixInput` / `det3x3`)\n// ---------------------------------------------------------------------------\n\ntype Linear3x3 = readonly [number, number, number, number, number, number, number, number, number]\n\nfunction parseMatrixInput(\n  input: MatrixInput,\n): Result<{ linear: Linear3x3; translation: readonly [number, number, number] }> {\n  if ('linear' in input) {\n    return ok({ linear: input.linear, translation: input.translation })\n  }\n  const [r0, r1, r2, r3] = input\n  const TOL = 1e-10\n  if (Math.abs(r3[0]) > TOL || Math.abs(r3[1]) > TOL || Math.abs(r3[2]) > TOL || Math.abs(r3[3] - 1) > TOL) {\n    return err(\n      validationError(\n        VALIDATION_FAILED,\n        `applyMatrix: invalid bottom row [${String(r3[0])}, ${String(r3[1])}, ${String(r3[2])}, ${String(r3[3])}]. Must be [0, 0, 0, 1] for an affine transform.`,\n      ),\n    )\n  }\n  return ok({\n    linear: [r0[0], r0[1], r0[2], r1[0], r1[1], r1[2], r2[0], r2[1], r2[2]],\n    translation: [r0[3], r1[3], r2[3]],\n  })\n}\n\nfunction det3x3(m: Linear3x3): number {\n  return (\n    m[0] * (m[4] * m[8] - m[5] * m[7]) -\n    m[1] * (m[3] * m[8] - m[5] * m[6]) +\n    m[2] * (m[3] * m[7] - m[4] * m[6])\n  )\n}\n\n// ---------------------------------------------------------------------------\n// applyMatrix\n// ---------------------------------------------------------------------------\n\nconst APPLY_MATRIX_PARAMS = { name: 'applyMatrix', params: ['shape', 'matrix'], formClass: 'A' as FormClass }\n\n/**\n * Apply a 4×4 affine matrix (OpenSCAD `multmatrix` equivalent).\n *\n * The vendored fn splits orthogonal (evolution-tracked) and non-orthogonal\n * (`gp_GTrsf`) paths; the core path uses the single L1 `generalTransform`\n * (occt-wasm `gp_GTrsf`, geometrically equivalent for both classes) since\n * `applyMatrix` carries identity naming and needs no face evolution.\n *\n * @param args - Resolved arguments (shape, matrix).\n * @returns The transformed shape as a `BrepHandle`.\n */\nexport function applyMatrixBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, matrix] = resolveArgs(args, APPLY_MATRIX_PARAMS)\n  const parsed = parseMatrixInput(matrix as MatrixInput)\n  if (!parsed.ok) return parsed\n  const { linear, translation } = parsed.value\n  if (Math.abs(det3x3(linear)) < 1e-12) {\n    return err(\n      validationError(\n        VALIDATION_FAILED,\n        'applyMatrix: singular matrix (determinant ≈0). Cannot apply a non-invertible transform.',\n      ),\n    )\n  }\n  const kernel = getBrepApi()\n  try {\n    const m12 = [\n      linear[0], linear[1], linear[2], translation[0],\n      linear[3], linear[4], linear[5], translation[1],\n      linear[6], linear[7], linear[8], translation[2],\n    ]\n    // GOTCHA (2026-09-25): occt-wasm's `located`/`generalTransform` return\n    // TopLoc/GTrsf-referencing handles whose STEP export crashes\n    // (\"memory access out of bounds\") — only the affine `transform`\n    // (BRepBuilderAPI_Transform, deep-copy) is STEP-safe. A similar\n    // transform (orthogonal rows, equal lengths) is affine and goes\n    // through `transform`; genuinely non-affine matrices keep the\n    // generalTransform path (no current caller, pre-existing behavior).\n    const lin = linear as readonly [number, number, number, number, number, number, number, number, number]\n    const s0 = Math.hypot(lin[0], lin[1], lin[2])\n    const s1 = Math.hypot(lin[3], lin[4], lin[5])\n    const s2 = Math.hypot(lin[6], lin[7], lin[8])\n    const dot01 = Math.abs(lin[0] * lin[3] + lin[1] * lin[4] + lin[2] * lin[5])\n    const dot02 = Math.abs(lin[0] * lin[6] + lin[1] * lin[7] + lin[2] * lin[8])\n    const dot12 = Math.abs(lin[3] * lin[6] + lin[4] * lin[7] + lin[5] * lin[8])\n    const TOL = 1e-9\n    const similar =\n      s0 > TOL && Math.abs(s1 - s0) < TOL && Math.abs(s2 - s0) < TOL &&\n      dot01 < TOL && dot02 < TOL && dot12 < TOL\n    return ok(similar ? kernel.transform(brepHandleOf(shape), m12) : kernel.generalTransform(brepHandleOf(shape), m12))\n  } catch (e) {\n    return err(\n      kernelError(\n        'APPLY_MATRIX_FAILED',\n        `applyMatrix: kernel transform failed: ${e instanceof Error ? e.message : String(e)}`,\n        e,\n      ),\n    )\n  }\n}\n\n// ---------------------------------------------------------------------------\n// clone\n// ---------------------------------------------------------------------------\n\nconst CLONE_PARAMS = { name: 'clone', params: ['shape'], formClass: 'A' as FormClass }\n\n/**\n * Deep-copy a shape (`kernel.copyShape`).\n *\n * @param args - Resolved arguments (shape).\n * @returns The cloned shape as a `BrepHandle`.\n */\nexport function cloneBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape] = resolveArgs(args, CLONE_PARAMS)\n  const kernel = getBrepApi()\n  try {\n    return ok(kernel.copyShape(brepHandleOf(shape)))\n  } catch (e) {\n    return err(\n      kernelError(\n        'CLONE_FAILED',\n        `clone: kernel copy failed: ${e instanceof Error ? e.message : String(e)}`,\n        e,\n      ),\n    )\n  }\n}\n\n// ---------------------------------------------------------------------------\n// locate\n// ---------------------------------------------------------------------------\n\nconst LOCATE_PARAMS = { name: 'locate', params: ['shape', 'placement'], formClass: 'A' as FormClass }\n\ntype TransformOp =\n  | { readonly type: 'translate'; readonly v: Vec3 }\n  | { readonly type: 'rotate'; readonly angle: number; readonly axis?: Vec3; readonly center?: Vec3 }\n\nfunction opToMatrix(op: TransformOp): number[] {\n  if (op.type === 'translate') return translationMatrix(op.v)\n  const axis = op.axis ?? [0, 0, 1]\n  const center = op.center ?? [0, 0, 0]\n  return rotationMatrix(axis as Vec3, center as Vec3, op.angle)\n}\n\n/**\n * Placement-only rigid move (translate/rotate) via the kernel's cheap location\n * re-tag. Ops apply first-to-last (rotate then translate).\n *\n * @param args - Resolved arguments (shape, placement).\n * @returns The relocated shape as a `BrepHandle`.\n */\nexport function locateBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, placement] = resolveArgs(args, LOCATE_PARAMS)\n  const ops: readonly TransformOp[] =\n    placement !== null && typeof placement === 'object' && 'type' in (placement as object)\n      ? [placement as TransformOp]\n      : (placement as readonly TransformOp[])\n  const kernel = getBrepApi()\n  try {\n    let acc: number[] = [...IDENTITY_3X4]\n    for (const op of ops) acc = composeAffine(acc, opToMatrix(op))\n    return ok(kernel.locate(brepHandleOf(shape), acc))\n  } catch (e) {\n    return err(\n      kernelError(\n        'LOCATE_FAILED',\n        `locate: kernel locate failed: ${e instanceof Error ? e.message : String(e)}`,\n        e,\n      ),\n    )\n  }\n}\n\n// ---------------------------------------------------------------------------\n// mirror\n// ---------------------------------------------------------------------------\n\nconst MIRROR_PARAMS = { name: 'mirror', params: ['shape', 'options'], formClass: 'A' as FormClass }\n\n/**\n * Mirror across a plane defined by `options.at` (origin) and `options.normal`.\n *\n * @param args - Resolved arguments (shape, mirror options).\n * @returns The mirrored shape as a `BrepHandle`.\n */\nexport function mirrorBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, options] = resolveArgs(args, MIRROR_PARAMS)\n  const opts = (options ?? {}) as { normal?: Vec3; at?: Vec3 }\n  const normal = opts.normal ?? [1, 0, 0]\n  const at = opts.at ?? [0, 0, 0]\n  const kernel = getBrepApi()\n  try {\n    return ok(kernel.mirror(brepHandleOf(shape), { x: at[0], y: at[1], z: at[2] }, { x: normal[0], y: normal[1], z: normal[2] }))\n  } catch (e) {\n    return err(\n      kernelError(\n        'MIRROR_FAILED',\n        `mirror: kernel mirror failed: ${e instanceof Error ? e.message : String(e)}`,\n        e,\n      ),\n    )\n  }\n}\n\n\n// ---------------------------------------------------------------------------\n// rotate — 绕轴旋转（vendored topology/api.js#rotate + transformFns.ts#rotate）// ---------------------------------------------------------------------------\n\nconst ROTATE_PARAMS = { name: 'rotate', params: ['shape', 'angle', 'options'], formClass: 'A' as FormClass }\n\n/**\n * Rotate the shape around an axis (vendored topology/api.js#rotate + transformFns.ts#rotate).\n *\n * @param args - Resolved arguments (shape, angle in degrees, axis options).\n * @returns The rotated shape as a `BrepHandle`.\n */\nexport function rotateBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, angle, options] = resolveArgs(args, ROTATE_PARAMS)\n  const s = brepHandleOf(shape)\n  const { at = [0, 0, 0], axis = [0, 0, 1] } = (options ?? {}) as { at?: Vec3; axis?: Vec3 }\n  try {\n    // GOTCHA (2026-09-25): occt-wasm's native `rotate` returns a handle whose\n    // STEP export crashes (\"memory access out of bounds\") — same family as\n    // located/generalTransform. Rotation is affine, so build the Rodrigues\n    // matrix and go through the STEP-safe `transform` (BRepBuilderAPI_Transform).\n    // 2026-09-26: switched from getOcctKernel().transform to the L1 getBrepApi().transform\n    // so the op is engine-neutral (brepkit transform = cloneAndTransform deep-copy,\n    // same STEP-safe semantics) — see brepkit-batchA-fix.\n    const [ax, ay, az] = axis as readonly [number, number, number]\n    const alen = Math.hypot(ax, ay, az)\n    if (alen < 1e-12) {\n      return err(validationError('INVALID_AXIS', `rotate: axis must be non-zero, got [${ax}, ${ay}, ${az}]`))\n    }\n    const nx = ax / alen, ny = ay / alen, nz = az / alen\n    const theta = (Number(angle) * Math.PI) / 180\n    const c = Math.cos(theta), sTheta = Math.sin(theta), t = 1 - c\n    // R = cI + sK + t·(n⊗n) (Rodrigues)\n    const r00 = t * nx * nx + c,     r01 = t * nx * ny - nz * sTheta, r02 = t * nx * nz + ny * sTheta\n    const r10 = t * nx * ny + nz * sTheta, r11 = t * ny * ny + c,     r12 = t * ny * nz - nx * sTheta\n    const r20 = t * nx * nz - ny * sTheta, r21 = t * ny * nz + nx * sTheta, r22 = t * nz * nz + c\n    const [px, py, pz] = at as readonly [number, number, number]\n    // Pivot-preserving translation: p' = R·(p − at) + at  ⇒  tx = at − R·at\n    const tx = px - (r00 * px + r01 * py + r02 * pz)\n    const ty = py - (r10 * px + r11 * py + r12 * pz)\n    const tz = pz - (r20 * px + r21 * py + r22 * pz)\n    const m12 = [r00, r01, r02, tx, r10, r11, r12, ty, r20, r21, r22, tz]\n    return ok(getBrepApi().transform(s, m12))\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('ROTATE_FAILED', `Rotate operation failed: ${raw}`, e))\n  }\n}\n\n// ---------------------------------------------------------------------------\n// shell — 去面掏空（vendored topology/api.js#shell + modifierFns.ts#shell）// ---------------------------------------------------------------------------\n\nconst SHELL_PARAMS = { name: 'shell', params: ['shape', 'faces', 'thickness', 'options'], formClass: 'A' as FormClass }\n\n/**\n * Shell — hollow the shape by removing faces (vendored topology/api.js#shell + modifierFns.ts#shell).\n *\n * @param args - Resolved arguments (shape, faces, thickness, options).\n * @returns The shelled (hollowed) shape as a `BrepHandle`.\n */\nexport function shellBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, faces, thickness, options] = resolveArgs(args, SHELL_PARAMS)\n  const kernel = getBrepApi()\n  const s = brepHandleOf(shape)\n  const t = Number(thickness)\n  if (t <= 0) {\n    return err(validationError('INVALID_THICKNESS', 'Shell thickness must be positive'))\n  }\n  if (!Array.isArray(faces) || faces.length === 0) {\n    return err(validationError('NO_FACES', 'At least one face must be specified for shell'))\n  }\n  const faceHandles = (faces as unknown[]).map((f) => brepHandleOf(f))\n  const tolerance = ((options ?? {}) as { tolerance?: number }).tolerance ?? 1e-3\n  try {\n    return ok(kernel.shell(s, faceHandles, t, tolerance))\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('SHELL_FAILED', `Shell operation failed: ${raw}`, e))\n  }\n}\n\n// ---------------------------------------------------------------------------\n// offset — 全表面偏移（vendored topology/api.js#offset + modifierFns.ts#offset）// ---------------------------------------------------------------------------\n\nconst OFFSET_PARAMS = { name: 'offset', params: ['shape', 'distance', 'options'], formClass: 'A' as FormClass }\n\n/**\n * Offset all faces of the shape (vendored topology/api.js#offset + modifierFns.ts#offset).\n *\n * @param args - Resolved arguments (shape, distance, options).\n * @returns The offset shape as a `BrepHandle`.\n */\nexport function offsetBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, distance, options] = resolveArgs(args, OFFSET_PARAMS)\n  const s = brepHandleOf(shape)\n  const d = Number(distance)\n  if (Math.abs(d) < 1e-10) {\n    return err(validationError('ZERO_OFFSET', 'Offset distance cannot be zero'))\n  }\n  const tolerance = ((options ?? {}) as { tolerance?: number }).tolerance ?? 1e-6\n  try {\n    const h = getOcctKernel().offset(s as never, d, tolerance)\n    return ok(h as unknown as BrepHandle)\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('OFFSET_FAILED', `Offset operation failed: ${raw}`, e))\n  }\n}\n"]}
+{"version":3,"file":"topologyFns.js","sourceRoot":"","sources":["../../../src/api/brep-mirror/topologyFns.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Self-hosted compat-op implementations — topology transform family\n * (core-decouple Phase 3, §5.4).\n *\n * @platform occt\n *\n * Each export is a \"brep-shaped\" implementation consumed by the generated\n * compat-op projection (defineOp + D11 arg normalization). Inputs are the\n * normalized positional arguments of the op's params table; shapes arrive as\n * faijs Shapes (or raw handles) and results are returned as BREP handles\n * (wrapped by `wrapBrepOne` → `fromHandle`).\n *\n * Semantics mirror the early brepjs fns (`topology/transformFns.ts`,\n * `topology/shapeFns.ts`) with the brepjs object model (castResultShape,\n * metadata propagation, evolution tracking) dropped: occt-wasm handles only.\n */\n\nimport type { BrepHandle } from '../../brep/engine/types'\nimport { getBrepApi } from '../../brep/handle-bridge'\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 { MatrixInput, Vec3 } from '../brepjs-compat/types'\nimport { brepHandleOf, composeAffine, IDENTITY_3X4, rotationMatrix, translationMatrix } from './brepHelpers'\nimport { getOcctKernel } from '../../occt-kernel/occtKernel'\n\nconst VALIDATION_FAILED = 'VALIDATION_FAILED'\n\n// ---------------------------------------------------------------------------\n// Matrix input parsing (brepjs `parseMatrixInput` / `det3x3`)\n// ---------------------------------------------------------------------------\n\ntype Linear3x3 = readonly [number, number, number, number, number, number, number, number, number]\n\nfunction parseMatrixInput(\n  input: MatrixInput,\n): Result<{ linear: Linear3x3; translation: readonly [number, number, number] }> {\n  if ('linear' in input) {\n    return ok({ linear: input.linear, translation: input.translation })\n  }\n  const [r0, r1, r2, r3] = input\n  const TOL = 1e-10\n  if (Math.abs(r3[0]) > TOL || Math.abs(r3[1]) > TOL || Math.abs(r3[2]) > TOL || Math.abs(r3[3] - 1) > TOL) {\n    return err(\n      validationError(\n        VALIDATION_FAILED,\n        `applyMatrix: invalid bottom row [${String(r3[0])}, ${String(r3[1])}, ${String(r3[2])}, ${String(r3[3])}]. Must be [0, 0, 0, 1] for an affine transform.`,\n      ),\n    )\n  }\n  return ok({\n    linear: [r0[0], r0[1], r0[2], r1[0], r1[1], r1[2], r2[0], r2[1], r2[2]],\n    translation: [r0[3], r1[3], r2[3]],\n  })\n}\n\nfunction det3x3(m: Linear3x3): number {\n  return (\n    m[0] * (m[4] * m[8] - m[5] * m[7]) -\n    m[1] * (m[3] * m[8] - m[5] * m[6]) +\n    m[2] * (m[3] * m[7] - m[4] * m[6])\n  )\n}\n\n// ---------------------------------------------------------------------------\n// applyMatrix\n// ---------------------------------------------------------------------------\n\nconst APPLY_MATRIX_PARAMS = { name: 'applyMatrix', params: ['shape', 'matrix'], formClass: 'A' as FormClass }\n\n/**\n * Apply a 4×4 affine matrix (OpenSCAD `multmatrix` equivalent).\n *\n * The brepjs fn splits orthogonal (evolution-tracked) and non-orthogonal\n * (`gp_GTrsf`) paths; the core path uses the single L1 `generalTransform`\n * (occt-wasm `gp_GTrsf`, geometrically equivalent for both classes) since\n * `applyMatrix` carries identity naming and needs no face evolution.\n *\n * @param args - Resolved arguments (shape, matrix).\n * @returns The transformed shape as a `BrepHandle`.\n */\nexport function applyMatrixBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, matrix] = resolveArgs(args, APPLY_MATRIX_PARAMS)\n  const parsed = parseMatrixInput(matrix as MatrixInput)\n  if (!parsed.ok) return parsed\n  const { linear, translation } = parsed.value\n  if (Math.abs(det3x3(linear)) < 1e-12) {\n    return err(\n      validationError(\n        VALIDATION_FAILED,\n        'applyMatrix: singular matrix (determinant ≈0). Cannot apply a non-invertible transform.',\n      ),\n    )\n  }\n  const kernel = getBrepApi()\n  try {\n    const m12 = [\n      linear[0], linear[1], linear[2], translation[0],\n      linear[3], linear[4], linear[5], translation[1],\n      linear[6], linear[7], linear[8], translation[2],\n    ]\n    // GOTCHA (2026-09-25): occt-wasm's `located`/`generalTransform` return\n    // TopLoc/GTrsf-referencing handles whose STEP export crashes\n    // (\"memory access out of bounds\") — only the affine `transform`\n    // (BRepBuilderAPI_Transform, deep-copy) is STEP-safe. A similar\n    // transform (orthogonal rows, equal lengths) is affine and goes\n    // through `transform`; genuinely non-affine matrices keep the\n    // generalTransform path (no current caller, pre-existing behavior).\n    const lin = linear as readonly [number, number, number, number, number, number, number, number, number]\n    const s0 = Math.hypot(lin[0], lin[1], lin[2])\n    const s1 = Math.hypot(lin[3], lin[4], lin[5])\n    const s2 = Math.hypot(lin[6], lin[7], lin[8])\n    const dot01 = Math.abs(lin[0] * lin[3] + lin[1] * lin[4] + lin[2] * lin[5])\n    const dot02 = Math.abs(lin[0] * lin[6] + lin[1] * lin[7] + lin[2] * lin[8])\n    const dot12 = Math.abs(lin[3] * lin[6] + lin[4] * lin[7] + lin[5] * lin[8])\n    const TOL = 1e-9\n    const similar =\n      s0 > TOL && Math.abs(s1 - s0) < TOL && Math.abs(s2 - s0) < TOL &&\n      dot01 < TOL && dot02 < TOL && dot12 < TOL\n    return ok(similar ? kernel.transform(brepHandleOf(shape), m12) : kernel.generalTransform(brepHandleOf(shape), m12))\n  } catch (e) {\n    return err(\n      kernelError(\n        'APPLY_MATRIX_FAILED',\n        `applyMatrix: kernel transform failed: ${e instanceof Error ? e.message : String(e)}`,\n        e,\n      ),\n    )\n  }\n}\n\n// ---------------------------------------------------------------------------\n// clone\n// ---------------------------------------------------------------------------\n\nconst CLONE_PARAMS = { name: 'clone', params: ['shape'], formClass: 'A' as FormClass }\n\n/**\n * Deep-copy a shape (`kernel.copyShape`).\n *\n * @param args - Resolved arguments (shape).\n * @returns The cloned shape as a `BrepHandle`.\n */\nexport function cloneBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape] = resolveArgs(args, CLONE_PARAMS)\n  const kernel = getBrepApi()\n  try {\n    return ok(kernel.copyShape(brepHandleOf(shape)))\n  } catch (e) {\n    return err(\n      kernelError(\n        'CLONE_FAILED',\n        `clone: kernel copy failed: ${e instanceof Error ? e.message : String(e)}`,\n        e,\n      ),\n    )\n  }\n}\n\n// ---------------------------------------------------------------------------\n// locate\n// ---------------------------------------------------------------------------\n\nconst LOCATE_PARAMS = { name: 'locate', params: ['shape', 'placement'], formClass: 'A' as FormClass }\n\ntype TransformOp =\n  | { readonly type: 'translate'; readonly v: Vec3 }\n  | { readonly type: 'rotate'; readonly angle: number; readonly axis?: Vec3; readonly center?: Vec3 }\n\nfunction opToMatrix(op: TransformOp): number[] {\n  if (op.type === 'translate') return translationMatrix(op.v)\n  const axis = op.axis ?? [0, 0, 1]\n  const center = op.center ?? [0, 0, 0]\n  return rotationMatrix(axis as Vec3, center as Vec3, op.angle)\n}\n\n/**\n * Placement-only rigid move (translate/rotate) via the kernel's cheap location\n * re-tag. Ops apply first-to-last (rotate then translate).\n *\n * @param args - Resolved arguments (shape, placement).\n * @returns The relocated shape as a `BrepHandle`.\n */\nexport function locateBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, placement] = resolveArgs(args, LOCATE_PARAMS)\n  const ops: readonly TransformOp[] =\n    placement !== null && typeof placement === 'object' && 'type' in (placement as object)\n      ? [placement as TransformOp]\n      : (placement as readonly TransformOp[])\n  const kernel = getBrepApi()\n  try {\n    let acc: number[] = [...IDENTITY_3X4]\n    for (const op of ops) acc = composeAffine(acc, opToMatrix(op))\n    return ok(kernel.locate(brepHandleOf(shape), acc))\n  } catch (e) {\n    return err(\n      kernelError(\n        'LOCATE_FAILED',\n        `locate: kernel locate failed: ${e instanceof Error ? e.message : String(e)}`,\n        e,\n      ),\n    )\n  }\n}\n\n// ---------------------------------------------------------------------------\n// mirror\n// ---------------------------------------------------------------------------\n\nconst MIRROR_PARAMS = { name: 'mirror', params: ['shape', 'options'], formClass: 'A' as FormClass }\n\n/**\n * Mirror across a plane defined by `options.at` (origin) and `options.normal`.\n *\n * @param args - Resolved arguments (shape, mirror options).\n * @returns The mirrored shape as a `BrepHandle`.\n */\nexport function mirrorBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, options] = resolveArgs(args, MIRROR_PARAMS)\n  const opts = (options ?? {}) as { normal?: Vec3; at?: Vec3 }\n  const normal = opts.normal ?? [1, 0, 0]\n  const at = opts.at ?? [0, 0, 0]\n  const kernel = getBrepApi()\n  try {\n    return ok(kernel.mirror(brepHandleOf(shape), { x: at[0], y: at[1], z: at[2] }, { x: normal[0], y: normal[1], z: normal[2] }))\n  } catch (e) {\n    return err(\n      kernelError(\n        'MIRROR_FAILED',\n        `mirror: kernel mirror failed: ${e instanceof Error ? e.message : String(e)}`,\n        e,\n      ),\n    )\n  }\n}\n\n\n// ---------------------------------------------------------------------------\n// rotate — 绕轴旋转（brepjs topology/api.js#rotate + transformFns.ts#rotate）// ---------------------------------------------------------------------------\n\nconst ROTATE_PARAMS = { name: 'rotate', params: ['shape', 'angle', 'options'], formClass: 'A' as FormClass }\n\n/**\n * Rotate the shape around an axis (brepjs topology/api.js#rotate + transformFns.ts#rotate).\n *\n * @param args - Resolved arguments (shape, angle in degrees, axis options).\n * @returns The rotated shape as a `BrepHandle`.\n */\nexport function rotateBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, angle, options] = resolveArgs(args, ROTATE_PARAMS)\n  const s = brepHandleOf(shape)\n  const { at = [0, 0, 0], axis = [0, 0, 1] } = (options ?? {}) as { at?: Vec3; axis?: Vec3 }\n  try {\n    // GOTCHA (2026-09-25): occt-wasm's native `rotate` returns a handle whose\n    // STEP export crashes (\"memory access out of bounds\") — same family as\n    // located/generalTransform. Rotation is affine, so build the Rodrigues\n    // matrix and go through the STEP-safe `transform` (BRepBuilderAPI_Transform).\n    // 2026-09-26: switched from getOcctKernel().transform to the L1 getBrepApi().transform\n    // so the op is engine-neutral (brepkit transform = cloneAndTransform deep-copy,\n    // same STEP-safe semantics) — see brepkit-batchA-fix.\n    const [ax, ay, az] = axis as readonly [number, number, number]\n    const alen = Math.hypot(ax, ay, az)\n    if (alen < 1e-12) {\n      return err(validationError('INVALID_AXIS', `rotate: axis must be non-zero, got [${ax}, ${ay}, ${az}]`))\n    }\n    const nx = ax / alen, ny = ay / alen, nz = az / alen\n    const theta = (Number(angle) * Math.PI) / 180\n    const c = Math.cos(theta), sTheta = Math.sin(theta), t = 1 - c\n    // R = cI + sK + t·(n⊗n) (Rodrigues)\n    const r00 = t * nx * nx + c,     r01 = t * nx * ny - nz * sTheta, r02 = t * nx * nz + ny * sTheta\n    const r10 = t * nx * ny + nz * sTheta, r11 = t * ny * ny + c,     r12 = t * ny * nz - nx * sTheta\n    const r20 = t * nx * nz - ny * sTheta, r21 = t * ny * nz + nx * sTheta, r22 = t * nz * nz + c\n    const [px, py, pz] = at as readonly [number, number, number]\n    // Pivot-preserving translation: p' = R·(p − at) + at  ⇒  tx = at − R·at\n    const tx = px - (r00 * px + r01 * py + r02 * pz)\n    const ty = py - (r10 * px + r11 * py + r12 * pz)\n    const tz = pz - (r20 * px + r21 * py + r22 * pz)\n    const m12 = [r00, r01, r02, tx, r10, r11, r12, ty, r20, r21, r22, tz]\n    return ok(getBrepApi().transform(s, m12))\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('ROTATE_FAILED', `Rotate operation failed: ${raw}`, e))\n  }\n}\n\n// ---------------------------------------------------------------------------\n// shell — 去面掏空（brepjs topology/api.js#shell + modifierFns.ts#shell）// ---------------------------------------------------------------------------\n\nconst SHELL_PARAMS = { name: 'shell', params: ['shape', 'faces', 'thickness', 'options'], formClass: 'A' as FormClass }\n\n/**\n * Shell — hollow the shape by removing faces (brepjs topology/api.js#shell + modifierFns.ts#shell).\n *\n * @param args - Resolved arguments (shape, faces, thickness, options).\n * @returns The shelled (hollowed) shape as a `BrepHandle`.\n */\nexport function shellBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, faces, thickness, options] = resolveArgs(args, SHELL_PARAMS)\n  const kernel = getBrepApi()\n  const s = brepHandleOf(shape)\n  const t = Number(thickness)\n  if (t <= 0) {\n    return err(validationError('INVALID_THICKNESS', 'Shell thickness must be positive'))\n  }\n  if (!Array.isArray(faces) || faces.length === 0) {\n    return err(validationError('NO_FACES', 'At least one face must be specified for shell'))\n  }\n  const faceHandles = (faces as unknown[]).map((f) => brepHandleOf(f))\n  const tolerance = ((options ?? {}) as { tolerance?: number }).tolerance ?? 1e-3\n  try {\n    return ok(kernel.shell(s, faceHandles, t, tolerance))\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('SHELL_FAILED', `Shell operation failed: ${raw}`, e))\n  }\n}\n\n// ---------------------------------------------------------------------------\n// offset — 全表面偏移（brepjs topology/api.js#offset + modifierFns.ts#offset）// ---------------------------------------------------------------------------\n\nconst OFFSET_PARAMS = { name: 'offset', params: ['shape', 'distance', 'options'], formClass: 'A' as FormClass }\n\n/**\n * Offset all faces of the shape (brepjs topology/api.js#offset + modifierFns.ts#offset).\n *\n * @param args - Resolved arguments (shape, distance, options).\n * @returns The offset shape as a `BrepHandle`.\n */\nexport function offsetBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, distance, options] = resolveArgs(args, OFFSET_PARAMS)\n  const s = brepHandleOf(shape)\n  const d = Number(distance)\n  if (Math.abs(d) < 1e-10) {\n    return err(validationError('ZERO_OFFSET', 'Offset distance cannot be zero'))\n  }\n  const tolerance = ((options ?? {}) as { tolerance?: number }).tolerance ?? 1e-6\n  try {\n    const h = getOcctKernel().offset(s as never, d, tolerance)\n    return ok(h as unknown as BrepHandle)\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('OFFSET_FAILED', `Offset operation failed: ${raw}`, e))\n  }\n}\n"]}

package/dist/api/brep-operations/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 brepjs
+ * `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 (brepjs `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 brepjs 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-operations/booleanFns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"booleanFns.d.ts","sourceRoot":"","sources":["../../../src/api/brep-operations/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-operations/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 brepjs
+ * `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 '../geom-types/planeOps.js';
+import { brepHandleOf } from './brepHelpers.js';
+const SECTION_PARAMS = { name: 'section', params: ['shape', 'plane'], formClass: 'A' };
+/**
+ * Section a shape with a plane (brepjs `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 brepjs 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 (brepjs 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) (brepjs 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-operations/booleanFns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"booleanFns.js","sourceRoot":"","sources":["../../../src/api/brep-operations/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 brepjs\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 '../geom-types/planeTypes'\nimport { resolvePlane } from '../geom-types/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 (brepjs `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 brepjs 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 (brepjs 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) (brepjs 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-operations/brepHelpers.d.ts

@@ -0,0 +1,55 @@
+/**
+ * brep-operations 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 kernel handle object `{ id }`,
+ *  - a shape wrapper object `{ 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-operations/brepHelpers.d.ts.map

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

@@ -0,0 +1,131 @@
+/**
+ * brep-operations 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 kernel handle object `{ id }`,
+ *  - a shape wrapper object `{ 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-operations] 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-operations] 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-operations] 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-operations/brepHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brepHelpers.js","sourceRoot":"","sources":["../../../src/api/brep-operations/brepHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * brep-operations 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 kernel handle object `{ id }`,\n *  - a shape wrapper object `{ 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-operations] 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-operations] 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-operations] 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"]}