@faicad/faijs 0.29.5 → 0.31.1

package/dist/api/measure-query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/measure-query/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * api measure-query — 测量与查询族（S4 剩余，平台 op engines:['occt']）\n *\n * @platform occt — 13 个原生方法直调 occt-wasm（occt-wasm 5.6.0 有，见\n * `dist/index.d.ts` 的 `OcctKernel`）：\n *   containsPoint / distanceBetween / getInertia / getLinearCenterOfMass /\n *   projectPointOnEdge / projectPointOnFace / classifyPointOnFace / uvFromPoint /\n *   vertexPosition / subShapeCount / iterShapes / liftCurve2dToPlane / intersectionCells\n * 它们**不在** L1 契约 `BrepEngineApi` 里（L1 只有 getCenterOfMass / getVolume /\n * getSurfaceArea / getBoundingBox 等子集，见 brep/engine/primitives.ts）⇒ 全族平台 op。\n *\n * 方案落点：docs/plans/2026-10-07-occt-wasm-op-enablement-plan.md §3.4.6。\n *\n * **形态二分**（沿用 shape-type / view-export / curve-sketch 的既定口径）：\n * - 返回 Shape 的两项（`liftCurve2d` / `commonCells`）走 `defineOp` + `engines:['occt']`，\n *   由 dispatchPath 门控（D11-4，brep_mock 豁免走 D11-3）；\n * - 其余返回标量 / Vec3 / 对象 / Shape[] 的 11 项走**普通函数** +\n *   `assertEngineFor('<name>', ['occt'])`：defineOp 的 brep 包装\n *   （define-op.ts#wrapBrepOne）把返回值一律收养为 Shape，装不下这些形态。普通函数\n *   形态的 op 由覆盖率扫描器 `scan-occt-op-coverage.ts` 的 PLAN_C2_EXTRA 计入 C2。\n *\n * **GOTCHA（上游载体差异，务必读）**：occt-wasm 的 `Vec3` 是 **`{x, y, z}` 对象接口**\n * （dist/types.d.ts:52-56），而 faijs 脚本面的 `Vec3` 是 **`[x, y, z]` 数组**\n * （mesh/types，见 api/geom.ts 里 `normal = [n.x, n.y, n.z]` 的同款转接）。因此本文件\n * 在**边界处做双向转换**，不外泄载体差异：入参 `[x,y,z]` → `{x,y,z}`，返回值\n * `{x,y,z}` → `[x,y,z]`。漏掉这层转换时症状是原生方法读到 `undefined` 坐标\n * （`{}.x` 静默取不到 → 落在原点）而非显式报错，故每条都配了返回值数组的测试。\n *\n * `iterShapes` 返回的子形状既有实体/面也有边/wire ⇒ 按 `getShapeType` 判定收养形态\n * （vertex/edge/wire → `fromBrepCurve`，其余 → `fromBrep`），避免把 1D 产物谎报成实体。\n *\n * §9.5 降级路径（记录在案）：一旦 brepkit 把这些测量/查询接进 L1 契约且两侧适配器\n * 同时落地，普通函数删掉 assertEngineFor 改走 getBrepApi()、defineOp 删掉 engines\n * 声明，对应方法即从 C2 转入 C1。\n */\n\nimport type { Shape, Vec3 } from '../../mesh/types'\nimport type { BrepHandle } from '../../brep/engine/types'\nimport type { PointClassification } from 'occt-wasm'\nimport { solidToShape } from '../../brep/brep-ops'\nimport { getBrepApi } from '../../brep/handle-bridge'\nimport { brepOf, fromBrep, fromBrepCurve } from '../../shape'\nimport { defineOp } from '../../sdk'\nimport type { Provenance } from '../../topology/naming/lineage'\nimport { getOcctKernel } from '../../occt-kernel/occtKernel'\nimport { assertEngineFor } from '../internal/l3-bridge'\n\n/** 子形状类型（与 occt 原生同名形参的字面量联合一致）。 */\nexport type SubShapeType = 'vertex' | 'edge' | 'wire' | 'face' | 'shell' | 'solid'\n\nconst SUB_SHAPE_TYPES: readonly SubShapeType[] = ['vertex', 'edge', 'wire', 'face', 'shell', 'solid']\n\n/** 输入 Shape → 内核句柄（无 BREP 槽报错）。 */\nfunction occtHandleOf(shape: Shape, op: string): BrepHandle {\n  const h = brepOf(shape) as BrepHandle | undefined\n  if (!h) {\n    throw new Error(`E_SHAPE_TYPE_NO_BREP: ${op} requires a BREP handle (mesh-only shape has none)`)\n  }\n  return h\n}\n\n/** 脚本面 `[x,y,z]` → 原生 `{x,y,z}`（见头注 GOTCHA）。 */\nfunction toNativeVec3(v: Vec3, op: string, which: string): { x: number; y: number; z: number } {\n  if (!Array.isArray(v) || v.length !== 3 || v.some((n) => typeof n !== 'number' || !Number.isFinite(n))) {\n    throw new Error(`E_${op.toUpperCase()}_BAD_${which.toUpperCase()}: ${which} must be a finite [x,y,z]`)\n  }\n  return { x: v[0], y: v[1], z: v[2] }\n}\n\n/** 原生 `{x,y,z}` → 脚本面 `[x,y,z]`（同上）。 */\nfunction fromNativeVec3(v: { x: number; y: number; z: number }): Vec3 {\n  return [v.x, v.y, v.z]\n}\n\n/** 句柄 → Shape：1D（vertex/edge/wire）登记为 kind:'curve'，其余为实体/面。 */\nfunction adopt(handle: BrepHandle): Shape {\n  const mesh = solidToShape(getBrepApi(), handle)\n  const t = getOcctKernel().getShapeType(handle as never)\n  if (t === 'vertex' || t === 'edge' || t === 'wire') {\n    return fromBrepCurve(mesh, { solid: handle })\n  }\n  return fromBrep(mesh, { solid: handle })\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// 标量/数据型查询（普通函数形态 + assertEngineFor）\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * 点是否在实体内（含边界，带容差）。\n * @group 查询\n * @inputs 1\n * @async false\n * @qual ok\n * @name containsPoint\n * @note 平台 op：仅 occt 引擎（原生 containsPoint，L1 契约无对应成员）。\n *       非 occt 引擎执行前报 E_BREP_UNSUPPORTED。坐标收脚本面的 [x,y,z]。\n * @returns boolean 点是否在形状内。\n * @param shape - 被检测的形状（语义上是实体/壳）。type:Shape required:true\n * @param point - 待判定点 [x,y,z]。type:Vec3 required:true\n * @param tolerance - 判定容差（模型单位）。type:number required:false\n * @example\n * const inside = cad.containsPoint(box, [1, 1, 1])\n */\nexport function containsPoint(shape: Shape, point: Vec3, tolerance?: number): boolean {\n  assertEngineFor('containsPoint', ['occt'])\n  const p = toNativeVec3(point, 'containsPoint', 'point')\n  return getOcctKernel().containsPoint(occtHandleOf(shape, 'containsPoint') as never, p, tolerance)\n}\n\n/**\n * 两形状之间的最短距离。\n * @group 查询\n * @inputs 2\n * @async false\n * @qual ok\n * @name distanceBetween\n * @note 平台 op：仅 occt 引擎（原生 distanceBetween，BRepExtrema_DistShapeShape）。\n *       非 occt 引擎执行前报 E_BREP_UNSUPPORTED。\n * @returns number 最短距离（模型单位；相交为 0）。\n * @param a - 第一个形状。type:Shape required:true\n * @param b - 第二个形状。type:Shape required:true\n * @example\n * const gap = cad.distanceBetween(box1, box2)\n */\nexport function distanceBetween(a: Shape, b: Shape): number {\n  assertEngineFor('distanceBetween', ['occt'])\n  const ha = occtHandleOf(a, 'distanceBetween')\n  const hb = occtHandleOf(b, 'distanceBetween')\n  return getOcctKernel().distanceBetween(ha as never, hb as never)\n}\n\n/**\n * 绕质心的惯性矩阵（row-major 3×3，长度 9；对称：[1]==[3]、[2]==[6]、[5]==[7]）。\n * @group 查询\n * @inputs 1\n * @async false\n * @qual ok\n * @name inertia\n * @note 平台 op：仅 occt 引擎（原生 getInertia）。非 occt 引擎执行前报\n *       E_BREP_UNSUPPORTED。\n * @returns number[] row-major 3×3 惯性矩阵。\n * @param shape - 被测量的形状。type:Shape required:true\n * @example\n * const m = cad.inertia(box)\n */\nexport function inertia(shape: Shape): number[] {\n  assertEngineFor('inertia', ['occt'])\n  return getOcctKernel().getInertia(occtHandleOf(shape, 'inertia') as never)\n}\n\n/**\n * 线性质心（按边长加权的质心；wire/edge 用它与体积质心区分）。\n * @group 查询\n * @inputs 1\n * @async false\n * @qual ok\n * @name linearCenterOfMass\n * @note 平台 op：仅 occt 引擎（原生 getLinearCenterOfMass）。非 occt 引擎执行前报\n *       E_BREP_UNSUPPORTED。返回脚本面的 [x,y,z]（非 occt 的 {x,y,z} 对象）。\n * @returns Vec3 线性质心坐标 [x,y,z]。\n * @param shape - 被测量的形状。type:Shape required:true\n * @example\n * const c = cad.linearCenterOfMass(wire)\n */\nexport function linearCenterOfMass(shape: Shape): Vec3 {\n  assertEngineFor('linearCenterOfMass', ['occt'])\n  return fromNativeVec3(getOcctKernel().getLinearCenterOfMass(occtHandleOf(shape, 'linearCenterOfMass') as never))\n}\n\n/**\n * 点到边的最近点（含该处切向与参数）。\n * @group 查询\n * @inputs 2\n * @async false\n * @qual ok\n * @name projectPointOnEdge\n * @note 平台 op：仅 occt 引擎（原生 projectPointOnEdge）。非 occt 引擎执行前报\n *       E_BREP_UNSUPPORTED。返回体里的 point/tangent 是脚本面的 [x,y,z]。\n * @returns object { point: Vec3; tangent: Vec3; parameter: number }。\n * @param edge - 被投影的边。type:Shape required:true\n * @param point - 待投影点 [x,y,z]。type:Vec3 required:true\n * @example\n * const hit = cad.projectPointOnEdge(e, [3, 4, 0])\n */\nexport function projectPointOnEdge(\n  edge: Shape,\n  point: Vec3,\n): { point: Vec3; tangent: Vec3; parameter: number } {\n  assertEngineFor('projectPointOnEdge', ['occt'])\n  const p = toNativeVec3(point, 'projectPointOnEdge', 'point')\n  const r = getOcctKernel().projectPointOnEdge(occtHandleOf(edge, 'projectPointOnEdge') as never, p)\n  return { point: fromNativeVec3(r.point), tangent: fromNativeVec3(r.tangent), parameter: r.parameter }\n}\n\n/**\n * 点到面的最近点（三维坐标）。\n * @group 查询\n * @inputs 2\n * @async false\n * @qual ok\n * @name projectPointOnFace\n * @note 平台 op：仅 occt 引擎（原生 projectPointOnFace）。非 occt 引擎执行前报\n *       E_BREP_UNSUPPORTED。要 UV 参数用 `uvFromPoint`。\n * @returns Vec3 面上的最近点 [x,y,z]。\n * @param face - 被投影的面。type:Shape required:true\n * @param point - 待投影点 [x,y,z]。type:Vec3 required:true\n * @example\n * const p = cad.projectPointOnFace(f, [3, 4, 5])\n */\nexport function projectPointOnFace(face: Shape, point: Vec3): Vec3 {\n  assertEngineFor('projectPointOnFace', ['occt'])\n  const p = toNativeVec3(point, 'projectPointOnFace', 'point')\n  return fromNativeVec3(getOcctKernel().projectPointOnFace(occtHandleOf(face, 'projectPointOnFace') as never, p))\n}\n\n/**\n * UV 点相对面边界的分类（BRepClass_FaceClassifier）。\n * @group 查询\n * @inputs 3\n * @async false\n * @qual ok\n * @name classifyPointOnFace\n * @note 平台 op：仅 occt 引擎（原生 classifyPointOnFace）。非 occt 引擎执行前报\n *       E_BREP_UNSUPPORTED。\n * @returns string 'in' | 'on' | 'out'。\n * @param face - 被判定的面。type:Shape required:true\n * @param u - U 参数。type:number required:true\n * @param v - V 参数。type:number required:true\n * @example\n * const cls = cad.classifyPointOnFace(f, 0.5, 0.5)\n */\nexport function classifyPointOnFace(face: Shape, u: number, v: number): PointClassification {\n  assertEngineFor('classifyPointOnFace', ['occt'])\n  if (typeof u !== 'number' || !Number.isFinite(u) || typeof v !== 'number' || !Number.isFinite(v)) {\n    throw new Error('E_CLASSIFYPOINTONFACE_BAD_UV: u and v must be finite numbers')\n  }\n  return getOcctKernel().classifyPointOnFace(occtHandleOf(face, 'classifyPointOnFace') as never, u, v)\n}\n\n/**\n * 三维点 → 面的 UV 参数。\n * @group 查询\n * @inputs 2\n * @async false\n * @qual ok\n * @name uvFromPoint\n * @note 平台 op：仅 occt 引擎（原生 uvFromPoint）。非 occt 引擎执行前报\n *       E_BREP_UNSUPPORTED。\n * @returns object { u: number; v: number }。\n * @param face - 目标面。type:Shape required:true\n * @param point - 三维点 [x,y,z]。type:Vec3 required:true\n * @example\n * const { u, v } = cad.uvFromPoint(f, [1, 2, 0])\n */\nexport function uvFromPoint(face: Shape, point: Vec3): { u: number; v: number } {\n  assertEngineFor('uvFromPoint', ['occt'])\n  const p = toNativeVec3(point, 'uvFromPoint', 'point')\n  return getOcctKernel().uvFromPoint(occtHandleOf(face, 'uvFromPoint') as never, p)\n}\n\n/**\n * 顶点坐标。\n * @group 查询\n * @inputs 1\n * @async false\n * @qual ok\n * @name vertexPosition\n * @note 平台 op：仅 occt 引擎（原生 vertexPosition）。非 occt 引擎执行前报\n *       E_BREP_UNSUPPORTED。返回脚本面的 [x,y,z]。\n * @returns Vec3 顶点坐标 [x,y,z]。\n * @param vertex - 顶点形状。type:Shape required:true\n * @example\n * const p = cad.vertexPosition(v)\n */\nexport function vertexPosition(vertex: Shape): Vec3 {\n  assertEngineFor('vertexPosition', ['occt'])\n  return fromNativeVec3(getOcctKernel().vertexPosition(occtHandleOf(vertex, 'vertexPosition') as never))\n}\n\n/**\n * 子形状计数（不物化逐个子形状句柄）。\n * @group 查询\n * @inputs 2\n * @async false\n * @qual ok\n * @name subShapeCount\n * @note 平台 op：仅 occt 引擎（原生 subShapeCount；L1 契约只有 getSubShapes，\n *       计数能力是 occt 独有）。非 occt 引擎执行前报 E_BREP_UNSUPPORTED。\n * @returns number 该类子形状的个数。\n * @param shape - 被统计的形状。type:Shape required:true\n * @param type - 子形状类型（vertex/edge/wire/face/shell/solid）。type:string required:true\n * @example\n * const n = cad.subShapeCount(box, 'face')\n */\nexport function subShapeCount(shape: Shape, type: SubShapeType): number {\n  assertEngineFor('subShapeCount', ['occt'])\n  if (!SUB_SHAPE_TYPES.includes(type)) {\n    throw new Error(\n      `E_SUBSHAPECOUNT_BAD_TYPE: type must be one of ${SUB_SHAPE_TYPES.join('/')} (got ${String(type)})`,\n    )\n  }\n  return getOcctKernel().subShapeCount(occtHandleOf(shape, 'subShapeCount') as never, type)\n}\n\n/**\n * 遍历全部子形状（递归展平，返回 Shape[]）。\n * @group 查询\n * @inputs 1\n * @async false\n * @qual ok\n * @name iterShapes\n * @note 平台 op：仅 occt 引擎（原生 iterShapes；L1 契约的 getSubShapes 只按类型单层取）。\n *       非 occt 引擎执行前报 E_BREP_UNSUPPORTED。\n *       返回 Shape 数组（非单个 Shape）⇒ 普通函数形态，与 shape-type 同口径。\n * @returns Shape[] 子形状列表（vertex/edge/wire 形态为 curve）。\n * @param shape - 被遍历的形状。type:Shape required:true\n * @example\n * const subs = cad.iterShapes(box)\n */\nexport function iterShapes(shape: Shape): Shape[] {\n  assertEngineFor('iterShapes', ['occt'])\n  const handles = getOcctKernel().iterShapes(occtHandleOf(shape, 'iterShapes') as never)\n  return (handles as unknown as BrepHandle[]).map(adopt)\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// liftCurve2d — 2D 点集 → 平面 wire（返回 Shape ⇒ defineOp）\n// ─────────────────────────────────────────────────────────────────────────────\n\n/** BREP 路径：occt 原生 liftCurve2dToPlane（脚本面收 [x,y]，此处转成 {x,y}）。 */\nfunction liftCurve2dBrep(\n  points2d: Array<[number, number]>,\n  planeOrigin: Vec3,\n  planeZ: Vec3,\n  planeX: Vec3,\n): Shape {\n  if (!Array.isArray(points2d) || points2d.length < 2) {\n    throw new Error('E_LIFTCURVE2D_TOO_FEW_POINTS: liftCurve2d requires at least 2 points')\n  }\n  const pts = points2d.map((p, i) => {\n    if (!Array.isArray(p) || p.length !== 2 || p.some((n) => typeof n !== 'number' || !Number.isFinite(n))) {\n      throw new Error(`E_LIFTCURVE2D_BAD_POINT: points2d[${i}] must be a finite [x,y]`)\n    }\n    return { x: p[0], y: p[1] }\n  })\n  const o = toNativeVec3(planeOrigin, 'liftCurve2d', 'planeOrigin')\n  const z = toNativeVec3(planeZ, 'liftCurve2d', 'planeZ')\n  const x = toNativeVec3(planeX, 'liftCurve2d', 'planeX')\n  const handle = getOcctKernel().liftCurve2dToPlane(pts, o, z, x) as unknown as BrepHandle\n  return fromBrepCurve(solidToShape(getBrepApi(), handle), { solid: handle })\n}\n\n/**\n * 把 2D 点集抬升到指定平面上，构造平面 wire。\n * @group 创建\n * @inputs 4\n * @async false\n * @qual ok\n * @name liftCurve2d\n * @note 平台 op：仅 occt 引擎（原生 liftCurve2dToPlane，L1 契约无对应成员）。\n *       非 occt 引擎执行前报错；brep_mock 不拦截。\n *       坐标收 `[x,y]` 数对（脚本面习惯），内部转成上游的 `{x,y}` 对象；\n *       planeZ/planeX 须非零且互不平行。\n * @returns Shape 平面上的 wire（登记为 kind:'curve'）。\n * @param points2d - 2D 点集 [[x,y], …]（≥2 点）。type:Array required:true\n * @param planeOrigin - 平面原点 [x,y,z]。type:Vec3 required:true\n * @param planeZ - 平面法向 [x,y,z]（非零）。type:Vec3 required:true\n * @param planeX - 平面内 X 轴方向 [x,y,z]（非零）。type:Vec3 required:true\n * @example\n * const w = cad.liftCurve2d([[0,0],[10,0],[10,5]], [0,0,0], [0,0,1], [1,0,0])\n */\nexport const liftCurve2d = defineOp({\n  name: 'liftCurve2d',\n  brep(points2d: Array<[number, number]>, planeOrigin: Vec3, planeZ: Vec3, planeX: Vec3) {\n    return liftCurve2dBrep(points2d, planeOrigin, planeZ, planeX)\n  },\n  engines: ['occt'],\n  naming: {\n    kind: 'unmodeled',\n    reason: '1D wire lifted from 2D points has no face role vocabulary',\n  } as Provenance,\n})\n\n// ─────────────────────────────────────────────────────────────────────────────\n// commonCells — ≥2 输入的重叠区域（干涉/通用熔合胞元，返回 Shape ⇒ defineOp）\n// ─────────────────────────────────────────────────────────────────────────────\n\n/** BREP 路径：occt 原生 intersectionCells（≥2 输入，不足则报错）。 */\nfunction commonCellsBrep(shapes: Shape[]): Shape {\n  if (!Array.isArray(shapes) || shapes.length < 2) {\n    throw new Error('E_COMMONCELLS_TOO_FEW: commonCells requires at least 2 shapes')\n  }\n  const handles = shapes.map((s, i) => {\n    if (!s) throw new Error(`E_COMMONCELLS_MISSING_ARG: shapes[${i}] is empty`)\n    return occtHandleOf(s, 'commonCells')\n  })\n  const handle = getOcctKernel().intersectionCells(handles as never[]) as unknown as BrepHandle\n  return fromBrep(solidToShape(getBrepApi(), handle), { solid: handle })\n}\n\n/**\n * 求多个形状的重叠区域（通用熔合胞元，常用于干涉检查）。\n * @group 布尔\n * @inputs 1\n * @async false\n * @qual ok\n * @name commonCells\n * @note 平台 op：仅 occt 引擎（原生 intersectionCells；与 `intersect` 的区别：\n *       后者是两形状求交，本 op 支持 ≥2 输入并返回全部重叠胞元）。\n *       非 occt 引擎执行前报错；brep_mock 不拦截。\n * @returns Shape 重叠区域（无重叠时为空复合体）。\n * @param shapes - 输入形状数组（≥2）。type:Shape[] required:true\n * @example\n * const overlap = cad.commonCells([boxA, boxB, boxC])\n */\nexport const commonCells = defineOp({\n  name: 'commonCells',\n  brep(shapes: Shape[]) {\n    return commonCellsBrep(shapes)\n  },\n  engines: ['occt'],\n  naming: {\n    // 原生 intersectionCells 只回 Shape（无 EvolutionData），\n    // 无法给出新面的来源词汇 —— 方案 §4.2「词汇未定义就用 unmodeled + reason」。\n    kind: 'unmodeled',\n    reason: 'intersectionCells returns a bare shape with no face evolution data',\n  } as Provenance,\n})\n"]}

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

@@ -9,9 +9,9 @@
  *   - volume(shape)       → 体积（getVolume）；
  *   - centerOfMass(shape) → 质心坐标（getCenterOfMass，BrepVec3 {x,y,z}）。
  *
- * 与 vendored 测量面（api/generated/measurement.ts 的 measureArea / measureLength）
- * 的区别：那些 op 经 l3-bridge 借入层 + vendored 函数绑定 occt-wasm，整体 occt-only
- * （Phase 6 已声明 engines: ['occt']）；本模块直接调 L1 方法，无借入层、无引擎绑定，
+ * 与旧测量面（api/generated/measurement.ts 的 measureArea / measureLength）
+ * 的区别：那些 op 挂在生成投影面上，整体 occt-only（Phase 6 已声明 engines: ['occt']）；
+ * 本模块直接调 L1 方法，不经来源实现、无引擎绑定，
  * 是脚本面的中立测量入口。返回纯数字，不产出 Shape、不消费 shape。
  *
  * 三源一致（B1）：本模块经 arg-spec 的 `scriptFace: true` 条目（kind 'faijs'）登记，

package/dist/api/measurement/index.js

@@ -9,9 +9,9 @@
  *   - volume(shape)       → 体积（getVolume）；
  *   - centerOfMass(shape) → 质心坐标（getCenterOfMass，BrepVec3 {x,y,z}）。
  *
- * 与 vendored 测量面（api/generated/measurement.ts 的 measureArea / measureLength）
- * 的区别：那些 op 经 l3-bridge 借入层 + vendored 函数绑定 occt-wasm，整体 occt-only
- * （Phase 6 已声明 engines: ['occt']）；本模块直接调 L1 方法，无借入层、无引擎绑定，
+ * 与旧测量面（api/generated/measurement.ts 的 measureArea / measureLength）
+ * 的区别：那些 op 挂在生成投影面上，整体 occt-only（Phase 6 已声明 engines: ['occt']）；
+ * 本模块直接调 L1 方法，不经来源实现、无引擎绑定，
  * 是脚本面的中立测量入口。返回纯数字，不产出 Shape、不消费 shape。
  *
  * 三源一致（B1）：本模块经 arg-spec 的 `scriptFace: true` 条目（kind 'faijs'）登记，

package/dist/api/measurement/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/measurement/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAgBjD;;;;;;;;;;;;GAYG;AACH,SAAS,wBAAwB,CAAC,KAAY,EAAE,EAAU;IACxD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAA2B,CAAA;IACpD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;IAC9D,CAAC;IACD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAA2B,CAAA;IACzD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,SAAyC,CAAA;QAC9E,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,uBAAuB,EAAE,qEAAqE;gBAC9F,mCAAmC,CACpC,CAAA;QACH,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;IAChE,CAAC;IACD,MAAM,IAAI,KAAK,CACb,uBAAuB,EAAE,8EAA8E;QACvG,iEAAiE,CAClE,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,KAAY;IACrC,MAAM,CAAC,GAAG,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACjD,OAAO,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAC1C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAY;IACvC,MAAM,CAAC,GAAG,wBAAwB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IACnD,OAAO,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAY;IACvC,MAAM,CAAC,GAAG,wBAAwB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IACnD,OAAO,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAY;IAC7C,MAAM,CAAC,GAAG,wBAAwB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAA;IACzD,OAAO,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAC3C,CAAC","sourcesContent":["/**\n * measurement — cad 脚本面测量 op（Phase 7，narrowing plan §Phase 7 / Q4）\n *\n * 补齐 §1.5 的反向缺口：BrepEngineApi 的 L1 测量面（getSurfaceArea / getLength）\n * 在脚本面此前没有任何入口——脚本里量不出面积、长度。本模块提供两个**中立**测量\n * op（走 getBrepApi() 的 L1 契约面，occt / brepkit / 小程序端同一份 .fai.js 都可跑）：\n *   - area(shape)         → 表面积（getSurfaceArea）；\n *   - length(shape)       → 边长/线长（getLength）；\n *   - volume(shape)       → 体积（getVolume）；\n *   - centerOfMass(shape) → 质心坐标（getCenterOfMass，BrepVec3 {x,y,z}）。\n *\n * 与 vendored 测量面（api/generated/measurement.ts 的 measureArea / measureLength）\n * 的区别：那些 op 经 l3-bridge 借入层 + vendored 函数绑定 occt-wasm，整体 occt-only\n * （Phase 6 已声明 engines: ['occt']）；本模块直接调 L1 方法，无借入层、无引擎绑定，\n * 是脚本面的中立测量入口。返回纯数字，不产出 Shape、不消费 shape。\n *\n * 三源一致（B1）：本模块经 arg-spec 的 `scriptFace: true` 条目（kind 'faijs'）登记，\n * 由 gen-l3-surface.ts re-export 进 api/generated/script-face.ts / script-face-manifest.ts，\n * gen-symbol-table.ts 同步 check() 符号表——cad 命名空间、manifest、符号表三处同源。\n */\n\nimport { brepOf, meshSolidOf } from '../../shape'\nimport { getBrepApi } from '../../brep/handle-bridge'\nimport { getBackends } from '../../runtime-state'\nimport type { MeshSolidBackend } from '../../brep/mesh-solid'\nimport type { BrepEngineApi } from '../../brep/engine/primitives'\nimport type { Shape } from '../../mesh/types'\nimport type { BrepHandle, BrepVec3 } from '../../brep/engine/types'\n\n/** 量测目标：句柄 + 读它的内核（精度链用 BREP 引擎，网格链用网格后端）。 */\ninterface MeasurementTarget {\n  /** 读该句柄的 L1 契约面。 */\n  readonly kernel: BrepEngineApi\n  /** 被量测的句柄。 */\n  readonly handle: BrepHandle\n  /** 量测所在链（`mesh` = 网格零件，量的是面片几何）。 */\n  readonly chain: 'brep' | 'mesh'\n}\n\n/**\n * 取量测目标：精度链句柄优先，其次是网格零件句柄；两者都没有 → 显式报错。\n *\n * 网格零件（方案 2026-10-01 §4 Phase 4 / B4 批）走**网格后端**的 L1 内核。它的\n * 量测值是对**面片几何**的精确量（STL 的曲面本来就是离散的：立方体 1000 与解析值\n * 一致，圆柱侧面则是 32 个面片之和）——不是对原始设计的还原，也不是估算。所以\n * 这里如实量、如实说，不额外加\"近似\"折扣，也不静默返回 0。\n *\n * @param shape - the shape being measured.\n * @param op - the measurement op name (error messages).\n * @returns the handle to measure plus the kernel that can read it.\n * @throws {Error} `E_MEASUREMENT_NO_HANDLE` when the shape carries neither chain handle.\n */\nfunction requireMeasurementTarget(shape: Shape, op: string): MeasurementTarget {\n  const brep = brepOf(shape) as BrepHandle | undefined\n  if (brep !== undefined) {\n    return { kernel: getBrepApi(), handle: brep, chain: 'brep' }\n  }\n  const mesh = meshSolidOf(shape) as BrepHandle | undefined\n  if (mesh !== undefined) {\n    const backend = getBackends().kernel.meshSolid as MeshSolidBackend | undefined\n    if (!backend) {\n      throw new Error(\n        `[faijs/measurement] ${op}: E_MESH_SOLID_UNSUPPORTED: this shape is a mesh solid but no mesh ` +\n        'backend is assembled in this host',\n      )\n    }\n    return { kernel: backend.kernel, handle: mesh, chain: 'mesh' }\n  }\n  throw new Error(\n    `[faijs/measurement] ${op}: E_MEASUREMENT_NO_HANDLE: measurement requires a shape with a chain handle ` +\n    '(a bare mesh has neither a BREP handle nor a mesh solid handle)',\n  )\n}\n\n/**\n * 测量形状的表面积（L1 getSurfaceArea，两引擎同口径）。\n *\n * @param shape - 被测量的形状（Face / Shape3D / compound / 网格零件）。\n * @returns 表面积（mm²；网格零件按面片几何计）。\n */\nexport async function area(shape: Shape): Promise<number> {\n  const t = requireMeasurementTarget(shape, 'area')\n  return t.kernel.getSurfaceArea(t.handle)\n}\n\n/**\n * 测量形状的边长/线长（L1 getLength，两引擎同口径）。\n *\n * 口径 = **shape 中所有唯一 edge 的弧长之和**：edge 取自身弧长，wire 取其边之和，\n * face 取边界边之和，solid 取全部边之和，compound 取各子实体之和。两个 BREP 引擎\n * 在此口径下逐位一致（2026-10-02 归一化，见 occt / brepkit 适配器的 getLength）。\n *\n * @param shape - 被测量的形状（edge / wire / face / solid / compound）。\n * @returns 长度（mm）。\n */\nexport async function length(shape: Shape): Promise<number> {\n  const t = requireMeasurementTarget(shape, 'length')\n  return t.kernel.getLength(t.handle)\n}\n\n/**\n * 测量形状的体素体积（L1 getVolume，两引擎同口径）。\n *\n * @param shape - 被测量的形状（solid / compound；对 wire / face 内核按自身口径计，可能返回 0）。\n * @returns 体积（mm³；网格零件按面片几何计）。\n */\nexport async function volume(shape: Shape): Promise<number> {\n  const t = requireMeasurementTarget(shape, 'volume')\n  return t.kernel.getVolume(t.handle)\n}\n\n/**\n * 测量形状的质心（L1 getCenterOfMass，两引擎同口径）。\n *\n * @param shape - 被测量的形状（solid / compound / face / 网格零件）。\n * @returns 质心坐标（mm，BREP 中立形态 {x,y,z}）。\n */\nexport async function centerOfMass(shape: Shape): Promise<BrepVec3> {\n  const t = requireMeasurementTarget(shape, 'centerOfMass')\n  return t.kernel.getCenterOfMass(t.handle)\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/measurement/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAgBjD;;;;;;;;;;;;GAYG;AACH,SAAS,wBAAwB,CAAC,KAAY,EAAE,EAAU;IACxD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAA2B,CAAA;IACpD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;IAC9D,CAAC;IACD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAA2B,CAAA;IACzD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,SAAyC,CAAA;QAC9E,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,uBAAuB,EAAE,qEAAqE;gBAC9F,mCAAmC,CACpC,CAAA;QACH,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;IAChE,CAAC;IACD,MAAM,IAAI,KAAK,CACb,uBAAuB,EAAE,8EAA8E;QACvG,iEAAiE,CAClE,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,KAAY;IACrC,MAAM,CAAC,GAAG,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACjD,OAAO,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAC1C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAY;IACvC,MAAM,CAAC,GAAG,wBAAwB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IACnD,OAAO,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAY;IACvC,MAAM,CAAC,GAAG,wBAAwB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IACnD,OAAO,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAY;IAC7C,MAAM,CAAC,GAAG,wBAAwB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAA;IACzD,OAAO,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAC3C,CAAC","sourcesContent":["/**\n * measurement — cad 脚本面测量 op（Phase 7，narrowing plan §Phase 7 / Q4）\n *\n * 补齐 §1.5 的反向缺口：BrepEngineApi 的 L1 测量面（getSurfaceArea / getLength）\n * 在脚本面此前没有任何入口——脚本里量不出面积、长度。本模块提供两个**中立**测量\n * op（走 getBrepApi() 的 L1 契约面，occt / brepkit / 小程序端同一份 .fai.js 都可跑）：\n *   - area(shape)         → 表面积（getSurfaceArea）；\n *   - length(shape)       → 边长/线长（getLength）；\n *   - volume(shape)       → 体积（getVolume）；\n *   - centerOfMass(shape) → 质心坐标（getCenterOfMass，BrepVec3 {x,y,z}）。\n *\n * 与旧测量面（api/generated/measurement.ts 的 measureArea / measureLength）\n * 的区别：那些 op 挂在生成投影面上，整体 occt-only（Phase 6 已声明 engines: ['occt']）；\n * 本模块直接调 L1 方法，不经来源实现、无引擎绑定，\n * 是脚本面的中立测量入口。返回纯数字，不产出 Shape、不消费 shape。\n *\n * 三源一致（B1）：本模块经 arg-spec 的 `scriptFace: true` 条目（kind 'faijs'）登记，\n * 由 gen-l3-surface.ts re-export 进 api/generated/script-face.ts / script-face-manifest.ts，\n * gen-symbol-table.ts 同步 check() 符号表——cad 命名空间、manifest、符号表三处同源。\n */\n\nimport { brepOf, meshSolidOf } from '../../shape'\nimport { getBrepApi } from '../../brep/handle-bridge'\nimport { getBackends } from '../../runtime-state'\nimport type { MeshSolidBackend } from '../../brep/mesh-solid'\nimport type { BrepEngineApi } from '../../brep/engine/primitives'\nimport type { Shape } from '../../mesh/types'\nimport type { BrepHandle, BrepVec3 } from '../../brep/engine/types'\n\n/** 量测目标：句柄 + 读它的内核（精度链用 BREP 引擎，网格链用网格后端）。 */\ninterface MeasurementTarget {\n  /** 读该句柄的 L1 契约面。 */\n  readonly kernel: BrepEngineApi\n  /** 被量测的句柄。 */\n  readonly handle: BrepHandle\n  /** 量测所在链（`mesh` = 网格零件，量的是面片几何）。 */\n  readonly chain: 'brep' | 'mesh'\n}\n\n/**\n * 取量测目标：精度链句柄优先，其次是网格零件句柄；两者都没有 → 显式报错。\n *\n * 网格零件（方案 2026-10-01 §4 Phase 4 / B4 批）走**网格后端**的 L1 内核。它的\n * 量测值是对**面片几何**的精确量（STL 的曲面本来就是离散的：立方体 1000 与解析值\n * 一致，圆柱侧面则是 32 个面片之和）——不是对原始设计的还原，也不是估算。所以\n * 这里如实量、如实说，不额外加\"近似\"折扣，也不静默返回 0。\n *\n * @param shape - the shape being measured.\n * @param op - the measurement op name (error messages).\n * @returns the handle to measure plus the kernel that can read it.\n * @throws {Error} `E_MEASUREMENT_NO_HANDLE` when the shape carries neither chain handle.\n */\nfunction requireMeasurementTarget(shape: Shape, op: string): MeasurementTarget {\n  const brep = brepOf(shape) as BrepHandle | undefined\n  if (brep !== undefined) {\n    return { kernel: getBrepApi(), handle: brep, chain: 'brep' }\n  }\n  const mesh = meshSolidOf(shape) as BrepHandle | undefined\n  if (mesh !== undefined) {\n    const backend = getBackends().kernel.meshSolid as MeshSolidBackend | undefined\n    if (!backend) {\n      throw new Error(\n        `[faijs/measurement] ${op}: E_MESH_SOLID_UNSUPPORTED: this shape is a mesh solid but no mesh ` +\n        'backend is assembled in this host',\n      )\n    }\n    return { kernel: backend.kernel, handle: mesh, chain: 'mesh' }\n  }\n  throw new Error(\n    `[faijs/measurement] ${op}: E_MEASUREMENT_NO_HANDLE: measurement requires a shape with a chain handle ` +\n    '(a bare mesh has neither a BREP handle nor a mesh solid handle)',\n  )\n}\n\n/**\n * 测量形状的表面积（L1 getSurfaceArea，两引擎同口径）。\n *\n * @param shape - 被测量的形状（Face / Shape3D / compound / 网格零件）。\n * @returns 表面积（mm²；网格零件按面片几何计）。\n */\nexport async function area(shape: Shape): Promise<number> {\n  const t = requireMeasurementTarget(shape, 'area')\n  return t.kernel.getSurfaceArea(t.handle)\n}\n\n/**\n * 测量形状的边长/线长（L1 getLength，两引擎同口径）。\n *\n * 口径 = **shape 中所有唯一 edge 的弧长之和**：edge 取自身弧长，wire 取其边之和，\n * face 取边界边之和，solid 取全部边之和，compound 取各子实体之和。两个 BREP 引擎\n * 在此口径下逐位一致（2026-10-02 归一化，见 occt / brepkit 适配器的 getLength）。\n *\n * @param shape - 被测量的形状（edge / wire / face / solid / compound）。\n * @returns 长度（mm）。\n */\nexport async function length(shape: Shape): Promise<number> {\n  const t = requireMeasurementTarget(shape, 'length')\n  return t.kernel.getLength(t.handle)\n}\n\n/**\n * 测量形状的体素体积（L1 getVolume，两引擎同口径）。\n *\n * @param shape - 被测量的形状（solid / compound；对 wire / face 内核按自身口径计，可能返回 0）。\n * @returns 体积（mm³；网格零件按面片几何计）。\n */\nexport async function volume(shape: Shape): Promise<number> {\n  const t = requireMeasurementTarget(shape, 'volume')\n  return t.kernel.getVolume(t.handle)\n}\n\n/**\n * 测量形状的质心（L1 getCenterOfMass，两引擎同口径）。\n *\n * @param shape - 被测量的形状（solid / compound / face / 网格零件）。\n * @returns 质心坐标（mm，BREP 中立形态 {x,y,z}）。\n */\nexport async function centerOfMass(shape: Shape): Promise<BrepVec3> {\n  const t = requireMeasurementTarget(shape, 'centerOfMass')\n  return t.kernel.getCenterOfMass(t.handle)\n}\n"]}

package/dist/api/meta.d.ts

@@ -1,8 +1,6 @@
 /**
  * api/meta — faijs 零件名称/描述/料号 与 整体文件元数据 权威类型与 Shape 方法
  *
- * 设计文档：docs/plans/2026-10-05-faijs-meta-name-note-api-design.md
- *
  * 定位（与 api/appearance.ts 同款方法模式）：
  * - 名称/描述设置**不是 op**（不进 defineOp/api-namespace/args-schema），是 Shape
  *   实例方法（`box1.setName('…')`，复用 `asm1.solve()` 的成员调用语句形态）。

package/dist/api/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/api/meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAI1C,gDAAgD;AAChD,MAAM,WAAW,SAAS;IACxB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAC9B,uCAAuC;IACvC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,8CAA8C;IAC9C,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,qCAAqC;IACrC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,sEAAsE;IACtE,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9C,+BAA+B;IAC/B,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,GAAG,SAAS,CAAA;CAC3C;AAID;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS,CAuBhF;AAID;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,gBAAgB,CA2BxE"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/api/meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAI1C,gDAAgD;AAChD,MAAM,WAAW,SAAS;IACxB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAC9B,uCAAuC;IACvC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,8CAA8C;IAC9C,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,qCAAqC;IACrC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,sEAAsE;IACtE,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9C,+BAA+B;IAC/B,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,GAAG,SAAS,CAAA;CAC3C;AAID;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS,CAuBhF;AAID;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,gBAAgB,CA2BxE"}

package/dist/api/meta.js

@@ -1,8 +1,6 @@
 /**
  * api/meta — faijs 零件名称/描述/料号 与 整体文件元数据 权威类型与 Shape 方法
  *
- * 设计文档：docs/plans/2026-10-05-faijs-meta-name-note-api-design.md
- *
  * 定位（与 api/appearance.ts 同款方法模式）：
  * - 名称/描述设置**不是 op**（不进 defineOp/api-namespace/args-schema），是 Shape
  *   实例方法（`box1.setName('…')`，复用 `asm1.solve()` 的成员调用语句形态）。

package/dist/api/meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/api/meta.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * api/meta — faijs 零件名称/描述/料号 与 整体文件元数据 权威类型与 Shape 方法\n *\n * 设计文档：docs/plans/2026-10-05-faijs-meta-name-note-api-design.md\n *\n * 定位（与 api/appearance.ts 同款方法模式）：\n * - 名称/描述设置**不是 op**（不进 defineOp/api-namespace/args-schema），是 Shape\n *   实例方法（`box1.setName('…')`，复用 `asm1.solve()` 的成员调用语句形态）。\n * - `ShapeMeta`（零件级）与 `FileMeta`（整体级）引擎无关、JSON 可序列化；\n *   `Shape.meta` 随 Shape 走 mesh/brep 双链路，编辑器/查看器只读字段。\n * - 本文件零依赖（不 import THREE / occt / store）；唯一 import 是 mesh/types\n *   的 `Shape` 类型（type-only），mesh/types 亦只 type-import 本文件的类型，\n *   两者为类型环、无运行时环（值依赖单向：shape.ts → api/meta.ts）。\n *\n * 命名约定（camelCase，faijs 全 TS/JS 生态）：\n * - 零件级：`name` / `description` / `partNumber` / `metadata`（键值）。\n * - 方法：`setName` / `setDescription` / `setPartNumber` / `setMetaField` /\n *   `setMeta` / `getMeta`。字段名与 3MF/STEP 规范一致（不用 note）。\n *   空串 = 清除：`setName('')` 删除 name（与「undefined 不覆盖」互补，用户可\n *   显式去掉继承来的名称）。\n */\n\nimport type { Shape } from '../mesh/types'\n\n// ── 类型 ──\n\n/** 零件级说明性元数据 —— 引擎无关、JSON 可序列化、随 Shape 走双链路。 */\nexport interface ShapeMeta {\n  /** 零件名：3MF `<object name>` / STEP `PRODUCT().name`。 */\n  name?: string\n  /** 描述：STEP `PRODUCT.description`；3MF 写 `faijs:description` metadatagroup。 */\n  description?: string\n  /** 料号：3MF `<object partnumber>`；STEP `PRODUCT_IDENTIFICATION` 或 UDA。 */\n  partNumber?: string\n  /**\n   * 自定义键值：3MF `<object><metadatagroup>`（vendor 前缀）；STEP UDA。\n   * 键为规范/厂商原始名（3MF 含命名空间前缀）；faijs 不解释值语义，\n   * 读入保留、写出回写。\n   */\n  metadata?: Record<string, string>\n}\n\n/**\n * 整体/文档级说明性元数据 —— 导入结果 / 导出选项，不挂 Shape。\n *\n * 不叫 `ModelMeta`：CAD 直觉里 \"model\" 偏单个零件（那是 `ShapeMeta` 的活）；\n * 本类型承载整个交换文件（3MF `<model>` / STEP P21 header）的元数据，故用\n * `FileMeta`。\n */\nexport interface FileMeta {\n  title?: string // 3MF Title / STEP FILE_NAME.name\n  description?: string      // 3MF Description / STEP FILE_DESCRIPTION.description\n  designer?: string         // 3MF Designer / STEP FILE_NAME.originator\n  author?: string           // STEP FILE_NAME.author（3MF 无对应；跨格式不互转）\n  organization?: string     // STEP FILE_NAME.organization（3MF 无对应）\n  copyright?: string        // 3MF Copyright（STEP 无标准位置）\n  licenseTerms?: string     // 3MF LicenseTerms（STEP 无标准位置）\n  rating?: string           // 3MF Rating（STEP 无标准位置）\n  creationDate?: string     // 3MF CreationDate / STEP FILE_NAME.timestamp\n  modificationDate?: string // 3MF ModificationDate（STEP 无标准位置）\n  application?: string      // 3MF Application / STEP FILE_NAME.preprocessor\n  /** 未知/厂商自定义 metadata 兜底（3MF model 级带前缀名；STEP header 其余字段）。 */\n  metadata?: Record<string, string>\n}\n\n/** Shape 元数据方法签名（运行时由 attachMetaMethods 挂载；纯数据判定不受影响）。 */\nexport interface ShapeMetaMethods {\n  /** 合并 meta：`{...cur, ...spec}`，spec 中 undefined 字段保留旧值。 */\n  setMeta(spec: ShapeMeta): this\n  /** 便捷：等价 setMeta({ name })（空串视为清除）。 */\n  setName(name: string): this\n  /** 便捷：等价 setMeta({ description })（空串视为清除）。 */\n  setDescription(description: string): this\n  /** 便捷：等价 setMeta({ partNumber }）。 */\n  setPartNumber(partNumber: string): this\n  /** 便捷：等价 setMeta({ metadata: {...cur.metadata, ...kv} })；值为空串的键删除。 */\n  setMetaField(key: string, value: string): this\n  /** 读取当前 meta（可能 undefined）。 */\n  getMeta(): Readonly<ShapeMeta> | undefined\n}\n\n// ── 合并 ──\n\n/**\n * 合并零件级元数据：spec 中 undefined 字段不覆盖旧值；空串覆盖为清除。\n * @param cur 当前 meta（可为 undefined）\n * @param spec 待合并字段（undefined 字段跳过；'' 显式清除）\n * @returns 合并后的 meta（新对象；cur 为 undefined 时仅含 spec 非空字段）\n */\nexport function mergeMeta(cur: ShapeMeta | undefined, spec: ShapeMeta): ShapeMeta {\n  const clean: Record<string, unknown> = {}\n  for (const [k, v] of Object.entries(spec)) {\n    if (v === undefined) continue\n    if (k === 'metadata' && v && typeof v === 'object') {\n      // 键值子合并：保留旧 metadata 的未覆盖键。\n      const base: Record<string, string> = { ...((cur?.metadata as Record<string, string> | undefined) ?? {}) }\n      for (const [kk, vv] of Object.entries(v as Record<string, string>)) {\n        if (vv === '') delete base[kk] // 空串清除该键\n        else base[kk] = vv\n      }\n      clean[k] = base\n      continue\n    }\n    if (v === '') clean[k] = undefined as unknown as string // 空串清除顶层字段\n    else clean[k] = v\n  }\n  const merged = { ...(cur ?? {}), ...clean } as ShapeMeta\n  // 清理合并后为 undefined 的顶层键（空串清除写入 undefined）。\n  for (const k of Object.keys(merged)) {\n    if ((merged as Record<string, unknown>)[k] === undefined) delete (merged as Record<string, unknown>)[k]\n  }\n  return merged\n}\n\n// ── Shape 方法挂载 ──\n\n/**\n * 给 Shape 实例挂载元数据方法（幂等：已有 setMeta 则跳过）。\n *\n * 所有产物构造点（solid/curve → fromBrep/fromMeshSolid/fromBrepCurve）统一\n * 调用本函数，保证 mesh/brep 双支路产物都可用 `box1.setName(...)`。\n * 方法**不序列化**（JSON 丢弃函数）；`meta` 字段随产物跨打印，编辑器/\n * 查看器只读字段即可，不依赖方法。\n * @param shape 产物 Shape 实例（solid/curve 产物）\n * @returns 挂载后的 shape（类型提升为 `Shape & ShapeMetaMethods`；同一实例原地挂载）\n */\nexport function attachMetaMethods(shape: Shape): Shape & ShapeMetaMethods {\n  const s = shape as Shape & ShapeMetaMethods\n  if (typeof s.setMeta === 'function') return s\n  s.setMeta = function setMeta(this: Shape & ShapeMetaMethods, spec: ShapeMeta) {\n    this.meta = mergeMeta(this.meta, spec)\n    return this\n  }\n  s.setName = function setName(this: Shape & ShapeMetaMethods, name: string) {\n    this.meta = mergeMeta(this.meta, { name })\n    return this\n  }\n  s.setDescription = function setDescription(this: Shape & ShapeMetaMethods, description: string) {\n    this.meta = mergeMeta(this.meta, { description })\n    return this\n  }\n  s.setPartNumber = function setPartNumber(this: Shape & ShapeMetaMethods, partNumber: string) {\n    this.meta = mergeMeta(this.meta, { partNumber })\n    return this\n  }\n  s.setMetaField = function setMetaField(this: Shape & ShapeMetaMethods, key: string, value: string) {\n    this.meta = mergeMeta(this.meta, { metadata: { [key]: value } })\n    return this\n  }\n  s.getMeta = function getMeta(this: Shape) {\n    return this.meta\n  }\n  return s\n}"]}
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/api/meta.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * api/meta — faijs 零件名称/描述/料号 与 整体文件元数据 权威类型与 Shape 方法\n *\n * 定位（与 api/appearance.ts 同款方法模式）：\n * - 名称/描述设置**不是 op**（不进 defineOp/api-namespace/args-schema），是 Shape\n *   实例方法（`box1.setName('…')`，复用 `asm1.solve()` 的成员调用语句形态）。\n * - `ShapeMeta`（零件级）与 `FileMeta`（整体级）引擎无关、JSON 可序列化；\n *   `Shape.meta` 随 Shape 走 mesh/brep 双链路，编辑器/查看器只读字段。\n * - 本文件零依赖（不 import THREE / occt / store）；唯一 import 是 mesh/types\n *   的 `Shape` 类型（type-only），mesh/types 亦只 type-import 本文件的类型，\n *   两者为类型环、无运行时环（值依赖单向：shape.ts → api/meta.ts）。\n *\n * 命名约定（camelCase，faijs 全 TS/JS 生态）：\n * - 零件级：`name` / `description` / `partNumber` / `metadata`（键值）。\n * - 方法：`setName` / `setDescription` / `setPartNumber` / `setMetaField` /\n *   `setMeta` / `getMeta`。字段名与 3MF/STEP 规范一致（不用 note）。\n *   空串 = 清除：`setName('')` 删除 name（与「undefined 不覆盖」互补，用户可\n *   显式去掉继承来的名称）。\n */\n\nimport type { Shape } from '../mesh/types'\n\n// ── 类型 ──\n\n/** 零件级说明性元数据 —— 引擎无关、JSON 可序列化、随 Shape 走双链路。 */\nexport interface ShapeMeta {\n  /** 零件名：3MF `<object name>` / STEP `PRODUCT().name`。 */\n  name?: string\n  /** 描述：STEP `PRODUCT.description`；3MF 写 `faijs:description` metadatagroup。 */\n  description?: string\n  /** 料号：3MF `<object partnumber>`；STEP `PRODUCT_IDENTIFICATION` 或 UDA。 */\n  partNumber?: string\n  /**\n   * 自定义键值：3MF `<object><metadatagroup>`（vendor 前缀）；STEP UDA。\n   * 键为规范/厂商原始名（3MF 含命名空间前缀）；faijs 不解释值语义，\n   * 读入保留、写出回写。\n   */\n  metadata?: Record<string, string>\n}\n\n/**\n * 整体/文档级说明性元数据 —— 导入结果 / 导出选项，不挂 Shape。\n *\n * 不叫 `ModelMeta`：CAD 直觉里 \"model\" 偏单个零件（那是 `ShapeMeta` 的活）；\n * 本类型承载整个交换文件（3MF `<model>` / STEP P21 header）的元数据，故用\n * `FileMeta`。\n */\nexport interface FileMeta {\n  title?: string // 3MF Title / STEP FILE_NAME.name\n  description?: string      // 3MF Description / STEP FILE_DESCRIPTION.description\n  designer?: string         // 3MF Designer / STEP FILE_NAME.originator\n  author?: string           // STEP FILE_NAME.author（3MF 无对应；跨格式不互转）\n  organization?: string     // STEP FILE_NAME.organization（3MF 无对应）\n  copyright?: string        // 3MF Copyright（STEP 无标准位置）\n  licenseTerms?: string     // 3MF LicenseTerms（STEP 无标准位置）\n  rating?: string           // 3MF Rating（STEP 无标准位置）\n  creationDate?: string     // 3MF CreationDate / STEP FILE_NAME.timestamp\n  modificationDate?: string // 3MF ModificationDate（STEP 无标准位置）\n  application?: string      // 3MF Application / STEP FILE_NAME.preprocessor\n  /** 未知/厂商自定义 metadata 兜底（3MF model 级带前缀名；STEP header 其余字段）。 */\n  metadata?: Record<string, string>\n}\n\n/** Shape 元数据方法签名（运行时由 attachMetaMethods 挂载；纯数据判定不受影响）。 */\nexport interface ShapeMetaMethods {\n  /** 合并 meta：`{...cur, ...spec}`，spec 中 undefined 字段保留旧值。 */\n  setMeta(spec: ShapeMeta): this\n  /** 便捷：等价 setMeta({ name })（空串视为清除）。 */\n  setName(name: string): this\n  /** 便捷：等价 setMeta({ description })（空串视为清除）。 */\n  setDescription(description: string): this\n  /** 便捷：等价 setMeta({ partNumber }）。 */\n  setPartNumber(partNumber: string): this\n  /** 便捷：等价 setMeta({ metadata: {...cur.metadata, ...kv} })；值为空串的键删除。 */\n  setMetaField(key: string, value: string): this\n  /** 读取当前 meta（可能 undefined）。 */\n  getMeta(): Readonly<ShapeMeta> | undefined\n}\n\n// ── 合并 ──\n\n/**\n * 合并零件级元数据：spec 中 undefined 字段不覆盖旧值；空串覆盖为清除。\n * @param cur 当前 meta（可为 undefined）\n * @param spec 待合并字段（undefined 字段跳过；'' 显式清除）\n * @returns 合并后的 meta（新对象；cur 为 undefined 时仅含 spec 非空字段）\n */\nexport function mergeMeta(cur: ShapeMeta | undefined, spec: ShapeMeta): ShapeMeta {\n  const clean: Record<string, unknown> = {}\n  for (const [k, v] of Object.entries(spec)) {\n    if (v === undefined) continue\n    if (k === 'metadata' && v && typeof v === 'object') {\n      // 键值子合并：保留旧 metadata 的未覆盖键。\n      const base: Record<string, string> = { ...((cur?.metadata as Record<string, string> | undefined) ?? {}) }\n      for (const [kk, vv] of Object.entries(v as Record<string, string>)) {\n        if (vv === '') delete base[kk] // 空串清除该键\n        else base[kk] = vv\n      }\n      clean[k] = base\n      continue\n    }\n    if (v === '') clean[k] = undefined as unknown as string // 空串清除顶层字段\n    else clean[k] = v\n  }\n  const merged = { ...(cur ?? {}), ...clean } as ShapeMeta\n  // 清理合并后为 undefined 的顶层键（空串清除写入 undefined）。\n  for (const k of Object.keys(merged)) {\n    if ((merged as Record<string, unknown>)[k] === undefined) delete (merged as Record<string, unknown>)[k]\n  }\n  return merged\n}\n\n// ── Shape 方法挂载 ──\n\n/**\n * 给 Shape 实例挂载元数据方法（幂等：已有 setMeta 则跳过）。\n *\n * 所有产物构造点（solid/curve → fromBrep/fromMeshSolid/fromBrepCurve）统一\n * 调用本函数，保证 mesh/brep 双支路产物都可用 `box1.setName(...)`。\n * 方法**不序列化**（JSON 丢弃函数）；`meta` 字段随产物跨打印，编辑器/\n * 查看器只读字段即可，不依赖方法。\n * @param shape 产物 Shape 实例（solid/curve 产物）\n * @returns 挂载后的 shape（类型提升为 `Shape & ShapeMetaMethods`；同一实例原地挂载）\n */\nexport function attachMetaMethods(shape: Shape): Shape & ShapeMetaMethods {\n  const s = shape as Shape & ShapeMetaMethods\n  if (typeof s.setMeta === 'function') return s\n  s.setMeta = function setMeta(this: Shape & ShapeMetaMethods, spec: ShapeMeta) {\n    this.meta = mergeMeta(this.meta, spec)\n    return this\n  }\n  s.setName = function setName(this: Shape & ShapeMetaMethods, name: string) {\n    this.meta = mergeMeta(this.meta, { name })\n    return this\n  }\n  s.setDescription = function setDescription(this: Shape & ShapeMetaMethods, description: string) {\n    this.meta = mergeMeta(this.meta, { description })\n    return this\n  }\n  s.setPartNumber = function setPartNumber(this: Shape & ShapeMetaMethods, partNumber: string) {\n    this.meta = mergeMeta(this.meta, { partNumber })\n    return this\n  }\n  s.setMetaField = function setMetaField(this: Shape & ShapeMetaMethods, key: string, value: string) {\n    this.meta = mergeMeta(this.meta, { metadata: { [key]: value } })\n    return this\n  }\n  s.getMeta = function getMeta(this: Shape) {\n    return this.meta\n  }\n  return s\n}"]}

package/dist/api/offset2d.d.ts

@@ -0,0 +1,49 @@
+/**
+ * api offset2d — 2D 轮廓偏置（手写平台 op engines:['occt']）
+ *
+ * @platform occt — 实现直调 occt 原生 `offsetWire2D`（occt-wasm 有，L1 契约
+ * `brep/engine/primitives.ts` 无对应成员——brepkit 侧只有裸 wasm 的
+ * `offsetWire2DWithJoin`，未接进 adapter）⇒ 平台 op：defineOp 声明
+ * `engines: ['occt']`（D11）。
+ *
+ * 与 `offset`（3D 全表面偏置）的分工（方案 §4.5 去重表）：
+ * - `offset`   = **3D 实体**的面偏置（`BRepOffsetAPI_MakeThickSolid`），产实体；
+ * - `offset2d` = **2D 轮廓**（平面 wire）的法向偏置（`BRepOffsetAPI_MakeOffset`），
+ *   产**1D 轮廓**（OpenSCAD `offset()` 链路的几何前置）。
+ *
+ * 产物形态（同 sectionByPlane / helix）：1D 轮廓经 `fromBrepCurve` 登记为
+ * `kind:'curve'`（wire/edge 三角载荷为空，显示走 L1 `wireframe`）。
+ */
+import type { Shape } from '../mesh/types.js';
+/** 拐角连接方式（映射 occt `JoinType`：Arc=0 / Tangent=1 / Intersection=2）。 */
+export type Offset2DJoinType = 'arc' | 'tangent' | 'intersection';
+/** `cad.offset2d` 参数。 */
+export interface Offset2DOptions {
+    /**
+     * 拐角连接方式：`'arc'`（默认，圆弧插值）| `'tangent'`（切向延伸）|
+     * `'intersection'`（求交延伸）。
+     */
+    joinType?: Offset2DJoinType;
+}
+/**
+ * 2D 轮廓偏置：把平面轮廓（wire 或面）沿其法向等距偏移，产出新的 1D 轮廓。
+ * @group 特征
+ * @inputs 1
+ * @async true
+ * @qual ok
+ * @name offset2d
+ * @note 平台 op：仅 occt 引擎（原生 offsetWire2D，L1 契约无对应成员）。非 occt
+ *       引擎执行前报错；brep_mock 不拦截。`delta` 可正可负（正 = 外扩，
+ *       负 = 内缩，方向随 contour 走向）；轮廓接受 wire 或面（面取其外环）。
+ * @returns Shape 1D 偏置轮廓（kind:'curve'）。
+ * @param profile - 轮廓几何（wire；面取其外环）。type:Shape required:true
+ * @param delta - 偏置距离（mm）。type:number required:true
+ * @param options - 偏置配置（joinType）。type:Offset2DOptions required:false
+ * @example
+ * const c = cad.wire([[0,0,0],[10,0,0],[10,10,0],[0,10,0]], { closed: true })
+ * const outer = await cad.offset2d(c, 2)
+ */
+export declare const offset2d: ((profile: Shape, delta: number, options?: Offset2DOptions | undefined) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../define-op.js").DualOpMeta;
+};
+//# sourceMappingURL=offset2d.d.ts.map

package/dist/api/offset2d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offset2d.d.ts","sourceRoot":"","sources":["../../src/api/offset2d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAU1C,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,SAAS,GAAG,cAAc,CAAA;AAEjE,yBAAyB;AACzB,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAC5B;AA0CD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,QAAQ;;CAQnB,CAAA"}

package/dist/api/offset2d.js

@@ -0,0 +1,86 @@
+/**
+ * api offset2d — 2D 轮廓偏置（手写平台 op engines:['occt']）
+ *
+ * @platform occt — 实现直调 occt 原生 `offsetWire2D`（occt-wasm 有，L1 契约
+ * `brep/engine/primitives.ts` 无对应成员——brepkit 侧只有裸 wasm 的
+ * `offsetWire2DWithJoin`，未接进 adapter）⇒ 平台 op：defineOp 声明
+ * `engines: ['occt']`（D11）。
+ *
+ * 与 `offset`（3D 全表面偏置）的分工（方案 §4.5 去重表）：
+ * - `offset`   = **3D 实体**的面偏置（`BRepOffsetAPI_MakeThickSolid`），产实体；
+ * - `offset2d` = **2D 轮廓**（平面 wire）的法向偏置（`BRepOffsetAPI_MakeOffset`），
+ *   产**1D 轮廓**（OpenSCAD `offset()` 链路的几何前置）。
+ *
+ * 产物形态（同 sectionByPlane / helix）：1D 轮廓经 `fromBrepCurve` 登记为
+ * `kind:'curve'`（wire/edge 三角载荷为空，显示走 L1 `wireframe`）。
+ */
+import { solidToShape } from '../brep/brep-ops.js';
+import { getBrepApi } from '../brep/handle-bridge.js';
+import { fromBrepCurve } from '../shape.js';
+import { defineOp } from '../sdk.js';
+import { getOcctKernel } from '../occt-kernel/occtKernel.js';
+import { toProfileWireView } from './internal/profile-wire.js';
+/** JoinType 字符串 → occt 枚举值。 */
+const JOIN_TYPE_CODE = {
+    arc: 0,
+    tangent: 1,
+    intersection: 2,
+};
+/** BREP 路径：occt offsetWire2D → 1D 轮廓经 fromBrepCurve 登记。 */
+function offset2dBrep(profile, delta, options) {
+    if (!profile) {
+        throw new Error('E_OFFSET2D_NO_PROFILE: offset2d requires a profile (wire or face) shape');
+    }
+    if (typeof delta !== 'number' || !Number.isFinite(delta)) {
+        throw new Error('E_OFFSET2D_BAD_DELTA: delta must be a finite number');
+    }
+    const joinType = options?.joinType ?? 'arc';
+    const joinCode = JOIN_TYPE_CODE[joinType];
+    if (joinCode === undefined) {
+        throw new Error(`E_OFFSET2D_BAD_JOIN: joinType must be 'arc' | 'tangent' | 'intersection' (got '${String(joinType)}')`);
+    }
+    const kernel = getBrepApi();
+    // 轮廓：wire 直用；面取外环（与 sweep/loft 共用唯一步径）。
+    const wire = toProfileWireView(profile);
+    try {
+        const handle = getOcctKernel().offsetWire2D(wire.wrapped, delta, joinCode);
+        return fromBrepCurve(solidToShape(kernel, handle), { solid: handle });
+    }
+    finally {
+        // 面→外环产出的 wire 是 arena 新句柄；曲线借用不 release。
+        if (!wire.borrowed) {
+            try {
+                kernel.release(wire.wrapped);
+            }
+            catch { /* 已释放 */ }
+        }
+    }
+}
+/**
+ * 2D 轮廓偏置：把平面轮廓（wire 或面）沿其法向等距偏移，产出新的 1D 轮廓。
+ * @group 特征
+ * @inputs 1
+ * @async true
+ * @qual ok
+ * @name offset2d
+ * @note 平台 op：仅 occt 引擎（原生 offsetWire2D，L1 契约无对应成员）。非 occt
+ *       引擎执行前报错；brep_mock 不拦截。`delta` 可正可负（正 = 外扩，
+ *       负 = 内缩，方向随 contour 走向）；轮廓接受 wire 或面（面取其外环）。
+ * @returns Shape 1D 偏置轮廓（kind:'curve'）。
+ * @param profile - 轮廓几何（wire；面取其外环）。type:Shape required:true
+ * @param delta - 偏置距离（mm）。type:number required:true
+ * @param options - 偏置配置（joinType）。type:Offset2DOptions required:false
+ * @example
+ * const c = cad.wire([[0,0,0],[10,0,0],[10,10,0],[0,10,0]], { closed: true })
+ * const outer = await cad.offset2d(c, 2)
+ */
+export const offset2d = defineOp({
+    name: 'offset2d',
+    paramDims: { delta: 'length' },
+    brep(profile, delta, options) {
+        return offset2dBrep(profile, delta, options);
+    },
+    engines: ['occt'],
+    naming: { kind: 'unmodeled', reason: '1D offset contour has no face role vocabulary' },
+});
+//# sourceMappingURL=offset2d.js.map

package/dist/api/offset2d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offset2d.js","sourceRoot":"","sources":["../../src/api/offset2d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAc3D,+BAA+B;AAC/B,MAAM,cAAc,GAAqC;IACvD,GAAG,EAAE,CAAC;IACN,OAAO,EAAE,CAAC;IACV,YAAY,EAAE,CAAC;CAChB,CAAA;AAED,2DAA2D;AAC3D,SAAS,YAAY,CAAC,OAAc,EAAE,KAAa,EAAE,OAAyB;IAC5E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAA;IAC5F,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAA;IACxE,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,KAAK,CAAA;IAC3C,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;IACzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,kFAAkF,MAAM,CAAC,QAAQ,CAAC,IAAI,CACvG,CAAA;IACH,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;IAC3B,wCAAwC;IACxC,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC,YAAY,CACzC,IAAI,CAAC,OAAgB,EACrB,KAAK,EACL,QAAiB,CACO,CAAA;QAC1B,OAAO,aAAa,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;IACvE,CAAC;YAAS,CAAC;QACT,0CAA0C;QAC1C,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC;gBAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAC/B,IAAI,EAAE,UAAU;IAChB,SAAS,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;IAC9B,IAAI,CAAC,OAAc,EAAE,KAAa,EAAE,OAAyB;QAC3D,OAAO,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IAC9C,CAAC;IACD,OAAO,EAAE,CAAC,MAAM,CAAC;IACjB,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,+CAA+C,EAAgB;CACrG,CAAC,CAAA","sourcesContent":["/**\n * api offset2d — 2D 轮廓偏置（手写平台 op engines:['occt']）\n *\n * @platform occt — 实现直调 occt 原生 `offsetWire2D`（occt-wasm 有，L1 契约\n * `brep/engine/primitives.ts` 无对应成员——brepkit 侧只有裸 wasm 的\n * `offsetWire2DWithJoin`，未接进 adapter）⇒ 平台 op：defineOp 声明\n * `engines: ['occt']`（D11）。\n *\n * 与 `offset`（3D 全表面偏置）的分工（方案 §4.5 去重表）：\n * - `offset`   = **3D 实体**的面偏置（`BRepOffsetAPI_MakeThickSolid`），产实体；\n * - `offset2d` = **2D 轮廓**（平面 wire）的法向偏置（`BRepOffsetAPI_MakeOffset`），\n *   产**1D 轮廓**（OpenSCAD `offset()` 链路的几何前置）。\n *\n * 产物形态（同 sectionByPlane / helix）：1D 轮廓经 `fromBrepCurve` 登记为\n * `kind:'curve'`（wire/edge 三角载荷为空，显示走 L1 `wireframe`）。\n */\n\nimport type { Shape } from '../mesh/types'\nimport type { BrepHandle } from '../brep/engine/types'\nimport { solidToShape } from '../brep/brep-ops'\nimport { getBrepApi } from '../brep/handle-bridge'\nimport { fromBrepCurve } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { Provenance } from '../topology/naming/lineage'\nimport { getOcctKernel } from '../occt-kernel/occtKernel'\nimport { toProfileWireView } from './internal/profile-wire'\n\n/** 拐角连接方式（映射 occt `JoinType`：Arc=0 / Tangent=1 / Intersection=2）。 */\nexport type Offset2DJoinType = 'arc' | 'tangent' | 'intersection'\n\n/** `cad.offset2d` 参数。 */\nexport interface Offset2DOptions {\n  /**\n   * 拐角连接方式：`'arc'`（默认，圆弧插值）| `'tangent'`（切向延伸）|\n   * `'intersection'`（求交延伸）。\n   */\n  joinType?: Offset2DJoinType\n}\n\n/** JoinType 字符串 → occt 枚举值。 */\nconst JOIN_TYPE_CODE: Record<Offset2DJoinType, number> = {\n  arc: 0,\n  tangent: 1,\n  intersection: 2,\n}\n\n/** BREP 路径：occt offsetWire2D → 1D 轮廓经 fromBrepCurve 登记。 */\nfunction offset2dBrep(profile: Shape, delta: number, options?: Offset2DOptions): Shape {\n  if (!profile) {\n    throw new Error('E_OFFSET2D_NO_PROFILE: offset2d requires a profile (wire or face) shape')\n  }\n  if (typeof delta !== 'number' || !Number.isFinite(delta)) {\n    throw new Error('E_OFFSET2D_BAD_DELTA: delta must be a finite number')\n  }\n  const joinType = options?.joinType ?? 'arc'\n  const joinCode = JOIN_TYPE_CODE[joinType]\n  if (joinCode === undefined) {\n    throw new Error(\n      `E_OFFSET2D_BAD_JOIN: joinType must be 'arc' | 'tangent' | 'intersection' (got '${String(joinType)}')`,\n    )\n  }\n  const kernel = getBrepApi()\n  // 轮廓：wire 直用；面取外环（与 sweep/loft 共用唯一步径）。\n  const wire = toProfileWireView(profile)\n  try {\n    const handle = getOcctKernel().offsetWire2D(\n      wire.wrapped as never,\n      delta,\n      joinCode as never,\n    ) as unknown as BrepHandle\n    return fromBrepCurve(solidToShape(kernel, handle), { solid: handle })\n  } finally {\n    // 面→外环产出的 wire 是 arena 新句柄；曲线借用不 release。\n    if (!wire.borrowed) {\n      try { kernel.release(wire.wrapped) } catch { /* 已释放 */ }\n    }\n  }\n}\n\n/**\n * 2D 轮廓偏置：把平面轮廓（wire 或面）沿其法向等距偏移，产出新的 1D 轮廓。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual ok\n * @name offset2d\n * @note 平台 op：仅 occt 引擎（原生 offsetWire2D，L1 契约无对应成员）。非 occt\n *       引擎执行前报错；brep_mock 不拦截。`delta` 可正可负（正 = 外扩，\n *       负 = 内缩，方向随 contour 走向）；轮廓接受 wire 或面（面取其外环）。\n * @returns Shape 1D 偏置轮廓（kind:'curve'）。\n * @param profile - 轮廓几何（wire；面取其外环）。type:Shape required:true\n * @param delta - 偏置距离（mm）。type:number required:true\n * @param options - 偏置配置（joinType）。type:Offset2DOptions required:false\n * @example\n * const c = cad.wire([[0,0,0],[10,0,0],[10,10,0],[0,10,0]], { closed: true })\n * const outer = await cad.offset2d(c, 2)\n */\nexport const offset2d = defineOp({\n  name: 'offset2d',\n  paramDims: { delta: 'length' },\n  brep(profile: Shape, delta: number, options?: Offset2DOptions) {\n    return offset2dBrep(profile, delta, options)\n  },\n  engines: ['occt'],\n  naming: { kind: 'unmodeled', reason: '1D offset contour has no face role vocabulary' } as Provenance,\n})\n"]}

package/dist/api/pattern.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pattern.d.ts","sourceRoot":"","sources":["../../src/api/pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AA0EhD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,aAAa;;CAiBxB,CAAA"}
+{"version":3,"file":"pattern.d.ts","sourceRoot":"","sources":["../../src/api/pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AA0EhD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,aAAa;;CAcxB,CAAA"}

package/dist/api/pattern.js

@@ -9,7 +9,7 @@
  * 倍数即得 k；再按「面内坐标」（centroid − t·dir）匹配输入面对应面，回投其 inner role。
  */
 import { solidToShape } from '../brep/brep-ops.js';
-import { getCurrentStmt, keep } from '../runtime-state.js';
+import { getCurrentStmt, keepHidden } from '../runtime-state.js';
 import { getBrepApi } from '../brep/handle-bridge.js';
 import { fromBrep, brepOf } from '../shape.js';
 import { defineOp } from '../sdk.js';
@@ -94,19 +94,16 @@ function linearPatternMeshSolid(input, direction, count, spacing) {
 export const linearPattern = defineOp({
     meshEngines: ['brepkit'],
     mesh(input, direction, count, spacing) {
-        keep(input);
+        keepHidden(input);
         // 裸网格输入由 `meshSolidBasicEntry` 如实拒绝（近似链没有 role 层，也没有句柄）——
         // 这里不复刻一遍判定，失败面只有一处。
         return linearPatternMeshSolid(input, direction, count, spacing);
     },
     brep(input, direction, count, spacing) {
         // copy-like keep semantics: replicate ops preserve their source shape.
-        keep(input);
+        keepHidden(input);
         return linearPatternBrep(input, direction, count, spacing);
     },
-    // Phase 1（Brep 引擎可切换重构）：能力前置判定——linearPattern 需要内核的
-    // 线性阵列方法（BrepMethodKind），brepkit 装配下缺失时执行前静态报错。
-    capabilities: ['linearPattern'],
     naming: { kind: 'replicate', k: 0 },
 });
 //# sourceMappingURL=pattern.js.map

package/dist/api/pattern.js.map

@@ -1 +1 @@
-{"version":3,"file":"pattern.js","sourceRoot":"","sources":["../../src/api/pattern.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * api pattern — linearPattern（手写覆盖生成投影，Phase 3: L3 `replica[k]` 角色表）\n *\n * 生成投影是 brep-only compatOp，不带角色表；本文件手写 defineOp，BREP 路径\n * 用质心聚类把结果面按份数 k 分组、回投影到输入面角色，产出 `replica[k]/<inner>`。\n *\n * 机制（无内核历史，纯几何推理）：pattern 的每份副本都是输入的精确平移，副本面\n * 几何相同但质心不同。结果面沿 pattern 方向投影得到份数坐标 t，四舍五入到 spacing\n * 倍数即得 k；再按「面内坐标」（centroid − t·dir）匹配输入面对应面，回投其 inner role。\n */\n\nimport type { Shape, Vec3 } from '../mesh/types'\nimport { solidToShape } from '../brep/brep-ops'\nimport { getCurrentStmt, keep } from '../runtime-state'\nimport { getBrepApi } from '../brep/handle-bridge'\nimport { fromBrep, brepOf } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { Provenance } from '../topology/naming/lineage'\nimport type { BrepHandle } from '../brep/engine/types'\nimport { buildReplicaRoleTable, type ReplicaTransform } from './internal/replica-role-table'\nimport { meshPatternProduct, meshSolidBasicEntry } from './internal/mesh-solid-op'\n\n/** 归一化向量（零向量 → [0,0,1] 兜底）。 */\nfunction norm(v: Vec3): [number, number, number] {\n  const len = Math.hypot(v[0], v[1], v[2])\n  if (len < 1e-9) return [0, 0, 1]\n  return [v[0] / len, v[1] / len, v[2] / len]\n}\n\n/** BREP 路径：沿 direction 复制 count 份，质心聚类回投输入面角色。 */\nfunction linearPatternBrep(input: Shape, direction: Vec3, count: number, spacing: number): Shape {\n  const kernel = getBrepApi()\n  const inputSolid = brepOf(input) as BrepHandle | undefined\n  if (!inputSolid) throw new Error('[api/pattern] input is not BREP')\n\n  // Phase 1.6：origin = 本次语句 StmtId。\n  const outStmt = String(getCurrentStmt()?.id ?? '')\n\n  // 取 count 份副本。Phase 2：BrepEngineApi.linearPattern 契约统一返回 BrepHandle[]\n  // （两内核原生都返回 compound，由适配器拆成数组）——不再有「单句柄 fused」形态。\n  const dir = norm(direction)\n  const raw = kernel.linearPattern(inputSolid, { x: dir[0], y: dir[1], z: dir[2] }, spacing, count)\n\n  let resultSolid: BrepHandle\n  try {\n    resultSolid = kernel.fuseAll(raw)\n  } finally {\n    for (const c of raw) kernel.release(c)\n  }\n\n  // 第 k 份副本是输入沿 dir 平移 k*spacing：质心反投回输入坐标系（T_k⁻¹）。\n  const replicas: ReplicaTransform[] = []\n  for (let k = 0; k < count; k++) {\n    const off = k * spacing\n    replicas.push({\n      label: `replica[${k}]`,\n      inverse: (c) => ({ x: c.x - off * dir[0], y: c.y - off * dir[1], z: c.z - off * dir[2] }),\n    })\n  }\n  const roleTable = buildReplicaRoleTable(kernel, input, resultSolid, replicas, outStmt)\n\n  return fromBrep(solidToShape(kernel, resultSolid), { solid: resultSolid, roleTable })\n}\n\n/**\n * 网格实体路径：沿 direction 阵列并把副本融成一个网格零件。\n *\n * 与 BREP 路径同一条内核契约（`linearPattern` 返回含原位置在内的 count 个句柄，\n * 再 `fuseAll` 成一体），差别只在**没有 quality 面角色可回投**——近似拓扑没有 role\n * 层，故不产 `replica[k]/<inner>` 命名（如实缺席，不伪造恒等映射）。\n *\n * @param input - the mesh-solid input.\n * @param direction - the pattern direction.\n * @param count - total number of copies (including the original).\n * @param spacing - the spacing between copies.\n * @returns the fused mesh solid as a new mesh part.\n */\nfunction linearPatternMeshSolid(input: Shape, direction: Vec3, count: number, spacing: number): Shape {\n  const entry = meshSolidBasicEntry(input, 'linearPattern')\n  const d = norm(direction)\n  return meshPatternProduct(entry, 'linearPattern', 'E_PATTERN_FAILED', () =>\n    entry.kernel.linearPattern(entry.solid, { x: d[0], y: d[1], z: d[2] }, spacing, count),\n  )\n}\n\n/**\n * 线性阵列：沿 direction 复制 count 份（含原位置）。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual ok\n * @name linearPattern\n * @note BREP 输入走质心聚类回投，结果面按份数 k 回投影到输入面角色，产出\n *       `replica[k]/<inner>`（Phase 3 L3 抗重放词汇）；**网格实体**输入走网格后端，\n *       阵列后融合为一个新的网格零件，近似拓扑没有 role 层故不产 replica 命名。\n *       裸网格输入仍抛 `E_MESH_UNSUPPORTED`。\n * @returns Shape 所有副本 fused 后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @param direction - 阵列方向。type:[x,y,z] required:true\n * @param count - 副本总数（含原位置）。type:number required:true\n * @param spacing - 副本间距。type:number required:true\n * @example\n * const p = await cad.linearPattern(part0, [1, 0, 0], 3, 20)\n */\nexport const linearPattern = defineOp({\n  meshEngines: ['brepkit'],\n  mesh(input: Shape, direction: Vec3, count: number, spacing: number) {\n    keep(input)\n    // 裸网格输入由 `meshSolidBasicEntry` 如实拒绝（近似链没有 role 层，也没有句柄）——\n    // 这里不复刻一遍判定，失败面只有一处。\n    return linearPatternMeshSolid(input, direction, count, spacing)\n  },\n  brep(input: Shape, direction: Vec3, count: number, spacing: number) {\n    // copy-like keep semantics: replicate ops preserve their source shape.\n    keep(input)\n    return linearPatternBrep(input, direction, count, spacing)\n  },\n  // Phase 1（Brep 引擎可切换重构）：能力前置判定——linearPattern 需要内核的\n  // 线性阵列方法（BrepMethodKind），brepkit 装配下缺失时执行前静态报错。\n  capabilities: ['linearPattern'],\n  naming: { kind: 'replicate', k: 0 } as Provenance,\n})\n"]}
+{"version":3,"file":"pattern.js","sourceRoot":"","sources":["../../src/api/pattern.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * api pattern — linearPattern（手写覆盖生成投影，Phase 3: L3 `replica[k]` 角色表）\n *\n * 生成投影是 brep-only compatOp，不带角色表；本文件手写 defineOp，BREP 路径\n * 用质心聚类把结果面按份数 k 分组、回投影到输入面角色，产出 `replica[k]/<inner>`。\n *\n * 机制（无内核历史，纯几何推理）：pattern 的每份副本都是输入的精确平移，副本面\n * 几何相同但质心不同。结果面沿 pattern 方向投影得到份数坐标 t，四舍五入到 spacing\n * 倍数即得 k；再按「面内坐标」（centroid − t·dir）匹配输入面对应面，回投其 inner role。\n */\n\nimport type { Shape, Vec3 } from '../mesh/types'\nimport { solidToShape } from '../brep/brep-ops'\nimport { getCurrentStmt, keepHidden } from '../runtime-state'\nimport { getBrepApi } from '../brep/handle-bridge'\nimport { fromBrep, brepOf } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { Provenance } from '../topology/naming/lineage'\nimport type { BrepHandle } from '../brep/engine/types'\nimport { buildReplicaRoleTable, type ReplicaTransform } from './internal/replica-role-table'\nimport { meshPatternProduct, meshSolidBasicEntry } from './internal/mesh-solid-op'\n\n/** 归一化向量（零向量 → [0,0,1] 兜底）。 */\nfunction norm(v: Vec3): [number, number, number] {\n  const len = Math.hypot(v[0], v[1], v[2])\n  if (len < 1e-9) return [0, 0, 1]\n  return [v[0] / len, v[1] / len, v[2] / len]\n}\n\n/** BREP 路径：沿 direction 复制 count 份，质心聚类回投输入面角色。 */\nfunction linearPatternBrep(input: Shape, direction: Vec3, count: number, spacing: number): Shape {\n  const kernel = getBrepApi()\n  const inputSolid = brepOf(input) as BrepHandle | undefined\n  if (!inputSolid) throw new Error('[api/pattern] input is not BREP')\n\n  // Phase 1.6：origin = 本次语句 StmtId。\n  const outStmt = String(getCurrentStmt()?.id ?? '')\n\n  // 取 count 份副本。Phase 2：BrepEngineApi.linearPattern 契约统一返回 BrepHandle[]\n  // （两内核原生都返回 compound，由适配器拆成数组）——不再有「单句柄 fused」形态。\n  const dir = norm(direction)\n  const raw = kernel.linearPattern(inputSolid, { x: dir[0], y: dir[1], z: dir[2] }, spacing, count)\n\n  let resultSolid: BrepHandle\n  try {\n    resultSolid = kernel.fuseAll(raw)\n  } finally {\n    for (const c of raw) kernel.release(c)\n  }\n\n  // 第 k 份副本是输入沿 dir 平移 k*spacing：质心反投回输入坐标系（T_k⁻¹）。\n  const replicas: ReplicaTransform[] = []\n  for (let k = 0; k < count; k++) {\n    const off = k * spacing\n    replicas.push({\n      label: `replica[${k}]`,\n      inverse: (c) => ({ x: c.x - off * dir[0], y: c.y - off * dir[1], z: c.z - off * dir[2] }),\n    })\n  }\n  const roleTable = buildReplicaRoleTable(kernel, input, resultSolid, replicas, outStmt)\n\n  return fromBrep(solidToShape(kernel, resultSolid), { solid: resultSolid, roleTable })\n}\n\n/**\n * 网格实体路径：沿 direction 阵列并把副本融成一个网格零件。\n *\n * 与 BREP 路径同一条内核契约（`linearPattern` 返回含原位置在内的 count 个句柄，\n * 再 `fuseAll` 成一体），差别只在**没有 quality 面角色可回投**——近似拓扑没有 role\n * 层，故不产 `replica[k]/<inner>` 命名（如实缺席，不伪造恒等映射）。\n *\n * @param input - the mesh-solid input.\n * @param direction - the pattern direction.\n * @param count - total number of copies (including the original).\n * @param spacing - the spacing between copies.\n * @returns the fused mesh solid as a new mesh part.\n */\nfunction linearPatternMeshSolid(input: Shape, direction: Vec3, count: number, spacing: number): Shape {\n  const entry = meshSolidBasicEntry(input, 'linearPattern')\n  const d = norm(direction)\n  return meshPatternProduct(entry, 'linearPattern', 'E_PATTERN_FAILED', () =>\n    entry.kernel.linearPattern(entry.solid, { x: d[0], y: d[1], z: d[2] }, spacing, count),\n  )\n}\n\n/**\n * 线性阵列：沿 direction 复制 count 份（含原位置）。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual ok\n * @name linearPattern\n * @note BREP 输入走质心聚类回投，结果面按份数 k 回投影到输入面角色，产出\n *       `replica[k]/<inner>`（Phase 3 L3 抗重放词汇）；**网格实体**输入走网格后端，\n *       阵列后融合为一个新的网格零件，近似拓扑没有 role 层故不产 replica 命名。\n *       裸网格输入仍抛 `E_MESH_UNSUPPORTED`。\n * @returns Shape 所有副本 fused 后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @param direction - 阵列方向。type:[x,y,z] required:true\n * @param count - 副本总数（含原位置）。type:number required:true\n * @param spacing - 副本间距。type:number required:true\n * @example\n * const p = await cad.linearPattern(part0, [1, 0, 0], 3, 20)\n */\nexport const linearPattern = defineOp({\n  meshEngines: ['brepkit'],\n  mesh(input: Shape, direction: Vec3, count: number, spacing: number) {\n    keepHidden(input)\n    // 裸网格输入由 `meshSolidBasicEntry` 如实拒绝（近似链没有 role 层，也没有句柄）——\n    // 这里不复刻一遍判定，失败面只有一处。\n    return linearPatternMeshSolid(input, direction, count, spacing)\n  },\n  brep(input: Shape, direction: Vec3, count: number, spacing: number) {\n    // copy-like keep semantics: replicate ops preserve their source shape.\n    keepHidden(input)\n    return linearPatternBrep(input, direction, count, spacing)\n  },\n  naming: { kind: 'replicate', k: 0 } as Provenance,\n})\n"]}

package/dist/api/primitives.d.ts

@@ -57,9 +57,9 @@ export declare function assertWedgeParams(params: Record<string, unknown>): void
  * @param params.segments - 细分度（影响三角化）。type:number 默认 64（= brepjs standard 等效，P0 §5.0/§5.1）
  * @example
  * const part0 = cad.box(10 * MM, 20 * MM, 30 * MM)
- * const part1 = cad.box(30 * MM, 20 * MM, 10 * MM, { centered: true, at: [1, 2, 3], segments: 64 })
+ * const part1 = cad.box(30 * MM, 20 * MM, 10 * MM, { at: [1, 2, 3], segments: 64 })
  *
- * 位置原生（§4.1/§6.2）：`box(width, depth, height)` 与 `box(10 * MM, 20 * MM, 30 * MM, {centered:true})`
+ * 位置原生（§4.1/§6.2）：`box(width, depth, height)` 与 `box(10 * MM, 20 * MM, 30 * MM, { at: [1, 2, 3] })`
  * 有量纲位必须写单位字面量（基准单位亦然，`10` 裸数字被 D8 R2 拒）。
  * 归一到同一对象（D11 位置→对象 + 尾参 options 合并）。旧 `{ size }` 对象形态已废弃（裁决 3），
  * 传入会抛 `E_ARGS_FORM`（错误提示 ≠ 兼容，§4.1）。
@@ -104,9 +104,9 @@ export declare const sphere: ((params: Record<string, unknown>) => Promise<Shape
  * @param params.segments - 细分度（影响三角化）。type:number 默认 64（= brepjs standard 等效，P0 §5.0/§5.1）
  * @example
  * const c = cad.cylinder(5, 40)
- * const c = cad.cylinder(5, 40, { centered: true, at: [0, 0, 20], segments: 64 })
+ * const c = cad.cylinder(5, 40, { at: [0, 0, 20], segments: 64 })
  *
- * 位置原生（§4.1/§6.2）：`cylinder(5, 40)` 与 `cylinder(5, 40, {centered:true})`
+ * 位置原生（§4.1/§6.2）：`cylinder(5, 40)` 与 `cylinder(5, 40, { at: [0, 0, 20] })`
  * 归一到同一对象（D11 位置→装箱 + 尾参 options 合并）。旧 `{ center }` 对象形态已废弃
  * （裁决 3），传入会抛 `E_ARGS_FORM`（错误提示 ≠ 兼容，§4.3）。
   */
@@ -131,8 +131,8 @@ export declare const cylinder: ((params: Record<string, unknown>) => Promise<Sha
  * @param params.segments - 细分度（影响三角化）。type:number 默认 64（= brepjs standard 等效，P0 §5.0/§5.1）
  * @example
  * const c = cad.cone(10, 4, 30)
- * const c = cad.cone(10, 0, 30, { centered: true, at: [0, 0, 20], segments: 64 })
- * 位置原生（§4.1/§6.2）：`cone(10, 4, 30)` 与 `cone(10, 4, 30, { centered: true })`
+ * const c = cad.cone(10, 0, 30, { at: [0, 0, 20], segments: 64 })
+ * 位置原生（§4.1/§6.2）：`cone(10, 4, 30)` 与 `cone(10, 4, 30, { at: [0, 0, 20] })`
  * 归一到同一对象（D11 位置→装箱 + 尾参 options 合并）。旧 `{ center }`/`{ size }` 对象形态
  * 已废弃（裁决 3），传入会抛 E_ARGS_FORM（错误提示 ≠ 兼容）。
   */

package/dist/api/primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/api/primitives.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAmB1C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAUrE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAExE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAS1E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAUtE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAKvE;AAyHD;;;;;;;;;;;;;;;;;;;;;;KAsBK;AACL,eAAO,MAAM,GAAG;;CAwBd,CAAA;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,MAAM;;CAgBjB,CAAA;AAWF;;;;;;;;;;;;;;;;;;;;;;IAsBI;AACJ,eAAO,MAAM,QAAQ;;CAgBnB,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;IAsBI;AACJ,eAAO,MAAM,IAAI;;CAuBf,CAAA;AAEF;;;;;;;;;;;;;;;;IAgBI;AACJ,eAAO,MAAM,KAAK;;CAchB,CAAA"}
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/api/primitives.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAkB1C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAUrE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAExE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAS1E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAUtE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAKvE;AA4HD;;;;;;;;;;;;;;;;;;;;;;KAsBK;AACL,eAAO,MAAM,GAAG;;CAwBd,CAAA;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,MAAM;;CAgBjB,CAAA;AAWF;;;;;;;;;;;;;;;;;;;;;;IAsBI;AACJ,eAAO,MAAM,QAAQ;;CAgBnB,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;IAsBI;AACJ,eAAO,MAAM,IAAI;;CAuBf,CAAA;AAEF;;;;;;;;;;;;;;;;IAgBI;AACJ,eAAO,MAAM,KAAK;;CAchB,CAAA"}