@faicad/faijs 0.13.0

package/dist/api/chamfer.js

@@ -0,0 +1,234 @@
+/**
+ * stdlib chamfer — chamfer 倒角库函数（BREP-only，directEdit 能力）
+ *
+ *
+ * 与 drill/engrave 的差异：没有 mesh 实现（defineOp({ brep })），输入非 BREP
+ * 时由 dispatchPath 抛 E_MESH_UNSUPPORTED；mode='brep' 且引擎缺 directEdit 能力
+ * → E_BREP_UNSUPPORTED（backend-dispatch.ts 单点判定）。
+ *
+ * 类型：
+ * - equal（对称）：kernel.chamfer(solid, edges, width)
+ * - distanceAngle：kernel.chamferDistAngle(solid, edges, width, angle)
+ * - twoDistances（双距）：逐边按 §3.5 换算（width1,width2 + β → dF, θ），
+ *     per-edge 调 kernel.chamferDistAngle；凹棱（β ≥ 180°）→ E_CHAMFER_REFLEX_EDGE。
+ */
+import { solidToShape } from '../brep/brep-ops.js';
+import { chamferWithRoleTable, identityEvolution } from '../brep/face-evolution.js';
+import { getBackends, getCurrentStmt } from '../runtime-state.js';
+import { fromBrep, brepOf, getSlot } from '../shape.js';
+import { defineOp } from '../sdk.js';
+import { resolveTopoRef, facesForQualifier, TopoRefError } from '../topology/naming/index.js';
+import { buildEdgeResolutionContext, buildEdgeContextFromSolid } from './topo-resolve.js';
+import { angleBetweenNormals, materialDihedralFromNormalAngle, chamferAngleFromDistances } from './chamfer-math.js';
+// ── 参数自校验（stdlib 被直接 import 时的防御层）──
+/**
+ * Validate chamfer parameters: `edges` must be a non-empty array of EdgeTopoRef,
+ * each with kind key "edge" and a two-entry faces pair.
+ * @param params the raw chamfer operation parameters.
+ */
+export function assertChamferParams(params) {
+    const edges = params.edges;
+    if (!Array.isArray(edges) || edges.length === 0) {
+        throw new Error('E_CHAMFER_NO_EDGES: chamfer requires at least one edge');
+    }
+    for (const e of edges) {
+        if (!e || typeof e !== 'object' || e.kind !== 'edge') {
+            throw new Error('E_CHAMFER_BAD_EDGE_REF: every edge entry must be an EdgeTopoRef with kind:"edge"');
+        }
+        const faces = e.faces;
+        if (!Array.isArray(faces) || faces.length !== 2) {
+            throw new Error('E_CHAMFER_BAD_EDGE_REF: EdgeTopoRef.faces must be a two-entry RoleQualifier pair');
+        }
+    }
+    const type = params.type;
+    if (type !== 'equal' && type !== 'twoDistances' && type !== 'distanceAngle') {
+        throw new Error('E_CHAMFER_BAD_TYPE: type must be equal | twoDistances | distanceAngle');
+    }
+    if (type === 'equal' || type === 'distanceAngle') {
+        const width = params.width;
+        if (typeof width !== 'number' || !Number.isFinite(width) || width <= 0) {
+            throw new Error('E_CHAMFER_BAD_WIDTH: chamfer.width must be a positive number');
+        }
+        if (type === 'distanceAngle') {
+            const angle = params.angle;
+            if (typeof angle !== 'number' || !Number.isFinite(angle) || angle <= 0 || angle >= 90) {
+                throw new Error('E_CHAMFER_BAD_ANGLE: chamfer.angle must be in (0, 90) degrees');
+            }
+        }
+    }
+    else {
+        const w1 = params.width1;
+        const w2 = params.width2;
+        if (typeof w1 !== 'number' || !Number.isFinite(w1) || w1 <= 0) {
+            throw new Error('E_CHAMFER_BAD_WIDTH: chamfer.width1 must be a positive number');
+        }
+        if (typeof w2 !== 'number' || !Number.isFinite(w2) || w2 <= 0) {
+            throw new Error('E_CHAMFER_BAD_WIDTH: chamfer.width2 must be a positive number');
+        }
+    }
+}
+// ── §3.5 几何换算 ──
+/** 面中心外法向（与 captureFaceHint 同口径）。 */
+function faceMidNormal(kernel, face) {
+    const uv = kernel.uvBounds(face);
+    const n = kernel.surfaceNormal(face, (uv.uMin + uv.uMax) / 2, (uv.vMin + uv.vMax) / 2);
+    return [n.x, n.y, n.z];
+}
+function dot3(a, b) {
+    return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+}
+function radToDeg(rad) {
+    return (rad * 180) / Math.PI;
+}
+/** 复刻 occt-wasm 的双层枚举（config.rs:517-527）：返回内核选用的参考面在
+ *  `faceHandles`（getSubShapes(solid,'face')）数组中的下标（0 起）；找不到 → null。 */
+function refFaceIndex(kernel, faceHandles, edge) {
+    for (let fi = 0; fi < faceHandles.length; fi++) {
+        for (const fe of kernel.getSubShapes(faceHandles[fi], 'edge')) {
+            if (kernel.isSame(fe, edge))
+                return fi;
+        }
+    }
+    return null;
+}
+/** 两邻面 outer-normal 夹角 → β（材料侧二面角，弧度）。 */
+function materialDihedralRad(kernel, ctx, a, b) {
+    const ha = ctx.faces[a - 1]?.handle;
+    const hb = ctx.faces[b - 1]?.handle;
+    if (ha === undefined || hb === undefined) {
+        throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', `chamfer: adjacent face ${a}/${b} has no live handle`);
+    }
+    const gamma = angleBetweenNormals(dot3(faceMidNormal(kernel, ha), faceMidNormal(kernel, hb)));
+    return materialDihedralFromNormalAngle(gamma);
+}
+/**
+ * twoDistances 单边换算：width1/width2 + β（§3.5）→ (dF, θ) 供一次 chamferDistAngle。
+ * 参考面由内核自选（refOrdinal 的面）；width1 对应 faces[0] 侧、width2 对应 faces[1] 侧。
+ *
+ * @param kernel        the OCCT kernel.
+ * @param ctx           the edge resolution context (faces with live handles).
+ * @param refAOrdinal   resolved ordinal of `EdgeTopoRef.faces[0]` (1-based).
+ * @param refBOrdinal   resolved ordinal of `EdgeTopoRef.faces[1]` (1-based).
+ * @param refOrdinal    the kernel reference face ordinal (1-based; the F in §3.5).
+ * @param width1        the `width1` argument.
+ * @param width2        the `width2` argument.
+ * @returns { dF, angleDeg } for a single `kernel.chamferDistAngle` call.
+ */
+export function twoDistParams(kernel, ctx, refAOrdinal, refBOrdinal, refOrdinal, width1, width2) {
+    const betaRad = materialDihedralRad(kernel, ctx, refAOrdinal, refBOrdinal);
+    // dF/dO：§3.5 —— 内核参考面 == faces[0] → width1，== faces[1] → width2。
+    let dF;
+    let dO;
+    if (refOrdinal === refAOrdinal) {
+        dF = width1;
+        dO = width2;
+    }
+    else if (refOrdinal === refBOrdinal) {
+        dF = width2;
+        dO = width1;
+    }
+    else {
+        throw new Error(`E_CHAMFER_EDGE_MISMATCH: kernel ref face ordinal ${refOrdinal} not in [${refAOrdinal}, ${refBOrdinal}]`);
+    }
+    const angleRad = chamferAngleFromDistances(dF, dO, betaRad);
+    return { distance: dF, angleDeg: radToDeg(angleRad) };
+}
+/** 解析一条 EdgeTopoRef → (ordinal, handle)；失败抛命名层 TopoRefError。 */
+function resolveEdge(ctx, ref) {
+    const r = resolveTopoRef(ref, ctx);
+    if (r.handle === undefined) {
+        throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', `chamfer: edge resolved without handle (${ref.faces[0].role}/${ref.faces[1].role})`);
+    }
+    return { ordinal: r.ordinal, handle: r.handle };
+}
+/** twoDistances 逐边构建（§3.6 V1）：每条边一次 chamferDistAngle。 */
+function chamferTwoDistances(kernel, edges, startCtx, solid, width1, width2) {
+    let resultSolid = solid;
+    for (const ref of edges) {
+        const ctx = resultSolid === solid ? startCtx : buildEdgeContextFromSolid(kernel, resultSolid, startCtx.roleTable);
+        const entity = resolveEdge(ctx, ref);
+        const faces = resultSolid === solid ? startCtx.faces : ctx.faces;
+        const idx = refFaceIndex(kernel, faces.map((f) => f.handle).filter((h) => h !== undefined), entity.handle);
+        if (idx === null) {
+            throw new Error('E_CHAMFER_EDGE_MISMATCH: kernel cannot locate ref face (bug)');
+        }
+        const a = facesForQualifier(ref.faces[0], ctx)[0];
+        const b = facesForQualifier(ref.faces[1], ctx)[0];
+        const refOrdinal = idx + 1;
+        const p = twoDistParams(kernel, ctx, a?.ordinal ?? -1, b?.ordinal ?? -1, refOrdinal, width1, width2);
+        resultSolid = kernel.chamferDistAngle(resultSolid, [entity.handle], p.distance, p.angleDeg);
+    }
+    return resultSolid;
+}
+/** BREP-only 主入口（§3.6 flow）。 */
+function chamferBrep(input, params) {
+    const kernel = getBackends().kernel.brep;
+    if (!kernel)
+        throw new Error('[stdlib/chamfer] no BREP kernel');
+    const solid = brepOf(input);
+    if (!solid)
+        throw new Error('[stdlib/chamfer] E_CHAMFER_NO_BREP: input is not BREP');
+    const edges = params.edges ?? [];
+    const type = params.type;
+    const ctx = buildEdgeResolutionContext(kernel, input);
+    if (!ctx)
+        throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', 'input has no edge naming context');
+    // 输入 roleTable + outPart（与 boolean.ts / fillet.ts 同构）
+    const inputRoleTable = getSlot(input)?.roleTable;
+    const outPart = String(getCurrentStmt()?.outputs[0] ?? '');
+    let resultSolid;
+    let faceEvolution;
+    let roleTable;
+    switch (type) {
+        case 'equal': {
+            // P5：改走 chamferWithHistory + roleTable 传播（§3.2 末段）
+            const edgeHandles = edges.map((e) => resolveEdge(ctx, e).handle);
+            const r = chamferWithRoleTable(kernel, solid, edgeHandles, params.width, inputRoleTable ?? new Map(), outPart);
+            resultSolid = r.result;
+            faceEvolution = r.faceEvolution;
+            roleTable = r.roleTable;
+            break;
+        }
+        case 'distanceAngle':
+            resultSolid = kernel.chamferDistAngle(solid, edges.map((e) => resolveEdge(ctx, e).handle), params.width, params.angle);
+            // chamferDistAngle 无 WithHistory 版本——用恒等面演化 + 原表
+            faceEvolution = identityEvolution(kernel, resultSolid);
+            roleTable = inputRoleTable;
+            break;
+        case 'twoDistances':
+            resultSolid = chamferTwoDistances(kernel, edges, ctx, solid, params.width1, params.width2);
+            faceEvolution = identityEvolution(kernel, resultSolid);
+            roleTable = inputRoleTable;
+            break;
+        default:
+            throw new Error('E_CHAMFER_BAD_TYPE');
+    }
+    return fromBrep(solidToShape(kernel, resultSolid), faceEvolution ? { solid: resultSolid, faceEvolution, roleTable } : { solid: resultSolid, roleTable });
+}
+/**
+ * 在几何体上倒角（等距 / 双距 / 距角）。仅 BREP 可用。
+ * @group 特征
+ * @inputs 1
+ * @async true
+ * @qual ok
+ * @name chamfer
+ * @note 倒角是 BREP-only：非 BREP 输入抛 E_MESH_UNSUPPORTED。参考面由内核自选，`width1` 沿 faces[0] 侧、`width2` 沿 faces[1] 侧。
+ * @returns Shape 倒角后的几何。
+ * @param input - 目标几何。type:Shape required:true
+ * @param params.edges - 参与倒角的边（EdgeTopoRef[]，条目为相邻两面的 role 线路）。type:EdgeTopoRef[] required:true
+ * @param params.type - 倒角类型（equal | twoDistances | distanceAngle）。type:string required:true
+ * @param params.width - type=equal: 倒角宽度（mm）。type:number 默认 1
+ * @param params.width1 - type=twoDistances: 沿 faces[0] 侧距离（mm）。type:number
+ * @param params.width2 - type=twoDistances: 沿 faces[1] 侧距离（mm）。type:number
+ * @param params.angle - type=distanceAngle: 与参考面夹角（度，(0,90)）。type:number
+ * @example
+ * const p = await cad.chamfer(part0, { edges: [{ kind:'edge', faces:[{ origin:'box', role:'box:top' }, { origin:'box', role:'box:front' }], hint:{ kind:'edge' } }], type:'equal', width:1 })
+ */
+export const chamfer = defineOp({
+    capabilities: ['directEdit'],
+    brep(input, params) {
+        assertChamferParams(params);
+        return chamferBrep(input, params);
+    },
+});
+//# sourceMappingURL=chamfer.js.map

package/dist/api/chamfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chamfer.js","sourceRoot":"","sources":["../../src/api/chamfer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * stdlib chamfer — chamfer 倒角库函数（BREP-only，directEdit 能力）\n *\n *\n * 与 drill/engrave 的差异：没有 mesh 实现（defineOp({ brep })），输入非 BREP\n * 时由 dispatchPath 抛 E_MESH_UNSUPPORTED；mode='brep' 且引擎缺 directEdit 能力\n * → E_BREP_UNSUPPORTED（backend-dispatch.ts 单点判定）。\n *\n * 类型：\n * - equal（对称）：kernel.chamfer(solid, edges, width)\n * - distanceAngle：kernel.chamferDistAngle(solid, edges, width, angle)\n * - twoDistances（双距）：逐边按 §3.5 换算（width1,width2 + β → dF, θ），\n *     per-edge 调 kernel.chamferDistAngle；凹棱（β ≥ 180°）→ E_CHAMFER_REFLEX_EDGE。\n */\n\nimport type { Shape } from '../mesh/types'\nimport { solidToShape } from '../brep/brep-ops'\nimport { chamferWithRoleTable, identityEvolution } from '../brep/face-evolution'\nimport { getBackends, getCurrentStmt } from '../runtime-state'\nimport { fromBrep, brepOf, getSlot } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\nimport type { BrepHandle } from '../brep/engine/types'\nimport type { EdgeTopoRef, ResolutionContext } from '../topology/naming'\nimport { resolveTopoRef, facesForQualifier, TopoRefError } from '../topology/naming'\nimport { buildEdgeResolutionContext, buildEdgeContextFromSolid } from './topo-resolve'\nimport { angleBetweenNormals, materialDihedralFromNormalAngle, chamferAngleFromDistances } from './chamfer-math'\n\n// ── 参数自校验（stdlib 被直接 import 时的防御层）──\n\n/**\n * Validate chamfer parameters: `edges` must be a non-empty array of EdgeTopoRef,\n * each with kind key \"edge\" and a two-entry faces pair.\n * @param params the raw chamfer operation parameters.\n */\nexport function assertChamferParams(params: Record<string, unknown>): void {\n  const edges = params.edges\n  if (!Array.isArray(edges) || edges.length === 0) {\n    throw new Error('E_CHAMFER_NO_EDGES: chamfer requires at least one edge')\n  }\n  for (const e of edges) {\n    if (!e || typeof e !== 'object' || (e as { kind?: unknown }).kind !== 'edge') {\n      throw new Error('E_CHAMFER_BAD_EDGE_REF: every edge entry must be an EdgeTopoRef with kind:\"edge\"')\n    }\n    const faces = (e as { faces?: unknown }).faces\n    if (!Array.isArray(faces) || faces.length !== 2) {\n      throw new Error('E_CHAMFER_BAD_EDGE_REF: EdgeTopoRef.faces must be a two-entry RoleQualifier pair')\n    }\n  }\n  const type = params.type\n  if (type !== 'equal' && type !== 'twoDistances' && type !== 'distanceAngle') {\n    throw new Error('E_CHAMFER_BAD_TYPE: type must be equal | twoDistances | distanceAngle')\n  }\n  if (type === 'equal' || type === 'distanceAngle') {\n    const width = params.width\n    if (typeof width !== 'number' || !Number.isFinite(width) || width <= 0) {\n      throw new Error('E_CHAMFER_BAD_WIDTH: chamfer.width must be a positive number')\n    }\n    if (type === 'distanceAngle') {\n      const angle = params.angle\n      if (typeof angle !== 'number' || !Number.isFinite(angle) || angle <= 0 || angle >= 90) {\n        throw new Error('E_CHAMFER_BAD_ANGLE: chamfer.angle must be in (0, 90) degrees')\n      }\n    }\n  } else {\n    const w1 = params.width1\n    const w2 = params.width2\n    if (typeof w1 !== 'number' || !Number.isFinite(w1) || w1 <= 0) {\n      throw new Error('E_CHAMFER_BAD_WIDTH: chamfer.width1 must be a positive number')\n    }\n    if (typeof w2 !== 'number' || !Number.isFinite(w2) || w2 <= 0) {\n      throw new Error('E_CHAMFER_BAD_WIDTH: chamfer.width2 must be a positive number')\n    }\n  }\n}\n\n// ── §3.5 几何换算 ──\n\n/** 面中心外法向（与 captureFaceHint 同口径）。 */\nfunction faceMidNormal(kernel: BrepEngineApi, face: BrepHandle): [number, number, number] {\n  const uv = kernel.uvBounds(face)\n  const n = kernel.surfaceNormal(face, (uv.uMin + uv.uMax) / 2, (uv.vMin + uv.vMax) / 2)\n  return [n.x, n.y, n.z]\n}\n\nfunction dot3(a: readonly number[], b: readonly number[]): number {\n  return a[0] * b[0] + a[1] * b[1] + a[2] * b[2]\n}\n\nfunction radToDeg(rad: number): number {\n  return (rad * 180) / Math.PI\n}\n\n/** 复刻 occt-wasm 的双层枚举（config.rs:517-527）：返回内核选用的参考面在\n *  `faceHandles`（getSubShapes(solid,'face')）数组中的下标（0 起）；找不到 → null。 */\nfunction refFaceIndex(kernel: BrepEngineApi, faceHandles: BrepHandle[], edge: BrepHandle): number | null {\n  for (let fi = 0; fi < faceHandles.length; fi++) {\n    for (const fe of kernel.getSubShapes(faceHandles[fi], 'edge')) {\n      if (kernel.isSame(fe, edge)) return fi\n    }\n  }\n  return null\n}\n\n/** 两邻面 outer-normal 夹角 → β（材料侧二面角，弧度）。 */\nfunction materialDihedralRad(kernel: BrepEngineApi, ctx: ResolutionContext, a: number, b: number): number {\n  const ha = ctx.faces[a - 1]?.handle\n  const hb = ctx.faces[b - 1]?.handle\n  if (ha === undefined || hb === undefined) {\n    throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', `chamfer: adjacent face ${a}/${b} has no live handle`)\n  }\n  const gamma = angleBetweenNormals(dot3(faceMidNormal(kernel, ha), faceMidNormal(kernel, hb)))\n  return materialDihedralFromNormalAngle(gamma)\n}\n\n/**\n * twoDistances 单边换算：width1/width2 + β（§3.5）→ (dF, θ) 供一次 chamferDistAngle。\n * 参考面由内核自选（refOrdinal 的面）；width1 对应 faces[0] 侧、width2 对应 faces[1] 侧。\n *\n * @param kernel        the OCCT kernel.\n * @param ctx           the edge resolution context (faces with live handles).\n * @param refAOrdinal   resolved ordinal of `EdgeTopoRef.faces[0]` (1-based).\n * @param refBOrdinal   resolved ordinal of `EdgeTopoRef.faces[1]` (1-based).\n * @param refOrdinal    the kernel reference face ordinal (1-based; the F in §3.5).\n * @param width1        the `width1` argument.\n * @param width2        the `width2` argument.\n * @returns { dF, angleDeg } for a single `kernel.chamferDistAngle` call.\n */\nexport function twoDistParams(\n  kernel: BrepEngineApi,\n  ctx: ResolutionContext,\n  refAOrdinal: number,\n  refBOrdinal: number,\n  refOrdinal: number,\n  width1: number,\n  width2: number,\n): { distance: number; angleDeg: number } {\n  const betaRad = materialDihedralRad(kernel, ctx, refAOrdinal, refBOrdinal)\n  // dF/dO：§3.5 —— 内核参考面 == faces[0] → width1，== faces[1] → width2。\n  let dF: number\n  let dO: number\n  if (refOrdinal === refAOrdinal) {\n    dF = width1\n    dO = width2\n  } else if (refOrdinal === refBOrdinal) {\n    dF = width2\n    dO = width1\n  } else {\n    throw new Error(`E_CHAMFER_EDGE_MISMATCH: kernel ref face ordinal ${refOrdinal} not in [${refAOrdinal}, ${refBOrdinal}]`)\n  }\n  const angleRad = chamferAngleFromDistances(dF, dO, betaRad)\n  return { distance: dF, angleDeg: radToDeg(angleRad) }\n}\n\n/** 解析一条 EdgeTopoRef → (ordinal, handle)；失败抛命名层 TopoRefError。 */\nfunction resolveEdge(ctx: ResolutionContext, ref: EdgeTopoRef): { ordinal: number; handle: BrepHandle } {\n  const r = resolveTopoRef(ref, ctx)\n  if (r.handle === undefined) {\n    throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', `chamfer: edge resolved without handle (${ref.faces[0].role}/${ref.faces[1].role})`)\n  }\n  return { ordinal: r.ordinal, handle: r.handle as BrepHandle }\n}\n\n/** twoDistances 逐边构建（§3.6 V1）：每条边一次 chamferDistAngle。 */\nfunction chamferTwoDistances(\n  kernel: BrepEngineApi,\n  edges: EdgeTopoRef[],\n  startCtx: ResolutionContext,\n  solid: BrepHandle,\n  width1: number,\n  width2: number,\n): BrepHandle {\n  let resultSolid = solid\n  for (const ref of edges) {\n    const ctx = resultSolid === solid ? startCtx : buildEdgeContextFromSolid(kernel, resultSolid, startCtx.roleTable)\n    const entity = resolveEdge(ctx, ref)\n    const faces = resultSolid === solid ? startCtx.faces : ctx.faces\n    const idx = refFaceIndex(kernel, faces.map((f) => f.handle).filter((h): h is BrepHandle => h !== undefined), entity.handle)\n    if (idx === null) {\n      throw new Error('E_CHAMFER_EDGE_MISMATCH: kernel cannot locate ref face (bug)')\n    }\n    const a = facesForQualifier(ref.faces[0], ctx)[0]\n    const b = facesForQualifier(ref.faces[1], ctx)[0]\n    const refOrdinal = idx + 1\n    const p = twoDistParams(kernel, ctx, a?.ordinal ?? -1, b?.ordinal ?? -1, refOrdinal, width1, width2)\n    resultSolid = kernel.chamferDistAngle(resultSolid, [entity.handle], p.distance, p.angleDeg)\n  }\n  return resultSolid\n}\n\n/** BREP-only 主入口（§3.6 flow）。 */\nfunction chamferBrep(input: Shape, params: Record<string, unknown>): Shape {\n  const kernel = getBackends().kernel.brep as BrepEngineApi | null\n  if (!kernel) throw new Error('[stdlib/chamfer] no BREP kernel')\n  const solid = brepOf(input) as BrepHandle | undefined\n  if (!solid) throw new Error('[stdlib/chamfer] E_CHAMFER_NO_BREP: input is not BREP')\n\n  const edges = (params.edges as unknown as EdgeTopoRef[] | undefined) ?? []\n  const type = params.type as string\n  const ctx = buildEdgeResolutionContext(kernel, input as object)\n  if (!ctx) throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', 'input has no edge naming context')\n\n  // 输入 roleTable + outPart（与 boolean.ts / fillet.ts 同构）\n  const inputRoleTable = getSlot(input)?.roleTable as ReadonlyMap<unknown, unknown> | undefined\n  const outPart = String(getCurrentStmt()?.outputs[0] ?? '')\n\n  let resultSolid: BrepHandle\n  let faceEvolution: Map<number, number[]> | undefined\n  let roleTable: ReadonlyMap<unknown, unknown> | undefined\n\n  switch (type) {\n    case 'equal': {\n      // P5：改走 chamferWithHistory + roleTable 传播（§3.2 末段）\n      const edgeHandles = edges.map((e) => resolveEdge(ctx, e).handle)\n      const r = chamferWithRoleTable(\n        kernel,\n        solid,\n        edgeHandles,\n        params.width as number,\n        inputRoleTable ?? new Map(),\n        outPart,\n      )\n      resultSolid = r.result\n      faceEvolution = r.faceEvolution\n      roleTable = r.roleTable\n      break\n    }\n    case 'distanceAngle':\n      resultSolid = kernel.chamferDistAngle(solid, edges.map((e) => resolveEdge(ctx, e).handle), params.width as number, params.angle as number)\n      // chamferDistAngle 无 WithHistory 版本——用恒等面演化 + 原表\n      faceEvolution = identityEvolution(kernel, resultSolid)\n      roleTable = inputRoleTable\n      break\n    case 'twoDistances':\n      resultSolid = chamferTwoDistances(kernel, edges, ctx, solid, params.width1 as number, params.width2 as number)\n      faceEvolution = identityEvolution(kernel, resultSolid)\n      roleTable = inputRoleTable\n      break\n    default:\n      throw new Error('E_CHAMFER_BAD_TYPE')\n  }\n\n  return fromBrep(\n    solidToShape(kernel, resultSolid),\n    faceEvolution ? { solid: resultSolid, faceEvolution, roleTable } : { solid: resultSolid, roleTable },\n  )\n}\n\n/**\n * 在几何体上倒角（等距 / 双距 / 距角）。仅 BREP 可用。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual ok\n * @name chamfer\n * @note 倒角是 BREP-only：非 BREP 输入抛 E_MESH_UNSUPPORTED。参考面由内核自选，`width1` 沿 faces[0] 侧、`width2` 沿 faces[1] 侧。\n * @returns Shape 倒角后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @param params.edges - 参与倒角的边（EdgeTopoRef[]，条目为相邻两面的 role 线路）。type:EdgeTopoRef[] required:true\n * @param params.type - 倒角类型（equal | twoDistances | distanceAngle）。type:string required:true\n * @param params.width - type=equal: 倒角宽度（mm）。type:number 默认 1\n * @param params.width1 - type=twoDistances: 沿 faces[0] 侧距离（mm）。type:number\n * @param params.width2 - type=twoDistances: 沿 faces[1] 侧距离（mm）。type:number\n * @param params.angle - type=distanceAngle: 与参考面夹角（度，(0,90)）。type:number\n * @example\n * const p = await cad.chamfer(part0, { edges: [{ kind:'edge', faces:[{ origin:'box', role:'box:top' }, { origin:'box', role:'box:front' }], hint:{ kind:'edge' } }], type:'equal', width:1 })\n */\nexport const chamfer = defineOp({\n  capabilities: ['directEdit'],\n  brep(input: Shape, params: Record<string, unknown>) {\n    assertChamferParams(params)\n    return chamferBrep(input, params)\n  },\n})\n"]}

package/dist/api/compat/index.d.ts

@@ -0,0 +1,173 @@
+/**
+ * BREP-TS compatibility surface (P21).
+ *
+ * Projects the vendored BREP TS tree onto four stable groups so library authors
+ * can write `import { box, fuse, Sketcher, ok } from this module` and call it
+ * upstream-style:
+ *
+ *   ① op        — solid primitives + boolean / evolution operations
+ *   ② topology  — sub-shape queries + measurements (plus the Bounds3D type)
+ *   ③ sketching — stateful Sketcher / FaceSketcher DSL + drawing factories
+ *   ④ combinators / types — result, vector, plane, errors, constants, types
+ *
+ * Every symbol is a projection (re-export or a thin dual-form wrapper) from the
+ * ported tree: no reimplementation. The `.js` specifiers are the repo
+ * convention (TypeScript maps `.js` → `.ts`).
+ *
+ * Semantic wraps (P23: both live in `api/internal/compat-projection.ts` so the
+ * generated face and this hand-curated face share one mechanism):
+ * - single-kernel assert: every modeling op asserts a bound BREP kernel first
+ *   (see `assertKernelBound`); `getBackends()` may throw before configuration,
+ *   so it is guarded and falls back to the occt-kernel binding flag.
+ * - dual argument forms: object form normalizes to positional form via the
+ *   shared `resolveArgs` discriminant; object keys outside the declared
+ *   parameter table throw the shared `E_ARGS_FORM` token.
+ * - `box` is the hand-written dual-form sample: positional
+ *   `box(width, depth, height)` and `box({ size })` / `box({ width, depth,
+ *   height })` both forward to the vendored primitive in its native dimension
+ *   order (width = X, depth = Y, height = Z — confirm against
+ *   `primitiveFns#box`), so every accepted form yields identical geometry.
+ */
+import type { ValidSolid } from '../../vendored/brepjs/core/shapeTypes.js';
+/** Signature of a compat op projection (inputs normalized before the call). */
+type CompatOp = (...args: unknown[]) => unknown;
+import { sphere as primitiveSphere, cylinder as primitiveCylinder } from '../../vendored/brepjs/topology/primitiveFns.js';
+/**
+ * Create a solid box.
+ *
+ * Positional form `box(width, depth, height)` uses the vendor's native
+ * dimension order — X = width, Y = depth,
+ * Z = height (the vendored `primitiveFns#box` dimension order; width/height are
+ * NOT swapped). See the overload below for the object form.
+ *
+ * @param width - side length along X.
+ * @param depth - side length along Y.
+ * @param height - side length along Z.
+ * @returns a new valid solid box.
+ */
+export declare function box(width: number, depth: number, height: number): ValidSolid;
+/**
+ * Create a solid box from an object form.
+ *
+ * Accepts `box({ size })` where `size` is a number (cube) or a
+ * `[width, depth, height]` triple, or `box({ width, depth, height })`. Every
+ * accepted form forwards to `primitiveBox(width, depth, height)`, so equal
+ * dimension values always produce identical geometry.
+ *
+ * @param options - the dimension set: `size` (a cube edge or a triple) or
+ * `width`/`depth`/`height` sides.
+ * @returns a new valid solid box.
+ * @throws An `Error` whose message contains the shared `E_ARGS_FORM` token when
+ * no form matches (e.g. `box('x')`, `box()`, or unknown object keys).
+ */
+export declare function box(options: BoxDimensions): ValidSolid;
+/** Object-form input accepted by {@link box}. */
+export interface BoxDimensions {
+    /** All three sides as one number (cube) or a `[width, depth, height]` triple. */
+    size?: number | [number, number, number];
+    /** Side length along X. */
+    width?: number;
+    /** Side length along Y. */
+    depth?: number;
+    /** Side length along Z. */
+    height?: number;
+}
+/**
+ * Project the vendored `sphere(radius, options?)` verbatim (P25: the raw
+ * morph form is what portable libraries call — upstream brepjs signatures,
+ * no op projection).
+ */
+export { primitiveSphere as sphere };
+/** Project the vendored `cylinder(radius, height, options?)` verbatim. */
+export { primitiveCylinder as cylinder };
+/** Project the vendored `cone(bottomRadius, topRadius, height, options?)`. */
+export declare const cone: CompatOp;
+/** Project the vendored `torus(majorRadius, minorRadius, options?)`. */
+export declare const torus: CompatOp;
+/** Project the vendored `ellipsoid(rx, ry, rz, options?)`. */
+export declare const ellipsoid: CompatOp;
+import { fuse as vendoredFuse, cut as vendoredCut, intersect as vendoredIntersect } from '../../vendored/brepjs/topology/api.js';
+import { extrude as vendoredExtrude, revolve as vendoredRevolve, loft as vendoredLoft } from '../../vendored/brepjs/operations/api.js';
+/** Fuse two shapeables into one 3D result. */
+export declare const fuse: typeof vendoredFuse;
+/** Cut the second shapeable out of the first. */
+export declare const cut: typeof vendoredCut;
+/** Extrude a planar profile along a height or direction vector. */
+export declare const extrude: typeof vendoredExtrude;
+/** Revolve a planar profile around an axis with optional angle. */
+export declare const revolve: typeof vendoredRevolve;
+/** Loft through a set of wire profiles. */
+export declare const loft: typeof vendoredLoft;
+/** Intersect two shapeables (common 3D volume). */
+export declare const intersect: typeof vendoredIntersect;
+import { makeExternalGear as vendoredMakeExternalGear, makeInternalGear as vendoredMakeInternalGear, makePlanetaryGear as vendoredMakePlanetaryGear } from '../../vendored/brepjs/gear/gearFns.js';
+import { thread as vendoredThread } from '../../vendored/brepjs/operations/threadFns.js';
+/**
+ * Build an external spur gear.
+ * @param params - the external-gear parameters (`teeth`, `moduleSize`, `thickness`, …).
+ * @returns `Ok` with the gear solid + geometry, or `Err` for invalid parameters.
+ */
+export declare const makeExternalGear: typeof vendoredMakeExternalGear;
+/**
+ * Build an internal (ring) spur gear.
+ * @param params - the internal-gear parameters, including the optional ring wall thickness.
+ * @returns `Ok` with the gear solid + geometry, or `Err` for invalid parameters.
+ */
+export declare const makeInternalGear: typeof vendoredMakeInternalGear;
+/**
+ * Build a planetary gear train (sun + planets + ring).
+ * @param params - the planetary-gear parameters.
+ * @returns `Ok` with the sun/planet/ring solids and mesh diagnostics, or `Err`.
+ */
+export declare const makePlanetaryGear: typeof vendoredMakePlanetaryGear;
+/**
+ * Build a helical screw-thread ridge.
+ * @param options - the thread profile (`radius`, `pitch`, `height`, …).
+ * @returns `Ok` with the thread-ridge solid, or `Err` for invalid parameters.
+ */
+export declare const thread: typeof vendoredThread;
+export type { ExternalGearParams, InternalGearParams, PlanetaryGearParams, GearResult, PlanetaryGearAssembly, } from '../../vendored/brepjs/gear/gearFns.js';
+export type { ThreadOptions } from '../../vendored/brepjs/operations/threadFns.js';
+export { getEdges, getFaces, getWires, getVertices, getShells, getSolids, getCompSolids, getBounds, vertexPosition, } from '../../vendored/brepjs/topology/topologyQueryFns.js';
+export type { Bounds3D } from '../../vendored/brepjs/topology/topologyQueryFns.js';
+export { measureVolume, measureArea, measureLength, } from '../../vendored/brepjs/measurement/measureFns.js';
+export { default as Sketcher } from '../../vendored/brepjs/sketching/sketcher.js';
+export { default as FaceSketcher } from '../../vendored/brepjs/sketching/faceSketcher.js';
+export { drawCircle, drawEllipse, drawRoundedRectangle, drawRectangle, drawSingleCircle, drawSingleEllipse, drawPolysides, drawText, } from '../../vendored/brepjs/sketching/drawingFactories.js';
+export { draw } from '../../vendored/brepjs/sketching/drawingPen.js';
+export { makeBaseBox } from '../../vendored/brepjs/sketching/shortcuts.js';
+export { ok, err, isOk, isErr, unwrap, unwrapOr, map, andThen, } from '../../vendored/brepjs/core/result.js';
+export type { Result, Ok, Err } from '../../vendored/brepjs/core/result.js';
+export { vecAdd, vecSub, vecScale, vecDot, vecCross, vecLength, vecNormalize, } from '../../vendored/brepjs/core/vecOps.js';
+export { createPlane, createNamedPlane, resolvePlane, } from '../../vendored/brepjs/core/planeOps.js';
+export { kernelError, validationError } from '../../vendored/brepjs/core/errors.js';
+export type { BrepError } from '../../vendored/brepjs/core/errors.js';
+export { DEG2RAD, RAD2DEG } from '../../vendored/brepjs/core/constants.js';
+export type { Vertex, Edge, Wire, Face, Shell, Solid, CompSolid, Shape3D, ValidSolid, ClosedWire, AnyShape, } from '../../vendored/brepjs/core/shapeTypes.js';
+export type { GearGeometry } from '../../vendored/brepjs/gear/gearMath.js';
+export type { Plane, PlaneName, PlaneInput } from '../../vendored/brepjs/core/planeTypes.js';
+export type { Vec3, PointInput } from '../../vendored/brepjs/core/types.js';
+import { line as rawLine, wire as rawWire, wireLoop as rawWireLoop, face as rawFace, polygon as rawPolygon } from '../../vendored/brepjs/topology/primitiveFns.js';
+import { outerWire as rawOuterWire, getSurfaceType as rawSurfaceType, pointOnSurface as rawPointOnSurface, normalAt as rawNormalAt, faceCenter as rawFaceCenter } from '../../vendored/brepjs/topology/faceFns.js';
+import { sharedEdges as rawSharedEdges } from '../../vendored/brepjs/topology/adjacencyFns.js';
+import { curveStartPoint as rawCurveStartPoint, curveEndPoint as rawCurveEndPoint } from '../../vendored/brepjs/topology/curveFns.js';
+import { translate as rawTranslate } from '../../vendored/brepjs/topology/transformFns.js';
+import { isSolid as rawIsSolid } from '../../vendored/brepjs/core/shapeTypes.js';
+import { isPlanarWire as rawIsPlanarWire } from '../../vendored/brepjs/core/validityTypes.js';
+import { isValid as rawIsValid } from '../../vendored/brepjs/topology/healingFns.js';
+import type { AnyShape } from '../../vendored/brepjs/core/shapeTypes.js';
+import type { Vec3 } from '../../vendored/brepjs/core/types.js';
+export { rawLine as line, rawWire as wire, rawWireLoop as wireLoop, rawFace as face, rawPolygon as polygon, rawOuterWire as outerWire, rawSurfaceType as getSurfaceType, rawPointOnSurface as pointOnSurface, rawNormalAt as normalAt, rawFaceCenter as faceCenter, rawSharedEdges as sharedEdges, rawCurveStartPoint as curveStartPoint, rawCurveEndPoint as curveEndPoint, rawTranslate as translate, rawIsSolid as isSolid, rawIsPlanarWire as isPlanarWire, rawIsValid as isValid, };
+/**
+ * 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;
+//# sourceMappingURL=index.d.ts.map

package/dist/api/compat/index.d.ts.map

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