@faicad/fai-cq-gears 0.13.0

package/dist/crossed_pair.d.ts

@@ -0,0 +1,177 @@
+/**
+ * crossed_pair — 交错轴齿轮对（CrossedGearPair / HyperbolicGearPair）
+ *
+ * 对应 `crossed_helical_gear.py`：两个单体齿轮按轴交角装配成一个 Compound。
+ * 两件都各自用现成的实体构造（`buildCrossedHelicalSolid` / `buildHyperbolicGearSolid`），
+ * 差异只在**装配定位链**与**螺旋角分配**：
+ *
+ * ## 螺旋角分配（CrossedGearPair）
+ *
+ * `gear1_helix_angle is None` 时两齿轮各取 `shaft_angle/2`；否则
+ * `g1 = gear1_helix_angle`、`g2 = shaft_angle − gear1_helix_angle`。
+ *
+ * ## gear2 定位链（两种对类完全一致，仅 X 向偏移不同）
+ *
+ * Python（右到左复合 `loc = A; loc *= B; loc *= C; loc *= D` ⇒ 施加顺序 D→C→B→A）：
+ *
+ * ```python
+ * loc = cq.Location(Vector(r0_1 + r0_2, 0, w1/2))          # A 平移
+ * loc *= cq.Location(Vector(0,0,0), X, shaft_angle)        # B 绕原点 X 转
+ * loc *= cq.Location(Vector(0,0,-w2/2))                     # C 平移
+ * loc *= cq.Location(Vector(0,0,0), Z, align_angle)        # D 绕原点 Z 转
+ * ```
+ *
+ * `align_angle = (0 if gear2.z%2 else 180/gear2.z) + degrees(gear2.twist + gear1.twist*ratio)/2`，
+ * `ratio = gear1.z / gear2.z`。
+ *
+ * ## X 向偏移差异
+ * - CrossedGearPair：用两齿轮分度半径之和 `r0_1 + r0_2`；
+ * - HyperbolicGearPair：用两齿轮**喉部半径**之和 `throat_r1 + throat_r2`。
+ */
+import type { BrepHandle } from '@faicad/faijs';
+import type { GearKernel } from '@faicad/cq-compat';
+import { crossedHelicalGearGeometry, type HyperbolicGearGeometry } from './profile.js';
+import { type BuildSpurGearOptions } from './spur_gear.js';
+/** 装配定位链的输入量（拆出来便于单测直接验证定位本身）。 */
+export interface SecondGearPlacement {
+    /** gear2 绕 Z 的对齿/对齐角（弧度）。 */
+    alignAngleRad: number;
+    /** 轴交角（弧度）。 */
+    shaftAngleRad: number;
+    /** X 向平移量（Crossed 用 r0 和、Hyperbolic 用 throat_r 和）。 */
+    offsetX: number;
+    /** gear1 宽度（Z 向平移分量）。 */
+    gear1Width: number;
+    /** gear2 宽度（Z 向平移分量）。 */
+    gear2Width: number;
+}
+/**
+ * 把第二齿轮摆到与第一齿轮啮合的位姿（复刻 Python 的四步 `loc *=`）。
+ *
+ * 施加顺序 **D → C → B → A**：先绕原点 Z 转 `alignAngle`，再沿 Z 平移 `-w2/2`，
+ * 再绕原点 X 转 `shaftAngle`，最后沿 X 平移 `offsetX`、沿 Z 平移 `w1/2`。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param g2 第二齿轮 solid
+ * @param place 定位链输入量
+ * @returns 定位后的第二齿轮 solid
+ */
+export declare function placeSecondGear(kernel: GearKernel, g2: BrepHandle, place: SecondGearPlacement): BrepHandle;
+/**
+ * 复刻 Python 的 `align_angle` 公式。
+ *
+ * `align_angle = (0 if gear2.z%2 else 180/gear2.z) + degrees(gear2.twist + gear1.twist*ratio)/2`，
+ * `ratio = gear1.z / gear2.z`。两个 twist 都用**弧度**（来自几何量）。
+ *
+ * @param gear1Z 第一齿轮齿数
+ * @param gear1TwistRad 第一齿轮扭转角（弧度）
+ * @param gear2Z 第二齿轮齿数
+ * @param gear2TwistRad 第二齿轮扭转角（弧度）
+ * @returns 对齐角（弧度）
+ */
+export declare function crossedPairAlignAngle(gear1Z: number, gear1TwistRad: number, gear2Z: number, gear2TwistRad: number): number;
+/** 交错轴斜齿轮对参数（逐字沿用 `CrossedGearPair.__init__`）。 */
+export interface CrossedGearPairParams {
+    module: number;
+    gear1_teeth_number: number;
+    gear2_teeth_number: number;
+    gear1_width: number;
+    gear2_width: number;
+    pressure_angle?: number;
+    shaft_angle?: number;
+    /** 第一齿轮螺旋角（度）；`null`/缺省 = 两齿轮各取 `shaft_angle/2`。 */
+    gear1_helix_angle?: number | null;
+    clearance?: number;
+    backlash?: number;
+}
+/** 齿轮对构造选项（扩展单体特征选项 + 装配开关）。 */
+export interface BuildCrossedGearPairOptions extends BuildSpurGearOptions {
+    /** 是否构建第一齿轮（默认 true）。 */
+    buildGear1?: boolean;
+    /** 是否构建第二齿轮（默认 true）。 */
+    buildGear2?: boolean;
+    /** 是否对 gear2 施加装配定位（默认 true）。 */
+    transformGear2?: boolean;
+}
+/** 交错轴斜齿轮对的构建结果。 */
+export interface CrossedGearPairBuild {
+    /** 第一齿轮 solid（未定位）。 */
+    gear1?: BrepHandle;
+    /** 第二齿轮 solid（已定位）。 */
+    gear2?: BrepHandle;
+    gear1Geometry: ReturnType<typeof crossedHelicalGearGeometry>;
+    gear2Geometry: ReturnType<typeof crossedHelicalGearGeometry>;
+    /** 轴交角（弧度）。 */
+    shaftAngleRad: number;
+}
+/**
+ * 构建一对交错轴斜齿轮（`CrossedGearPair`）。
+ *
+ * 两件都走 `buildCrossedHelicalSolid`（用各自的 helix 角），差异只在参数：gear2 的
+ * helix 由 `shaft_angle − gear1_helix` 决定；gear2 默认按轴交角定位到与第一齿轮啮合。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param params 齿轮对参数
+ * @param options 构造选项
+ * @returns 两件 solid（gear2 默认已定位）与两件几何量
+ */
+export declare function buildCrossedGearPair(kernel: GearKernel, params: CrossedGearPairParams, options?: BuildCrossedGearPairOptions): CrossedGearPairBuild;
+/**
+ * 一对交错轴斜齿轮的导出条目（gear1 → gear2）。
+ *
+ * @param build 交叉轴齿轮对构建结果（gear2 可能为空——只有 `shafts_connected` 时存在）
+ * @returns 具名实体数组（名字进 STEP 产品名，供逐件等价比对）
+ */
+export declare function crossedPairExportParts(build: CrossedGearPairBuild): Array<{
+    name: string;
+    solid: BrepHandle;
+}>;
+/** 双曲面齿轮对参数（逐字沿用 `HyperbolicGearPair.__init__`）。 */
+export interface HyperbolicGearPairParams {
+    module: number;
+    gear1_teeth_number: number;
+    /** 齿宽（两齿轮共用，沿 X）。 */
+    width: number;
+    /** 轴交角（度）。 */
+    shaft_angle: number;
+    /** 第二齿轮齿数（缺省 = 第一齿轮齿数）。 */
+    gear2_teeth_number?: number;
+    pressure_angle?: number;
+    clearance?: number;
+    backlash?: number;
+}
+/** 双曲面齿轮对的构建结果。 */
+export interface HyperbolicGearPairBuild {
+    gear1?: BrepHandle;
+    gear2?: BrepHandle;
+    gear1Geometry: HyperbolicGearGeometry;
+    gear2Geometry: HyperbolicGearGeometry;
+    /** 轴交角（弧度）。 */
+    shaftAngleRad: number;
+}
+/**
+ * 构建一对双曲面齿轮（`HyperbolicGearPair`）。
+ *
+ * 两齿轮的扭转角由轴交角 + 喉部几何反算
+ * （`g_twist = 2·asin((w/2)·tan(shaft/2) / r0)`），再各自走 `buildHyperbolicGearSolid`；
+ * gear2 用 **throat_r 和** 作 X 向偏移（与 CrossedGearPair 的 r0 和不同）。
+ *
+ * @throws 扭转角无法计算（NaN，齿数/轴交角/齿宽组合不合法）时抛 Error
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param params 齿轮对参数
+ * @param options 构造选项
+ * @returns 两件 solid（gear2 默认已定位）与两件几何量
+ */
+export declare function buildHyperbolicGearPair(kernel: GearKernel, params: HyperbolicGearPairParams, options?: BuildCrossedGearPairOptions): HyperbolicGearPairBuild;
+/**
+ * 一对双曲面齿轮的导出条目（gear1 → gear2）。
+ *
+ * @param build 双曲面齿轮对构建结果（gear2 可能为空——只有 `shafts_connected` 时存在）
+ * @returns 具名实体数组（名字进 STEP 产品名，供逐件等价比对）
+ */
+export declare function hyperbolicPairExportParts(build: HyperbolicGearPairBuild): Array<{
+    name: string;
+    solid: BrepHandle;
+}>;
+//# sourceMappingURL=crossed_pair.d.ts.map

package/dist/crossed_pair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crossed_pair.d.ts","sourceRoot":"","sources":["../src/crossed_pair.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EACL,0BAA0B,EACgC,KAAK,sBAAsB,EACtF,MAAM,WAAW,CAAA;AAElB,OAAO,EAA4B,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAKjF,kCAAkC;AAClC,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,mBAAmB,GAC7D,UAAU,CAMZ;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAC3E,MAAM,CAUR;AAID,kDAAkD;AAClD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,kBAAkB,EAAE,MAAM,CAAA;IAC1B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,gCAAgC;AAChC,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE,yBAAyB;IACzB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,yBAAyB;IACzB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,iCAAiC;IACjC,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,oBAAoB;AACpB,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,uBAAuB;IACvB,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,aAAa,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAA;IAC5D,aAAa,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAA;IAC5D,eAAe;IACf,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,qBAAqB,EAC7B,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,CAuDtB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,oBAAoB,GAC1B,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC,CAK5C;AAID,oDAAoD;AACpD,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAA;IACd,kBAAkB,EAAE,MAAM,CAAA;IAC1B,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,cAAc;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,2BAA2B;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,mBAAmB;AACnB,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,aAAa,EAAE,sBAAsB,CAAA;IACrC,aAAa,EAAE,sBAAsB,CAAA;IACrC,eAAe;IACf,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,wBAAwB,EAChC,OAAO,GAAE,2BAAgC,GACxC,uBAAuB,CA4DzB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,uBAAuB,GAC7B,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC,CAK5C"}

package/dist/crossed_pair.js

@@ -0,0 +1,237 @@
+/**
+ * crossed_pair — 交错轴齿轮对（CrossedGearPair / HyperbolicGearPair）
+ *
+ * 对应 `crossed_helical_gear.py`：两个单体齿轮按轴交角装配成一个 Compound。
+ * 两件都各自用现成的实体构造（`buildCrossedHelicalSolid` / `buildHyperbolicGearSolid`），
+ * 差异只在**装配定位链**与**螺旋角分配**：
+ *
+ * ## 螺旋角分配（CrossedGearPair）
+ *
+ * `gear1_helix_angle is None` 时两齿轮各取 `shaft_angle/2`；否则
+ * `g1 = gear1_helix_angle`、`g2 = shaft_angle − gear1_helix_angle`。
+ *
+ * ## gear2 定位链（两种对类完全一致，仅 X 向偏移不同）
+ *
+ * Python（右到左复合 `loc = A; loc *= B; loc *= C; loc *= D` ⇒ 施加顺序 D→C→B→A）：
+ *
+ * ```python
+ * loc = cq.Location(Vector(r0_1 + r0_2, 0, w1/2))          # A 平移
+ * loc *= cq.Location(Vector(0,0,0), X, shaft_angle)        # B 绕原点 X 转
+ * loc *= cq.Location(Vector(0,0,-w2/2))                     # C 平移
+ * loc *= cq.Location(Vector(0,0,0), Z, align_angle)        # D 绕原点 Z 转
+ * ```
+ *
+ * `align_angle = (0 if gear2.z%2 else 180/gear2.z) + degrees(gear2.twist + gear1.twist*ratio)/2`，
+ * `ratio = gear1.z / gear2.z`。
+ *
+ * ## X 向偏移差异
+ * - CrossedGearPair：用两齿轮分度半径之和 `r0_1 + r0_2`；
+ * - HyperbolicGearPair：用两齿轮**喉部半径**之和 `throat_r1 + throat_r2`。
+ */
+import { crossedHelicalGearGeometry, hyperbolicGearGeometry, } from './profile.js';
+import { buildCrossedHelicalSolid } from './crossed_helical_gear.js';
+import { buildHyperbolicGearSolid } from './spur_gear.js';
+const Z_AXIS = { point: { x: 0, y: 0, z: 0 }, direction: { x: 0, y: 0, z: 1 } };
+const X_AXIS = { point: { x: 0, y: 0, z: 0 }, direction: { x: 1, y: 0, z: 0 } };
+/**
+ * 把第二齿轮摆到与第一齿轮啮合的位姿（复刻 Python 的四步 `loc *=`）。
+ *
+ * 施加顺序 **D → C → B → A**：先绕原点 Z 转 `alignAngle`，再沿 Z 平移 `-w2/2`，
+ * 再绕原点 X 转 `shaftAngle`，最后沿 X 平移 `offsetX`、沿 Z 平移 `w1/2`。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param g2 第二齿轮 solid
+ * @param place 定位链输入量
+ * @returns 定位后的第二齿轮 solid
+ */
+export function placeSecondGear(kernel, g2, place) {
+    let s = g2;
+    s = kernel.rotate(s, Z_AXIS, place.alignAngleRad); // D
+    s = kernel.translate(s, 0, 0, -place.gear2Width / 2); // C
+    s = kernel.rotate(s, X_AXIS, place.shaftAngleRad); // B
+    return kernel.translate(s, place.offsetX, 0, place.gear1Width / 2); // A
+}
+/**
+ * 复刻 Python 的 `align_angle` 公式。
+ *
+ * `align_angle = (0 if gear2.z%2 else 180/gear2.z) + degrees(gear2.twist + gear1.twist*ratio)/2`，
+ * `ratio = gear1.z / gear2.z`。两个 twist 都用**弧度**（来自几何量）。
+ *
+ * @param gear1Z 第一齿轮齿数
+ * @param gear1TwistRad 第一齿轮扭转角（弧度）
+ * @param gear2Z 第二齿轮齿数
+ * @param gear2TwistRad 第二齿轮扭转角（弧度）
+ * @returns 对齐角（弧度）
+ */
+export function crossedPairAlignAngle(gear1Z, gear1TwistRad, gear2Z, gear2TwistRad) {
+    const ratio = gear1Z / gear2Z;
+    // ⚠️ 分支方向与 cq 逐字一致：`align_angle = 0.0 if gear2.z % 2 else 180/gear2.z`。
+    // 即 **gear2.z 为偶**时取 `180/gear2.z`（base 非零），**为奇**时取 0。
+    // 2026-09-13 修正：此前把奇偶分支写反（偶→0、奇→180/z），导致 gear2 绕 Z 对齐角
+    // 差半齿（如 z=20 时差 9°），gear2 被平移+旋转到错误位姿，compare-all 报
+    // bool diff ≈ 整件体积（cgp-basic / hgp-basic 因此 DIFFERENT）。
+    const alignDeg = (gear2Z % 2 === 0 ? 180 / gear2Z : 0)
+        + (((gear2TwistRad * 180.0) / Math.PI) + ((gear1TwistRad * 180.0) / Math.PI) * ratio) / 2.0;
+    return (alignDeg * Math.PI) / 180.0;
+}
+/**
+ * 构建一对交错轴斜齿轮（`CrossedGearPair`）。
+ *
+ * 两件都走 `buildCrossedHelicalSolid`（用各自的 helix 角），差异只在参数：gear2 的
+ * helix 由 `shaft_angle − gear1_helix` 决定；gear2 默认按轴交角定位到与第一齿轮啮合。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param params 齿轮对参数
+ * @param options 构造选项
+ * @returns 两件 solid（gear2 默认已定位）与两件几何量
+ */
+export function buildCrossedGearPair(kernel, params, options = {}) {
+    const shaftAngleDeg = params.shaft_angle ?? 90.0;
+    let g1Helix;
+    let g2Helix;
+    if (params.gear1_helix_angle == null) {
+        g1Helix = shaftAngleDeg / 2.0;
+        g2Helix = shaftAngleDeg / 2.0;
+    }
+    else {
+        g1Helix = params.gear1_helix_angle;
+        g2Helix = shaftAngleDeg - params.gear1_helix_angle;
+    }
+    const gear1Params = {
+        module: params.module,
+        teeth_number: params.gear1_teeth_number,
+        width: params.gear1_width,
+        pressure_angle: params.pressure_angle,
+        helix_angle: g1Helix,
+        clearance: params.clearance,
+        backlash: params.backlash,
+    };
+    const gear2Params = {
+        module: params.module,
+        teeth_number: params.gear2_teeth_number,
+        width: params.gear2_width,
+        pressure_angle: params.pressure_angle,
+        helix_angle: g2Helix,
+        clearance: params.clearance,
+        backlash: params.backlash,
+    };
+    const geom1 = crossedHelicalGearGeometry(gear1Params);
+    const geom2 = crossedHelicalGearGeometry(gear2Params);
+    const shaftAngleRad = (shaftAngleDeg * Math.PI) / 180.0;
+    const alignAngleRad = crossedPairAlignAngle(geom1.z, geom1.twistAngle, geom2.z, geom2.twistAngle);
+    const out = { gear1Geometry: geom1, gear2Geometry: geom2, shaftAngleRad };
+    if (options.buildGear1 !== false) {
+        out.gear1 = buildCrossedHelicalSolid(kernel, gear1Params, options);
+    }
+    if (options.buildGear2 !== false) {
+        let g2 = buildCrossedHelicalSolid(kernel, gear2Params, options);
+        if (options.transformGear2 !== false) {
+            g2 = placeSecondGear(kernel, g2, {
+                alignAngleRad,
+                shaftAngleRad,
+                offsetX: geom1.r0 + geom2.r0,
+                gear1Width: params.gear1_width,
+                gear2Width: params.gear2_width,
+            });
+        }
+        out.gear2 = g2;
+    }
+    return out;
+}
+/**
+ * 一对交错轴斜齿轮的导出条目（gear1 → gear2）。
+ *
+ * @param build 交叉轴齿轮对构建结果（gear2 可能为空——只有 `shafts_connected` 时存在）
+ * @returns 具名实体数组（名字进 STEP 产品名，供逐件等价比对）
+ */
+export function crossedPairExportParts(build) {
+    const parts = [];
+    if (build.gear1)
+        parts.push({ name: 'gear1', solid: build.gear1 });
+    if (build.gear2)
+        parts.push({ name: 'gear2', solid: build.gear2 });
+    return parts;
+}
+/**
+ * 构建一对双曲面齿轮（`HyperbolicGearPair`）。
+ *
+ * 两齿轮的扭转角由轴交角 + 喉部几何反算
+ * （`g_twist = 2·asin((w/2)·tan(shaft/2) / r0)`），再各自走 `buildHyperbolicGearSolid`；
+ * gear2 用 **throat_r 和** 作 X 向偏移（与 CrossedGearPair 的 r0 和不同）。
+ *
+ * @throws 扭转角无法计算（NaN，齿数/轴交角/齿宽组合不合法）时抛 Error
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param params 齿轮对参数
+ * @param options 构造选项
+ * @returns 两件 solid（gear2 默认已定位）与两件几何量
+ */
+export function buildHyperbolicGearPair(kernel, params, options = {}) {
+    const shaftAngleDeg = params.shaft_angle;
+    const g2Teeth = params.gear2_teeth_number ?? params.gear1_teeth_number;
+    const g1R0 = (params.module * params.gear1_teeth_number) / 2.0;
+    const g2R0 = (params.module * g2Teeth) / 2.0;
+    const alpha = (shaftAngleDeg / 2.0) * (Math.PI / 180.0);
+    const hh = (params.width / 2.0) * Math.tan(alpha);
+    const g1Twist = 2.0 * Math.asin(hh / g1R0);
+    const g2Twist = 2.0 * Math.asin(hh / g2R0);
+    if (Number.isNaN(g1Twist) || Number.isNaN(g2Twist)) {
+        throw new Error('HyperbolicGearPair: impossible to calculate the twist angle for the '
+            + 'given shaft angle / teeth number / gear width');
+    }
+    const gear1Params = {
+        module: params.module,
+        teeth_number: params.gear1_teeth_number,
+        width: params.width,
+        twist_angle: (g1Twist * 180.0) / Math.PI,
+        pressure_angle: params.pressure_angle,
+        clearance: params.clearance,
+        backlash: params.backlash,
+    };
+    const gear2Params = {
+        module: params.module,
+        teeth_number: g2Teeth,
+        width: params.width,
+        twist_angle: (g2Twist * 180.0) / Math.PI,
+        pressure_angle: params.pressure_angle,
+        clearance: params.clearance,
+        backlash: params.backlash,
+    };
+    const geom1 = hyperbolicGearGeometry(gear1Params);
+    const geom2 = hyperbolicGearGeometry(gear2Params);
+    const shaftAngleRad = (shaftAngleDeg * Math.PI) / 180.0;
+    const alignAngleRad = crossedPairAlignAngle(geom1.z, geom1.twistAngle, geom2.z, geom2.twistAngle);
+    const out = { gear1Geometry: geom1, gear2Geometry: geom2, shaftAngleRad };
+    if (options.buildGear1 !== false) {
+        out.gear1 = buildHyperbolicGearSolid(kernel, gear1Params, options);
+    }
+    if (options.buildGear2 !== false) {
+        let g2 = buildHyperbolicGearSolid(kernel, gear2Params, options);
+        if (options.transformGear2 !== false) {
+            g2 = placeSecondGear(kernel, g2, {
+                alignAngleRad,
+                shaftAngleRad,
+                offsetX: geom1.throatR + geom2.throatR,
+                gear1Width: params.width,
+                gear2Width: params.width,
+            });
+        }
+        out.gear2 = g2;
+    }
+    return out;
+}
+/**
+ * 一对双曲面齿轮的导出条目（gear1 → gear2）。
+ *
+ * @param build 双曲面齿轮对构建结果（gear2 可能为空——只有 `shafts_connected` 时存在）
+ * @returns 具名实体数组（名字进 STEP 产品名，供逐件等价比对）
+ */
+export function hyperbolicPairExportParts(build) {
+    const parts = [];
+    if (build.gear1)
+        parts.push({ name: 'gear1', solid: build.gear1 });
+    if (build.gear2)
+        parts.push({ name: 'gear2', solid: build.gear2 });
+    return parts;
+}
+//# sourceMappingURL=crossed_pair.js.map

package/dist/crossed_pair.js.map

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

package/dist/features.d.ts

@@ -0,0 +1,184 @@
+/**
+ * features — 裸齿轮之上的布尔特征（倒角 / 轴孔 / 凹槽 / 轮毂 / 轮辐）
+ *
+ * 复刻 cq_gears `GearBase._make_chamfer` / `_make_bore`（A1 尖峰
+ * `scripts/spike-chamfer.ts` 已验证：spur 裸体 + chamfer0.5 + bore1 → 体积
+ * 167.845620 对齐官方 167.8456187，rel 5.6e-9），以及 SpurGear 系的
+ * `_make_recess` / `_make_hub` / `_make_spokes`（RingGear 无这些特征）。
+ *
+ * 实现要点（与 cq 逐字一致）：
+ * - 倒角是 XZ 平面（法向 -Y）上的三角轮廓 → line-edge → wire → face → revolve 360°
+ *   得到旋转体 cutter，再布尔差到裸齿轮；外部齿 / 内齿（ring）的 cutter 轮廓方向相反。
+ * - 轴孔是贯穿圆柱 cut（轴心对齐 +Z，高度 = width + 2E 确保穿透）。
+ * - 凹槽（recess）是顶/底面上的圆盘或圆环 pocket 布尔差（cq `cutBlind`，深度恰好
+ *   = recess，与端面齐平——参考构建同款做法，OCCT 可处理共面 cut）。
+ * - 轮毂（hub）是顶面上的圆环棱柱（bore_d 作内孔）布尔并（cq `extrude(hub_length)`）。
+ * - 轮辐（spokes）是 r1..r2 之间的「直边 + 内外圆弧」窗口棱柱 cutter，绕 Z 轴
+ *   逐个旋转 n_spokes 次布尔差；spoke_fillet 对 cutter 的竖直棱边做圆角。
+ */
+import type { BrepHandle } from '@faicad/faijs';
+import type { GearKernel } from '@faicad/cq-compat';
+/** cq `_make_chamfer` 的小偏移量（避免共面自交）。 */
+export declare const CHAMFER_E = 0.01;
+/** 倒角量：标量 = 等边；`[wx, wy]` = 半径方向 / z 方向各自的去除量。 */
+export type ChamferValue = number | [number, number];
+/** 倒角 / 轴孔 / 凹槽 / 轮毂 / 轮辐相关构造选项（裸齿轮之上的镀铬特征）。 */
+export interface GearFeatureOptions {
+    /** 上下两边同时倒角（同量）。 */
+    chamfer?: ChamferValue;
+    /** 顶面倒角量（覆盖 `chamfer`）。 */
+    chamferTop?: ChamferValue;
+    /** 底面倒角量（覆盖 `chamfer`）。 */
+    chamferBottom?: ChamferValue;
+    /** 轴孔直径（cq `bore_d`）。 */
+    boreD?: number;
+    /** 删齿区间集合（cq `missing_teeth`，如 `[[0,10],[20,30]]`）。 */
+    missingTeeth?: MissingTeethSpec;
+    /** 顶面轮毂直径（cq `hub_d`）。 */
+    hubD?: number;
+    /** 轮毂自顶面向上的高度（cq `hub_length`，None=不建轮毂）。 */
+    hubLength?: number;
+    /** 顶面凹槽深度（cq `recess`）。 */
+    recess?: number;
+    /** 顶面凹槽直径（cq `recess_d`）。 */
+    recessD?: number;
+    /** 底面凹槽深度（cq `bottom_recess`）。 */
+    bottomRecess?: number;
+    /** 底面凹槽直径（cq `bottom_recess_d`，缺省用 `recessD`）。 */
+    bottomRecessD?: number;
+    /** 底面轮毂直径（cq `bottom_hub_d`，缺省用 `hubD`）。 */
+    bottomHubD?: number;
+    /** 轮辐数量（cq `n_spokes`，>1 才生效）。 */
+    nSpokes?: number;
+    /** 轮辐宽度（cq `spoke_width`）。 */
+    spokeWidth?: number;
+    /** 轮辐内径（cq `spokes_id`，缺省 = hub_d）。 */
+    spokesId?: number;
+    /** 轮辐外径（cq `spokes_od`，缺省 = recess_d）。 */
+    spokesOd?: number;
+    /** 轮辐圆角（cq `spoke_fillet`，对窗口 cutter 竖直棱边）。 */
+    spokeFillet?: number;
+}
+/**
+ * 生成单个倒角 cutter 旋转体（A1 已验证的几何）。
+ *
+ * 轮廓取自 {@link chamferProfile}，绕全局 Z 转 360° 成体，供 `applyChamfer` 布尔差。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param ra 齿顶圆半径（外部齿=齿尖、内齿=内齿尖）
+ * @param width 齿宽
+ * @param wx 沿半径方向的去除量
+ * @param wy 沿 z 方向的去除量
+ * @param which 顶面 / 底面（决定用哪一支轮廓）
+ * @param isRing 内齿（true）使用与 cq `ring_gear.py` 一致的相反轮廓
+ * @returns 绕 Z 轴 360° 回转得到的 cutter 实体句柄
+ */
+export declare function makeChamferCutter(kernel: GearKernel, ra: number, width: number, wx: number, wy: number, which: 'top' | 'bottom', isRing: boolean): BrepHandle;
+/**
+ * 复刻 cq `_make_chamfer`：在裸齿轮实体上布尔差上/下倒角旋转体。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param body 裸齿轮 solid
+ * @param ra 齿顶圆半径
+ * @param width 齿宽
+ * @param opts 倒角选项（chamfer / chamferTop / chamferBottom）
+ * @param isRing 内齿（使用 ring 版 cutter 轮廓）
+ * @returns 倒角后的 solid（cutter 无效时显式抛错，不静默吞掉）
+ */
+export declare function applyChamfer(kernel: GearKernel, body: BrepHandle, ra: number, width: number, opts: GearFeatureOptions, isRing?: boolean): BrepHandle;
+/**
+ * 复刻 cq `_make_bore`：贯穿圆柱 cut（轴心对齐 +Z，高度 = width + 2E 确保穿透）。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param body 实体
+ * @param boreD 轴孔直径（cq `bore_d`）
+ * @param width 齿宽
+ * @returns 带轴孔的 solid
+ */
+export declare function applyBore(kernel: GearKernel, body: BrepHandle, boreD: number, width: number): BrepHandle;
+/**
+ * 复刻 cq `_make_recess`：顶/底面上的圆盘或圆环 pocket 布尔差。
+ *
+ * cq 语义（逐字对齐 `spur_gear.py::_make_recess`）：
+ * - 仅在传了 `recess`/`bottom_recess` 深度时生效；`recess_d` 缺失应报错（assert）。
+ * - 顶面：外径 = recess_d 的圆盘 pocket，深度恰好 = recess（cutBlind(-recess)）；
+ *   有 hub_d 时改为**圆环** pocket（外 recess_d、内 hub_d）——轮毂在 recess 之后
+ *   由 `_make_hub` 另行 fuse，故这里挖掉的只是轮毂之外的环槽。
+ * - 底面：bottom_recess_d / bottom_hub_d 缺省时分别回退 recess_d / hub_d。
+ * - 深度与端面齐平（cutter 顶面在 z=width / z=0），与参考构建一致，共面 cut OCCT 可处理。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param body 实体（裸齿轮，含 bore 之后的形态）
+ * @param width 齿宽
+ * @param opts recess / recessD / hubD / bottomRecess / bottomRecessD / bottomHubD
+ * @returns 挖槽后的 solid
+ */
+export declare function applyRecess(kernel: GearKernel, body: BrepHandle, width: number, opts: GearFeatureOptions): BrepHandle;
+/**
+ * 复刻 cq `_make_hub`：顶面上的圆环棱柱布尔并（hub_length 为 None 时不建模）。
+ *
+ * cq 语义（`spur_gear.py::_make_hub`）：在顶面 workplane 上，有 bore_d 时先画
+ * 内孔圆，再画 hub_d/2 外圆并 `extrude(hub_length)`——得到的是**圆环**棱柱
+ * （bore 贯穿轮毂），fuse 到主体上。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param body 实体
+ * @param width 齿宽（轮毂从 z=width 向上生长）
+ * @param opts hubD / hubLength / boreD
+ * @returns fuse 轮毂后的 solid
+ */
+export declare function applyHub(kernel: GearKernel, body: BrepHandle, width: number, opts: GearFeatureOptions): BrepHandle;
+/**
+ * 复刻 cq `_make_spokes`：r1..r2 之间的「直边 + 内外圆弧」窗口棱柱 cutter，
+ * 绕 Z 轴逐个旋转 n_spokes 次布尔差（n_spokes 为 None 时不建模）。
+ *
+ * cq 语义（`spur_gear.py::_make_spokes`，角度逐字一致）：
+ * - r1 = max(spoke_width/2, spokes_id/2)（spokes_id 缺省 = hub_d）、r2 = spokes_od/2；
+ * - 两端各收/放 ±0.0001 避免与内/外边界共面；
+ * - a1 = asin(sw/2 / id/2)、a2 = asin(sw/2 / od/2)，a3 = tau − a2、a4 = tau − a1；
+ * - 窗口轮廓 = 内弧(a1→a4, r1) − 直边(r1@a4 → r2@a3) − 外弧(r2: a3→a2, **顺时针**) −
+ *   直边(r2@a2 → r1@a1)，即外弧反向走；
+ * - 高度 = width + 1.0，从 z=-0.1 起完全穿透；spoke_fillet 对窗口的竖直棱边做圆角。
+ *
+ * 圆弧用 `makeArcEdge(start, mid, end)` 构造（三点定弧，几何精确，无 radiusArc
+ * 的正负半径歧义）：外弧 a3→a2 取中点角 (a3+a2)/2。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param body 实体
+ * @param width 齿宽
+ * @param opts nSpokes / spokeWidth / spokesId / spokesOd / spokeFillet / hubD / recessD
+ * @returns 挖去全部轮辐窗口后的 solid
+ */
+export declare function applySpokes(kernel: GearKernel, body: BrepHandle, width: number, opts: GearFeatureOptions): BrepHandle;
+/** cq `_make_missing_teeth` 的删齿区间集合：`[[起始齿, 结束齿], …]`（含两端）。 */
+export type MissingTeethSpec = Array<[number, number]>;
+/** applyMissingTeeth 所需的齿轮几何量（避免对 profile 的类型耦合）。 */
+export interface MissingTeethGeom {
+    /** 齿顶圆半径 */
+    ra: number;
+    /** 齿根圆半径 */
+    rd: number;
+    /** 齿距角 2π/z */
+    tau: number;
+    /** 齿宽 */
+    width: number;
+    /** 扭转角（弧度，helix_angle=0 时为 0） */
+    twistAngle: number;
+}
+/**
+ * 复刻 cq `_make_missing_teeth` / `_remove_teeth`：按删齿区间切掉轮齿。
+ *
+ * cq 语义（`spur_gear.py`，逐字一致）：
+ * - 每个区间 (t1, t2) 生成窗口 cutter（z=-0.1 起、高 width+0.2 完全穿透），逐个 cut；
+ * - twist_angle = 0（直齿）：截面 `extrude` 直棱柱；
+ * - twist_angle ≠ 0（斜齿/人字齿）：截面 `twistExtrude(width+0.2, degrees(-twist))`，
+ *   本实现用多站旋转截面 loft 逼近（见 `twistCutoutSolid`）。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param body 实体（cq `_build` 中位于 bore 之后、recess 之前）
+ * @param geom 删齿所需几何量（ra/rd/tau/width/twistAngle）
+ * @param spec 删齿区间集合
+ * @returns 删齿后的 solid
+ */
+export declare function applyMissingTeeth(kernel: GearKernel, body: BrepHandle, geom: MissingTeethGeom, spec: MissingTeethSpec): BrepHandle;
+//# sourceMappingURL=features.d.ts.map

package/dist/features.d.ts.map

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