@faicad/faijs 0.33.2 → 0.35.2

package/dist/extra/extras/text-geometry.js

@@ -0,0 +1,188 @@
+/**
+ * text-geometry — 文字几何创建（mesh 路径）
+ *
+ * 使用 opentype.js + OpenSans Regular 字体（与 BREP 路径统一）。
+ * 字体来源：fontRegistry（通过依赖注入的 FontLoader 加载）。
+ *
+ * 几何链：opentype Path → Contour[]（共享 SVG 语法层折线化 + evenodd 分类，
+ * Y-down → Y-up 翻转）→ `extrudeShape`（core 自有，three-free）。
+ * 返回 core `Shape`（positions + indices + normals），由使用方自行转为
+ * 自己的渲染几何（如 3d_editor 的 BufferGeometry 适配层）。
+ */
+import { ensureDefaultFont, getFont as getRegisteredFont } from '../../brep/text/fontRegistry.js';
+import { parsePathToSubpaths, computeBBox, computeSignedArea, classifyNested, } from '../../primitives/svg/svg-path.js';
+import { extrudeShape } from '../../mesh/meshdata/extrude.js';
+// ── Font loading ──
+/**
+ * Get the default opentype.js font (OpenSans Regular).
+ *
+ * Fetched from fontRegistry — the same font used by the BREP path
+ * (text-to-solid). The first call triggers a lazy ensureDefaultFont() load.
+ *
+ * @returns a promise resolving to the default opentype.js Font.
+ */
+export async function getOpentypeFont() {
+    await ensureDefaultFont();
+    const font = getRegisteredFont('default');
+    if (!font) {
+        throw new Error('[text-geometry] Default font not loaded. ' +
+            'Call setFontLoader() before using text functions.');
+    }
+    return font;
+}
+// ── opentype Path → Contours ──
+/**
+ * 将 opentype.js Path 命令序列化为 SVG path `d` 字符串。
+ *
+ * opentype.js 的 glyph 轮廓可能不显式发出 `Z`（隐式闭合）；SVG 语义中
+ * 每个 `M` 都开始新子路径、前一子路径隐式闭合。这里在非首个 `M` 前补 `Z`，
+ * 使折线化层获得显式闭合（与 three `Shape` 的隐式闭合语义一致）。
+ */
+function pathToSvgD(path) {
+    const commands = path.commands;
+    const parts = [];
+    for (const cmd of commands) {
+        switch (cmd.type) {
+            case 'M':
+                if (parts.length > 0)
+                    parts.push('Z');
+                parts.push(`M ${cmd.x},${cmd.y}`);
+                break;
+            case 'L':
+                parts.push(`L ${cmd.x},${cmd.y}`);
+                break;
+            case 'C':
+                parts.push(`C ${cmd.x1},${cmd.y1} ${cmd.x2},${cmd.y2} ${cmd.x},${cmd.y}`);
+                break;
+            case 'Q':
+                parts.push(`Q ${cmd.x1},${cmd.y1} ${cmd.x},${cmd.y}`);
+                break;
+            case 'Z':
+                parts.push('Z');
+                break;
+        }
+    }
+    // opentype.js 的 glyph 轮廓不显式发出 Z（隐式闭合，终点 = 起点）：
+    // 末尾未闭合的子路径也必须闭合，否则会被折线化层判为开放轮廓而丢弃。
+    if (parts.length > 0 && !/Z$/.test(parts[parts.length - 1])) {
+        parts.push('Z');
+    }
+    return parts.join(' ');
+}
+/**
+ * 将 opentype.js Path 折线化并分类为 Y-up 平面轮廓（供 `extrudeShape` 消费）。
+ *
+ * opentype 字形坐标是 Y-down（canvas 惯例），与 SVG 一致；输出翻转至 Y-up，
+ * 与 BREP 文本路径（`core/brep/text/text-to-solid.ts`）的世界坐标约定一致。
+ *
+ * @param path - the opentype.js path to flatten.
+ * @param curveSegments - per-curve sampling segments (default 6).
+ * @returns the classified contours (Y-up).
+ */
+export function opentypePathToContours(path, curveSegments = 6) {
+    const d = pathToSvgD(path);
+    const subpaths = parsePathToSubpaths(d, curveSegments);
+    const all = [];
+    for (const sp of subpaths) {
+        if (!sp.closed || Math.abs(sp.signedArea) < 1e-9 || sp.points.length < 3)
+            continue;
+        const flipped = sp.points.map((p) => ({ x: p.x, y: -p.y }));
+        all.push({
+            points: flipped,
+            bbox: computeBBox(flipped),
+            signedArea: computeSignedArea(flipped),
+        });
+    }
+    const groups = classifyNested(all);
+    return groups.map((g) => ({
+        outer: all[g.outerIdx].points,
+        holes: g.holes.map((h) => all[h].points),
+    }));
+}
+// ── Shape 居中（与既有 three 实现相同的布局语义） ──
+/**
+ * X 居中、Y 底部对齐到 0、Z 居中（text 链的旧布局语义）。
+ * @param shape - 待居中的 Shape（positions 就地复制，不修改输入）。
+ * @returns 平移后的新 Shape（索引/法线不变）。
+ */
+export function centerShapeXZBottom(shape) {
+    let minX = Infinity, maxX = -Infinity, minY = Infinity, maxZ = -Infinity;
+    for (let i = 0; i < shape.positions.length; i += 3) {
+        const x = shape.positions[i];
+        const y = shape.positions[i + 1];
+        const z = shape.positions[i + 2];
+        if (x < minX)
+            minX = x;
+        if (x > maxX)
+            maxX = x;
+        if (y < minY)
+            minY = y;
+        if (z > maxZ)
+            maxZ = z;
+    }
+    const cx = (minX + maxX) / 2;
+    const cz = maxZ / 2;
+    const dx = -cx;
+    const dy = -minY;
+    const dz = -cz;
+    const positions = new Float32Array(shape.positions.length);
+    for (let i = 0; i < shape.positions.length; i += 3) {
+        positions[i] = shape.positions[i] + dx;
+        positions[i + 1] = shape.positions[i + 1] + dy;
+        positions[i + 2] = shape.positions[i + 2] + dz;
+    }
+    return { ...shape, positions };
+}
+// ── Text geometry ──
+/**
+ * Create text geometry centered in X/Z, extruded along +Z.
+ *
+ * Uses opentype.js font.getPath() → Contour[] → extrudeShape, flipping
+ * the opentype y-down axis to y-up. This is the same font source and the same
+ * axis convention as the BREP path (text-to-solid), ensuring both glyph and
+ * orientation consistency between the mesh and BREP paths.
+ *
+ * @param text  Text string to render
+ * @param size  Font size in mm
+ * @param depth Extrusion depth in mm
+ * @param font  opentype.js Font object (from fontRegistry)
+ * @returns a promise resolving to the extruded text shape.
+ */
+export async function createTextGeometry(text, size, depth, font) {
+    // Check for notdef glyphs (missing characters)
+    for (const ch of text) {
+        if (ch === ' ' || ch === '\t' || ch === '\n' || ch === '\r')
+            continue;
+        const glyph = font.charToGlyph(ch);
+        if (glyph.index === 0) {
+            throw new Error(`[text-geometry] Character "${ch}" (U+${ch.codePointAt(0).toString(16).toUpperCase()}) ` +
+                `not found in font. If it is a CJK character, a CJK font must be loaded.`);
+        }
+    }
+    const path = font.getPath(text, 0, 0, size);
+    const shape = opentypePathToGeometry(path, depth);
+    if (!shape) {
+        throw new Error(`[text-geometry] Failed to create geometry from text: "${text}"`);
+    }
+    return shape;
+}
+// ── opentype path → Shape ──
+/**
+ * Convert an opentype.js Path to a core Shape.
+ *
+ * Path commands → Contour[] → extrudeShape. The result is centered in X and Z
+ * (bounding box center → origin) with Y aligned to its bottom edge.
+ *
+ * Exported for reuse by the CJK text path and 3d_editor preview layer.
+ *
+ * @param path - the opentype.js path to convert.
+ * @param depth - extrusion depth in mm.
+ * @returns the resulting Shape, or null when the path is empty.
+ */
+export function opentypePathToGeometry(path, depth) {
+    const contours = opentypePathToContours(path, 6);
+    if (contours.length === 0)
+        return null;
+    return centerShapeXZBottom(extrudeShape(contours, depth));
+}
+//# sourceMappingURL=text-geometry.js.map

package/dist/extra/extras/text-geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-geometry.js","sourceRoot":"","sources":["../../../src/extra/extras/text-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,iBAAiB,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAC9F,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,cAAc,GACf,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAK1D,qBAAqB;AAErB;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,iBAAiB,EAAE,CAAA;IACzB,MAAM,IAAI,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAA;IACzC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,2CAA2C;YAC3C,mDAAmD,CACpD,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,iCAAiC;AAEjC;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,IAAU;IAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAyB,CAAA;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,GAAG;gBACN,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACrC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAA;gBACjC,MAAK;YACP,KAAK,GAAG;gBACN,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAA;gBACjC,MAAK;YACP,KAAK,GAAG;gBACN,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAA;gBACzE,MAAK;YACP,KAAK,GAAG;gBACN,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAA;gBACrD,MAAK;YACP,KAAK,GAAG;gBACN,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACf,MAAK;QACT,CAAC;IACH,CAAC;IACD,+CAA+C;IAC/C,oCAAoC;IACpC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAU,EAAE,aAAa,GAAG,CAAC;IAClE,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;IAC1B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,CAAC,EAAE,aAAa,CAAC,CAAA;IAEtD,MAAM,GAAG,GAAwF,EAAE,CAAA;IACnG,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC,EAAE,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,SAAQ;QAClF,MAAM,OAAO,GAAgB,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACxE,GAAG,CAAC,IAAI,CAAC;YACP,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC;YAC1B,UAAU,EAAE,iBAAiB,CAAC,OAAO,CAAC;SACvC,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAA;IAClC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxB,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAqC;QAC5D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAqC,CAAC;KACxE,CAAC,CAAC,CAAA;AACL,CAAC;AAED,sCAAsC;AAEtC;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAY;IAC9C,IAAI,IAAI,GAAG,QAAQ,EAAE,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,GAAG,QAAQ,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAA;IACxE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;QAC5B,MAAM,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QAChC,MAAM,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QAChC,IAAI,CAAC,GAAG,IAAI;YAAE,IAAI,GAAG,CAAC,CAAA;QACtB,IAAI,CAAC,GAAG,IAAI;YAAE,IAAI,GAAG,CAAC,CAAA;QACtB,IAAI,CAAC,GAAG,IAAI;YAAE,IAAI,GAAG,CAAC,CAAA;QACtB,IAAI,CAAC,GAAG,IAAI;YAAE,IAAI,GAAG,CAAC,CAAA;IACxB,CAAC;IACD,MAAM,EAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAA;IAC5B,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,CAAA;IACnB,MAAM,EAAE,GAAG,CAAC,EAAE,CAAA;IACd,MAAM,EAAE,GAAG,CAAC,IAAI,CAAA;IAChB,MAAM,EAAE,GAAG,CAAC,EAAE,CAAA;IACd,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAC1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;QACtC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAA;QAC9C,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAA;IAChD,CAAC;IACD,OAAO,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,CAAA;AAChC,CAAC;AAED,sBAAsB;AAEtB;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,IAAY,EACZ,KAAa,EACb,IAAU;IAEV,+CAA+C;IAC/C,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,8BAA8B,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI;gBACzF,yEAAyE,CAC1E,CAAA;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;IAC3C,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACjD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,yDAAyD,IAAI,GAAG,CAAC,CAAA;IACnF,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,8BAA8B;AAE9B;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAU,EACV,KAAa;IAEb,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAChD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACtC,OAAO,mBAAmB,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAA;AAC3D,CAAC","sourcesContent":["/**\n * text-geometry — 文字几何创建（mesh 路径）\n *\n * 使用 opentype.js + OpenSans Regular 字体（与 BREP 路径统一）。\n * 字体来源：fontRegistry（通过依赖注入的 FontLoader 加载）。\n *\n * 几何链：opentype Path → Contour[]（共享 SVG 语法层折线化 + evenodd 分类，\n * Y-down → Y-up 翻转）→ `extrudeShape`（core 自有，three-free）。\n * 返回 core `Shape`（positions + indices + normals），由使用方自行转为\n * 自己的渲染几何（如 3d_editor 的 BufferGeometry 适配层）。\n */\n\nimport type { Font, Path, PathCommand } from 'opentype.js'\nimport { ensureDefaultFont, getFont as getRegisteredFont } from '../../brep/text/fontRegistry'\nimport {\n  parsePathToSubpaths,\n  computeBBox,\n  computeSignedArea,\n  classifyNested,\n} from '../../primitives/svg/svg-path'\nimport { extrudeShape } from '../../mesh/meshdata/extrude'\nimport type { Contour } from '../../mesh/meshdata/extrude'\nimport type { Shape } from '../../mesh/types'\nimport type { SvgPoint2 } from '../../primitives/svg/svg-path'\n\n// ── Font loading ──\n\n/**\n * Get the default opentype.js font (OpenSans Regular).\n *\n * Fetched from fontRegistry — the same font used by the BREP path\n * (text-to-solid). The first call triggers a lazy ensureDefaultFont() load.\n *\n * @returns a promise resolving to the default opentype.js Font.\n */\nexport async function getOpentypeFont(): Promise<Font> {\n  await ensureDefaultFont()\n  const font = getRegisteredFont('default')\n  if (!font) {\n    throw new Error(\n      '[text-geometry] Default font not loaded. ' +\n      'Call setFontLoader() before using text functions.',\n    )\n  }\n  return font\n}\n\n// ── opentype Path → Contours ──\n\n/**\n * 将 opentype.js Path 命令序列化为 SVG path `d` 字符串。\n *\n * opentype.js 的 glyph 轮廓可能不显式发出 `Z`（隐式闭合）；SVG 语义中\n * 每个 `M` 都开始新子路径、前一子路径隐式闭合。这里在非首个 `M` 前补 `Z`，\n * 使折线化层获得显式闭合（与 three `Shape` 的隐式闭合语义一致）。\n */\nfunction pathToSvgD(path: Path): string {\n  const commands = path.commands as PathCommand[]\n  const parts: string[] = []\n  for (const cmd of commands) {\n    switch (cmd.type) {\n      case 'M':\n        if (parts.length > 0) parts.push('Z')\n        parts.push(`M ${cmd.x},${cmd.y}`)\n        break\n      case 'L':\n        parts.push(`L ${cmd.x},${cmd.y}`)\n        break\n      case 'C':\n        parts.push(`C ${cmd.x1},${cmd.y1} ${cmd.x2},${cmd.y2} ${cmd.x},${cmd.y}`)\n        break\n      case 'Q':\n        parts.push(`Q ${cmd.x1},${cmd.y1} ${cmd.x},${cmd.y}`)\n        break\n      case 'Z':\n        parts.push('Z')\n        break\n    }\n  }\n  // opentype.js 的 glyph 轮廓不显式发出 Z（隐式闭合，终点 = 起点）：\n  // 末尾未闭合的子路径也必须闭合，否则会被折线化层判为开放轮廓而丢弃。\n  if (parts.length > 0 && !/Z$/.test(parts[parts.length - 1])) {\n    parts.push('Z')\n  }\n  return parts.join(' ')\n}\n\n/**\n * 将 opentype.js Path 折线化并分类为 Y-up 平面轮廓（供 `extrudeShape` 消费）。\n *\n * opentype 字形坐标是 Y-down（canvas 惯例），与 SVG 一致；输出翻转至 Y-up，\n * 与 BREP 文本路径（`core/brep/text/text-to-solid.ts`）的世界坐标约定一致。\n *\n * @param path - the opentype.js path to flatten.\n * @param curveSegments - per-curve sampling segments (default 6).\n * @returns the classified contours (Y-up).\n */\nexport function opentypePathToContours(path: Path, curveSegments = 6): Contour[] {\n  const d = pathToSvgD(path)\n  const subpaths = parsePathToSubpaths(d, curveSegments)\n\n  const all: { points: SvgPoint2[]; bbox: ReturnType<typeof computeBBox>; signedArea: number }[] = []\n  for (const sp of subpaths) {\n    if (!sp.closed || Math.abs(sp.signedArea) < 1e-9 || sp.points.length < 3) continue\n    const flipped: SvgPoint2[] = sp.points.map((p) => ({ x: p.x, y: -p.y }))\n    all.push({\n      points: flipped,\n      bbox: computeBBox(flipped),\n      signedArea: computeSignedArea(flipped),\n    })\n  }\n\n  const groups = classifyNested(all)\n  return groups.map((g) => ({\n    outer: all[g.outerIdx].points as unknown as Contour['outer'],\n    holes: g.holes.map((h) => all[h].points as unknown as Contour['outer']),\n  }))\n}\n\n// ── Shape 居中（与既有 three 实现相同的布局语义） ──\n\n/**\n * X 居中、Y 底部对齐到 0、Z 居中（text 链的旧布局语义）。\n * @param shape - 待居中的 Shape（positions 就地复制，不修改输入）。\n * @returns 平移后的新 Shape（索引/法线不变）。\n */\nexport function centerShapeXZBottom(shape: Shape): Shape {\n  let minX = Infinity, maxX = -Infinity, minY = Infinity, maxZ = -Infinity\n  for (let i = 0; i < shape.positions.length; i += 3) {\n    const x = shape.positions[i]\n    const y = shape.positions[i + 1]\n    const z = shape.positions[i + 2]\n    if (x < minX) minX = x\n    if (x > maxX) maxX = x\n    if (y < minY) minY = y\n    if (z > maxZ) maxZ = z\n  }\n  const cx = (minX + maxX) / 2\n  const cz = maxZ / 2\n  const dx = -cx\n  const dy = -minY\n  const dz = -cz\n  const positions = new Float32Array(shape.positions.length)\n  for (let i = 0; i < shape.positions.length; i += 3) {\n    positions[i] = shape.positions[i] + dx\n    positions[i + 1] = shape.positions[i + 1] + dy\n    positions[i + 2] = shape.positions[i + 2] + dz\n  }\n  return { ...shape, positions }\n}\n\n// ── Text geometry ──\n\n/**\n * Create text geometry centered in X/Z, extruded along +Z.\n *\n * Uses opentype.js font.getPath() → Contour[] → extrudeShape, flipping\n * the opentype y-down axis to y-up. This is the same font source and the same\n * axis convention as the BREP path (text-to-solid), ensuring both glyph and\n * orientation consistency between the mesh and BREP paths.\n *\n * @param text  Text string to render\n * @param size  Font size in mm\n * @param depth Extrusion depth in mm\n * @param font  opentype.js Font object (from fontRegistry)\n * @returns a promise resolving to the extruded text shape.\n */\nexport async function createTextGeometry(\n  text: string,\n  size: number,\n  depth: number,\n  font: Font,\n): Promise<Shape> {\n  // Check for notdef glyphs (missing characters)\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        `[text-geometry] 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  const path = font.getPath(text, 0, 0, size)\n  const shape = opentypePathToGeometry(path, depth)\n  if (!shape) {\n    throw new Error(`[text-geometry] Failed to create geometry from text: \"${text}\"`)\n  }\n  return shape\n}\n\n// ── opentype path → Shape ──\n\n/**\n * Convert an opentype.js Path to a core Shape.\n *\n * Path commands → Contour[] → extrudeShape. The result is centered in X and Z\n * (bounding box center → origin) with Y aligned to its bottom edge.\n *\n * Exported for reuse by the CJK text path and 3d_editor preview layer.\n *\n * @param path - the opentype.js path to convert.\n * @param depth - extrusion depth in mm.\n * @returns the resulting Shape, or null when the path is empty.\n */\nexport function opentypePathToGeometry(\n  path: Path,\n  depth: number,\n): Shape | null {\n  const contours = opentypePathToContours(path, 6)\n  if (contours.length === 0) return null\n  return centerShapeXZBottom(extrudeShape(contours, depth))\n}\n"]}

package/dist/extra/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @faicad/faijs/extra — editor extension ops for faijs.
+ *
+ * Carries the ops and preview helpers that serve the editor application but
+ * are now part of the cad namespace (fully assembled inside
+ * `createApiNamespace()`):
+ *
+ * - A group (editor ops): `fai_drill` / `fai_extrude` / `fai_split`,
+ *   `group` / `assembly`, `copy`, `load`.
+ * - B group (svg / 3D text): `text`, `svgExtrude` plus the preview helpers
+ *   `svgToExtrudedGeometry` / `parseSvgShapes` / `extrudeShapes` /
+ *   `createTextGeometry` / `getOpentypeFont` / `opentypePathToGeometry` /
+ *   `createMixedTextGeometry`.
+ *
+ * Hosts no longer need to merge/register these ops — `createRuntime(ports)`
+ * provides the full cad namespace. The `editor-ops` sub-entry remains for
+ * lightweight bundle closures.
+ */
+export { ALL_EDITOR_OPS, CREATOR_OPS, EDITOR_OPS, isEditorOp, type CreatorOpName, type EditorOpName, } from './op-names.js';
+export { fai_drill, assertDrillParams } from './ops/fai_drill.js';
+export { fai_extrude, assertExtrudeParams } from './ops/fai_extrude.js';
+export { fai_split } from './ops/fai_split.js';
+export { group, assembly } from './ops/compound.js';
+export type { GroupParams, AssemblyParams, AssemblyBehavior, AssemblyDecl } from './ops/compound.js';
+export { copy } from './ops/copy.js';
+export { load } from './ops/load.js';
+export type { AssemblyConstraint, FaceMateConstraint, FaceMateFace, EntityRef, FaceRef, EdgeRef, AssemblyVec3, MateConstraint, AlignConstraint, CoincidentConstraint, ConcentricConstraint, DistanceConstraint, AngleConstraint, ParallelConstraint, PerpendicularConstraint, FixedConstraint, StructuralConstraint, } from '../api/assembly/types.js';
+export type { AssemblySolveResult } from '../api/assembly/solve.js';
+export { text, assertTextParams } from './ops/text.js';
+export { svgExtrude, assertSvgExtrudeParams } from './ops/svg-extrude.js';
+export { svgToExtrudedGeometry, parseSvgShapes, extrudeShapes, type SvgExtrudeOptions, } from './extras/svg-extrude.js';
+export { createTextGeometry, getOpentypeFont, opentypePathToGeometry, } from './extras/text-geometry.js';
+export { createMixedTextGeometry } from './extras/text-cjk.js';
+export { createEngraveDecorationProvider } from './mesh/engrave-decoration.js';
+export { split as meshSplit, splitWithParams, dovetailSplit, dowelSplit, tenonSplit, computeBasisFromNormal, } from './mesh/fai_split.js';
+export { drill } from './mesh/fai_drill.js';
+export { extrude as meshExtrude } from './mesh/fai_extrude.js';
+export { text as meshText, svgExtrude as meshSvgExtrude } from './mesh/primitives.js';
+export type { Shape, Vec3, BoundingBox, FaceDescriptor, TextParams, SvgExtrudeParams, DrillParams, ExtrudeParams, SplitPlane, SplitResult, DovetailSplitParams, DowelSplitParams, TenonSplitParams, } from '../mesh/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/extra/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extra/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EACL,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EACnD,KAAK,aAAa,EAAE,KAAK,YAAY,GACtC,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAChD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACjG,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACjC,YAAY,EACV,kBAAkB,EAAE,kBAAkB,EAAE,YAAY,EACpD,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EACzC,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,oBAAoB,EAC3E,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,uBAAuB,EAChF,eAAe,EAAE,oBAAoB,GACtC,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAGhE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAGtE,OAAO,EACL,qBAAqB,EAAE,cAAc,EAAE,aAAa,EACpD,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,kBAAkB,EAAE,eAAe,EAAE,sBAAsB,GAC5D,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAA;AAG3E,OAAO,EACL,KAAK,IAAI,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAC1E,sBAAsB,GACvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClF,YAAY,EACV,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EACxC,UAAU,EAAE,gBAAgB,EAC5B,WAAW,EAAE,aAAa,EAC1B,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,GACjF,MAAM,eAAe,CAAA"}

package/dist/extra/index.js

@@ -0,0 +1,40 @@
+/**
+ * @faicad/faijs/extra — editor extension ops for faijs.
+ *
+ * Carries the ops and preview helpers that serve the editor application but
+ * are now part of the cad namespace (fully assembled inside
+ * `createApiNamespace()`):
+ *
+ * - A group (editor ops): `fai_drill` / `fai_extrude` / `fai_split`,
+ *   `group` / `assembly`, `copy`, `load`.
+ * - B group (svg / 3D text): `text`, `svgExtrude` plus the preview helpers
+ *   `svgToExtrudedGeometry` / `parseSvgShapes` / `extrudeShapes` /
+ *   `createTextGeometry` / `getOpentypeFont` / `opentypePathToGeometry` /
+ *   `createMixedTextGeometry`.
+ *
+ * Hosts no longer need to merge/register these ops — `createRuntime(ports)`
+ * provides the full cad namespace. The `editor-ops` sub-entry remains for
+ * lightweight bundle closures.
+ */
+export { ALL_EDITOR_OPS, CREATOR_OPS, EDITOR_OPS, isEditorOp, } from './op-names.js';
+// ── A 组：编辑器 op 定义 ──
+export { fai_drill, assertDrillParams } from './ops/fai_drill.js';
+export { fai_extrude, assertExtrudeParams } from './ops/fai_extrude.js';
+export { fai_split } from './ops/fai_split.js';
+export { group, assembly } from './ops/compound.js';
+export { copy } from './ops/copy.js';
+export { load } from './ops/load.js';
+// ── B 组：svg / 3D 文字 op ──
+export { text, assertTextParams } from './ops/text.js';
+export { svgExtrude, assertSvgExtrudeParams } from './ops/svg-extrude.js';
+// ── B 组：预览辅助函数（宿主交互预览用，不提交几何）──
+export { svgToExtrudedGeometry, parseSvgShapes, extrudeShapes, } from './extras/svg-extrude.js';
+export { createTextGeometry, getOpentypeFont, opentypePathToGeometry, } from './extras/text-geometry.js';
+export { createMixedTextGeometry } from './extras/text-cjk.js';
+export { createEngraveDecorationProvider } from './mesh/engrave-decoration.js';
+// ── mesh implementations (editor script face / previews; exported per module, no aggregate) ──
+export { split as meshSplit, splitWithParams, dovetailSplit, dowelSplit, tenonSplit, computeBasisFromNormal, } from './mesh/fai_split.js';
+export { drill } from './mesh/fai_drill.js';
+export { extrude as meshExtrude } from './mesh/fai_extrude.js';
+export { text as meshText, svgExtrude as meshSvgExtrude } from './mesh/primitives.js';
+//# sourceMappingURL=index.js.map

package/dist/extra/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extra/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EACL,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,GAEpD,MAAM,YAAY,CAAA;AAEnB,sBAAsB;AACtB,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEhD,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAUjC,2BAA2B;AAC3B,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAEtE,iCAAiC;AACjC,OAAO,EACL,qBAAqB,EAAE,cAAc,EAAE,aAAa,GAErD,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,kBAAkB,EAAE,eAAe,EAAE,sBAAsB,GAC5D,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAA;AAE3E,gGAAgG;AAChG,OAAO,EACL,KAAK,IAAI,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAC1E,sBAAsB,GACvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAA","sourcesContent":["/**\n * @faicad/faijs/extra — editor extension ops for faijs.\n *\n * Carries the ops and preview helpers that serve the editor application but\n * are now part of the cad namespace (fully assembled inside\n * `createApiNamespace()`):\n *\n * - A group (editor ops): `fai_drill` / `fai_extrude` / `fai_split`,\n *   `group` / `assembly`, `copy`, `load`.\n * - B group (svg / 3D text): `text`, `svgExtrude` plus the preview helpers\n *   `svgToExtrudedGeometry` / `parseSvgShapes` / `extrudeShapes` /\n *   `createTextGeometry` / `getOpentypeFont` / `opentypePathToGeometry` /\n *   `createMixedTextGeometry`.\n *\n * Hosts no longer need to merge/register these ops — `createRuntime(ports)`\n * provides the full cad namespace. The `editor-ops` sub-entry remains for\n * lightweight bundle closures.\n */\nexport {\n  ALL_EDITOR_OPS, CREATOR_OPS, EDITOR_OPS, isEditorOp,\n  type CreatorOpName, type EditorOpName,\n} from './op-names'\n\n// ── A 组：编辑器 op 定义 ──\nexport { fai_drill, assertDrillParams } from './ops/fai_drill'\nexport { fai_extrude, assertExtrudeParams } from './ops/fai_extrude'\nexport { fai_split } from './ops/fai_split'\nexport { group, assembly } from './ops/compound'\nexport type { GroupParams, AssemblyParams, AssemblyBehavior, AssemblyDecl } from './ops/compound'\nexport { copy } from './ops/copy'\nexport { load } from './ops/load'\nexport type {\n  AssemblyConstraint, FaceMateConstraint, FaceMateFace,\n  EntityRef, FaceRef, EdgeRef, AssemblyVec3,\n  MateConstraint, AlignConstraint, CoincidentConstraint, ConcentricConstraint,\n  DistanceConstraint, AngleConstraint, ParallelConstraint, PerpendicularConstraint,\n  FixedConstraint, StructuralConstraint,\n} from '../api/assembly/types'\nexport type { AssemblySolveResult } from '../api/assembly/solve'\n\n// ── B 组：svg / 3D 文字 op ──\nexport { text, assertTextParams } from './ops/text'\nexport { svgExtrude, assertSvgExtrudeParams } from './ops/svg-extrude'\n\n// ── B 组：预览辅助函数（宿主交互预览用，不提交几何）──\nexport {\n  svgToExtrudedGeometry, parseSvgShapes, extrudeShapes,\n  type SvgExtrudeOptions,\n} from './extras/svg-extrude'\nexport {\n  createTextGeometry, getOpentypeFont, opentypePathToGeometry,\n} from './extras/text-geometry'\nexport { createMixedTextGeometry } from './extras/text-cjk'\nexport { createEngraveDecorationProvider } from './mesh/engrave-decoration'\n\n// ── mesh implementations (editor script face / previews; exported per module, no aggregate) ──\nexport {\n  split as meshSplit, splitWithParams, dovetailSplit, dowelSplit, tenonSplit,\n  computeBasisFromNormal,\n} from './mesh/fai_split'\nexport { drill } from './mesh/fai_drill'\nexport { extrude as meshExtrude } from './mesh/fai_extrude'\nexport { text as meshText, svgExtrude as meshSvgExtrude } from './mesh/primitives'\nexport type {\n  Shape, Vec3, BoundingBox, FaceDescriptor,\n  TextParams, SvgExtrudeParams,\n  DrillParams, ExtrudeParams,\n  SplitPlane, SplitResult, DovetailSplitParams, DowelSplitParams, TenonSplitParams,\n} from '../mesh/types'\n"]}

package/dist/extra/mesh/drill-hole/DrillHoleCore.d.ts

@@ -0,0 +1,94 @@
+import { Vec3, Mat4, Box3 } from '../../../math3d/index.js';
+import type { Shape } from '../../../mesh/types.js';
+import type { DrillDirection, DrillHoleParams } from './drill-types.js';
+/**
+ * Build a Z-up hole geometry centered on the origin, with the axial direction
+ * along Z.
+ *
+ * - simple: CylinderGeometry rotated to Z-up
+ * - screw: makeScrew() already returns Z-up
+ *
+ * Tolerance is applied as a radial expansion (tolerance/2 on radius).
+ *
+ * @param params - drill-hole parameters (type, diameter, screw details, tolerance).
+ * @param height - axial length of the hole in millimeters.
+ * @returns the hole geometry as a Z-up Shape.
+ */
+export declare function buildHoleGeometry(params: DrillHoleParams, height: number): Shape;
+/**
+ * Compute the through-hole height by raycasting against the target mesh's
+ * bounding box. Returns { height, center } so the cylinder exactly spans the
+ * model thickness along the drill direction, without extending outside.
+ *
+ * @param position - world-space position of the hole entry point.
+ * @param direction - the drill direction (normalized internally).
+ * @param bbox - world-space bounding box of the target mesh.
+ * @returns the height and world-space center of the through hole.
+ */
+export declare function computeThroughHoleDimensions(position: Vec3, direction: Vec3, bbox: Box3): {
+    height: number;
+    center: Vec3;
+};
+/**
+ * Compute the blind-hole center: the hole entry is at the click point,
+ * the hole extends inward by `depth`. The cylinder center is at
+ * position + direction * (depth / 2).
+ *
+ * @param position - world-space hole entry point.
+ * @param direction - the drill direction (normalized internally).
+ * @param depth - blind-hole depth in millimeters.
+ * @returns the world-space cylinder center.
+ */
+export declare function computeBlindHoleCenter(position: Vec3, direction: Vec3, depth: number): Vec3;
+/**
+ * Orient and position a Z-up hole geometry (axial along Z) to world space.
+ * Returns a new geometry with the transform baked in.
+ *
+ * @param geo - Z-up hole geometry centered on the origin.
+ * @param direction - world-space axis the hole should point along.
+ * @param center - world-space position of the hole center.
+ * @returns a transformed clone of the input geometry.
+ */
+export declare function positionHoleGeometry(geo: Shape, direction: Vec3, center: Vec3): Shape;
+/**
+ * Resolve the drill direction based on params.direction and the face normal.
+ *
+ * - 'normal': inward direction = negated face normal
+ * - 'x'/'y'/'z': axis-aligned, flipped to point INTO the material
+ *   (i.e. opposite to the face normal)
+ *
+ * @param direction - requested drill-direction reference.
+ * @param faceNormal - face normal at the drill position.
+ * @returns the resolved unit drill direction.
+ */
+export declare function resolveDrillDirection(direction: DrillDirection, faceNormal: Vec3): Vec3;
+/**
+ * Drill a hole into a mesh in world space, returning the resulting
+ * geometry in the mesh's local space.
+ *
+ * @param target - the target mesh-like object with geometry and world matrix.
+ * @param params - drill-hole parameters.
+ * @param position - world-space hole entry point.
+ * @param faceNormal - world-space normal of the face at the entry point.
+ * @returns the drilled geometry in mesh-local space.
+ */
+export declare function executeDrillHole(target: {
+    geometry: Shape;
+    matrixWorld: Mat4;
+}, params: DrillHoleParams, position: Vec3, faceNormal: Vec3): Promise<Shape>;
+/**
+ * Core drill computation that accepts geometry + world matrix directly.
+ *
+ * This avoids the need to temporarily swap mesh.geometry when the mesh
+ * currently has a preview geometry on it. Callers that have the G0 geometry
+ * in a separate Shape can use this directly.
+ *
+ * @param sourceGeometry - the base geometry to drill (mesh-local space).
+ * @param worldMatrix - world transform of the source geometry.
+ * @param params - drill-hole parameters.
+ * @param position - world-space hole entry point.
+ * @param faceNormal - world-space face normal at the entry point.
+ * @returns the drilled geometry, transformed back into mesh-local space.
+ */
+export declare function executeDrillHoleOnGeometry(sourceGeometry: Shape, worldMatrix: Mat4, params: DrillHoleParams, position: Vec3, faceNormal: Vec3): Promise<Shape>;
+//# sourceMappingURL=DrillHoleCore.d.ts.map

package/dist/extra/mesh/drill-hole/DrillHoleCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DrillHoleCore.d.ts","sourceRoot":"","sources":["../../../../src/extra/mesh/drill-hole/DrillHoleCore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAQ,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAYhD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAKpE;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,GACb,KAAK,CA8DP;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,IAAI,EACd,SAAS,EAAE,IAAI,EACf,IAAI,EAAE,IAAI,GACT;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,IAAI,CAAA;CAAE,CAqDlC;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,IAAI,EACd,SAAS,EAAE,IAAI,EACf,KAAK,EAAE,MAAM,GACZ,IAAI,CAEN;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,KAAK,EACV,SAAS,EAAE,IAAI,EACf,MAAM,EAAE,IAAI,GACX,KAAK,CAWP;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,IAAI,GACf,IAAI,CAiBN;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,IAAI,CAAA;CAAE,EAC9C,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,IAAI,EACd,UAAU,EAAE,IAAI,GACf,OAAO,CAAC,KAAK,CAAC,CAQhB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,0BAA0B,CAC9C,cAAc,EAAE,KAAK,EACrB,WAAW,EAAE,IAAI,EACjB,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,IAAI,EACd,UAAU,EAAE,IAAI,GACf,OAAO,CAAC,KAAK,CAAC,CA0EhB"}