@faicad/faijs 0.33.2 → 0.35.8

package/dist/extra/browser.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @faicad/faijs/extra/browser — browser/worker entry for the extra domain.
+ *
+ * This entry is environment-agnostic (no `node:*` modules). It re-exports the
+ * main extra entry verbatim; it exists so hosts can import the extra domain
+ * the same way they import `@faicad/faijs/browser`.
+ */
+export * from './index.js';
+//# sourceMappingURL=browser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/extra/browser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,SAAS,CAAA"}

package/dist/extra/browser.js

@@ -0,0 +1,9 @@
+/**
+ * @faicad/faijs/extra/browser — browser/worker entry for the extra domain.
+ *
+ * This entry is environment-agnostic (no `node:*` modules). It re-exports the
+ * main extra entry verbatim; it exists so hosts can import the extra domain
+ * the same way they import `@faicad/faijs/browser`.
+ */
+export * from './index.js';
+//# sourceMappingURL=browser.js.map

package/dist/extra/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/extra/browser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,SAAS,CAAA","sourcesContent":["/**\n * @faicad/faijs/extra/browser — browser/worker entry for the extra domain.\n *\n * This entry is environment-agnostic (no `node:*` modules). It re-exports the\n * main extra entry verbatim; it exists so hosts can import the extra domain\n * the same way they import `@faicad/faijs/browser`.\n */\nexport * from './index'\n"]}

package/dist/extra/editor-ops.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @faicad/faijs/extra/editor-ops — lightweight editor op closure.
+ *
+ * Carries the A group editor ops (`fai_drill` / `fai_extrude` / `fai_split`,
+ * `group` / `assembly`, `copy`, `load`) without the heavy text/SVG geometry
+ * chain (opentype.js, etc.). The cad namespace is now fully assembled inside
+ * `createApiNamespace()`, so this entry no longer exposes merge/register
+ * functions — it only re-exports the ops for bundle consumers that need the
+ * lightweight closure (e.g. the weapp worker).
+ *
+ * The cad namespace is identical on all platforms; only the implementation
+ * closure differs.
+ */
+export { EDITOR_OPS } from './op-names.js';
+export { fai_drill } from './ops/fai_drill.js';
+export { fai_extrude } 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 } from './ops/compound.js';
+export { copy } from './ops/copy.js';
+export { load } from './ops/load.js';
+//# sourceMappingURL=editor-ops.d.ts.map

package/dist/extra/editor-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-ops.d.ts","sourceRoot":"","sources":["../../src/extra/editor-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,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,MAAM,gBAAgB,CAAA;AACnF,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA"}

package/dist/extra/editor-ops.js

@@ -0,0 +1,21 @@
+/**
+ * @faicad/faijs/extra/editor-ops — lightweight editor op closure.
+ *
+ * Carries the A group editor ops (`fai_drill` / `fai_extrude` / `fai_split`,
+ * `group` / `assembly`, `copy`, `load`) without the heavy text/SVG geometry
+ * chain (opentype.js, etc.). The cad namespace is now fully assembled inside
+ * `createApiNamespace()`, so this entry no longer exposes merge/register
+ * functions — it only re-exports the ops for bundle consumers that need the
+ * lightweight closure (e.g. the weapp worker).
+ *
+ * The cad namespace is identical on all platforms; only the implementation
+ * closure differs.
+ */
+export { EDITOR_OPS } from './op-names.js';
+export { fai_drill } from './ops/fai_drill.js';
+export { fai_extrude } 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';
+//# sourceMappingURL=editor-ops.js.map

package/dist/extra/editor-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-ops.js","sourceRoot":"","sources":["../../src/extra/editor-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,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","sourcesContent":["/**\n * @faicad/faijs/extra/editor-ops — lightweight editor op closure.\n *\n * Carries the A group editor ops (`fai_drill` / `fai_extrude` / `fai_split`,\n * `group` / `assembly`, `copy`, `load`) without the heavy text/SVG geometry\n * chain (opentype.js, etc.). The cad namespace is now fully assembled inside\n * `createApiNamespace()`, so this entry no longer exposes merge/register\n * functions — it only re-exports the ops for bundle consumers that need the\n * lightweight closure (e.g. the weapp worker).\n *\n * The cad namespace is identical on all platforms; only the implementation\n * closure differs.\n */\nexport { EDITOR_OPS } from './op-names'\nexport { fai_drill } from './ops/fai_drill'\nexport { fai_extrude } from './ops/fai_extrude'\nexport { fai_split } from './ops/fai_split'\nexport { group, assembly } from './ops/compound'\nexport type { GroupParams, AssemblyParams, AssemblyBehavior } from './ops/compound'\nexport { copy } from './ops/copy'\nexport { load } from './ops/load'\n"]}

package/dist/extra/extras/svg-extrude.d.ts

@@ -0,0 +1,45 @@
+import type { Contour } from '../../mesh/meshdata/extrude.js';
+import type { Shape } from '../../mesh/types.js';
+/**
+ * Options controlling an SVG extrusion.
+ *
+ * targetLongSide maps the longer logical side of the SVG to this length in
+ * mm (the short side is scaled proportionally); naturalWidth/naturalHeight
+ * are the SVG's logical dimensions used to compute the scale factor.
+ */
+export interface SvgExtrudeOptions {
+    depth: number;
+    /** 长边目标长度（mm），短边按比例计算。默认 20 */
+    targetLongSide?: number;
+    /** SVG 原始逻辑尺寸，用于计算实际缩放比例 */
+    naturalWidth: number;
+    naturalHeight: number;
+}
+/**
+ * Parse SVG text into a list of closed Y-up contours.
+ * Uses the shared SVG syntax layer (element extraction + path flattening +
+ * group matrix + evenodd hole classification).
+ *
+ * @param svgText - the SVG source text.
+ * @returns the list of closed contours found in the SVG.
+ * @throws when the SVG contains no closed contour.
+ */
+export declare function parseSvgShapes(svgText: string): Contour[];
+/**
+ * Extrude a list of contours into a single Shape.
+ * The scale factor is computed from naturalWidth/naturalHeight and targetLongSide.
+ *
+ * @param shapes - the contours to extrude.
+ * @param options - the extrusion options (depth and scale inputs).
+ * @returns the merged, scaled, centred Shape.
+ */
+export declare function extrudeShapes(shapes: Contour[], options: SvgExtrudeOptions): Shape;
+/**
+ * One-stop helper: SVG text → extruded Shape.
+ *
+ * @param svgText - the SVG source text.
+ * @param options - the extrusion options.
+ * @returns the extruded Shape.
+ */
+export declare function svgToExtrudedGeometry(svgText: string, options: SvgExtrudeOptions): Shape;
+//# sourceMappingURL=svg-extrude.d.ts.map

package/dist/extra/extras/svg-extrude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-extrude.d.ts","sourceRoot":"","sources":["../../../src/extra/extras/svg-extrude.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAE7C;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAezD;AA2BD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,EAAE,iBAAiB,GACzB,KAAK,CAmBP;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,GACzB,KAAK,CAGP"}

package/dist/extra/extras/svg-extrude.js

@@ -0,0 +1,110 @@
+/**
+ * svg-extrude — SVG → 拉伸几何（editor extension library，three-free）。
+ *
+ * 几何链：SVG 文本 → Contour[]（共享 SVG 语法层折线化 + group matrix +
+ * Y 翻转 + evenodd 分类，`@faicad/faijs/primitives/svg/svg-path`）→
+ * `extrudeShape`（core 自有）→ 缩放 → 居中。返回 core `Shape`。
+ *
+ * 与旧 three `SVGLoader` 实现的登记差异：
+ * - fill-rule：统一按 evenodd 分类孔洞（SVGLoader 支持 per-path fill-rule，
+ *   本项目素材均为 potrace/Inkscape 导出，evenodd 语义足够，见方案 R6）；
+ * - transform：支持 `<g transform="matrix(...)">` 与 rect 内联 transform
+ *   （SVGLoader 亦支持；本项目共享层覆盖相同面）；
+ * - 曲线：Bezier/Arc 按 `curveSegments` 采样折线化（SVGLoader 用精确曲线，
+ *   预览级网格两者等价，几何级差异登记于方案 R2）。
+ */
+import { svgPathToContours } from '../../primitives/svg/svg-path.js';
+import { extrudeShape } from '../../mesh/meshdata/extrude.js';
+/**
+ * Parse SVG text into a list of closed Y-up contours.
+ * Uses the shared SVG syntax layer (element extraction + path flattening +
+ * group matrix + evenodd hole classification).
+ *
+ * @param svgText - the SVG source text.
+ * @returns the list of closed contours found in the SVG.
+ * @throws when the SVG contains no closed contour.
+ */
+export function parseSvgShapes(svgText) {
+    let contours;
+    try {
+        contours = svgPathToContours(svgText, 6);
+    }
+    catch {
+        // svgPathToContours 在「无 path 元素」与「无闭合轮廓」两种情形会各自抛更底层的
+        // 错误（"[svg-path] No path elements found" / "[svg-path] No closed contours
+        // generated"）。这里统一成编辑器面向用户的同一句，避免上层按消息文本做分档时
+        // 撞上两种措辞（3d_editor 的 svg-extrude.test.ts 也按这一句断言）。
+        throw new Error('No closed contour found in SVG. Please check the file content.');
+    }
+    if (contours.length === 0) {
+        throw new Error('No closed contour found in SVG. Please check the file content.');
+    }
+    return contours;
+}
+/** X/Y 居中、Z 底部对齐到 0（3D 打印放在热床上）。 */
+function centerShapeXYBottom(shape) {
+    let minX = Infinity, maxX = -Infinity, minY = Infinity, maxY = -Infinity, minZ = 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 (y > maxY)
+            maxY = y;
+        if (z < minZ)
+            minZ = z;
+    }
+    const dx = -(minX + maxX) / 2;
+    const dy = -(minY + maxY) / 2;
+    const dz = -minZ;
+    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 };
+}
+/**
+ * Extrude a list of contours into a single Shape.
+ * The scale factor is computed from naturalWidth/naturalHeight and targetLongSide.
+ *
+ * @param shapes - the contours to extrude.
+ * @param options - the extrusion options (depth and scale inputs).
+ * @returns the merged, scaled, centred Shape.
+ */
+export function extrudeShapes(shapes, options) {
+    const { depth, naturalWidth, naturalHeight, targetLongSide = 20 } = options;
+    // 计算缩放比例：长边映射到 targetLongSide
+    const longSide = Math.max(naturalWidth, naturalHeight);
+    const scale = longSide > 0 ? targetLongSide / longSide : 1;
+    // 先挤出，再整体缩放几何体（XY 缩放，Z 不变）
+    const shape = extrudeShape(shapes, depth);
+    if (scale !== 1) {
+        const positions = new Float32Array(shape.positions.length);
+        for (let i = 0; i < shape.positions.length; i += 3) {
+            positions[i] = shape.positions[i] * scale;
+            positions[i + 1] = shape.positions[i + 1] * scale;
+            positions[i + 2] = shape.positions[i + 2];
+        }
+        return centerShapeXYBottom({ ...shape, positions });
+    }
+    return centerShapeXYBottom(shape);
+}
+/**
+ * One-stop helper: SVG text → extruded Shape.
+ *
+ * @param svgText - the SVG source text.
+ * @param options - the extrusion options.
+ * @returns the extruded Shape.
+ */
+export function svgToExtrudedGeometry(svgText, options) {
+    const shapes = parseSvgShapes(svgText);
+    return extrudeShapes(shapes, options);
+}
+//# sourceMappingURL=svg-extrude.js.map

package/dist/extra/extras/svg-extrude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-extrude.js","sourceRoot":"","sources":["../../../src/extra/extras/svg-extrude.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * svg-extrude — SVG → 拉伸几何（editor extension library，three-free）。\n *\n * 几何链：SVG 文本 → Contour[]（共享 SVG 语法层折线化 + group matrix +\n * Y 翻转 + evenodd 分类，`@faicad/faijs/primitives/svg/svg-path`）→\n * `extrudeShape`（core 自有）→ 缩放 → 居中。返回 core `Shape`。\n *\n * 与旧 three `SVGLoader` 实现的登记差异：\n * - fill-rule：统一按 evenodd 分类孔洞（SVGLoader 支持 per-path fill-rule，\n *   本项目素材均为 potrace/Inkscape 导出，evenodd 语义足够，见方案 R6）；\n * - transform：支持 `<g transform=\"matrix(...)\">` 与 rect 内联 transform\n *   （SVGLoader 亦支持；本项目共享层覆盖相同面）；\n * - 曲线：Bezier/Arc 按 `curveSegments` 采样折线化（SVGLoader 用精确曲线，\n *   预览级网格两者等价，几何级差异登记于方案 R2）。\n */\nimport { svgPathToContours } from '../../primitives/svg/svg-path'\nimport { extrudeShape } from '../../mesh/meshdata/extrude'\nimport type { Contour } from '../../mesh/meshdata/extrude'\nimport type { Shape } from '../../mesh/types'\n\n/**\n * Options controlling an SVG extrusion.\n *\n * targetLongSide maps the longer logical side of the SVG to this length in\n * mm (the short side is scaled proportionally); naturalWidth/naturalHeight\n * are the SVG's logical dimensions used to compute the scale factor.\n */\nexport interface SvgExtrudeOptions {\n  depth: number\n  /** 长边目标长度（mm），短边按比例计算。默认 20 */\n  targetLongSide?: number\n  /** SVG 原始逻辑尺寸，用于计算实际缩放比例 */\n  naturalWidth: number\n  naturalHeight: number\n}\n\n/**\n * Parse SVG text into a list of closed Y-up contours.\n * Uses the shared SVG syntax layer (element extraction + path flattening +\n * group matrix + evenodd hole classification).\n *\n * @param svgText - the SVG source text.\n * @returns the list of closed contours found in the SVG.\n * @throws when the SVG contains no closed contour.\n */\nexport function parseSvgShapes(svgText: string): Contour[] {\n  let contours: Contour[]\n  try {\n    contours = svgPathToContours(svgText, 6)\n  } catch {\n    // svgPathToContours 在「无 path 元素」与「无闭合轮廓」两种情形会各自抛更底层的\n    // 错误（\"[svg-path] No path elements found\" / \"[svg-path] No closed contours\n    // generated\"）。这里统一成编辑器面向用户的同一句，避免上层按消息文本做分档时\n    // 撞上两种措辞（3d_editor 的 svg-extrude.test.ts 也按这一句断言）。\n    throw new Error('No closed contour found in SVG. Please check the file content.')\n  }\n  if (contours.length === 0) {\n    throw new Error('No closed contour found in SVG. Please check the file content.')\n  }\n  return contours\n}\n\n/** X/Y 居中、Z 底部对齐到 0（3D 打印放在热床上）。 */\nfunction centerShapeXYBottom(shape: Shape): Shape {\n  let minX = Infinity, maxX = -Infinity, minY = Infinity, maxY = -Infinity, minZ = 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 (y > maxY) maxY = y\n    if (z < minZ) minZ = z\n  }\n  const dx = -(minX + maxX) / 2\n  const dy = -(minY + maxY) / 2\n  const dz = -minZ\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/**\n * Extrude a list of contours into a single Shape.\n * The scale factor is computed from naturalWidth/naturalHeight and targetLongSide.\n *\n * @param shapes - the contours to extrude.\n * @param options - the extrusion options (depth and scale inputs).\n * @returns the merged, scaled, centred Shape.\n */\nexport function extrudeShapes(\n  shapes: Contour[],\n  options: SvgExtrudeOptions,\n): Shape {\n  const { depth, naturalWidth, naturalHeight, targetLongSide = 20 } = options\n\n  // 计算缩放比例：长边映射到 targetLongSide\n  const longSide = Math.max(naturalWidth, naturalHeight)\n  const scale = longSide > 0 ? targetLongSide / longSide : 1\n\n  // 先挤出，再整体缩放几何体（XY 缩放，Z 不变）\n  const shape = extrudeShape(shapes, depth)\n  if (scale !== 1) {\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] * scale\n      positions[i + 1] = shape.positions[i + 1] * scale\n      positions[i + 2] = shape.positions[i + 2]\n    }\n    return centerShapeXYBottom({ ...shape, positions })\n  }\n  return centerShapeXYBottom(shape)\n}\n\n/**\n * One-stop helper: SVG text → extruded Shape.\n *\n * @param svgText - the SVG source text.\n * @param options - the extrusion options.\n * @returns the extruded Shape.\n */\nexport function svgToExtrudedGeometry(\n  svgText: string,\n  options: SvgExtrudeOptions,\n): Shape {\n  const shapes = parseSvgShapes(svgText)\n  return extrudeShapes(shapes, options)\n}\n"]}

package/dist/extra/extras/text-cjk.d.ts

@@ -0,0 +1,36 @@
+/**
+ * text-cjk — mixed CJK + Latin text geometry (editor extension library).
+ *
+ * Uses the Local Font Access API (window.queryLocalFonts) to load system CJK
+ * fonts, then parses glyph paths with opentype.js to create Contour[] →
+ * extrudeShape (core, three-free).
+ *
+ * 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.
+ *
+ * The character classification / system-font loading half lives in core
+ * (`@faicad/faijs/primitives/text/cjk-font`) and is deliberately three-free.
+ */
+import type { Font } from 'opentype.js';
+import type { Shape } from '../../mesh/types.js';
+/**
+ * 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 shape for the whole text.
+ */
+export declare function createMixedTextGeometry(text: string, size: number, depth: number, cjkFont: Font | null, defaultFont?: Font): Promise<Shape>;
+//# sourceMappingURL=text-cjk.d.ts.map

package/dist/extra/extras/text-cjk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-cjk.d.ts","sourceRoot":"","sources":["../../../src/extra/extras/text-cjk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAGvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AA0B7C;;;;;;;;;;;;;;;;;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,CAiDhB"}

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

@@ -0,0 +1,86 @@
+import { extrudeShape } from '../../mesh/meshdata/extrude.js';
+import { mergeShapes } from '../../mesh/meshdata/ops.js';
+import { getOpentypeFont, opentypePathToContours, centerShapeXZBottom } from './text-geometry.js';
+/**
+ * Generate geometry for a single character using opentype.js.
+ * Uses the same shape/extrude chain as opentypePathToGeometry().
+ */
+function charShape(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;
+    const contours = opentypePathToContours(path, 6);
+    if (contours.length === 0)
+        return null;
+    // 不居中：逐字符的 xOffset 布局在此处处理
+    return extrudeShape(contours, depth);
+}
+/**
+ * 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 shape 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 charShapes = [];
+    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 shape = charShape(char, size, depth, font, cursorX);
+        if (shape) {
+            let minX = Infinity, maxX = -Infinity;
+            for (let i = 0; i < shape.positions.length; i += 3) {
+                const x = shape.positions[i];
+                if (x < minX)
+                    minX = x;
+                if (x > maxX)
+                    maxX = x;
+            }
+            const charWidth = maxX - minX;
+            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;
+            charShapes.push({ shape, advance: effectiveAdv });
+            cursorX += effectiveAdv;
+        }
+    }
+    // Merge all character geometries into one
+    if (charShapes.length === 0) {
+        // Fallback: create a minimal geometry from a question mark
+        const shape = charShape('?', size, depth, font, 0);
+        if (shape)
+            return centerShapeXZBottom(shape);
+        return { positions: new Float32Array(0), indices: new Uint32Array(0) };
+    }
+    const merged = mergeShapes(charShapes.map((cs) => cs.shape));
+    return centerShapeXZBottom(merged);
+}
+//# sourceMappingURL=text-cjk.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text-cjk.js","sourceRoot":"","sources":["../../../src/extra/extras/text-cjk.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * text-cjk — mixed CJK + Latin text geometry (editor extension library).\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 Contour[] →\n * extrudeShape (core, three-free).\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 *\n * The character classification / system-font loading half lives in core\n * (`@faicad/faijs/primitives/text/cjk-font`) and is deliberately three-free.\n */\nimport type { Font } from 'opentype.js'\nimport { extrudeShape } from '../../mesh/meshdata/extrude'\nimport { mergeShapes } from '../../mesh/meshdata/ops'\nimport type { Shape } from '../../mesh/types'\nimport { getOpentypeFont, opentypePathToContours, centerShapeXZBottom } from './text-geometry'\n\n/**\n * Generate geometry for a single character using opentype.js.\n * Uses the same shape/extrude chain as opentypePathToGeometry().\n */\nfunction charShape(\n  char: string,\n  size: number,\n  depth: number,\n  font: Font,\n  xOffset: number,\n): Shape | 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  const contours = opentypePathToContours(path, 6)\n  if (contours.length === 0) return null\n  // 不居中：逐字符的 xOffset 布局在此处处理\n  return extrudeShape(contours, depth)\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 shape 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<Shape> {\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 charShapes: { shape: Shape; 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 shape = charShape(char, size, depth, font, cursorX)\n    if (shape) {\n      let minX = Infinity, maxX = -Infinity\n      for (let i = 0; i < shape.positions.length; i += 3) {\n        const x = shape.positions[i]\n        if (x < minX) minX = x\n        if (x > maxX) maxX = x\n      }\n      const charWidth = maxX - minX\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      charShapes.push({ shape, advance: effectiveAdv })\n      cursorX += effectiveAdv\n    }\n  }\n\n  // Merge all character geometries into one\n  if (charShapes.length === 0) {\n    // Fallback: create a minimal geometry from a question mark\n    const shape = charShape('?', size, depth, font, 0)\n    if (shape) return centerShapeXZBottom(shape)\n    return { positions: new Float32Array(0), indices: new Uint32Array(0) }\n  }\n\n  const merged = mergeShapes(charShapes.map((cs) => cs.shape))\n  return centerShapeXZBottom(merged)\n}\n"]}

package/dist/extra/extras/text-geometry.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 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 type { Font, Path } from 'opentype.js';
+import type { Contour } from '../../mesh/meshdata/extrude.js';
+import type { Shape } from '../../mesh/types.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>;
+/**
+ * 将 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 declare function opentypePathToContours(path: Path, curveSegments?: number): Contour[];
+/**
+ * X 居中、Y 底部对齐到 0、Z 居中（text 链的旧布局语义）。
+ * @param shape - 待居中的 Shape（positions 就地复制，不修改输入）。
+ * @returns 平移后的新 Shape（索引/法线不变）。
+ */
+export declare function centerShapeXZBottom(shape: Shape): Shape;
+/**
+ * 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 declare function createTextGeometry(text: string, size: number, depth: number, font: Font): Promise<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 declare function opentypePathToGeometry(path: Path, depth: number): Shape | null;
+//# sourceMappingURL=text-geometry.d.ts.map

package/dist/extra/extras/text-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-geometry.d.ts","sourceRoot":"","sources":["../../../src/extra/extras/text-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAe,MAAM,aAAa,CAAA;AAS1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAK7C;;;;;;;GAOG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAUrD;AA0CD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,SAAI,GAAG,OAAO,EAAE,CAoB/E;AAID;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAuBvD;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,KAAK,CAAC,CAmBhB;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,GACZ,KAAK,GAAG,IAAI,CAId"}