@faicad/faijs 0.16.0 → 0.17.0

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

@@ -1 +1 @@
-{"version":3,"file":"score.js","sourceRoot":"","sources":["../../../src/topology/naming/score.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * score.ts — 面候选打分器（移植 brepjs src/topology/shapeRef/scoring.ts）\n *\n * 两套实现，口径一致、结果可比（§3.5）：\n * - `defaultFaceScorer`：BREP 现场几何（kernel 计算 surfaceType/normal/center/area）\n * - `scoreFaceRow`：mesh/primitive 面行快照（FaceRow 或命名槽 FaceHint）\n *\n * 阈值常量化并写明 mm 单位假设——faijs 契约就是 mm，可直接沿用 brepjs 阈值。\n */\n\nimport type { BrepEngineApi } from '../../brep/engine/primitives'\nimport type { BrepHandle } from '../../brep/engine/types'\nimport type { FaceHint } from './types'\n\n/** 打分函数：分越高越匹配；-Infinity 直接拒绝。 */\nexport type FaceScorer = (hint: FaceHint, candidate: FaceCandidate) => number\n\n/** 打分候选：BREP 现场句柄 或 mesh/primitive 面行快照，二选一。 */\nexport interface FaceCandidate {\n  /** BREP 现场面句柄（走 kernel 现场几何）。 */\n  readonly handle?: BrepHandle\n  /** 面行快照（mesh/primitive；与 handle 二选一）。 */\n  readonly row?: Readonly<{\n    surfaceType?: string\n    normal?: readonly number[]\n    center?: readonly number[]\n    area?: number\n  }>\n}\n\n/** 曲面类型不符直接拒绝（硬门）。 */\nconst TYPE_MISMATCH = -Infinity\n/** 法向点积下限（拒绝阈值）。 */\nconst NORMAL_DOT_MIN = 0.707\n/** 质心距²上限（mm²；拒绝阈值）。 */\nconst CENTROID_DIST_SQ_MAX = 100\n/** 面积 |log 比| 超此值扣分。 */\nconst AREA_LOG_RATIO_MAX = 1.0\n/** 几何兜底接受的最小分。 */\nexport const MIN_SCORE = 0.5\n/** 并列模糊带：两候选分差小于此值视为并列（→ ambiguous）。 */\nexport const AMBIGUITY_THRESHOLD = 0.1\n\n/** 从候选读取几何量的统一入口（handle 优先，row 兜底）。 */\nfunction candidateGeometry(\n  kernel: BrepEngineApi | null,\n  candidate: FaceCandidate,\n): { surfaceType?: string; normal?: readonly number[]; center?: readonly number[]; area?: number } {\n  if (candidate.handle !== undefined && kernel) {\n    const center = kernel.getSurfaceCenterOfMass(candidate.handle)\n    const uv = kernel.uvBounds(candidate.handle)\n    const u = (uv.uMin + uv.uMax) / 2\n    const v = (uv.vMin + uv.vMax) / 2\n    const normal = kernel.surfaceNormal(candidate.handle, u, v)\n    return {\n      surfaceType: kernel.surfaceType(candidate.handle),\n      normal: [normal.x, normal.y, normal.z],\n      center: [center.x, center.y, center.z],\n      area: faceAreaOf(kernel, candidate.handle),\n    }\n  }\n  return candidate.row ?? {}\n}\n\n/** 面面积：BREP 现场无直接 API，用包围盒近似不可靠——退化为 undefined（不打分）。 */\nfunction faceAreaOf(_kernel: BrepEngineApi, _face: BrepHandle): number | undefined {\n  // occt-wasm 无公开 face area API（queryBatch 仅测试用、返回 {area} 但生产路径零调用）。\n  // hint 携带的 area 仍参与面积比扣分（见 scorerArea），此处返回 undefined 表示「现场未知」。\n  return undefined\n}\n\n/** 面积比扣分（hint.area 已知且 >0 时）。 */\nfunction scorerArea(hint: FaceHint, area: number | undefined): number {\n  if (hint.area === undefined || hint.area <= 0) return 0\n  if (area === undefined || area <= 0) return 0\n  const logRatio = Math.abs(Math.log(hint.area / area))\n  return logRatio > AREA_LOG_RATIO_MAX ? -logRatio : 0\n}\n\n/**\n * 打分一条候选（共用于 BREP 现场与面行快照两路）。\n *\n * @param kernel - OCCT 内核（candidate.handle 路径需要；row 路径可传 null）。\n * @param hint - 被解析 TopoRef 携带的面 hint。\n * @param candidate - 候选（句柄或面行）。\n * @returns 综合分；-Infinity 表示硬性不匹配。\n */\nexport function scoreCandidate(\n  kernel: BrepEngineApi | null,\n  hint: FaceHint,\n  candidate: FaceCandidate,\n): number {\n  let score = 0\n  const g = candidateGeometry(kernel, candidate)\n\n  // 曲面类型硬门\n  if (hint.surfaceType !== undefined) {\n    if (g.surfaceType === hint.surfaceType) {\n      score += 1.0\n    } else {\n      return TYPE_MISMATCH\n    }\n  }\n\n  // 法向点积\n  if (hint.normal !== undefined && g.normal !== undefined) {\n    const dot =\n      hint.normal[0] * g.normal[0] +\n      hint.normal[1] * g.normal[1] +\n      hint.normal[2] * g.normal[2]\n    if (dot < NORMAL_DOT_MIN) return TYPE_MISMATCH\n    score += dot\n  }\n\n  // 质心距²惩罚\n  if (hint.center !== undefined && g.center !== undefined) {\n    const dx = hint.center[0] - g.center[0]\n    const dy = hint.center[1] - g.center[1]\n    const dz = hint.center[2] - g.center[2]\n    const distSq = dx * dx + dy * dy + dz * dz\n    if (distSq > CENTROID_DIST_SQ_MAX) return TYPE_MISMATCH\n    score -= distSq / 100\n  }\n\n  // 面积比扣分\n  score += scorerArea(hint, g.area)\n\n  return score\n}\n\n/**\n * BREP 现场打分器（§3.5 defaultFaceScorer 移植）：候选是活句柄，几何现场算。\n * 保持与 scoreFaceRow 同一套权重，保证两路结果可比。\n */\n/**\n * Build a scorer that computes geometry live from a BREP kernel handle.\n *\n * @param kernel - the OCCT kernel used to evaluate candidate face geometry.\n * @returns a FaceScorer scoring live face handles against a FaceHint.\n */\nexport function defaultFaceScorer(kernel: BrepEngineApi): FaceScorer {\n  return (hint, candidate) => scoreCandidate(kernel, hint, candidate)\n}\n\n/**\n * 面行/命名槽快照打分器（§3.5 scoreFaceRow）：候选是 FaceRow/hint 快照，\n * 用于 mesh/primitive（无 kernel 现场几何）。\n *\n * @param hint - the FaceHint carried by the TopoRef being resolved.\n * @param row - the candidate face-row snapshot (surfaceType/normal/center/area).\n * @returns the combined score; -Infinity rejects the candidate outright.\n */\nexport function scoreFaceRow(hint: FaceHint, row: FaceCandidate['row']): number {\n  return scoreCandidate(null, hint, { row })\n}\n"]}
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../../src/topology/naming/score.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * score.ts — 面候选打分器（移植 brepjs src/topology/shapeRef/scoring.ts）\n *\n * 两套实现，口径一致、结果可比（§3.5）：\n * - `defaultFaceScorer`：BREP 现场几何（kernel 计算 surfaceType/normal/center/area）\n * - `scoreFaceRow`：mesh/primitive 面行快照（FaceRow 或命名槽 FaceHint）\n *\n * 阈值常量化并写明 mm 单位假设——faijs 契约就是 mm，可直接沿用 brepjs 阈值。\n */\n\nimport type { BrepEngineApi } from '../../brep/engine/primitives'\nimport type { BrepHandle } from '../../brep/engine/types'\nimport type { FaceHint } from './types'\n\n/** 打分函数：分越高越匹配；-Infinity 直接拒绝。 */\nexport type FaceScorer = (hint: FaceHint, candidate: FaceCandidate) => number\n\n/** 打分候选：BREP 现场句柄 或 mesh/primitive 面行快照，二选一。 */\nexport interface FaceCandidate {\n  /** BREP 现场面句柄（走 kernel 现场几何）。 */\n  readonly handle?: BrepHandle\n  /** 面行快照（mesh/primitive；与 handle 二选一）。 */\n  readonly row?: Readonly<{\n    surfaceType?: string\n    normal?: readonly number[]\n    center?: readonly number[]\n    area?: number\n  }>\n}\n\n/** 曲面类型不符直接拒绝（硬门）。 */\nconst TYPE_MISMATCH = -Infinity\n/** 法向点积下限（拒绝阈值）。 */\nconst NORMAL_DOT_MIN = 0.707\n/** 质心距²上限（mm²；拒绝阈值）。 */\nconst CENTROID_DIST_SQ_MAX = 100\n/** 面积 |log 比| 超此值扣分。 */\nconst AREA_LOG_RATIO_MAX = 1.0\n/** 几何兜底接受的最小分。 */\nexport const MIN_SCORE = 0.5\n/** 并列模糊带：两候选分差小于此值视为并列（→ ambiguous）。 */\nexport const AMBIGUITY_THRESHOLD = 0.1\n\n/** 从候选读取几何量的统一入口（handle 优先，row 兜底）。 */\nfunction candidateGeometry(\n  kernel: BrepEngineApi | null,\n  candidate: FaceCandidate,\n): { surfaceType?: string; normal?: readonly number[]; center?: readonly number[]; area?: number } {\n  if (candidate.handle !== undefined && kernel) {\n    const center = kernel.surfaceCenterOfMass(candidate.handle)\n    const uv = kernel.uvBounds(candidate.handle)\n    const u = (uv.uMin + uv.uMax) / 2\n    const v = (uv.vMin + uv.vMax) / 2\n    const normal = kernel.surfaceNormal(candidate.handle, u, v)\n    return {\n      surfaceType: kernel.surfaceType(candidate.handle),\n      normal: [normal.x, normal.y, normal.z],\n      center: [center.x, center.y, center.z],\n      area: faceAreaOf(kernel, candidate.handle),\n    }\n  }\n  return candidate.row ?? {}\n}\n\n/** 面面积：BREP 现场无直接 API，用包围盒近似不可靠——退化为 undefined（不打分）。 */\nfunction faceAreaOf(_kernel: BrepEngineApi, _face: BrepHandle): number | undefined {\n  // occt-wasm 无公开 face area API（queryBatch 仅测试用、返回 {area} 但生产路径零调用）。\n  // hint 携带的 area 仍参与面积比扣分（见 scorerArea），此处返回 undefined 表示「现场未知」。\n  return undefined\n}\n\n/** 面积比扣分（hint.area 已知且 >0 时）。 */\nfunction scorerArea(hint: FaceHint, area: number | undefined): number {\n  if (hint.area === undefined || hint.area <= 0) return 0\n  if (area === undefined || area <= 0) return 0\n  const logRatio = Math.abs(Math.log(hint.area / area))\n  return logRatio > AREA_LOG_RATIO_MAX ? -logRatio : 0\n}\n\n/**\n * 打分一条候选（共用于 BREP 现场与面行快照两路）。\n *\n * @param kernel - OCCT 内核（candidate.handle 路径需要；row 路径可传 null）。\n * @param hint - 被解析 TopoRef 携带的面 hint。\n * @param candidate - 候选（句柄或面行）。\n * @returns 综合分；-Infinity 表示硬性不匹配。\n */\nexport function scoreCandidate(\n  kernel: BrepEngineApi | null,\n  hint: FaceHint,\n  candidate: FaceCandidate,\n): number {\n  let score = 0\n  const g = candidateGeometry(kernel, candidate)\n\n  // 曲面类型硬门\n  if (hint.surfaceType !== undefined) {\n    if (g.surfaceType === hint.surfaceType) {\n      score += 1.0\n    } else {\n      return TYPE_MISMATCH\n    }\n  }\n\n  // 法向点积\n  if (hint.normal !== undefined && g.normal !== undefined) {\n    const dot =\n      hint.normal[0] * g.normal[0] +\n      hint.normal[1] * g.normal[1] +\n      hint.normal[2] * g.normal[2]\n    if (dot < NORMAL_DOT_MIN) return TYPE_MISMATCH\n    score += dot\n  }\n\n  // 质心距²惩罚\n  if (hint.center !== undefined && g.center !== undefined) {\n    const dx = hint.center[0] - g.center[0]\n    const dy = hint.center[1] - g.center[1]\n    const dz = hint.center[2] - g.center[2]\n    const distSq = dx * dx + dy * dy + dz * dz\n    if (distSq > CENTROID_DIST_SQ_MAX) return TYPE_MISMATCH\n    score -= distSq / 100\n  }\n\n  // 面积比扣分\n  score += scorerArea(hint, g.area)\n\n  return score\n}\n\n/**\n * BREP 现场打分器（§3.5 defaultFaceScorer 移植）：候选是活句柄，几何现场算。\n * 保持与 scoreFaceRow 同一套权重，保证两路结果可比。\n */\n/**\n * Build a scorer that computes geometry live from a BREP kernel handle.\n *\n * @param kernel - the OCCT kernel used to evaluate candidate face geometry.\n * @returns a FaceScorer scoring live face handles against a FaceHint.\n */\nexport function defaultFaceScorer(kernel: BrepEngineApi): FaceScorer {\n  return (hint, candidate) => scoreCandidate(kernel, hint, candidate)\n}\n\n/**\n * 面行/命名槽快照打分器（§3.5 scoreFaceRow）：候选是 FaceRow/hint 快照，\n * 用于 mesh/primitive（无 kernel 现场几何）。\n *\n * @param hint - the FaceHint carried by the TopoRef being resolved.\n * @param row - the candidate face-row snapshot (surfaceType/normal/center/area).\n * @returns the combined score; -Infinity rejects the candidate outright.\n */\nexport function scoreFaceRow(hint: FaceHint, row: FaceCandidate['row']): number {\n  return scoreCandidate(null, hint, { row })\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faicad/faijs",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -9,9 +9,7 @@
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "bin": {
-    "faijs-fcstd-convert": "./dist/fcstd/cli.js"
-  },
+  "bin": {},
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -49,14 +47,6 @@
       "types": "./dist/sdf.d.ts",
       "default": "./dist/sdf.js"
     },
-    "./fcstd": {
-      "types": "./dist/fcstd/index.d.ts",
-      "default": "./dist/fcstd/index.js"
-    },
-    "./fcstd-convert": {
-      "types": "./dist/fcstd-convert.d.ts",
-      "default": "./dist/fcstd-convert.js"
-    },
     "./node": {
       "types": "./dist/node.d.ts",
       "default": "./dist/node.js"
@@ -128,6 +118,10 @@
     "./boolean/*": {
       "types": "./dist/boolean/*.d.ts",
       "default": "./dist/boolean/*.js"
+    },
+    "./env-agnostic": {
+      "types": "./dist/env-agnostic.d.ts",
+      "default": "./dist/env-agnostic.js"
     }
   },
   "files": [
@@ -136,11 +130,8 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@salusoft89/planegcs": "1.2.0",
     "@xmldom/xmldom": "^0.9.8",
     "acorn": "^8.18.0",
-    "fflate": "^0.8.2",
-    "flatbush": "^4.6.2",
     "manifold-3d": "^3.5.1",
     "opentype.js": "^1.3.4"
   },
@@ -162,7 +153,6 @@
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "lint": "eslint src",
-    "fcstd:convert": "tsx src/fcstd/cli.ts",
     "gen:capability-map": "tsx scripts/gen-capability-map.ts",
     "gen:brepkit-surface": "tsx scripts/gen-brepkit-surface.ts"
   }