@faicad/faijs 0.33.2 → 0.35.8

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

@@ -6,7 +6,8 @@
  *
  * 与 brepjs 的差异：
  * - brepjs 用 BlueprintSketcher 构造 wire → 本项目直接用 kernel.makeLineEdge / makeBezierEdge
- * - brepjs 用 organiseBlueprints 处理孔洞 → 本项目用 makeFace 直接构建（OCCT 自动处理内孔）
+ * - brepjs 用 organiseBlueprints 处理孔洞 → 本项目用 makeFace + addHolesInFace 构建
+ *   （分类复用 `primitives/svg/svg-path.ts` 的共享 classifyNested，与 svg-to-solid 同源）
  * - brepjs 用 sketchOnPlane → 本项目直接在 XY 平面构造然后按需变换
  *
  * opentype.js 路径命令 → OCCT edge 映射：
@@ -15,8 +16,20 @@
  * - C (cubicBezier) → kernel.makeBezierEdge([p0, cp1, cp2, p1])
  * - Q (quadraticBezier) → 转换为三次贝塞尔后用 makeBezierEdge
  * - Z (closePath) → 闭合 wire
+ *
+ * 孔洞与组合（2026-10-13 修复，见 .agents/notes/ 对应 Agent Note）：
+ * - 旧实现把每个闭合轮廓独立 makeFace+extrude 后**逐个 fuse**：带孔字符（如 'o'）
+ *   的外轮廓体与内孔体被布尔并成一个实心体，孔被填实（与 mesh 路径的 evenodd
+ *   分类不一致）；且 fuse 次数 = 轮廓数，'Hello' ≈ 8-12 次 OCCT 布尔是文字建模
+ *   10 秒级耗时的主因。
+ * - 新实现：轮廓按包含关系分组（外轮廓 + 其孔，复用 classifyNested）→ 每组
+ *   makeFace(outer) + addHolesInFace(holes) 挖孔 → extrude；字符间互不重叠，
+ *   **用 makeCompound 组合（零布尔成本）**，不再逐轮廓 fuse。
  */
 import { getFont } from './fontRegistry.js';
+import { classifyNested, computeBBox, computeSignedArea, } from '../../primitives/svg/svg-path.js';
+/** 每条曲线离散化的采样段数（分类用的点集精度：bbox/质心/射线足够）。 */
+const CURVE_SAMPLES = 8;
 /**
  * 将 opentype.js 坐标转为 OCCT 点（XY 平面，Z=0）。
  *
@@ -57,15 +70,31 @@ function quadToCubic(p0, cp, p2) {
 function makeBezierFromPoints(kernel, p0, c1, c2, p1) {
     return kernel.makeBezierEdge([p0, c1, c2, p1]);
 }
+/** 三次贝塞尔在 t 处的采样点（用于轮廓分类点集）。 */
+function sampleCubic(p0, c1, c2, p1, t) {
+    const mt = 1 - t;
+    const a = mt * mt * mt;
+    const b = 3 * mt * mt * t;
+    const c = 3 * mt * t * t;
+    const d = t * t * t;
+    return {
+        x: a * p0.x + b * c1.x + c * c2.x + d * p1.x,
+        y: a * p0.y + b * c1.y + c * c2.y + d * p1.y,
+    };
+}
 /**
- * 将文字转换为 OCCT wire 数组（每个闭合轮廓一个 wire）。
+ * 将文字转换为 OCCT wire 数组（每个闭合轮廓一个 wire），并带各轮廓的
+ * 采样点集（供 classifyNested 做外轮廓/孔洞分类）。
+ *
+ * 采样点：L 端点、Q/C 按 CURVE_SAMPLES 段离散化 —— 与 mesh 路径
+ * `opentypePathToContours` 的曲线折线化同一用途（bbox/质心/射线判定精度足够）。
  *
  * @param kernel OCCT 内核
  * @param text 文字字符串
  * @param options 配置选项
- * @returns BrepHandle 数组（每个是一个闭合 wire）
+ * @returns 每个闭合轮廓的 { wire, points }（points 为 Y-up 采样点）
  */
-export function textBlueprints(kernel, text, options = {}) {
+export function textBlueprintsDetailed(kernel, text, options = {}) {
     const { startX = 0, startY = 0, fontSize = 16, fontFamily = 'default' } = options;
     let font = getFont(fontFamily);
     if (!font)
@@ -89,6 +118,7 @@ export function textBlueprints(kernel, text, options = {}) {
     const wires = [];
     const allEdges = [];
     let currentEdges = [];
+    let currentPoints = [];
     let lastPt = null;
     let subpathStart = null;
     for (const cmd of commands) {
@@ -97,18 +127,21 @@ export function textBlueprints(kernel, text, options = {}) {
                 // 开始新子路径 — 如果当前有 edges，先构建 wire
                 if (currentEdges.length > 0) {
                     const wire = kernel.makeWire(currentEdges);
-                    wires.push(wire);
+                    wires.push({ wire, points: currentPoints });
                     allEdges.push(...currentEdges);
                     currentEdges = [];
+                    currentPoints = [];
                 }
                 lastPt = toPt(cmd.x, cmd.y);
                 subpathStart = lastPt;
+                currentPoints.push({ x: lastPt.x, y: lastPt.y });
                 break;
             }
             case 'L': {
                 if (!lastPt) {
                     lastPt = toPt(cmd.x, cmd.y);
                     subpathStart = lastPt;
+                    currentPoints.push({ x: lastPt.x, y: lastPt.y });
                     break;
                 }
                 const curr = toPt(cmd.x, cmd.y);
@@ -117,6 +150,7 @@ export function textBlueprints(kernel, text, options = {}) {
                     const edge = kernel.makeLineEdge(lastPt, curr);
                     currentEdges.push(edge);
                     allEdges.push(edge);
+                    currentPoints.push({ x: curr.x, y: curr.y });
                 }
                 lastPt = curr;
                 break;
@@ -131,6 +165,10 @@ export function textBlueprints(kernel, text, options = {}) {
                 const edge = makeBezierFromPoints(kernel, lastPt, c1, c2, endPt);
                 currentEdges.push(edge);
                 allEdges.push(edge);
+                // 采样曲线点（端点已含）——与 makeBezierEdge 同一组控制点
+                for (let s = 1; s <= CURVE_SAMPLES; s++) {
+                    currentPoints.push(sampleCubic(lastPt, c1, c2, endPt, s / CURVE_SAMPLES));
+                }
                 lastPt = endPt;
                 break;
             }
@@ -143,6 +181,9 @@ export function textBlueprints(kernel, text, options = {}) {
                 const edge = makeBezierFromPoints(kernel, lastPt, c1, c2, endPt);
                 currentEdges.push(edge);
                 allEdges.push(edge);
+                for (let s = 1; s <= CURVE_SAMPLES; s++) {
+                    currentPoints.push(sampleCubic(lastPt, c1, c2, endPt, s / CURVE_SAMPLES));
+                }
                 lastPt = endPt;
                 break;
             }
@@ -154,12 +195,21 @@ export function textBlueprints(kernel, text, options = {}) {
                     currentEdges.push(edge);
                     allEdges.push(edge);
                 }
+                // 闭合点回归起点（pointInPolygon 的射线判定要求多边形闭合）
+                if (subpathStart && currentPoints.length > 0) {
+                    const s = currentPoints[0];
+                    const l = currentPoints[currentPoints.length - 1];
+                    if (Math.abs(s.x - l.x) > 1e-9 || Math.abs(s.y - l.y) > 1e-9) {
+                        currentPoints.push(s);
+                    }
+                }
                 // 构建 wire
                 if (currentEdges.length > 0) {
                     const wire = kernel.makeWire(currentEdges);
-                    wires.push(wire);
+                    wires.push({ wire, points: currentPoints });
                     allEdges.push(...currentEdges);
                     currentEdges = [];
+                    currentPoints = [];
                 }
                 lastPt = null;
                 subpathStart = null;
@@ -170,7 +220,7 @@ export function textBlueprints(kernel, text, options = {}) {
     // 处理最后一个未闭合的子路径
     if (currentEdges.length > 0) {
         const wire = kernel.makeWire(currentEdges);
-        wires.push(wire);
+        wires.push({ wire, points: currentPoints });
         allEdges.push(...currentEdges);
     }
     // 释放所有边（wire 已共享 TShape）
@@ -180,24 +230,53 @@ export function textBlueprints(kernel, text, options = {}) {
     return wires;
 }
 /**
- * 将文字转换为 OCCT 3D solid（face → extrude → fuse）。
+ * 将文字转换为 OCCT wire 数组（每个闭合轮廓一个 wire）。
+ *
+ * @param kernel OCCT 内核
+ * @param text 文字字符串
+ * @param options 配置选项
+ * @returns BrepHandle 数组（每个是一个闭合 wire）
+ */
+export function textBlueprints(kernel, text, options = {}) {
+    return textBlueprintsDetailed(kernel, text, options).map((d) => d.wire);
+}
+/**
+ * 将文字转换为 OCCT 3D solid（face → 挖孔 → extrude → compound）。
+ *
+ * 每个「外轮廓 + 其孔」分组生成一个空心 solid（makeFace + addHolesInFace）；
+ * 分组之间（字符 / 互不重叠的独立轮廓，如 'i' 的点）**用 makeCompound 组合**，
+ * 不做布尔融合 —— 字符水平排列互不重叠，compound 语义正确且零布尔成本
+ * （旧实现逐个 fuse 是文字建模慢的根因，也是 'o' 孔被填实的成因）。
  *
  * @param kernel OCCT 内核
  * @param text 文字字符串
  * @param options 配置选项
- * @returns BrepHandle（合并后的 solid）
+ * @returns BrepHandle（单组时为 solid，多组时为 compound）
  */
 export function textToSolid(kernel, text, options) {
     const { fontSize = 16, fontFamily = 'default', depth } = options;
-    const wires = textBlueprints(kernel, text, { fontSize, fontFamily });
-    if (wires.length === 0) {
+    const detailed = textBlueprintsDetailed(kernel, text, { fontSize, fontFamily });
+    if (detailed.length === 0) {
         throw new Error('[textToSolid] no wires generated from text');
     }
-    // 为每个 wire 创建 face → extrude
+    // 轮廓分类：外轮廓 + 孔（复用 svg 共享 classifyNested；text 字符水平排布、字形
+    // 直立，bbox 预筛 + 质心射线足够，与 mesh 路径的 evenodd 分类同源）。
+    const subpaths = detailed.map((d) => ({
+        points: d.points,
+        bbox: computeBBox(d.points),
+        signedArea: computeSignedArea(d.points),
+    }));
+    const groups = classifyNested(subpaths);
+    // 为每个分组创建 face（挖孔）→ extrude
     const solids = [];
-    for (const wire of wires) {
+    for (const g of groups) {
         try {
-            const face = kernel.makeFace(wire);
+            let face = kernel.makeFace(detailed[g.outerIdx].wire);
+            if (g.holes.length > 0) {
+                const holed = kernel.addHolesInFace(face, g.holes.map((h) => detailed[h].wire));
+                kernel.release(face);
+                face = holed;
+            }
             const solid = kernel.extrude(face, 0, 0, depth);
             kernel.release(face);
             solids.push(solid);
@@ -205,19 +284,20 @@ export function textToSolid(kernel, text, options) {
         catch {
             // 某些 wire 可能无法构建 face（如开放线框）— 跳过
         }
-        kernel.release(wire);
+    }
+    // 释放所有 wire（face/solid 已共享 TShape）
+    for (const d of detailed) {
+        kernel.release(d.wire);
     }
     if (solids.length === 0) {
         throw new Error('[textToSolid] no solids generated from wires');
     }
-    // Fuse 所有 solid
-    let result = solids[0];
-    for (let i = 1; i < solids.length; i++) {
-        const prev = result;
-        result = kernel.fuse(prev, solids[i]);
-        kernel.release(prev);
-        kernel.release(solids[i]);
-    }
-    return result;
+    if (solids.length === 1)
+        return solids[0];
+    // 多组：compound 组合（不 fuse —— 组间互不重叠，布尔是多余且昂贵的操作）。
+    const compound = kernel.makeCompound(solids);
+    for (const s of solids)
+        kernel.release(s);
+    return compound;
 }
 //# sourceMappingURL=text-to-solid.js.map

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/**\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"]}
+{"version":3,"file":"text-to-solid.js","sourceRoot":"","sources":["../../../src/brep/text/text-to-solid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAMH,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AACxC,OAAO,EACL,cAAc,EACd,WAAW,EACX,iBAAiB,GAGlB,MAAM,+BAA+B,CAAA;AAKtC,2CAA2C;AAC3C,MAAM,aAAa,GAAG,CAAC,CAAA;AAEvB;;;;;;GAMG;AACH,SAAS,IAAI,CAAC,CAAS,EAAE,CAAS;IAChC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;AAC3B,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,WAAW,CAClB,EAAM,EAAE,EAAM,EAAE,EAAM;IAEtB,MAAM,EAAE,GAAG;QACT,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QACxB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QACxB,CAAC,EAAE,CAAC;KACL,CAAA;IACD,MAAM,EAAE,GAAG;QACT,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QACxB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QACxB,CAAC,EAAE,CAAC;KACL,CAAA;IACD,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;AACjB,CAAC;AAED;;;;;GAKG;AACH,SAAS,oBAAoB,CAC3B,MAAqB,EACrB,EAAM,EAAE,EAAM,EAAE,EAAM,EAAE,EAAM;IAE9B,OAAO,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;AAChD,CAAC;AAED,gCAAgC;AAChC,SAAS,WAAW,CAClB,EAAM,EAAE,EAAM,EAAE,EAAM,EAAE,EAAM,EAAE,CAAS;IAEzC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAA;IAChB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;IACtB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;IACzB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAA;IACxB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACnB,OAAO;QACL,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QAC5C,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;KAC7C,CAAA;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAqB,EACrB,IAAY,EACZ,UAKI,EAAE;IAEN,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,QAAQ,GAAG,EAAE,EAAE,UAAU,GAAG,SAAS,EAAE,GAAG,OAAO,CAAA;IAEjF,IAAI,IAAI,GAAqB,OAAO,CAAC,UAAU,CAAC,CAAA;IAChD,IAAI,CAAC,IAAI;QAAE,IAAI,GAAG,OAAO,EAAE,CAAA;IAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAA;IACnG,CAAC;IAED,0CAA0C;IAC1C,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACtB,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI;YAAE,SAAQ;QACrE,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QAClC,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,+BAA+B,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI;gBAC1F,yEAAyE,CAC1E,CAAA;QACH,CAAC;IACH,CAAC;IAED,SAAS;IACT,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAyB,CAAA;IAE/C,MAAM,KAAK,GAAgD,EAAE,CAAA;IAC7D,MAAM,QAAQ,GAAiB,EAAE,CAAA;IAEjC,IAAI,YAAY,GAAiB,EAAE,CAAA;IACnC,IAAI,aAAa,GAAgB,EAAE,CAAA;IACnC,IAAI,MAAM,GAAc,IAAI,CAAA;IAC5B,IAAI,YAAY,GAAc,IAAI,CAAA;IAElC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,GAAG,CAAC,CAAC,CAAC;gBACT,gCAAgC;gBAChC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;oBAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAA;oBAC3C,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAA;oBAC9B,YAAY,GAAG,EAAE,CAAA;oBACjB,aAAa,GAAG,EAAE,CAAA;gBACpB,CAAC;gBACD,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAE,EAAE,GAAG,CAAC,CAAE,CAAC,CAAA;gBAC7B,YAAY,GAAG,MAAM,CAAA;gBACrB,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAA;gBAChD,MAAK;YACP,CAAC;YACD,KAAK,GAAG,CAAC,CAAC,CAAC;gBACT,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAE,EAAE,GAAG,CAAC,CAAE,CAAC,CAAA;oBAC7B,YAAY,GAAG,MAAM,CAAA;oBACrB,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAA;oBAChD,MAAK;gBACP,CAAC;gBACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAE,EAAE,GAAG,CAAC,CAAE,CAAC,CAAA;gBACjC,SAAS;gBACT,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;oBAC7E,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;oBAC9C,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;oBACvB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;oBACnB,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAA;gBAC9C,CAAC;gBACD,MAAM,GAAG,IAAI,CAAA;gBACb,MAAK;YACP,CAAC;YACD,KAAK,GAAG,CAAC,CAAC,CAAC;gBACT,IAAI,CAAC,MAAM;oBAAE,MAAK;gBAClB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAG,EAAE,GAAG,CAAC,EAAG,CAAC,CAAA;gBACjC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAE,EAAE,GAAG,CAAC,CAAE,CAAC,CAAA;gBAClC,WAAW;gBACX,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,EAAE,EAAE,KAAK,CAAC,CAAA;gBAC/C,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAA;gBAChE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACvB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACnB,uCAAuC;gBACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,aAAa,EAAE,CAAC,EAAE,EAAE,CAAC;oBACxC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAA;gBAC3E,CAAC;gBACD,MAAM,GAAG,KAAK,CAAA;gBACd,MAAK;YACP,CAAC;YACD,KAAK,GAAG,CAAC,CAAC,CAAC;gBACT,IAAI,CAAC,MAAM;oBAAE,MAAK;gBAClB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAG,EAAE,GAAG,CAAC,EAAG,CAAC,CAAA;gBACjC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAG,EAAE,GAAG,CAAC,EAAG,CAAC,CAAA;gBACjC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAE,EAAE,GAAG,CAAC,CAAE,CAAC,CAAA;gBAClC,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAA;gBAChE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACvB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,aAAa,EAAE,CAAC,EAAE,EAAE,CAAC;oBACxC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAA;gBAC3E,CAAC;gBACD,MAAM,GAAG,KAAK,CAAA;gBACd,MAAK;YACP,CAAC;YACD,KAAK,GAAG,CAAC,CAAC,CAAC;gBACT,mBAAmB;gBACnB,IAAI,YAAY,IAAI,MAAM;oBACtB,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;oBAC/F,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;oBACtD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;oBACvB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACrB,CAAC;gBACD,uCAAuC;gBACvC,IAAI,YAAY,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC7C,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAA;oBAC1B,MAAM,CAAC,GAAG,aAAa,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;oBACjD,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;wBAC7D,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;oBACvB,CAAC;gBACH,CAAC;gBACD,UAAU;gBACV,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;oBAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAA;oBAC3C,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAA;oBAC9B,YAAY,GAAG,EAAE,CAAA;oBACjB,aAAa,GAAG,EAAE,CAAA;gBACpB,CAAC;gBACD,MAAM,GAAG,IAAI,CAAA;gBACb,YAAY,GAAG,IAAI,CAAA;gBACnB,MAAK;YACP,CAAC;QACH,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;QAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAA;QAC3C,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAA;IAChC,CAAC;IAED,yBAAyB;IACzB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAqB,EACrB,IAAY,EACZ,UAKI,EAAE;IAEN,OAAO,sBAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AACzE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CACzB,MAAqB,EACrB,IAAY,EACZ,OAIC;IAED,MAAM,EAAE,QAAQ,GAAG,EAAE,EAAE,UAAU,GAAG,SAAS,EAAE,KAAK,EAAE,GAAG,OAAO,CAAA;IAEhE,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAA;IAE/E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAC/D,CAAC;IAED,uDAAuD;IACvD,gDAAgD;IAChD,MAAM,QAAQ,GAA0B,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;QAC3B,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC;KACxC,CAAC,CAAC,CAAA;IACH,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;IAEvC,4BAA4B;IAC5B,MAAM,MAAM,GAAiB,EAAE,CAAA;IAC/B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,IAAI,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA;YACrD,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;gBAC/E,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;gBACpB,IAAI,GAAG,KAAK,CAAA;YACd,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;YAC/C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YACpB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,iCAAiC;QACnC,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACxB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IACjE,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAA;IAEzC,gDAAgD;IAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IAC5C,KAAK,MAAM,CAAC,IAAI,MAAM;QAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACzC,OAAO,QAAQ,CAAA;AACjB,CAAC","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 + addHolesInFace 构建\n *   （分类复用 `primitives/svg/svg-path.ts` 的共享 classifyNested，与 svg-to-solid 同源）\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 * 孔洞与组合（2026-10-13 修复，见 .agents/notes/ 对应 Agent Note）：\n * - 旧实现把每个闭合轮廓独立 makeFace+extrude 后**逐个 fuse**：带孔字符（如 'o'）\n *   的外轮廓体与内孔体被布尔并成一个实心体，孔被填实（与 mesh 路径的 evenodd\n *   分类不一致）；且 fuse 次数 = 轮廓数，'Hello' ≈ 8-12 次 OCCT 布尔是文字建模\n *   10 秒级耗时的主因。\n * - 新实现：轮廓按包含关系分组（外轮廓 + 其孔，复用 classifyNested）→ 每组\n *   makeFace(outer) + addHolesInFace(holes) 挖孔 → extrude；字符间互不重叠，\n *   **用 makeCompound 组合（零布尔成本）**，不再逐轮廓 fuse。\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'\nimport {\n  classifyNested,\n  computeBBox,\n  computeSignedArea,\n  type ClassifiableSubpath,\n  type SvgPoint2,\n} from '../../primitives/svg/svg-path'\n\n/** 点坐标（OCCT 格式） */\ninterface Pt { x: number; y: number; z: number }\n\n/** 每条曲线离散化的采样段数（分类用的点集精度：bbox/质心/射线足够）。 */\nconst CURVE_SAMPLES = 8\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/** 三次贝塞尔在 t 处的采样点（用于轮廓分类点集）。 */\nfunction sampleCubic(\n  p0: Pt, c1: Pt, c2: Pt, p1: Pt, t: number,\n): SvgPoint2 {\n  const mt = 1 - t\n  const a = mt * mt * mt\n  const b = 3 * mt * mt * t\n  const c = 3 * mt * t * t\n  const d = t * t * t\n  return {\n    x: a * p0.x + b * c1.x + c * c2.x + d * p1.x,\n    y: a * p0.y + b * c1.y + c * c2.y + d * p1.y,\n  }\n}\n\n/**\n * 将文字转换为 OCCT wire 数组（每个闭合轮廓一个 wire），并带各轮廓的\n * 采样点集（供 classifyNested 做外轮廓/孔洞分类）。\n *\n * 采样点：L 端点、Q/C 按 CURVE_SAMPLES 段离散化 —— 与 mesh 路径\n * `opentypePathToContours` 的曲线折线化同一用途（bbox/质心/射线判定精度足够）。\n *\n * @param kernel OCCT 内核\n * @param text 文字字符串\n * @param options 配置选项\n * @returns 每个闭合轮廓的 { wire, points }（points 为 Y-up 采样点）\n */\nexport function textBlueprintsDetailed(\n  kernel: BrepEngineApi,\n  text: string,\n  options: {\n    startX?: number\n    startY?: number\n    fontSize?: number\n    fontFamily?: string\n  } = {},\n): { wire: BrepHandle; points: SvgPoint2[] }[] {\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: { wire: BrepHandle; points: SvgPoint2[] }[] = []\n  const allEdges: BrepHandle[] = []\n\n  let currentEdges: BrepHandle[] = []\n  let currentPoints: SvgPoint2[] = []\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, points: currentPoints })\n          allEdges.push(...currentEdges)\n          currentEdges = []\n          currentPoints = []\n        }\n        lastPt = toPt(cmd.x!, cmd.y!)\n        subpathStart = lastPt\n        currentPoints.push({ x: lastPt.x, y: lastPt.y })\n        break\n      }\n      case 'L': {\n        if (!lastPt) {\n          lastPt = toPt(cmd.x!, cmd.y!)\n          subpathStart = lastPt\n          currentPoints.push({ x: lastPt.x, y: lastPt.y })\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          currentPoints.push({ x: curr.x, y: curr.y })\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        // 采样曲线点（端点已含）——与 makeBezierEdge 同一组控制点\n        for (let s = 1; s <= CURVE_SAMPLES; s++) {\n          currentPoints.push(sampleCubic(lastPt, c1, c2, endPt, s / CURVE_SAMPLES))\n        }\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        for (let s = 1; s <= CURVE_SAMPLES; s++) {\n          currentPoints.push(sampleCubic(lastPt, c1, c2, endPt, s / CURVE_SAMPLES))\n        }\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        // 闭合点回归起点（pointInPolygon 的射线判定要求多边形闭合）\n        if (subpathStart && currentPoints.length > 0) {\n          const s = currentPoints[0]\n          const l = currentPoints[currentPoints.length - 1]\n          if (Math.abs(s.x - l.x) > 1e-9 || Math.abs(s.y - l.y) > 1e-9) {\n            currentPoints.push(s)\n          }\n        }\n        // 构建 wire\n        if (currentEdges.length > 0) {\n          const wire = kernel.makeWire(currentEdges)\n          wires.push({ wire, points: currentPoints })\n          allEdges.push(...currentEdges)\n          currentEdges = []\n          currentPoints = []\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, points: currentPoints })\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 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  return textBlueprintsDetailed(kernel, text, options).map((d) => d.wire)\n}\n\n/**\n * 将文字转换为 OCCT 3D solid（face → 挖孔 → extrude → compound）。\n *\n * 每个「外轮廓 + 其孔」分组生成一个空心 solid（makeFace + addHolesInFace）；\n * 分组之间（字符 / 互不重叠的独立轮廓，如 'i' 的点）**用 makeCompound 组合**，\n * 不做布尔融合 —— 字符水平排列互不重叠，compound 语义正确且零布尔成本\n * （旧实现逐个 fuse 是文字建模慢的根因，也是 'o' 孔被填实的成因）。\n *\n * @param kernel OCCT 内核\n * @param text 文字字符串\n * @param options 配置选项\n * @returns BrepHandle（单组时为 solid，多组时为 compound）\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 detailed = textBlueprintsDetailed(kernel, text, { fontSize, fontFamily })\n\n  if (detailed.length === 0) {\n    throw new Error('[textToSolid] no wires generated from text')\n  }\n\n  // 轮廓分类：外轮廓 + 孔（复用 svg 共享 classifyNested；text 字符水平排布、字形\n  // 直立，bbox 预筛 + 质心射线足够，与 mesh 路径的 evenodd 分类同源）。\n  const subpaths: ClassifiableSubpath[] = detailed.map((d) => ({\n    points: d.points,\n    bbox: computeBBox(d.points),\n    signedArea: computeSignedArea(d.points),\n  }))\n  const groups = classifyNested(subpaths)\n\n  // 为每个分组创建 face（挖孔）→ extrude\n  const solids: BrepHandle[] = []\n  for (const g of groups) {\n    try {\n      let face = kernel.makeFace(detailed[g.outerIdx].wire)\n      if (g.holes.length > 0) {\n        const holed = kernel.addHolesInFace(face, g.holes.map((h) => detailed[h].wire))\n        kernel.release(face)\n        face = holed\n      }\n      const solid = kernel.extrude(face, 0, 0, depth)\n      kernel.release(face)\n      solids.push(solid)\n    } catch {\n      // 某些 wire 可能无法构建 face（如开放线框）— 跳过\n    }\n  }\n\n  // 释放所有 wire（face/solid 已共享 TShape）\n  for (const d of detailed) {\n    kernel.release(d.wire)\n  }\n\n  if (solids.length === 0) {\n    throw new Error('[textToSolid] no solids generated from wires')\n  }\n\n  if (solids.length === 1) return solids[0]\n\n  // 多组：compound 组合（不 fuse —— 组间互不重叠，布尔是多余且昂贵的操作）。\n  const compound = kernel.makeCompound(solids)\n  for (const s of solids) kernel.release(s)\n  return compound\n}\n"]}

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

@@ -9,7 +9,7 @@
  * `api/surface/engine-method-map.json` 的 aligned/dialect 条目）。brepkit 独有
  * 能力（chamfer2d/chamferV2/filletV2/sketch* 族、serializeSolid、meshBoolean、
  * minkowskiSum …）与单方语义（loft、平面 section/split 之外的 splitter 语义…）
- * 都不在本对象里——平台代码经原生面 `getBrepkitKernel()`（D3）访问。
+ * 都不在本对象里——平台代码经原生面 `getBrepKitKernel()`（D3）访问。
  *
  * 设计要点（对应 3d_editor 项目的 weapp-voice-ai-modeling 设计计划 §5）：
  * - 句柄：brepkit u32 句柄与 faijs BrepHandle(number) 同构，直通零转换；
@@ -49,7 +49,7 @@ export declare function createBrepkitPrimitives(): Promise<BrepkitEngineExtras>;
  *
  * @returns the live brepkit wasm kernel singleton.
  */
-export declare function getBrepkitKernel(): BrepKitKernel;
+export declare function getBrepKitKernel(): BrepKitKernel;
 /**
  * 释放内核单例（测试收尾用；宿主常驻不需调用）。
  *

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,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,CA0wC5E;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"}
+{"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;AAiP9D,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,CAm+C5E;AA6ID;;;;;;;;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"}