@faicad/fai-cq-warehouse 0.13.0

package/dist/holes.d.ts

@@ -0,0 +1,186 @@
+/**
+ * holes — P1-b 孔系列（`extensions.py:865–1363` 的函数式移植）
+ *
+ * 上游以 Workplane monkey-patch 提供 `clearanceHole` / `tapHole` / `threadedHole` /
+ * `insertHole` / `pressFitHole` / `fastenerHole` / `pushFastenerLocations`；
+ * 本包按方案红线**不做 monkey-patch**，以函数式 API 提供（目标件显式入参）。
+ *
+ * 语义对齐（`_fastenerHole` 核心，extensions.py:865–1009）：
+ *  - 孔切割器 = 沉头（轮廓 revolve，下移 head_offset）∪ 杆部圆柱（轴向 −Z）∪ 钻尖圆锥
+ *    （cskAngle=82°）；
+ *  - `depth=None` → 贯穿（`bboxDiagonal(part)` ≈ `Workplane.largestDimension()`）；
+ *  - 螺纹孔（`threadedHole`）= 间隙孔 + 内螺纹 IsoThread(external=False) 并集；
+ *  - 逐孔位 `cut`（上游 `cutEach`）。
+ *
+ * ⚠️ W4 的 `recess.ts` Temp* 临时实现在本文件落地后由 `src/nut.ts` 的 BradTeeNut
+ * 改调本文件（`fastenerHole` 路径），Temp 节随替换删除（方案 §8-W4 去重表）。
+ */
+import type { BrepHandle } from '@faicad/faijs';
+import { type Hand } from './thread.js';
+/** 钻尖角（度）—— 上游 `cskAngle = 82`（extensions.py:975）。 */
+export declare const DRILL_TIP_ANGLE = 82;
+/** 沉头轮廓点列（r-z 半剖面，z 轴为旋转轴）。 */
+export interface ProfilePoint {
+    r: number;
+    z: number;
+}
+/** 孔位（世界坐标，孔口所在点）。 */
+export interface HoleLocation {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * 孔切割器（局部坐标：孔口在 z=0，孔轴向 −Z）—— `_fastenerHole` 的几何核心。
+ *
+ * @param p.countersinkProfile 沉头轮廓（`null` = 无沉头，如 SetScrew）
+ * @param p.holeRadius 孔半径
+ * @param p.depth 孔深
+ * @param p.threaded 内螺纹：提供则并集一个内螺纹 IsoThread（`threadedHole` 用）
+ * @param p.hand 螺纹旋向（threaded 时必填语义上由调用方保证）
+ * @param p.simple true → 跳过内螺纹（上游 `simple=True` 只打直孔）
+ */
+export interface FastenerHoleCutterParams {
+    countersinkProfile: ProfilePoint[] | null;
+    holeRadius: number;
+    depth: number;
+    threadDiameter?: number;
+    threadPitch?: number;
+    hand?: Hand;
+    simple?: boolean;
+}
+/**
+ * 组装孔切割器实体（沉头 ∪ 杆部 ∪ 钻尖）。
+ * @param p - 切割器参数（countersinkProfile 沉头轮廓、holeRadius 孔径、depth 深、可选 threadDiameter/threadPitch/hand/simple）。
+ * @returns 切割器句柄，调用方平移到孔位后自行 cut。
+ */
+export declare function fastenerHoleCutter(p: FastenerHoleCutterParams): BrepHandle;
+/**
+ * 内螺纹体（threadedHole 用）—— 上游 `_fastenerHole` 里它是**切割后 union 回
+ * 零件**的（extensions.py:998–1005），**不是**切割器的一部分；置于孔底
+ * `bore_direction * depth`，长 `depth − head_offset`。
+ * @param p - 螺纹参数：threadDiameter 公称径、threadPitch 螺距、length 长、可选 hand 旋向。
+ * @returns 内螺纹实体句柄（BrepHandle）。
+ */
+export declare function internalThreadSolid(p: {
+    threadDiameter: number;
+    threadPitch: number;
+    length: number;
+    hand?: Hand;
+}): BrepHandle;
+/** clearanceHole 参数（语义对齐 `extensions._clearanceHole`）。 */
+export interface ClearanceHoleParams {
+    /** 目标件（上游为 Workplane 栈上的实体）。 */
+    part: BrepHandle;
+    /** 螺纹公称直径（如 'M6'）——查 `clearance_hole_sizes`。 */
+    size: string;
+    /** 孔位列表（世界坐标）。 */
+    locations: HoleLocation[];
+    fit?: 'Close' | 'Normal' | 'Loose';
+    /** 孔深；缺省贯穿（bboxDiagonal）。 */
+    depth?: number;
+    /** 沉头轮廓；`null` = 无沉头。 */
+    countersinkProfile?: ProfilePoint[] | null;
+    counterSunk?: boolean;
+    /** 螺纹直径（用于 largestDimension 对齐时的最小深度参考；B 侧直接用贯穿）。 */
+    threadDiameter?: number;
+}
+/**
+ * clearanceHole —— 间隙孔（`extensions.py:1080` 起的 `_clearanceHole`）。
+ * HeatSetNut 不可用（上游同样拒绝，提示改用 insertHole）。
+ * @param p - 间隙孔参数（part 目标件、size 螺纹规格、locations 孔位、可选 fit/depth/countersinkProfile/counterSunk/threadDiameter）。
+ * @returns 打孔后的零件实体。
+ */
+export declare function clearanceHole(p: ClearanceHoleParams): BrepHandle;
+/** tapHole 参数（语义对齐 `_tapHole`：material 定孔径）。 */
+export interface TapHoleParams {
+    part: BrepHandle;
+    size: string;
+    locations: HoleLocation[];
+    material?: 'Soft' | 'Hard';
+    fit?: 'Close' | 'Normal' | 'Loose';
+    depth?: number;
+    countersinkProfile?: ProfilePoint[] | null;
+    counterSunk?: boolean;
+}
+/**
+ * tapHole —— 攻丝底孔（直孔，无螺纹；上游 `_tapHole` → `_fastenerHole(hand=None)`）。
+ * @param p - 攻丝孔参数（part、size、locations、可选 material/fit/depth/countersinkProfile/counterSunk）。
+ * @returns 打孔后的零件实体。
+ */
+export declare function tapHole(p: TapHoleParams): BrepHandle;
+/** threadedHole 参数（语义对齐 `_threadedHole`：间隙孔 + 内螺纹）。 */
+export interface ThreadedHoleParams {
+    part: BrepHandle;
+    size: string;
+    locations: HoleLocation[];
+    /** 螺距（来自紧固件参数行 `pitch`）。 */
+    pitch: number;
+    hand?: Hand;
+    simple?: boolean;
+    fit?: 'Close' | 'Normal' | 'Loose';
+    depth?: number;
+    countersinkProfile?: ProfilePoint[] | null;
+    counterSunk?: boolean;
+}
+/**
+ * threadedHole —— 螺纹孔：间隙孔切割后再与内螺纹 IsoThread 求并（上游
+ * `_threadedHole` → `_fastenerHole(hand≠None)`，`simple=False` 才有螺纹体）。
+ * @param p - 螺纹孔参数（part、size、locations、pitch、可选 hand/simple/fit/depth/countersinkProfile/counterSunk）。
+ * @returns 打孔并含内螺纹的零件实体。
+ */
+export declare function threadedHole(p: ThreadedHoleParams): BrepHandle;
+/** insertHole 参数（语义对齐 `_insertHole`：仅 HeatSetNut，间隙孔径）。 */
+export interface InsertHoleParams {
+    part: BrepHandle;
+    size: string;
+    locations: HoleLocation[];
+    fit?: 'Close' | 'Normal' | 'Loose';
+    depth?: number;
+}
+/**
+ * insertHole —— HeatSetNut 专用直孔（上游拒绝其它紧固件类型）。
+ * 注：W4 起 `HeatSetNut` 本体因内核缺 `makeNSidedSurface` 显式抛错；本函数
+ * 只依赖间隙孔径表，可用。
+ * @param p - 直孔参数（part、size、locations、可选 fit/depth）。
+ * @returns 打孔后的零件实体。
+ */
+export declare function insertHole(p: InsertHoleParams): BrepHandle;
+/** pressFitHole 参数（语义对齐 `_pressFitHole`：仅 Bearing，间隙孔径）。 */
+export interface PressFitHoleParams {
+    part: BrepHandle;
+    size: string;
+    locations: HoleLocation[];
+    fit?: 'Close' | 'Normal' | 'Loose';
+    depth?: number;
+}
+/**
+ * pressFitHole —— 轴承压入孔（上游拒绝非 Bearing；外圈间隙孔径表）。
+ * Bearing 的孔径表在 bearing 参数行（`clearance_hole_diameters`），此处按 size 查。
+ * @param p - 压入孔参数（part、size、locations、可选 fit/depth）。
+ * @returns 打孔后的零件实体。
+ */
+export declare function pressFitHole(p: PressFitHoleParams): BrepHandle;
+/**
+ * fastenerHole —— 通用入口（语义对齐 `_fastenerHole` 本体）：调用方直接给
+ * 孔径/沉头/螺纹参数，不必经过各具名封装。
+ */
+export interface FastenerHoleParams extends FastenerHoleCutterParams {
+    part: BrepHandle;
+    locations: HoleLocation[];
+}
+/**
+ * fastenerHole —— 通用入口（语义对齐 `_fastenerHole` 本体）：调用方直接给
+ * 孔径/沉头/螺纹参数，不必经过各具名封装；逐孔位切割。
+ * @param p - 通用孔参数（FastenerHoleCutterParams + part + locations）。
+ * @returns 打孔后的零件实体。
+ */
+export declare function fastenerHole(p: FastenerHoleParams): BrepHandle;
+/**
+ * pushFastenerLocations —— 记录孔位（上游为 Assembly 收集紧固件用；
+ * 函数式形态下直接返回入参孔位副本，供调用方装配用）。
+ * @param locations - 孔位列表。
+ * @returns 孔位副本（HoleLocation[]）。
+ */
+export declare function pushFastenerLocations(locations: HoleLocation[]): HoleLocation[];
+//# sourceMappingURL=holes.d.ts.map

package/dist/holes.d.ts.map

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

package/dist/holes.js

@@ -0,0 +1,197 @@
+/**
+ * holes — P1-b 孔系列（`extensions.py:865–1363` 的函数式移植）
+ *
+ * 上游以 Workplane monkey-patch 提供 `clearanceHole` / `tapHole` / `threadedHole` /
+ * `insertHole` / `pressFitHole` / `fastenerHole` / `pushFastenerLocations`；
+ * 本包按方案红线**不做 monkey-patch**，以函数式 API 提供（目标件显式入参）。
+ *
+ * 语义对齐（`_fastenerHole` 核心，extensions.py:865–1009）：
+ *  - 孔切割器 = 沉头（轮廓 revolve，下移 head_offset）∪ 杆部圆柱（轴向 −Z）∪ 钻尖圆锥
+ *    （cskAngle=82°）；
+ *  - `depth=None` → 贯穿（`bboxDiagonal(part)` ≈ `Workplane.largestDimension()`）；
+ *  - 螺纹孔（`threadedHole`）= 间隙孔 + 内螺纹 IsoThread(external=False) 并集；
+ *  - 逐孔位 `cut`（上游 `cutEach`）。
+ *
+ * ⚠️ W4 的 `recess.ts` Temp* 临时实现在本文件落地后由 `src/nut.ts` 的 BradTeeNut
+ * 改调本文件（`fastenerHole` 路径），Temp 节随替换删除（方案 §8-W4 去重表）。
+ */
+import { requireKernel } from './kernel.js';
+import { cone, cylinder, fuse, revolveProfile, polygonWire, translate, bboxDiagonal, } from './primitives.js';
+import { isoThread } from './thread.js';
+import { clearanceHoleDiameters, tapHoleDiameters } from './params.js';
+/** 钻尖角（度）—— 上游 `cskAngle = 82`（extensions.py:975）。 */
+export const DRILL_TIP_ANGLE = 82;
+/** 旋转轴（+Z）。 */
+const AXIS_Z = { point: { x: 0, y: 0, z: 0 }, direction: { x: 0, y: 0, z: 1 } };
+/**
+ * 组装孔切割器实体（沉头 ∪ 杆部 ∪ 钻尖）。
+ * @param p - 切割器参数（countersinkProfile 沉头轮廓、holeRadius 孔径、depth 深、可选 threadDiameter/threadPitch/hand/simple）。
+ * @returns 切割器句柄，调用方平移到孔位后自行 cut。
+ */
+export function fastenerHoleCutter(p) {
+    const { countersinkProfile, holeRadius, depth } = p;
+    const headOffset = countersinkProfile !== null ? Math.max(...countersinkProfile.map((q) => q.z)) : 0;
+    let cutter;
+    if (countersinkProfile !== null) {
+        // ① 沉头：轮廓绕 +Z 旋转，下移 head_offset → z ∈ [−headOffset, 0]
+        const csk = translate(revolveProfile(polygonWire(countersinkProfile.map((q) => ({ x: q.r, y: 0, z: q.z }))), AXIS_Z, 2 * Math.PI), 0, 0, -headOffset);
+        // ② 杆部：自 z=0 向 −Z 长 depth
+        const shank = translate(cylinder(holeRadius, depth), 0, 0, -depth);
+        cutter = fuse(csk, shank);
+    }
+    else {
+        cutter = translate(cylinder(holeRadius, depth), 0, 0, -depth);
+    }
+    // ③ 钻尖：底半径 holeRadius 于 z=−depth，尖顶向下
+    const h = holeRadius / Math.tan(((DRILL_TIP_ANGLE / 2) * Math.PI) / 180);
+    const tip = translate(cone(0, holeRadius, h), 0, 0, -depth - h);
+    return fuse(cutter, tip);
+}
+/**
+ * 内螺纹体（threadedHole 用）—— 上游 `_fastenerHole` 里它是**切割后 union 回
+ * 零件**的（extensions.py:998–1005），**不是**切割器的一部分；置于孔底
+ * `bore_direction * depth`，长 `depth − head_offset`。
+ * @param p - 螺纹参数：threadDiameter 公称径、threadPitch 螺距、length 长、可选 hand 旋向。
+ * @returns 内螺纹实体句柄（BrepHandle）。
+ */
+export function internalThreadSolid(p) {
+    const thread = isoThread({
+        major_diameter: p.threadDiameter,
+        pitch: p.threadPitch,
+        length: p.length,
+        external: false,
+        hand: p.hand ?? 'right',
+    });
+    if (thread.handle === null) {
+        throw new Error('internalThreadSolid: IsoThread returned no solid');
+    }
+    return thread.handle;
+}
+/** 逐孔位切割公共实现：对 part 在每个 location 上 cut 同一切割器。 */
+function cutAtLocations(part, cutter, locations) {
+    const k = requireKernel();
+    let out = part;
+    for (const loc of locations) {
+        const moved = translate(cutter, loc.x, loc.y, loc.z);
+        out = k.cut(out, moved);
+    }
+    return out;
+}
+/** 解析孔径：fit（间隙）或 material（攻丝），缺失即抛错（对齐上游 ValueError）。 */
+function resolveDiameter(table, key, what) {
+    const k = key ?? 'Normal';
+    const v = table[k];
+    if (typeof v !== 'number') {
+        throw new Error(`${what}: ${k} invalid, must be one of ${Object.keys(table).join(', ')}`);
+    }
+    return v;
+}
+/**
+ * clearanceHole —— 间隙孔（`extensions.py:1080` 起的 `_clearanceHole`）。
+ * HeatSetNut 不可用（上游同样拒绝，提示改用 insertHole）。
+ * @param p - 间隙孔参数（part 目标件、size 螺纹规格、locations 孔位、可选 fit/depth/countersinkProfile/counterSunk/threadDiameter）。
+ * @returns 打孔后的零件实体。
+ */
+export function clearanceHole(p) {
+    const fit = p.fit ?? 'Normal';
+    const diameters = clearanceHoleDiameters(p.size);
+    const holeRadius = resolveDiameter(diameters, fit, 'clearanceHole') / 2;
+    const depth = p.depth ?? bboxDiagonal(p.part);
+    const csk = p.counterSunk === false ? null : (p.countersinkProfile ?? null);
+    const cutter = fastenerHoleCutter({ countersinkProfile: csk, holeRadius, depth });
+    return cutAtLocations(p.part, cutter, p.locations);
+}
+/**
+ * tapHole —— 攻丝底孔（直孔，无螺纹；上游 `_tapHole` → `_fastenerHole(hand=None)`）。
+ * @param p - 攻丝孔参数（part、size、locations、可选 material/fit/depth/countersinkProfile/counterSunk）。
+ * @returns 打孔后的零件实体。
+ */
+export function tapHole(p) {
+    const material = p.material ?? 'Soft';
+    const diameters = tapHoleDiameters(p.size);
+    const holeRadius = resolveDiameter(diameters, material, 'tapHole') / 2;
+    const depth = p.depth ?? bboxDiagonal(p.part);
+    const csk = p.counterSunk === false ? null : (p.countersinkProfile ?? null);
+    const cutter = fastenerHoleCutter({ countersinkProfile: csk, holeRadius, depth });
+    return cutAtLocations(p.part, cutter, p.locations);
+}
+/**
+ * threadedHole —— 螺纹孔：间隙孔切割后再与内螺纹 IsoThread 求并（上游
+ * `_threadedHole` → `_fastenerHole(hand≠None)`，`simple=False` 才有螺纹体）。
+ * @param p - 螺纹孔参数（part、size、locations、pitch、可选 hand/simple/fit/depth/countersinkProfile/counterSunk）。
+ * @returns 打孔并含内螺纹的零件实体。
+ */
+export function threadedHole(p) {
+    const fit = p.fit ?? 'Normal';
+    const diameters = clearanceHoleDiameters(p.size);
+    const holeRadius = resolveDiameter(diameters, fit, 'threadedHole') / 2;
+    const depth = p.depth ?? bboxDiagonal(p.part);
+    const csk = p.counterSunk === false ? null : (p.countersinkProfile ?? null);
+    const headOffset = csk !== null ? Math.max(...csk.map((q) => q.z)) : 0;
+    const cutter = fastenerHoleCutter({ countersinkProfile: csk, holeRadius, depth });
+    let out = cutAtLocations(p.part, cutter, p.locations);
+    // 上游：threaded 且非 simple 时，把内螺纹 union 回零件（extensions.py:998–1005）
+    if (p.simple !== true) {
+        const thread = internalThreadSolid({
+            threadDiameter: Number(p.size.replace(/[^0-9.]/g, '')),
+            threadPitch: p.pitch,
+            length: depth - headOffset,
+            hand: p.hand,
+        });
+        const k = requireKernel();
+        for (const loc of p.locations) {
+            const moved = translate(thread, loc.x, loc.y, loc.z - depth);
+            out = k.fuse(out, moved);
+        }
+    }
+    return out;
+}
+/**
+ * insertHole —— HeatSetNut 专用直孔（上游拒绝其它紧固件类型）。
+ * 注：W4 起 `HeatSetNut` 本体因内核缺 `makeNSidedSurface` 显式抛错；本函数
+ * 只依赖间隙孔径表，可用。
+ * @param p - 直孔参数（part、size、locations、可选 fit/depth）。
+ * @returns 打孔后的零件实体。
+ */
+export function insertHole(p) {
+    const fit = p.fit ?? 'Normal';
+    const diameters = clearanceHoleDiameters(p.size);
+    const holeRadius = resolveDiameter(diameters, fit, 'insertHole') / 2;
+    const depth = p.depth ?? bboxDiagonal(p.part);
+    const cutter = fastenerHoleCutter({ countersinkProfile: null, holeRadius, depth });
+    return cutAtLocations(p.part, cutter, p.locations);
+}
+/**
+ * pressFitHole —— 轴承压入孔（上游拒绝非 Bearing；外圈间隙孔径表）。
+ * Bearing 的孔径表在 bearing 参数行（`clearance_hole_diameters`），此处按 size 查。
+ * @param p - 压入孔参数（part、size、locations、可选 fit/depth）。
+ * @returns 打孔后的零件实体。
+ */
+export function pressFitHole(p) {
+    const fit = p.fit ?? 'Normal';
+    const diameters = clearanceHoleDiameters(p.size);
+    const holeRadius = resolveDiameter(diameters, fit, 'pressFitHole') / 2;
+    const depth = p.depth ?? bboxDiagonal(p.part);
+    const cutter = fastenerHoleCutter({ countersinkProfile: null, holeRadius, depth });
+    return cutAtLocations(p.part, cutter, p.locations);
+}
+/**
+ * fastenerHole —— 通用入口（语义对齐 `_fastenerHole` 本体）：调用方直接给
+ * 孔径/沉头/螺纹参数，不必经过各具名封装；逐孔位切割。
+ * @param p - 通用孔参数（FastenerHoleCutterParams + part + locations）。
+ * @returns 打孔后的零件实体。
+ */
+export function fastenerHole(p) {
+    const { part, locations, ...cutter } = p;
+    return cutAtLocations(part, fastenerHoleCutter(cutter), locations);
+}
+/**
+ * pushFastenerLocations —— 记录孔位（上游为 Assembly 收集紧固件用；
+ * 函数式形态下直接返回入参孔位副本，供调用方装配用）。
+ * @param locations - 孔位列表。
+ * @returns 孔位副本（HoleLocation[]）。
+ */
+export function pushFastenerLocations(locations) {
+    return locations.map((l) => ({ ...l }));
+}
+//# sourceMappingURL=holes.js.map

package/dist/holes.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * index — fai_cq_warehouse 公共 API 入口（W8 汇总导出）
+ *
+ * 移植自 cq_warehouse（上游 0.8.0）的 6 个几何模块：
+ * thread（5 类）/ nut（7 类）/ screw（12 类）/ washer（3 类）/ bearing（5 类）/ sprocket（1 类）。
+ *
+ * 约定（方案 §4.2，与 fai_cq_gears 同构）：
+ * - 参数名逐字沿用 Python；构建函数返回 `Result`（kernel 阶段失败转 `err`）。
+ * - `types()`/`sizes()` 类方法转 `nutTypes()`/`nutSizes()` 等函数式形态（params.ts）。
+ * - `contractVersion` 语义见方案 §4.2.1：本包 API 形状 + 参数表来源 + STEP 输出
+ *   形态的行为契约版本；与内核契约对齐（照 fai_cq_gears，勿硬编码）。
+ * - P1 增项已落地：孔系列（holes.ts，函数式）与 Chain（chain.ts，平面 2+ 链轮），
+ *   见 Agent Note 2026-09-15-fai-cq-warehouse-w9-p1-chain-holes。
+ */
+export { contractVersion } from './contract.js';
+export type { Result } from '@faicad/faijs';
+export { type ParamRow, type ParamTable, isolateFastenerType, typesOf, sizesOf, NUT_TABLES, SCREW_TABLES, WASHER_TABLES, BEARING_TABLES, type NutClassName, type ScrewClassName, type WasherClassName, type BearingClassName, nutTypes, nutSizes, screwTypes, screwSizes, bearingTypes, bearingSizes, washerTypes, washerSizes, clearanceHoleDiameters, tapHoleDiameters, selectBySize, } from './params.js';
+export { INCH, metricStrToFloat, imperialStrToFloat, evalArithmetic, evaluateCell, } from './measure.js';
+export { type EndFinish, type Hand, type ThreadSpec, type ThreadResult, type IsoThreadParams, type TrapezoidalParams, type PlasticBottleThreadParams, ACME_PITCH, METRIC_TRAPEZOIDAL_SIZES, buildThread, isoThreadDimensions, isoThread, acmeThreadSizes, acmeThreadParseSize, acmeThread, metricTrapezoidalThreadSizes, metricTrapezoidalThreadParseSize, metricTrapezoidalThread, plasticBottleThreadDimensions, plasticBottleThread, } from './thread.js';
+export { type NutParams, type NutResult, buildNut, hexNut, hexNutWithFlange, unchamferedHexagonNut, squareNut, domedCapNut, bradTeeNut, heatSetNut, polarArrayLocations, } from './nut.js';
+export { type ScrewParams, type ScrewResult, SCREW_CLASSES, screwProfilePoints, buildScrew, } from './screw.js';
+export { type WasherParams, type WasherResult, plainWasher, chamferedWasher, cheeseHeadWasher, } from './washer.js';
+export { type BearingParams, type BearingResult, BEARING_CLASSES, buildBearing, } from './bearing.js';
+export { type SprocketParams, type SprocketResult, buildSprocket, sprocketPitchRadius, sprocketCircumference, } from './sprocket.js';
+export { DRILL_TIP_ANGLE, type ProfilePoint, type HoleLocation, type FastenerHoleCutterParams, fastenerHoleCutter, internalThreadSolid, type ClearanceHoleParams, clearanceHole, type TapHoleParams, tapHole, type ThreadedHoleParams, threadedHole, type InsertHoleParams, insertHole, type PressFitHoleParams, pressFitHole, type FastenerHoleParams, fastenerHole, pushFastenerLocations, } from './holes.js';
+export { type ChainParams, type ChainPart, type ChainResult, buildChain, makeLink, placeSprocket, } from './chain.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAG3C,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,mBAAmB,EACnB,OAAO,EACP,OAAO,EACP,UAAU,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,sBAAsB,EACtB,gBAAgB,EAChB,YAAY,GACb,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,IAAI,EACJ,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,YAAY,GACb,MAAM,WAAW,CAAA;AAGlB,OAAO,EACL,KAAK,SAAS,EACd,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,UAAU,EACV,wBAAwB,EACxB,WAAW,EACX,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,4BAA4B,EAC5B,gCAAgC,EAChC,uBAAuB,EACvB,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,QAAQ,EACR,MAAM,EACN,gBAAgB,EAChB,qBAAqB,EACrB,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,mBAAmB,GACpB,MAAM,OAAO,CAAA;AAGd,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,aAAa,EACb,kBAAkB,EAClB,UAAU,GACX,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,WAAW,EACX,eAAe,EACf,gBAAgB,GACjB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,eAAe,EACf,YAAY,GACb,MAAM,WAAW,CAAA;AAGlB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,aAAa,EACb,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,aAAa,EACb,KAAK,aAAa,EAClB,OAAO,EACP,KAAK,kBAAkB,EACvB,YAAY,EACZ,KAAK,gBAAgB,EACrB,UAAU,EACV,KAAK,kBAAkB,EACvB,YAAY,EACZ,KAAK,kBAAkB,EACvB,YAAY,EACZ,qBAAqB,GACtB,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,UAAU,EACV,QAAQ,EACR,aAAa,GACd,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,36 @@
+/**
+ * index — fai_cq_warehouse 公共 API 入口（W8 汇总导出）
+ *
+ * 移植自 cq_warehouse（上游 0.8.0）的 6 个几何模块：
+ * thread（5 类）/ nut（7 类）/ screw（12 类）/ washer（3 类）/ bearing（5 类）/ sprocket（1 类）。
+ *
+ * 约定（方案 §4.2，与 fai_cq_gears 同构）：
+ * - 参数名逐字沿用 Python；构建函数返回 `Result`（kernel 阶段失败转 `err`）。
+ * - `types()`/`sizes()` 类方法转 `nutTypes()`/`nutSizes()` 等函数式形态（params.ts）。
+ * - `contractVersion` 语义见方案 §4.2.1：本包 API 形状 + 参数表来源 + STEP 输出
+ *   形态的行为契约版本；与内核契约对齐（照 fai_cq_gears，勿硬编码）。
+ * - P1 增项已落地：孔系列（holes.ts，函数式）与 Chain（chain.ts，平面 2+ 链轮），
+ *   见 Agent Note 2026-09-15-fai-cq-warehouse-w9-p1-chain-holes。
+ */
+export { contractVersion } from './contract.js';
+// ── 参数表查询（types()/sizes()/select_by_size 等价面）────────────────────────
+export { isolateFastenerType, typesOf, sizesOf, NUT_TABLES, SCREW_TABLES, WASHER_TABLES, BEARING_TABLES, nutTypes, nutSizes, screwTypes, screwSizes, bearingTypes, bearingSizes, washerTypes, washerSizes, clearanceHoleDiameters, tapHoleDiameters, selectBySize, } from './params.js';
+// ── 字符串度量解析 ────────────────────────────────────────────────────────────
+export { INCH, metricStrToFloat, imperialStrToFloat, evalArithmetic, evaluateCell, } from './measure.js';
+// ── thread：Thread / IsoThread / AcmeThread / MetricTrapezoidalThread / PlasticBottleThread ──
+export { ACME_PITCH, METRIC_TRAPEZOIDAL_SIZES, buildThread, isoThreadDimensions, isoThread, acmeThreadSizes, acmeThreadParseSize, acmeThread, metricTrapezoidalThreadSizes, metricTrapezoidalThreadParseSize, metricTrapezoidalThread, plasticBottleThreadDimensions, plasticBottleThread, } from './thread.js';
+// ── nut：7 类螺母 ─────────────────────────────────────────────────────────────
+export { buildNut, hexNut, hexNutWithFlange, unchamferedHexagonNut, squareNut, domedCapNut, bradTeeNut, heatSetNut, polarArrayLocations, } from './nut.js';
+// ── screw：12 类螺钉 ──────────────────────────────────────────────────────────
+export { SCREW_CLASSES, screwProfilePoints, buildScrew, } from './screw.js';
+// ── washer：3 类垫圈 ──────────────────────────────────────────────────────────
+export { plainWasher, chamferedWasher, cheeseHeadWasher, } from './washer.js';
+// ── bearing：5 类轴承 ─────────────────────────────────────────────────────────
+export { BEARING_CLASSES, buildBearing, } from './bearing.js';
+// ── sprocket：链轮 ────────────────────────────────────────────────────────────
+export { buildSprocket, sprocketPitchRadius, sprocketCircumference, } from './sprocket.js';
+// ── holes：P1-b 孔系列（函数式，不做 monkey-patch）────────────────────────────
+export { DRILL_TIP_ANGLE, fastenerHoleCutter, internalThreadSolid, clearanceHole, tapHole, threadedHole, insertHole, pressFitHole, fastenerHole, pushFastenerLocations, } from './holes.js';
+// ── chain：P1-a 滚子链（平面 2 链轮形态）──────────────────────────────────────
+export { buildChain, makeLink, placeSprocket, } from './chain.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAG5C,uEAAuE;AACvE,OAAO,EAGL,mBAAmB,EACnB,OAAO,EACP,OAAO,EACP,UAAU,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EAKd,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,sBAAsB,EACtB,gBAAgB,EAChB,YAAY,GACb,MAAM,UAAU,CAAA;AAEjB,0EAA0E;AAC1E,OAAO,EACL,IAAI,EACJ,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,YAAY,GACb,MAAM,WAAW,CAAA;AAElB,+FAA+F;AAC/F,OAAO,EAQL,UAAU,EACV,wBAAwB,EACxB,WAAW,EACX,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,4BAA4B,EAC5B,gCAAgC,EAChC,uBAAuB,EACvB,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,UAAU,CAAA;AAEjB,6EAA6E;AAC7E,OAAO,EAGL,QAAQ,EACR,MAAM,EACN,gBAAgB,EAChB,qBAAqB,EACrB,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,mBAAmB,GACpB,MAAM,OAAO,CAAA;AAEd,6EAA6E;AAC7E,OAAO,EAGL,aAAa,EACb,kBAAkB,EAClB,UAAU,GACX,MAAM,SAAS,CAAA;AAEhB,6EAA6E;AAC7E,OAAO,EAGL,WAAW,EACX,eAAe,EACf,gBAAgB,GACjB,MAAM,UAAU,CAAA;AAEjB,6EAA6E;AAC7E,OAAO,EAGL,eAAe,EACf,YAAY,GACb,MAAM,WAAW,CAAA;AAElB,8EAA8E;AAC9E,OAAO,EAGL,aAAa,EACb,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,YAAY,CAAA;AAEnB,qEAAqE;AACrE,OAAO,EACL,eAAe,EAIf,kBAAkB,EAClB,mBAAmB,EAEnB,aAAa,EAEb,OAAO,EAEP,YAAY,EAEZ,UAAU,EAEV,YAAY,EAEZ,YAAY,EACZ,qBAAqB,GACtB,MAAM,SAAS,CAAA;AAEhB,qEAAqE;AACrE,OAAO,EAIL,UAAU,EACV,QAAQ,EACR,aAAa,GACd,MAAM,SAAS,CAAA"}

package/dist/kernel.d.ts

@@ -0,0 +1,117 @@
+/**
+ * kernel.ts — 本包私有 raw 内核访问层（方案 §5.5.2 第 ①② 层）。
+ *
+ * 红线（§5.1 约束 2/3）：
+ *  - 本包不 initOcctWasm()、不持有 kernel 单例——内核由 host 经
+ *    getBackends().kernel.brep 注入；未配置即抛错、禁止兜底。
+ *  - 全包**只有本文件**调 getBackends()；其余文件一律 import { requireKernel }。
+ *    将来 core 的 KernelBase backlog（§5.5.1 / D3）修复后只需改这里 1 行。
+ *  - 不 import occt-wasm / GearKernel（那是另一个第三方库的私有接口）。
+ */
+import type { BrepEngineApi, BrepHandle, BrepVec3 } from '@faicad/faijs';
+/**
+ * Get the BREP kernel injected by the host.
+ * 与 core 自身消费点同构（`core/src/api/*.ts` 等 19 处同一模式）。
+ * @throws when the kernel is absent — never silently falls back to null or a stub
+ *         (aligned with `runtime-state.ts:364-368`).
+ * @returns host 注入的 BREP 引擎 API。
+ */
+export declare function requireKernel(): BrepEngineApi;
+/** Rotation axis (point + direction), mirroring cq `Workplane` axis semantics. */
+export interface WarehouseAxis {
+    point: BrepVec3;
+    direction: BrepVec3;
+}
+/**
+ * WarehouseKernel extends BrepEngineApi — 只声明本包真正用到的成员
+ * （方案 §5.5.2 第 ② 层：结构性匹配，不 import occt-wasm）。
+ *
+ * ⚠️ 关键认知：这一层是「我认为应该有」的**声明**，不是证明——它只换来
+ * 编辑器补全，不提供任何正确性保证。正确性由 kernel-conformance.test.ts
+ * （第 ③ 层，两级断言：存在性 + 契约 smoke）兜住；新增成员必须先加进
+ * 该测试的清单（§10 内核契约门禁）。
+ */
+export interface WarehouseKernel extends BrepEngineApi {
+    /** cq `Wire.makeHelix` 等价：**右手**圆柱螺旋线。
+     *  ⚠️ 实测（occtWasmAdapter:430）：raw wasm 仅 9 参，无 taper/lefthand——
+     *  锥螺旋上游 5 类用不到（taper 默认 360°=圆柱）；左手螺纹由调用方镜像实现。 */
+    makeHelixWire(origin: BrepVec3, axis: BrepVec3, pitch: number, height: number, radius: number): BrepHandle;
+    /** 点列 → 逼近 B 样条曲线（thread 端部 fade 的参数曲线，cq parametricCurve 等价）。 */
+    approximatePoints(points: BrepVec3[], tolerance?: number): BrepHandle;
+    /** 点列 → 插值 B 样条曲线（cq `Workplane.spline` 的内核等价：过点插值，
+     *  非逼近；PanHead 等头型轮廓用）。 */
+    interpolatePoints(points: BrepVec3[], options?: {
+        periodic?: boolean;
+        tolerance?: number;
+    }): BrepHandle;
+    /** 点列 + 端点切向 → 插值三次 B 样条（`GeomAPI_Interpolate.Load(t0, t1, scale=True)`
+     *  等价：切向量按弦长缩放，PanHead 头型样条复刻用）。 */
+    interpolatePointsWithTangents(points: BrepVec3[], startTangent: BrepVec3, endTangent: BrepVec3): BrepHandle;
+    /** 点阵 → B 样条曲面 → Face（齿廓/螺纹曲面逼近）。 */
+    bsplineSurface(points: BrepVec3[], rows: number, cols: number): BrepHandle;
+    /** `BRepBuilderAPI_Sewing`：faces → shell（thread 的 make_shell 步骤）。 */
+    sew(shapes: BrepHandle[], tolerance?: number): BrepHandle;
+    /** shell → solid（thread 的 make_solid 步骤）。 */
+    makeSolid(shell: BrepHandle): BrepHandle;
+    /** face/wire 绕轴旋转扫掠（nut/screw/bearing 的 revolve 轮廓）。 */
+    revolve(shape: BrepHandle, axis: WarehouseAxis, angleRad: number): BrepHandle;
+    /** 退化为厚度的面拉伸（fastener knurl 面；makeNSidedSurface 缺失期的路径之一）。 */
+    thicken(shape: BrepHandle, thickness: number, tolerance: number): BrepHandle;
+    /** 非平面 wire → face（HeatSetNut knurl，kernel 层原语——注意与
+     *  extensions.py 的 Workplane 级 makeNonPlanarFace 封装是两个层，§3.4）。 */
+    makeNonPlanarFace(wire: BrepHandle): BrepHandle;
+    /** 带拔模角的棱柱拉伸（LocOpe_DPrism 等价，screw 沉孔锥度切割器）。
+     *  ⚠️ 实测：截面随锥度收缩到自交（如 cross 沉孔臂宽退化）时**直接抛错**——
+     *  A 侧 LocOpe_DPrism 容忍退化并续生锥面，本内核不能；故 taper=30° 的
+     *  cross/R 沉孔是 W5 显式缺口（见 recess.ts 文件头）。 */
+    draftPrism(shape: BrepHandle, dx: number, dy: number, dz: number, angleDeg: number): BrepHandle;
+    /** 反转 shape 的朝向。实测：2×2×2 box 体积 8 → -8，即 getVolume 随之变号；
+     *  用于把 sew 得到的反向实体翻正（`primitives.orientOutward`）。 */
+    reverseShape(shape: BrepHandle): BrepHandle;
+    getSurfaceArea(shape: BrepHandle): number;
+    /** 顶点坐标（fillet2D / edge 级 rotate 定位用）。 */
+    vertexPosition(vertex: BrepHandle): BrepVec3;
+    /** 绕任意轴旋转（右手，弧度）。实测 box 绕 Z 转 π/2 精确落位；
+     *  edge/vertex 同样可旋转（hexalobular 六分之一轮廓的 polarArray 合成）。 */
+    rotate(shape: BrepHandle, axis: WarehouseAxis, angleRad: number): BrepHandle;
+    /** 关于平面镜像（point + 法向）。锥度沉孔切割器 = draftPrism 向上收锥后镜像翻转。 */
+    mirror(shape: BrepHandle, point: BrepVec3, normal: BrepVec3): BrepHandle;
+    /** 三角化（mesh 体积基准）。A 侧 `Shape.tessellate(tol, angular=0.1)` 的等价物。
+     *  ⚠️ 与 core `getVolume`（BRepGProp 精确曲面积分）并存不是冗余：后者对螺旋
+     *  B 样条面存在**求积混叠**（A 侧 Thread raw/raw 差 14%），三角化才是真值基准。
+     *  ⚠️ `tessellate` 会**原地**给 shape 建三角化，之后的 `getBoundingBox` 若按
+     *  `useTriangulation=true` 取盒会被污染（A 侧 manifest 已因此错 0.0126 mm）——
+     *  先量 bbox 再三角化。 */
+    tessellate(shape: BrepHandle, options?: TessellateOptionsLite): TessellateResultLite;
+    /** NURBS 曲线数据（探针取极点对表用，如 PanHead 样条 vs `GeomAPI_Interpolate`）。
+     *  ⚠️ 平台契约 `BrepEngineApi.getNurbsCurveData` 只声明了
+     *  `{degree, periodic, rational}`（core 的类型欠账，已记 backlog）；
+     *  occt-wasm 实际还返回 `knots / multiplicities / poles / weights`——
+     *  本包按**真实返回结构**补声明（结构性匹配，不 import occt-wasm），
+     *  探针断言依赖它。 */
+    getNurbsCurveData(edge: BrepHandle): NurbsCurveDataLite | null;
+}
+/** occt-wasm `NurbsCurveData` 中本包用到的字段（平台契约未声明，见 {@link WarehouseKernel}）。 */
+export interface NurbsCurveDataLite {
+    degree: number;
+    periodic: boolean;
+    rational: boolean;
+    knots: number[];
+    multiplicities: number[];
+    poles: number[];
+    weights: number[];
+}
+/** `tessellate` 参数（结构性声明，不 import occt-wasm）。 */
+export interface TessellateOptionsLite {
+    linearDeflection?: number;
+    angularDeflection?: number;
+    relative?: boolean;
+}
+/** `tessellate` 返回值的最小结构面。 */
+export interface TessellateResultLite {
+    positions: Float32Array;
+    indices: Uint32Array;
+    vertexCount: number;
+    triangleCount: number;
+}
+//# sourceMappingURL=kernel.d.ts.map

package/dist/kernel.d.ts.map

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

package/dist/kernel.js

@@ -0,0 +1,25 @@
+/**
+ * kernel.ts — 本包私有 raw 内核访问层（方案 §5.5.2 第 ①② 层）。
+ *
+ * 红线（§5.1 约束 2/3）：
+ *  - 本包不 initOcctWasm()、不持有 kernel 单例——内核由 host 经
+ *    getBackends().kernel.brep 注入；未配置即抛错、禁止兜底。
+ *  - 全包**只有本文件**调 getBackends()；其余文件一律 import { requireKernel }。
+ *    将来 core 的 KernelBase backlog（§5.5.1 / D3）修复后只需改这里 1 行。
+ *  - 不 import occt-wasm / GearKernel（那是另一个第三方库的私有接口）。
+ */
+import { getBackends } from '@faicad/faijs';
+/**
+ * Get the BREP kernel injected by the host.
+ * 与 core 自身消费点同构（`core/src/api/*.ts` 等 19 处同一模式）。
+ * @throws when the kernel is absent — never silently falls back to null or a stub
+ *         (aligned with `runtime-state.ts:364-368`).
+ * @returns host 注入的 BREP 引擎 API。
+ */
+export function requireKernel() {
+    const k = getBackends().kernel.brep;
+    if (!k)
+        throw new Error('[fai-cq-warehouse] BREP kernel unavailable: call configureBackends({ kernel: { brep } }) first');
+    return k;
+}
+//# sourceMappingURL=kernel.js.map

package/dist/kernel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.js","sourceRoot":"","sources":["../src/kernel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAG3C;;;;;;GAMG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,CAAC,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,IAA4B,CAAA;IAC3D,IAAI,CAAC,CAAC;QACJ,MAAM,IAAI,KAAK,CACb,gGAAgG,CACjG,CAAA;IACH,OAAO,CAAC,CAAA;AACV,CAAC"}