@faicad/faijs 0.16.1 → 0.17.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"sweepFns.d.ts","sourceRoot":"","sources":["../../../src/api/brep-mirror/sweepFns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEzD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAA;AA8B1D;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAclE;AAMD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAqBlE;AAMD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CA8BhE;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CA6BzE;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAqDvE"}

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

@@ -0,0 +1,200 @@
+/**
+ * Self-hosted compat-op implementations — extrude/revolve/sweep family
+ * (core-decouple Phase 3, §5.4; G3).
+ *
+ * @platform occt
+ *
+ * Semantics mirror vendored `operations/{api,extrudeFns,sweepFns}.ts`:
+ *  - `extrudeBrep` — height: number → [0,0,h]; Vec3 → as-is. EXTRUDE_ZERO_VECTOR guard.
+ *  - `revolveBrep` — options { at, axis, angle(radians, default 2π) }; REVOLUTION_NOT_3D.
+ *  - `sweepBrep` — config.mode 'simple' → simplePipe; default → sweepPipeShell(frenet).
+ *    shellMode / law / auxiliarySpine / support / correction configs are not
+ *    supported after selfhosting (cad 面取手写 api/sweep.ts，shell 元组不暴露 §2.4①).
+ *  - `complexExtrudeBrep` / `twistExtrudeBrep` — linear / helix spine built on
+ *    occt-wasm makeLineEdge+makeWire / makeHelixWire, then sweepPipeShell.
+ *    ExtrusionProfile scaling law is not supported (vendored buildLawFromProfile
+ *    has no L1 equivalent); non-undefined profile → LAW_UNSUPPORTED error.
+ */
+import { getBrepApi } from '../../brep/handle-bridge.js';
+import { ok, err } from '../../result/result.js';
+import { kernelError, validationError } from '../../result/errors.js';
+import { resolveArgs } from '../internal/dual-form-args.js';
+import { brepHandleOf } from './brepHelpers.js';
+import { getOcctKernel } from '../../occt-kernel/occtKernel.js';
+const EXTRUDE_PARAMS = { name: 'extrude', params: ['face', 'height'], formClass: 'A' };
+const REVOLVE_PARAMS = { name: 'revolve', params: ['face', 'options'], formClass: 'A' };
+const SWEEP_PARAMS = { name: 'sweep', params: ['wire', 'spine', 'config', 'shellMode'], formClass: 'A' };
+const COMPLEX_EXTRUDE_PARAMS = { name: 'complexExtrude', params: ['wire', 'center', 'normal', 'profile'], formClass: 'A' };
+const TWIST_EXTRUDE_PARAMS = { name: 'twistExtrude', params: ['wire', 'angleDegrees', 'center', 'normal', 'profile'], formClass: 'A' };
+function vecLength(v) {
+    return Math.hypot(v[0], v[1], v[2]);
+}
+/** 构造直线 spine wire（vendored makeSpineWire）。 */
+function makeSpineWire(kernel, start, end) {
+    const e = kernel.makeLineEdge({ x: start[0], y: start[1], z: start[2] }, { x: end[0], y: end[1], z: end[2] });
+    const w = kernel.makeWire([e]);
+    kernel.release(e);
+    return w;
+}
+// ---------------------------------------------------------------------------
+// extrude — face 沿向量/高度拉伸（vendored api.js#extrude + extrudeFns.ts#extrude）
+// ---------------------------------------------------------------------------
+/**
+ * Extrude a face along a vector/height (vendored api.js#extrude + extrudeFns.ts#extrude).
+ *
+ * @param args - Resolved arguments (face, height or extrusion vector).
+ * @returns The extruded solid as a `BrepHandle`.
+ */
+export function extrudeBrep(...args) {
+    const [face, height] = resolveArgs(args, EXTRUDE_PARAMS);
+    const kernel = getBrepApi();
+    const f = brepHandleOf(face);
+    const vec = typeof height === 'number' ? [0, 0, height] : height;
+    if (vecLength(vec) < 1e-10) {
+        return err(validationError('EXTRUDE_ZERO_VECTOR', 'extrude: extrusion vector has zero length'));
+    }
+    try {
+        return ok(kernel.extrude(f, vec[0], vec[1], vec[2]));
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return err(kernelError('EXTRUDE_FAILED', `Extrusion operation failed: ${raw}`, e));
+    }
+}
+// ---------------------------------------------------------------------------
+// revolve — face 绕轴旋转（vendored api.js#revolve；angle 单位弧度，默认 2π）
+// ---------------------------------------------------------------------------
+/**
+ * Revolve a face around an axis (vendored api.js#revolve; angle in radians, default 2π).
+ *
+ * @param args - Resolved arguments (face, revolve options).
+ * @returns The revolved solid as a `BrepHandle`.
+ */
+export function revolveBrep(...args) {
+    const [face, options] = resolveArgs(args, REVOLVE_PARAMS);
+    const kernel = getBrepApi();
+    const f = brepHandleOf(face);
+    const { at = [0, 0, 0], axis = [0, 0, 1], angle = 2 * Math.PI } = (options ?? {});
+    try {
+        const h = kernel.revolveVec(f, { x: at[0], y: at[1], z: at[2] }, { x: axis[0], y: axis[1], z: axis[2] }, (angle * 180) / Math.PI);
+        return ok(h);
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return err(kernelError('REVOLVE_FAILED', `Revolution operation failed: ${raw}`, e));
+    }
+}
+// ---------------------------------------------------------------------------
+// sweep — 截面沿脊柱扫掠（vendored sweepFns.ts#sweep）
+// ---------------------------------------------------------------------------
+/**
+ * Sweep a profile along a spine (vendored sweepFns.ts#sweep).
+ *
+ * @param args - Resolved arguments (wire, spine, config, shellMode).
+ * @returns The swept solid as a `BrepHandle`.
+ */
+export function sweepBrep(...args) {
+    const [wire, spine, config, shellMode] = resolveArgs(args, SWEEP_PARAMS);
+    const w = brepHandleOf(wire);
+    const sp = brepHandleOf(spine);
+    const cfg = (config ?? {});
+    if (shellMode === true) {
+        return err(validationError('SWEEP_SHELL_MODE_UNSUPPORTED', 'sweep shellMode is not supported after selfhosting (cad 面不暴露壳元组 §2.4①)'));
+    }
+    if (cfg.transitionMode !== undefined && cfg.transitionMode !== 'right') {
+        return err(validationError('SWEEP_TRANSITION_UNSUPPORTED', `sweep transitionMode '${cfg.transitionMode}' is not supported after selfhosting (only 'right' default)`));
+    }
+    try {
+        if (cfg.mode === 'simple') {
+            return ok(getOcctKernel().simplePipe(w, sp));
+        }
+        return ok(getOcctKernel().sweepPipeShell(w, sp, cfg.frenet === true, false));
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return err(kernelError('SWEEP_FAILED', `Sweep operation failed: ${raw}`, e));
+    }
+}
+// ---------------------------------------------------------------------------
+// complexExtrude — wire 沿 normal 挤出（vendored sweepFns.ts#complexExtrude）
+// ---------------------------------------------------------------------------
+/**
+ * Extrude a wire along a normal (vendored sweepFns.ts#complexExtrude).
+ *
+ * @param args - Resolved arguments (wire, center, normal, profile).
+ * @returns The extruded solid as a `BrepHandle`.
+ */
+export function complexExtrudeBrep(...args) {
+    const [wire, center, normal, profile] = resolveArgs(args, COMPLEX_EXTRUDE_PARAMS);
+    const kernel = getBrepApi();
+    const w = brepHandleOf(wire);
+    const c = (center ?? [0, 0, 0]);
+    const n = (normal ?? [0, 0, 0]);
+    if (vecLength(n) < 1e-10) {
+        return err(validationError('ZERO_LENGTH_EXTRUSION', 'Extrusion vector cannot have zero length'));
+    }
+    if (profile !== undefined && profile !== null) {
+        return err(validationError('COMPLEX_EXTRUDE_LAW_UNSUPPORTED', 'complexExtrude ExtrusionProfile scaling law is not supported after selfhosting'));
+    }
+    const endPoint = [c[0] + n[0], c[1] + n[1], c[2] + n[2]];
+    const spine = makeSpineWire(kernel, c, endPoint);
+    try {
+        const h = getOcctKernel().sweepPipeShell(w, spine, false, false);
+        return ok(h);
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return err(kernelError('SWEEP_FAILED', `complexExtrude sweep failed: ${raw}`, e));
+    }
+    finally {
+        kernel.release(spine);
+    }
+}
+// ---------------------------------------------------------------------------
+// twistExtrude — wire 沿螺旋挤出（vendored sweepFns.ts#twistExtrude）
+// ---------------------------------------------------------------------------
+/**
+ * Extrude a wire along a helical path (vendored sweepFns.ts#twistExtrude).
+ *
+ * @param args - Resolved arguments (wire, angleDegrees, center, normal, profile).
+ * @returns The twisted extrusion as a `BrepHandle`.
+ */
+export function twistExtrudeBrep(...args) {
+    const [wire, angleDegrees, center, normal, profile] = resolveArgs(args, TWIST_EXTRUDE_PARAMS);
+    const kernel = getBrepApi();
+    const w = brepHandleOf(wire);
+    const angle = Number(angleDegrees);
+    const c = (center ?? [0, 0, 0]);
+    const n = (normal ?? [0, 0, 0]);
+    if (Math.abs(angle) < 1e-10) {
+        return err(validationError('ZERO_TWIST_ANGLE', 'Twist angle cannot be zero'));
+    }
+    if (angle < 0) {
+        return err(validationError('TWIST_NEGATIVE_ANGLE_UNSUPPORTED', 'twistExtrude negative angle (left-handed helix) is not supported after selfhosting (occt-wasm makeHelixWire has no handedness param)'));
+    }
+    if (vecLength(n) < 1e-10) {
+        return err(validationError('ZERO_LENGTH_EXTRUSION', 'Extrusion vector cannot have zero length'));
+    }
+    if (profile !== undefined && profile !== null) {
+        return err(validationError('TWIST_EXTRUDE_LAW_UNSUPPORTED', 'twistExtrude ExtrusionProfile scaling law is not supported after selfhosting'));
+    }
+    const extrusionLength = vecLength(n);
+    const pitch = (360.0 / Math.abs(angle)) * extrusionLength;
+    // vendored 语义：主 spine=直线、auxiliary=helix，sweepPipeShell 传对象参数
+    // （occt-wasm 运行时接受 auxiliary 键；d.ts 窄签名用 as never 绕过）
+    const endPointTwist = [c[0] + n[0], c[1] + n[1], c[2] + n[2]];
+    const spine = makeSpineWire(kernel, c, endPointTwist);
+    const axisDir = vecLength(n) > 1e-12 ? [n[0] / vecLength(n), n[1] / vecLength(n), n[2] / vecLength(n)] : [0, 0, 1];
+    try {
+        const helix = getOcctKernel().makeHelixWire({ x: c[0], y: c[1], z: c[2] }, { x: axisDir[0], y: axisDir[1], z: axisDir[2] }, pitch, extrusionLength, 1);
+        const h = getOcctKernel().sweepPipeShell(w, spine, { auxiliary: helix });
+        getOcctKernel().release(helix);
+        kernel.release(spine);
+        return ok(h);
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return err(kernelError('SWEEP_FAILED', `twistExtrude sweep failed: ${raw}`, e));
+    }
+}
+//# sourceMappingURL=sweepFns.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sweepFns.js","sourceRoot":"","sources":["../../../src/api/brep-mirror/sweepFns.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Self-hosted compat-op implementations — extrude/revolve/sweep family\n * (core-decouple Phase 3, §5.4; G3).\n *\n * @platform occt\n *\n * Semantics mirror vendored `operations/{api,extrudeFns,sweepFns}.ts`:\n *  - `extrudeBrep` — height: number → [0,0,h]; Vec3 → as-is. EXTRUDE_ZERO_VECTOR guard.\n *  - `revolveBrep` — options { at, axis, angle(radians, default 2π) }; REVOLUTION_NOT_3D.\n *  - `sweepBrep` — config.mode 'simple' → simplePipe; default → sweepPipeShell(frenet).\n *    shellMode / law / auxiliarySpine / support / correction configs are not\n *    supported after selfhosting (cad 面取手写 api/sweep.ts，shell 元组不暴露 §2.4①).\n *  - `complexExtrudeBrep` / `twistExtrudeBrep` — linear / helix spine built on\n *    occt-wasm makeLineEdge+makeWire / makeHelixWire, then sweepPipeShell.\n *    ExtrusionProfile scaling law is not supported (vendored buildLawFromProfile\n *    has no L1 equivalent); non-undefined profile → LAW_UNSUPPORTED error.\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 { Vec3 } from '../brepjs-compat/types'\nimport { brepHandleOf } from './brepHelpers'\nimport { getOcctKernel } from '../../occt-kernel/occtKernel'\n\nconst EXTRUDE_PARAMS = { name: 'extrude', params: ['face', 'height'], formClass: 'A' as FormClass }\nconst REVOLVE_PARAMS = { name: 'revolve', params: ['face', 'options'], formClass: 'A' as FormClass }\nconst SWEEP_PARAMS = { name: 'sweep', params: ['wire', 'spine', 'config', 'shellMode'], formClass: 'A' as FormClass }\nconst COMPLEX_EXTRUDE_PARAMS = { name: 'complexExtrude', params: ['wire', 'center', 'normal', 'profile'], formClass: 'A' as FormClass }\nconst TWIST_EXTRUDE_PARAMS = { name: 'twistExtrude', params: ['wire', 'angleDegrees', 'center', 'normal', 'profile'], formClass: 'A' as FormClass }\n\nfunction vecLength(v: readonly number[]): number {\n  return Math.hypot(v[0], v[1], v[2])\n}\n\n/** 构造直线 spine wire（vendored makeSpineWire）。 */\nfunction makeSpineWire(kernel: ReturnType<typeof getBrepApi>, start: Vec3, end: Vec3): BrepHandle {\n  const e = kernel.makeLineEdge({ x: start[0], y: start[1], z: start[2] }, { x: end[0], y: end[1], z: end[2] })\n  const w = kernel.makeWire([e])\n  kernel.release(e)\n  return w\n}\n\n// ---------------------------------------------------------------------------\n// extrude — face 沿向量/高度拉伸（vendored api.js#extrude + extrudeFns.ts#extrude）\n// ---------------------------------------------------------------------------\n\n/**\n * Extrude a face along a vector/height (vendored api.js#extrude + extrudeFns.ts#extrude).\n *\n * @param args - Resolved arguments (face, height or extrusion vector).\n * @returns The extruded solid as a `BrepHandle`.\n */\nexport function extrudeBrep(...args: unknown[]): Result<BrepHandle> {\n  const [face, height] = resolveArgs(args, EXTRUDE_PARAMS)\n  const kernel = getBrepApi()\n  const f = brepHandleOf(face)\n  const vec: Vec3 = typeof height === 'number' ? [0, 0, height] : (height as Vec3)\n  if (vecLength(vec) < 1e-10) {\n    return err(validationError('EXTRUDE_ZERO_VECTOR', 'extrude: extrusion vector has zero length'))\n  }\n  try {\n    return ok(kernel.extrude(f, vec[0], vec[1], vec[2]))\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('EXTRUDE_FAILED', `Extrusion operation failed: ${raw}`, e))\n  }\n}\n\n// ---------------------------------------------------------------------------\n// revolve — face 绕轴旋转（vendored api.js#revolve；angle 单位弧度，默认 2π）\n// ---------------------------------------------------------------------------\n\n/**\n * Revolve a face around an axis (vendored api.js#revolve; angle in radians, default 2π).\n *\n * @param args - Resolved arguments (face, revolve options).\n * @returns The revolved solid as a `BrepHandle`.\n */\nexport function revolveBrep(...args: unknown[]): Result<BrepHandle> {\n  const [face, options] = resolveArgs(args, REVOLVE_PARAMS)\n  const kernel = getBrepApi()\n  const f = brepHandleOf(face)\n  const { at = [0, 0, 0], axis = [0, 0, 1], angle = 2 * Math.PI } = (options ?? {}) as {\n    at?: Vec3\n    axis?: Vec3\n    angle?: number\n  }\n  try {\n    const h = kernel.revolveVec(\n      f,\n      { x: at[0], y: at[1], z: at[2] },\n      { x: axis[0], y: axis[1], z: axis[2] },\n      (angle * 180) / Math.PI,\n    )\n    return ok(h)\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('REVOLVE_FAILED', `Revolution operation failed: ${raw}`, e))\n  }\n}\n\n// ---------------------------------------------------------------------------\n// sweep — 截面沿脊柱扫掠（vendored sweepFns.ts#sweep）\n// ---------------------------------------------------------------------------\n\n/**\n * Sweep a profile along a spine (vendored sweepFns.ts#sweep).\n *\n * @param args - Resolved arguments (wire, spine, config, shellMode).\n * @returns The swept solid as a `BrepHandle`.\n */\nexport function sweepBrep(...args: unknown[]): Result<BrepHandle> {\n  const [wire, spine, config, shellMode] = resolveArgs(args, SWEEP_PARAMS)\n  const w = brepHandleOf(wire)\n  const sp = brepHandleOf(spine)\n  const cfg = (config ?? {}) as { mode?: string; frenet?: boolean; transitionMode?: string }\n  if (shellMode === true) {\n    return err(\n      validationError(\n        'SWEEP_SHELL_MODE_UNSUPPORTED',\n        'sweep shellMode is not supported after selfhosting (cad 面不暴露壳元组 §2.4①)',\n      ),\n    )\n  }\n  if (cfg.transitionMode !== undefined && cfg.transitionMode !== 'right') {\n    return err(\n      validationError(\n        'SWEEP_TRANSITION_UNSUPPORTED',\n        `sweep transitionMode '${cfg.transitionMode}' is not supported after selfhosting (only 'right' default)`,\n      ),\n    )\n  }\n  try {\n    if (cfg.mode === 'simple') {\n      return ok(getOcctKernel().simplePipe(w as never, sp as never) as unknown as BrepHandle)\n    }\n    return ok(getOcctKernel().sweepPipeShell(w as never, sp as never, cfg.frenet === true, false) as unknown as BrepHandle)\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('SWEEP_FAILED', `Sweep operation failed: ${raw}`, e))\n  }\n}\n\n// ---------------------------------------------------------------------------\n// complexExtrude — wire 沿 normal 挤出（vendored sweepFns.ts#complexExtrude）\n// ---------------------------------------------------------------------------\n\n/**\n * Extrude a wire along a normal (vendored sweepFns.ts#complexExtrude).\n *\n * @param args - Resolved arguments (wire, center, normal, profile).\n * @returns The extruded solid as a `BrepHandle`.\n */\nexport function complexExtrudeBrep(...args: unknown[]): Result<BrepHandle> {\n  const [wire, center, normal, profile] = resolveArgs(args, COMPLEX_EXTRUDE_PARAMS)\n  const kernel = getBrepApi()\n  const w = brepHandleOf(wire)\n  const c = (center ?? [0, 0, 0]) as Vec3\n  const n = (normal ?? [0, 0, 0]) as Vec3\n\n  if (vecLength(n) < 1e-10) {\n    return err(validationError('ZERO_LENGTH_EXTRUSION', 'Extrusion vector cannot have zero length'))\n  }\n  if (profile !== undefined && profile !== null) {\n    return err(\n      validationError(\n        'COMPLEX_EXTRUDE_LAW_UNSUPPORTED',\n        'complexExtrude ExtrusionProfile scaling law is not supported after selfhosting',\n      ),\n    )\n  }\n  const endPoint: Vec3 = [c[0] + n[0], c[1] + n[1], c[2] + n[2]]\n  const spine = makeSpineWire(kernel, c, endPoint)\n  try {\n    const h = getOcctKernel().sweepPipeShell(w as never, spine as never, false, false) as unknown as BrepHandle\n    return ok(h)\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('SWEEP_FAILED', `complexExtrude sweep failed: ${raw}`, e))\n  } finally {\n    kernel.release(spine)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// twistExtrude — wire 沿螺旋挤出（vendored sweepFns.ts#twistExtrude）\n// ---------------------------------------------------------------------------\n\n/**\n * Extrude a wire along a helical path (vendored sweepFns.ts#twistExtrude).\n *\n * @param args - Resolved arguments (wire, angleDegrees, center, normal, profile).\n * @returns The twisted extrusion as a `BrepHandle`.\n */\nexport function twistExtrudeBrep(...args: unknown[]): Result<BrepHandle> {\n  const [wire, angleDegrees, center, normal, profile] = resolveArgs(args, TWIST_EXTRUDE_PARAMS)\n  const kernel = getBrepApi()\n  const w = brepHandleOf(wire)\n  const angle = Number(angleDegrees)\n  const c = (center ?? [0, 0, 0]) as Vec3\n  const n = (normal ?? [0, 0, 0]) as Vec3\n\n  if (Math.abs(angle) < 1e-10) {\n    return err(validationError('ZERO_TWIST_ANGLE', 'Twist angle cannot be zero'))\n  }\n  if (angle < 0) {\n    return err(\n      validationError(\n        'TWIST_NEGATIVE_ANGLE_UNSUPPORTED',\n        'twistExtrude negative angle (left-handed helix) is not supported after selfhosting (occt-wasm makeHelixWire has no handedness param)',\n      ),\n    )\n  }\n  if (vecLength(n) < 1e-10) {\n    return err(validationError('ZERO_LENGTH_EXTRUSION', 'Extrusion vector cannot have zero length'))\n  }\n  if (profile !== undefined && profile !== null) {\n    return err(\n      validationError(\n        'TWIST_EXTRUDE_LAW_UNSUPPORTED',\n        'twistExtrude ExtrusionProfile scaling law is not supported after selfhosting',\n      ),\n    )\n  }\n  const extrusionLength = vecLength(n)\n  const pitch = (360.0 / Math.abs(angle)) * extrusionLength\n  // vendored 语义：主 spine=直线、auxiliary=helix，sweepPipeShell 传对象参数\n  // （occt-wasm 运行时接受 auxiliary 键；d.ts 窄签名用 as never 绕过）\n  const endPointTwist: Vec3 = [c[0] + n[0], c[1] + n[1], c[2] + n[2]]\n  const spine = makeSpineWire(kernel, c, endPointTwist)\n  const axisDir = vecLength(n) > 1e-12 ? [n[0] / vecLength(n), n[1] / vecLength(n), n[2] / vecLength(n)] : [0, 0, 1]\n  try {\n    const helix = getOcctKernel().makeHelixWire(\n      { x: c[0], y: c[1], z: c[2] },\n      { x: axisDir[0], y: axisDir[1], z: axisDir[2] },\n      pitch,\n      extrusionLength,\n      1,\n    )\n    const h = getOcctKernel().sweepPipeShell(w as never, spine as never, { auxiliary: helix } as never) as unknown as BrepHandle\n    getOcctKernel().release(helix as never)\n    kernel.release(spine)\n    return ok(h)\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('SWEEP_FAILED', `twistExtrude sweep failed: ${raw}`, e))\n  }\n}\n"]}

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

@@ -1,6 +1,11 @@
 /**
  * Functional thread operation — builds a helical screw thread.
  *
+ * @platform occt — 本文件 import occt-kernel：螺纹用 `loft`
+ * （BRepOffsetAPI_ThruSections）构造，loft 是 occt-only（L1 无，engine-method-map
+ * `loft` → occt-only）。守卫①要求平台 import 自证身份；调用方 op（screw）声明
+ * `engines: ['occt']`（D11）。
+ *
  * 适配自 brepjs `src/operations/threadFns.ts`。
  * 保留文件名和核心算法，适配本项目的 occt-wasm API。
  *
@@ -65,4 +70,14 @@ export interface ThreadOptions {
  * ```
  */
 export declare function threadBrep(kernel: BrepEngineApi, options: ThreadOptions): BrepHandle;
+import { type Result } from '../../result/result.js';
+/**
+ * compat-op wrapper: thread(options) → Result<BrepHandle>.
+ * Converges on core threadBrep (§5.4: vendored compat op and core version merged into one).
+ * threadBrep internal validation throws are caught as Result err (codes THREAD_INVALID_ARGS / THREAD_FAILED).
+ *
+ * @param args - Resolved arguments (thread options).
+ * @returns The generated thread solid as a `BrepHandle`.
+ */
+export declare function threadBrepOp(...args: unknown[]): Result<BrepHandle>;
 //# sourceMappingURL=threadFns.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"threadFns.d.ts","sourceRoot":"","sources":["../../../src/api/brep-mirror/threadFns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAEjE,4BAA4B;AAC5B,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,aAAa,GACrB,UAAU,CA6EZ"}
+{"version":3,"file":"threadFns.d.ts","sourceRoot":"","sources":["../../../src/api/brep-mirror/threadFns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAIjE,4BAA4B;AAC5B,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,aAAa,GACrB,UAAU,CA8EZ;AAWD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAK1D;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAanE"}

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

@@ -1,6 +1,11 @@
 /**
  * Functional thread operation — builds a helical screw thread.
  *
+ * @platform occt — 本文件 import occt-kernel：螺纹用 `loft`
+ * （BRepOffsetAPI_ThruSections）构造，loft 是 occt-only（L1 无，engine-method-map
+ * `loft` → occt-only）。守卫①要求平台 import 自证身份；调用方 op（screw）声明
+ * `engines: ['occt']`（D11）。
+ *
  * 适配自 brepjs `src/operations/threadFns.ts`。
  * 保留文件名和核心算法，适配本项目的 occt-wasm API。
  *
@@ -14,6 +19,8 @@
  * - brepjs 用 DisposalScope 管理中间句柄 → 本项目手动 kernel.release
  * - brepjs 用 Result 类型 → 本项目抛出异常
  */
+import { getOcctKernel } from '../../occt-kernel/occtKernel.js';
+import { getBrepApi } from '../../brep/handle-bridge.js';
 /**
  * 通过 loft 旋转齿截面构建螺旋螺纹 ridge。
  *
@@ -91,8 +98,9 @@ export function threadBrep(kernel, options) {
         const wire = kernel.makeWire(edges);
         sections.push(wire);
     }
-    // Loft
-    const thread = kernel.loft(sections, true, true);
+    // Loft（occt-only 平台面，D3）。BrepHandle（branded number）与 occt-wasm
+    // ShapeHandle 运行时同构，品牌转换只发生在平台边界。
+    const thread = getOcctKernel().loft(sections, true, true);
     // 释放中间句柄
     for (const w of sections)
         kernel.release(w);
@@ -100,4 +108,31 @@ export function threadBrep(kernel, options) {
         kernel.release(e);
     return thread;
 }
+import { resolveArgs } from '../internal/dual-form-args.js';
+import { ok, err } from '../../result/result.js';
+import { validationError, kernelError } from '../../result/errors.js';
+const THREAD_PARAMS = { name: 'thread', params: ['options'], formClass: 'B1' };
+/**
+ * compat-op wrapper: thread(options) → Result<BrepHandle>.
+ * Converges on core threadBrep (§5.4: vendored compat op and core version merged into one).
+ * threadBrep internal validation throws are caught as Result err (codes THREAD_INVALID_ARGS / THREAD_FAILED).
+ *
+ * @param args - Resolved arguments (thread options).
+ * @returns The generated thread solid as a `BrepHandle`.
+ */
+export function threadBrepOp(...args) {
+    const [options] = resolveArgs(args, THREAD_PARAMS);
+    const kernel = getBrepApi();
+    try {
+        const h = threadBrep(kernel, options);
+        return ok(h);
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        if (raw.startsWith('[threadBrep]')) {
+            return err(validationError('THREAD_INVALID_ARGS', raw));
+        }
+        return err(kernelError('THREAD_FAILED', `Thread generation failed: ${raw}`, e));
+    }
+}
 //# sourceMappingURL=threadFns.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"threadFns.js","sourceRoot":"","sources":["../../../src/api/brep-mirror/threadFns.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Functional thread operation — builds a helical screw thread.\n *\n * 适配自 brepjs `src/operations/threadFns.ts`。\n * 保留文件名和核心算法，适配本项目的 occt-wasm API。\n *\n * occt-wasm 的 `BRepOffsetAPI_MakePipeShell` (sweep) 无法可靠地沿螺旋线扫掠截面，\n * 因此螺纹用 loft（`BRepOffsetAPI_ThruSections`）穿过一系列旋转的齿截面构造。\n * 结果是螺旋螺纹的 *ridge* — 外螺纹 fuse 到螺杆，内螺纹 cut 从孔中减去。\n *\n * 与 brepjs 的差异：\n * - brepjs 用 BlueprintSketcher + line() + wire() 构造截面 → 本项目直接用 kernel.makeLineEdge + kernel.makeWire\n * - brepjs 用 loft() 函数 → 本项目直接用 kernel.loft(wires, isSolid, ruled)\n * - brepjs 用 DisposalScope 管理中间句柄 → 本项目手动 kernel.release\n * - brepjs 用 Result 类型 → 本项目抛出异常\n */\n\nimport type { BrepHandle } from '../../brep/engine/types'\nimport type { BrepEngineApi } from '../../brep/engine/primitives'\n\n/** 螺纹配置参数。单位 mm，角度由螺距推导。 */\nexport interface ThreadOptions {\n  /** 核心半径（外螺纹）或名义孔半径（内螺纹），在螺纹根部 */\n  radius: number\n  /** 每圈轴向距离（螺距） */\n  pitch: number\n  /** 螺纹总长（沿轴）。圈数 = height / pitch */\n  height: number\n  /** 径向螺纹高度（齿顶 - 齿根）。默认 0.6 * pitch（≈ISO 60° V 型） */\n  depth?: number\n  /** 齿根处轴向半宽。默认 0.42 * pitch */\n  toothHalfWidth?: number\n  /**\n   * flat 顶宽，给出梯形齿而非尖 V 型。\n   * 0（默认）= 尖 V（ISO/UN）；正值 = 梯形齿（Acme/square）。\n   * 必须 < toothHalfWidth。\n   */\n  crest?: number\n  /** 每圈截面数 — 越高越平滑但越慢。默认 20 */\n  sectionsPerTurn?: number\n  /** 左旋。默认 false（右旋） */\n  lefthand?: boolean\n  /** 齿尖朝向轴心（内螺纹用 cut 从孔中减去时） */\n  inward?: boolean\n}\n\n/**\n * 通过 loft 旋转齿截面构建螺旋螺纹 ridge。\n *\n * @param kernel  OCCT 内核\n * @param options 螺纹配置\n * @returns 螺纹 ridge solid（BrepHandle）\n *\n * @example 外螺纹（Ø12 螺杆，2.5mm 螺距）:\n * ```ts\n * const ridge = threadBrep(kernel, { radius: 6, pitch: 2.5, height: 7.5 })\n * const rod = kernel.makeCylinder(6.15, 7.5)\n * const result = kernel.fuse(rod, ridge)\n * kernel.release(rod)\n * kernel.release(ridge)\n * ```\n *\n * @example 内螺纹（攻丝 Ø6 孔）:\n * ```ts\n * const ridge = threadBrep(kernel, { radius: 3, pitch: 1, height: 6, inward: true })\n * const result = kernel.cut(boredBlock, ridge)\n * kernel.release(ridge)\n * ```\n */\nexport function threadBrep(\n  kernel: BrepEngineApi,\n  options: ThreadOptions,\n): BrepHandle {\n  const {\n    radius,\n    pitch,\n    height,\n    depth = 0.6 * pitch,\n    toothHalfWidth = 0.42 * pitch,\n    crest = 0,\n    sectionsPerTurn = 12,\n    lefthand = false,\n    inward = false,\n  } = options\n\n  // 参数校验\n  if (!(radius > 0)) throw new Error('[threadBrep] radius must be > 0')\n  if (!(pitch > 0)) throw new Error('[threadBrep] pitch must be > 0')\n  if (!(height > 0)) throw new Error('[threadBrep] height must be > 0')\n  if (!(depth > 0)) throw new Error('[threadBrep] depth must be > 0')\n  if (crest < 0 || crest >= toothHalfWidth) {\n    throw new Error('[threadBrep] crest must be >= 0 and < toothHalfWidth')\n  }\n  if (sectionsPerTurn < 3) {\n    throw new Error('[threadBrep] sectionsPerTurn must be >= 3')\n  }\n\n  const turns = height / pitch\n  const nSec = Math.max(2, Math.round(turns * sectionsPerTurn))\n  const sign = lefthand ? -1 : 1\n  const apexU = inward ? -depth : depth // 齿顶：外螺纹朝外，内螺纹朝内\n  const baseU = inward ? 0.3 : -0.3 // 齿根：略微嵌入配合实体以保证布尔干净\n  const a = toothHalfWidth\n\n  // 构建截面序列\n  const sections: BrepHandle[] = []\n  const intermediateEdges: BrepHandle[] = []\n\n  for (let i = 0; i <= nSec; i++) {\n    const th = (sign * i * 2 * Math.PI) / sectionsPerTurn\n    const z = (pitch * Math.abs(th)) / (2 * Math.PI)\n    const cx = radius * Math.cos(th)\n    const cy = radius * Math.sin(th)\n    const rx = Math.cos(th)\n    const ry = Math.sin(th)\n\n    // 点生成函数：u = 径向偏移，v = 轴向偏移\n    const pt = (u: number, v: number) => ({\n      x: cx + u * rx,\n      y: cy + u * ry,\n      z: z + v,\n    })\n\n    // V 型齿（crest=0）通过单个顶点闭合；梯形齿（crest>0）给出平顶\n    const profile = crest > 0\n      ? [pt(baseU, -a), pt(apexU, -crest), pt(apexU, crest), pt(baseU, a)]\n      : [pt(baseU, -a), pt(apexU, 0), pt(baseU, a)]\n\n    // 构建边\n    const edges: BrepHandle[] = []\n    for (let k = 0; k < profile.length; k++) {\n      const edge = kernel.makeLineEdge(profile[k], profile[(k + 1) % profile.length])\n      edges.push(edge)\n      intermediateEdges.push(edge)\n    }\n\n    // 构建 wire\n    const wire = kernel.makeWire(edges)\n    sections.push(wire)\n  }\n\n  // Loft\n  const thread = kernel.loft(sections, true, true)\n\n  // 释放中间句柄\n  for (const w of sections) kernel.release(w)\n  for (const e of intermediateEdges) kernel.release(e)\n\n  return thread\n}\n"]}
+{"version":3,"file":"threadFns.js","sourceRoot":"","sources":["../../../src/api/brep-mirror/threadFns.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Functional thread operation — builds a helical screw thread.\n *\n * @platform occt — 本文件 import occt-kernel：螺纹用 `loft`\n * （BRepOffsetAPI_ThruSections）构造，loft 是 occt-only（L1 无，engine-method-map\n * `loft` → occt-only）。守卫①要求平台 import 自证身份；调用方 op（screw）声明\n * `engines: ['occt']`（D11）。\n *\n * 适配自 brepjs `src/operations/threadFns.ts`。\n * 保留文件名和核心算法，适配本项目的 occt-wasm API。\n *\n * occt-wasm 的 `BRepOffsetAPI_MakePipeShell` (sweep) 无法可靠地沿螺旋线扫掠截面，\n * 因此螺纹用 loft（`BRepOffsetAPI_ThruSections`）穿过一系列旋转的齿截面构造。\n * 结果是螺旋螺纹的 *ridge* — 外螺纹 fuse 到螺杆，内螺纹 cut 从孔中减去。\n *\n * 与 brepjs 的差异：\n * - brepjs 用 BlueprintSketcher + line() + wire() 构造截面 → 本项目直接用 kernel.makeLineEdge + kernel.makeWire\n * - brepjs 用 loft() 函数 → 本项目直接用 kernel.loft(wires, isSolid, ruled)\n * - brepjs 用 DisposalScope 管理中间句柄 → 本项目手动 kernel.release\n * - brepjs 用 Result 类型 → 本项目抛出异常\n */\n\nimport type { BrepHandle } from '../../brep/engine/types'\nimport type { BrepEngineApi } from '../../brep/engine/primitives'\nimport { getOcctKernel, type ShapeHandle } from '../../occt-kernel/occtKernel'\nimport { getBrepApi } from '../../brep/handle-bridge'\n\n/** 螺纹配置参数。单位 mm，角度由螺距推导。 */\nexport interface ThreadOptions {\n  /** 核心半径（外螺纹）或名义孔半径（内螺纹），在螺纹根部 */\n  radius: number\n  /** 每圈轴向距离（螺距） */\n  pitch: number\n  /** 螺纹总长（沿轴）。圈数 = height / pitch */\n  height: number\n  /** 径向螺纹高度（齿顶 - 齿根）。默认 0.6 * pitch（≈ISO 60° V 型） */\n  depth?: number\n  /** 齿根处轴向半宽。默认 0.42 * pitch */\n  toothHalfWidth?: number\n  /**\n   * flat 顶宽，给出梯形齿而非尖 V 型。\n   * 0（默认）= 尖 V（ISO/UN）；正值 = 梯形齿（Acme/square）。\n   * 必须 < toothHalfWidth。\n   */\n  crest?: number\n  /** 每圈截面数 — 越高越平滑但越慢。默认 20 */\n  sectionsPerTurn?: number\n  /** 左旋。默认 false（右旋） */\n  lefthand?: boolean\n  /** 齿尖朝向轴心（内螺纹用 cut 从孔中减去时） */\n  inward?: boolean\n}\n\n/**\n * 通过 loft 旋转齿截面构建螺旋螺纹 ridge。\n *\n * @param kernel  OCCT 内核\n * @param options 螺纹配置\n * @returns 螺纹 ridge solid（BrepHandle）\n *\n * @example 外螺纹（Ø12 螺杆，2.5mm 螺距）:\n * ```ts\n * const ridge = threadBrep(kernel, { radius: 6, pitch: 2.5, height: 7.5 })\n * const rod = kernel.makeCylinder(6.15, 7.5)\n * const result = kernel.fuse(rod, ridge)\n * kernel.release(rod)\n * kernel.release(ridge)\n * ```\n *\n * @example 内螺纹（攻丝 Ø6 孔）:\n * ```ts\n * const ridge = threadBrep(kernel, { radius: 3, pitch: 1, height: 6, inward: true })\n * const result = kernel.cut(boredBlock, ridge)\n * kernel.release(ridge)\n * ```\n */\nexport function threadBrep(\n  kernel: BrepEngineApi,\n  options: ThreadOptions,\n): BrepHandle {\n  const {\n    radius,\n    pitch,\n    height,\n    depth = 0.6 * pitch,\n    toothHalfWidth = 0.42 * pitch,\n    crest = 0,\n    sectionsPerTurn = 12,\n    lefthand = false,\n    inward = false,\n  } = options\n\n  // 参数校验\n  if (!(radius > 0)) throw new Error('[threadBrep] radius must be > 0')\n  if (!(pitch > 0)) throw new Error('[threadBrep] pitch must be > 0')\n  if (!(height > 0)) throw new Error('[threadBrep] height must be > 0')\n  if (!(depth > 0)) throw new Error('[threadBrep] depth must be > 0')\n  if (crest < 0 || crest >= toothHalfWidth) {\n    throw new Error('[threadBrep] crest must be >= 0 and < toothHalfWidth')\n  }\n  if (sectionsPerTurn < 3) {\n    throw new Error('[threadBrep] sectionsPerTurn must be >= 3')\n  }\n\n  const turns = height / pitch\n  const nSec = Math.max(2, Math.round(turns * sectionsPerTurn))\n  const sign = lefthand ? -1 : 1\n  const apexU = inward ? -depth : depth // 齿顶：外螺纹朝外，内螺纹朝内\n  const baseU = inward ? 0.3 : -0.3 // 齿根：略微嵌入配合实体以保证布尔干净\n  const a = toothHalfWidth\n\n  // 构建截面序列\n  const sections: BrepHandle[] = []\n  const intermediateEdges: BrepHandle[] = []\n\n  for (let i = 0; i <= nSec; i++) {\n    const th = (sign * i * 2 * Math.PI) / sectionsPerTurn\n    const z = (pitch * Math.abs(th)) / (2 * Math.PI)\n    const cx = radius * Math.cos(th)\n    const cy = radius * Math.sin(th)\n    const rx = Math.cos(th)\n    const ry = Math.sin(th)\n\n    // 点生成函数：u = 径向偏移，v = 轴向偏移\n    const pt = (u: number, v: number) => ({\n      x: cx + u * rx,\n      y: cy + u * ry,\n      z: z + v,\n    })\n\n    // V 型齿（crest=0）通过单个顶点闭合；梯形齿（crest>0）给出平顶\n    const profile = crest > 0\n      ? [pt(baseU, -a), pt(apexU, -crest), pt(apexU, crest), pt(baseU, a)]\n      : [pt(baseU, -a), pt(apexU, 0), pt(baseU, a)]\n\n    // 构建边\n    const edges: BrepHandle[] = []\n    for (let k = 0; k < profile.length; k++) {\n      const edge = kernel.makeLineEdge(profile[k], profile[(k + 1) % profile.length])\n      edges.push(edge)\n      intermediateEdges.push(edge)\n    }\n\n    // 构建 wire\n    const wire = kernel.makeWire(edges)\n    sections.push(wire)\n  }\n\n  // Loft（occt-only 平台面，D3）。BrepHandle（branded number）与 occt-wasm\n  // ShapeHandle 运行时同构，品牌转换只发生在平台边界。\n  const thread = getOcctKernel().loft(sections as unknown as ShapeHandle[], true, true)\n\n  // 释放中间句柄\n  for (const w of sections) kernel.release(w)\n  for (const e of intermediateEdges) kernel.release(e)\n\n  return thread as unknown as BrepHandle\n}\n\n\n/**\n * compat-op 包装：thread(options) → Result<BrepHandle>。\n * 收敛以 core threadBrep 为准（§5.4：vendored compat op 与 core 版两份收敛为一处）。\n * threadBrep 内部校验抛异常 → 捕获为 Result err（错误码 THREAD_INVALID_ARGS / THREAD_FAILED）。\n */\n\nimport type { FormClass } from '../internal/dual-form-args'\nimport { resolveArgs } from '../internal/dual-form-args'\nimport { ok, err, type Result } from '../../result/result'\nimport { validationError, kernelError } from '../../result/errors'\n\nconst THREAD_PARAMS = { name: 'thread', params: ['options'], formClass: 'B1' as FormClass }\n\n/**\n * compat-op wrapper: thread(options) → Result<BrepHandle>.\n * Converges on core threadBrep (§5.4: vendored compat op and core version merged into one).\n * threadBrep internal validation throws are caught as Result err (codes THREAD_INVALID_ARGS / THREAD_FAILED).\n *\n * @param args - Resolved arguments (thread options).\n * @returns The generated thread solid as a `BrepHandle`.\n */\nexport function threadBrepOp(...args: unknown[]): Result<BrepHandle> {\n  const [options] = resolveArgs(args, THREAD_PARAMS)\n  const kernel = getBrepApi()\n  try {\n    const h = threadBrep(kernel, options as ThreadOptions)\n    return ok(h)\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    if (raw.startsWith('[threadBrep]')) {\n      return err(validationError('THREAD_INVALID_ARGS', raw))\n    }\n    return err(kernelError('THREAD_FAILED', `Thread generation failed: ${raw}`, e))\n  }\n}\n"]}

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

@@ -0,0 +1,74 @@
+/**
+ * Self-hosted compat-op implementations — topology transform family
+ * (core-decouple Phase 3, §5.4).
+ *
+ * @platform occt
+ *
+ * Each export is a "brep-shaped" implementation consumed by the generated
+ * compat-op projection (defineOp + D11 arg normalization). Inputs are the
+ * normalized positional arguments of the op's params table; shapes arrive as
+ * 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`,
+ * `topology/shapeFns.ts`) with the brepjs object model (castResultShape,
+ * metadata propagation, evolution tracking) dropped: occt-wasm handles only.
+ */
+import type { BrepHandle } from '../../brep/engine/types.js';
+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
+ * (`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.
+ *
+ * @param args - Resolved arguments (shape, matrix).
+ * @returns The transformed shape as a `BrepHandle`.
+ */
+export declare function applyMatrixBrep(...args: unknown[]): Result<BrepHandle>;
+/**
+ * Deep-copy a shape (`kernel.copyShape`).
+ *
+ * @param args - Resolved arguments (shape).
+ * @returns The cloned shape as a `BrepHandle`.
+ */
+export declare function cloneBrep(...args: unknown[]): Result<BrepHandle>;
+/**
+ * Placement-only rigid move (translate/rotate) via the kernel's cheap location
+ * re-tag. Ops apply first-to-last (rotate then translate).
+ *
+ * @param args - Resolved arguments (shape, placement).
+ * @returns The relocated shape as a `BrepHandle`.
+ */
+export declare function locateBrep(...args: unknown[]): Result<BrepHandle>;
+/**
+ * Mirror across a plane defined by `options.at` (origin) and `options.normal`.
+ *
+ * @param args - Resolved arguments (shape, mirror options).
+ * @returns The mirrored shape as a `BrepHandle`.
+ */
+export declare function mirrorBrep(...args: unknown[]): Result<BrepHandle>;
+/**
+ * Rotate the shape around an axis (vendored 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).
+ *
+ * @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).
+ *
+ * @param args - Resolved arguments (shape, distance, options).
+ * @returns The offset shape as a `BrepHandle`.
+ */
+export declare function offsetBrep(...args: unknown[]): Result<BrepHandle>;
+//# sourceMappingURL=topologyFns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topologyFns.d.ts","sourceRoot":"","sources":["../../../src/api/brep-mirror/topologyFns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEzD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAoD1D;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAgDtE;AAQD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAchE;AAmBD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAoBjE;AAQD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAiBjE;AAQD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAgCjE;AAOD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAmBhE;AAOD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAejE"}