@faicad/faijs 0.13.0

package/dist/topology/naming/geom-hint.js

@@ -0,0 +1,254 @@
+/**
+ * geom-hint.ts — 几何 hint 捕获（§3.1）
+ *
+ * 两路：
+ * - `captureFaceHint(kernel, faceHandle)`：BREP 现场面 → FaceHint（assignRoles 用）。
+ * - `faceRowToHint(row)`：面行/FaceRow → FaceHint（primitive/mesh 命名槽快照用）。
+ *
+ * hint 字段与 SelectorRuntime 的 FaceRow（surfaceType/area/center/normal）同源
+ * （§2.2），保证 BREP 现场与面行快照两条打分路径口径一致。
+ */
+/** 归一化向量（axis 采集内部用；零向量返回 null，调用方放弃采集）。 */
+function normalizedAxis(v) {
+    const len = Math.hypot(v[0], v[1], v[2]);
+    if (len < 1e-12 || !Number.isFinite(len))
+        return null;
+    return [v[0] / len, v[1] / len, v[2] / len];
+}
+/**
+ * BREP 现场圆柱面 → 轴 hint（P0 装配前置）。
+ *
+ * 算法与 occt-kernel/topologyExt.ts getSurfaceParams 的 cylinder 分支同源：
+ * direction = normalize(S(u,v+1) − S(u,v))（V 向即轴向）；origin = P − R·外法向
+ *（surfaceNormal 含朝向，reversed 面先取反修正）。
+ *
+ * @param kernel - the OCCT kernel.
+ * @param face - the cylindrical face handle.
+ * @returns the axis hint, or undefined when the axis cannot be derived.
+ */
+function captureCylinderFaceAxis(kernel, face) {
+    try {
+        const uv = kernel.uvBounds(face);
+        const p0 = kernel.pointOnSurface(face, uv.uMin, uv.vMin);
+        const p1 = kernel.pointOnSurface(face, uv.uMin, uv.vMin + 1);
+        const direction = normalizedAxis([p1.x - p0.x, p1.y - p0.y, p1.z - p0.z]);
+        const cyl = kernel.getFaceCylinderData(face);
+        if (!direction || !cyl)
+            return undefined;
+        let sn = kernel.surfaceNormal(face, uv.uMin, uv.vMin);
+        if (kernel.shapeOrientation(face) === 'reversed') {
+            sn = { x: -sn.x, y: -sn.y, z: -sn.z };
+        }
+        const origin = [
+            p0.x - cyl.radius * sn.x,
+            p0.y - cyl.radius * sn.y,
+            p0.z - cyl.radius * sn.z,
+        ];
+        return { origin, direction };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * BREP 现场圆边 → 轴 hint（origin = 圆心，direction = 所在平面法向；P0 装配前置）。
+ *
+ * 用曲线上三个不同参数的采样点做外接圆圆心（三点定圆，精确、无弧长近似），
+ * 法向取 (p1−p0)×(p2−p0) 归一化。只用 curvePointAtParam/curveParameters 等既有
+ * 公开内核 API（与 getCurveParams 的 circle 分支同一能力面），不新增内核方法。
+ *
+ * @param kernel - the OCCT kernel.
+ * @param edge - the circular edge handle.
+ * @returns the axis hint, or undefined when sampling fails.
+ */
+function captureCircleEdgeAxis(kernel, edge) {
+    try {
+        const { first, last } = kernel.curveParameters(edge);
+        if (!Number.isFinite(first) || !Number.isFinite(last))
+            return undefined;
+        const d = (last - first) / 3;
+        const pa = kernel.curvePointAtParam(edge, first);
+        const pb = kernel.curvePointAtParam(edge, first + d);
+        const pc = kernel.curvePointAtParam(edge, first + 2 * d);
+        const e1 = [pb.x - pa.x, pb.y - pa.y, pb.z - pa.z];
+        const e2 = [pc.x - pa.x, pc.y - pa.y, pc.z - pa.z];
+        // 三点外接圆：解 o = a + α·e1 + β·e2，满足 |o−a| = |o−b| = |o−c|
+        const e11 = e1[0] * e1[0] + e1[1] * e1[1] + e1[2] * e1[2];
+        const e22 = e2[0] * e2[0] + e2[1] * e2[1] + e2[2] * e2[2];
+        const e12 = e1[0] * e2[0] + e1[1] * e2[1] + e1[2] * e2[2];
+        const denom = e11 * e22 - e12 * e12;
+        if (Math.abs(denom) < 1e-18)
+            return undefined;
+        const alpha = (e11 * e22 - e22 * e12) / (2 * denom);
+        const beta = (e22 * e11 - e11 * e12) / (2 * denom);
+        const origin = [
+            pa.x + alpha * e1[0] + beta * e2[0],
+            pa.y + alpha * e1[1] + beta * e2[1],
+            pa.z + alpha * e1[2] + beta * e2[2],
+        ];
+        const direction = normalizedAxis([
+            e1[1] * e2[2] - e1[2] * e2[1],
+            e1[2] * e2[0] - e1[0] * e2[2],
+            e1[0] * e2[1] - e1[1] * e2[0],
+        ]);
+        if (!direction)
+            return undefined;
+        return { origin, direction };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * BREP 现场面 → FaceHint。
+ *
+ * 面积在 occt-wasm 无公开 API（queryBatch 仅测试用），故现场路径不填 area——
+ * 打分器对缺失 area 不扣分（scorerArea 双 undefined 跳过）。
+ *
+ * @param kernel - the OCCT kernel.
+ * @param face - the face handle to snapshot.
+ * @returns the captured FaceHint.
+ */
+export function captureFaceHint(kernel, face) {
+    const surfaceType = kernel.surfaceType(face);
+    const uv = kernel.uvBounds(face);
+    const u = (uv.uMin + uv.uMax) / 2;
+    const v = (uv.vMin + uv.vMax) / 2;
+    const normal = kernel.surfaceNormal(face, u, v);
+    const center = kernel.getSurfaceCenterOfMass(face);
+    // P0 装配前置：圆柱面采集轴 hint（其余面类型缺省——平面用 center+normal 即可）
+    const axis = surfaceType === 'cylinder' ? captureCylinderFaceAxis(kernel, face) : undefined;
+    return {
+        kind: 'face',
+        surfaceType,
+        normal: [normal.x, normal.y, normal.z],
+        center: [center.x, center.y, center.z],
+        ...(axis ? { axis } : {}),
+    };
+}
+/**
+ * 面行 → FaceHint（mesh/primitive 命名槽快照路径；§3.6 setTopology 注入用）。
+ * 面行的 surfaceType/normal/center/area 与 BREP 现场同口径（§1.1 事实）。
+ *
+ * @param row - a FaceRow (or shape-compatible object) from the selector manifest.
+ * @returns the FaceHint derived from the row.
+ */
+export function faceRowToHint(row) {
+    const hint = {
+        kind: 'face',
+        ...(row.surfaceType !== undefined ? { surfaceType: row.surfaceType } : {}),
+        ...(row.normal && row.normal.length === 3 ? { normal: [row.normal[0], row.normal[1], row.normal[2]] } : {}),
+        ...(row.center && row.center.length === 3 ? { center: [row.center[0], row.center[1], row.center[2]] } : {}),
+        ...(row.area !== undefined && Number.isFinite(row.area) ? { area: row.area } : {}),
+        ...(row.axis?.origin && row.axis.origin.length === 3 && row.axis.direction && row.axis.direction.length === 3
+            ? {
+                axis: {
+                    origin: [row.axis.origin[0], row.axis.origin[1], row.axis.origin[2]],
+                    direction: [row.axis.direction[0], row.axis.direction[1], row.axis.direction[2]],
+                },
+            }
+            : {}),
+    };
+    return hint;
+}
+/**
+ * 边行 → EdgeHint（mesh/primitive 命名槽快照路径；§3.7 edgeNaming 用）。
+ * EdgeRow.center 与 EdgeHint.midpoint 同口径（§3.7：边 midpoint 与 EdgeRow.center
+ * 同口径，geom-hint.ts 统一采集）。
+ *
+ * @param row - an EdgeRow (or shape-compatible object) from the selector manifest.
+ * @returns the EdgeHint derived from the row.
+ */
+export function edgeRowToHint(row) {
+    const hint = {
+        kind: 'edge',
+        ...(row.length !== undefined && Number.isFinite(row.length) ? { length: row.length } : {}),
+        ...(row.center && row.center.length === 3 ? { midpoint: [row.center[0], row.center[1], row.center[2]] } : {}),
+        ...(row.axis?.origin && row.axis.origin.length === 3 && row.axis.direction && row.axis.direction.length === 3
+            ? {
+                axis: {
+                    origin: [row.axis.origin[0], row.axis.origin[1], row.axis.origin[2]],
+                    direction: [row.axis.direction[0], row.axis.direction[1], row.axis.direction[2]],
+                },
+            }
+            : {}),
+    };
+    return hint;
+}
+/**
+ * BREP 现场边 → EdgeHint。
+ *
+ * hint 是「并列裁决者」而非身份本身（§1.2），只在两邻面多公共边时用于打分。
+ * length 用 `kernel.curveLength(edge)`；midpoint 取曲线参数中点的点坐标
+ * （与 face 的 curvePointAtParam 同口径；屏蔽封闭/退化边的采样退化）。
+ *
+ * @param kernel - the OCCT kernel.
+ * @param edge - the edge handle to snapshot.
+ * @returns the captured EdgeHint.
+ */
+/**
+ * BREP 现场边 → 轴 hint（装配约束的边实体来源；P0 前置）。
+ *
+ * 直边：origin = 曲线起点，direction = 起点切向；
+ * 圆边：origin = 圆心（三点定圆），direction = 所在平面法向；
+ * 其它曲线类型 → undefined（不静默造轴）。
+ *
+ * @param kernel - the OCCT kernel.
+ * @param edge - the edge handle.
+ * @returns the axis hint, or undefined for unsupported curves / sampling failure.
+ */
+export function captureEdgeAxis(kernel, edge) {
+    try {
+        const curveType = kernel.curveType(edge);
+        if (curveType === 'line') {
+            const { first } = kernel.curveParameters(edge);
+            const origin = kernel.curvePointAtParam(edge, first);
+            const tangent = kernel.curveTangent(edge, first);
+            const direction = normalizedAxis([tangent.x, tangent.y, tangent.z]);
+            if (Number.isFinite(origin.x) && Number.isFinite(origin.y) && Number.isFinite(origin.z) && direction) {
+                return { origin: [origin.x, origin.y, origin.z], direction };
+            }
+        }
+        else if (curveType === 'circle') {
+            return captureCircleEdgeAxis(kernel, edge);
+        }
+    }
+    catch {
+        // 曲线类型读取失败 → 无 axis hint（调用方按缺省处理，不静默造轴）
+    }
+    return undefined;
+}
+/**
+ * 采集棱边 hint（长度 / 中点 / 轴）。
+ *
+ * P0 装配前置：直边（起点 + 切向）与圆边（圆心 + 所在平面法向）产出 axis hint；
+ * 退化或非线/圆曲线不产出 axis（调用方按缺省处理，不静默造轴）。
+ *
+ * @param kernel - the BREP engine API.
+ * @param edge - the edge handle.
+ * @returns the captured edge hint.
+ */
+export function captureEdgeHint(kernel, edge) {
+    const length = kernel.curveLength(edge);
+    const hint = { kind: 'edge' };
+    if (Number.isFinite(length) && length > 0)
+        hint.length = length;
+    try {
+        const { first, last } = kernel.curveParameters(edge);
+        if (Number.isFinite(first) && Number.isFinite(last)) {
+            const mid = kernel.curvePointAtParam(edge, (first + last) / 2);
+            if (Number.isFinite(mid.x) && Number.isFinite(mid.y) && Number.isFinite(mid.z)) {
+                hint.midpoint = [mid.x, mid.y, mid.z];
+            }
+        }
+    }
+    catch {
+        // 退化边（如长度 0）读曲线参数失败 → 只留 length，不发散
+    }
+    // P0 装配前置：直边（起点+切向）/ 圆边（圆心+法向）采集轴 hint
+    const axis = captureEdgeAxis(kernel, edge);
+    if (axis)
+        hint.axis = axis;
+    return hint;
+}
+//# sourceMappingURL=geom-hint.js.map

package/dist/topology/naming/geom-hint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geom-hint.js","sourceRoot":"","sources":["../../../src/topology/naming/geom-hint.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * geom-hint.ts — 几何 hint 捕获（§3.1）\n *\n * 两路：\n * - `captureFaceHint(kernel, faceHandle)`：BREP 现场面 → FaceHint（assignRoles 用）。\n * - `faceRowToHint(row)`：面行/FaceRow → FaceHint（primitive/mesh 命名槽快照用）。\n *\n * hint 字段与 SelectorRuntime 的 FaceRow（surfaceType/area/center/normal）同源\n * （§2.2），保证 BREP 现场与面行快照两条打分路径口径一致。\n */\n\nimport type { BrepEngineApi } from '../../brep/engine/primitives'\nimport type { BrepHandle } from '../../brep/engine/types'\nimport type { FaceHint, EdgeHint, AxisHint } from './types'\n\n/** 归一化向量（axis 采集内部用；零向量返回 null，调用方放弃采集）。 */\nfunction normalizedAxis(v: [number, number, number]): [number, number, number] | null {\n  const len = Math.hypot(v[0], v[1], v[2])\n  if (len < 1e-12 || !Number.isFinite(len)) return null\n  return [v[0] / len, v[1] / len, v[2] / len]\n}\n\n/**\n * BREP 现场圆柱面 → 轴 hint（P0 装配前置）。\n *\n * 算法与 occt-kernel/topologyExt.ts getSurfaceParams 的 cylinder 分支同源：\n * direction = normalize(S(u,v+1) − S(u,v))（V 向即轴向）；origin = P − R·外法向\n *（surfaceNormal 含朝向，reversed 面先取反修正）。\n *\n * @param kernel - the OCCT kernel.\n * @param face - the cylindrical face handle.\n * @returns the axis hint, or undefined when the axis cannot be derived.\n */\nfunction captureCylinderFaceAxis(kernel: BrepEngineApi, face: BrepHandle): AxisHint | undefined {\n  try {\n    const uv = kernel.uvBounds(face)\n    const p0 = kernel.pointOnSurface(face, uv.uMin, uv.vMin)\n    const p1 = kernel.pointOnSurface(face, uv.uMin, uv.vMin + 1)\n    const direction = normalizedAxis([p1.x - p0.x, p1.y - p0.y, p1.z - p0.z])\n    const cyl = kernel.getFaceCylinderData(face)\n    if (!direction || !cyl) return undefined\n    let sn = kernel.surfaceNormal(face, uv.uMin, uv.vMin)\n    if (kernel.shapeOrientation(face) === 'reversed') {\n      sn = { x: -sn.x, y: -sn.y, z: -sn.z }\n    }\n    const origin: [number, number, number] = [\n      p0.x - cyl.radius * sn.x,\n      p0.y - cyl.radius * sn.y,\n      p0.z - cyl.radius * sn.z,\n    ]\n    return { origin, direction }\n  } catch {\n    return undefined\n  }\n}\n\n/**\n * BREP 现场圆边 → 轴 hint（origin = 圆心，direction = 所在平面法向；P0 装配前置）。\n *\n * 用曲线上三个不同参数的采样点做外接圆圆心（三点定圆，精确、无弧长近似），\n * 法向取 (p1−p0)×(p2−p0) 归一化。只用 curvePointAtParam/curveParameters 等既有\n * 公开内核 API（与 getCurveParams 的 circle 分支同一能力面），不新增内核方法。\n *\n * @param kernel - the OCCT kernel.\n * @param edge - the circular edge handle.\n * @returns the axis hint, or undefined when sampling fails.\n */\nfunction captureCircleEdgeAxis(kernel: BrepEngineApi, edge: BrepHandle): AxisHint | undefined {\n  try {\n    const { first, last } = kernel.curveParameters(edge)\n    if (!Number.isFinite(first) || !Number.isFinite(last)) return undefined\n    const d = (last - first) / 3\n    const pa = kernel.curvePointAtParam(edge, first)\n    const pb = kernel.curvePointAtParam(edge, first + d)\n    const pc = kernel.curvePointAtParam(edge, first + 2 * d)\n    const e1: [number, number, number] = [pb.x - pa.x, pb.y - pa.y, pb.z - pa.z]\n    const e2: [number, number, number] = [pc.x - pa.x, pc.y - pa.y, pc.z - pa.z]\n    // 三点外接圆：解 o = a + α·e1 + β·e2，满足 |o−a| = |o−b| = |o−c|\n    const e11 = e1[0] * e1[0] + e1[1] * e1[1] + e1[2] * e1[2]\n    const e22 = e2[0] * e2[0] + e2[1] * e2[1] + e2[2] * e2[2]\n    const e12 = e1[0] * e2[0] + e1[1] * e2[1] + e1[2] * e2[2]\n    const denom = e11 * e22 - e12 * e12\n    if (Math.abs(denom) < 1e-18) return undefined\n    const alpha = (e11 * e22 - e22 * e12) / (2 * denom)\n    const beta = (e22 * e11 - e11 * e12) / (2 * denom)\n    const origin: [number, number, number] = [\n      pa.x + alpha * e1[0] + beta * e2[0],\n      pa.y + alpha * e1[1] + beta * e2[1],\n      pa.z + alpha * e1[2] + beta * e2[2],\n    ]\n    const direction = normalizedAxis([\n      e1[1] * e2[2] - e1[2] * e2[1],\n      e1[2] * e2[0] - e1[0] * e2[2],\n      e1[0] * e2[1] - e1[1] * e2[0],\n    ])\n    if (!direction) return undefined\n    return { origin, direction }\n  } catch {\n    return undefined\n  }\n}\n\n/**\n * BREP 现场面 → FaceHint。\n *\n * 面积在 occt-wasm 无公开 API（queryBatch 仅测试用），故现场路径不填 area——\n * 打分器对缺失 area 不扣分（scorerArea 双 undefined 跳过）。\n *\n * @param kernel - the OCCT kernel.\n * @param face - the face handle to snapshot.\n * @returns the captured FaceHint.\n */\nexport function captureFaceHint(kernel: BrepEngineApi, face: BrepHandle): FaceHint {\n  const surfaceType = kernel.surfaceType(face)\n  const uv = kernel.uvBounds(face)\n  const u = (uv.uMin + uv.uMax) / 2\n  const v = (uv.vMin + uv.vMax) / 2\n  const normal = kernel.surfaceNormal(face, u, v)\n  const center = kernel.getSurfaceCenterOfMass(face)\n  // P0 装配前置：圆柱面采集轴 hint（其余面类型缺省——平面用 center+normal 即可）\n  const axis = surfaceType === 'cylinder' ? captureCylinderFaceAxis(kernel, face) : undefined\n  return {\n    kind: 'face',\n    surfaceType,\n    normal: [normal.x, normal.y, normal.z],\n    center: [center.x, center.y, center.z],\n    ...(axis ? { axis } : {}),\n  }\n}\n\n/**\n * 面行 → FaceHint（mesh/primitive 命名槽快照路径；§3.6 setTopology 注入用）。\n * 面行的 surfaceType/normal/center/area 与 BREP 现场同口径（§1.1 事实）。\n *\n * @param row - a FaceRow (or shape-compatible object) from the selector manifest.\n * @returns the FaceHint derived from the row.\n */\nexport function faceRowToHint(row: {\n  surfaceType?: string\n  normal?: readonly number[] | null\n  center?: readonly number[] | null\n  area?: number\n  axis?: { origin?: readonly number[] | null; direction?: readonly number[] | null } | null\n}): FaceHint {\n  const hint: FaceHint = {\n    kind: 'face',\n    ...(row.surfaceType !== undefined ? { surfaceType: row.surfaceType } : {}),\n    ...(row.normal && row.normal.length === 3 ? { normal: [row.normal[0], row.normal[1], row.normal[2]] as [number, number, number] } : {}),\n    ...(row.center && row.center.length === 3 ? { center: [row.center[0], row.center[1], row.center[2]] as [number, number, number] } : {}),\n    ...(row.area !== undefined && Number.isFinite(row.area) ? { area: row.area } : {}),\n    ...(row.axis?.origin && row.axis.origin.length === 3 && row.axis.direction && row.axis.direction.length === 3\n      ? {\n          axis: {\n            origin: [row.axis.origin[0], row.axis.origin[1], row.axis.origin[2]] as [number, number, number],\n            direction: [row.axis.direction[0], row.axis.direction[1], row.axis.direction[2]] as [number, number, number],\n          },\n        }\n      : {}),\n  }\n  return hint\n}\n\n/**\n * 边行 → EdgeHint（mesh/primitive 命名槽快照路径；§3.7 edgeNaming 用）。\n * EdgeRow.center 与 EdgeHint.midpoint 同口径（§3.7：边 midpoint 与 EdgeRow.center\n * 同口径，geom-hint.ts 统一采集）。\n *\n * @param row - an EdgeRow (or shape-compatible object) from the selector manifest.\n * @returns the EdgeHint derived from the row.\n */\nexport function edgeRowToHint(row: {\n  length?: number\n  center?: readonly number[] | null\n  axis?: { origin?: readonly number[] | null; direction?: readonly number[] | null } | null\n}): EdgeHint {\n  const hint: EdgeHint = {\n    kind: 'edge',\n    ...(row.length !== undefined && Number.isFinite(row.length) ? { length: row.length } : {}),\n    ...(row.center && row.center.length === 3 ? { midpoint: [row.center[0], row.center[1], row.center[2]] as [number, number, number] } : {}),\n    ...(row.axis?.origin && row.axis.origin.length === 3 && row.axis.direction && row.axis.direction.length === 3\n      ? {\n          axis: {\n            origin: [row.axis.origin[0], row.axis.origin[1], row.axis.origin[2]] as [number, number, number],\n            direction: [row.axis.direction[0], row.axis.direction[1], row.axis.direction[2]] as [number, number, number],\n          },\n        }\n      : {}),\n  }\n  return hint\n}\n\n/**\n * BREP 现场边 → EdgeHint。\n *\n * hint 是「并列裁决者」而非身份本身（§1.2），只在两邻面多公共边时用于打分。\n * length 用 `kernel.curveLength(edge)`；midpoint 取曲线参数中点的点坐标\n * （与 face 的 curvePointAtParam 同口径；屏蔽封闭/退化边的采样退化）。\n *\n * @param kernel - the OCCT kernel.\n * @param edge - the edge handle to snapshot.\n * @returns the captured EdgeHint.\n */\n/**\n * BREP 现场边 → 轴 hint（装配约束的边实体来源；P0 前置）。\n *\n * 直边：origin = 曲线起点，direction = 起点切向；\n * 圆边：origin = 圆心（三点定圆），direction = 所在平面法向；\n * 其它曲线类型 → undefined（不静默造轴）。\n *\n * @param kernel - the OCCT kernel.\n * @param edge - the edge handle.\n * @returns the axis hint, or undefined for unsupported curves / sampling failure.\n */\nexport function captureEdgeAxis(kernel: BrepEngineApi, edge: BrepHandle): AxisHint | undefined {\n  try {\n    const curveType = kernel.curveType(edge)\n    if (curveType === 'line') {\n      const { first } = kernel.curveParameters(edge)\n      const origin = kernel.curvePointAtParam(edge, first)\n      const tangent = kernel.curveTangent(edge, first)\n      const direction = normalizedAxis([tangent.x, tangent.y, tangent.z])\n      if (Number.isFinite(origin.x) && Number.isFinite(origin.y) && Number.isFinite(origin.z) && direction) {\n        return { origin: [origin.x, origin.y, origin.z], direction }\n      }\n    } else if (curveType === 'circle') {\n      return captureCircleEdgeAxis(kernel, edge)\n    }\n  } catch {\n    // 曲线类型读取失败 → 无 axis hint（调用方按缺省处理，不静默造轴）\n  }\n  return undefined\n}\n\n/**\n * 采集棱边 hint（长度 / 中点 / 轴）。\n *\n * P0 装配前置：直边（起点 + 切向）与圆边（圆心 + 所在平面法向）产出 axis hint；\n * 退化或非线/圆曲线不产出 axis（调用方按缺省处理，不静默造轴）。\n *\n * @param kernel - the BREP engine API.\n * @param edge - the edge handle.\n * @returns the captured edge hint.\n */\nexport function captureEdgeHint(kernel: BrepEngineApi, edge: BrepHandle): EdgeHint {\n  const length = kernel.curveLength(edge)\n  const hint: { kind: 'edge'; length?: number; midpoint?: [number, number, number]; axis?: AxisHint } = { kind: 'edge' }\n  if (Number.isFinite(length) && length > 0) hint.length = length\n  try {\n    const { first, last } = kernel.curveParameters(edge)\n    if (Number.isFinite(first) && Number.isFinite(last)) {\n      const mid = kernel.curvePointAtParam(edge, (first + last) / 2)\n      if (Number.isFinite(mid.x) && Number.isFinite(mid.y) && Number.isFinite(mid.z)) {\n        hint.midpoint = [mid.x, mid.y, mid.z]\n      }\n    }\n  } catch {\n    // 退化边（如长度 0）读曲线参数失败 → 只留 length，不发散\n  }\n  // P0 装配前置：直边（起点+切向）/ 圆边（圆心+法向）采集轴 hint\n  const axis = captureEdgeAxis(kernel, edge)\n  if (axis) hint.axis = axis\n  return hint\n}\n"]}

package/dist/topology/naming/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ *
+ * 跨历史身份层：TopoRef（纯数据、写进 .fai.js）+ RoleTable（运行期、不序列化）。
+ * 解析方向固定为单向：TopoRef（稳定）→ 解析器 → 当前快照的序号 FaceId/EdgeId
+ * 或活 BREP 句柄。绝不反向把序号当稳定身份存进脚本。
+ */
+export * from './types.js';
+export * from './geom-hint.js';
+export * from './score.js';
+export * from './roles.js';
+export * from './resolve-face.js';
+export * from './resolve-edge.js';
+export * from './resolve-vertex.js';
+export * from './resolve-derived.js';
+export * from './resolver.js';
+export * from './ref-params.js';
+export * from './capture-topo-ref.js';
+export * from './build-naming.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/topology/naming/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/topology/naming/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA"}

package/dist/topology/naming/index.js

@@ -0,0 +1,19 @@
+/**
+ *
+ * 跨历史身份层：TopoRef（纯数据、写进 .fai.js）+ RoleTable（运行期、不序列化）。
+ * 解析方向固定为单向：TopoRef（稳定）→ 解析器 → 当前快照的序号 FaceId/EdgeId
+ * 或活 BREP 句柄。绝不反向把序号当稳定身份存进脚本。
+ */
+export * from './types.js';
+export * from './geom-hint.js';
+export * from './score.js';
+export * from './roles.js';
+export * from './resolve-face.js';
+export * from './resolve-edge.js';
+export * from './resolve-vertex.js';
+export * from './resolve-derived.js';
+export * from './resolver.js';
+export * from './ref-params.js';
+export * from './capture-topo-ref.js';
+export * from './build-naming.js';
+//# sourceMappingURL=index.js.map

package/dist/topology/naming/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/topology/naming/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA","sourcesContent":["/**\n *\n * 跨历史身份层：TopoRef（纯数据、写进 .fai.js）+ RoleTable（运行期、不序列化）。\n * 解析方向固定为单向：TopoRef（稳定）→ 解析器 → 当前快照的序号 FaceId/EdgeId\n * 或活 BREP 句柄。绝不反向把序号当稳定身份存进脚本。\n */\n\nexport * from './types'\nexport * from './geom-hint'\nexport * from './score'\nexport * from './roles'\nexport * from './resolve-face'\nexport * from './resolve-edge'\nexport * from './resolve-vertex'\nexport * from './resolve-derived'\nexport * from './resolver'\nexport * from './ref-params'\nexport * from './capture-topo-ref'\nexport * from './build-naming'\n"]}

package/dist/topology/naming/ref-params.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ref-params.ts — 递归把 op 参数里的 TopoRef 替换为解析后的 {ordinal/handle}
+ * （移植 brepjs refResolveFns.resolveRefParams，§3.6）
+ *
+ * 区别于 brepjs「仅单输入自动解析」：faijs 的 TopoRef 自带 origin（§2.2），
+ * 多输入布尔也能按 origin 定位到对应输入 Shape 的命名槽，因此可支持多输入。
+ *
+ * 解析失败抛 TopoRefError（三态错误码），纳入 args 校验——不静默留原值。
+ */
+import { type TopoRef } from './types.js';
+import { type ResolutionContext } from './resolver.js';
+/** 按 TopoRef.origin 取解析上下文的查找函数（调用方把输入 Shape 的命名槽登记进来）。 */
+export type ContextLookup = (origin: string) => ResolutionContext | undefined;
+/**
+ * 结构判定：是否 TopoRef 四类之一。
+ *
+ * @param v - the value to test.
+ * @returns true when the value is one of the four TopoRef kinds.
+ */
+export declare function isTopoRef(v: unknown): v is TopoRef;
+/**
+ * 递归解析一个值（TopoRef → {ordinal, handle}；数组/嵌套对象下钻）。
+ *
+ * @param value - the value to resolve (may contain TopoRefs anywhere).
+ * @param lookup - maps a TopoRef origin to its resolution context.
+ * @returns the value with TopoRefs replaced by {ordinal, handle}.
+ */
+export declare function resolveTopoValue(value: unknown, lookup: ContextLookup): unknown;
+/**
+ * 取 TopoRef 的 origin（§2.2）：
+ * - face：ref.origin（单一链根）；
+ * - edge/vertex/derived-face：无单一 origin 字段，取 faces/between[0].origin
+ *   （faijs 扩展，多输入定位用）。
+ *
+ * @param ref - the TopoRef.
+ * @returns the origin string used for context lookup.
+ */
+export declare function originOf(ref: TopoRef): string;
+/**
+ * 递归把 op 参数里的 TopoRef 替换为解析后的 {ordinal, handle}。
+ *
+ * 参数对象原样返回一个新对象；不改变原对象。解析失败抛 TopoRefError。
+ *
+ * @param params - the op's parameter table (user args; TopoRefs inside are resolved).
+ * @param lookup - maps a TopoRef origin to its resolution context.
+ * @returns the resolved parameter table.
+ */
+export declare function resolveTopoArgs(params: Readonly<Record<string, unknown>>, lookup: ContextLookup): Record<string, unknown>;
+//# sourceMappingURL=ref-params.d.ts.map

package/dist/topology/naming/ref-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-params.d.ts","sourceRoot":"","sources":["../../../src/topology/naming/ref-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAgB,KAAK,OAAO,EAAE,MAAM,SAAS,CAAA;AACpD,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnE,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAA;AAE7E;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,OAAO,CAIlD;AASD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAqB/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQ7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,MAAM,EAAE,aAAa,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB"}

package/dist/topology/naming/ref-params.js

@@ -0,0 +1,92 @@
+/**
+ * ref-params.ts — 递归把 op 参数里的 TopoRef 替换为解析后的 {ordinal/handle}
+ * （移植 brepjs refResolveFns.resolveRefParams，§3.6）
+ *
+ * 区别于 brepjs「仅单输入自动解析」：faijs 的 TopoRef 自带 origin（§2.2），
+ * 多输入布尔也能按 origin 定位到对应输入 Shape 的命名槽，因此可支持多输入。
+ *
+ * 解析失败抛 TopoRefError（三态错误码），纳入 args 校验——不静默留原值。
+ */
+import { TopoRefError } from './types.js';
+import { resolveTopoRef } from './resolver.js';
+/**
+ * 结构判定：是否 TopoRef 四类之一。
+ *
+ * @param v - the value to test.
+ * @returns true when the value is one of the four TopoRef kinds.
+ */
+export function isTopoRef(v) {
+    if (typeof v !== 'object' || v === null)
+        return false;
+    const kind = v.kind;
+    return kind === 'face' || kind === 'edge' || kind === 'vertex' || kind === 'derived-face';
+}
+/** 可递归的普通对象（非 TopoRef、非数组、非类实例）。 */
+function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+/**
+ * 递归解析一个值（TopoRef → {ordinal, handle}；数组/嵌套对象下钻）。
+ *
+ * @param value - the value to resolve (may contain TopoRefs anywhere).
+ * @param lookup - maps a TopoRef origin to its resolution context.
+ * @returns the value with TopoRefs replaced by {ordinal, handle}.
+ */
+export function resolveTopoValue(value, lookup) {
+    if (isTopoRef(value)) {
+        const origin = originOf(value);
+        const ctx = lookup(origin);
+        if (!ctx) {
+            // origin 没有对应输入 Shape 的命名槽 → 无法定位（引用错误，抛错而非静默）
+            throw new TopoRefError('E_TOPO_NOT_FOUND', value.kind, `topo ref origin "${origin}" has no input shape in this op`);
+        }
+        return resolveTopoRef(value, ctx);
+    }
+    if (Array.isArray(value))
+        return value.map((v) => resolveTopoValue(v, lookup));
+    if (isPlainObject(value)) {
+        const nested = {};
+        for (const [k, v] of Object.entries(value))
+            nested[k] = resolveTopoValue(v, lookup);
+        return nested;
+    }
+    return value;
+}
+/**
+ * 取 TopoRef 的 origin（§2.2）：
+ * - face：ref.origin（单一链根）；
+ * - edge/vertex/derived-face：无单一 origin 字段，取 faces/between[0].origin
+ *   （faijs 扩展，多输入定位用）。
+ *
+ * @param ref - the TopoRef.
+ * @returns the origin string used for context lookup.
+ */
+export function originOf(ref) {
+    if (ref.kind === 'edge' || ref.kind === 'vertex') {
+        return ref.faces[0]?.origin ?? '';
+    }
+    if (ref.kind === 'derived-face') {
+        return ref.between[0]?.origin ?? '';
+    }
+    return ref.origin;
+}
+/**
+ * 递归把 op 参数里的 TopoRef 替换为解析后的 {ordinal, handle}。
+ *
+ * 参数对象原样返回一个新对象；不改变原对象。解析失败抛 TopoRefError。
+ *
+ * @param params - the op's parameter table (user args; TopoRefs inside are resolved).
+ * @param lookup - maps a TopoRef origin to its resolution context.
+ * @returns the resolved parameter table.
+ */
+export function resolveTopoArgs(params, lookup) {
+    const out = {};
+    for (const [key, value] of Object.entries(params)) {
+        out[key] = resolveTopoValue(value, lookup);
+    }
+    return out;
+}
+//# sourceMappingURL=ref-params.js.map

package/dist/topology/naming/ref-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-params.js","sourceRoot":"","sources":["../../../src/topology/naming/ref-params.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ref-params.ts — 递归把 op 参数里的 TopoRef 替换为解析后的 {ordinal/handle}\n * （移植 brepjs refResolveFns.resolveRefParams，§3.6）\n *\n * 区别于 brepjs「仅单输入自动解析」：faijs 的 TopoRef 自带 origin（§2.2），\n * 多输入布尔也能按 origin 定位到对应输入 Shape 的命名槽，因此可支持多输入。\n *\n * 解析失败抛 TopoRefError（三态错误码），纳入 args 校验——不静默留原值。\n */\n\nimport { TopoRefError, type TopoRef } from './types'\nimport { resolveTopoRef, type ResolutionContext } from './resolver'\n\n/** 按 TopoRef.origin 取解析上下文的查找函数（调用方把输入 Shape 的命名槽登记进来）。 */\nexport type ContextLookup = (origin: string) => ResolutionContext | undefined\n\n/**\n * 结构判定：是否 TopoRef 四类之一。\n *\n * @param v - the value to test.\n * @returns true when the value is one of the four TopoRef kinds.\n */\nexport function isTopoRef(v: unknown): v is TopoRef {\n  if (typeof v !== 'object' || v === null) return false\n  const kind = (v as { kind?: unknown }).kind\n  return kind === 'face' || kind === 'edge' || kind === 'vertex' || kind === 'derived-face'\n}\n\n/** 可递归的普通对象（非 TopoRef、非数组、非类实例）。 */\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) return false\n  const proto = Object.getPrototypeOf(value) as object | null\n  return proto === Object.prototype || proto === null\n}\n\n/**\n * 递归解析一个值（TopoRef → {ordinal, handle}；数组/嵌套对象下钻）。\n *\n * @param value - the value to resolve (may contain TopoRefs anywhere).\n * @param lookup - maps a TopoRef origin to its resolution context.\n * @returns the value with TopoRefs replaced by {ordinal, handle}.\n */\nexport function resolveTopoValue(value: unknown, lookup: ContextLookup): unknown {\n  if (isTopoRef(value)) {\n    const origin = originOf(value)\n    const ctx = lookup(origin)\n    if (!ctx) {\n      // origin 没有对应输入 Shape 的命名槽 → 无法定位（引用错误，抛错而非静默）\n      throw new TopoRefError(\n        'E_TOPO_NOT_FOUND',\n        value.kind,\n        `topo ref origin \"${origin}\" has no input shape in this op`,\n      )\n    }\n    return resolveTopoRef(value, ctx)\n  }\n  if (Array.isArray(value)) return value.map((v) => resolveTopoValue(v, lookup))\n  if (isPlainObject(value)) {\n    const nested: Record<string, unknown> = {}\n    for (const [k, v] of Object.entries(value)) nested[k] = resolveTopoValue(v, lookup)\n    return nested\n  }\n  return value\n}\n\n/**\n * 取 TopoRef 的 origin（§2.2）：\n * - face：ref.origin（单一链根）；\n * - edge/vertex/derived-face：无单一 origin 字段，取 faces/between[0].origin\n *   （faijs 扩展，多输入定位用）。\n *\n * @param ref - the TopoRef.\n * @returns the origin string used for context lookup.\n */\nexport function originOf(ref: TopoRef): string {\n  if (ref.kind === 'edge' || ref.kind === 'vertex') {\n    return ref.faces[0]?.origin ?? ''\n  }\n  if (ref.kind === 'derived-face') {\n    return ref.between[0]?.origin ?? ''\n  }\n  return ref.origin\n}\n\n/**\n * 递归把 op 参数里的 TopoRef 替换为解析后的 {ordinal, handle}。\n *\n * 参数对象原样返回一个新对象；不改变原对象。解析失败抛 TopoRefError。\n *\n * @param params - the op's parameter table (user args; TopoRefs inside are resolved).\n * @param lookup - maps a TopoRef origin to its resolution context.\n * @returns the resolved parameter table.\n */\nexport function resolveTopoArgs(\n  params: Readonly<Record<string, unknown>>,\n  lookup: ContextLookup,\n): Record<string, unknown> {\n  const out: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(params)) {\n    out[key] = resolveTopoValue(value, lookup)\n  }\n  return out\n}\n"]}

package/dist/topology/naming/resolve-derived.d.ts

@@ -0,0 +1,23 @@
+/**
+ * resolve-derived.ts — 生成面（倒角/圆角过渡面）TopoRef 解析
+ * （移植 brepjs derivedFaceRefFns，§4.5）
+ *
+ * 生成面没有稳定 hash（操作前不存在，fillet/chamfer 演化为空），
+ * 以「桥接的两面」lineage 命名：解析 = 重找被桥接的两面 → 取同时邻接
+ * 两者的面 → 法向混合过滤（过渡面法向同时正比于两条被桥接法向，
+ * 正交的侧面被拒绝）→ 边中点裁决并列。
+ */
+import type { BrepHandle } from '../../brep/engine/types.js';
+import type { DerivedFaceTopoRef, TopoResolution } from './types.js';
+import type { ResolutionContext } from './resolve-face.js';
+/**
+ * 解析生成面 TopoRef 到当前快照的面序号。
+ *
+ * @param ref - the derived-face TopoRef to resolve.
+ * @param ctx - the resolution context (needs faceAdjacency for lineage).
+ * @returns the three-state TopoResolution with the face ordinal.
+ */
+export declare function resolveDerivedFaceTopo(ref: DerivedFaceTopoRef, ctx: ResolutionContext): TopoResolution<{
+    handle?: BrepHandle;
+}>;
+//# sourceMappingURL=resolve-derived.d.ts.map

package/dist/topology/naming/resolve-derived.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-derived.d.ts","sourceRoot":"","sources":["../../../src/topology/naming/resolve-derived.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACjE,OAAO,KAAK,EAAsB,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAoB3E;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,kBAAkB,EACvB,GAAG,EAAE,iBAAiB,GACrB,cAAc,CAAC;IAAE,MAAM,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC,CAiCzC"}