@faicad/faijs 0.14.1 → 0.16.1

package/dist/primitives/text/cjk.d.ts

@@ -1,61 +0,0 @@
-/**
- * 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 type { Font } from 'opentype.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 declare function isCjkChar(ch: string): boolean;
-/**
- * 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 declare function containsCjk(text: string): boolean;
-/** Result of loading a system CJK font. */
-export interface CjkFontResult {
-    font: opentype.Font;
-    family: string;
-}
-/**
- * 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 declare function loadSystemCjkFont(): Promise<CjkFontResult | null>;
-/**
- * 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 declare function createMixedTextGeometry(text: string, size: number, depth: number, cjkFont: Font | null, defaultFont?: Font): Promise<THREE.BufferGeometry>;
-//# sourceMappingURL=cjk.d.ts.map

package/dist/primitives/text/cjk.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cjk.d.ts","sourceRoot":"","sources":["../../../src/primitives/text/cjk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,QAAQ,MAAM,aAAa,CAAA;AACvC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAIvC;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAS7C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKjD;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAwCvE;AAsED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,IAAI,GAAG,IAAI,EACpB,WAAW,CAAC,EAAE,IAAI,GACjB,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CA4D/B"}

package/dist/primitives/text/cjk.js

@@ -1,215 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,47 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,127 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"version":3,"file":"text-geometry.js","sourceRoot":"","sources":["../../src/primitives/text-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAE,iBAAiB,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAE3F,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,sBAAsB;AAEtB;;;;;;;;;;;;GAYG;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,GAAG,GAAG,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC/C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,yDAAyD,IAAI,GAAG,CAAC,CAAA;IACnF,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,uCAAuC;AAEvC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAU,EACV,KAAa;IAEb,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAyB,CAAA;IAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEtC,MAAM,MAAM,GAAkB,EAAE,CAAA;IAChC,IAAI,YAAY,GAAuB,IAAI,CAAA;IAE3C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,GAAG;gBACN,0EAA0E;gBAC1E,wDAAwD;gBACxD,IAAI,YAAY,EAAE,CAAC;oBACjB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;gBAC3B,CAAC;gBACD,YAAY,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAA;gBAChC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAE,EAAE,GAAG,CAAC,CAAE,CAAC,CAAA;gBACnC,MAAK;YACP,KAAK,GAAG;gBACN,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,CAAE,EAAE,GAAG,CAAC,CAAE,CAAC,CAAA;gBACpC,MAAK;YACP,KAAK,GAAG;gBACN,YAAY,EAAE,aAAa,CAAC,GAAG,CAAC,EAAG,EAAE,GAAG,CAAC,EAAG,EAAE,GAAG,CAAC,EAAG,EAAE,GAAG,CAAC,EAAG,EAAE,GAAG,CAAC,CAAE,EAAE,GAAG,CAAC,CAAE,CAAC,CAAA;gBAC/E,MAAK;YACP,KAAK,GAAG;gBACN,YAAY,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAG,EAAE,GAAG,CAAC,EAAG,EAAE,GAAG,CAAC,CAAE,EAAE,GAAG,CAAC,CAAE,CAAC,CAAA;gBAChE,MAAK;YACP,KAAK,GAAG;gBACN,IAAI,YAAY,EAAE,CAAC;oBACjB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;oBACzB,YAAY,GAAG,IAAI,CAAA;gBACrB,CAAC;gBACD,MAAK;QACT,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IAC3B,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEpC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,eAAe,CAAC,MAAM,EAAE;QAC5C,KAAK;QACL,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,CAAC;KACjB,CAAC,CAAA;IACF,GAAG,CAAC,kBAAkB,EAAE,CAAA;IACxB,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QACpB,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAC9D,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAC9D,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACjD,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC","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/test-helpers.d.ts

@@ -1,31 +0,0 @@
-/**
- * test-helpers — 测试辅助函数
- *
- * 提供 executeScript 等便利函数，供测试使用。
- * 从 script-engine/replay-validator.ts 迁移（原名 replayScript，已改名对齐 roadmap §3.6）。
- *
- * Phase 2.5：executeScript 改用 CadRuntime（VM 执行），不再依赖 src/ops/dispatcher 的 executeStatement。
- * executeScript 接受代码文本，走 CadRuntime.execute（无 IR 中间层）。
- */
-import type { Shape } from './mesh/types.js';
-import type { BrepChainState } from './brep/brep-chain.js';
-import type { HostPorts, ExecutionMode } from './cad-runtime/ports.js';
-/** Result of executing a script via the test helper. */
-export interface ExecuteOutput {
-    contentKey: string;
-    shape: Shape;
-    brepChain: BrepChainState;
-}
-/**
- * Execute a script through the CadRuntime (direct path) and return the final
- * shape, its content key, and the resulting BREP chain state.
- *
- * @param code - the .fai.js source text to execute.
- * @param params - optional execution parameters.
- * @param ports - optional host ports (defaults to a no-op events sink).
- * @param mode - optional execution mode.
- * @param _brepChain - optional pre-existing BREP chain state (reserved).
- * @returns the final shape, content key, and BREP chain state.
- */
-export declare function executeScript(code: string, params?: Record<string, unknown>, ports?: HostPorts, mode?: ExecutionMode, _brepChain?: BrepChainState): Promise<ExecuteOutput>;
-//# sourceMappingURL=test-helpers.d.ts.map

package/dist/test-helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../src/test-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAIvD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAWnE,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,KAAK,CAAA;IACZ,SAAS,EAAE,cAAc,CAAA;CAC1B;AAOD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,CAAC,EAAE,SAAS,EACjB,IAAI,CAAC,EAAE,aAAa,EACpB,UAAU,CAAC,EAAE,cAAc,GAC1B,OAAO,CAAC,aAAa,CAAC,CAsBxB"}

package/dist/test-helpers.js

@@ -1,55 +0,0 @@
-/**
- * test-helpers — 测试辅助函数
- *
- * 提供 executeScript 等便利函数，供测试使用。
- * 从 script-engine/replay-validator.ts 迁移（原名 replayScript，已改名对齐 roadmap §3.6）。
- *
- * Phase 2.5：executeScript 改用 CadRuntime（VM 执行），不再依赖 src/ops/dispatcher 的 executeStatement。
- * executeScript 接受代码文本，走 CadRuntime.execute（无 IR 中间层）。
- */
-import { createRuntime } from './cad-runtime/runtime.js';
-import { computeContentKey } from './cad-runtime/runtime.js';
-// P6/D1：库函数已并入 core 的 api/ 层（原 packages/stdlib 取消）。
-// 用「变量动态 import」——tsc 不解析非字面量 specifier，vitest 经 alias 解析到 api 源码。
-const API_NAMESPACE_MODULE = '@faicad/faijs-core/api/api-namespace';
-async function getCadLib() {
-    const mod = (await import(API_NAMESPACE_MODULE));
-    return mod.createApiNamespace();
-}
-/** 最小 ports（events no-op），供未传 ports 的测试使用。 */
-function defaultPorts() {
-    return { events: { emit: () => { } } };
-}
-/**
- * Execute a script through the CadRuntime (direct path) and return the final
- * shape, its content key, and the resulting BREP chain state.
- *
- * @param code - the .fai.js source text to execute.
- * @param params - optional execution parameters.
- * @param ports - optional host ports (defaults to a no-op events sink).
- * @param mode - optional execution mode.
- * @param _brepChain - optional pre-existing BREP chain state (reserved).
- * @returns the final shape, content key, and BREP chain state.
- */
-export async function executeScript(code, params, ports, mode, _brepChain) {
-    // P5/E-a-1：测试辅助注入 cad 命名空间（core 不默认装配；test-helpers 只被测试消费）
-    const runtime = createRuntime(ports ?? defaultPorts(), mode, { cad: await getCadLib() });
-    const result = await runtime.execute(code, { params });
-    // 从 outputs 中取最后一个 shape（与原逻辑一致）
-    const shapeNames = [...result.outputs.keys()];
-    if (shapeNames.length === 0) {
-        throw new Error(`[executeScript] empty result — no geometry outputs`);
-    }
-    const finalName = shapeNames[shapeNames.length - 1];
-    const finalShape = result.outputs.get(finalName);
-    if (!('positions' in finalShape) || !('indices' in finalShape)) {
-        throw new Error(`[executeScript] final output "${finalName}" is not a mesh shape`);
-    }
-    const contentKey = computeContentKey(finalShape.positions, finalShape.indices);
-    return {
-        contentKey,
-        shape: finalShape,
-        brepChain: result.brepChain,
-    };
-}
-//# sourceMappingURL=test-helpers.js.map

package/dist/test-helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../src/test-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAIzD,oDAAoD;AACpD,mEAAmE;AACnE,MAAM,oBAAoB,GAAG,sCAAsC,CAAA;AAEnE,KAAK,UAAU,SAAS;IACtB,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAkD,CAAA;IACjG,OAAO,GAAG,CAAC,kBAAkB,EAAE,CAAA;AACjC,CAAC;AASD,8CAA8C;AAC9C,SAAS,YAAY;IACnB,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,EAAe,CAAA;AACpD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,MAAgC,EAChC,KAAiB,EACjB,IAAoB,EACpB,UAA2B;IAE3B,2DAA2D;IAC3D,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,IAAI,YAAY,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,SAAS,EAAE,EAAE,CAAC,CAAA;IACxF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IAEtD,iCAAiC;IACjC,MAAM,UAAU,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IAC7C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;IACvE,CAAC;IACD,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACnD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAE,CAAA;IACjD,IAAI,CAAC,CAAC,WAAW,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,UAAU,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,iCAAiC,SAAS,uBAAuB,CAAC,CAAA;IACpF,CAAC;IACD,MAAM,UAAU,GAAG,iBAAiB,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;IAE9E,OAAO;QACL,UAAU;QACV,KAAK,EAAE,UAAU;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAA;AACH,CAAC","sourcesContent":["/**\n * test-helpers — 测试辅助函数\n *\n * 提供 executeScript 等便利函数，供测试使用。\n * 从 script-engine/replay-validator.ts 迁移（原名 replayScript，已改名对齐 roadmap §3.6）。\n *\n * Phase 2.5：executeScript 改用 CadRuntime（VM 执行），不再依赖 src/ops/dispatcher 的 executeStatement。\n * executeScript 接受代码文本，走 CadRuntime.execute（无 IR 中间层）。\n */\n\nimport type { Shape } from './mesh/types'\nimport type { BrepChainState } from './brep/brep-chain'\nimport { createRuntime } from './cad-runtime/runtime'\nimport { computeContentKey } from './cad-runtime/runtime'\nimport type { StdlibNamespace } from './runtime-state'\nimport type { HostPorts, ExecutionMode } from './cad-runtime/ports'\n\n// P6/D1：库函数已并入 core 的 api/ 层（原 packages/stdlib 取消）。\n// 用「变量动态 import」——tsc 不解析非字面量 specifier，vitest 经 alias 解析到 api 源码。\nconst API_NAMESPACE_MODULE = '@faicad/faijs-core/api/api-namespace'\n\nasync function getCadLib(): Promise<StdlibNamespace> {\n  const mod = (await import(API_NAMESPACE_MODULE)) as { createApiNamespace: () => StdlibNamespace }\n  return mod.createApiNamespace()\n}\n\n/** Result of executing a script via the test helper. */\nexport interface ExecuteOutput {\n  contentKey: string\n  shape: Shape\n  brepChain: BrepChainState\n}\n\n/** 最小 ports（events no-op），供未传 ports 的测试使用。 */\nfunction defaultPorts(): HostPorts {\n  return { events: { emit: () => {} } } as HostPorts\n}\n\n/**\n * Execute a script through the CadRuntime (direct path) and return the final\n * shape, its content key, and the resulting BREP chain state.\n *\n * @param code - the .fai.js source text to execute.\n * @param params - optional execution parameters.\n * @param ports - optional host ports (defaults to a no-op events sink).\n * @param mode - optional execution mode.\n * @param _brepChain - optional pre-existing BREP chain state (reserved).\n * @returns the final shape, content key, and BREP chain state.\n */\nexport async function executeScript(\n  code: string,\n  params?: Record<string, unknown>,\n  ports?: HostPorts,\n  mode?: ExecutionMode,\n  _brepChain?: BrepChainState,\n): Promise<ExecuteOutput> {\n  // P5/E-a-1：测试辅助注入 cad 命名空间（core 不默认装配；test-helpers 只被测试消费）\n  const runtime = createRuntime(ports ?? defaultPorts(), mode, { cad: await getCadLib() })\n  const result = await runtime.execute(code, { params })\n\n  // 从 outputs 中取最后一个 shape（与原逻辑一致）\n  const shapeNames = [...result.outputs.keys()]\n  if (shapeNames.length === 0) {\n    throw new Error(`[executeScript] empty result — no geometry outputs`)\n  }\n  const finalName = shapeNames[shapeNames.length - 1]\n  const finalShape = result.outputs.get(finalName)!\n  if (!('positions' in finalShape) || !('indices' in finalShape)) {\n    throw new Error(`[executeScript] final output \"${finalName}\" is not a mesh shape`)\n  }\n  const contentKey = computeContentKey(finalShape.positions, finalShape.indices)\n\n  return {\n    contentKey,\n    shape: finalShape,\n    brepChain: result.brepChain,\n  }\n}\n"]}