@faicad/faijs 0.29.5 → 0.30.9

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

@@ -0,0 +1,323 @@
+/**
+ * Self-hosted compat-op implementations — extrude/revolve/sweep family
+ * (core-decouple Phase 3, §5.4; G3).
+ *
+ * @platform occt
+ *
+ * Semantics mirror brepjs `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 core migration (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 (brepjs 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（brepjs 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 沿向量/高度拉伸（brepjs api.js#extrude + extrudeFns.ts#extrude）
+// ---------------------------------------------------------------------------
+/**
+ * Extrude a face along a vector/height (brepjs 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 绕轴旋转（brepjs api.js#revolve；angle 单位弧度，默认 2π）
+// ---------------------------------------------------------------------------
+/**
+ * Revolve a face around an axis (brepjs 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 — 截面沿脊柱扫掠（brepjs sweepFns.ts#sweep）
+// ---------------------------------------------------------------------------
+/**
+ * `sweep` 的完整控制面（S3，方案 §3.4.3）：给出下列任一字段即改走 occt 原生
+ * `sweepFull`（`sweepAdvanced`/`sweepOriented` 的能力是其子集，由同一选项对象承载）。
+ * 未给出任何字段时保持旧路径（`simplePipe` / `sweepPipeShell`）**逐字节不变**。
+ */
+const SWEEP_FULL_KEYS = [
+    'orientation',
+    'up',
+    'auxSpine',
+    'curvilinearEquivalence',
+    'guideContact',
+    'withContact',
+    'withCorrection',
+    'support',
+    'maxDegree',
+    'maxSegments',
+    'law',
+    'lawLength',
+    'lawEndFactor',
+    'tol3d',
+    'boundTol',
+    'tolAngular',
+];
+/** SweepMode 名字 → occt 枚举值（Fixed=0 / Frenet=1 / FixedUp=2 / Auxiliary=3）。 */
+const SWEEP_MODE_CODE = {
+    fixed: 0,
+    frenet: 1,
+    fixedUp: 2,
+    auxiliary: 3,
+};
+/** TransitionMode 名字 → occt 枚举值（Transformed=0 / RightCorner=1 / RoundCorner=2）。 */
+const SWEEP_TRANSITION_CODE = {
+    transformed: 0,
+    rightCorner: 1,
+    roundCorner: 2,
+};
+/** SweepContact 名字 → occt 枚举值（None=0 / Contact=1 / ContactOnBorder=2）。 */
+const SWEEP_CONTACT_CODE = {
+    none: 0,
+    contact: 1,
+    contactOnBorder: 2,
+};
+/** SweepLaw 名字 → occt 枚举值（None=0 / Linear=1 / SCurve=2）。 */
+const SWEEP_LAW_CODE = {
+    none: 0,
+    linear: 1,
+    sCurve: 2,
+};
+/** 是否给出 sweepFull 专有字段（或 transitionMode 的新语义名）。 */
+function wantsSweepFull(cfg) {
+    if (SWEEP_FULL_KEYS.some((k) => cfg[k] !== undefined))
+        return true;
+    return cfg.transitionMode !== undefined && SWEEP_TRANSITION_CODE[cfg.transitionMode] !== undefined;
+}
+/** 选项对象 → occt sweepFull 的 options（只放已给出的键，其余走内核缺省）。 */
+function toSweepFullOptions(cfg) {
+    const opts = {};
+    const pickEnum = (key, field, table) => {
+        const v = cfg[key];
+        if (v === undefined)
+            return;
+        const code = table[String(v)];
+        if (code === undefined) {
+            throw validationError(`E_SWEEP_BAD_${field.toUpperCase()}`, `sweep ${field} '${String(v)}' is invalid (allowed: ${Object.keys(table).join(' / ')})`);
+        }
+        opts[field === 'orientation' ? 'mode' : field] = code;
+    };
+    try {
+        pickEnum('orientation', 'orientation', SWEEP_MODE_CODE);
+        const transition = cfg['transitionMode'];
+        if (transition !== undefined) {
+            // 只要走到这里（wantsSweepFull 为真），transitionMode 必是新语义名之一。
+            opts.transitionMode = SWEEP_TRANSITION_CODE[transition];
+        }
+        pickEnum('guideContact', 'guideContact', SWEEP_CONTACT_CODE);
+        pickEnum('law', 'law', SWEEP_LAW_CODE);
+        const up = cfg['up'];
+        if (up !== undefined) {
+            if (!Array.isArray(up) || up.length !== 3) {
+                throw validationError('E_SWEEP_BAD_UP', 'sweep up must be [x,y,z]');
+            }
+            opts.up = { x: up[0], y: up[1], z: up[2] };
+        }
+        const auxSpine = cfg['auxSpine'];
+        if (auxSpine !== undefined)
+            opts.auxSpine = brepHandleOf(auxSpine);
+        const support = cfg['support'];
+        if (support !== undefined)
+            opts.support = brepHandleOf(support);
+        for (const k of ['curvilinearEquivalence', 'withContact', 'withCorrection']) {
+            if (cfg[k] !== undefined)
+                opts[k] = cfg[k];
+        }
+        for (const k of ['maxDegree', 'maxSegments', 'lawLength', 'lawEndFactor', 'tol3d', 'boundTol', 'tolAngular']) {
+            if (cfg[k] !== undefined)
+                opts[k] = cfg[k];
+        }
+        // 内核硬前置：law 非 none 时 lawLength 必给（occt-wasm 自己也会抛；此处前置给清楚的错误码）。
+        const lawCode = opts.law;
+        if (lawCode !== undefined && lawCode !== SWEEP_LAW_CODE.none && opts.lawLength === undefined) {
+            throw validationError('E_SWEEP_LAW_NEEDS_LENGTH', 'sweep law requires lawLength (the spine length the law spans)');
+        }
+        return ok(opts);
+    }
+    catch (e) {
+        return err(e);
+    }
+}
+/**
+ * Sweep a profile along a spine (brepjs sweepFns.ts#sweep).
+ *
+ * 两条路径（S3）：
+ * - 无 sweepFull 专有字段 → 旧路径（`mode:'simple'` → `simplePipe`；否则 `sweepPipeShell`）；
+ * - 给出任一 sweepFull 字段 → occt 原生 `sweepFull`（完整控制面：朝向模式 / 转角过渡 /
+ *   引导线关系 / 支持面 / 逼近预算 / 缩放律）。`mode:'simple'` 与 sweepFull 字段互斥。
+ *
+ * @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 core migration (cad 面不暴露壳元组 §2.4①)'));
+    }
+    const useFull = wantsSweepFull(cfg);
+    if (!useFull && cfg.transitionMode !== undefined && cfg.transitionMode !== 'right') {
+        return err(validationError('E_SWEEP_TRANSITION_UNSUPPORTED', `sweep transitionMode '${cfg.transitionMode}' is not supported (allowed: 'right' legacy alias, or 'transformed' / 'rightCorner' / 'roundCorner')`));
+    }
+    if (useFull && cfg.mode === 'simple') {
+        return err(validationError('E_SWEEP_MODE_CONFLICT', "sweep mode:'simple' cannot be combined with sweepFull options (orientation / law / transition / support / auxSpine / tolerances)"));
+    }
+    try {
+        if (useFull) {
+            const built = toSweepFullOptions(cfg);
+            if (!built.ok)
+                return err(built.error);
+            return ok(getOcctKernel().sweepFull(w, sp, built.value));
+        }
+        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 挤出（brepjs sweepFns.ts#complexExtrude）
+// ---------------------------------------------------------------------------
+/**
+ * Extrude a wire along a normal (brepjs 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 core migration'));
+    }
+    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 沿螺旋挤出（brepjs sweepFns.ts#twistExtrude）
+// ---------------------------------------------------------------------------
+/**
+ * Extrude a wire along a helical path (brepjs 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 core migration (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 core migration'));
+    }
+    const extrusionLength = vecLength(n);
+    const pitch = (360.0 / Math.abs(angle)) * extrusionLength;
+    // brepjs 语义：主 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-operations/sweepFns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweepFns.js","sourceRoot":"","sources":["../../../src/api/brep-operations/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 brepjs `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 core migration (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 (brepjs 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 '../geom-types/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（brepjs 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 沿向量/高度拉伸（brepjs api.js#extrude + extrudeFns.ts#extrude）\n// ---------------------------------------------------------------------------\n\n/**\n * Extrude a face along a vector/height (brepjs 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 绕轴旋转（brepjs api.js#revolve；angle 单位弧度，默认 2π）\n// ---------------------------------------------------------------------------\n\n/**\n * Revolve a face around an axis (brepjs 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 — 截面沿脊柱扫掠（brepjs sweepFns.ts#sweep）\n// ---------------------------------------------------------------------------\n\n/**\n * `sweep` 的完整控制面（S3，方案 §3.4.3）：给出下列任一字段即改走 occt 原生\n * `sweepFull`（`sweepAdvanced`/`sweepOriented` 的能力是其子集，由同一选项对象承载）。\n * 未给出任何字段时保持旧路径（`simplePipe` / `sweepPipeShell`）**逐字节不变**。\n */\nconst SWEEP_FULL_KEYS = [\n  'orientation',\n  'up',\n  'auxSpine',\n  'curvilinearEquivalence',\n  'guideContact',\n  'withContact',\n  'withCorrection',\n  'support',\n  'maxDegree',\n  'maxSegments',\n  'law',\n  'lawLength',\n  'lawEndFactor',\n  'tol3d',\n  'boundTol',\n  'tolAngular',\n] as const\n\n/** SweepMode 名字 → occt 枚举值（Fixed=0 / Frenet=1 / FixedUp=2 / Auxiliary=3）。 */\nconst SWEEP_MODE_CODE: Record<string, number> = {\n  fixed: 0,\n  frenet: 1,\n  fixedUp: 2,\n  auxiliary: 3,\n}\n/** TransitionMode 名字 → occt 枚举值（Transformed=0 / RightCorner=1 / RoundCorner=2）。 */\nconst SWEEP_TRANSITION_CODE: Record<string, number> = {\n  transformed: 0,\n  rightCorner: 1,\n  roundCorner: 2,\n}\n/** SweepContact 名字 → occt 枚举值（None=0 / Contact=1 / ContactOnBorder=2）。 */\nconst SWEEP_CONTACT_CODE: Record<string, number> = {\n  none: 0,\n  contact: 1,\n  contactOnBorder: 2,\n}\n/** SweepLaw 名字 → occt 枚举值（None=0 / Linear=1 / SCurve=2）。 */\nconst SWEEP_LAW_CODE: Record<string, number> = {\n  none: 0,\n  linear: 1,\n  sCurve: 2,\n}\n\n/** sweep 配置（`sweepFns` 侧形态；faijs 面 = api/sweep.ts 的 SweepOptions）。 */\ninterface SweepConfig {\n  mode?: string\n  frenet?: boolean\n  transitionMode?: string\n  [k: string]: unknown\n}\n\n/** 是否给出 sweepFull 专有字段（或 transitionMode 的新语义名）。 */\nfunction wantsSweepFull(cfg: SweepConfig): boolean {\n  if (SWEEP_FULL_KEYS.some((k) => cfg[k] !== undefined)) return true\n  return cfg.transitionMode !== undefined && SWEEP_TRANSITION_CODE[cfg.transitionMode] !== undefined\n}\n\n/** 选项对象 → occt sweepFull 的 options（只放已给出的键，其余走内核缺省）。 */\nfunction toSweepFullOptions(\n  cfg: SweepConfig,\n): Result<Record<string, unknown>, ReturnType<typeof validationError>> {\n  const opts: Record<string, unknown> = {}\n  const pickEnum = (key: string, field: string, table: Record<string, number>): void => {\n    const v = cfg[key]\n    if (v === undefined) return\n    const code = table[String(v)]\n    if (code === undefined) {\n      throw validationError(\n        `E_SWEEP_BAD_${field.toUpperCase()}`,\n        `sweep ${field} '${String(v)}' is invalid (allowed: ${Object.keys(table).join(' / ')})`,\n      )\n    }\n    opts[field === 'orientation' ? 'mode' : field] = code\n  }\n  try {\n    pickEnum('orientation', 'orientation', SWEEP_MODE_CODE)\n    const transition = cfg['transitionMode']\n    if (transition !== undefined) {\n      // 只要走到这里（wantsSweepFull 为真），transitionMode 必是新语义名之一。\n      opts.transitionMode = SWEEP_TRANSITION_CODE[transition]\n    }\n    pickEnum('guideContact', 'guideContact', SWEEP_CONTACT_CODE)\n    pickEnum('law', 'law', SWEEP_LAW_CODE)\n\n    const up = cfg['up'] as readonly number[] | undefined\n    if (up !== undefined) {\n      if (!Array.isArray(up) || up.length !== 3) {\n        throw validationError('E_SWEEP_BAD_UP', 'sweep up must be [x,y,z]')\n      }\n      opts.up = { x: up[0], y: up[1], z: up[2] }\n    }\n    const auxSpine = cfg['auxSpine']\n    if (auxSpine !== undefined) opts.auxSpine = brepHandleOf(auxSpine)\n    const support = cfg['support']\n    if (support !== undefined) opts.support = brepHandleOf(support)\n    for (const k of ['curvilinearEquivalence', 'withContact', 'withCorrection'] as const) {\n      if (cfg[k] !== undefined) opts[k] = cfg[k]\n    }\n    for (const k of ['maxDegree', 'maxSegments', 'lawLength', 'lawEndFactor', 'tol3d', 'boundTol', 'tolAngular'] as const) {\n      if (cfg[k] !== undefined) opts[k] = cfg[k]\n    }\n    // 内核硬前置：law 非 none 时 lawLength 必给（occt-wasm 自己也会抛；此处前置给清楚的错误码）。\n    const lawCode = opts.law as number | undefined\n    if (lawCode !== undefined && lawCode !== SWEEP_LAW_CODE.none && opts.lawLength === undefined) {\n      throw validationError(\n        'E_SWEEP_LAW_NEEDS_LENGTH',\n        'sweep law requires lawLength (the spine length the law spans)',\n      )\n    }\n    return ok(opts)\n  } catch (e) {\n    return err(e as ReturnType<typeof validationError>)\n  }\n}\n\n/**\n * Sweep a profile along a spine (brepjs sweepFns.ts#sweep).\n *\n * 两条路径（S3）：\n * - 无 sweepFull 专有字段 → 旧路径（`mode:'simple'` → `simplePipe`；否则 `sweepPipeShell`）；\n * - 给出任一 sweepFull 字段 → occt 原生 `sweepFull`（完整控制面：朝向模式 / 转角过渡 /\n *   引导线关系 / 支持面 / 逼近预算 / 缩放律）。`mode:'simple'` 与 sweepFull 字段互斥。\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 SweepConfig\n  if (shellMode === true) {\n    return err(\n      validationError(\n        'SWEEP_SHELL_MODE_UNSUPPORTED',\n        'sweep shellMode is not supported after core migration (cad 面不暴露壳元组 §2.4①)',\n      ),\n    )\n  }\n  const useFull = wantsSweepFull(cfg)\n  if (!useFull && cfg.transitionMode !== undefined && cfg.transitionMode !== 'right') {\n    return err(\n      validationError(\n        'E_SWEEP_TRANSITION_UNSUPPORTED',\n        `sweep transitionMode '${cfg.transitionMode}' is not supported (allowed: 'right' legacy alias, or 'transformed' / 'rightCorner' / 'roundCorner')`,\n      ),\n    )\n  }\n  if (useFull && cfg.mode === 'simple') {\n    return err(\n      validationError(\n        'E_SWEEP_MODE_CONFLICT',\n        \"sweep mode:'simple' cannot be combined with sweepFull options (orientation / law / transition / support / auxSpine / tolerances)\",\n      ),\n    )\n  }\n  try {\n    if (useFull) {\n      const built = toSweepFullOptions(cfg)\n      if (!built.ok) return err(built.error)\n      return ok(getOcctKernel().sweepFull(w as never, sp as never, built.value as never) as unknown as BrepHandle)\n    }\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 挤出（brepjs sweepFns.ts#complexExtrude）\n// ---------------------------------------------------------------------------\n\n/**\n * Extrude a wire along a normal (brepjs 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 core migration',\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 沿螺旋挤出（brepjs sweepFns.ts#twistExtrude）\n// ---------------------------------------------------------------------------\n\n/**\n * Extrude a wire along a helical path (brepjs 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 core migration (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 core migration',\n      ),\n    )\n  }\n  const extrusionLength = vecLength(n)\n  const pitch = (360.0 / Math.abs(angle)) * extrusionLength\n  // brepjs 语义：主 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-operations/threadFns.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 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。
+ *
+ * occt-wasm 的 `BRepOffsetAPI_MakePipeShell` (sweep) 无法可靠地沿螺旋线扫掠截面，
+ * 因此螺纹用 loft（`BRepOffsetAPI_ThruSections`）穿过一系列旋转的齿截面构造。
+ * 结果是螺旋螺纹的 *ridge* — 外螺纹 fuse 到螺杆，内螺纹 cut 从孔中减去。
+ *
+ * 与 brepjs 的差异：
+ * - brepjs 用 BlueprintSketcher + line() + wire() 构造截面 → 本项目直接用 kernel.makeLineEdge + kernel.makeWire
+ * - brepjs 用 loft() 函数 → 本项目直接用 kernel.loft(wires, isSolid, ruled)
+ * - brepjs 用 DisposalScope 管理中间句柄 → 本项目手动 kernel.release
+ * - brepjs 用 Result 类型 → 本项目抛出异常
+ */
+import type { BrepHandle } from '../../brep/engine/types.js';
+import type { BrepEngineApi } from '../../brep/engine/primitives.js';
+/** 螺纹配置参数。单位 mm，角度由螺距推导。 */
+export interface ThreadOptions {
+    /** 核心半径（外螺纹）或名义孔半径（内螺纹），在螺纹根部 */
+    radius: number;
+    /** 每圈轴向距离（螺距） */
+    pitch: number;
+    /** 螺纹总长（沿轴）。圈数 = height / pitch */
+    height: number;
+    /** 径向螺纹高度（齿顶 - 齿根）。默认 0.6 * pitch（≈ISO 60° V 型） */
+    depth?: number;
+    /** 齿根处轴向半宽。默认 0.42 * pitch */
+    toothHalfWidth?: number;
+    /**
+     * flat 顶宽，给出梯形齿而非尖 V 型。
+     * 0（默认）= 尖 V（ISO/UN）；正值 = 梯形齿（Acme/square）。
+     * 必须 < toothHalfWidth。
+     */
+    crest?: number;
+    /** 每圈截面数 — 越高越平滑但越慢。默认 20 */
+    sectionsPerTurn?: number;
+    /** 左旋。默认 false（右旋） */
+    lefthand?: boolean;
+    /** 齿尖朝向轴心（内螺纹用 cut 从孔中减去时） */
+    inward?: boolean;
+}
+/**
+ * 通过 loft 旋转齿截面构建螺旋螺纹 ridge。
+ *
+ * @param kernel  OCCT 内核
+ * @param options 螺纹配置
+ * @returns 螺纹 ridge solid（BrepHandle）
+ *
+ * @example 外螺纹（Ø12 螺杆，2.5mm 螺距）:
+ * ```ts
+ * const ridge = threadBrep(kernel, { radius: 6, pitch: 2.5, height: 7.5 })
+ * const rod = kernel.makeCylinder(6.15, 7.5)
+ * const result = kernel.fuse(rod, ridge)
+ * kernel.release(rod)
+ * kernel.release(ridge)
+ * ```
+ *
+ * @example 内螺纹（攻丝 Ø6 孔）:
+ * ```ts
+ * const ridge = threadBrep(kernel, { radius: 3, pitch: 1, height: 6, inward: true })
+ * const result = kernel.cut(boredBlock, ridge)
+ * kernel.release(ridge)
+ * ```
+ */
+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: brepjs 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-operations/threadFns.d.ts.map

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

@@ -0,0 +1,138 @@
+/**
+ * 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。
+ *
+ * occt-wasm 的 `BRepOffsetAPI_MakePipeShell` (sweep) 无法可靠地沿螺旋线扫掠截面，
+ * 因此螺纹用 loft（`BRepOffsetAPI_ThruSections`）穿过一系列旋转的齿截面构造。
+ * 结果是螺旋螺纹的 *ridge* — 外螺纹 fuse 到螺杆，内螺纹 cut 从孔中减去。
+ *
+ * 与 brepjs 的差异：
+ * - brepjs 用 BlueprintSketcher + line() + wire() 构造截面 → 本项目直接用 kernel.makeLineEdge + kernel.makeWire
+ * - brepjs 用 loft() 函数 → 本项目直接用 kernel.loft(wires, isSolid, ruled)
+ * - brepjs 用 DisposalScope 管理中间句柄 → 本项目手动 kernel.release
+ * - brepjs 用 Result 类型 → 本项目抛出异常
+ */
+import { getOcctKernel } from '../../occt-kernel/occtKernel.js';
+import { getBrepApi } from '../../brep/handle-bridge.js';
+/**
+ * 通过 loft 旋转齿截面构建螺旋螺纹 ridge。
+ *
+ * @param kernel  OCCT 内核
+ * @param options 螺纹配置
+ * @returns 螺纹 ridge solid（BrepHandle）
+ *
+ * @example 外螺纹（Ø12 螺杆，2.5mm 螺距）:
+ * ```ts
+ * const ridge = threadBrep(kernel, { radius: 6, pitch: 2.5, height: 7.5 })
+ * const rod = kernel.makeCylinder(6.15, 7.5)
+ * const result = kernel.fuse(rod, ridge)
+ * kernel.release(rod)
+ * kernel.release(ridge)
+ * ```
+ *
+ * @example 内螺纹（攻丝 Ø6 孔）:
+ * ```ts
+ * const ridge = threadBrep(kernel, { radius: 3, pitch: 1, height: 6, inward: true })
+ * const result = kernel.cut(boredBlock, ridge)
+ * kernel.release(ridge)
+ * ```
+ */
+export function threadBrep(kernel, options) {
+    const { radius, pitch, height, depth = 0.6 * pitch, toothHalfWidth = 0.42 * pitch, crest = 0, sectionsPerTurn = 12, lefthand = false, inward = false, } = options;
+    // 参数校验
+    if (!(radius > 0))
+        throw new Error('[threadBrep] radius must be > 0');
+    if (!(pitch > 0))
+        throw new Error('[threadBrep] pitch must be > 0');
+    if (!(height > 0))
+        throw new Error('[threadBrep] height must be > 0');
+    if (!(depth > 0))
+        throw new Error('[threadBrep] depth must be > 0');
+    if (crest < 0 || crest >= toothHalfWidth) {
+        throw new Error('[threadBrep] crest must be >= 0 and < toothHalfWidth');
+    }
+    if (sectionsPerTurn < 3) {
+        throw new Error('[threadBrep] sectionsPerTurn must be >= 3');
+    }
+    const turns = height / pitch;
+    const nSec = Math.max(2, Math.round(turns * sectionsPerTurn));
+    const sign = lefthand ? -1 : 1;
+    const apexU = inward ? -depth : depth; // 齿顶：外螺纹朝外，内螺纹朝内
+    const baseU = inward ? 0.3 : -0.3; // 齿根：略微嵌入配合实体以保证布尔干净
+    const a = toothHalfWidth;
+    // 构建截面序列
+    const sections = [];
+    const intermediateEdges = [];
+    for (let i = 0; i <= nSec; i++) {
+        const th = (sign * i * 2 * Math.PI) / sectionsPerTurn;
+        const z = (pitch * Math.abs(th)) / (2 * Math.PI);
+        const cx = radius * Math.cos(th);
+        const cy = radius * Math.sin(th);
+        const rx = Math.cos(th);
+        const ry = Math.sin(th);
+        // 点生成函数：u = 径向偏移，v = 轴向偏移
+        const pt = (u, v) => ({
+            x: cx + u * rx,
+            y: cy + u * ry,
+            z: z + v,
+        });
+        // V 型齿（crest=0）通过单个顶点闭合；梯形齿（crest>0）给出平顶
+        const profile = crest > 0
+            ? [pt(baseU, -a), pt(apexU, -crest), pt(apexU, crest), pt(baseU, a)]
+            : [pt(baseU, -a), pt(apexU, 0), pt(baseU, a)];
+        // 构建边
+        const edges = [];
+        for (let k = 0; k < profile.length; k++) {
+            const edge = kernel.makeLineEdge(profile[k], profile[(k + 1) % profile.length]);
+            edges.push(edge);
+            intermediateEdges.push(edge);
+        }
+        // 构建 wire
+        const wire = kernel.makeWire(edges);
+        sections.push(wire);
+    }
+    // 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);
+    for (const e of intermediateEdges)
+        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: brepjs 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-operations/threadFns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threadFns.js","sourceRoot":"","sources":["../../../src/api/brep-operations/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：brepjs 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: brepjs 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"]}