@faicad/fai-cq-warehouse 0.13.0

package/dist/recess.d.ts

@@ -0,0 +1,129 @@
+/**
+ * recess.ts — W5 螺钉沉孔切割器（方案 §5.4 W5 交付物）。
+ *
+ * ≈ 上游 `fastener.py:226-347` 的五种沉孔 plan + `default_head_recess`
+ * （fastener.py:1576）的 plan/depth/taper 三元组，以及 `make_head`
+ * （fastener.py:1513）里的切割器构造：
+ *
+ *     cutter = extrudeLinear(plan, (0,0,-depth), taper).translate((0,0,topZ))
+ *     head_blank = plan Extrude(topZ) − cutter
+ *     head = revolved_profile ∩ head_blank
+ *
+ * B 侧等价替换（探针 §W5-probe11/12 实证，体积解析对齐）：
+ * draftPrism 只能沿 +dz 收缩远端，与上游「从顶面向下收」的切割器方向相反——
+ * 先向上拔模拉伸（远端收缩）、再关于 XY 面镜像、平移到头顶，三步合成。
+ *
+ * ⚠️ W5 已知缺口（红线：未验证的路径必须显式抛错，禁止静默近似）：
+ * taper=30° 的截面随深度收缩，臂宽（PH: m/12，R: m/2）在深度
+ * h* = (m/12)/tan30° ≈ 0.76·m/12… 内归零，之后 A 侧 LocOpe_DPrism 靠
+ * 「截面自交后续生锥面」继续成型（实测 PH2 切割器 z 底 −2.349、含 4 锥面），
+ * 本内核 draftPrism 在自交前即抛错（探针 §W5-probe50：深 0.8 即失败）。
+ * → cross（PH*）沉孔一律抛 `E_RECESS_TAPER_UNSUPPORTED`；Robertson（R*）
+ *   上游 taper=0、不受影响，正常实现。受影响的类用 T/slot 类型过验收
+ *   （见 gen-reference.py SCREW_CASES 注释）。
+ *
+ * ## 本文件的两节（互不依赖）
+ *
+ * 1. **W5 沉孔模块**（本节以上）：`fastener.py:226-347` 的五种 plan +
+ *    `default_head_recess` + `make_head` 的切割器构造，服务 `src/screw.ts` 的 12 类。
+ * 2. **W4 临时孔径切割器**（文件末节，`Temp` 前缀）：`extensions._fastenerHole`
+ *    的最小等价路径，只服务 `src/nut.ts` 的 `bradTeeNut`；替换目标是 W9·P1-b 的
+ *    `src/holes.ts`。两节之间**禁止互相引用**。
+ */
+import type { BrepHandle } from '@faicad/faijs';
+import { type ParamRow } from './params.js';
+/** 沉孔三元组：plan wire（XY 面、z=0）+ 深度 + 锥角（度）。 */
+export interface RecessSpec {
+    planWire: BrepHandle;
+    depth: number;
+    taperDeg: number;
+}
+/** cross（PH）槽深表（按 PH 规格索引）——`fastener.py:232` 逐字。 */
+declare const CROSS_DEPTHS: Record<string, number>;
+/** Robertson（R）槽深表（按 R 规格索引）——`fastener.py:336` 逐字。 */
+declare const SQUARE_DEPTHS: Record<string, number>;
+/**
+ * cross / Type H 沉孔 plan（`fastener.py:226 cross_recess`）。
+ * 12 边十字；4 个内角（±w/12, ±w/12）用 `fillet2D(m/3)` 圆化。
+ * A 侧实证（probe31/37/41）：圆化后面积 11.262240262 逐位一致。
+ * @param size - PH0…PH4。
+ * @returns plan wire。
+ */
+export declare function crossRecessPlanWire(size: string): BrepHandle;
+/**
+ * 六角沉孔 plan（`fastener.py:257 hex_recess`）：`polygon(6, polygon_diagonal(s))`。
+ * @param widthAcrossFlats - 对边距 s。
+ * @returns plan wire。
+ */
+export declare function hexRecessPlanWire(widthAcrossFlats: number): BrepHandle;
+/**
+ * hexalobular（Torx® T）沉孔 plan（`fastener.py:265 hexalobular_recess`）。
+ * 六分之一轮廓 = 外弧(Re)→内弧(−Ri)→外弧(Re) 三段 radiusArc，再绕 Z 每 −60°
+ * 复制 6 份（clockwise，与上游 `range(0,-360,-60)` 一致）。
+ * A 侧实证（probe27/28）：T30 plan 面积 17.521497 与 A 侧一致。
+ * @param size - T6…T100。
+ * @returns plan wire。
+ */
+export declare function hexalobularRecessPlanWire(size: string): BrepHandle;
+/**
+ * 开槽沉孔 plan（`fastener.py:323 slot_recess`）：`rect(width, length)`
+ * （cq rect 以原点为中心）。length 方向必须超出头顶面——上游由
+ * `make_head` 用 3×maxR 的默认 plan 包容（slot 的 length 参数是 n，宽度 dk）。
+ * 等等——上游 slot_recess(dk, n)：**宽度 dk、长度 n**，而 n < dk；
+ * `make_head` 注释说明 slot 横贯整个头、必须伸出顶面，故矩形以原点为中心、
+ * 长边 = dk 落在 X、短边 = n 落在 Y。
+ * @param width - X 向边长（= dk，横贯头径）。
+ * @param length - Y 向边长（= 槽宽 n）。
+ * @returns plan wire。
+ */
+export declare function slotRecessPlanWire(width: number, length: number): BrepHandle;
+/**
+ * Robertson 方沉孔 plan（`fastener.py:328 square_recess`）：`rect(m, m)`。
+ * @param size - R00…R3。
+ * @returns plan wire。
+ */
+export declare function squareRecessPlanWire(size: string): BrepHandle;
+/**
+ * `fastener.py:1576 default_head_recess`：按 screw_data 列名依序探测
+ * slot(dk,n,t) → hex(s,t) → recess 列（PH/T/R），返回三元组。
+ * 与上游一致：多个 try 块**后面的命中会覆盖前面的**（fastener.py 逐 try 赋值）。
+ * @param row - 该规格的参数行（已 isolate 到具体 fastener_type）。
+ * @returns 沉孔三元组。
+ * @throws PH（cross，taper=30°）→ `E_RECESS_TAPER_UNSUPPORTED`（W5 已知缺口）；
+ *         无任何沉孔列 → 上游同文报错。
+ */
+export declare function defaultHeadRecess(row: ParamRow): RecessSpec;
+/**
+ * 沉孔切割器（`make_head` fastener.py:1548-1552 的 B 侧等价）：
+ * draftPrism 向上（远端收缩）→ 关于 XY 镜像 → 平移到头顶 z=topZ。
+ * 结果占 z ∈ [topZ−depth, topZ]，开口（全尺寸截面）朝上。
+ * @param spec - 沉孔三元组。
+ * @param topZ - 头顶面高度（max_head_height）。
+ * @returns 切割器实体。
+ */
+export declare function recessCutter(spec: RecessSpec, topZ: number): BrepHandle;
+/** SQUARE_DEPTHS 仅 square_recess 用；导出供测试对表。 */
+export { SQUARE_DEPTHS, CROSS_DEPTHS };
+/** 钻尖角（度）—— 上游 `_fastenerHole` 的 `cskAngle = 82`（extensions.py:975）。 */
+export { DRILL_TIP_ANGLE } from './holes.js';
+/** 沉头轮廓（XZ 平面 `{r,z}` 点列，闭合，`r` 为到轴距离）。 */
+export interface TempProfilePoint {
+    r: number;
+    z: number;
+}
+/**
+ * `CounterSunkScrew.countersink_profile`（fastener.py:1786-1798）的临时等价实现 —— 90° 截锥。
+ *
+ * 上游逐字转写：`vLineTo(k)` → `hLineTo(dk/2)` → `polarLine(k/cos(a/2), -90-a/2)` → `close()`。
+ *
+ * ⚠️ 注意上游此方法**不读 `fit`**（与 `Screw.default_countersink_profile` 不同）：
+ * 轮廓只由 `a`（头角）/`dk`（头径）/`k`（头高）决定。参数里的 `fit` 仅为签名对齐。
+ *
+ * ⚠️ 与 `src/screw.ts` 的 `CounterSunkScrew` 沉孔轮廓**同式**：该重复是 W4 明示的
+ * 临时债（见本文件头与 W5 分析文档），随 `_fastenerHole` 整体迁入 `src/holes.ts` 时一并消除。
+ * @param screwData - `countersunk_head_parameters.csv` 中该规格行的求值结果（含 a/dk/k）。
+ * @param _fit - 配合等级（上游此路径未使用）。
+ * @returns 截锥轮廓点列：`(0,0) → (0,k) → (dk/2,k) → (dk/2−k·tan(a/2), 0)`。
+ */
+export declare function tempCounterSunkCountersinkProfile(screwData: Record<string, number | string>, _fit?: 'Close' | 'Normal' | 'Loose'): TempProfilePoint[];
+//# sourceMappingURL=recess.d.ts.map

package/dist/recess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recess.d.ts","sourceRoot":"","sources":["../src/recess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,eAAe,CAAA;AAazD,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AASrD,6CAA6C;AAC7C,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,UAAU,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB;AAID,qDAAqD;AACrD,QAAA,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAA2D,CAAA;AAGpG,uDAAuD;AACvD,QAAA,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAyD,CAAA;AASnG;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAkD5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,GAAG,UAAU,CAStE;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAyClE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAS5E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAI7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,GAAG,UAAU,CA+C3D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAKvE;AAED,+CAA+C;AAC/C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,CAAA;AAQtC,wEAAwE;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAEzC,2CAA2C;AAC3C,MAAM,WAAW,gBAAgB;IAC/B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAC1C,IAAI,GAAE,OAAO,GAAG,QAAQ,GAAG,OAAkB,GAC5C,gBAAgB,EAAE,CAmBpB"}

package/dist/recess.js

@@ -0,0 +1,323 @@
+/**
+ * recess.ts — W5 螺钉沉孔切割器（方案 §5.4 W5 交付物）。
+ *
+ * ≈ 上游 `fastener.py:226-347` 的五种沉孔 plan + `default_head_recess`
+ * （fastener.py:1576）的 plan/depth/taper 三元组，以及 `make_head`
+ * （fastener.py:1513）里的切割器构造：
+ *
+ *     cutter = extrudeLinear(plan, (0,0,-depth), taper).translate((0,0,topZ))
+ *     head_blank = plan Extrude(topZ) − cutter
+ *     head = revolved_profile ∩ head_blank
+ *
+ * B 侧等价替换（探针 §W5-probe11/12 实证，体积解析对齐）：
+ * draftPrism 只能沿 +dz 收缩远端，与上游「从顶面向下收」的切割器方向相反——
+ * 先向上拔模拉伸（远端收缩）、再关于 XY 面镜像、平移到头顶，三步合成。
+ *
+ * ⚠️ W5 已知缺口（红线：未验证的路径必须显式抛错，禁止静默近似）：
+ * taper=30° 的截面随深度收缩，臂宽（PH: m/12，R: m/2）在深度
+ * h* = (m/12)/tan30° ≈ 0.76·m/12… 内归零，之后 A 侧 LocOpe_DPrism 靠
+ * 「截面自交后续生锥面」继续成型（实测 PH2 切割器 z 底 −2.349、含 4 锥面），
+ * 本内核 draftPrism 在自交前即抛错（探针 §W5-probe50：深 0.8 即失败）。
+ * → cross（PH*）沉孔一律抛 `E_RECESS_TAPER_UNSUPPORTED`；Robertson（R*）
+ *   上游 taper=0、不受影响，正常实现。受影响的类用 T/slot 类型过验收
+ *   （见 gen-reference.py SCREW_CASES 注释）。
+ *
+ * ## 本文件的两节（互不依赖）
+ *
+ * 1. **W5 沉孔模块**（本节以上）：`fastener.py:226-347` 的五种 plan +
+ *    `default_head_recess` + `make_head` 的切割器构造，服务 `src/screw.ts` 的 12 类。
+ * 2. **W4 临时孔径切割器**（文件末节，`Temp` 前缀）：`extensions._fastenerHole`
+ *    的最小等价路径，只服务 `src/nut.ts` 的 `bradTeeNut`；替换目标是 W9·P1-b 的
+ *    `src/holes.ts`。两节之间**禁止互相引用**。
+ */
+import { requireKernel } from './kernel.js';
+import { arcEdge, draftPrismFace, filletCorner2D, lineEdge, mirrorAbout, polygonWire, radiusArcMidpoint, rotateAbout, wireFromEdges, } from './primitives.js';
+import { iso10664Def } from './params.js';
+/** 本包内部统一经 WarehouseKernel 取用。 */
+function k() {
+    return requireKernel();
+}
+const Z_AXIS = { point: { x: 0, y: 0, z: 0 }, direction: { x: 0, y: 0, z: 1 } };
+/** cross（PH）/ Robertson（R）尺寸表——`fastener.py:232/336` 逐字。 */
+const CROSS_WIDTHS = { PH0: 1.9, PH1: 3.1, PH2: 5.3, PH3: 6.8, PH4: 10.0 };
+/** cross（PH）槽深表（按 PH 规格索引）——`fastener.py:232` 逐字。 */
+const CROSS_DEPTHS = { PH0: 1.1, PH1: 2.0, PH2: 3.27, PH3: 3.53, PH4: 5.88 };
+/** Robertson（R）槽宽表（按 R 规格索引）——`fastener.py:336` 逐字。 */
+const SQUARE_WIDTHS = { R00: 1.8, R0: 2.31, R1: 2.86, R2: 3.38, R3: 4.85 };
+/** Robertson（R）槽深表（按 R 规格索引）——`fastener.py:336` 逐字。 */
+const SQUARE_DEPTHS = { R00: 1.85, R0: 2.87, R1: 3.56, R2: 4.19, R3: 5.11 };
+/**
+ * 2D 点 → 世界坐标（XY 平面，z=0）。
+ */
+function v(p) {
+    return { x: p.x, y: p.y, z: 0 };
+}
+/**
+ * cross / Type H 沉孔 plan（`fastener.py:226 cross_recess`）。
+ * 12 边十字；4 个内角（±w/12, ±w/12）用 `fillet2D(m/3)` 圆化。
+ * A 侧实证（probe31/37/41）：圆化后面积 11.262240262 逐位一致。
+ * @param size - PH0…PH4。
+ * @returns plan wire。
+ */
+export function crossRecessPlanWire(size) {
+    const m = CROSS_WIDTHS[size];
+    if (m === undefined)
+        throw new Error(`cross_recess: invalid cross size ${size}`);
+    const w = m / 12;
+    const r = m / 3;
+    // 上游象限：moveTo(m/2,0)→vLineTo(m/12)→hLineTo(m/12)→vLineTo(m/2)→hLineTo(0)
+    // 经 mirrorX/mirrorY 展开后，臂尖上的镜像缝点（(±m/2,0)/(0,±m/2)）是共线冗余
+    // 顶点——几何等价的 12 角环（probe41 面积 11.262240262 与 A 侧逐位一致）。
+    const orig = [
+        { x: m / 2, y: w },
+        { x: w, y: w },
+        { x: w, y: m / 2 },
+        { x: -w, y: m / 2 },
+        { x: -w, y: w },
+        { x: -m / 2, y: w },
+        { x: -m / 2, y: -w },
+        { x: -w, y: -w },
+        { x: -w, y: -m / 2 },
+        { x: w, y: -m / 2 },
+        { x: w, y: -w },
+        { x: m / 2, y: -w },
+    ];
+    // (±w,±w) 四个内角：索引 1、4、7、10。
+    const filletIdx = new Set([1, 4, 7, 10]);
+    const p1of = new Map();
+    const p2of = new Map();
+    const midof = new Map();
+    for (const i of filletIdx) {
+        const cur = orig[i];
+        const prev = orig[(i + 11) % 12];
+        const next = orig[(i + 1) % 12];
+        const f = filletCorner2D(prev, cur, next, r);
+        p1of.set(i, f.p1);
+        p2of.set(i, f.p2);
+        midof.set(i, f.mid);
+    }
+    const edges = [];
+    for (let i = 0; i < 12; i++) {
+        const cur = orig[i];
+        const next = orig[(i + 1) % 12];
+        if (filletIdx.has(i)) {
+            // 圆角顶点：P1→(arc)→P2，再接 P2→next 连线（探针 probe38 16 边闭合形态）。
+            edges.push(arcEdge(v(p1of.get(i)), v(midof.get(i)), v(p2of.get(i))));
+            edges.push(lineEdge(v(p2of.get(i)), v(next)));
+        }
+        else {
+            const target = filletIdx.has((i + 1) % 12) ? p1of.get((i + 1) % 12) : next;
+            edges.push(lineEdge(v(cur), v(target)));
+        }
+    }
+    return wireFromEdges(edges);
+}
+/**
+ * 六角沉孔 plan（`fastener.py:257 hex_recess`）：`polygon(6, polygon_diagonal(s))`。
+ * @param widthAcrossFlats - 对边距 s。
+ * @returns plan wire。
+ */
+export function hexRecessPlanWire(widthAcrossFlats) {
+    // polygon_diagonal(s, 6) = s/cos(π/6)（nut.ts polygonDiagonal 同式）。
+    const e = widthAcrossFlats / Math.cos(Math.PI / 6);
+    const pts = [];
+    for (let i = 0; i < 6; i++) {
+        const a = (Math.PI / 3) * i;
+        pts.push({ x: (e / 2) * Math.cos(a), y: (e / 2) * Math.sin(a), z: 0 });
+    }
+    return polygonWire(pts);
+}
+/**
+ * hexalobular（Torx® T）沉孔 plan（`fastener.py:265 hexalobular_recess`）。
+ * 六分之一轮廓 = 外弧(Re)→内弧(−Ri)→外弧(Re) 三段 radiusArc，再绕 Z 每 −60°
+ * 复制 6 份（clockwise，与上游 `range(0,-360,-60)` 一致）。
+ * A 侧实证（probe27/28）：T30 plan 面积 17.521497 与 A 侧一致。
+ * @param size - T6…T100。
+ * @returns plan wire。
+ */
+export function hexalobularRecessPlanWire(size) {
+    const row = iso10664Def[size];
+    if (!row)
+        throw new Error(`hexalobular_recess: invalid hexalobular size ${size}`);
+    const A = Number(row['A']);
+    const B = Number(row['B']);
+    const Re = Number(row['Re']);
+    const sqrt3 = Math.sqrt(3);
+    // Ri = (A²−√3·A·B−4·A·Re+B²+2√3·B·Re) / (2(√3·A−2·B−2√3·Re+4·Re))
+    const Ri = (A * A - sqrt3 * A * B - 4 * A * Re + B * B + 2 * sqrt3 * B * Re) /
+        (2 * (sqrt3 * A - 2 * B - 2 * sqrt3 * Re + 4 * Re));
+    const centerExternal0 = { x: 0, y: A / 2 - Re };
+    const centerExternal1 = { x: (sqrt3 * (A / 2 - Re)) / 2, y: A / 4 - Re / 2 };
+    const centerInternal = { x: B / 4 + Ri / 2, y: (sqrt3 * (B / 2 + Ri)) / 2 };
+    // 切点 = 外弧圆心 + 单位向量(内弧圆心−外弧圆心) × Re
+    const tangentPoints = [centerExternal0, centerExternal1].map((c) => {
+        const dx = centerInternal.x - c.x;
+        const dy = centerInternal.y - c.y;
+        const l = Math.hypot(dx, dy);
+        return { x: c.x + (dx / l) * Re, y: c.y + (dy / l) * Re };
+    });
+    // 六分之一：moveTo(0, A/2) → radiusArc(tp0, Re) → radiusArc(tp1, −Ri)
+    //           → radiusArc((√3A/4, A/4), Re)
+    const start = { x: 0, y: A / 2 };
+    const end = { x: (sqrt3 * A) / 4, y: A / 4 };
+    const m1 = radiusArcMidpoint(start, tangentPoints[0], Re);
+    const m2 = radiusArcMidpoint(tangentPoints[0], tangentPoints[1], -Ri);
+    const m3 = radiusArcMidpoint(tangentPoints[1], end, Re);
+    const oneSixth = [
+        arcEdge(v(start), v(m1), v(tangentPoints[0])),
+        arcEdge(v(tangentPoints[0]), v(m2), v(tangentPoints[1])),
+        arcEdge(v(tangentPoints[1]), v(m3), v(end)),
+    ];
+    const edges = [];
+    for (let a = 0; a > -360; a -= 60) {
+        const rad = (a * Math.PI) / 180;
+        for (const e of oneSixth)
+            edges.push(rotateAbout(e, Z_AXIS, rad));
+    }
+    return wireFromEdges(edges);
+}
+/**
+ * 开槽沉孔 plan（`fastener.py:323 slot_recess`）：`rect(width, length)`
+ * （cq rect 以原点为中心）。length 方向必须超出头顶面——上游由
+ * `make_head` 用 3×maxR 的默认 plan 包容（slot 的 length 参数是 n，宽度 dk）。
+ * 等等——上游 slot_recess(dk, n)：**宽度 dk、长度 n**，而 n < dk；
+ * `make_head` 注释说明 slot 横贯整个头、必须伸出顶面，故矩形以原点为中心、
+ * 长边 = dk 落在 X、短边 = n 落在 Y。
+ * @param width - X 向边长（= dk，横贯头径）。
+ * @param length - Y 向边长（= 槽宽 n）。
+ * @returns plan wire。
+ */
+export function slotRecessPlanWire(width, length) {
+    const hw = width / 2;
+    const hl = length / 2;
+    return wireFromEdges([
+        lineEdge(v({ x: -hw, y: -hl }), v({ x: hw, y: -hl })),
+        lineEdge(v({ x: hw, y: -hl }), v({ x: hw, y: hl })),
+        lineEdge(v({ x: hw, y: hl }), v({ x: -hw, y: hl })),
+        lineEdge(v({ x: -hw, y: hl }), v({ x: -hw, y: -hl })),
+    ]);
+}
+/**
+ * Robertson 方沉孔 plan（`fastener.py:328 square_recess`）：`rect(m, m)`。
+ * @param size - R00…R3。
+ * @returns plan wire。
+ */
+export function squareRecessPlanWire(size) {
+    const m = SQUARE_WIDTHS[size];
+    if (m === undefined)
+        throw new Error(`square_recess: invalid square size ${size}`);
+    return slotRecessPlanWire(m, m);
+}
+/**
+ * `fastener.py:1576 default_head_recess`：按 screw_data 列名依序探测
+ * slot(dk,n,t) → hex(s,t) → recess 列（PH/T/R），返回三元组。
+ * 与上游一致：多个 try 块**后面的命中会覆盖前面的**（fastener.py 逐 try 赋值）。
+ * @param row - 该规格的参数行（已 isolate 到具体 fastener_type）。
+ * @returns 沉孔三元组。
+ * @throws PH（cross，taper=30°）→ `E_RECESS_TAPER_UNSUPPORTED`（W5 已知缺口）；
+ *         无任何沉孔列 → 上游同文报错。
+ */
+export function defaultHeadRecess(row) {
+    let spec = null;
+    // Slot Recess：dk, n, t → slot_recess(dk, n)，taper=0
+    if (row['dk'] !== undefined && row['n'] !== undefined && row['t'] !== undefined) {
+        spec = {
+            planWire: slotRecessPlanWire(Number(row['dk']), Number(row['n'])),
+            depth: Number(row['t']),
+            taperDeg: 0,
+        };
+    }
+    // Hex Recess：s, t → hex_recess(s)，taper=0
+    if (row['s'] !== undefined && row['t'] !== undefined) {
+        spec = {
+            planWire: hexRecessPlanWire(Number(row['s'])),
+            depth: Number(row['t']),
+            taperDeg: 0,
+        };
+    }
+    // Philips / Torx / Robertson：recess 列
+    const recess = row['recess'];
+    if (recess !== undefined && recess !== '') {
+        const r = String(recess).toUpperCase();
+        if (r.startsWith('PH')) {
+            // W5 已知缺口：cross 沉孔 30° 锥度在臂宽退化后 A 侧靠 DPrism 续锥面，
+            // 本内核 draftPrism 自交即抛错（见文件头）。
+            throw new Error(`E_RECESS_TAPER_UNSUPPORTED: cross recess ${r} needs a 30° taper cutter whose ` +
+                `section self-intersects (LocOpe_DPrism tolerates, our draftPrism does not) — ` +
+                `choose a T/slot/hex fastener_type instead`);
+        }
+        if (r.startsWith('T')) {
+            spec = {
+                planWire: hexalobularRecessPlanWire(r),
+                depth: 0.6 * Number(iso10664Def[r]['A']),
+                taperDeg: 0,
+            };
+        }
+        else if (r.startsWith('R')) {
+            spec = {
+                planWire: squareRecessPlanWire(r),
+                depth: SQUARE_DEPTHS[r],
+                taperDeg: 0,
+            };
+        }
+    }
+    if (!spec)
+        throw new Error(`Recess data missing from screw_data ${JSON.stringify(row)}`);
+    return spec;
+}
+/**
+ * 沉孔切割器（`make_head` fastener.py:1548-1552 的 B 侧等价）：
+ * draftPrism 向上（远端收缩）→ 关于 XY 镜像 → 平移到头顶 z=topZ。
+ * 结果占 z ∈ [topZ−depth, topZ]，开口（全尺寸截面）朝上。
+ * @param spec - 沉孔三元组。
+ * @param topZ - 头顶面高度（max_head_height）。
+ * @returns 切割器实体。
+ */
+export function recessCutter(spec, topZ) {
+    const face = k().makeFace(spec.planWire);
+    const up = spec.taperDeg === 0 ? k().extrude(face, 0, 0, spec.depth) : draftPrismFace(face, spec.depth, spec.taperDeg);
+    const flipped = mirrorAbout(up, { x: 0, y: 0, z: 0 }, { x: 0, y: 0, z: 1 });
+    return k().translate(flipped, 0, 0, topZ);
+}
+/** SQUARE_DEPTHS 仅 square_recess 用；导出供测试对表。 */
+export { SQUARE_DEPTHS, CROSS_DEPTHS };
+// ── W4：`extensions._fastenerHole` 的最小等价路径（BradTeeNut 用）────────────
+//
+// W9·P1-b 已落地：孔切割器迁入 `src/holes.ts`（`fastenerHoleCutter`），本文件
+// 仅保留 `tempCounterSunkCountersinkProfile`（沉头轮廓，BradTeeNut 仍在用）。
+// 原 `TempClearanceHoleCutterParams` / `tempClearanceHoleCutter` 已随迁移删除。
+/** 钻尖角（度）—— 上游 `_fastenerHole` 的 `cskAngle = 82`（extensions.py:975）。 */
+export { DRILL_TIP_ANGLE } from './holes.js';
+/**
+ * `CounterSunkScrew.countersink_profile`（fastener.py:1786-1798）的临时等价实现 —— 90° 截锥。
+ *
+ * 上游逐字转写：`vLineTo(k)` → `hLineTo(dk/2)` → `polarLine(k/cos(a/2), -90-a/2)` → `close()`。
+ *
+ * ⚠️ 注意上游此方法**不读 `fit`**（与 `Screw.default_countersink_profile` 不同）：
+ * 轮廓只由 `a`（头角）/`dk`（头径）/`k`（头高）决定。参数里的 `fit` 仅为签名对齐。
+ *
+ * ⚠️ 与 `src/screw.ts` 的 `CounterSunkScrew` 沉孔轮廓**同式**：该重复是 W4 明示的
+ * 临时债（见本文件头与 W5 分析文档），随 `_fastenerHole` 整体迁入 `src/holes.ts` 时一并消除。
+ * @param screwData - `countersunk_head_parameters.csv` 中该规格行的求值结果（含 a/dk/k）。
+ * @param _fit - 配合等级（上游此路径未使用）。
+ * @returns 截锥轮廓点列：`(0,0) → (0,k) → (dk/2,k) → (dk/2−k·tan(a/2), 0)`。
+ */
+export function tempCounterSunkCountersinkProfile(screwData, _fit = 'Normal') {
+    const a = screwData['a'];
+    const dk = screwData['dk'];
+    const k = screwData['k'];
+    if (typeof a !== 'number' || typeof dk !== 'number' || typeof k !== 'number')
+        throw new Error(`recess(Temp): countersunk screw data must be numeric (a/dk/k), got ${JSON.stringify({ a, dk, k })}`);
+    const half = ((a * Math.PI) / 180) / 2;
+    const sideLength = k / Math.cos(half);
+    const dir = ((-90 - a / 2) * Math.PI) / 180;
+    const endR = dk / 2 + sideLength * Math.cos(dir);
+    const endZ = k + sideLength * Math.sin(dir);
+    return [
+        { r: 0, z: 0 },
+        { r: 0, z: k },
+        { r: dk / 2, z: k },
+        { r: endR, z: endZ },
+    ];
+}
+//# sourceMappingURL=recess.js.map

package/dist/recess.js.map

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

package/dist/screw.d.ts

@@ -0,0 +1,101 @@
+/**
+ * screw.ts — 螺钉 12 类（W5）—— 上游 `cq_warehouse.fastener.Screw` 基类 + 12 个子类的逐位复刻。
+ *
+ * 装配流（`fastener.py:1513 make_head` + `:176 __init__`）：
+ * ```
+ *   head = revolve(head_profile) ∩ extrude(head_plan)      # 有 recess 时先 cut 再交
+ *          ∪ revolve(flange_profile)                       # HexHeadWithFlange 才有
+ *   cq_object = head.translate((0,0,-length_offset)) ∪ shank.translate((0,0,-length))
+ *   shank = circle(min_radius).extrude(thread_length)（simple）或 shank.fuse(thread)
+ * ```
+ * `SetScrew` 走 `custom_make`：无头、全杆长、`cylinder − 六角沉孔`。
+ *
+ * 几何坐标：轮廓画在 XZ 平面（局部 x → 世界 X＝半径、局部 y → 世界 +Z），
+ * `revolveProfile` 绕 Z 轴 360°。杆部 z ∈ [−length, −length_offset]，
+ * 头部 z ∈ [−length_offset, −length_offset + head_height)。
+ *
+ * 逐位复刻的三个关键事实（A 侧实测见 `scripts/probe-screw-head-profiles.py`，
+ * 回归锁在 `src/screw.test.ts`；分析见
+ * `docs/analysis/2026-09-14-cq-warehouse-screw-probe.md`）：
+ *
+ * 1. **`vertices(">X")` / `edges(">Z").vertices(">X")` 用的是 `Edge.Center()`**，
+ *    而圆弧的 `Edge.Center()` 是**圆弧质心而非圆心**——见 {@link edgeCenter}。
+ * 2. **`CheeseHeadScrew` 的 `k / cos(degrees(5))` 单位怪癖**：`math.degrees(5)`
+ *    的结果（286.4789）被当**弧度**喂给 `cos`，故长度为负；与 `5-90 = -85°`
+ *    方向叠加后实测等效于「沿 5° 内倾母线向上」。直接照抄公式即得正确几何。
+ * 3. **`fillet2D` 的圆弧邻边必须走圆心连线的精确解**：`t = r/tan(θ/2)` 只对
+ *    「两直线角」精确，用在「圆弧-直线」角上会把切点放到**弧外**
+ *    （RCOS 实测 `|p1 − 圆心| = 12.00099 ≠ rf = 12`，误差 2.0e-3）——见
+ *    {@link filletAt}。
+ */
+import type { BrepHandle } from '@faicad/faijs';
+import { type ParamRow, type ScrewClassName } from './params.js';
+import { type Hand } from './thread.js';
+/** XZ 平面轮廓点：局部 (x, y)，revolve 后局部 x→世界半径、局部 y→世界 +Z。 */
+interface Pt {
+    x: number;
+    y: number;
+}
+/** 12 类共享的构造参数（上游 `Screw.__init__` 签名，fastener.py:176）。 */
+export interface ScrewParams {
+    /** 尺寸串，如 `M6-1`（公制）或 `1/4-20`（英制）。 */
+    size: string;
+    /** 头下到螺纹端的总长（mm；`length_offset` 会把头高计入）。 */
+    length: number;
+    /** 类型标识，如 `iso4762`。 */
+    fastener_type: string;
+    /** 螺纹旋向，默认 `right`。 */
+    hand?: Hand;
+    /** 上游语义：True = 杆部光轴不建螺纹几何。 */
+    simple?: boolean;
+    /** 六角头类的扳手空间（默认 6，跨直径）。 */
+    socket_clearance?: number;
+}
+/** `Screw.__init__` 的派生量集合（上游同名属性/方法）。 */
+export interface ScrewResult {
+    /** 螺钉实体；`custom_make` 未产出几何时为 null。 */
+    handle: BrepHandle | null;
+    screwClass: ScrewClassName;
+    size: string;
+    threadSize: string;
+    isMetric: boolean;
+    threadDiameter: number;
+    threadPitch: number;
+    length: number;
+    fastenerType: string;
+    hand: Hand;
+    simple: boolean;
+    screwData: ParamRow;
+    headHeight: number;
+    headDiameter: number;
+    maxThreadLength: number;
+    threadLength: number;
+    socketClearance: number;
+    /** `countersink_profile` 的顶点最大 z（上游 `min_hole_depth` 的 `head_offset`）。 */
+    headOffset: number | null;
+    /** `min_hole_depth(counter_sunk=True)`：`length + head_offset − length_offset`。 */
+    minHoleDepth: number | null;
+    /** `min_hole_depth(counter_sunk=False)`：`length − length_offset`。 */
+    minHoleDepthStraight: number;
+    info: string;
+}
+/** 全部螺钉类名（= `SCREW_TABLES` 的键，按声明序；测试与比对脚本共用）。 */
+export declare const SCREW_CLASSES: readonly ScrewClassName[];
+/**
+ * 头型轮廓的**顶点序列**（首段起点 + 各段终点，含 `fillet2D` 切点）——对应 A 侧
+ * `head_profile` 的边端点。逐位对照的回归锁通道（见 `src/screw.test.ts`），
+ * 也是 W9·P1-b 复用沉孔轮廓的入口。
+ * @param className - 12 类之一。
+ * @param p - 入参（只需 `size` / `fastener_type` 等，`length` 不参与轮廓）。
+ * @returns XZ 顶点列（局部 x→半径、y→轴向）；`SetScrew` 无头型时返回 `[]`。
+ */
+export declare function screwProfilePoints(className: ScrewClassName, p: ScrewParams): Pt[];
+/**
+ * `Screw.__init__`（`fastener.py:176`）的 B 侧复刻：解析 + 装配 + 派生量。
+ * @param className - 12 类之一（决定参数表与钩子集）。
+ * @param p - 入参。
+ * @returns 螺钉实体与上游同名派生量。
+ */
+export declare function buildScrew(className: ScrewClassName, p: ScrewParams): ScrewResult;
+export {};
+//# sourceMappingURL=screw.d.ts.map

package/dist/screw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screw.d.ts","sourceRoot":"","sources":["../src/screw.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,eAAe,CAAA;AAkBzD,OAAO,EAKL,KAAK,QAAQ,EACb,KAAK,cAAc,EACpB,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAkC,KAAK,IAAI,EAAE,MAAM,UAAU,CAAA;AAGpE,wDAAwD;AACxD,UAAU,EAAE;IACV,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAwcD,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,uBAAuB;IACvB,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,8BAA8B;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,2BAA2B;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;IACzB,UAAU,EAAE,cAAc,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,QAAQ,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,kFAAkF;IAClF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,qEAAqE;IACrE,oBAAoB,EAAE,MAAM,CAAA;IAC5B,IAAI,EAAE,MAAM,CAAA;CACb;AAoCD,kDAAkD;AAClD,eAAO,MAAM,aAAa,EAAE,SAAS,cAAc,EAE9B,CAAA;AA8YrB;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC,EAAE,WAAW,GAAG,EAAE,EAAE,CAKlF;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC,EAAE,WAAW,GAAG,WAAW,CAmGjF"}