@faicad/fai-cq-gears 0.13.0

package/dist/planetary.d.ts

@@ -0,0 +1,96 @@
+/**
+ * planetary — 行星轮系（PlanetaryGearset / HerringbonePlanetaryGearset）
+ *
+ * 对应 `ring_gear.py`：一个太阳轮 + n 个行星轮 + 一个内齿圈，按中心距均布装配。
+ * 三件各自用现成的实体构造（`buildSpurGearSolid` / `buildRingGearSolid` 及其人字变体），
+ * 差异只在**参数分配**与**装配定位**：
+ *
+ * ## 参数分配（PlanetaryGearset）
+ * - `ring_z = sun_z + planet_z·2`（内齿圈齿数由太阳/行星决定）
+ * - 太阳：`helix_angle`（给定）
+ * - 行星：`helix_angle = -helix_angle`（旋向相反）
+ * - 内齿圈：`helix_angle = -helix_angle`
+ * - `orbit_r = sun.r0 + planet.r0`（行星公转半径）
+ *
+ * ## 装配定位（逐件，复刻 Python `assemble`）
+ * - 太阳：仅在 `planet.z` 为**奇数**时绕 Z 转 `tau_sun/2`（否则恒等）；
+ * - 行星 i：先绕 Z 自转 `tau_planet/2`，再平移到 `(cos(i·a)·orbit_r, sin(i·a)·orbit_r, 0)`，
+ *   `a = 2π/n_planets`；
+ * - 内齿圈：绕 Z 转 `tau_ring/2`。
+ *
+ * ⚠️ `cq.Location(Vector(p), Z, angle)` 的语义是「先绕原点 Z 转 angle，再平移 p」
+ * （见 `pairs.ts` 文件头实测结论），故行星定位是 **rotate → translate**，不是反过来。
+ *
+ * HerringbonePlanetaryGearset 继承 PlanetaryGearset，仅把 `gear_cls = HerringboneGear`、
+ * `ring_gear_cls = HerringboneRingGear`——即三件全部走人字齿构建。
+ */
+import type { BrepHandle } from '@faicad/faijs';
+import type { GearKernel } from '@faicad/cq-compat';
+import { type SpurGearGeometry } from './profile.js';
+import { type BuildSpurGearOptions } from './spur_gear.js';
+/** 行星轮系参数（逐字沿用 `PlanetaryGearset.__init__`）。 */
+export interface PlanetaryGearsetParams {
+    module: number;
+    sun_teeth_number: number;
+    planet_teeth_number: number;
+    width: number;
+    rim_width: number;
+    n_planets: number;
+    pressure_angle?: number;
+    helix_angle?: number;
+    clearance?: number;
+    backlash?: number;
+}
+/** 行星轮系构造选项（扩展单体特征选项 + 装配开关）。 */
+export interface BuildPlanetaryGearsetOptions extends BuildSpurGearOptions {
+    /** 是否构建太阳轮（默认 true）。 */
+    buildSun?: boolean;
+    /** 是否构建行星轮（默认 true）。 */
+    buildPlanets?: boolean;
+    /** 是否构建内齿圈（默认 true）。 */
+    buildRing?: boolean;
+    /** 是否为人字齿（HerringbonePlanetaryGearset 传 true）。 */
+    herringbone?: boolean;
+}
+/** 行星轮系的构建结果。 */
+export interface PlanetaryGearsetBuild {
+    sun?: BrepHandle;
+    planets: BrepHandle[];
+    ring?: BrepHandle;
+    sunGeometry: SpurGearGeometry;
+    planetGeometry: SpurGearGeometry;
+    ringGeometry: SpurGearGeometry;
+    /** 行星公转半径（= sun.r0 + planet.r0）。 */
+    orbitR: number;
+    /** 行星个数。 */
+    nPlanets: number;
+}
+/**
+ * 构建行星轮系（PlanetaryGearset / HerringbonePlanetaryGearset 共用）。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param params 轮系参数
+ * @param options 构造选项（`herringbone` 控制是否人字齿）
+ * @returns 太阳 / 行星数组 / 内齿圈 solid 与几何量
+ */
+export declare function buildPlanetaryGearset(kernel: GearKernel, params: PlanetaryGearsetParams, options?: BuildPlanetaryGearsetOptions): PlanetaryGearsetBuild;
+/**
+ * 人字行星轮系（HerringbonePlanetaryGearset）——三件全部人字齿。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param params 行星轮系参数（逐字沿用 Python `HerringbonePlanetaryGearset.__init__`）
+ * @param options 构建选项（strategy / 特征字段，透传单体构造）
+ * @returns sun + planets[] + ring 的构建记录
+ */
+export declare function buildHerringbonePlanetaryGearset(kernel: GearKernel, params: PlanetaryGearsetParams, options?: BuildPlanetaryGearsetOptions): PlanetaryGearsetBuild;
+/**
+ * 行星轮系的导出条目（sun → planet_00.. → ring）。
+ *
+ * @param build 行星轮系构建结果（成员可能为空——只有 `shafts_connected` 时存在）
+ * @returns 具名实体数组（名字进 STEP 产品名，供逐件等价比对）
+ */
+export declare function planetaryExportParts(build: PlanetaryGearsetBuild): Array<{
+    name: string;
+    solid: BrepHandle;
+}>;
+//# sourceMappingURL=planetary.d.ts.map

package/dist/planetary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planetary.d.ts","sourceRoot":"","sources":["../src/planetary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAC+B,KAAK,gBAAgB,EAC1D,MAAM,WAAW,CAAA;AAClB,OAAO,EAC0C,KAAK,oBAAoB,EACzE,MAAM,aAAa,CAAA;AAKpB,gDAAgD;AAChD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,EAAE,MAAM,CAAA;IACxB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,iCAAiC;AACjC,MAAM,WAAW,4BAA6B,SAAQ,oBAAoB;IACxE,wBAAwB;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wBAAwB;IACxB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,wBAAwB;IACxB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,iBAAiB;AACjB,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,UAAU,CAAA;IAChB,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,WAAW,EAAE,gBAAgB,CAAA;IAC7B,cAAc,EAAE,gBAAgB,CAAA;IAChC,YAAY,EAAE,gBAAgB,CAAA;IAC9B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE,4BAAiC,GACzC,qBAAqB,CAgFvB;AAED;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE,4BAAiC,GACzC,qBAAqB,CAEvB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,qBAAqB,GAC3B,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC,CAQ5C"}

package/dist/planetary.js

@@ -0,0 +1,139 @@
+/**
+ * planetary — 行星轮系（PlanetaryGearset / HerringbonePlanetaryGearset）
+ *
+ * 对应 `ring_gear.py`：一个太阳轮 + n 个行星轮 + 一个内齿圈，按中心距均布装配。
+ * 三件各自用现成的实体构造（`buildSpurGearSolid` / `buildRingGearSolid` 及其人字变体），
+ * 差异只在**参数分配**与**装配定位**：
+ *
+ * ## 参数分配（PlanetaryGearset）
+ * - `ring_z = sun_z + planet_z·2`（内齿圈齿数由太阳/行星决定）
+ * - 太阳：`helix_angle`（给定）
+ * - 行星：`helix_angle = -helix_angle`（旋向相反）
+ * - 内齿圈：`helix_angle = -helix_angle`
+ * - `orbit_r = sun.r0 + planet.r0`（行星公转半径）
+ *
+ * ## 装配定位（逐件，复刻 Python `assemble`）
+ * - 太阳：仅在 `planet.z` 为**奇数**时绕 Z 转 `tau_sun/2`（否则恒等）；
+ * - 行星 i：先绕 Z 自转 `tau_planet/2`，再平移到 `(cos(i·a)·orbit_r, sin(i·a)·orbit_r, 0)`，
+ *   `a = 2π/n_planets`；
+ * - 内齿圈：绕 Z 转 `tau_ring/2`。
+ *
+ * ⚠️ `cq.Location(Vector(p), Z, angle)` 的语义是「先绕原点 Z 转 angle，再平移 p」
+ * （见 `pairs.ts` 文件头实测结论），故行星定位是 **rotate → translate**，不是反过来。
+ *
+ * HerringbonePlanetaryGearset 继承 PlanetaryGearset，仅把 `gear_cls = HerringboneGear`、
+ * `ring_gear_cls = HerringboneRingGear`——即三件全部走人字齿构建。
+ */
+import { spurGearGeometry, ringGearGeometry, } from './profile.js';
+import { buildSpurGearSolid, buildHerringboneGearSolid, } from './spur_gear.js';
+import { buildRingGearSolid, buildHerringboneRingGearSolid } from './ring_gear.js';
+const Z_AXIS = { point: { x: 0, y: 0, z: 0 }, direction: { x: 0, y: 0, z: 1 } };
+/**
+ * 构建行星轮系（PlanetaryGearset / HerringbonePlanetaryGearset 共用）。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param params 轮系参数
+ * @param options 构造选项（`herringbone` 控制是否人字齿）
+ * @returns 太阳 / 行星数组 / 内齿圈 solid 与几何量
+ */
+export function buildPlanetaryGearset(kernel, params, options = {}) {
+    const herringbone = options.herringbone ?? false;
+    const ringZ = params.sun_teeth_number + params.planet_teeth_number * 2;
+    const sunParams = {
+        module: params.module,
+        teeth_number: params.sun_teeth_number,
+        width: params.width,
+        pressure_angle: params.pressure_angle,
+        helix_angle: params.helix_angle,
+        clearance: params.clearance,
+        backlash: params.backlash,
+    };
+    const planetParams = {
+        module: params.module,
+        teeth_number: params.planet_teeth_number,
+        width: params.width,
+        pressure_angle: params.pressure_angle,
+        helix_angle: -(params.helix_angle ?? 0.0),
+        clearance: params.clearance,
+        backlash: params.backlash,
+    };
+    const ringParams = {
+        module: params.module,
+        teeth_number: ringZ,
+        width: params.width,
+        rim_width: params.rim_width,
+        pressure_angle: params.pressure_angle,
+        helix_angle: -(params.helix_angle ?? 0.0),
+        clearance: params.clearance,
+        backlash: params.backlash,
+    };
+    const sunGeom = spurGearGeometry(sunParams);
+    const planetGeom = spurGearGeometry(planetParams);
+    const ringGeom = ringGearGeometry(ringParams);
+    const orbitR = sunGeom.r0 + planetGeom.r0;
+    const nPlanets = params.n_planets;
+    const out = {
+        planets: [], sunGeometry: sunGeom, planetGeometry: planetGeom,
+        ringGeometry: ringGeom, orbitR, nPlanets,
+    };
+    // 太阳：仅在 planet.z 为奇数时绕 Z 转 tau_sun/2
+    if (options.buildSun !== false) {
+        let sun = herringbone
+            ? buildHerringboneGearSolid(kernel, sunParams, options)
+            : buildSpurGearSolid(kernel, sunParams, options);
+        if (params.planet_teeth_number % 2 !== 0) {
+            sun = kernel.rotate(sun, Z_AXIS, sunGeom.tau / 2);
+        }
+        out.sun = sun;
+    }
+    // 行星：先自转 tau_planet/2，再平移到均布位置
+    if (options.buildPlanets !== false && nPlanets > 0) {
+        const planetA = (Math.PI * 2.0) / nPlanets;
+        for (let i = 0; i < nPlanets; i++) {
+            let p = herringbone
+                ? buildHerringboneGearSolid(kernel, planetParams, options)
+                : buildSpurGearSolid(kernel, planetParams, options);
+            p = kernel.rotate(p, Z_AXIS, planetGeom.tau / 2);
+            p = kernel.translate(p, Math.cos(i * planetA) * orbitR, Math.sin(i * planetA) * orbitR, 0);
+            out.planets.push(p);
+        }
+    }
+    // 内齿圈：绕 Z 转 tau_ring/2
+    if (options.buildRing !== false) {
+        let ring = herringbone
+            ? buildHerringboneRingGearSolid(kernel, ringParams, options)
+            : buildRingGearSolid(kernel, ringParams, options);
+        ring = kernel.rotate(ring, Z_AXIS, ringGeom.tau / 2);
+        out.ring = ring;
+    }
+    return out;
+}
+/**
+ * 人字行星轮系（HerringbonePlanetaryGearset）——三件全部人字齿。
+ *
+ * @param kernel 原始 OCCT 内核
+ * @param params 行星轮系参数（逐字沿用 Python `HerringbonePlanetaryGearset.__init__`）
+ * @param options 构建选项（strategy / 特征字段，透传单体构造）
+ * @returns sun + planets[] + ring 的构建记录
+ */
+export function buildHerringbonePlanetaryGearset(kernel, params, options = {}) {
+    return buildPlanetaryGearset(kernel, params, { ...options, herringbone: true });
+}
+/**
+ * 行星轮系的导出条目（sun → planet_00.. → ring）。
+ *
+ * @param build 行星轮系构建结果（成员可能为空——只有 `shafts_connected` 时存在）
+ * @returns 具名实体数组（名字进 STEP 产品名，供逐件等价比对）
+ */
+export function planetaryExportParts(build) {
+    const parts = [];
+    if (build.sun)
+        parts.push({ name: 'sun', solid: build.sun });
+    build.planets.forEach((p, i) => {
+        parts.push({ name: `planet_${String(i).padStart(2, '0')}`, solid: p });
+    });
+    if (build.ring)
+        parts.push({ name: 'ring', solid: build.ring });
+    return parts;
+}
+//# sourceMappingURL=planetary.js.map

package/dist/planetary.js.map

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

package/dist/profile.d.ts

@@ -0,0 +1,439 @@
+/**
+ * profile — SpurGear 齿廓与齿面点阵（cq_gears `spur_gear.py` 的数学部分）
+ *
+ * 只做**纯数学**，不碰内核：输出的是点集，可直接与 Python 侧
+ * `SpurGear.t_lflank_pts` 等内部数组逐点比对（见 `profile.test.ts`）。
+ *
+ * 参数名**逐字沿用 Python**（`module` / `teeth_number` / `pressure_angle` …），
+ * 这样 `regression_test_cases.json` 可以零转换直接喂进来。
+ */
+import { type Vec3 } from './math.js';
+/** `GearBase` 的类级常量（cq_gears `spur_gear.py:27-39`），逐字保留。 */
+export declare const GEAR_BASE_CONSTANTS: {
+    readonly ka: 1;
+    readonly kd: 1.25;
+    readonly curve_points: 20;
+    readonly surface_splines: 5;
+    readonly wire_comb_tol: 0.01;
+    readonly spline_approx_tol: 0.01;
+    readonly shell_sewing_tol: 0.01;
+    readonly isection_tol: 1e-7;
+    readonly spline_approx_min_deg: 3;
+    readonly spline_approx_max_deg: 8;
+};
+/** SpurGear 构造参数（参数名逐字沿用 Python `SpurGear.__init__`）。 */
+export interface SpurGearParams {
+    module: number;
+    teeth_number: number;
+    width: number;
+    pressure_angle?: number;
+    helix_angle?: number;
+    clearance?: number;
+    backlash?: number;
+    addendum_coeff?: number | null;
+    dedendum_coeff?: number | null;
+}
+/** HyperbolicGear 构造参数（参数名逐字沿用 `crossed_helical_gear.py::HyperbolicGear.__init__`）。
+ *
+ * 与 `SpurGear` 不同：把 `helix_angle` 换成**显式** `twist_angle`（度），其余齿轮几何
+ * 仍是标准渐开线（它继承 `SpurGear`，`__init__` 内部以 `helix_angle=0.0` 调用父类）。 */
+export interface HyperbolicGearParams {
+    module: number;
+    teeth_number: number;
+    width: number;
+    /** 喉部扭转角（度，cq `twist_angle`）。 */
+    twist_angle: number;
+    pressure_angle?: number;
+    clearance?: number;
+    backlash?: number;
+}
+/** HyperbolicGear 的全部派生几何量（复用 `SpurGearGeometry` 布局 + `throatR`）。 */
+export type HyperbolicGearGeometry = SpurGearGeometry & {
+    throatR: number;
+};
+/** RingGear 构造参数（参数名逐字沿用 Python `RingGear.__init__`）。
+ *
+ * 注意：内部齿（ring）在 `e73874c` 沿用固定的 `ka=1.0 / kd=1.25`
+ * （`addendum_coeff` 仅 `SpurGear` 支持，见 commit `a6bedc0` 之后的改动），
+ * 所以这里没有 `addendum_coeff` / `dedendum_coeff`。 */
+export interface RingGearParams {
+    module: number;
+    teeth_number: number;
+    width: number;
+    rim_width: number;
+    pressure_angle?: number;
+    helix_angle?: number;
+    clearance?: number;
+    backlash?: number;
+}
+/** SpurGear 的全部派生几何量与四段齿廓点集（`SpurGear.__init__` 的产物）。 */
+export interface SpurGearGeometry {
+    /** 模数 m */
+    m: number;
+    /** 齿数 z */
+    z: number;
+    /** 压力角（弧度） */
+    a0: number;
+    clearance: number;
+    backlash: number;
+    /** 螺旋角（弧度） */
+    helixAngle: number;
+    width: number;
+    ka: number;
+    kd: number;
+    /** 分度圆直径 */
+    d0: number;
+    /** 齿顶高 */
+    adn: number;
+    /** 齿根高 */
+    ddn: number;
+    /** 齿顶圆直径 */
+    da: number;
+    /** 齿根圆直径 */
+    dd: number;
+    /** 分度圆齿厚 */
+    s0: number;
+    invA0: number;
+    /** 分度圆半径 */
+    r0: number;
+    /** 齿顶圆半径 */
+    ra: number;
+    /** 齿根圆半径 */
+    rd: number;
+    /** 基圆半径 */
+    rb: number;
+    /** 齿根过渡起始半径 max(rb, rd) */
+    rr: number;
+    /** 齿距角 2π/z */
+    tau: number;
+    /** 扭转角（弧度，= 0 当 helix_angle = 0） */
+    twistAngle: number;
+    /** 齿面点阵行数（helix_angle = 0 时为 2，否则 5） */
+    surfaceSplines: number;
+    curvePoints: number;
+    /** 左齿廓渐开线点集 */
+    t_lflank_pts: Vec3[];
+    /** 齿顶圆弧点集 */
+    t_tip_pts: Vec3[];
+    /** 右齿廓渐开线点集 */
+    t_rflank_pts: Vec3[];
+    /** 齿根圆弧点集 */
+    t_root_pts: Vec3[];
+}
+/**
+ * 计算 SpurGear 的全部几何量（`SpurGear.__init__` 的移植）。
+ *
+ * @throws 与 Python 同款校验：`addendum_coeff <= 0` / `dedendum_coeff <= 0` /
+ *   齿根圆直径 <= 0。
+ *
+ * @param params 齿轮参数（模数/齿数/宽度等）
+ * @returns 全部派生几何量
+ */
+export declare function spurGearGeometry(params: SpurGearParams): SpurGearGeometry;
+/**
+ * 计算 HyperbolicGear（双曲面齿轮）的全部几何量
+ * （`crossed_helical_gear.py::HyperbolicGear.__init__` 的移植）。
+ *
+ * 它继承 `SpurGear`，**齿廓数学与 SpurGear 同构**——父类以 `helix_angle=0.0` 构造
+ * （故 `twistAngle=0` / `surfaceSplines=2`），然后本函数**覆盖**两处：
+ * - `self.twist_angle = radians(twist_angle)`：扭转角来自显式构造参数，而非 helix 推导；
+ * - `throat_r`（`throat_r = sqrt(rpx² + rpy²)`，`rpx=(r0+ln)/2`、`rpy=ht/2`、
+ *   `ln=cos(twist)·r0`、`ht=sin(twist)·r0`）：喉部半径，用于齿轮对装配的 X 向偏移。
+ *
+ * 返回的仍是 `SpurGearGeometry`（点集布局一致），可直接喂给 `buildGearSolid` /
+ * `toothFaceGrids`；`throatR` 作为扩展字段附带。
+ *
+ * @throws `twist_angle` 缺失（无默认值，与 Python 同款签名）由调用方负责。
+ *
+ * @param params 双曲面齿轮参数（模数/齿数/宽度/扭转角等）
+ * @returns `SpurGearGeometry` + `throatR`
+ */
+export declare function hyperbolicGearGeometry(params: HyperbolicGearParams): HyperbolicGearGeometry;
+/**
+ * 计算 RingGear（内部齿）的全部几何量（`RingGear.__init__` 的移植）。
+ *
+ * 与 SpurGear 的关键差异（内部齿）：
+ * - 齿顶圆 `da = d0 − 2·adn`（比分度圆小）、齿根圆 `dd = d0 + 2·ddn + 2·clearance`（比分度圆大）；
+ * - 齿厚 `s0 = m·(π/2 + backlash·tan(a0))`（注意是 **+**，外齿是 −）；
+ * - 渐开线 `r = linspace(ra, rr)`：从齿顶圆（内）走向齿根圆（外），与外齿方向相反；
+ * - 齿顶圆弧落在 `rd`（外齿是 `ra`）、齿根圆弧落在 `ra`（外齿是 `rd`）——齿尖朝外、齿根朝内。
+ *
+ * `ka` / `kd` 固定取 `GEAR_BASE_CONSTANTS`（内部齿在 `e73874c` 不支持 `addendum_coeff`）。
+ * 返回的仍是 `SpurGearGeometry`（点集布局一致），可直接喂给 `toothFaceGrids` /
+ * `buildToothFaces`，无需为 RingGear 另写齿面构造。
+ *
+ * @throws 与 Python 同款校验：齿根圆直径 <= 0。
+ *
+ * @param params 内部齿参数（模数/齿数/宽度/轮缘宽等）
+ * @returns 全部派生几何量（与 `SpurGearGeometry` 同构）
+ */
+export declare function ringGearGeometry(params: RingGearParams): SpurGearGeometry;
+/** CrossedHelicalGear 构造参数（逐字沿用 `crossed_helical_gear.py::CrossedHelicalGear.__init__`）。
+ *
+ * 与 `SpurGear` 不同：**不接受** `addendum_coeff` / `dedendum_coeff`（源码该构造函数没有这两个形参）。 */
+export interface CrossedHelicalGearParams {
+    module: number;
+    teeth_number: number;
+    width: number;
+    pressure_angle?: number;
+    helix_angle?: number;
+    clearance?: number;
+    backlash?: number;
+}
+/**
+ * 计算 CrossedHelicalGear（交错轴斜齿轮）的全部几何量
+ * （`crossed_helical_gear.py::CrossedHelicalGear.__init__` 的移植）。
+ *
+ * 与 SpurGear 的**根本差异**是「端面模数」而非「法向模数」：
+ * - 端面压力角 `at0 = arctan(a0 / cos(helix))`——⚠️ 源码里 `a0` 是**弧度值**直接除以
+ *   `cos(helix)`（并非 `tan(a0)`），这是 cq_gears 的原始写法，必须逐字复刻，
+ *   否则 `rb` 会偏（实测 case30 rb 由 20.2898 偏到 20.1227）；
+ * - 端面模数 `mt = m / cos(helix)`，分度圆直径 `d0 = mt·z`（SpurGear 是 `m·z`）；
+ * - 分度圆齿厚 `s0 = r0·π/z`（SpurGear 是 `m·(π/2 − backlash·tan(a0))`）；
+ * - 基圆半径 `rb = cos(at0)·r0`。
+ *
+ * 其余（渐开线采样、齿顶/齿根圆弧、扭转角、齿面行数）与 SpurGear 同构，返回的仍是
+ * `SpurGearGeometry`，可直接喂给 `toothFaceGrids` / `buildToothFaces`。
+ *
+ * 源码此处**没有**齿根圆直径校验（与 SpurGear 不同），故不复刻该抛错。
+ *
+ * @param params 交错轴斜齿轮参数（模数/齿数/宽度/螺旋角等）
+ * @returns 全部派生几何量（与 `SpurGearGeometry` 同构）
+ */
+export declare function crossedHelicalGearGeometry(params: CrossedHelicalGearParams): SpurGearGeometry;
+/** BevelGear 构造参数（逐字沿用 `bevel_gear.py::BevelGear.__init__`）。
+ *
+ * ⚠️ 与 SpurGear 不同：用 `cone_angle`（分度锥角，度）而不是 `width`；
+ * 且 `cone_angle` / `face_width` 是**位置参数**（Python 签名里排在压力角之前）。 */
+export interface BevelGearParams {
+    module: number;
+    teeth_number: number;
+    /** 分度锥角（度） */
+    cone_angle: number;
+    /** 齿宽（沿分度锥母线的长度） */
+    face_width: number;
+    pressure_angle?: number;
+    helix_angle?: number;
+    clearance?: number;
+    backlash?: number;
+}
+/** `BevelGear` 覆写 `GearBase` 的类常量（`bevel_gear.py:32`；`helix_angle = 0` 时被改成 2）。 */
+export declare const BEVEL_SURFACE_SPLINES = 12;
+/** BevelGear 的全部派生几何量与四段齿廓点集（`BevelGear.__init__` 的产物）。
+ *
+ * ⚠️ 四段点集与 SpurGear 不同：它们是**单位球面上的点**（`r = 1`），
+ * 真正落到齿面上要乘以每行的锥距 `r ∈ [tc_f, pc_f]`（见 `bevel_gear.ts`）。 */
+export interface BevelGearGeometry {
+    /** 模数 m */
+    m: number;
+    /** 齿数 z */
+    z: number;
+    /** 压力角（弧度） */
+    a0: number;
+    clearance: number;
+    backlash: number;
+    /** 螺旋角（弧度） */
+    helixAngle: number;
+    /** 齿宽（锥距方向） */
+    faceWidth: number;
+    ka: number;
+    kd: number;
+    /** 分度圆半径 rp = m·z/2 */
+    rp: number;
+    /** 大球半径（= 分度锥母线长）gs_r = rp / sin(gamma_p) */
+    gsR: number;
+    /** 分度锥角（弧度） */
+    gammaP: number;
+    /** 基锥角（弧度） */
+    gammaB: number;
+    /** 面锥角（弧度） */
+    gammaF: number;
+    /** 根锥角（弧度） */
+    gammaR: number;
+    /** 齿距角 2π/z */
+    tau: number;
+    /** 锥顶到齿轮底面的距离 cone_h = cos(gamma_r)·gs_r */
+    coneH: number;
+    /** 齿镜像点方位角 mp_theta = π/z + 2·s_inv(gamma_b, gamma_p) */
+    mpTheta: number;
+    /** 扭转角（弧度；helix_angle = 0 时为 0） */
+    twistAngle: number;
+    /** 齿面点阵行数（helix_angle = 0 时为 2，否则 12） */
+    surfaceSplines: number;
+    curvePoints: number;
+    /** 左齿廓渐开线点集（**单位球面**） */
+    t_lflank_pts: Vec3[];
+    /** 齿顶圆弧点集（**单位球面**） */
+    t_tip_pts: Vec3[];
+    /** 右齿廓渐开线点集（**单位球面**） */
+    t_rflank_pts: Vec3[];
+    /** 齿根圆弧点集（**单位球面**） */
+    t_root_pts: Vec3[];
+}
+/**
+ * 计算 BevelGear（锥齿轮）的全部几何量（`BevelGear.__init__` 的移植）。
+ *
+ * 与 SpurGear 的根本差异：齿廓画在**单位球面**上（球面渐开线），
+ * 齿面是「球面齿廓 × 锥距」的直纹面；`gamma_b/_f/_r` 分别是基/面/根锥角，
+ * 高度一律用 `r·cos(gamma)` 折算到齿轮轴（+Z）上。
+ *
+ * @throws `gs_r <= face_width` 时抛 RangeError（Python 同款 assert）；
+ *   `twist_angle` 为 NaN 时抛 Error（Python 同款 assert）。
+ *
+ * @param params 锥齿轮参数（模数/齿数/锥角/齿宽等）
+ * @returns 全部派生几何量
+ */
+export declare function bevelGearGeometry(params: BevelGearParams): BevelGearGeometry;
+/** 四段齿廓的名字（`_build_tooth_faces` 的迭代顺序，勿改）。 */
+export declare const TOOTH_SEGMENTS: readonly ["lflank", "tip", "rflank", "root"];
+/** 单个齿廓段的名字。 */
+export type ToothSegment = typeof TOOTH_SEGMENTS[number];
+/**
+ * 取某段齿廓的基础点集（z=0 平面上的轮廓点，与 Python 内部数组逐点一致）。
+ *
+ * @param g 已计算的齿轮几何量
+ * @param seg 齿廓段名
+ * @returns 该段的点集
+ */
+export declare function segmentPoints(g: SpurGearGeometry | WormGeometry | BevelGearGeometry, seg: ToothSegment): Vec3[];
+/** 一个齿面段的行 × 列点阵。 */
+export interface ToothGrid {
+    segment: ToothSegment;
+    rows: number;
+    cols: number;
+    /** 行主序，`points[r][c]` */
+    points: Vec3[][];
+}
+/**
+ * 复现 `SpurGear._build_tooth_faces` 的点阵构造。
+ *
+ * 注意扭转用 `pts @ rotation_matrix(...)`（行向量左乘 ⇒ 实际转 −a，见 `math.ts` 顶部说明），
+ * 与 Python 逐字一致。
+ *
+ * @param twistA 起始扭转角（弧度）
+ * @param twistB 终止扭转角（弧度）
+ * @param zPos   起始 z
+ * @param width  该段宽度
+ * @param g 齿轮几何量
+ * @returns 4 段齿廓各自的 row×col 点阵
+ */
+export declare function toothFaceGrids(g: SpurGearGeometry, twistA?: number, twistB?: number, zPos?: number, width?: number): ToothGrid[];
+/**
+ * 按 cq_gears 类名分派到对应的齿廓几何计算（manifest 的 `class` 字段直接驱动）。
+ *
+ * `HerringboneGear` 继承 `SpurGear`、`HerringboneRingGear` 继承 `RingGear`，
+ * 其**齿廓数学**与父类相同（人字形的差异只体现在建面阶段的 `_build_tooth_faces` 覆盖），
+ * 故分派到同一函数。
+ *
+ * @throws 未支持的类名直接抛错（不静默退回 SpurGear，避免掩盖分派错误）
+ *
+ * @param className cq_gears 类名（`SpurGear` / `RingGear` / `CrossedHelicalGear` …）
+ * @param args 该类构造函数的参数（逐字取自 manifest）
+ * @returns 全部派生几何量
+ */
+export declare function gearGeometryForClass(className: string, args: Record<string, unknown>): SpurGearGeometry | WormGeometry | BevelGearGeometry | HyperbolicGearGeometry;
+/** RackGear 构造参数（参数名逐字沿用 Python `RackGear.__init__`）。 */
+export interface RackGearParams {
+    module: number;
+    length: number;
+    width: number;
+    height: number;
+    pressure_angle?: number;
+    helix_angle?: number;
+    clearance?: number;
+    backlash?: number;
+}
+/** RackGear 的全部派生几何量与四段齿廓点集（`RackGear.__init__` 的产物）。 */
+export interface RackGearGeometry {
+    m: number;
+    /** 压力角（弧度） */
+    a0: number;
+    clearance: number;
+    backlash: number;
+    /** 螺旋角（弧度） */
+    helixAngle: number;
+    width: number;
+    length: number;
+    height: number;
+    /** 齿顶线（+y） */
+    la: number;
+    /** 齿根线（−y） */
+    ld: number;
+    /** 分度线上的齿厚（x 向） */
+    s0: number;
+    /** 齿廓总高（la − ld） */
+    toothHeight: number;
+    /** 齿数 z = ceil(length / (π·m)) */
+    z: number;
+    t_lflank_pts: Vec3[];
+    t_tip_pts: Vec3[];
+    t_rflank_pts: Vec3[];
+    t_root_pts: Vec3[];
+}
+/**
+ * 计算 RackGear 的全部几何量（`RackGear.__init__` 的移植）。
+ *
+ * 齿条齿廓是**梯形直线段**（每段只有 2 个点），沿 X 以 π·m 为周期重复；
+ * 齿深方向是 +y（la 在上、ld 在下），实体沿 Z 挤出 width。
+ * `ka`/`kd` 沿用 GearBase 类常量（RackGear 构造函数不接受 addendum/dedendum 覆盖）。
+ *
+ * @param params 齿条参数（模数/长度/宽/高/螺旋角等）
+ * @returns 全部派生几何量
+ */
+export declare function rackGearGeometry(params: RackGearParams): RackGearGeometry;
+/** Worm 构造参数（参数名逐字沿用 Python `Worm.__init__`）。 */
+export interface WormParams {
+    module: number;
+    /** 导程角（度） */
+    lead_angle: number;
+    /** 蜗杆头数 */
+    n_threads: number;
+    /** 蜗杆长度（轴向，沿 X） */
+    length: number;
+    pressure_angle?: number;
+    clearance?: number;
+    backlash?: number;
+}
+/** Worm 的全部派生几何量与四段齿廓点集（`Worm.__init__` 的产物）。 */
+export interface WormGeometry {
+    m: number;
+    /** 压力角（弧度） */
+    a0: number;
+    clearance: number;
+    backlash: number;
+    /** 导程角（弧度） */
+    leadAngle: number;
+    length: number;
+    /** 头数 */
+    nThreads: number;
+    /** 分度圆半径 */
+    r0: number;
+    /** 齿顶圆半径 */
+    ra: number;
+    /** 齿根圆半径 */
+    rd: number;
+    /** 齿顶线（+y） */
+    la: number;
+    /** 齿根线（−y） */
+    ld: number;
+    /** 分度线上的齿厚（x 向，半齿距） */
+    s0: number;
+    /** 齿廓总高（la − ld，Python `self.tooth_height`） */
+    toothHeight: number;
+    t_lflank_pts: Vec3[];
+    t_tip_pts: Vec3[];
+    t_rflank_pts: Vec3[];
+    t_root_pts: Vec3[];
+}
+/**
+ * 计算 Worm 的全部几何量（`Worm.__init__` 的移植）。
+ *
+ * 齿廓公式与 `RackGear.__init__` **逐字同构**（梯形直线段 p1–p5）——cq 里 Worm
+ * 的齿廓本来就是「展开到分度圆柱切平面上的齿条」。差异只在分度半径：
+ * `d0 = n_threads·m / |tan(lead_angle)|`，以及半径向的 ra/rd。
+ *
+ * @param params 蜗杆参数（模数/导程角/头数/长度等）
+ * @returns 全部派生几何量
+ */
+export declare function wormGeometry(params: WormParams): WormGeometry;
+//# sourceMappingURL=profile.d.ts.map