@faicad/faijs 0.13.0

package/dist/primitives/text/cjk.js

@@ -0,0 +1,215 @@
+/**
+ * CJK (Chinese/Japanese/Korean) text geometry generation.
+ *
+ * Uses the Local Font Access API (window.queryLocalFonts) to load system CJK
+ * fonts, then parses glyph paths with opentype.js to create THREE.Shape →
+ * ExtrudeGeometry.
+ *
+ * When a CJK font is available, it is used for ALL characters (including Latin).
+ * When no CJK font is available, the default OpenSans Regular font (from
+ * fontRegistry) is used for all characters via opentype.js.
+ */
+import * as THREE from 'three';
+import * as opentype from 'opentype.js';
+import { mergeBufferGeometries } from '../../primitives/mesh-primitives.js';
+import { getOpentypeFont } from '../text-geometry.js';
+/**
+ * Check if a character is CJK (CJK Unified Ideographs + extensions).
+ *
+ * @param ch - the single character to test.
+ * @returns true when the character falls in a CJK code point range.
+ */
+export function isCjkChar(ch) {
+    const code = ch.charCodeAt(0);
+    return ((code >= 0x4E00 && code <= 0x9FFF) || // CJK Unified Ideographs
+        (code >= 0x3400 && code <= 0x4DBF) || // CJK Extension A
+        (code >= 0x2F800 && code <= 0x2FA1F) || // CJK Compatibility Ideographs Supplement
+        (code >= 0x3000 && code <= 0x303F) || // CJK Symbols and Punctuation
+        (code >= 0xFF00 && code <= 0xFFEF) // Fullwidth Forms
+    );
+}
+/**
+ * Check if a text string contains any CJK characters.
+ *
+ * @param text - the text to scan.
+ * @returns true when at least one character is CJK.
+ */
+export function containsCjk(text) {
+    for (const ch of text) {
+        if (isCjkChar(ch))
+            return true;
+    }
+    return false;
+}
+/**
+ * Load a CJK font from the system using the Local Font Access API.
+ * Returns null if unavailable (no permission, unsupported browser, or no CJK font found).
+ *
+ * @returns a promise resolving to the parsed CJK font and its family name,
+ *   or null when no usable system CJK font is available.
+ */
+export async function loadSystemCjkFont() {
+    const w = typeof window !== 'undefined' ? window : undefined;
+    if (!w || typeof w.queryLocalFonts !== 'function') {
+        return null;
+    }
+    try {
+        const fonts = await w.queryLocalFonts();
+        // Find a font that supports CJK
+        const cjkFont = fonts.find((f) => f.family.includes('Microsoft YaHei') ||
+            f.family.includes('SimSun') ||
+            f.family.includes('Noto Sans') ||
+            f.family.includes('Noto Serif') ||
+            f.fullName.includes('CJK') ||
+            f.fullName.includes('SC') ||
+            f.fullName.includes('CN') ||
+            f.fullName.includes('JP') ||
+            f.fullName.includes('KR') ||
+            f.family.includes('Source Han') ||
+            f.family.includes('思源') ||
+            f.family.includes('微软雅黑') ||
+            f.family.includes('宋体') ||
+            f.family.includes('黑体') ||
+            f.family.includes('楷体') ||
+            f.family.includes('仿宋'));
+        if (!cjkFont)
+            return null;
+        const fontData = await cjkFont.blob();
+        const buf = await fontData.arrayBuffer();
+        const font = opentype.parse(buf);
+        return { font, family: cjkFont.family };
+    }
+    catch {
+        // User denied permission or other error
+        return null;
+    }
+}
+/**
+ * Generate geometry for a single character using opentype.js.
+ * Uses the shared opentypePathToGeometry() from text-geometry.ts.
+ */
+function charGeometry(char, size, depth, font, xOffset) {
+    const glyph = font.charToGlyph(char);
+    if (!glyph || !glyph.path)
+        return null;
+    const path = glyph.getPath(xOffset, 0, size);
+    if (!path || !path.commands || path.commands.length === 0)
+        return null;
+    // Use the shared opentypePathToGeometry, but without centering (we handle offset manually)
+    const commands = path.commands;
+    if (commands.length === 0)
+        return null;
+    const shapes = [];
+    let currentShape = null;
+    for (const cmd of commands) {
+        switch (cmd.type) {
+            case 'M':
+                // Implicit closure: opentype.js doesn't always emit 'Z' before a new 'M'.
+                if (currentShape) {
+                    shapes.push(currentShape);
+                }
+                currentShape = new THREE.Shape();
+                currentShape.moveTo(cmd.x, cmd.y);
+                break;
+            case 'L':
+                currentShape?.lineTo(cmd.x, cmd.y);
+                break;
+            case 'C':
+                currentShape?.bezierCurveTo(cmd.x1, cmd.y1, cmd.x2, cmd.y2, cmd.x, cmd.y);
+                break;
+            case 'Q':
+                currentShape?.quadraticCurveTo(cmd.x1, cmd.y1, cmd.x, cmd.y);
+                break;
+            case 'Z':
+                if (currentShape) {
+                    shapes.push(currentShape);
+                    currentShape = null;
+                }
+                break;
+        }
+    }
+    // Handle final unclosed subpath (opentype.js doesn't always emit 'Z')
+    if (currentShape) {
+        shapes.push(currentShape);
+    }
+    if (shapes.length === 0)
+        return null;
+    const geo = new THREE.ExtrudeGeometry(shapes, {
+        depth,
+        bevelEnabled: false,
+        curveSegments: 6,
+    });
+    return geo;
+}
+/**
+ * Generate geometry for mixed text (CJK + Latin).
+ *
+ * When cjkFont is available, it is used for ALL characters (including Latin),
+ * since CJK fonts typically contain Latin glyphs.
+ *
+ * When cjkFont is null, the default OpenSans Regular font (from fontRegistry)
+ * is used for all characters via opentype.js — this is the same font used by
+ * the BREP path, ensuring glyph consistency.
+ *
+ * @param text     Text string to render
+ * @param size     Font size in mm
+ * @param depth    Extrusion depth in mm
+ * @param cjkFont  CJK font from system (null = use default font only)
+ * @param defaultFont  Default opentype.js Font (OpenSans Regular from fontRegistry).
+ *                     If not provided, will be loaded via getOpentypeFont().
+ * @returns a promise resolving to the merged, centred geometry for the whole text.
+ */
+export async function createMixedTextGeometry(text, size, depth, cjkFont, defaultFont) {
+    // Use CJK font for all chars if available, otherwise use default font
+    const font = cjkFont ?? defaultFont ?? (await getOpentypeFont());
+    // All characters individually
+    const charGeos = [];
+    let cursorX = 0;
+    for (const char of text) {
+        if (char === ' ' || char === '\t' || char === '\n' || char === '\r') {
+            // Space: advance by approximate width
+            const spaceAdv = font.charToGlyph(' ').advanceWidth ?? size / 3;
+            cursorX += spaceAdv * (size / font.unitsPerEm);
+            continue;
+        }
+        const glyph = font.charToGlyph(char);
+        if (glyph.index === 0) {
+            // Skip notdef glyphs (should not happen if font check was done upstream)
+            continue;
+        }
+        const geo = charGeometry(char, size, depth, font, cursorX);
+        if (geo) {
+            geo.computeBoundingBox();
+            const bb = geo.boundingBox;
+            const charWidth = bb.max.x - bb.min.x;
+            const adv = (glyph.advanceWidth ?? 0) * (size / font.unitsPerEm);
+            // Use advance width for cursor, but ensure minimum advance
+            const effectiveAdv = adv > 0 ? adv : charWidth + size * 0.1;
+            charGeos.push({ geo, advance: effectiveAdv });
+            cursorX += effectiveAdv;
+        }
+    }
+    // Merge all character geometries into one
+    if (charGeos.length === 0) {
+        // Fallback: create a minimal geometry from a question mark
+        const geo = charGeometry('?', size, depth, font, 0);
+        if (geo)
+            return geo;
+        return new THREE.BufferGeometry();
+    }
+    // Merge via BufferGeometryUtils or manual merge
+    const merged = mergeBufferGeometries(charGeos.map((cg) => cg.geo));
+    // Center the whole text in X/Z
+    merged.computeBoundingBox();
+    if (merged.boundingBox) {
+        const cx = (merged.boundingBox.max.x + merged.boundingBox.min.x) / 2;
+        const cz = (merged.boundingBox.max.z + merged.boundingBox.min.z) / 2;
+        merged.translate(-cx, -merged.boundingBox.min.y, -cz);
+    }
+    // Dispose individual geometries
+    for (const cg of charGeos) {
+        cg.geo.dispose();
+    }
+    return merged;
+}
+//# sourceMappingURL=cjk.js.map

package/dist/primitives/text/cjk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cjk.js","sourceRoot":"","sources":["../../../src/primitives/text/cjk.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * CJK (Chinese/Japanese/Korean) text geometry generation.\n *\n * Uses the Local Font Access API (window.queryLocalFonts) to load system CJK\n * fonts, then parses glyph paths with opentype.js to create THREE.Shape →\n * ExtrudeGeometry.\n *\n * When a CJK font is available, it is used for ALL characters (including Latin).\n * When no CJK font is available, the default OpenSans Regular font (from\n * fontRegistry) is used for all characters via opentype.js.\n */\nimport * as THREE from 'three'\nimport * as opentype from 'opentype.js'\nimport type { Font } from 'opentype.js'\nimport { mergeBufferGeometries } from '../../primitives/mesh-primitives'\nimport { getOpentypeFont } from '../text-geometry'\n\n/**\n * Check if a character is CJK (CJK Unified Ideographs + extensions).\n *\n * @param ch - the single character to test.\n * @returns true when the character falls in a CJK code point range.\n */\nexport function isCjkChar(ch: string): boolean {\n  const code = ch.charCodeAt(0)\n  return (\n    (code >= 0x4E00 && code <= 0x9FFF) ||    // CJK Unified Ideographs\n    (code >= 0x3400 && code <= 0x4DBF) ||    // CJK Extension A\n    (code >= 0x2F800 && code <= 0x2FA1F) ||  // CJK Compatibility Ideographs Supplement\n    (code >= 0x3000 && code <= 0x303F) ||    // CJK Symbols and Punctuation\n    (code >= 0xFF00 && code <= 0xFFEF)       // Fullwidth Forms\n  )\n}\n\n/**\n * Check if a text string contains any CJK characters.\n *\n * @param text - the text to scan.\n * @returns true when at least one character is CJK.\n */\nexport function containsCjk(text: string): boolean {\n  for (const ch of text) {\n    if (isCjkChar(ch)) return true\n  }\n  return false\n}\n\n/** Result of loading a system CJK font. */\nexport interface CjkFontResult {\n  font: opentype.Font\n  family: string\n}\n\n/**\n * Load a CJK font from the system using the Local Font Access API.\n * Returns null if unavailable (no permission, unsupported browser, or no CJK font found).\n *\n * @returns a promise resolving to the parsed CJK font and its family name,\n *   or null when no usable system CJK font is available.\n */\nexport async function loadSystemCjkFont(): Promise<CjkFontResult | null> {\n  const w = typeof window !== 'undefined' ? (window as any) : undefined\n  if (!w || typeof w.queryLocalFonts !== 'function') {\n    return null\n  }\n\n  try {\n    const fonts: Array<{ family: string; fullName: string; style: string; postscriptName: string; blob: () => Promise<Blob> }> = await w.queryLocalFonts()\n\n    // Find a font that supports CJK\n    const cjkFont = fonts.find((f) =>\n      f.family.includes('Microsoft YaHei') ||\n      f.family.includes('SimSun') ||\n      f.family.includes('Noto Sans') ||\n      f.family.includes('Noto Serif') ||\n      f.fullName.includes('CJK') ||\n      f.fullName.includes('SC') ||\n      f.fullName.includes('CN') ||\n      f.fullName.includes('JP') ||\n      f.fullName.includes('KR') ||\n      f.family.includes('Source Han') ||\n      f.family.includes('思源') ||\n      f.family.includes('微软雅黑') ||\n      f.family.includes('宋体') ||\n      f.family.includes('黑体') ||\n      f.family.includes('楷体') ||\n      f.family.includes('仿宋')\n    )\n\n    if (!cjkFont) return null\n\n    const fontData = await cjkFont.blob()\n    const buf = await fontData.arrayBuffer()\n    const font = opentype.parse(buf)\n\n    return { font, family: cjkFont.family }\n  } catch {\n    // User denied permission or other error\n    return null\n  }\n}\n\n/**\n * Generate geometry for a single character using opentype.js.\n * Uses the shared opentypePathToGeometry() from text-geometry.ts.\n */\nfunction charGeometry(\n  char: string,\n  size: number,\n  depth: number,\n  font: Font,\n  xOffset: number,\n): THREE.BufferGeometry | null {\n  const glyph = font.charToGlyph(char)\n  if (!glyph || !glyph.path) return null\n\n  const path = glyph.getPath(xOffset, 0, size)\n  if (!path || !path.commands || path.commands.length === 0) return null\n\n  // Use the shared opentypePathToGeometry, but without centering (we handle offset manually)\n  const commands = path.commands as opentype.PathCommand[]\n  if (commands.length === 0) return null\n\n  const shapes: THREE.Shape[] = []\n  let currentShape: THREE.Shape | null = null\n\n  for (const cmd of commands) {\n    switch (cmd.type) {\n      case 'M':\n        // Implicit closure: opentype.js doesn't always emit 'Z' before a new 'M'.\n        if (currentShape) {\n          shapes.push(currentShape)\n        }\n        currentShape = new THREE.Shape()\n        currentShape.moveTo(cmd.x!, cmd.y!)\n        break\n      case 'L':\n        currentShape?.lineTo(cmd.x!, cmd.y!)\n        break\n      case 'C':\n        currentShape?.bezierCurveTo(cmd.x1!, cmd.y1!, cmd.x2!, cmd.y2!, cmd.x!, cmd.y!)\n        break\n      case 'Q':\n        currentShape?.quadraticCurveTo(cmd.x1!, cmd.y1!, cmd.x!, cmd.y!)\n        break\n      case 'Z':\n        if (currentShape) {\n          shapes.push(currentShape)\n          currentShape = null\n        }\n        break\n    }\n  }\n\n  // Handle final unclosed subpath (opentype.js doesn't always emit 'Z')\n  if (currentShape) {\n    shapes.push(currentShape)\n  }\n\n  if (shapes.length === 0) return null\n\n  const geo = new THREE.ExtrudeGeometry(shapes, {\n    depth,\n    bevelEnabled: false,\n    curveSegments: 6,\n  })\n  return geo\n}\n\n\n/**\n * Generate geometry for mixed text (CJK + Latin).\n *\n * When cjkFont is available, it is used for ALL characters (including Latin),\n * since CJK fonts typically contain Latin glyphs.\n *\n * When cjkFont is null, the default OpenSans Regular font (from fontRegistry)\n * is used for all characters via opentype.js — this is the same font used by\n * the BREP path, ensuring glyph consistency.\n *\n * @param text     Text string to render\n * @param size     Font size in mm\n * @param depth    Extrusion depth in mm\n * @param cjkFont  CJK font from system (null = use default font only)\n * @param defaultFont  Default opentype.js Font (OpenSans Regular from fontRegistry).\n *                     If not provided, will be loaded via getOpentypeFont().\n * @returns a promise resolving to the merged, centred geometry for the whole text.\n */\nexport async function createMixedTextGeometry(\n  text: string,\n  size: number,\n  depth: number,\n  cjkFont: Font | null,\n  defaultFont?: Font,\n): Promise<THREE.BufferGeometry> {\n  // Use CJK font for all chars if available, otherwise use default font\n  const font = cjkFont ?? defaultFont ?? (await getOpentypeFont())\n\n  // All characters individually\n  const charGeos: { geo: THREE.BufferGeometry; advance: number }[] = []\n  let cursorX = 0\n\n  for (const char of text) {\n    if (char === ' ' || char === '\\t' || char === '\\n' || char === '\\r') {\n      // Space: advance by approximate width\n      const spaceAdv = font.charToGlyph(' ').advanceWidth ?? size / 3\n      cursorX += spaceAdv * (size / font.unitsPerEm)\n      continue\n    }\n\n    const glyph = font.charToGlyph(char)\n    if (glyph.index === 0) {\n      // Skip notdef glyphs (should not happen if font check was done upstream)\n      continue\n    }\n\n    const geo = charGeometry(char, size, depth, font, cursorX)\n    if (geo) {\n      geo.computeBoundingBox()\n      const bb = geo.boundingBox!\n      const charWidth = bb.max.x - bb.min.x\n      const adv = (glyph.advanceWidth ?? 0) * (size / font.unitsPerEm)\n      // Use advance width for cursor, but ensure minimum advance\n      const effectiveAdv = adv > 0 ? adv : charWidth + size * 0.1\n      charGeos.push({ geo, advance: effectiveAdv })\n      cursorX += effectiveAdv\n    }\n  }\n\n  // Merge all character geometries into one\n  if (charGeos.length === 0) {\n    // Fallback: create a minimal geometry from a question mark\n    const geo = charGeometry('?', size, depth, font, 0)\n    if (geo) return geo\n    return new THREE.BufferGeometry()\n  }\n\n  // Merge via BufferGeometryUtils or manual merge\n  const merged = mergeBufferGeometries(charGeos.map((cg) => cg.geo))\n\n  // Center the whole text in X/Z\n  merged.computeBoundingBox()\n  if (merged.boundingBox) {\n    const cx = (merged.boundingBox.max.x + merged.boundingBox.min.x) / 2\n    const cz = (merged.boundingBox.max.z + merged.boundingBox.min.z) / 2\n    merged.translate(-cx, -merged.boundingBox.min.y, -cz)\n  }\n\n  // Dispose individual geometries\n  for (const cg of charGeos) {\n    cg.geo.dispose()\n  }\n\n  return merged\n}\n"]}

package/dist/primitives/text-geometry.d.ts

@@ -0,0 +1,47 @@
+/**
+ * text-geometry — 文字几何创建（mesh 路径）
+ *
+ * 使用 opentype.js + OpenSans Regular 字体（与 BREP 路径统一）。
+ * 字体来源：fontRegistry（通过依赖注入的 FontLoader 加载）。
+ *
+ * 过渡期仍用 THREE.Shape/ExtrudeGeometry，R6 时再替换为 manifold。
+ */
+import * as THREE from 'three';
+import type { Font, Path } from 'opentype.js';
+/**
+ * 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 declare function getOpentypeFont(): Promise<Font>;
+/**
+ * Create text geometry centered in X/Z, extruded along +Z.
+ *
+ * Uses opentype.js font.getPath() → THREE.Shape → ExtrudeGeometry.
+ * This is the same font source as the BREP path (text-to-solid),
+ * ensuring glyph consistency between 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 geometry.
+ */
+export declare function createTextGeometry(text: string, size: number, depth: number, font: Font): Promise<THREE.BufferGeometry>;
+/**
+ * Convert an opentype.js Path to THREE.BufferGeometry.
+ *
+ * Path commands → THREE.Shape → ExtrudeGeometry.
+ * The result is centered in X and Z (bounding box center → origin).
+ *
+ * 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 BufferGeometry, or null when the path is empty.
+ */
+export declare function opentypePathToGeometry(path: Path, depth: number): THREE.BufferGeometry | null;
+//# sourceMappingURL=text-geometry.d.ts.map

package/dist/primitives/text-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-geometry.d.ts","sourceRoot":"","sources":["../../src/primitives/text-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAe,MAAM,aAAa,CAAA;AAK1D;;;;;;;GAOG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAUrD;AAID;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAmB/B;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,cAAc,GAAG,IAAI,CAuD7B"}

package/dist/primitives/text-geometry.js

@@ -0,0 +1,127 @@
+/**
+ * text-geometry — 文字几何创建（mesh 路径）
+ *
+ * 使用 opentype.js + OpenSans Regular 字体（与 BREP 路径统一）。
+ * 字体来源：fontRegistry（通过依赖注入的 FontLoader 加载）。
+ *
+ * 过渡期仍用 THREE.Shape/ExtrudeGeometry，R6 时再替换为 manifold。
+ */
+import * as THREE from 'three';
+import { ensureDefaultFont, getFont as getRegisteredFont } from '../brep/text/fontRegistry.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;
+}
+// ── Text geometry ──
+/**
+ * Create text geometry centered in X/Z, extruded along +Z.
+ *
+ * Uses opentype.js font.getPath() → THREE.Shape → ExtrudeGeometry.
+ * This is the same font source as the BREP path (text-to-solid),
+ * ensuring glyph consistency between 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 geometry.
+ */
+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 geo = opentypePathToGeometry(path, depth);
+    if (!geo) {
+        throw new Error(`[text-geometry] Failed to create geometry from text: "${text}"`);
+    }
+    return geo;
+}
+// ── opentype path → THREE geometry ──
+/**
+ * Convert an opentype.js Path to THREE.BufferGeometry.
+ *
+ * Path commands → THREE.Shape → ExtrudeGeometry.
+ * The result is centered in X and Z (bounding box center → origin).
+ *
+ * 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 BufferGeometry, or null when the path is empty.
+ */
+export function opentypePathToGeometry(path, depth) {
+    const commands = path.commands;
+    if (commands.length === 0)
+        return null;
+    const shapes = [];
+    let currentShape = null;
+    for (const cmd of commands) {
+        switch (cmd.type) {
+            case 'M':
+                // Implicit closure: opentype.js doesn't always emit 'Z' before a new 'M'.
+                // Push the current shape before starting a new subpath.
+                if (currentShape) {
+                    shapes.push(currentShape);
+                }
+                currentShape = new THREE.Shape();
+                currentShape.moveTo(cmd.x, cmd.y);
+                break;
+            case 'L':
+                currentShape?.lineTo(cmd.x, cmd.y);
+                break;
+            case 'C':
+                currentShape?.bezierCurveTo(cmd.x1, cmd.y1, cmd.x2, cmd.y2, cmd.x, cmd.y);
+                break;
+            case 'Q':
+                currentShape?.quadraticCurveTo(cmd.x1, cmd.y1, cmd.x, cmd.y);
+                break;
+            case 'Z':
+                if (currentShape) {
+                    shapes.push(currentShape);
+                    currentShape = null;
+                }
+                break;
+        }
+    }
+    // Handle final unclosed subpath (opentype.js doesn't always emit 'Z')
+    if (currentShape) {
+        shapes.push(currentShape);
+    }
+    if (shapes.length === 0)
+        return null;
+    const geo = new THREE.ExtrudeGeometry(shapes, {
+        depth,
+        bevelEnabled: false,
+        curveSegments: 6,
+    });
+    geo.computeBoundingBox();
+    if (geo.boundingBox) {
+        const cx = (geo.boundingBox.max.x + geo.boundingBox.min.x) / 2;
+        const cz = (geo.boundingBox.max.z + geo.boundingBox.min.z) / 2;
+        geo.translate(-cx, -geo.boundingBox.min.y, -cz);
+    }
+    return geo;
+}
+//# sourceMappingURL=text-geometry.js.map

package/dist/primitives/text-geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-geometry.js","sourceRoot":"","sources":["../../src/primitives/text-geometry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * text-geometry — 文字几何创建（mesh 路径）\n *\n * 使用 opentype.js + OpenSans Regular 字体（与 BREP 路径统一）。\n * 字体来源：fontRegistry（通过依赖注入的 FontLoader 加载）。\n *\n * 过渡期仍用 THREE.Shape/ExtrudeGeometry，R6 时再替换为 manifold。\n */\n\nimport * as THREE from 'three'\nimport type { Font, Path, PathCommand } from 'opentype.js'\nimport { ensureDefaultFont, getFont as getRegisteredFont } from '../brep/text/fontRegistry'\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// ── Text geometry ──\n\n/**\n * Create text geometry centered in X/Z, extruded along +Z.\n *\n * Uses opentype.js font.getPath() → THREE.Shape → ExtrudeGeometry.\n * This is the same font source as the BREP path (text-to-solid),\n * ensuring glyph consistency between 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 geometry.\n */\nexport async function createTextGeometry(\n  text: string,\n  size: number,\n  depth: number,\n  font: Font,\n): Promise<THREE.BufferGeometry> {\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 geo = opentypePathToGeometry(path, depth)\n  if (!geo) {\n    throw new Error(`[text-geometry] Failed to create geometry from text: \"${text}\"`)\n  }\n  return geo\n}\n\n// ── opentype path → THREE geometry ──\n\n/**\n * Convert an opentype.js Path to THREE.BufferGeometry.\n *\n * Path commands → THREE.Shape → ExtrudeGeometry.\n * The result is centered in X and Z (bounding box center → origin).\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 BufferGeometry, or null when the path is empty.\n */\nexport function opentypePathToGeometry(\n  path: Path,\n  depth: number,\n): THREE.BufferGeometry | null {\n  const commands = path.commands as PathCommand[]\n  if (commands.length === 0) return null\n\n  const shapes: THREE.Shape[] = []\n  let currentShape: THREE.Shape | null = null\n\n  for (const cmd of commands) {\n    switch (cmd.type) {\n      case 'M':\n        // Implicit closure: opentype.js doesn't always emit 'Z' before a new 'M'.\n        // Push the current shape before starting a new subpath.\n        if (currentShape) {\n          shapes.push(currentShape)\n        }\n        currentShape = new THREE.Shape()\n        currentShape.moveTo(cmd.x!, cmd.y!)\n        break\n      case 'L':\n        currentShape?.lineTo(cmd.x!, cmd.y!)\n        break\n      case 'C':\n        currentShape?.bezierCurveTo(cmd.x1!, cmd.y1!, cmd.x2!, cmd.y2!, cmd.x!, cmd.y!)\n        break\n      case 'Q':\n        currentShape?.quadraticCurveTo(cmd.x1!, cmd.y1!, cmd.x!, cmd.y!)\n        break\n      case 'Z':\n        if (currentShape) {\n          shapes.push(currentShape)\n          currentShape = null\n        }\n        break\n    }\n  }\n\n  // Handle final unclosed subpath (opentype.js doesn't always emit 'Z')\n  if (currentShape) {\n    shapes.push(currentShape)\n  }\n\n  if (shapes.length === 0) return null\n\n  const geo = new THREE.ExtrudeGeometry(shapes, {\n    depth,\n    bevelEnabled: false,\n    curveSegments: 6,\n  })\n  geo.computeBoundingBox()\n  if (geo.boundingBox) {\n    const cx = (geo.boundingBox.max.x + geo.boundingBox.min.x) / 2\n    const cz = (geo.boundingBox.max.z + geo.boundingBox.min.z) / 2\n    geo.translate(-cx, -geo.boundingBox.min.y, -cz)\n  }\n  return geo\n}\n"]}

package/dist/primitives/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Standard primitive types.
+ * Note: 'box' and 'cube' are synonyms — the parser uses 'box' (cad.box()),
+ * while the internal BREP code uses 'cube'. Both are valid.
+ */
+export type PrimitiveType = 'cube' | 'box' | 'sphere' | 'cylinder' | 'cone' | 'wedge';
+/** Generator type. */
+export type GeneratorType = 'screw' | 'text';
+/** Union of all primitive and generator types. */
+export type AnyPrimitiveType = PrimitiveType | GeneratorType;
+/** Standard primitive parameter unions (each shape matches its type). */
+export type PrimitiveParams = {
+    size: number;
+} | {
+    radius: number;
+    segments: number;
+} | {
+    radius: number;
+    height: number;
+    segments: number;
+};
+/** Loose primitive parameter record (for persisted storage; read the relevant fields by type). */
+export type PrimitiveParamsRecord = Record<string, number>;
+/** Primitive parameters plus a center (used for script statement args; center is [number, number, number]). */
+export type PrimitiveArgsRecord = Record<string, number | number[]>;
+/** Primitive metadata, attached to LoadedFileModel.primitiveMeta. */
+export interface PrimitiveMeta {
+    type: PrimitiveType;
+    params: PrimitiveParamsRecord;
+}
+/** Serialized geometry data (used by the store and undo). */
+export interface PrimitiveGeometryData {
+    positions: Float32Array;
+    indices: Uint32Array;
+}
+/** A Primitive record stored in the store (no THREE.Mesh reference; rebuilt by PrimitivesLayer). */
+export interface PrimitiveRecord {
+    id: string;
+    type: AnyPrimitiveType;
+    name: string;
+    color: number;
+    params: Record<string, unknown>;
+    geometryData: PrimitiveGeometryData;
+    createdAt: number;
+}
+/** Primitive colour cycle (NASSCAD-style: bright, high-saturation, easily distinguishable). */
+export declare const PRIMITIVE_COLORS: [number, number, number][];
+/**
+ * Return the next colour from the PRIMITIVE_COLORS cycle.
+ *
+ * Cycles through the palette in order, wrapping around at the end.
+ *
+ * @returns the next [r, g, b] colour in the palette.
+ */
+export declare function nextPrimitiveColor(): [number, number, number];
+//# sourceMappingURL=types.d.ts.map

package/dist/primitives/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/primitives/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAA;AAErF,sBAAsB;AACtB,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAA;AAE5C,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,aAAa,CAAA;AAE5D,yEAAyE;AACzE,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAExD,kGAAkG;AAClG,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAE1D,+GAA+G;AAC/G,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;AAEnE,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,aAAa,CAAA;IACnB,MAAM,EAAE,qBAAqB,CAAA;CAC9B;AAED,6DAA6D;AAC7D,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,YAAY,CAAA;IACvB,OAAO,EAAE,WAAW,CAAA;CACrB;AAED,oGAAoG;AACpG,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,gBAAgB,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,YAAY,EAAE,qBAAqB,CAAA;IACnC,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAStD,CAAA;AAGD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAI7D"}

package/dist/primitives/types.js

@@ -0,0 +1,25 @@
+/** Primitive colour cycle (NASSCAD-style: bright, high-saturation, easily distinguishable). */
+export const PRIMITIVE_COLORS = [
+    [0.85, 0.25, 0.20], // 红色
+    [0.20, 0.60, 0.85], // 蓝色
+    [0.20, 0.75, 0.30], // 绿色
+    [1.00, 0.70, 0.10], // 橙色
+    [0.60, 0.30, 0.80], // 紫色
+    [0.00, 0.75, 0.75], // 青色
+    [0.95, 0.50, 0.75], // 粉色
+    [0.50, 0.50, 0.50], // 灰色
+];
+let _colorIndex = 0;
+/**
+ * Return the next colour from the PRIMITIVE_COLORS cycle.
+ *
+ * Cycles through the palette in order, wrapping around at the end.
+ *
+ * @returns the next [r, g, b] colour in the palette.
+ */
+export function nextPrimitiveColor() {
+    const color = PRIMITIVE_COLORS[_colorIndex % PRIMITIVE_COLORS.length];
+    _colorIndex++;
+    return color;
+}
+//# sourceMappingURL=types.js.map

package/dist/primitives/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/primitives/types.ts"],"names":[],"mappings":"AAgDA,+FAA+F;AAC/F,MAAM,CAAC,MAAM,gBAAgB,GAA+B;IAC1D,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAI,KAAK;IAC3B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAI,KAAK;IAC3B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAI,KAAK;IAC3B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAI,KAAK;IAC3B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAI,KAAK;IAC3B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAI,KAAK;IAC3B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAI,KAAK;IAC3B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAI,KAAK;CAC5B,CAAA;AAED,IAAI,WAAW,GAAG,CAAC,CAAA;AACnB;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,gBAAgB,CAAC,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACrE,WAAW,EAAE,CAAA;IACb,OAAO,KAAK,CAAA;AACd,CAAC","sourcesContent":["/**\n * Standard primitive types.\n * Note: 'box' and 'cube' are synonyms — the parser uses 'box' (cad.box()),\n * while the internal BREP code uses 'cube'. Both are valid.\n */\nexport type PrimitiveType = 'cube' | 'box' | 'sphere' | 'cylinder' | 'cone' | 'wedge'\n\n/** Generator type. */\nexport type GeneratorType = 'screw' | 'text'\n\n/** Union of all primitive and generator types. */\nexport type AnyPrimitiveType = PrimitiveType | GeneratorType\n\n/** Standard primitive parameter unions (each shape matches its type). */\nexport type PrimitiveParams =\n  | { size: number }\n  | { radius: number; segments: number }\n  | { radius: number; height: number; segments: number }\n\n/** Loose primitive parameter record (for persisted storage; read the relevant fields by type). */\nexport type PrimitiveParamsRecord = Record<string, number>\n\n/** Primitive parameters plus a center (used for script statement args; center is [number, number, number]). */\nexport type PrimitiveArgsRecord = Record<string, number | number[]>\n\n/** Primitive metadata, attached to LoadedFileModel.primitiveMeta. */\nexport interface PrimitiveMeta {\n  type: PrimitiveType\n  params: PrimitiveParamsRecord\n}\n\n/** Serialized geometry data (used by the store and undo). */\nexport interface PrimitiveGeometryData {\n  positions: Float32Array\n  indices: Uint32Array\n}\n\n/** A Primitive record stored in the store (no THREE.Mesh reference; rebuilt by PrimitivesLayer). */\nexport interface PrimitiveRecord {\n  id: string\n  type: AnyPrimitiveType\n  name: string\n  color: number       // hex 颜色\n  params: Record<string, unknown>\n  geometryData: PrimitiveGeometryData\n  createdAt: number\n}\n\n/** Primitive colour cycle (NASSCAD-style: bright, high-saturation, easily distinguishable). */\nexport const PRIMITIVE_COLORS: [number, number, number][] = [\n  [0.85, 0.25, 0.20],   // 红色\n  [0.20, 0.60, 0.85],   // 蓝色\n  [0.20, 0.75, 0.30],   // 绿色\n  [1.00, 0.70, 0.10],   // 橙色\n  [0.60, 0.30, 0.80],   // 紫色\n  [0.00, 0.75, 0.75],   // 青色\n  [0.95, 0.50, 0.75],   // 粉色\n  [0.50, 0.50, 0.50],   // 灰色\n]\n\nlet _colorIndex = 0\n/**\n * Return the next colour from the PRIMITIVE_COLORS cycle.\n *\n * Cycles through the palette in order, wrapping around at the end.\n *\n * @returns the next [r, g, b] colour in the palette.\n */\nexport function nextPrimitiveColor(): [number, number, number] {\n  const color = PRIMITIVE_COLORS[_colorIndex % PRIMITIVE_COLORS.length]\n  _colorIndex++\n  return color\n}\n"]}