@faicad/faijs 0.22.2 → 0.29.5

package/dist/brep/mesh-solid.js

@@ -0,0 +1,229 @@
+/**
+ * mesh-solid — 网格实体（mesh solid）与其网格后端端口
+ *
+ *
+ * 名词边界（方案 §3.1）：
+ * - **网格实体** = 由网格文件导入、经「规范化」得到的引擎实体。它是**近似拓扑**
+ *   的载体，不是精度链的一环；永不进 `brepChain.solidCache`。
+ * - **规范化** = `importIndexedMesh` → `weldShellsAndFaces(tol)` → `unifyFaces()`。
+ *   **顺序不可交换**：先 `unifyFaces` 会把实体做坏（体积归零），防回归用例见
+ *   `brepkit-kernel/mesh-solid-topology.test.ts`。
+ * - **网格后端** = 提供网格实体能力的引擎侧组件（本期即 brepkit 的网格用法）。
+ *   与 BREP 引擎**同名不同用**：可能同一个 wasm 实例，但走 mesh 语义路径。
+ *
+ * 本模块只依赖 L1（`engine/types`、`engine/primitives`）与拓扑构建器；后端实现
+ * 放在适配器侧（`brep/engine/adapters/brepkit`），因此本模块自身不含任何内核私有
+ * 调用——`MeshSolidKernelOps` 是内核私有原语的端口（L1 契约不含 weld/unify）。
+ */
+import { buildTopologyFromMesh } from './brep-topology.js';
+// ── 规范化驱动（引擎中立，供适配器的 MeshSolidBackend 实现复用） ──
+/** 与显示 mesh 一致的默认三角化参数（`buildSolidTopologyRuntime` 同源）。 */
+const DISPLAY_LINEAR_DEFLECTION = 0.1;
+const DISPLAY_ANGULAR_DEFLECTION = (2 * Math.PI) / 32;
+/**
+ * 由包围盒对角线导出焊接容差（方案 §3.3）。
+ *
+ * 下限 1e-6 兜住退化 bbox（单点/零厚网格）；上不封顶——超大模型需要更粗的
+ * 缝合半径才缝得上（float32 坐标的相对误差随尺度线性增长）。
+ *
+ * @param kernel - the L1 kernel API (bbox query only).
+ * @param shape - the raw imported shape.
+ * @returns the weld tolerance derived from the bounding-box diagonal.
+ */
+export function weldToleranceFor(kernel, shape) {
+    const bb = kernel.getBoundingBox(shape, false);
+    const dx = bb.xmax - bb.xmin;
+    const dy = bb.ymax - bb.ymin;
+    const dz = bb.zmax - bb.zmin;
+    const diag = Math.sqrt(dx * dx + dy * dy + dz * dz);
+    return Math.max(1e-6, diag * 1e-6);
+}
+/**
+ * 规范化：`importMesh` → `weld` → `unify`，再校验并三角化。
+ *
+ * 三条硬约束，都是 Phase 0 实测结论：
+ * 1. **顺序不可交换**——先 unify 再 weld 会得到体积归零的坏实体；
+ * 2. `unify` **原地修改**，返回值是合并面数，不是句柄；
+ * 3. 校验用 `isValid`（weld 后必须合法），不合法即抛错——开放/非流形网格必须
+ *    在导入处失败，不能静默退化成"无拓扑的裸网格"（那会让所有下游 mesh op
+ *    失去选择能力）。
+ *
+ * @param backend - the mesh backend providing ops + kernel.
+ * @param mesh - the source triangle mesh.
+ * @param opts - optional weld tolerance / tessellation overrides.
+ * @returns the normalized mesh solid, its tessellation, and element counts.
+ * @throws {Error} `E_MESH_SOLID_UNWELDABLE` when welding leaves an invalid solid.
+ */
+export function normalizeMeshSolid(backend, mesh, opts) {
+    const { kernel, ops } = backend;
+    const raw = ops.importMesh(mesh.positions, mesh.indices);
+    const tolerance = opts?.weldTolerance ?? weldToleranceFor(kernel, raw);
+    const faces = kernel.getSubShapes(raw, 'face');
+    const welded = ops.weld(faces, tolerance);
+    // 原地修改：返回值是合并掉的面数。绝不能把它当句柄。
+    const mergedFaceCount = ops.unify(welded);
+    if (!kernel.isValid(welded)) {
+        // 原始实体（逐三角形、边不共享）在 weld 前就不合法是正常的；weld 后仍不合法
+        // 说明网格本身开放/非流形/自交——这是**必须暴露的导入失败**，不是可降级状态。
+        try {
+            backend.release(raw);
+        }
+        catch { /* already released */ }
+        throw new Error(`E_MESH_SOLID_UNWELDABLE: welded mesh is still an invalid solid (tolerance=${tolerance}) — ` +
+            'the source mesh is open, non-manifold or self-intersecting');
+    }
+    // 焊接后原始逐三角形实体已无用；及时释放，避免句柄堆积（新路径不得添泄漏）。
+    try {
+        backend.release(raw);
+    }
+    catch { /* already released */ }
+    const tess = kernel.meshShape(welded, {
+        linearDeflection: opts?.linearDeflection ?? DISPLAY_LINEAR_DEFLECTION,
+        angularDeflection: opts?.angularDeflection ?? DISPLAY_ANGULAR_DEFLECTION,
+    });
+    return {
+        solid: welded,
+        mesh: tess,
+        faceCount: kernel.getSubShapes(welded, 'face').length,
+        edgeCount: kernel.getSubShapes(welded, 'edge').length,
+        vertexCount: kernel.getSubShapes(welded, 'vertex').length,
+        weldTolerance: tolerance,
+        mergedFaceCount,
+    };
+}
+/**
+ * 已存在的网格实体 → 结果描述（三角化 + 计数）。
+ *
+ * Phase 2 的 mesh op 产出的新实体走这里：**一次**三角化同时喂显示与拓扑，
+ * 保证 `faceRuns` 与所见三角形一一对应（规则 1）。重复调 `describe` 会得到
+ * 另一份三角化结果——同一实体在同一参数下确定性一致，但仍应复用同一份结果。
+ *
+ * @param backend - the mesh backend.
+ * @param solid - an existing mesh solid handle.
+ * @param opts - optional tessellation overrides.
+ * @returns the mesh solid result carrying the shared tessellation.
+ */
+export function describeMeshSolid(backend, solid, opts) {
+    const { kernel } = backend;
+    const tess = kernel.meshShape(solid, {
+        linearDeflection: opts?.linearDeflection ?? DISPLAY_LINEAR_DEFLECTION,
+        angularDeflection: opts?.angularDeflection ?? DISPLAY_ANGULAR_DEFLECTION,
+    });
+    return {
+        solid,
+        mesh: tess,
+        faceCount: kernel.getSubShapes(solid, 'face').length,
+        edgeCount: kernel.getSubShapes(solid, 'edge').length,
+        vertexCount: kernel.getSubShapes(solid, 'vertex').length,
+        weldTolerance: 0,
+        mergedFaceCount: 0,
+    };
+}
+/**
+ * 网格实体 → 近似拓扑数据（`SelectorRuntimeData`）。
+ *
+ * 复用 BREP 路径同源的 `buildTopologyFromMesh`（方案 §1.3 实测：产物与 BREP
+ * 路径同构——同样的 FaceRow/EdgeRow 字段、同样的 `faceStart/faceCount` 邻接）。
+ * **不引入第二套拓扑表示。**
+ *
+ * @param backend - the mesh backend (kernel + release).
+ * @param result - the normalized mesh solid result (carries the shared tessellation).
+ * @returns the serializable selector runtime data.
+ */
+export function buildMeshSolidTopology(backend, result) {
+    return buildTopologyFromMesh(backend.kernel, result.solid, result.mesh);
+}
+// ── 注册表（生命周期，与 brepChain.solidCache 并列且互不干扰） ──
+/**
+ * 网格实体句柄注册表（`PartName → BrepHandle`）。
+ *
+ * 与 `brepChain.solidCache` 的差别：本表**永不**参与 BREP 精度链判定——
+ * 它存在只表示"该 part 是网格零件，携带近似拓扑"。释放语义与 solidCache 对齐：
+ * `set` 覆盖不释放（旧句柄可能仍被旧输出 Shape 引用），`delete`/`clear` 释放。
+ */
+export class MeshSolidRegistry {
+    handles = new Map();
+    backendRef = null;
+    /**
+     * 装配/换装网格后端（宿主装配期；运行期只读语义）。
+     * @param backend - the mesh backend, or null to detach.
+     */
+    setBackend(backend) {
+        this.backendRef = backend;
+    }
+    /**
+     * 当前网格后端（未装配则 null）。
+     * @returns the assembled mesh backend, or null.
+     */
+    get backend() {
+        return this.backendRef;
+    }
+    /**
+     * 登记某 part 的网格实体句柄（覆盖旧值，**不释放**旧句柄——与 solidCache 同语义）。
+     * @param part - the part name.
+     * @param solid - the mesh solid handle.
+     */
+    set(part, solid) {
+        this.handles.set(part, solid);
+    }
+    /**
+     * 读取某 part 的网格实体句柄。
+     * @param part - the part name.
+     * @returns the handle, or undefined.
+     */
+    get(part) {
+        return this.handles.get(part);
+    }
+    /**
+     * 该 part 是否携带网格实体。
+     * @param part - the part name.
+     * @returns true when a handle is registered.
+     */
+    has(part) {
+        return this.handles.has(part);
+    }
+    /**
+     * 删除某 part 并释放其句柄（重放/失效路径）。
+     * @param part - the part name.
+     */
+    delete(part) {
+        const h = this.handles.get(part);
+        if (h === undefined)
+            return;
+        this.handles.delete(part);
+        try {
+            this.backendRef?.release(h);
+        }
+        catch { /* already released */ }
+    }
+    /**
+     * 按 part 名列表批量删除（重放失效用）。
+     * @param parts - the part names to delete; unknown names are ignored.
+     */
+    deleteMany(parts) {
+        for (const p of parts)
+            this.delete(p);
+    }
+    /** 释放全部句柄并清空（dispose）。 */
+    clear() {
+        for (const h of this.handles.values()) {
+            try {
+                this.backendRef?.release(h);
+            }
+            catch { /* already released */ }
+        }
+        this.handles.clear();
+    }
+    /**
+     * 当前登记的全部 part 名（诊断/测试）。
+     * @returns the registered part names.
+     */
+    keys() {
+        return [...this.handles.keys()];
+    }
+    /** 登记数量（诊断/测试）。 */
+    get size() {
+        return this.handles.size;
+    }
+}
+//# sourceMappingURL=mesh-solid.js.map

package/dist/brep/mesh-solid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-solid.js","sourceRoot":"","sources":["../../src/brep/mesh-solid.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * mesh-solid — 网格实体（mesh solid）与其网格后端端口\n *\n *\n * 名词边界（方案 §3.1）：\n * - **网格实体** = 由网格文件导入、经「规范化」得到的引擎实体。它是**近似拓扑**\n *   的载体，不是精度链的一环；永不进 `brepChain.solidCache`。\n * - **规范化** = `importIndexedMesh` → `weldShellsAndFaces(tol)` → `unifyFaces()`。\n *   **顺序不可交换**：先 `unifyFaces` 会把实体做坏（体积归零），防回归用例见\n *   `brepkit-kernel/mesh-solid-topology.test.ts`。\n * - **网格后端** = 提供网格实体能力的引擎侧组件（本期即 brepkit 的网格用法）。\n *   与 BREP 引擎**同名不同用**：可能同一个 wasm 实例，但走 mesh 语义路径。\n *\n * 本模块只依赖 L1（`engine/types`、`engine/primitives`）与拓扑构建器；后端实现\n * 放在适配器侧（`brep/engine/adapters/brepkit`），因此本模块自身不含任何内核私有\n * 调用——`MeshSolidKernelOps` 是内核私有原语的端口（L1 契约不含 weld/unify）。\n */\n\nimport type { BrepHandle, BrepMeshResult } from './engine/types'\nimport type { BrepEngineApi } from './engine/primitives'\nimport type { PartName } from '../identity'\nimport type { SelectorRuntimeData } from '../topology/build-selector-runtime'\nimport { buildTopologyFromMesh } from './brep-topology'\n\n/** 网格实体构建的输入网格（已按基准单位折算的坐标，与 `Shape` 同构）。 */\nexport interface MeshSolidInput {\n  positions: Float32Array\n  indices: Uint32Array\n}\n\n/** 规范化选项。 */\nexport interface MeshSolidNormalizeOptions {\n  /**\n   * 焊接容差（顶点/重复边缝合半径）。缺省由包围盒对角线定标\n   * （`max(1e-6, 对角线 × 1e-6)`）——**不得写死绝对值**：STL 无单位元数据，\n   * 同一文件既可能是 mm 也可能是 inch，绝对容差在两种尺度下必有一边失准。\n   */\n  weldTolerance?: number\n  /** 三角化参数（缺省与显示 mesh 一致：0.1 / 2π/32）。 */\n  linearDeflection?: number\n  angularDeflection?: number\n}\n\n/** 规范化结果：实体句柄 + 其三角化（显示 mesh 与拓扑 mesh 的唯一真源）。 */\nexport interface MeshSolidResult {\n  /** 规范化后的网格实体句柄。 */\n  readonly solid: BrepHandle\n  /**\n   * 同一实体的三角化（含 faceGroups）。**显示 mesh 必须用这一份**——规则 1：\n   * 拓扑 faceRuns 所索引的三角形，必须就是用户看到的三角形。若显示仍用原始\n   * STL 顶点数组、拓扑用实体的重新三角化，两者三角形数/序不一致 → faceRuns 错位。\n   */\n  readonly mesh: BrepMeshResult\n  readonly faceCount: number\n  readonly edgeCount: number\n  readonly vertexCount: number\n  /** 实际使用的焊接容差（诊断/复现用）。 */\n  readonly weldTolerance: number\n  /** `unifyFaces` 合并掉的重复面数（0 = 共面面片未被合并，顶点未焊上）。 */\n  readonly mergedFaceCount: number\n}\n\n/**\n * 网格后端的**内核私有原语**（L1 `BrepEngineApi` 不含 weld/unify）。\n *\n * 由适配器（拥用内核闭包的一侧）实现；句柄一律是 faijs `BrepHandle`\n * （适配器内部负责 `asNum()` 剥离标签），本模块不感知内核方言。\n */\nexport interface MeshSolidKernelOps {\n  /** 原始三角网格 → 逐三角形面的实体（内核自带顶点焊接）。 */\n  importMesh(positions: Float32Array, indices: Uint32Array): BrepHandle\n  /** 面列表 → 缝合后的实体（重复边缝成共享边 → 真流形）。 */\n  weld(faces: BrepHandle[], tolerance: number): BrepHandle\n  /** 共面区域合并（**原地修改**，返回合并掉的面数）。 */\n  unify(solid: BrepHandle): number\n}\n\n/**\n * 网格后端端口：`load` 的 mesh 路径经它产出网格实体与近似拓扑。\n *\n * 生命周期：由宿主装配期注册进 mesh 引擎槽（`registerMeshEngine`），运行期只读。\n */\nexport interface MeshSolidBackend {\n  /** 后端 id（与 `defineOp.meshEngines` 的门禁名同源，如 `'brepkit'`）。 */\n  readonly id: string\n  /** L1 契约面（拓扑查询 + 几何操作；brepkit 适配器已全实现）。 */\n  readonly kernel: BrepEngineApi\n  /** 内核私有原语（weld/unify）。 */\n  readonly ops: MeshSolidKernelOps\n  /**\n   * 规范化 + 三角化。**失败必须抛错**（带 part 名由调用方补），不静默降级。\n   * @param mesh - the source triangle mesh (base-unit coordinates).\n   * @param opts - optional weld tolerance / tessellation overrides.\n   * @returns the mesh solid with its tessellation.\n   */\n  normalize(mesh: MeshSolidInput, opts?: MeshSolidNormalizeOptions): MeshSolidResult\n  /**\n   * 已存在的网格实体 → 结果描述（三角化 + 计数）。Phase 2 的 mesh op 用它把\n   * 「内核操作产出的新实体」包成下一份网格零件（显示 mesh 与拓扑 mesh 同源）。\n   * @param solid - an existing mesh solid handle.\n   * @param opts - optional tessellation overrides.\n   * @returns the mesh solid result carrying the shared tessellation.\n   */\n  describe(solid: BrepHandle, opts?: MeshSolidNormalizeOptions): MeshSolidResult\n  /**\n   * 从网格实体结果构建近似拓扑数据（`SelectorRuntimeData`，可直接交 `setTopology`）。\n   * @param result - the mesh solid result (its tessellation indexes the topology).\n   * @returns the serializable selector runtime data.\n   */\n  buildTopologyData(result: MeshSolidResult): SelectorRuntimeData\n  /** 释放网格实体句柄。 */\n  release(solid: BrepHandle): void\n}\n\n// ── 规范化驱动（引擎中立，供适配器的 MeshSolidBackend 实现复用） ──\n\n/** 与显示 mesh 一致的默认三角化参数（`buildSolidTopologyRuntime` 同源）。 */\nconst DISPLAY_LINEAR_DEFLECTION = 0.1\nconst DISPLAY_ANGULAR_DEFLECTION = (2 * Math.PI) / 32\n\n/**\n * 由包围盒对角线导出焊接容差（方案 §3.3）。\n *\n * 下限 1e-6 兜住退化 bbox（单点/零厚网格）；上不封顶——超大模型需要更粗的\n * 缝合半径才缝得上（float32 坐标的相对误差随尺度线性增长）。\n *\n * @param kernel - the L1 kernel API (bbox query only).\n * @param shape - the raw imported shape.\n * @returns the weld tolerance derived from the bounding-box diagonal.\n */\nexport function weldToleranceFor(kernel: BrepEngineApi, shape: BrepHandle): number {\n  const bb = kernel.getBoundingBox(shape, false)\n  const dx = bb.xmax - bb.xmin\n  const dy = bb.ymax - bb.ymin\n  const dz = bb.zmax - bb.zmin\n  const diag = Math.sqrt(dx * dx + dy * dy + dz * dz)\n  return Math.max(1e-6, diag * 1e-6)\n}\n\n/**\n * 规范化：`importMesh` → `weld` → `unify`，再校验并三角化。\n *\n * 三条硬约束，都是 Phase 0 实测结论：\n * 1. **顺序不可交换**——先 unify 再 weld 会得到体积归零的坏实体；\n * 2. `unify` **原地修改**，返回值是合并面数，不是句柄；\n * 3. 校验用 `isValid`（weld 后必须合法），不合法即抛错——开放/非流形网格必须\n *    在导入处失败，不能静默退化成\"无拓扑的裸网格\"（那会让所有下游 mesh op\n *    失去选择能力）。\n *\n * @param backend - the mesh backend providing ops + kernel.\n * @param mesh - the source triangle mesh.\n * @param opts - optional weld tolerance / tessellation overrides.\n * @returns the normalized mesh solid, its tessellation, and element counts.\n * @throws {Error} `E_MESH_SOLID_UNWELDABLE` when welding leaves an invalid solid.\n */\nexport function normalizeMeshSolid(\n  backend: MeshSolidBackend,\n  mesh: MeshSolidInput,\n  opts?: MeshSolidNormalizeOptions,\n): MeshSolidResult {\n  const { kernel, ops } = backend\n  const raw = ops.importMesh(mesh.positions, mesh.indices)\n  const tolerance = opts?.weldTolerance ?? weldToleranceFor(kernel, raw)\n\n  const faces = kernel.getSubShapes(raw, 'face')\n  const welded = ops.weld(faces, tolerance)\n  // 原地修改：返回值是合并掉的面数。绝不能把它当句柄。\n  const mergedFaceCount = ops.unify(welded)\n\n  if (!kernel.isValid(welded)) {\n    // 原始实体（逐三角形、边不共享）在 weld 前就不合法是正常的；weld 后仍不合法\n    // 说明网格本身开放/非流形/自交——这是**必须暴露的导入失败**，不是可降级状态。\n    try { backend.release(raw) } catch { /* already released */ }\n    throw new Error(\n      `E_MESH_SOLID_UNWELDABLE: welded mesh is still an invalid solid (tolerance=${tolerance}) — ` +\n      'the source mesh is open, non-manifold or self-intersecting',\n    )\n  }\n  // 焊接后原始逐三角形实体已无用；及时释放，避免句柄堆积（新路径不得添泄漏）。\n  try { backend.release(raw) } catch { /* already released */ }\n\n  const tess = kernel.meshShape(welded, {\n    linearDeflection: opts?.linearDeflection ?? DISPLAY_LINEAR_DEFLECTION,\n    angularDeflection: opts?.angularDeflection ?? DISPLAY_ANGULAR_DEFLECTION,\n  })\n\n  return {\n    solid: welded,\n    mesh: tess,\n    faceCount: kernel.getSubShapes(welded, 'face').length,\n    edgeCount: kernel.getSubShapes(welded, 'edge').length,\n    vertexCount: kernel.getSubShapes(welded, 'vertex').length,\n    weldTolerance: tolerance,\n    mergedFaceCount,\n  }\n}\n\n/**\n * 已存在的网格实体 → 结果描述（三角化 + 计数）。\n *\n * Phase 2 的 mesh op 产出的新实体走这里：**一次**三角化同时喂显示与拓扑，\n * 保证 `faceRuns` 与所见三角形一一对应（规则 1）。重复调 `describe` 会得到\n * 另一份三角化结果——同一实体在同一参数下确定性一致，但仍应复用同一份结果。\n *\n * @param backend - the mesh backend.\n * @param solid - an existing mesh solid handle.\n * @param opts - optional tessellation overrides.\n * @returns the mesh solid result carrying the shared tessellation.\n */\nexport function describeMeshSolid(\n  backend: MeshSolidBackend,\n  solid: BrepHandle,\n  opts?: MeshSolidNormalizeOptions,\n): MeshSolidResult {\n  const { kernel } = backend\n  const tess = kernel.meshShape(solid, {\n    linearDeflection: opts?.linearDeflection ?? DISPLAY_LINEAR_DEFLECTION,\n    angularDeflection: opts?.angularDeflection ?? DISPLAY_ANGULAR_DEFLECTION,\n  })\n  return {\n    solid,\n    mesh: tess,\n    faceCount: kernel.getSubShapes(solid, 'face').length,\n    edgeCount: kernel.getSubShapes(solid, 'edge').length,\n    vertexCount: kernel.getSubShapes(solid, 'vertex').length,\n    weldTolerance: 0,\n    mergedFaceCount: 0,\n  }\n}\n\n/**\n * 网格实体 → 近似拓扑数据（`SelectorRuntimeData`）。\n *\n * 复用 BREP 路径同源的 `buildTopologyFromMesh`（方案 §1.3 实测：产物与 BREP\n * 路径同构——同样的 FaceRow/EdgeRow 字段、同样的 `faceStart/faceCount` 邻接）。\n * **不引入第二套拓扑表示。**\n *\n * @param backend - the mesh backend (kernel + release).\n * @param result - the normalized mesh solid result (carries the shared tessellation).\n * @returns the serializable selector runtime data.\n */\nexport function buildMeshSolidTopology(\n  backend: MeshSolidBackend,\n  result: MeshSolidResult,\n): SelectorRuntimeData {\n  return buildTopologyFromMesh(backend.kernel, result.solid, result.mesh)\n}\n\n// ── 注册表（生命周期，与 brepChain.solidCache 并列且互不干扰） ──\n\n/**\n * 网格实体句柄注册表（`PartName → BrepHandle`）。\n *\n * 与 `brepChain.solidCache` 的差别：本表**永不**参与 BREP 精度链判定——\n * 它存在只表示\"该 part 是网格零件，携带近似拓扑\"。释放语义与 solidCache 对齐：\n * `set` 覆盖不释放（旧句柄可能仍被旧输出 Shape 引用），`delete`/`clear` 释放。\n */\nexport class MeshSolidRegistry {\n  private readonly handles = new Map<PartName, BrepHandle>()\n  private backendRef: MeshSolidBackend | null = null\n\n  /**\n   * 装配/换装网格后端（宿主装配期；运行期只读语义）。\n   * @param backend - the mesh backend, or null to detach.\n   */\n  setBackend(backend: MeshSolidBackend | null): void {\n    this.backendRef = backend\n  }\n\n  /**\n   * 当前网格后端（未装配则 null）。\n   * @returns the assembled mesh backend, or null.\n   */\n  get backend(): MeshSolidBackend | null {\n    return this.backendRef\n  }\n\n  /**\n   * 登记某 part 的网格实体句柄（覆盖旧值，**不释放**旧句柄——与 solidCache 同语义）。\n   * @param part - the part name.\n   * @param solid - the mesh solid handle.\n   */\n  set(part: PartName, solid: BrepHandle): void {\n    this.handles.set(part, solid)\n  }\n\n  /**\n   * 读取某 part 的网格实体句柄。\n   * @param part - the part name.\n   * @returns the handle, or undefined.\n   */\n  get(part: PartName): BrepHandle | undefined {\n    return this.handles.get(part)\n  }\n\n  /**\n   * 该 part 是否携带网格实体。\n   * @param part - the part name.\n   * @returns true when a handle is registered.\n   */\n  has(part: PartName): boolean {\n    return this.handles.has(part)\n  }\n\n  /**\n   * 删除某 part 并释放其句柄（重放/失效路径）。\n   * @param part - the part name.\n   */\n  delete(part: PartName): void {\n    const h = this.handles.get(part)\n    if (h === undefined) return\n    this.handles.delete(part)\n    try { this.backendRef?.release(h) } catch { /* already released */ }\n  }\n\n  /**\n   * 按 part 名列表批量删除（重放失效用）。\n   * @param parts - the part names to delete; unknown names are ignored.\n   */\n  deleteMany(parts: Iterable<PartName>): void {\n    for (const p of parts) this.delete(p)\n  }\n\n  /** 释放全部句柄并清空（dispose）。 */\n  clear(): void {\n    for (const h of this.handles.values()) {\n      try { this.backendRef?.release(h) } catch { /* already released */ }\n    }\n    this.handles.clear()\n  }\n\n  /**\n   * 当前登记的全部 part 名（诊断/测试）。\n   * @returns the registered part names.\n   */\n  keys(): PartName[] {\n    return [...this.handles.keys()]\n  }\n\n  /** 登记数量（诊断/测试）。 */\n  get size(): number {\n    return this.handles.size\n  }\n}\n"]}

package/dist/brep/text/fontRegistry.d.ts

@@ -13,11 +13,24 @@ import type { Font } from 'opentype.js';
  * 字体二进制加载器接口。
  *
  * 生产代码（text.ts / engrave.ts）不自己决定字体来源，
- * 而是通过 ensureDefaultFont() 使用注入的 FontLoader。
+ * 而是通过 ensureDefaultFont() / ensureFont() 使用注入的 FontLoader。
  */
 export interface FontLoader {
     /** 返回默认字体的二进制数据 */
     loadDefaultFont(): Promise<ArrayBuffer>;
+    /**
+     * 可选：按**字体族名**或**文件路径**取字体二进制。
+     *
+     * 宿主实现（Node 读磁盘/系统字体目录、浏览器按 URL 映射）决定来源；引擎核心
+     * 不碰 fs/fetch。返回 `null` 表示宿主无法解析该名字——调用方回退到默认字体
+     * （与 CadQuery/OCC `Font_FontMgr::FindFont` 找不到名字时回退默认字体的语义一致）。
+     *
+     * 未实现该方法的宿主（如浏览器）会让 `ensureFont(name)` 直接回退默认字体。
+     *
+     * @param nameOrPath - 字体族名（如 `"Arial"`）或字体文件路径
+     * @returns 字体字节，或 null（无法解析）
+     */
+    resolveFont?(nameOrPath: string): Promise<ArrayBuffer | null>;
 }
 /**
  * 设置当前环境的字体加载器。
@@ -61,6 +74,24 @@ export declare function ensureDefaultFont(): Promise<void>;
  * @returns opentype.js Font 对象，如果未加载则返回 undefined
  */
 export declare function getFont(fontFamily?: string): Font | undefined;
+/**
+ * 确保某个**具名字体**可用，并返回它。
+ *
+ * 语义对齐 CadQuery 的 `font=`/`fontPath=`：
+ *
+ * - 名字已注册过（含 `loadFont(data, name)` 直接注册）⇒ 直接返回；
+ * - `fontPath`（已存在的文件路径）或字体族名 ⇒ 交给 `FontLoader.resolveFont` 解析，
+ *   解析成功后**以该名字注册**，后续同名调用命中缓存；
+ * - 宿主没有 `resolveFont`、或解析失败（名字不是本机已安装字体）⇒ **回退到默认字体**
+ *   （OCC `Font_FontMgr::FindFont` 找不到字体时同样回退默认字体，不会抛错）。
+ *
+ * `null`/`undefined`/空串等价于「不指定」⇒ 默认字体。
+ *
+ * @param nameOrPath - 字体族名、字体文件路径，或 null/undefined 表示默认字体
+ * @returns 解析到的字体（解析不到时是默认字体）
+ * @throws 没有安装 FontLoader 且默认字体也未加载时
+ */
+export declare function ensureFont(nameOrPath?: string | null): Promise<Font>;
 /**
  * 清除所有已注册的字体。
  *

package/dist/brep/text/fontRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fontRegistry.d.ts","sourceRoot":"","sources":["../../../src/brep/text/fontRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAMvC;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,mBAAmB;IACnB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;CACxC;AAID;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAE7D;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,UAAU,GAAG,IAAI,CAEjD;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,WAAW,EACrB,UAAU,SAAY,EACtB,KAAK,UAAQ,GACZ,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAavD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,UAAU,SAAY,GAAG,IAAI,GAAG,SAAS,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAIjC"}
+{"version":3,"file":"fontRegistry.d.ts","sourceRoot":"","sources":["../../../src/brep/text/fontRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAoBvC;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,mBAAmB;IACnB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;IACvC;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;CAC9D;AAID;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAE7D;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,UAAU,GAAG,IAAI,CAEjD;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,WAAW,EACrB,UAAU,SAAY,EACtB,KAAK,UAAQ,GACZ,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAavD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,UAAU,SAAY,GAAG,IAAI,GAAG,SAAS,CAEhE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB1E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAIjC"}

package/dist/brep/text/fontRegistry.js

@@ -8,7 +8,19 @@
  * - Node 测试：fontTestHelper.ts 通过 fs.readFileSync 加载
  * - 字体文件唯一真源：src/assets/fonts/OpenSans-Regular.ttf
  */
-import * as opentype from 'opentype.js';
+import * as opentypeModule from 'opentype.js';
+/**
+ * `opentype.js` publishes no `exports` map: it ships a UMD bundle (`main`) plus
+ * an ESM build (`module`). Node ESM resolves the UMD `main`, whose CommonJS
+ * interop exposes a namespace import as `{ default }` only — so
+ * `opentypeModule.parse` is undefined there — whereas bundlers (vite/vitest)
+ * resolve the ESM build and expose the named exports directly. Resolve once,
+ * here, so glyph parsing works in every host (CLI/tsx = Node ESM,
+ * vitest/browser = bundler).
+ */
+const opentype = typeof opentypeModule.parse === 'function'
+    ? opentypeModule
+    : opentypeModule.default;
 const FONT_REGISTER = {};
 let activeFontLoader = null;
 /**
@@ -86,6 +98,44 @@ export async function ensureDefaultFont() {
 export function getFont(fontFamily = 'default') {
     return FONT_REGISTER[fontFamily];
 }
+/**
+ * 确保某个**具名字体**可用，并返回它。
+ *
+ * 语义对齐 CadQuery 的 `font=`/`fontPath=`：
+ *
+ * - 名字已注册过（含 `loadFont(data, name)` 直接注册）⇒ 直接返回；
+ * - `fontPath`（已存在的文件路径）或字体族名 ⇒ 交给 `FontLoader.resolveFont` 解析，
+ *   解析成功后**以该名字注册**，后续同名调用命中缓存；
+ * - 宿主没有 `resolveFont`、或解析失败（名字不是本机已安装字体）⇒ **回退到默认字体**
+ *   （OCC `Font_FontMgr::FindFont` 找不到字体时同样回退默认字体，不会抛错）。
+ *
+ * `null`/`undefined`/空串等价于「不指定」⇒ 默认字体。
+ *
+ * @param nameOrPath - 字体族名、字体文件路径，或 null/undefined 表示默认字体
+ * @returns 解析到的字体（解析不到时是默认字体）
+ * @throws 没有安装 FontLoader 且默认字体也未加载时
+ */
+export async function ensureFont(nameOrPath) {
+    if (!nameOrPath) {
+        await ensureDefaultFont();
+        return getFont();
+    }
+    const already = getFont(nameOrPath);
+    if (already)
+        return already;
+    if (nameOrPath === 'default') {
+        await ensureDefaultFont();
+        return getFont();
+    }
+    const resolver = activeFontLoader?.resolveFont;
+    if (resolver) {
+        const data = await activeFontLoader.resolveFont(nameOrPath);
+        if (data)
+            return loadFont(data, nameOrPath, true);
+    }
+    await ensureDefaultFont();
+    return getFont();
+}
 /**
  * 清除所有已注册的字体。
  *

package/dist/brep/text/fontRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"fontRegistry.js","sourceRoot":"","sources":["../../../src/brep/text/fontRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,QAAQ,MAAM,aAAa,CAAA;AAGvC,MAAM,aAAa,GAAyB,EAAE,CAAA;AAe9C,IAAI,gBAAgB,GAAsB,IAAI,CAAA;AAE9C;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,MAAyB;IACrD,gBAAgB,GAAG,MAAM,CAAA;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,gBAAgB,CAAA;AACzB,CAAC;AAED,iBAAiB;AAEjB;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAqB,EACrB,UAAU,GAAG,SAAS,EACtB,KAAK,GAAG,KAAK;IAEb,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;QACxC,OAAO,aAAa,CAAC,UAAU,CAAC,CAAA;IAClC,CAAC;IAED,IAAI,IAAU,CAAA;IACd,IAAI,CAAC;QACH,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IACjC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;IAC3G,CAAC;IAED,aAAa,CAAC,UAAU,CAAC,GAAG,IAAI,CAAA;IAChC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,aAAa,CAAC,SAAS,CAAC,GAAG,IAAI,CAAA;IACjC,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,IAAI,OAAO,CAAC,SAAS,CAAC;QAAE,OAAM;IAE9B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,qCAAqC;YACrC,oDAAoD;YACpD,0EAA0E,CAC3E,CAAA;IACH,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,eAAe,EAAE,CAAA;IACrD,MAAM,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,UAAU,GAAG,SAAS;IAC5C,OAAO,aAAa,CAAC,UAAU,CAAC,CAAA;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU;IACxB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7C,OAAO,aAAa,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC;AACH,CAAC","sourcesContent":["/**\n * 字体加载与注册 — 单一真源\n *\n * 设计原则：\n * - loadFont 只接受 ArrayBuffer（纯函数，无 fs/fetch 环境依赖）\n * - 字体二进制的获取方式由 FontLoader 接口注入（依赖反转）\n * - 浏览器：browserFontLoader.ts 通过 vite ?url + fetch 加载\n * - Node 测试：fontTestHelper.ts 通过 fs.readFileSync 加载\n * - 字体文件唯一真源：src/assets/fonts/OpenSans-Regular.ttf\n */\n\nimport * as opentype from 'opentype.js'\nimport type { Font } from 'opentype.js'\n\nconst FONT_REGISTER: Record<string, Font> = {}\n\n// ─── FontLoader 依赖注入 ───\n\n/**\n * 字体二进制加载器接口。\n *\n * 生产代码（text.ts / engrave.ts）不自己决定字体来源，\n * 而是通过 ensureDefaultFont() 使用注入的 FontLoader。\n */\nexport interface FontLoader {\n  /** 返回默认字体的二进制数据 */\n  loadDefaultFont(): Promise<ArrayBuffer>\n}\n\nlet activeFontLoader: FontLoader | null = null\n\n/**\n * 设置当前环境的字体加载器。\n *\n * 浏览器：由 browserFontLoader.ts 在应用启动时自动调用。\n * 测试：由 fontTestHelper.ts 在 beforeAll 中调用。\n *\n * @param loader - the font loader to install, or null to clear the active one.\n */\nexport function setFontLoader(loader: FontLoader | null): void {\n  activeFontLoader = loader\n}\n\n/**\n * Get the currently-installed font loader (may be null).\n * @returns the active font loader, or null when none is set.\n */\nexport function getFontLoader(): FontLoader | null {\n  return activeFontLoader\n}\n\n// ─── 核心 API ───\n\n/**\n * 加载并注册一个 OpenType/TrueType 字体。\n *\n * 纯函数：只接受 ArrayBuffer，不处理 fs/fetch。\n * 环境差异由 FontLoader 接口在外部处理。\n *\n * @param fontData 字体文件二进制数据\n * @param fontFamily 注册名（默认 'default'）\n * @param force 是否覆盖已注册的同名字体\n * @returns 解析后的 opentype.js Font 对象\n */\nexport async function loadFont(\n  fontData: ArrayBuffer,\n  fontFamily = 'default',\n  force = false,\n): Promise<Font> {\n  if (!force && FONT_REGISTER[fontFamily]) {\n    return FONT_REGISTER[fontFamily]\n  }\n\n  let font: Font\n  try {\n    font = opentype.parse(fontData)\n  } catch (e) {\n    throw new Error(`Failed to parse font data: ${e instanceof Error ? e.message : String(e)}`, { cause: e })\n  }\n\n  FONT_REGISTER[fontFamily] = font\n  if (!FONT_REGISTER['default']) {\n    FONT_REGISTER['default'] = font\n  }\n\n  return font\n}\n\n/**\n * 确保默认字体已加载（惰性加载）。\n *\n * 使用注入的 FontLoader 获取字体二进制，然后调用 loadFont 解析注册。\n * 如果字体已加载（getFont('default') 返回非 undefined），直接返回。\n *\n * @throws 如果没有设置 FontLoader 且字体尚未加载\n */\nexport async function ensureDefaultFont(): Promise<void> {\n  if (getFont('default')) return\n\n  if (!activeFontLoader) {\n    throw new Error(\n      '[fontRegistry] No font loader set. ' +\n      'Call setFontLoader() before using text functions. ' +\n      'Browser: import browserFontLoader.ts; Node tests: use fontTestHelper.ts.',\n    )\n  }\n\n  const data = await activeFontLoader.loadDefaultFont()\n  await loadFont(data, 'default', true)\n}\n\n/**\n * 获取已注册的字体。\n *\n * @param fontFamily 注册名（默认 'default'）\n * @returns opentype.js Font 对象，如果未加载则返回 undefined\n */\nexport function getFont(fontFamily = 'default'): Font | undefined {\n  return FONT_REGISTER[fontFamily]\n}\n\n/**\n * 清除所有已注册的字体。\n *\n * 主要用于测试：在注入失败 loader 前，先清除已加载的字体，\n * 确保 ensureDefaultFont() 会重新调用 loader。\n */\nexport function clearFonts(): void {\n  for (const key of Object.keys(FONT_REGISTER)) {\n    delete FONT_REGISTER[key]\n  }\n}\n"]}
+{"version":3,"file":"fontRegistry.js","sourceRoot":"","sources":["../../../src/brep/text/fontRegistry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 字体加载与注册 — 单一真源\n *\n * 设计原则：\n * - loadFont 只接受 ArrayBuffer（纯函数，无 fs/fetch 环境依赖）\n * - 字体二进制的获取方式由 FontLoader 接口注入（依赖反转）\n * - 浏览器：browserFontLoader.ts 通过 vite ?url + fetch 加载\n * - Node 测试：fontTestHelper.ts 通过 fs.readFileSync 加载\n * - 字体文件唯一真源：src/assets/fonts/OpenSans-Regular.ttf\n */\n\nimport * as opentypeModule from 'opentype.js'\nimport type { Font } from 'opentype.js'\n\n/**\n * `opentype.js` publishes no `exports` map: it ships a UMD bundle (`main`) plus\n * an ESM build (`module`). Node ESM resolves the UMD `main`, whose CommonJS\n * interop exposes a namespace import as `{ default }` only — so\n * `opentypeModule.parse` is undefined there — whereas bundlers (vite/vitest)\n * resolve the ESM build and expose the named exports directly. Resolve once,\n * here, so glyph parsing works in every host (CLI/tsx = Node ESM,\n * vitest/browser = bundler).\n */\nconst opentype: typeof opentypeModule =\n  typeof (opentypeModule as { parse?: unknown }).parse === 'function'\n    ? opentypeModule\n    : (opentypeModule as unknown as { default: typeof opentypeModule }).default\n\nconst FONT_REGISTER: Record<string, Font> = {}\n\n// ─── FontLoader 依赖注入 ───\n\n/**\n * 字体二进制加载器接口。\n *\n * 生产代码（text.ts / engrave.ts）不自己决定字体来源，\n * 而是通过 ensureDefaultFont() / ensureFont() 使用注入的 FontLoader。\n */\nexport interface FontLoader {\n  /** 返回默认字体的二进制数据 */\n  loadDefaultFont(): Promise<ArrayBuffer>\n  /**\n   * 可选：按**字体族名**或**文件路径**取字体二进制。\n   *\n   * 宿主实现（Node 读磁盘/系统字体目录、浏览器按 URL 映射）决定来源；引擎核心\n   * 不碰 fs/fetch。返回 `null` 表示宿主无法解析该名字——调用方回退到默认字体\n   * （与 CadQuery/OCC `Font_FontMgr::FindFont` 找不到名字时回退默认字体的语义一致）。\n   *\n   * 未实现该方法的宿主（如浏览器）会让 `ensureFont(name)` 直接回退默认字体。\n   *\n   * @param nameOrPath - 字体族名（如 `\"Arial\"`）或字体文件路径\n   * @returns 字体字节，或 null（无法解析）\n   */\n  resolveFont?(nameOrPath: string): Promise<ArrayBuffer | null>\n}\n\nlet activeFontLoader: FontLoader | null = null\n\n/**\n * 设置当前环境的字体加载器。\n *\n * 浏览器：由 browserFontLoader.ts 在应用启动时自动调用。\n * 测试：由 fontTestHelper.ts 在 beforeAll 中调用。\n *\n * @param loader - the font loader to install, or null to clear the active one.\n */\nexport function setFontLoader(loader: FontLoader | null): void {\n  activeFontLoader = loader\n}\n\n/**\n * Get the currently-installed font loader (may be null).\n * @returns the active font loader, or null when none is set.\n */\nexport function getFontLoader(): FontLoader | null {\n  return activeFontLoader\n}\n\n// ─── 核心 API ───\n\n/**\n * 加载并注册一个 OpenType/TrueType 字体。\n *\n * 纯函数：只接受 ArrayBuffer，不处理 fs/fetch。\n * 环境差异由 FontLoader 接口在外部处理。\n *\n * @param fontData 字体文件二进制数据\n * @param fontFamily 注册名（默认 'default'）\n * @param force 是否覆盖已注册的同名字体\n * @returns 解析后的 opentype.js Font 对象\n */\nexport async function loadFont(\n  fontData: ArrayBuffer,\n  fontFamily = 'default',\n  force = false,\n): Promise<Font> {\n  if (!force && FONT_REGISTER[fontFamily]) {\n    return FONT_REGISTER[fontFamily]\n  }\n\n  let font: Font\n  try {\n    font = opentype.parse(fontData)\n  } catch (e) {\n    throw new Error(`Failed to parse font data: ${e instanceof Error ? e.message : String(e)}`, { cause: e })\n  }\n\n  FONT_REGISTER[fontFamily] = font\n  if (!FONT_REGISTER['default']) {\n    FONT_REGISTER['default'] = font\n  }\n\n  return font\n}\n\n/**\n * 确保默认字体已加载（惰性加载）。\n *\n * 使用注入的 FontLoader 获取字体二进制，然后调用 loadFont 解析注册。\n * 如果字体已加载（getFont('default') 返回非 undefined），直接返回。\n *\n * @throws 如果没有设置 FontLoader 且字体尚未加载\n */\nexport async function ensureDefaultFont(): Promise<void> {\n  if (getFont('default')) return\n\n  if (!activeFontLoader) {\n    throw new Error(\n      '[fontRegistry] No font loader set. ' +\n      'Call setFontLoader() before using text functions. ' +\n      'Browser: import browserFontLoader.ts; Node tests: use fontTestHelper.ts.',\n    )\n  }\n\n  const data = await activeFontLoader.loadDefaultFont()\n  await loadFont(data, 'default', true)\n}\n\n/**\n * 获取已注册的字体。\n *\n * @param fontFamily 注册名（默认 'default'）\n * @returns opentype.js Font 对象，如果未加载则返回 undefined\n */\nexport function getFont(fontFamily = 'default'): Font | undefined {\n  return FONT_REGISTER[fontFamily]\n}\n\n/**\n * 确保某个**具名字体**可用，并返回它。\n *\n * 语义对齐 CadQuery 的 `font=`/`fontPath=`：\n *\n * - 名字已注册过（含 `loadFont(data, name)` 直接注册）⇒ 直接返回；\n * - `fontPath`（已存在的文件路径）或字体族名 ⇒ 交给 `FontLoader.resolveFont` 解析，\n *   解析成功后**以该名字注册**，后续同名调用命中缓存；\n * - 宿主没有 `resolveFont`、或解析失败（名字不是本机已安装字体）⇒ **回退到默认字体**\n *   （OCC `Font_FontMgr::FindFont` 找不到字体时同样回退默认字体，不会抛错）。\n *\n * `null`/`undefined`/空串等价于「不指定」⇒ 默认字体。\n *\n * @param nameOrPath - 字体族名、字体文件路径，或 null/undefined 表示默认字体\n * @returns 解析到的字体（解析不到时是默认字体）\n * @throws 没有安装 FontLoader 且默认字体也未加载时\n */\nexport async function ensureFont(nameOrPath?: string | null): Promise<Font> {\n  if (!nameOrPath) {\n    await ensureDefaultFont()\n    return getFont()!\n  }\n\n  const already = getFont(nameOrPath)\n  if (already) return already\n\n  if (nameOrPath === 'default') {\n    await ensureDefaultFont()\n    return getFont()!\n  }\n\n  const resolver = activeFontLoader?.resolveFont\n  if (resolver) {\n    const data = await activeFontLoader!.resolveFont!(nameOrPath)\n    if (data) return loadFont(data, nameOrPath, true)\n  }\n\n  await ensureDefaultFont()\n  return getFont()!\n}\n\n/**\n * 清除所有已注册的字体。\n *\n * 主要用于测试：在注入失败 loader 前，先清除已加载的字体，\n * 确保 ensureDefaultFont() 会重新调用 loader。\n */\nexport function clearFonts(): void {\n  for (const key of Object.keys(FONT_REGISTER)) {\n    delete FONT_REGISTER[key]\n  }\n}\n"]}

package/dist/brep/text/text-to-solid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text-to-solid.d.ts","sourceRoot":"","sources":["../../../src/brep/text/text-to-solid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAmDzD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACf,GACL,UAAU,EAAE,CAwHd;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;CACd,GACA,UAAU,CAqCZ"}
+{"version":3,"file":"text-to-solid.d.ts","sourceRoot":"","sources":["../../../src/brep/text/text-to-solid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAwDzD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACf,GACL,UAAU,EAAE,CAwHd;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;CACd,GACA,UAAU,CAqCZ"}

package/dist/brep/text/text-to-solid.js

@@ -17,10 +17,15 @@
  * - Z (closePath) → 闭合 wire
  */
 import { getFont } from './fontRegistry.js';
-/** 将 opentype.js 坐标转为 OCCT 点（XY 平面，Z=0） */
+/**
+ * 将 opentype.js 坐标转为 OCCT 点（XY 平面，Z=0）。
+ *
+ * opentype.js 的 path 是 **y 向下**（canvas 约定：字形主体在负 y），OCCT 是
+ * **y 向上**，故这里翻转 y —— 与 `../svg/svg-to-solid.ts` 的 `flipY`
+ * （SVG Y-down → OCCT Y-up）同一约定。X 不翻转，文字从左到右。
+ */
 function toPt(x, y) {
-    // 与 mesh 路径一致：不翻转 X 轴，文字从左到右
-    return { x, y, z: 0 };
+    return { x, y: -y, z: 0 };
 }
 /**
  * 将 opentype.js 二次贝塞尔转换为三次贝塞尔的控制点。

package/dist/brep/text/text-to-solid.js.map

@@ -1 +1 @@
-{"version":3,"file":"text-to-solid.js","sourceRoot":"","sources":["../../../src/brep/text/text-to-solid.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 文字 → OCCT wire/face 转换\n *\n * 适配自 brepjs `src/text/text-to-solid.ts`。\n * 保留文件名和核心算法，适配本项目的 occt-wasm API。\n *\n * 与 brepjs 的差异：\n * - brepjs 用 BlueprintSketcher 构造 wire → 本项目直接用 kernel.makeLineEdge / makeBezierEdge\n * - brepjs 用 organiseBlueprints 处理孔洞 → 本项目用 makeFace 直接构建（OCCT 自动处理内孔）\n * - brepjs 用 sketchOnPlane → 本项目直接在 XY 平面构造然后按需变换\n *\n * opentype.js 路径命令 → OCCT edge 映射：\n * - M (moveTo) → 开始新子路径\n * - L (lineTo) → kernel.makeLineEdge(prev, curr)\n * - C (cubicBezier) → kernel.makeBezierEdge([p0, cp1, cp2, p1])\n * - Q (quadraticBezier) → 转换为三次贝塞尔后用 makeBezierEdge\n * - Z (closePath) → 闭合 wire\n */\n\nimport type { BrepHandle } from '../engine/types'\nimport type { BrepEngineApi } from '../engine/primitives'\nimport type { Font } from 'opentype.js'\nimport type { PathCommand } from 'opentype.js'\nimport { getFont } from './fontRegistry'\n\n/** 点坐标（OCCT 格式） */\ninterface Pt { x: number; y: number; z: number }\n\n/** 将 opentype.js 坐标转为 OCCT 点（XY 平面，Z=0） */\nfunction toPt(x: number, y: number): Pt {\n  // 与 mesh 路径一致：不翻转 X 轴，文字从左到右\n  return { x, y, z: 0 }\n}\n\n/**\n * 将 opentype.js 二次贝塞尔转换为三次贝塞尔的控制点。\n *\n * Q: P0 → P1 (cp) → P2\n * C: P0 → C1 → C2 → P2\n * C1 = P0 + 2/3 * (P1 - P0) = (2*P1 + P0) / 3\n * C2 = P2 + 2/3 * (P1 - P2) = (2*P1 + P2) / 3\n */\nfunction quadToCubic(\n  p0: Pt, cp: Pt, p2: Pt,\n): [Pt, Pt] {\n  const c1 = {\n    x: (2 * cp.x + p0.x) / 3,\n    y: (2 * cp.y + p0.y) / 3,\n    z: 0,\n  }\n  const c2 = {\n    x: (2 * cp.x + p2.x) / 3,\n    y: (2 * cp.y + p2.y) / 3,\n    z: 0,\n  }\n  return [c1, c2]\n}\n\n/**\n * 用 OCCT 贝塞尔边构造一段三次贝塞尔曲线。\n *\n * 三次贝塞尔曲线有 4 个控制点：P0, C1, C2, P1。\n * occt-wasm 的 makeBezierEdge 接受 Vec3[] 控制点数组。\n */\nfunction makeBezierFromPoints(\n  kernel: BrepEngineApi,\n  p0: Pt, c1: Pt, c2: Pt, p1: Pt,\n): BrepHandle {\n  return kernel.makeBezierEdge([p0, c1, c2, p1])\n}\n\n/**\n * 将文字转换为 OCCT wire 数组（每个闭合轮廓一个 wire）。\n *\n * @param kernel OCCT 内核\n * @param text 文字字符串\n * @param options 配置选项\n * @returns BrepHandle 数组（每个是一个闭合 wire）\n */\nexport function textBlueprints(\n  kernel: BrepEngineApi,\n  text: string,\n  options: {\n    startX?: number\n    startY?: number\n    fontSize?: number\n    fontFamily?: string\n  } = {},\n): BrepHandle[] {\n  const { startX = 0, startY = 0, fontSize = 16, fontFamily = 'default' } = options\n\n  let font: Font | undefined = getFont(fontFamily)\n  if (!font) font = getFont()\n  if (!font) {\n    throw new Error('[textBlueprints] No fonts loaded. Call loadFont() before using text functions.')\n  }\n\n  // 检查缺字形（CJK 字符在 OpenSans Regular 中没有对应字形）\n  for (const ch of text) {\n    if (ch === ' ' || ch === '\\t' || ch === '\\n' || ch === '\\r') continue\n    const glyph = font.charToGlyph(ch)\n    if (glyph.index === 0) {\n      throw new Error(\n        `[textBlueprints] Character \"${ch}\" (U+${ch.codePointAt(0)!.toString(16).toUpperCase()}) ` +\n        `not found in font. If it is a CJK character, a CJK font must be loaded.`,\n      )\n    }\n  }\n\n  // 获取文字路径\n  const path = font.getPath(text, startX, startY, fontSize)\n  const commands = path.commands as PathCommand[]\n\n  const wires: BrepHandle[] = []\n  const allEdges: BrepHandle[] = []\n\n  let currentEdges: BrepHandle[] = []\n  let lastPt: Pt | null = null\n  let subpathStart: Pt | null = null\n\n  for (const cmd of commands) {\n    switch (cmd.type) {\n      case 'M': {\n        // 开始新子路径 — 如果当前有 edges，先构建 wire\n        if (currentEdges.length > 0) {\n          const wire = kernel.makeWire(currentEdges)\n          wires.push(wire)\n          allEdges.push(...currentEdges)\n          currentEdges = []\n        }\n        lastPt = toPt(cmd.x!, cmd.y!)\n        subpathStart = lastPt\n        break\n      }\n      case 'L': {\n        if (!lastPt) {\n          lastPt = toPt(cmd.x!, cmd.y!)\n          subpathStart = lastPt\n          break\n        }\n        const curr = toPt(cmd.x!, cmd.y!)\n        // 跳过零长度边\n        if (Math.abs(curr.x - lastPt.x) > 1e-9 || Math.abs(curr.y - lastPt.y) > 1e-9) {\n          const edge = kernel.makeLineEdge(lastPt, curr)\n          currentEdges.push(edge)\n          allEdges.push(edge)\n        }\n        lastPt = curr\n        break\n      }\n      case 'Q': {\n        if (!lastPt) break\n        const cp = toPt(cmd.x1!, cmd.y1!)\n        const endPt = toPt(cmd.x!, cmd.y!)\n        // 转换为三次贝塞尔\n        const [c1, c2] = quadToCubic(lastPt, cp, endPt)\n        const edge = makeBezierFromPoints(kernel, lastPt, c1, c2, endPt)\n        currentEdges.push(edge)\n        allEdges.push(edge)\n        lastPt = endPt\n        break\n      }\n      case 'C': {\n        if (!lastPt) break\n        const c1 = toPt(cmd.x1!, cmd.y1!)\n        const c2 = toPt(cmd.x2!, cmd.y2!)\n        const endPt = toPt(cmd.x!, cmd.y!)\n        const edge = makeBezierFromPoints(kernel, lastPt, c1, c2, endPt)\n        currentEdges.push(edge)\n        allEdges.push(edge)\n        lastPt = endPt\n        break\n      }\n      case 'Z': {\n        // 闭合 — 如果有起点，添加闭合边\n        if (subpathStart && lastPt &&\n            (Math.abs(subpathStart.x - lastPt.x) > 1e-9 || Math.abs(subpathStart.y - lastPt.y) > 1e-9)) {\n          const edge = kernel.makeLineEdge(lastPt, subpathStart)\n          currentEdges.push(edge)\n          allEdges.push(edge)\n        }\n        // 构建 wire\n        if (currentEdges.length > 0) {\n          const wire = kernel.makeWire(currentEdges)\n          wires.push(wire)\n          allEdges.push(...currentEdges)\n          currentEdges = []\n        }\n        lastPt = null\n        subpathStart = null\n        break\n      }\n    }\n  }\n\n  // 处理最后一个未闭合的子路径\n  if (currentEdges.length > 0) {\n    const wire = kernel.makeWire(currentEdges)\n    wires.push(wire)\n    allEdges.push(...currentEdges)\n  }\n\n  // 释放所有边（wire 已共享 TShape）\n  for (const e of allEdges) {\n    kernel.release(e)\n  }\n\n  return wires\n}\n\n/**\n * 将文字转换为 OCCT 3D solid（face → extrude → fuse）。\n *\n * @param kernel OCCT 内核\n * @param text 文字字符串\n * @param options 配置选项\n * @returns BrepHandle（合并后的 solid）\n */\nexport function textToSolid(\n  kernel: BrepEngineApi,\n  text: string,\n  options: {\n    fontSize?: number\n    fontFamily?: string\n    depth: number\n  },\n): BrepHandle {\n  const { fontSize = 16, fontFamily = 'default', depth } = options\n\n  const wires = textBlueprints(kernel, text, { fontSize, fontFamily })\n\n  if (wires.length === 0) {\n    throw new Error('[textToSolid] no wires generated from text')\n  }\n\n  // 为每个 wire 创建 face → extrude\n  const solids: BrepHandle[] = []\n  for (const wire of wires) {\n    try {\n      const face = kernel.makeFace(wire)\n      const solid = kernel.extrude(face, 0, 0, depth)\n      kernel.release(face)\n      solids.push(solid)\n    } catch {\n      // 某些 wire 可能无法构建 face（如开放线框）— 跳过\n    }\n    kernel.release(wire)\n  }\n\n  if (solids.length === 0) {\n    throw new Error('[textToSolid] no solids generated from wires')\n  }\n\n  // Fuse 所有 solid\n  let result = solids[0]\n  for (let i = 1; i < solids.length; i++) {\n    const prev = result\n    result = kernel.fuse(prev, solids[i])\n    kernel.release(prev)\n    kernel.release(solids[i])\n  }\n\n  return result\n}\n"]}
+{"version":3,"file":"text-to-solid.js","sourceRoot":"","sources":["../../../src/brep/text/text-to-solid.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 文字 → OCCT wire/face 转换\n *\n * 适配自 brepjs `src/text/text-to-solid.ts`。\n * 保留文件名和核心算法，适配本项目的 occt-wasm API。\n *\n * 与 brepjs 的差异：\n * - brepjs 用 BlueprintSketcher 构造 wire → 本项目直接用 kernel.makeLineEdge / makeBezierEdge\n * - brepjs 用 organiseBlueprints 处理孔洞 → 本项目用 makeFace 直接构建（OCCT 自动处理内孔）\n * - brepjs 用 sketchOnPlane → 本项目直接在 XY 平面构造然后按需变换\n *\n * opentype.js 路径命令 → OCCT edge 映射：\n * - M (moveTo) → 开始新子路径\n * - L (lineTo) → kernel.makeLineEdge(prev, curr)\n * - C (cubicBezier) → kernel.makeBezierEdge([p0, cp1, cp2, p1])\n * - Q (quadraticBezier) → 转换为三次贝塞尔后用 makeBezierEdge\n * - Z (closePath) → 闭合 wire\n */\n\nimport type { BrepHandle } from '../engine/types'\nimport type { BrepEngineApi } from '../engine/primitives'\nimport type { Font } from 'opentype.js'\nimport type { PathCommand } from 'opentype.js'\nimport { getFont } from './fontRegistry'\n\n/** 点坐标（OCCT 格式） */\ninterface Pt { x: number; y: number; z: number }\n\n/**\n * 将 opentype.js 坐标转为 OCCT 点（XY 平面，Z=0）。\n *\n * opentype.js 的 path 是 **y 向下**（canvas 约定：字形主体在负 y），OCCT 是\n * **y 向上**，故这里翻转 y —— 与 `../svg/svg-to-solid.ts` 的 `flipY`\n * （SVG Y-down → OCCT Y-up）同一约定。X 不翻转，文字从左到右。\n */\nfunction toPt(x: number, y: number): Pt {\n  return { x, y: -y, z: 0 }\n}\n\n/**\n * 将 opentype.js 二次贝塞尔转换为三次贝塞尔的控制点。\n *\n * Q: P0 → P1 (cp) → P2\n * C: P0 → C1 → C2 → P2\n * C1 = P0 + 2/3 * (P1 - P0) = (2*P1 + P0) / 3\n * C2 = P2 + 2/3 * (P1 - P2) = (2*P1 + P2) / 3\n */\nfunction quadToCubic(\n  p0: Pt, cp: Pt, p2: Pt,\n): [Pt, Pt] {\n  const c1 = {\n    x: (2 * cp.x + p0.x) / 3,\n    y: (2 * cp.y + p0.y) / 3,\n    z: 0,\n  }\n  const c2 = {\n    x: (2 * cp.x + p2.x) / 3,\n    y: (2 * cp.y + p2.y) / 3,\n    z: 0,\n  }\n  return [c1, c2]\n}\n\n/**\n * 用 OCCT 贝塞尔边构造一段三次贝塞尔曲线。\n *\n * 三次贝塞尔曲线有 4 个控制点：P0, C1, C2, P1。\n * occt-wasm 的 makeBezierEdge 接受 Vec3[] 控制点数组。\n */\nfunction makeBezierFromPoints(\n  kernel: BrepEngineApi,\n  p0: Pt, c1: Pt, c2: Pt, p1: Pt,\n): BrepHandle {\n  return kernel.makeBezierEdge([p0, c1, c2, p1])\n}\n\n/**\n * 将文字转换为 OCCT wire 数组（每个闭合轮廓一个 wire）。\n *\n * @param kernel OCCT 内核\n * @param text 文字字符串\n * @param options 配置选项\n * @returns BrepHandle 数组（每个是一个闭合 wire）\n */\nexport function textBlueprints(\n  kernel: BrepEngineApi,\n  text: string,\n  options: {\n    startX?: number\n    startY?: number\n    fontSize?: number\n    fontFamily?: string\n  } = {},\n): BrepHandle[] {\n  const { startX = 0, startY = 0, fontSize = 16, fontFamily = 'default' } = options\n\n  let font: Font | undefined = getFont(fontFamily)\n  if (!font) font = getFont()\n  if (!font) {\n    throw new Error('[textBlueprints] No fonts loaded. Call loadFont() before using text functions.')\n  }\n\n  // 检查缺字形（CJK 字符在 OpenSans Regular 中没有对应字形）\n  for (const ch of text) {\n    if (ch === ' ' || ch === '\\t' || ch === '\\n' || ch === '\\r') continue\n    const glyph = font.charToGlyph(ch)\n    if (glyph.index === 0) {\n      throw new Error(\n        `[textBlueprints] Character \"${ch}\" (U+${ch.codePointAt(0)!.toString(16).toUpperCase()}) ` +\n        `not found in font. If it is a CJK character, a CJK font must be loaded.`,\n      )\n    }\n  }\n\n  // 获取文字路径\n  const path = font.getPath(text, startX, startY, fontSize)\n  const commands = path.commands as PathCommand[]\n\n  const wires: BrepHandle[] = []\n  const allEdges: BrepHandle[] = []\n\n  let currentEdges: BrepHandle[] = []\n  let lastPt: Pt | null = null\n  let subpathStart: Pt | null = null\n\n  for (const cmd of commands) {\n    switch (cmd.type) {\n      case 'M': {\n        // 开始新子路径 — 如果当前有 edges，先构建 wire\n        if (currentEdges.length > 0) {\n          const wire = kernel.makeWire(currentEdges)\n          wires.push(wire)\n          allEdges.push(...currentEdges)\n          currentEdges = []\n        }\n        lastPt = toPt(cmd.x!, cmd.y!)\n        subpathStart = lastPt\n        break\n      }\n      case 'L': {\n        if (!lastPt) {\n          lastPt = toPt(cmd.x!, cmd.y!)\n          subpathStart = lastPt\n          break\n        }\n        const curr = toPt(cmd.x!, cmd.y!)\n        // 跳过零长度边\n        if (Math.abs(curr.x - lastPt.x) > 1e-9 || Math.abs(curr.y - lastPt.y) > 1e-9) {\n          const edge = kernel.makeLineEdge(lastPt, curr)\n          currentEdges.push(edge)\n          allEdges.push(edge)\n        }\n        lastPt = curr\n        break\n      }\n      case 'Q': {\n        if (!lastPt) break\n        const cp = toPt(cmd.x1!, cmd.y1!)\n        const endPt = toPt(cmd.x!, cmd.y!)\n        // 转换为三次贝塞尔\n        const [c1, c2] = quadToCubic(lastPt, cp, endPt)\n        const edge = makeBezierFromPoints(kernel, lastPt, c1, c2, endPt)\n        currentEdges.push(edge)\n        allEdges.push(edge)\n        lastPt = endPt\n        break\n      }\n      case 'C': {\n        if (!lastPt) break\n        const c1 = toPt(cmd.x1!, cmd.y1!)\n        const c2 = toPt(cmd.x2!, cmd.y2!)\n        const endPt = toPt(cmd.x!, cmd.y!)\n        const edge = makeBezierFromPoints(kernel, lastPt, c1, c2, endPt)\n        currentEdges.push(edge)\n        allEdges.push(edge)\n        lastPt = endPt\n        break\n      }\n      case 'Z': {\n        // 闭合 — 如果有起点，添加闭合边\n        if (subpathStart && lastPt &&\n            (Math.abs(subpathStart.x - lastPt.x) > 1e-9 || Math.abs(subpathStart.y - lastPt.y) > 1e-9)) {\n          const edge = kernel.makeLineEdge(lastPt, subpathStart)\n          currentEdges.push(edge)\n          allEdges.push(edge)\n        }\n        // 构建 wire\n        if (currentEdges.length > 0) {\n          const wire = kernel.makeWire(currentEdges)\n          wires.push(wire)\n          allEdges.push(...currentEdges)\n          currentEdges = []\n        }\n        lastPt = null\n        subpathStart = null\n        break\n      }\n    }\n  }\n\n  // 处理最后一个未闭合的子路径\n  if (currentEdges.length > 0) {\n    const wire = kernel.makeWire(currentEdges)\n    wires.push(wire)\n    allEdges.push(...currentEdges)\n  }\n\n  // 释放所有边（wire 已共享 TShape）\n  for (const e of allEdges) {\n    kernel.release(e)\n  }\n\n  return wires\n}\n\n/**\n * 将文字转换为 OCCT 3D solid（face → extrude → fuse）。\n *\n * @param kernel OCCT 内核\n * @param text 文字字符串\n * @param options 配置选项\n * @returns BrepHandle（合并后的 solid）\n */\nexport function textToSolid(\n  kernel: BrepEngineApi,\n  text: string,\n  options: {\n    fontSize?: number\n    fontFamily?: string\n    depth: number\n  },\n): BrepHandle {\n  const { fontSize = 16, fontFamily = 'default', depth } = options\n\n  const wires = textBlueprints(kernel, text, { fontSize, fontFamily })\n\n  if (wires.length === 0) {\n    throw new Error('[textToSolid] no wires generated from text')\n  }\n\n  // 为每个 wire 创建 face → extrude\n  const solids: BrepHandle[] = []\n  for (const wire of wires) {\n    try {\n      const face = kernel.makeFace(wire)\n      const solid = kernel.extrude(face, 0, 0, depth)\n      kernel.release(face)\n      solids.push(solid)\n    } catch {\n      // 某些 wire 可能无法构建 face（如开放线框）— 跳过\n    }\n    kernel.release(wire)\n  }\n\n  if (solids.length === 0) {\n    throw new Error('[textToSolid] no solids generated from wires')\n  }\n\n  // Fuse 所有 solid\n  let result = solids[0]\n  for (let i = 1; i < solids.length; i++) {\n    const prev = result\n    result = kernel.fuse(prev, solids[i])\n    kernel.release(prev)\n    kernel.release(solids[i])\n  }\n\n  return result\n}\n"]}

package/dist/brepkit-kernel/brepkitKernel.d.ts

@@ -20,9 +20,18 @@
  */
 import { type BrepKitKernel } from './brepkitWasm.js';
 import type { BrepEngineApi } from '../brep/engine/primitives.js';
-/** brepkit 适配器返回类型：BrepEngineApi + brepkit 专属诊断。 */
+/** brepkit 适配器返回类型：BrepEngineApi + brepkit 专属诊断 + 网格实体原语。 */
 type BrepkitEngineExtras = BrepEngineApi & {
     getMeshFallbackCount(): number;
+    /**
+     * 网格实体原语（`brep/mesh-solid.ts` 的 `MeshSolidKernelOps`）。
+     *
+     * 为什么放在适配器而不是 L1 契约面：`weldShellsAndFaces` / `unifyFaces` 是
+     * brepkit **内核私有**的缝合/合并原语（L1 `BrepEngineApi` 没有对应概念——
+     * OCCT 侧用 `sew`+`unifySameDomain` 才有等价语义，形态不同）。挂在适配器
+     * 返回对象上，网格后端（`MeshSolidBackend`）经端口取用，契约面保持干净。
+     */
+    meshSolid: import('../brep/mesh-solid.js').MeshSolidKernelOps;
 };
 /**
  * 创建 brepkit BrepEngineApi 实现（L1 契约显式对象字面量）。
@@ -41,7 +50,14 @@ export declare function createBrepkitPrimitives(): Promise<BrepkitEngineExtras>;
  * @returns the live brepkit wasm kernel singleton.
  */
 export declare function getBrepkitKernel(): BrepKitKernel;
-/** 释放内核单例（测试收尾用；宿主常驻不需调用）。 */
+/**
+ * 释放内核单例（测试收尾用；宿主常驻不需调用）。
+ *
+ * GOTCHA（2026-10-01 修复）：旧实现只 `free()` 内核、**不重置** brepkitWasm.ts 里
+ * 缓存的 `initPromise`，也不丢 memo 化的原语对象 → 第二次 `createBrepkitPrimitives()`
+ * 拿到**已释放**的内核，随后一切内核调用报 `null pointer passed to rust`
+ * （实测：`BrepKernel.makeBox`）。现在三样一起清：内核、initPromise、memo 原语。
+ */
 export declare function disposeBrepkit(): void;
 /** brepkit 适配器原语集类型（BrepEngineApi + brepkit 专属诊断 getMeshFallbackCount）。 */
 export type BrepkitPrimitives = Awaited<ReturnType<typeof createBrepkitPrimitives>>;

package/dist/brepkit-kernel/brepkitKernel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brepkitKernel.d.ts","sourceRoot":"","sources":["../../src/brepkit-kernel/brepkitKernel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAGnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAwI9D,oDAAoD;AACpD,KAAK,mBAAmB,GAAG,aAAa,GAAG;IAAE,oBAAoB,IAAI,MAAM,CAAA;CAAE,CAAA;AAuC7E;;;;;GAKG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CA65B5E;AAoDD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED,8BAA8B;AAC9B,wBAAgB,cAAc,IAAI,IAAI,CAKrC;AAED,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAA"}
+{"version":3,"file":"brepkitKernel.d.ts","sourceRoot":"","sources":["../../src/brepkit-kernel/brepkitKernel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAGrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAoO9D,6DAA6D;AAC7D,KAAK,mBAAmB,GAAG,aAAa,GAAG;IACzC,oBAAoB,IAAI,MAAM,CAAA;IAC9B;;;;;;;OAOG;IACH,SAAS,EAAE,OAAO,oBAAoB,EAAE,kBAAkB,CAAA;CAC3D,CAAA;AAkDD;;;;;GAKG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CA6mC5E;AAwDD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAQrC;AAED,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAA"}