@faicad/fai-cq-gears 0.13.0

package/dist/rack_gear.d.ts

@@ -0,0 +1,125 @@
+/**
+ * rack_gear — RackGear / HerringboneRackGear（齿条）实体构造
+ *
+ * 对应 `RackGear._build_gear_faces()` + `_build()`（`HerringboneRackGear` 只覆盖
+ * `_build_tooth_faces`，其余全部继承）：
+ *
+ * ```
+ * ① 齿面：4 段梯形直线廓形 × 2 行（z=0 / z=width，行间 x 平移 tx=tan(h)·width）
+ *    → 2×2 点阵 → spline 面（Herringbone：上下两半正反螺旋，共 8 面/齿）
+ * ② 沿 X 以 π·m 为步距复制齿（按螺旋方向多补 extra 个），端部用
+ *    x=0 / x=length 两块大平面 `split` 裁剪（compound → 按 bbox 取碎片）
+ * ③ 左/右侧面：收 x=0 / x=length 平面上的齿面边 + 3 条轮廓线 → 组线 → 平面
+ * ④ 背面（y=ld−height 矩形）+ 顶/底盖面（收 z=width / z=0 的边组线成面）
+ * ⑤ sew → makeSolid → fixFaceOrientations
+ * ```
+ *
+ * 官方 `build()` 对齿条**无** bore/chamfer 特征（`_build` 只做 faces→shell→solid），
+ * 所以回归体积直接对照 regression json 的 expected。
+ */
+import type { BrepHandle } from '@faicad/faijs';
+import type { GearKernel } from '@faicad/cq-compat';
+import { type RackGearGeometry, type RackGearParams } from './profile.js';
+import { type SplineFaceStrategy } from './spline-face.js';
+import { type Vec3 } from './math.js';
+/** RackGear 实体构造选项。 */
+export interface BuildRackGearOptions {
+    strategy?: SplineFaceStrategy;
+    /** 缝合容差（cq `shell_sewing_tol`）。 */
+    shellSewingTol?: number;
+    /** 组线容差（cq `wire_comb_tol`）。 */
+    wireCombTol?: number;
+    /** HerringboneRackGear：齿宽上下两半正反螺旋。 */
+    herringbone?: boolean;
+}
+/**
+ * ① 基础齿面（单个齿位，未平移）：普通 4 面，Herringbone 上下两半共 8 面。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param geom 齿条几何量
+ * @param herringbone 是否人字齿（上下两半螺旋方向相反）
+ * @param strategy 样条建面策略
+ * @returns 基础齿面数组（4 或 8 个面）
+ */
+export declare function rackToothFaces(kernel: GearKernel, geom: RackGearGeometry, herringbone: boolean, strategy: SplineFaceStrategy): BrepHandle[];
+/**
+ * ② 单个齿位的齿面：基础齿面沿 X 平移 `π·m·i`，然后按 cq 顺序做左/右端裁剪。
+ *
+ * cq 的 split 语义（probe-rack.ts 已实测）：
+ * - 工具平面与面相交 → compound，碎片按 bbox.xmax / xmin 取
+ * - 不相交 → 原面单返回（cq 返回 face 本身），再按 bbox 判断丢弃
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param base 基础齿面数组（rackToothFaces 的产物）
+ * @param dx 齿位沿 X 的平移量（π·m·i）
+ * @param i 齿位序号（决定触发哪一侧裁剪分支）
+ * @param geom 齿条几何量
+ * @param extra 端部补齿数（Python `extra`）
+ * @param cutL 左端裁剪平面（x=0）
+ * @param cutR 右端裁剪平面（x=length）
+ * @returns 保留的面；完全被裁掉时返回空数组
+ */
+export declare function toothAtPosition(kernel: GearKernel, base: BrepHandle[], dx: number, i: number, geom: RackGearGeometry, extra: number, cutL: BrepHandle, cutR: BrepHandle): BrepHandle[];
+/**
+ * 大平面工具（cq `Face.makePlane(length, width, basePnt, dir)` 的等价物）。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param length 平面在局部 u 方向的长度
+ * @param width 平面在局部 v 方向的宽度
+ * @param basePnt 平面中心点
+ * @param dir 平面法向
+ * @returns 矩形平面 Face
+ */
+export declare function cutPlane(kernel: GearKernel, length: number, width: number, basePnt: Vec3, dir: Vec3): BrepHandle;
+/**
+ * 收集边集合里「边中心 X 为极值」的边（cq `edges('<X'/'>X')` 语义）。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param faces 候选面集合
+ * @param side 取最小（left）还是最大（right）
+ * @returns 中心落在极值 ±容差内的边
+ */
+export declare function extremeXEdges(kernel: GearKernel, faces: BrepHandle[], side: 'left' | 'right'): BrepHandle[];
+/**
+ * ③ 端面（cq 左/右侧面）：裁剪后的齿面在端部截面上的边 + 3 条轮廓直线
+ * （沿截面到背面 y=ld−height 的两条横线 + 背面竖线），组线成面。
+ *
+ * cq 的辅助线从 `vertices('<Z')` / `vertices('>Z')` 出发——即截面链上 **z 最小/
+ * 最大的端点**（其 y 未必是链上 y 的极值，螺旋齿条下两者不同）。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param toothFaces 裁剪后的齿面集合
+ * @param side 左端（x=0）还是右端（x=length）
+ * @param geom 齿条几何量
+ * @param wireCombTol 组线容差
+ * @returns 端面 Face
+ */
+export declare function endCapFace(kernel: GearKernel, toothFaces: BrepHandle[], side: 'left' | 'right', geom: RackGearGeometry, wireCombTol: number): BrepHandle;
+/**
+ * ④ 背面：y = ld−height 平面上的 length×width 矩形（cq `.rect(length, width, centered=False)`）。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param geom 齿条几何量
+ * @returns 背面 Face
+ */
+export declare function backFace(kernel: GearKernel, geom: RackGearGeometry): BrepHandle;
+/**
+ * ④ 顶/底盖面：收所有面在 z=const 平面上的边界边 → 组线（外轮廓 1 条，含齿谷
+ * 波形与两侧背线）→ 平面。cq `.edges('>Z'/ '<Z').consolidateWires()` 后取第一条。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param faces 候选面集合（齿面 + 端面 + 背面）
+ * @param z 盖面所在高度（width 或 0）
+ * @returns 盖面 Face（开环 wire 建面，与 cq 语义一致）
+ */
+export declare function planarCapAtZ(kernel: GearKernel, faces: BrepHandle[], z: number): BrepHandle;
+/**
+ * ①–⑤：完整 RackGear / HerringboneRackGear 实体。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param params 齿条参数（逐字沿用 Python 构造参数名）
+ * @param build 构造选项（策略/容差覆盖）
+ * @returns solid
+ */
+export declare function buildRackGearSolid(kernel: GearKernel, params: RackGearParams, build?: BuildRackGearOptions): BrepHandle;
+//# sourceMappingURL=rack_gear.d.ts.map

package/dist/rack_gear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rack_gear.d.ts","sourceRoot":"","sources":["../src/rack_gear.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAEL,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAC3C,MAAM,WAAW,CAAA;AAClB,OAAO,EAAiD,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEtG,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,QAAQ,CAAA;AAaxC,uBAAuB;AACvB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAC7B,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sCAAsC;IACtC,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAqBD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,OAAO,EACpB,QAAQ,EAAE,kBAAkB,GAC3B,UAAU,EAAE,CAuBd;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,UAAU,EAAE,EAClB,EAAE,EAAE,MAAM,EACV,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,UAAU,GACf,UAAU,EAAE,CAqCd;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAC7B,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GACvB,UAAU,CAyBZ;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAC9D,UAAU,EAAE,CAad;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,UAAU,EAAE,EACxB,IAAI,EAAE,MAAM,GAAG,OAAO,EACtB,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,MAAM,GAClB,UAAU,CA2BZ;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,gBAAgB,GAAG,UAAU,CAU/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,UAAU,EAAE,EACnB,CAAC,EAAE,MAAM,GACR,UAAU,CAoBZ;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,cAAc,EACtB,KAAK,GAAE,oBAAyB,GAC/B,UAAU,CA4DZ"}

package/dist/rack_gear.js

@@ -0,0 +1,344 @@
+/**
+ * rack_gear — RackGear / HerringboneRackGear（齿条）实体构造
+ *
+ * 对应 `RackGear._build_gear_faces()` + `_build()`（`HerringboneRackGear` 只覆盖
+ * `_build_tooth_faces`，其余全部继承）：
+ *
+ * ```
+ * ① 齿面：4 段梯形直线廓形 × 2 行（z=0 / z=width，行间 x 平移 tx=tan(h)·width）
+ *    → 2×2 点阵 → spline 面（Herringbone：上下两半正反螺旋，共 8 面/齿）
+ * ② 沿 X 以 π·m 为步距复制齿（按螺旋方向多补 extra 个），端部用
+ *    x=0 / x=length 两块大平面 `split` 裁剪（compound → 按 bbox 取碎片）
+ * ③ 左/右侧面：收 x=0 / x=length 平面上的齿面边 + 3 条轮廓线 → 组线 → 平面
+ * ④ 背面（y=ld−height 矩形）+ 顶/底盖面（收 z=width / z=0 的边组线成面）
+ * ⑤ sew → makeSolid → fixFaceOrientations
+ * ```
+ *
+ * 官方 `build()` 对齿条**无** bore/chamfer 特征（`_build` 只做 faces→shell→solid），
+ * 所以回归体积直接对照 regression json 的 expected。
+ */
+import { GEAR_BASE_CONSTANTS, rackGearGeometry, } from './profile.js';
+import { buildSplineFace, DEFAULT_SPLINE_FACE_STRATEGY } from './spline-face.js';
+import { connectEdgesToWires, gearEdgeEnds as edgeEnds, gearShellToSolid as shellToSolid } from '@faicad/cq-compat';
+import { vec3 } from './math.js';
+/** 侧端裁剪平面比齿廓超出的余量（Python `cp_ext`）。 */
+const CP_EXT = 10.0;
+/** 判定「边完全落在某坐标平面」的容差（远小于 wire_comb_tol）。 */
+const PLANAR_PICK_TOL = 1e-6;
+/**
+ * 顶/底盖面组线合并容差：cq `consolidateWires` 链接样条近似边时依赖
+ * 样条容差量级的顶点合并（1e-2），不是拓扑容差 1e-6（probe-case26.py 实证）。
+ */
+const CAP_WIRE_MERGE_TOL = 1e-2;
+/**
+ * 一个齿面段的 2×2 点阵：底行在 `z`（x 平移 `x`），顶行在 `z+w`（x 再平移
+ * `tan(helix)·w`）。cq `_build_tooth_faces` 的 pts1/pts2 逐字对应。
+ */
+function rackFaceGrid(segPts, seg, helixRad, x, z, w) {
+    const tx = Math.tan(helixRad) * w;
+    return {
+        segment: seg,
+        rows: 2,
+        cols: 2,
+        points: [
+            segPts.map((p) => vec3(p.x + x, p.y, z)),
+            segPts.map((p) => vec3(p.x + x + tx, p.y, z + w)),
+        ],
+    };
+}
+/**
+ * ① 基础齿面（单个齿位，未平移）：普通 4 面，Herringbone 上下两半共 8 面。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param geom 齿条几何量
+ * @param herringbone 是否人字齿（上下两半螺旋方向相反）
+ * @param strategy 样条建面策略
+ * @returns 基础齿面数组（4 或 8 个面）
+ */
+export function rackToothFaces(kernel, geom, herringbone, strategy) {
+    const segs = [
+        ['lflank', geom.t_lflank_pts],
+        ['tip', geom.t_tip_pts],
+        ['rflank', geom.t_rflank_pts],
+        ['root', geom.t_root_pts],
+    ];
+    const faces = [];
+    const half = geom.width / 2;
+    if (herringbone) {
+        const tx = Math.tan(geom.helixAngle) * half;
+        for (const [seg, pts] of segs) {
+            // 下半：正向螺旋，z ∈ [0, width/2]
+            faces.push(buildSplineFace(kernel, rackFaceGrid(pts, seg, geom.helixAngle, 0, 0, half), strategy));
+            // 上半：反向螺旋，起点 x 平移 tx，z ∈ [width/2, width]
+            faces.push(buildSplineFace(kernel, rackFaceGrid(pts, seg, -geom.helixAngle, tx, half, half), strategy));
+        }
+    }
+    else {
+        for (const [seg, pts] of segs) {
+            faces.push(buildSplineFace(kernel, rackFaceGrid(pts, seg, geom.helixAngle, 0, 0, geom.width), strategy));
+        }
+    }
+    return faces;
+}
+/**
+ * ② 单个齿位的齿面：基础齿面沿 X 平移 `π·m·i`，然后按 cq 顺序做左/右端裁剪。
+ *
+ * cq 的 split 语义（probe-rack.ts 已实测）：
+ * - 工具平面与面相交 → compound，碎片按 bbox.xmax / xmin 取
+ * - 不相交 → 原面单返回（cq 返回 face 本身），再按 bbox 判断丢弃
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param base 基础齿面数组（rackToothFaces 的产物）
+ * @param dx 齿位沿 X 的平移量（π·m·i）
+ * @param i 齿位序号（决定触发哪一侧裁剪分支）
+ * @param geom 齿条几何量
+ * @param extra 端部补齿数（Python `extra`）
+ * @param cutL 左端裁剪平面（x=0）
+ * @param cutR 右端裁剪平面（x=length）
+ * @returns 保留的面；完全被裁掉时返回空数组
+ */
+export function toothAtPosition(kernel, base, dx, i, geom, extra, cutL, cutR) {
+    const faces = [];
+    for (const tf of base) {
+        let face = kernel.translate(tf, dx, 0, 0);
+        if (i <= extra + 1) {
+            const cpd = kernel.split(face, [cutL]);
+            const frags = kernel.isFace(cpd) ? [cpd] : kernel.getSubShapes(cpd, 'face');
+            if (frags.length > 1) {
+                // compound：取 bbox.xmax 最大的碎片（cq max(key=get_xmax)）
+                let best = frags[0];
+                for (const f of frags) {
+                    if (kernel.getBoundingBox(f).xmax > kernel.getBoundingBox(best).xmax)
+                        best = f;
+                }
+                face = best;
+            }
+            else {
+                face = frags[0];
+                if (kernel.getBoundingBox(face).xmax < 0.0)
+                    continue;
+            }
+        }
+        if (i >= geom.z - extra - 1) {
+            const cpd = kernel.split(face, [cutR]);
+            const frags = kernel.isFace(cpd) ? [cpd] : kernel.getSubShapes(cpd, 'face');
+            if (frags.length > 1) {
+                // compound：取 bbox.xmin 最小的碎片（cq min(key=get_xmin)）
+                let best = frags[0];
+                for (const f of frags) {
+                    if (kernel.getBoundingBox(f).xmin < kernel.getBoundingBox(best).xmin)
+                        best = f;
+                }
+                face = best;
+            }
+            else {
+                face = frags[0];
+                if (kernel.getBoundingBox(face).xmin > geom.length)
+                    continue;
+            }
+        }
+        faces.push(face);
+    }
+    return faces;
+}
+/**
+ * 大平面工具（cq `Face.makePlane(length, width, basePnt, dir)` 的等价物）。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param length 平面在局部 u 方向的长度
+ * @param width 平面在局部 v 方向的宽度
+ * @param basePnt 平面中心点
+ * @param dir 平面法向
+ * @returns 矩形平面 Face
+ */
+export function cutPlane(kernel, length, width, basePnt, dir) {
+    // 面法向 dir，面内局部坐标：任取与 dir 垂直的两个轴
+    const ref = Math.abs(dir.z) < 0.9 ? vec3(0, 0, 1) : vec3(1, 0, 0);
+    let u = vec3(dir.y * ref.z - dir.z * ref.y, dir.z * ref.x - dir.x * ref.z, dir.x * ref.y - dir.y * ref.x);
+    const un = Math.hypot(u.x, u.y, u.z);
+    u = vec3(u.x / un, u.y / un, u.z / un);
+    const v = vec3(dir.y * u.z - dir.z * u.y, dir.z * u.x - dir.x * u.z, dir.x * u.y - dir.y * u.x);
+    const h = length / 2;
+    const w = width / 2;
+    const p = (a, b) => vec3(basePnt.x + u.x * a + v.x * b, basePnt.y + u.y * a + v.y * b, basePnt.z + u.z * a + v.z * b);
+    const es = [
+        kernel.makeLineEdge(p(-h, -w), p(h, -w)),
+        kernel.makeLineEdge(p(h, -w), p(h, w)),
+        kernel.makeLineEdge(p(h, w), p(-h, w)),
+        kernel.makeLineEdge(p(-h, w), p(-h, -w)),
+    ];
+    return kernel.makeFace(kernel.makeWire(es));
+}
+/**
+ * 收集边集合里「边中心 X 为极值」的边（cq `edges('<X'/'>X')` 语义）。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param faces 候选面集合
+ * @param side 取最小（left）还是最大（right）
+ * @returns 中心落在极值 ±容差内的边
+ */
+export function extremeXEdges(kernel, faces, side) {
+    let extreme = side === 'left' ? Infinity : -Infinity;
+    const centers = [];
+    for (const f of faces) {
+        for (const e of kernel.getSubShapes(f, 'edge')) {
+            const bb = kernel.getBoundingBox(e);
+            const cx = (bb.xmin + bb.xmax) / 2;
+            centers.push({ e, cx });
+            extreme = side === 'left' ? Math.min(extreme, cx) : Math.max(extreme, cx);
+        }
+    }
+    // cq DirectionMinMaxSelector 的容差语义：中心在极值 ± tol 内都算选中
+    return centers.filter((c) => Math.abs(c.cx - extreme) <= PLANAR_PICK_TOL).map((c) => c.e);
+}
+/**
+ * ③ 端面（cq 左/右侧面）：裁剪后的齿面在端部截面上的边 + 3 条轮廓直线
+ * （沿截面到背面 y=ld−height 的两条横线 + 背面竖线），组线成面。
+ *
+ * cq 的辅助线从 `vertices('<Z')` / `vertices('>Z')` 出发——即截面链上 **z 最小/
+ * 最大的端点**（其 y 未必是链上 y 的极值，螺旋齿条下两者不同）。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param toothFaces 裁剪后的齿面集合
+ * @param side 左端（x=0）还是右端（x=length）
+ * @param geom 齿条几何量
+ * @param wireCombTol 组线容差
+ * @returns 端面 Face
+ */
+export function endCapFace(kernel, toothFaces, side, geom, wireCombTol) {
+    const picked = extremeXEdges(kernel, toothFaces, side);
+    if (picked.length === 0) {
+        throw new Error(`endCapFace(${side}): no edges selected`);
+    }
+    // 截面链的 z 最小 / 最大端点（cq pt1 / pt2）
+    let pt1;
+    let pt2;
+    for (const e of picked) {
+        const ends = edgeEnds(kernel, e);
+        for (const p of [ends.a, ends.b]) {
+            if (!pt1 || p.z < pt1.z)
+                pt1 = { y: p.y, z: p.z };
+            if (!pt2 || p.z > pt2.z)
+                pt2 = { y: p.y, z: p.z };
+        }
+    }
+    const backY = geom.ld - geom.height;
+    const pt = (y, z) => vec3(side === 'left' ? 0 : geom.length, y, z);
+    const lines = [
+        kernel.makeLineEdge(pt(pt1.y, pt1.z), pt(backY, pt1.z)),
+        kernel.makeLineEdge(pt(backY, pt1.z), pt(backY, pt2.z)),
+        kernel.makeLineEdge(pt(backY, pt2.z), pt(pt2.y, pt2.z)),
+    ];
+    const wires = connectEdgesToWires(kernel, [...picked, ...lines], wireCombTol);
+    if (wires.length !== 1) {
+        throw new Error(`endCapFace(${side}): expected 1 closed loop, got ${wires.length}`);
+    }
+    return kernel.makeFace(wires[0]);
+}
+/**
+ * ④ 背面：y = ld−height 平面上的 length×width 矩形（cq `.rect(length, width, centered=False)`）。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param geom 齿条几何量
+ * @returns 背面 Face
+ */
+export function backFace(kernel, geom) {
+    const y = geom.ld - geom.height;
+    const p = (a, b) => vec3(a, y, b);
+    const es = [
+        kernel.makeLineEdge(p(0, 0), p(geom.length, 0)),
+        kernel.makeLineEdge(p(geom.length, 0), p(geom.length, geom.width)),
+        kernel.makeLineEdge(p(geom.length, geom.width), p(0, geom.width)),
+        kernel.makeLineEdge(p(0, geom.width), p(0, 0)),
+    ];
+    return kernel.makeFace(kernel.makeWire(es));
+}
+/**
+ * ④ 顶/底盖面：收所有面在 z=const 平面上的边界边 → 组线（外轮廓 1 条，含齿谷
+ * 波形与两侧背线）→ 平面。cq `.edges('>Z'/ '<Z').consolidateWires()` 后取第一条。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param faces 候选面集合（齿面 + 端面 + 背面）
+ * @param z 盖面所在高度（width 或 0）
+ * @returns 盖面 Face（开环 wire 建面，与 cq 语义一致）
+ */
+export function planarCapAtZ(kernel, faces, z) {
+    const edges = [];
+    for (const f of faces) {
+        for (const e of kernel.getSubShapes(f, 'edge')) {
+            const bb = kernel.getBoundingBox(e);
+            if (Math.abs(bb.zmin - z) <= PLANAR_PICK_TOL && Math.abs(bb.zmax - z) <= PLANAR_PICK_TOL) {
+                edges.push(e);
+            }
+        }
+    }
+    if (edges.length === 0)
+        throw new Error(`planarCapAtZ: no edges at z=${z}`);
+    // cq 的 consolidateWires 依赖样条近似边的顶点容差（≈spline tol 量级）链接边，
+    // 且 makeFromWires 接受开环 wire（probe-case26.py 实测：cq 组出 1 条 closed=False
+    // 的 wire 仍建面成功、体积精确）。故这里用样条容差量级合并、取第一条 wire、
+    // 不强制闭合——与 cq 语义逐字对齐。
+    const wires = connectEdgesToWires(kernel, edges, CAP_WIRE_MERGE_TOL);
+    if (wires.length === 0) {
+        throw new Error(`planarCapAtZ(z=${z}): no wires consolidated from ${edges.length} edges`);
+    }
+    return kernel.makeFace(wires[0]);
+}
+/**
+ * ①–⑤：完整 RackGear / HerringboneRackGear 实体。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param params 齿条参数（逐字沿用 Python 构造参数名）
+ * @param build 构造选项（策略/容差覆盖）
+ * @returns solid
+ */
+export function buildRackGearSolid(kernel, params, build = {}) {
+    const strategy = build.strategy ?? DEFAULT_SPLINE_FACE_STRATEGY;
+    const geom = rackGearGeometry(params);
+    const herringbone = build.herringbone ?? false;
+    const wireCombTol = build.wireCombTol ?? GEAR_BASE_CONSTANTS.wire_comb_tol;
+    const sewingTol = build.shellSewingTol ?? GEAR_BASE_CONSTANTS.shell_sewing_tol;
+    // ② 端部裁剪平面（x=0 左侧 / x=length 右侧，各外扩 cp_ext）
+    const cutL = cutPlane(kernel, geom.toothHeight + CP_EXT, geom.width + CP_EXT, vec3(0, 0, geom.width / 2), vec3(-1, 0, 0));
+    const cutR = cutPlane(kernel, geom.toothHeight + CP_EXT, geom.width + CP_EXT, vec3(geom.length, 0, geom.width / 2), vec3(1, 0, 0));
+    // extra = int(abs(ceil(tan(h)·width / (π·m))))——abs 在 ceil **之外**（Python 逐字：
+    // `int(abs(np.ceil(...)))`），负螺旋角时 ceil 为负、取 abs 后为正。
+    const extra = Math.abs(Math.ceil(Math.tan(geom.helixAngle) * geom.width / (Math.PI * geom.m)));
+    const base = rackToothFaces(kernel, geom, herringbone, strategy);
+    const toothFaces = [];
+    // tidx 按螺旋方向分三种（Python 逐字）：正螺旋左侧多补、负螺旋右侧多补、直齿不补
+    const iLo = geom.helixAngle > 0 ? -extra : 0;
+    const iHi = geom.helixAngle > 0 ? geom.z : geom.z + extra;
+    for (let i = iLo; i <= iHi; i++) {
+        toothFaces.push(...toothAtPosition(kernel, base, Math.PI * geom.m * i, i, geom, extra, cutL, cutR));
+    }
+    if (toothFaces.length === 0) {
+        throw new Error('buildRackGearSolid: no tooth faces survived end trimming');
+    }
+    // ③ 端面 + ④ 背面 + 顶/底盖面
+    const lsFace = endCapFace(kernel, toothFaces, 'left', geom, wireCombTol);
+    const rsFace = endCapFace(kernel, toothFaces, 'right', geom, wireCombTol);
+    const bkFace = backFace(kernel, geom);
+    const all = [...toothFaces, lsFace, rsFace, bkFace];
+    const tpFace = planarCapAtZ(kernel, all, geom.width);
+    const btFace = planarCapAtZ(kernel, all, 0);
+    // ⑤ 缝合 → 实体化 → 朝向归一化
+    const solid = shellToSolid(kernel, [...all, tpFace, btFace], sewingTol);
+    // fixFaceOrientations 在微开口 shell（cq 同样存在：rs 端面只到 zmax≈width−0.18，
+    // 靠 sew 容差吸收）上会把 solid 拆回 shell（debug-rack-cap.ts 实测）。退化路径：
+    // makeSolid 的产物直接按体积符号归一化朝向。
+    let oriented = solid;
+    if (kernel.isSolid(solid)) {
+        const fixed = kernel.fixFaceOrientations(solid);
+        if (kernel.isSolid(fixed))
+            oriented = fixed;
+    }
+    if (!kernel.isSolid(oriented)) {
+        throw new Error(`buildRackGearSolid: result is not a solid (got ${String(kernel.getShapeType(oriented))})`);
+    }
+    if (kernel.getVolume(oriented) < 0) {
+        oriented = kernel.reverseShape(oriented);
+    }
+    return oriented;
+}
+//# sourceMappingURL=rack_gear.js.map

package/dist/rack_gear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rack_gear.js","sourceRoot":"","sources":["../src/rack_gear.ts"],"names":[],"mappings":"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"}

package/dist/ring_gear.d.ts

@@ -0,0 +1,54 @@
+/**
+ * ring_gear — RingGear（内部齿）实体构造
+ *
+ * 对应 `RingGear._build_gear_faces()` + `_build_rim_face()` + `_build()`：
+ *
+ * ```
+ * ① 4z 个齿面（复用 SpurGear 的 `buildToothFaces`，因为点集布局一致）
+ * ② 外圈 rim：两圈圆环 wire（z=0 / z=width）经 `loft(ruled=true)` 蒙成圆柱面
+ * ③ 顶/底面：在 z=width / z=0 收齿面边界边 → 组线成内孔 wire，
+ *    再用 `Face.makeFromWires(rimWire, [toothWire])` 做成**环形**盖面（外圆 rim_r、内孔齿廓）
+ * ④ sew(齿面 + rim + 2 盖面) → makeSolid → fixFaceOrientations
+ * ```
+ *
+ * 与 SpurGear 的关键差异：端面是**环形**（外 rim 圆 + 内齿廓孔），不是实心圆盘；
+ * 多了外圈 rim 圆柱面。倒角（chamfer）/ 轴孔（bore）属于 `_make_chamfer` / `_make_bore`，
+ * 在 sew 之后以旋转体 cutter 布尔差实现（见 `features.ts`，A1 已验证几何），
+ * 由 `BuildRingGearOptions.chamfer` / `boreD` 驱动。
+ */
+import type { BrepHandle } from '@faicad/faijs';
+import type { GearKernel } from '@faicad/cq-compat';
+import { type RingGearParams } from './profile.js';
+import { type SplineFaceOptions, type SplineFaceStrategy } from './spline-face.js';
+import { type GearFeatureOptions } from './features.js';
+/** RingGear 实体构造选项（在 `SplineFaceOptions` 上加容差、策略与镀铬特征覆盖）。 */
+export interface BuildRingGearOptions extends SplineFaceOptions, GearFeatureOptions {
+    strategy?: SplineFaceStrategy;
+    /** 缝合容差（cq `shell_sewing_tol`）。 */
+    shellSewingTol?: number;
+    /** 组线容差（cq `wire_comb_tol`）。 */
+    wireCombTol?: number;
+    /** 人字齿：齿面沿宽度方向拆成上下两半、各以相反螺旋扭转（V 形）。 */
+    herringbone?: boolean;
+}
+/** ①–④：完整 RingGear 实体（内部齿，非倒角）。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param params 齿轮参数
+ * @param build 构造选项（策略/容差覆盖）
+ * @returns 朝向归一化后的 solid
+ */
+export declare function buildRingGearSolid(kernel: GearKernel, params: RingGearParams, build?: BuildRingGearOptions): BrepHandle;
+/** ①–④：完整 HerringboneRingGear 实体（人字内齿，裸齿轮）。
+ *
+ * 齿廓数学与 RingGear 同构（`gearGeometryForClass` 已分派到 `ringGearGeometry`），
+ * 差异只在建面阶段：齿面拆成上下两半、反向螺旋形成 V 形（复用
+ * `buildHerringboneToothFaces`）；rim 圆柱面与环形盖面与 RingGear 一致。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param params 内齿参数（逐字沿用 Python 构造参数名）
+ * @param build 构造选项（策略/容差覆盖）
+ * @returns 朝向归一化后的 solid
+ */
+export declare function buildHerringboneRingGearSolid(kernel: GearKernel, params: RingGearParams, build?: BuildRingGearOptions): BrepHandle;
+//# sourceMappingURL=ring_gear.d.ts.map

package/dist/ring_gear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ring_gear.d.ts","sourceRoot":"","sources":["../src/ring_gear.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAyC,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AACtF,OAAO,EAEK,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAC1D,MAAM,eAAe,CAAA;AAGtB,OAAO,EACoB,KAAK,kBAAkB,EACjD,MAAM,YAAY,CAAA;AAKnB,6DAA6D;AAC7D,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB,EAAE,kBAAkB;IACjF,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAC7B,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAqED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,cAAc,EACtB,KAAK,GAAE,oBAAyB,GAC/B,UAAU,CAqCZ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,cAAc,EACtB,KAAK,GAAE,oBAAyB,GAC/B,UAAU,CAEZ"}