@faicad/sheetmetal 0.13.0

package/dist/compat.d.ts

@@ -0,0 +1,90 @@
+/**
+ * compat — brepjs 同名兼容 shim（D12，批次一的桥接面）
+ *
+ * 设计：docs/plans/2026-09-01-layered-api-architecture.md §D12 / §7.3 / §7.5
+ *
+ * 移植的钣金源文件只改 import 来源行（`from 'brepjs'` → `from './compat.js'`），
+ * Result 消费点零改动。本文件是包内**唯一**桥接点（§9 验收白名单：src 中
+ * `kernel/`、`getBackends`、`getSlot` 零命中，compat.ts 除外）——
+ * 批次一（纯 2D/数据层）需要的符号以 vendored L1/L2 的同名形态提供：
+ *
+ * - Result 机制与类型：vendored `core/result.js` / `core/errors.js` /
+ *   `core/shapeTypes.js` / `core/validityTypes.js` / `core/types.js`；
+ * - 2D/查询 op：直包 vendored L2（`primitiveFns.line/wire/wireLoop`、
+ *   `topologyQueryFns.getEdges`、`curveFns.curveStartPoint/curveEndPoint`）——
+ *   产出的都是 brepjs 原样句柄形态（同一 occt-wasm 实例，D10），与 3D 批次
+ *   经 L3 `cad.*` 的路径不同：批次一不碰 3D 实体，无需 faijs Shape 包装。
+ *
+ * vec* 纯函数按 §7.5 ⑤ 不映射到 cad 命名空间；批次一各文件未消费 vec*，
+ * 待 3D 批次需要时从 vendored `utils/vec3.js` 在此 re-export。
+ */
+import { ok, err, isOk, isErr, type Result } from '@faicad/faijs-core/vendored/brepjs/core/result.js';
+import { validationError, type BrepError } from '@faicad/faijs-core/vendored/brepjs/core/errors.js';
+import type { Solid, Wire, Edge, Face, AnyShape } from '@faicad/faijs-core/vendored/brepjs/core/shapeTypes.js';
+import { isSolid } from '@faicad/faijs-core/vendored/brepjs/core/shapeTypes.js';
+import type { ClosedWire, ValidSolid } from '@faicad/faijs-core/vendored/brepjs/core/validityTypes.js';
+import { isPlanarWire } from '@faicad/faijs-core/vendored/brepjs/core/validityTypes.js';
+import type { Vec3 } from '@faicad/faijs-core/vendored/brepjs/core/types.js';
+import type { Bounds3D } from '@faicad/faijs-core/vendored/brepjs/topology/topologyQueryFns.js';
+import { getSolids, getFaces, getBounds } from '@faicad/faijs-core/vendored/brepjs/topology/topologyQueryFns.js';
+import { line as brepjsLine, wire as brepjsWire, wireLoop as brepjsWireLoop, box as brepjsBox, cylinder as brepjsCylinder, sphere as brepjsSphere, face as brepjsFace, polygon as brepjsPolygon } from '@faicad/faijs-core/vendored/brepjs/topology/primitiveFns.js';
+import { unwrap as brepjsUnwrap } from '@faicad/faijs-core/vendored/brepjs/core/result.js';
+import { translate as brepjsTranslate } from '@faicad/faijs-core/vendored/brepjs/topology/transformFns.js';
+import { extrude as brepjsExtrude } from '@faicad/faijs-core/vendored/brepjs/operations/extrudeFns.js';
+import { getEdges as brepjsGetEdges } from '@faicad/faijs-core/vendored/brepjs/topology/topologyQueryFns.js';
+import { curveStartPoint as brepjsCurveStartPoint, curveEndPoint as brepjsCurveEndPoint } from '@faicad/faijs-core/vendored/brepjs/topology/curveFns.js';
+import { isValid } from '@faicad/faijs-core/vendored/brepjs/topology/healingFns.js';
+import { measureVolume, measureArea } from '@faicad/faijs-core/vendored/brepjs/measurement/measureFns.js';
+import { getSurfaceType, pointOnSurface, normalAt, faceCenter } from '@faicad/faijs-core/vendored/brepjs/topology/faceFns.js';
+import { sharedEdges } from '@faicad/faijs-core/vendored/brepjs/topology/adjacencyFns.js';
+import { outerWire as brepjsOuterWire } from '@faicad/faijs-core/vendored/brepjs/topology/faceFns.js';
+import { vecAdd, vecSub, vecScale, vecDot, vecCross, vecNormalize, vecLength } from '@faicad/faijs-core/vendored/brepjs/core/vecOps.js';
+export { ok, err, isOk, isErr, validationError, brepjsUnwrap as unwrap };
+export type { Result, BrepError };
+export type { Solid, Wire, Edge, Face, AnyShape, ClosedWire, ValidSolid, Vec3, Bounds3D };
+export { brepjsLine as line, brepjsWire as wire, brepjsWireLoop as wireLoop };
+export { brepjsGetEdges as getEdges, getSolids, getFaces, getBounds };
+export { isSolid, isPlanarWire, isValid };
+export { brepjsCurveStartPoint as curveStartPoint, brepjsCurveEndPoint as curveEndPoint };
+export { brepjsBox as box, brepjsCylinder as cylinder, brepjsSphere as sphere, brepjsFace as face };
+export { brepjsPolygon as polygon, brepjsOuterWire as outerWire };
+export { brepjsExtrude as extrude };
+export { brepjsTranslate as translate };
+/**
+ * Rotate a shape by an angle in degrees around an axis.
+ * @param shape - The shape to rotate.
+ * @param angle - Rotation angle in degrees.
+ * @param options - Axis and pivot (`at`) for the rotation; defaults to the Z
+ * axis through the origin, matching upstream brepjs.
+ * @returns A new rotated shape.
+ */
+export declare function rotate<T extends AnyShape>(shape: T, angle: number, options?: {
+    at?: Vec3;
+    axis?: Vec3;
+}): T;
+/**
+ * Fuse two solids (union). Accepts plain `Solid` operands like upstream
+ * brepjs; the vendored `ValidSolid` brand is applied internally.
+ * @param a - First solid operand.
+ * @param b - Second solid operand.
+ * @returns `Ok` with the fused solid, or `Err` when the result is not 3D.
+ */
+export declare function fuse(a: Solid, b: Solid): Result<ValidSolid>;
+/**
+ * Cut solid `b` out of solid `a` (difference).
+ * @param a - Solid to subtract from.
+ * @param b - Solid to subtract.
+ * @returns `Ok` with the result, or `Err` when the result is not 3D.
+ */
+export declare function cut(a: Solid, b: Solid): Result<ValidSolid>;
+/**
+ * Intersect two solids (common volume).
+ * @param a - First solid operand.
+ * @param b - Second solid operand.
+ * @returns `Ok` with the intersection, or `Err` when the result is not 3D.
+ */
+export declare function intersect(a: Solid, b: Solid): Result<ValidSolid>;
+export { measureVolume, measureArea };
+export { getSurfaceType, pointOnSurface, normalAt, faceCenter, sharedEdges };
+export { vecAdd, vecSub, vecScale, vecDot, vecCross, vecNormalize, vecLength };
+//# sourceMappingURL=compat.d.ts.map

package/dist/compat.d.ts.map

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

package/dist/compat.js

@@ -0,0 +1,99 @@
+/**
+ * compat — brepjs 同名兼容 shim（D12，批次一的桥接面）
+ *
+ * 设计：docs/plans/2026-09-01-layered-api-architecture.md §D12 / §7.3 / §7.5
+ *
+ * 移植的钣金源文件只改 import 来源行（`from 'brepjs'` → `from './compat.js'`），
+ * Result 消费点零改动。本文件是包内**唯一**桥接点（§9 验收白名单：src 中
+ * `kernel/`、`getBackends`、`getSlot` 零命中，compat.ts 除外）——
+ * 批次一（纯 2D/数据层）需要的符号以 vendored L1/L2 的同名形态提供：
+ *
+ * - Result 机制与类型：vendored `core/result.js` / `core/errors.js` /
+ *   `core/shapeTypes.js` / `core/validityTypes.js` / `core/types.js`；
+ * - 2D/查询 op：直包 vendored L2（`primitiveFns.line/wire/wireLoop`、
+ *   `topologyQueryFns.getEdges`、`curveFns.curveStartPoint/curveEndPoint`）——
+ *   产出的都是 brepjs 原样句柄形态（同一 occt-wasm 实例，D10），与 3D 批次
+ *   经 L3 `cad.*` 的路径不同：批次一不碰 3D 实体，无需 faijs Shape 包装。
+ *
+ * vec* 纯函数按 §7.5 ⑤ 不映射到 cad 命名空间；批次一各文件未消费 vec*，
+ * 待 3D 批次需要时从 vendored `utils/vec3.js` 在此 re-export。
+ */
+import { ok, err, isOk, isErr } from '@faicad/faijs-core/vendored/brepjs/core/result.js';
+import { validationError } from '@faicad/faijs-core/vendored/brepjs/core/errors.js';
+import { isSolid } from '@faicad/faijs-core/vendored/brepjs/core/shapeTypes.js';
+import { isPlanarWire } from '@faicad/faijs-core/vendored/brepjs/core/validityTypes.js';
+import { getSolids, getFaces, getBounds } from '@faicad/faijs-core/vendored/brepjs/topology/topologyQueryFns.js';
+import { line as brepjsLine, wire as brepjsWire, wireLoop as brepjsWireLoop, box as brepjsBox, cylinder as brepjsCylinder, sphere as brepjsSphere, face as brepjsFace, polygon as brepjsPolygon, } from '@faicad/faijs-core/vendored/brepjs/topology/primitiveFns.js';
+import { unwrap as brepjsUnwrap } from '@faicad/faijs-core/vendored/brepjs/core/result.js';
+import { fuse as brepjsFuse, cut as brepjsCut, intersect as brepjsIntersect } from '@faicad/faijs-core/vendored/brepjs/topology/booleanFns.js';
+import { rotate as brepjsRotate, translate as brepjsTranslate } from '@faicad/faijs-core/vendored/brepjs/topology/transformFns.js';
+import { extrude as brepjsExtrude } from '@faicad/faijs-core/vendored/brepjs/operations/extrudeFns.js';
+import { getEdges as brepjsGetEdges } from '@faicad/faijs-core/vendored/brepjs/topology/topologyQueryFns.js';
+import { curveStartPoint as brepjsCurveStartPoint, curveEndPoint as brepjsCurveEndPoint, } from '@faicad/faijs-core/vendored/brepjs/topology/curveFns.js';
+import { isValid } from '@faicad/faijs-core/vendored/brepjs/topology/healingFns.js';
+import { measureVolume, measureArea } from '@faicad/faijs-core/vendored/brepjs/measurement/measureFns.js';
+import { getSurfaceType, pointOnSurface, normalAt, faceCenter, } from '@faicad/faijs-core/vendored/brepjs/topology/faceFns.js';
+import { sharedEdges } from '@faicad/faijs-core/vendored/brepjs/topology/adjacencyFns.js';
+import { outerWire as brepjsOuterWire } from '@faicad/faijs-core/vendored/brepjs/topology/faceFns.js';
+import { vecAdd, vecSub, vecScale, vecDot, vecCross, vecNormalize, vecLength, } from '@faicad/faijs-core/vendored/brepjs/core/vecOps.js';
+// ── Result 机制（L1 core/result + core/errors，brepjs 同名） ──
+export { ok, err, isOk, isErr, validationError, brepjsUnwrap as unwrap };
+// ── 2D/查询 op（直 re-export vendored L2，保留 brepjs 同名同签名） ──
+export { brepjsLine as line, brepjsWire as wire, brepjsWireLoop as wireLoop };
+export { brepjsGetEdges as getEdges, getSolids, getFaces, getBounds };
+export { isSolid, isPlanarWire, isValid };
+export { brepjsCurveStartPoint as curveStartPoint, brepjsCurveEndPoint as curveEndPoint };
+// ── 3D op（批次二/三：布尔/图元/变换/拉伸） ──
+export { brepjsBox as box, brepjsCylinder as cylinder, brepjsSphere as sphere, brepjsFace as face };
+export { brepjsPolygon as polygon, brepjsOuterWire as outerWire };
+export { brepjsExtrude as extrude };
+export { brepjsTranslate as translate };
+// 上游 brepjs 18 的 rotate 以 `{ at, axis }` 选项对象接受轴；vendored 树是
+// 四参数位置形态（P5 锁定 commit）。compat 包装对齐上游同名同签（D12）。
+/**
+ * Rotate a shape by an angle in degrees around an axis.
+ * @param shape - The shape to rotate.
+ * @param angle - Rotation angle in degrees.
+ * @param options - Axis and pivot (`at`) for the rotation; defaults to the Z
+ * axis through the origin, matching upstream brepjs.
+ * @returns A new rotated shape.
+ */
+export function rotate(shape, angle, options = {}) {
+    return brepjsRotate(shape, angle, options.at ?? [0, 0, 0], options.axis ?? [0, 0, 1]);
+}
+// 上游 brepjs 18 的布尔接受任意 3D shape；vendored 首重载要求 ValidSolid
+// 品牌（编译期幻影）。compat 以 Solid 形态导出、内部 cast（运行时无差异）。
+/**
+ * Fuse two solids (union). Accepts plain `Solid` operands like upstream
+ * brepjs; the vendored `ValidSolid` brand is applied internally.
+ * @param a - First solid operand.
+ * @param b - Second solid operand.
+ * @returns `Ok` with the fused solid, or `Err` when the result is not 3D.
+ */
+export function fuse(a, b) {
+    return brepjsFuse(a, b);
+}
+/**
+ * Cut solid `b` out of solid `a` (difference).
+ * @param a - Solid to subtract from.
+ * @param b - Solid to subtract.
+ * @returns `Ok` with the result, or `Err` when the result is not 3D.
+ */
+export function cut(a, b) {
+    return brepjsCut(a, b);
+}
+/**
+ * Intersect two solids (common volume).
+ * @param a - First solid operand.
+ * @param b - Second solid operand.
+ * @returns `Ok` with the intersection, or `Err` when the result is not 3D.
+ */
+export function intersect(a, b) {
+    return brepjsIntersect(a, b);
+}
+// ── 度量 / 曲面查询（批次二/三） ──
+export { measureVolume, measureArea };
+export { getSurfaceType, pointOnSurface, normalAt, faceCenter, sharedEdges };
+// ── 向量纯函数（§7.5 ⑤，不映射 cad 命名空间） ──
+export { vecAdd, vecSub, vecScale, vecDot, vecCross, vecNormalize, vecLength };
+//# sourceMappingURL=compat.js.map

package/dist/compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat.js","sourceRoot":"","sources":["../src/compat.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * compat — brepjs 同名兼容 shim（D12，批次一的桥接面）\n *\n * 设计：docs/plans/2026-09-01-layered-api-architecture.md §D12 / §7.3 / §7.5\n *\n * 移植的钣金源文件只改 import 来源行（`from 'brepjs'` → `from './compat.js'`），\n * Result 消费点零改动。本文件是包内**唯一**桥接点（§9 验收白名单：src 中\n * `kernel/`、`getBackends`、`getSlot` 零命中，compat.ts 除外）——\n * 批次一（纯 2D/数据层）需要的符号以 vendored L1/L2 的同名形态提供：\n *\n * - Result 机制与类型：vendored `core/result.js` / `core/errors.js` /\n *   `core/shapeTypes.js` / `core/validityTypes.js` / `core/types.js`；\n * - 2D/查询 op：直包 vendored L2（`primitiveFns.line/wire/wireLoop`、\n *   `topologyQueryFns.getEdges`、`curveFns.curveStartPoint/curveEndPoint`）——\n *   产出的都是 brepjs 原样句柄形态（同一 occt-wasm 实例，D10），与 3D 批次\n *   经 L3 `cad.*` 的路径不同：批次一不碰 3D 实体，无需 faijs Shape 包装。\n *\n * vec* 纯函数按 §7.5 ⑤ 不映射到 cad 命名空间；批次一各文件未消费 vec*，\n * 待 3D 批次需要时从 vendored `utils/vec3.js` 在此 re-export。\n */\n\nimport { ok, err, isOk, isErr, type Result } from '@faicad/faijs-core/vendored/brepjs/core/result.js'\nimport { validationError, type BrepError } from '@faicad/faijs-core/vendored/brepjs/core/errors.js'\nimport type { Solid, Wire, Edge, Face, AnyShape } from '@faicad/faijs-core/vendored/brepjs/core/shapeTypes.js'\nimport { isSolid } from '@faicad/faijs-core/vendored/brepjs/core/shapeTypes.js'\nimport type { ClosedWire, ValidSolid } from '@faicad/faijs-core/vendored/brepjs/core/validityTypes.js'\nimport { isPlanarWire } from '@faicad/faijs-core/vendored/brepjs/core/validityTypes.js'\nimport type { Vec3 } from '@faicad/faijs-core/vendored/brepjs/core/types.js'\nimport type { Bounds3D } from '@faicad/faijs-core/vendored/brepjs/topology/topologyQueryFns.js'\nimport { getSolids, getFaces, getBounds } from '@faicad/faijs-core/vendored/brepjs/topology/topologyQueryFns.js'\nimport {\n  line as brepjsLine,\n  wire as brepjsWire,\n  wireLoop as brepjsWireLoop,\n  box as brepjsBox,\n  cylinder as brepjsCylinder,\n  sphere as brepjsSphere,\n  face as brepjsFace,\n  polygon as brepjsPolygon,\n} from '@faicad/faijs-core/vendored/brepjs/topology/primitiveFns.js'\nimport { unwrap as brepjsUnwrap } from '@faicad/faijs-core/vendored/brepjs/core/result.js'\nimport { fuse as brepjsFuse, cut as brepjsCut, intersect as brepjsIntersect } from '@faicad/faijs-core/vendored/brepjs/topology/booleanFns.js'\nimport { rotate as brepjsRotate, translate as brepjsTranslate } from '@faicad/faijs-core/vendored/brepjs/topology/transformFns.js'\nimport { extrude as brepjsExtrude } from '@faicad/faijs-core/vendored/brepjs/operations/extrudeFns.js'\nimport { getEdges as brepjsGetEdges } from '@faicad/faijs-core/vendored/brepjs/topology/topologyQueryFns.js'\nimport {\n  curveStartPoint as brepjsCurveStartPoint,\n  curveEndPoint as brepjsCurveEndPoint,\n} from '@faicad/faijs-core/vendored/brepjs/topology/curveFns.js'\nimport { isValid } from '@faicad/faijs-core/vendored/brepjs/topology/healingFns.js'\nimport { measureVolume, measureArea } from '@faicad/faijs-core/vendored/brepjs/measurement/measureFns.js'\nimport {\n  getSurfaceType,\n  pointOnSurface,\n  normalAt,\n  faceCenter,\n} from '@faicad/faijs-core/vendored/brepjs/topology/faceFns.js'\nimport { sharedEdges } from '@faicad/faijs-core/vendored/brepjs/topology/adjacencyFns.js'\nimport { outerWire as brepjsOuterWire } from '@faicad/faijs-core/vendored/brepjs/topology/faceFns.js'\nimport {\n  vecAdd,\n  vecSub,\n  vecScale,\n  vecDot,\n  vecCross,\n  vecNormalize,\n  vecLength,\n} from '@faicad/faijs-core/vendored/brepjs/core/vecOps.js'\n\n// ── Result 机制（L1 core/result + core/errors，brepjs 同名） ──\nexport { ok, err, isOk, isErr, validationError, brepjsUnwrap as unwrap }\nexport type { Result, BrepError }\n\n// ── 类型（L1，brepjs 同名；批次一消费的类型全集） ──\nexport type { Solid, Wire, Edge, Face, AnyShape, ClosedWire, ValidSolid, Vec3, Bounds3D }\n\n// ── 2D/查询 op（直 re-export vendored L2，保留 brepjs 同名同签名） ──\nexport { brepjsLine as line, brepjsWire as wire, brepjsWireLoop as wireLoop }\nexport { brepjsGetEdges as getEdges, getSolids, getFaces, getBounds }\nexport { isSolid, isPlanarWire, isValid }\nexport { brepjsCurveStartPoint as curveStartPoint, brepjsCurveEndPoint as curveEndPoint }\n\n// ── 3D op（批次二/三：布尔/图元/变换/拉伸） ──\nexport { brepjsBox as box, brepjsCylinder as cylinder, brepjsSphere as sphere, brepjsFace as face }\nexport { brepjsPolygon as polygon, brepjsOuterWire as outerWire }\nexport { brepjsExtrude as extrude }\nexport { brepjsTranslate as translate }\n\n// 上游 brepjs 18 的 rotate 以 `{ at, axis }` 选项对象接受轴；vendored 树是\n// 四参数位置形态（P5 锁定 commit）。compat 包装对齐上游同名同签（D12）。\n/**\n * Rotate a shape by an angle in degrees around an axis.\n * @param shape - The shape to rotate.\n * @param angle - Rotation angle in degrees.\n * @param options - Axis and pivot (`at`) for the rotation; defaults to the Z\n * axis through the origin, matching upstream brepjs.\n * @returns A new rotated shape.\n */\nexport function rotate<T extends AnyShape>(\n  shape: T,\n  angle: number,\n  options: { at?: Vec3; axis?: Vec3 } = {}\n): T {\n  return brepjsRotate(shape, angle, options.at ?? [0, 0, 0], options.axis ?? [0, 0, 1]);\n}\n\n// 上游 brepjs 18 的布尔接受任意 3D shape；vendored 首重载要求 ValidSolid\n// 品牌（编译期幻影）。compat 以 Solid 形态导出、内部 cast（运行时无差异）。\n/**\n * Fuse two solids (union). Accepts plain `Solid` operands like upstream\n * brepjs; the vendored `ValidSolid` brand is applied internally.\n * @param a - First solid operand.\n * @param b - Second solid operand.\n * @returns `Ok` with the fused solid, or `Err` when the result is not 3D.\n */\nexport function fuse(a: Solid, b: Solid): Result<ValidSolid> {\n  return brepjsFuse(a as ValidSolid, b as ValidSolid);\n}\n/**\n * Cut solid `b` out of solid `a` (difference).\n * @param a - Solid to subtract from.\n * @param b - Solid to subtract.\n * @returns `Ok` with the result, or `Err` when the result is not 3D.\n */\nexport function cut(a: Solid, b: Solid): Result<ValidSolid> {\n  return brepjsCut(a as ValidSolid, b as ValidSolid);\n}\n/**\n * Intersect two solids (common volume).\n * @param a - First solid operand.\n * @param b - Second solid operand.\n * @returns `Ok` with the intersection, or `Err` when the result is not 3D.\n */\nexport function intersect(a: Solid, b: Solid): Result<ValidSolid> {\n  return brepjsIntersect(a as ValidSolid, b as ValidSolid);\n}\n\n// ── 度量 / 曲面查询（批次二/三） ──\nexport { measureVolume, measureArea }\nexport { getSurfaceType, pointOnSurface, normalAt, faceCenter, sharedEdges }\n\n// ── 向量纯函数（§7.5 ⑤，不映射 cad 命名空间） ──\nexport { vecAdd, vecSub, vecScale, vecDot, vecCross, vecNormalize, vecLength }\n"]}

package/dist/contourFlangeFns.d.ts

@@ -0,0 +1,122 @@
+import { type Result, type Vec3, type Solid } from '@faicad/faijs/brepjs-compat';
+import type { ContourFlangeSpec, FlatSide, ProfileSegment, SheetMetalPart } from './types.js';
+/**
+ * The local frame of one contour-flange segment: the contact origin plus the
+ * segment's run, normal and shared bend-axis directions.
+ */
+export interface SegmentFrame {
+    /** Origin of the −normal (bottom) surface at the start of this segment. */
+    origin: Vec3;
+    /** Outward run direction (the segment's local +X). */
+    run: Vec3;
+    /** Top-surface normal (+Z), n = bendAxis × run. */
+    n: Vec3;
+    /** Bend axis along the base edge (+Y), shared by every segment. */
+    axis: Vec3;
+}
+/**
+ * Author a contour flange: an OPEN 2D profile (alternating line/arc segments) swept
+ * along one straight edge of the base flat. Each arc is a cylindrical bend, each
+ * line a flat leg; consecutive segments chain frame-to-frame exactly as
+ * {@link authorPart} chains flanges, building one connected multi-bend cross-section
+ * (a return, a hat, a J). The recorded {@link ContourFlangeFeature} carries each
+ * segment's EXACT developed length (lines: `length`; arcs: the canonical
+ * {@link developedLength}) so the unfold lays the strip out straight with no error.
+ * Construction stays on the public, OCCT-WASM-safe API.
+ * @param part the sheet-metal part the contour flange is added to (must already carry a solid)
+ * @param spec the contour-flange specification: profile segments, side, offset, width and optional bend rule
+ * @returns a `Result<SheetMetalPart>` — `ok` with the part plus the fused solid and the recorded
+ * {@link ContourFlangeFeature}, or `err` with a `validationError` on invalid input
+ */
+export declare function authorContourFlange(part: SheetMetalPart, spec: ContourFlangeSpec): Result<SheetMetalPart>;
+/**
+ * Result of building one contour-flange segment: the fused solid and the next
+ * segment's chained frame.
+ */
+export interface BuiltSegment {
+    solid: Solid;
+    frame: SegmentFrame;
+}
+/**
+ * Result of building a cylindrical bend: {@link BuiltSegment} plus the world-space
+ * origin of the bend axis.
+ */
+export interface BuiltArc extends BuiltSegment {
+    axisOrigin: Vec3;
+}
+/**
+ * Add one straight leg of `legLength` extending from `frame.origin` along
+ * `frame.run`, full thickness along `frame.n`, across `span` along `frame.axis`.
+ * The next segment's frame starts at the leg's far end.
+ * @param base the solid the new leg is fused onto
+ * @param frame the current segment frame the leg is built in
+ * @param span the flange width along the bend axis
+ * @param thickness the sheet thickness
+ * @param legLength the straight-run length of the leg
+ * @returns a `Result<BuiltSegment>` — `ok` with the fused solid and the next segment's
+ * frame, or `err` when the boolean fuse fails
+ */
+export declare function buildLineLeg(base: Solid, frame: SegmentFrame, span: number, thickness: number, legLength: number): Result<BuiltSegment>;
+/**
+ * Add one cylindrical bend turning the running direction by `angleDeg`. Mirrors
+ * {@link authorPart}'s bend patch: a hollow tube (outer R+T, inner R) intersected
+ * with the fold wedge, in a canonical frame mapped onto the current segment frame.
+ * The returned frame's run/normal are rotated by the fold so the next leg continues
+ * tangentially.
+ * @param base the solid the bend is fused onto
+ * @param frame the current segment frame the bend turns from
+ * @param span the flange width along the bend axis
+ * @param thickness the sheet thickness
+ * @param seg the arc profile segment: radius, angle and fold direction
+ * @returns a `Result<BuiltArc>` — `ok` with the fused solid, the rotated next frame and the
+ * world-space bend axis origin, or `err` with a `validationError` on invalid geometry
+ */
+export declare function buildArcBend(base: Solid, frame: SegmentFrame, span: number, thickness: number, seg: Extract<ProfileSegment, {
+    kind: 'arc';
+}>): Result<BuiltArc>;
+/**
+ * One of the four straight edges of a flat region, resolved into the start line a
+ * profile is chained from: edge direction, outward normal, start point and length.
+ */
+export interface BaseEdge {
+    dir: Vec3;
+    out: Vec3;
+    start: Vec3;
+    length: number;
+}
+/**
+ * Resolve one of the four edges of the base flat (the contour-flange root).
+ * @param part the sheet-metal part whose base flat edge is resolved
+ * @param side which of the four base-flat edges to resolve (`'xmax'`/`'xmin'`/`'ymax'`/`'ymin'`)
+ * @returns the resolved {@link BaseEdge} — edge direction, outward normal, start point and length
+ */
+export declare function baseEdge(part: SheetMetalPart, side: FlatSide): BaseEdge;
+/**
+ * Resolve one of the four edges of an arbitrary flat region (its world top-surface
+ * frame), the region-aware generalization of {@link baseEdge}: the base is the
+ * special case where `origin = 0`, `u = +X`, `v = +Y`, `n = +Z`. Used by hems and
+ * jogs to chain their profile off a named flange (or the base) edge.
+ * @param frame the region's world top-surface frame (origin, u/v/n axes and extents)
+ * @param side which of the four region edges to resolve
+ * @returns the resolved {@link BaseEdge} — edge direction, outward normal, start point and length
+ */
+export declare function regionEdge(frame: {
+    origin: Vec3;
+    u: Vec3;
+    v: Vec3;
+    n: Vec3;
+    uLen: number;
+    vLen: number;
+}, side: FlatSide): BaseEdge;
+/**
+ * The starting {@link SegmentFrame} for a profile chained off `edge` at `offset`
+ * along it: contact at the edge, run pointing outward, normal = the region normal,
+ * bend axis along the edge. Shared by the contour-flange, hem and jog builders.
+ * @param edge the resolved region edge the profile starts from
+ * @param n the region normal, used as the frame's +Z
+ * @param offset the start position along the edge, measured from `edge.start`
+ * @returns the {@link SegmentFrame} with contact at the edge at `offset`, run pointing
+ * outward and axis along the edge
+ */
+export declare function initialSegmentFrame(edge: BaseEdge, n: Vec3, offset: number): SegmentFrame;
+//# sourceMappingURL=contourFlangeFns.d.ts.map

package/dist/contourFlangeFns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contourFlangeFns.d.ts","sourceRoot":"","sources":["../src/contourFlangeFns.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,KAAK,EAkBX,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAIV,iBAAiB,EACjB,QAAQ,EACR,cAAc,EACd,cAAc,EACf,MAAM,YAAY,CAAC;AAIpB;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,MAAM,EAAE,IAAI,CAAC;IACb,sDAAsD;IACtD,GAAG,EAAE,IAAI,CAAC;IACV,mDAAmD;IACnD,CAAC,EAAE,IAAI,CAAC;IACR,mEAAmE;IACnE,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,iBAAiB,GACtB,MAAM,CAAC,cAAc,CAAC,CAuGxB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAS,SAAQ,YAAY;IAC5C,UAAU,EAAE,IAAI,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,KAAK,EACX,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,YAAY,CAAC,CAWtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,KAAK,EACX,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,OAAO,CAAC,cAAc,EAAE;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC,GAC5C,MAAM,CAAC,QAAQ,CAAC,CA8ClB;AAgCD;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,IAAI,CAAC;IACV,GAAG,EAAE,IAAI,CAAC;IACV,KAAK,EAAE,IAAI,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,CA8CvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAC9E,IAAI,EAAE,QAAQ,GACb,QAAQ,CAwCV;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAOzF"}