@faicad/faijs-extra 0.16.0

package/LICENSE

@@ -0,0 +1,29 @@
+MIT License
+
+Copyright (c) 2026 Faicad contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Third-party components bundled in this distribution retain their own licenses:
+
+- `src/vendored/brepjs` (compiled into `dist/vendored/**`): ported from the
+  brepjs project, licensed under the Apache License 2.0. See NOTICE for the
+  full attribution. Apache-2.0 text: https://www.apache.org/licenses/LICENSE-2.0

package/NOTICE

@@ -0,0 +1,29 @@
+faijs — @faicad/faijs NOTICE
+============================
+
+This product includes code ported from the `brepjs` project
+(https://github.com/OpenCascade/brepjs), licensed under the Apache
+License 2.0. Ported as of brepjs commit 8685273a (locked upstream
+reference; no two-way sync). The ported files retain their original
+Apache-2.0 attribution; see the vendored NOTICE in the source
+repository (packages/core/src/vendored/brepjs/NOTICE).
+
+Full Apache-2.0 text: https://www.apache.org/licenses/LICENSE-2.0
+
+Runtime dependencies (not distributed inside this package)
+----------------------------------------------------------
+
+The following optional/peer dependencies are loaded by the host at
+runtime and are NOT distributed inside this tarball. They carry their
+own licenses:
+
+- `occt-wasm` — JS glue: MIT OR Apache-2.0; the compiled WASM output is
+  LGPL-2.1-only (inherited from OCCT, https://dev.opencascade.org).
+  The LGPL replacement obligation is satisfied because the host loads
+  the `.wasm` from a URL that can be overridden
+  (`OcctKernel.init({ wasm: '...' })`).
+- `manifold-3d` — Apache-2.0.
+
+`@salusoft89/planegcs` (LGPL-2.0-or-later) is used only by the
+non-shipped `src/fcstd` module and is intentionally not a dependency of
+the published package.

package/dist/browser.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @faicad/faijs-extra/browser — browser/worker entry.
+ *
+ * The extension library is environment-agnostic: its dependency graph is three
+ * (+ `three/examples` addons) and opentype.js, with no `node:*` module and no
+ * wasm loader. This entry therefore re-exports the main entry verbatim; it
+ * exists so hosts can import the extension library the same way they import
+ * core's `@faicad/faijs/browser`, and so the entry-boundary guard has an
+ * explicit symbol to pin.
+ */
+export * from './index.js';
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

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

package/dist/browser.js

@@ -0,0 +1,12 @@
+/**
+ * @faicad/faijs-extra/browser — browser/worker entry.
+ *
+ * The extension library is environment-agnostic: its dependency graph is three
+ * (+ `three/examples` addons) and opentype.js, with no `node:*` module and no
+ * wasm loader. This entry therefore re-exports the main entry verbatim; it
+ * exists so hosts can import the extension library the same way they import
+ * core's `@faicad/faijs/browser`, and so the entry-boundary guard has an
+ * explicit symbol to pin.
+ */
+export * from './index.js';
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,cAAc,SAAS,CAAA","sourcesContent":["/**\n * @faicad/faijs-extra/browser — browser/worker entry.\n *\n * The extension library is environment-agnostic: its dependency graph is three\n * (+ `three/examples` addons) and opentype.js, with no `node:*` module and no\n * wasm loader. This entry therefore re-exports the main entry verbatim; it\n * exists so hosts can import the extension library the same way they import\n * core's `@faicad/faijs/browser`, and so the entry-boundary guard has an\n * explicit symbol to pin.\n */\nexport * from './index'\n"]}

package/dist/editor-ops.d.ts

@@ -0,0 +1,50 @@
+/**
+ * editor-ops — the editor op subgroup entry (`@faicad/faijs-extra/editor-ops`).
+ *
+ * Carries the plan §4.2 A group: `fai_drill` / `fai_extrude` / `fai_split`,
+ * `group` / `assembly`, `copy`, `load`. Unlike the full entry this module never
+ * reaches three's non-basic chain (`three/examples`' `SVGLoader`,
+ * `Shape`/`ExtrudeGeometry`) nor opentype.js — its dependency graph is three's
+ * math/container/basic-generator API only.
+ *
+ * That property is what lets the weapp worker mount these ops: the end side
+ * needs `cad.group` / `cad.copy` / `cad.load` to replay web-authored project
+ * scripts, but must not bundle the svg/3D-text chain (plan §3.1 G3). The guard
+ * `entry-boundary.test.ts` pins it.
+ */
+import { type StdlibNamespace } from '@faicad/faijs/runtime-state';
+/**
+ * Assemble the editor-owned ops into a `cad`-shaped namespace.
+ *
+ * @returns the editor op namespace, ready to be spread over the platform surface.
+ */
+export declare function createEditorOpsNamespace(): StdlibNamespace;
+/**
+ * Merge the editor op namespace over a platform namespace (pure).
+ * @param platform - the platform namespace (`createApiNamespace()`).
+ * @returns the merged namespace to register as the host's `cad` library.
+ */
+export declare function mergeEditorOpsNamespace(platform: StdlibNamespace): StdlibNamespace;
+/**
+ * The `cad` namespace a three-basic-only host registers: core's platform
+ * surface plus the editor-owned ops (no svg/3D-text creators).
+ *
+ * This is the entry the weapp worker uses — it must not bundle
+ * `three/examples`' `SVGLoader` nor the `Shape`/`ExtrudeGeometry` chain.
+ *
+ * @returns the namespace to hand to `registerLib('cad', …)`.
+ */
+export declare function createEditorOwnedCadNamespace(): StdlibNamespace;
+/** Register the A-group op names in the core symbol table (P5). */
+export declare function registerEditorOpsSymbols(): void;
+/** Undo `registerEditorOpsSymbols()`. */
+export declare function unregisterEditorOpsSymbols(): void;
+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/editor-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-ops.d.ts","sourceRoot":"","sources":["../src/editor-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAWpF;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,eAAe,CAW1D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,CAElF;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,IAAI,eAAe,CAE/D;AAED,mEAAmE;AACnE,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,yCAAyC;AACzC,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,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/editor-ops.js

@@ -0,0 +1,77 @@
+/**
+ * editor-ops — the editor op subgroup entry (`@faicad/faijs-extra/editor-ops`).
+ *
+ * Carries the plan §4.2 A group: `fai_drill` / `fai_extrude` / `fai_split`,
+ * `group` / `assembly`, `copy`, `load`. Unlike the full entry this module never
+ * reaches three's non-basic chain (`three/examples`' `SVGLoader`,
+ * `Shape`/`ExtrudeGeometry`) nor opentype.js — its dependency graph is three's
+ * math/container/basic-generator API only.
+ *
+ * That property is what lets the weapp worker mount these ops: the end side
+ * needs `cad.group` / `cad.copy` / `cad.load` to replay web-authored project
+ * scripts, but must not bundle the svg/3D-text chain (plan §3.1 G3). The guard
+ * `entry-boundary.test.ts` pins it.
+ */
+import { CONTRACT_VERSION } from '@faicad/faijs/runtime-state';
+import { registerSymbolTableEntries, unregisterSymbolTableEntries } from '@faicad/faijs/symbol-table';
+import { createApiNamespace } from '@faicad/faijs/api/api-namespace';
+import { EDITOR_OPS } from './op-names.js';
+import { fai_drill } from './ops/fai_drill.js';
+import { fai_extrude } from './ops/fai_extrude.js';
+import { fai_split } from './ops/fai_split.js';
+import { group, assembly } from './ops/compound.js';
+import { copy } from './ops/copy.js';
+import { load } from './ops/load.js';
+/**
+ * Assemble the editor-owned ops into a `cad`-shaped namespace.
+ *
+ * @returns the editor op namespace, ready to be spread over the platform surface.
+ */
+export function createEditorOpsNamespace() {
+    return {
+        contractVersion: CONTRACT_VERSION,
+        fai_drill,
+        fai_extrude,
+        fai_split,
+        group,
+        assembly,
+        copy,
+        load,
+    };
+}
+/**
+ * Merge the editor op namespace over a platform namespace (pure).
+ * @param platform - the platform namespace (`createApiNamespace()`).
+ * @returns the merged namespace to register as the host's `cad` library.
+ */
+export function mergeEditorOpsNamespace(platform) {
+    return { ...platform, ...createEditorOpsNamespace() };
+}
+/**
+ * The `cad` namespace a three-basic-only host registers: core's platform
+ * surface plus the editor-owned ops (no svg/3D-text creators).
+ *
+ * This is the entry the weapp worker uses — it must not bundle
+ * `three/examples`' `SVGLoader` nor the `Shape`/`ExtrudeGeometry` chain.
+ *
+ * @returns the namespace to hand to `registerLib('cad', …)`.
+ */
+export function createEditorOwnedCadNamespace() {
+    return mergeEditorOpsNamespace(createApiNamespace());
+}
+/** Register the A-group op names in the core symbol table (P5). */
+export function registerEditorOpsSymbols() {
+    registerSymbolTableEntries(EDITOR_OPS);
+}
+/** Undo `registerEditorOpsSymbols()`. */
+export function unregisterEditorOpsSymbols() {
+    unregisterSymbolTableEntries(EDITOR_OPS);
+}
+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/editor-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-ops.js","sourceRoot":"","sources":["../src/editor-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,gBAAgB,EAAwB,MAAM,6BAA6B,CAAA;AACpF,OAAO,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAA;AACrG,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE,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,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEjC;;;;GAIG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,eAAe,EAAE,gBAAgB;QACjC,SAAS;QACT,WAAW;QACX,SAAS;QACT,KAAK;QACL,QAAQ;QACR,IAAI;QACJ,IAAI;KACyB,CAAA;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAyB;IAC/D,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,wBAAwB,EAAE,EAAE,CAAA;AACvD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,6BAA6B;IAC3C,OAAO,uBAAuB,CAAC,kBAAkB,EAAE,CAAC,CAAA;AACtD,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,wBAAwB;IACtC,0BAA0B,CAAC,UAAU,CAAC,CAAA;AACxC,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,0BAA0B;IACxC,4BAA4B,CAAC,UAAU,CAAC,CAAA;AAC1C,CAAC;AAED,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 * editor-ops — the editor op subgroup entry (`@faicad/faijs-extra/editor-ops`).\n *\n * Carries the plan §4.2 A group: `fai_drill` / `fai_extrude` / `fai_split`,\n * `group` / `assembly`, `copy`, `load`. Unlike the full entry this module never\n * reaches three's non-basic chain (`three/examples`' `SVGLoader`,\n * `Shape`/`ExtrudeGeometry`) nor opentype.js — its dependency graph is three's\n * math/container/basic-generator API only.\n *\n * That property is what lets the weapp worker mount these ops: the end side\n * needs `cad.group` / `cad.copy` / `cad.load` to replay web-authored project\n * scripts, but must not bundle the svg/3D-text chain (plan §3.1 G3). The guard\n * `entry-boundary.test.ts` pins it.\n */\nimport { CONTRACT_VERSION, type StdlibNamespace } from '@faicad/faijs/runtime-state'\nimport { registerSymbolTableEntries, unregisterSymbolTableEntries } from '@faicad/faijs/symbol-table'\nimport { createApiNamespace } from '@faicad/faijs/api/api-namespace'\nimport { EDITOR_OPS } from './op-names'\nimport { fai_drill } from './ops/fai_drill'\nimport { fai_extrude } from './ops/fai_extrude'\nimport { fai_split } from './ops/fai_split'\nimport { group, assembly } from './ops/compound'\nimport { copy } from './ops/copy'\nimport { load } from './ops/load'\n\n/**\n * Assemble the editor-owned ops into a `cad`-shaped namespace.\n *\n * @returns the editor op namespace, ready to be spread over the platform surface.\n */\nexport function createEditorOpsNamespace(): StdlibNamespace {\n  return {\n    contractVersion: CONTRACT_VERSION,\n    fai_drill,\n    fai_extrude,\n    fai_split,\n    group,\n    assembly,\n    copy,\n    load,\n  } as unknown as StdlibNamespace\n}\n\n/**\n * Merge the editor op namespace over a platform namespace (pure).\n * @param platform - the platform namespace (`createApiNamespace()`).\n * @returns the merged namespace to register as the host's `cad` library.\n */\nexport function mergeEditorOpsNamespace(platform: StdlibNamespace): StdlibNamespace {\n  return { ...platform, ...createEditorOpsNamespace() }\n}\n\n/**\n * The `cad` namespace a three-basic-only host registers: core's platform\n * surface plus the editor-owned ops (no svg/3D-text creators).\n *\n * This is the entry the weapp worker uses — it must not bundle\n * `three/examples`' `SVGLoader` nor the `Shape`/`ExtrudeGeometry` chain.\n *\n * @returns the namespace to hand to `registerLib('cad', …)`.\n */\nexport function createEditorOwnedCadNamespace(): StdlibNamespace {\n  return mergeEditorOpsNamespace(createApiNamespace())\n}\n\n/** Register the A-group op names in the core symbol table (P5). */\nexport function registerEditorOpsSymbols(): void {\n  registerSymbolTableEntries(EDITOR_OPS)\n}\n\n/** Undo `registerEditorOpsSymbols()`. */\nexport function unregisterEditorOpsSymbols(): void {\n  unregisterSymbolTableEntries(EDITOR_OPS)\n}\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/extras/svg-extrude.d.ts

@@ -0,0 +1,43 @@
+import * as THREE from 'three';
+/**
+ * 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 THREE.Shape contours.
+ * Uses SVGLoader to convert the SVG paths into shapes usable by ExtrudeGeometry.
+ *
+ * @param svgText - the SVG source text.
+ * @returns the list of closed shapes found in the SVG.
+ * @throws when the SVG contains no closed contour.
+ */
+export declare function parseSvgShapes(svgText: string): THREE.Shape[];
+/**
+ * Extrude a list of shapes into a single merged BufferGeometry.
+ * The scale factor is computed from naturalWidth/naturalHeight and targetLongSide.
+ *
+ * @param shapes - the shapes to extrude.
+ * @param options - the extrusion options (depth and scale inputs).
+ * @returns the merged, scaled, centred BufferGeometry.
+ */
+export declare function extrudeShapes(shapes: THREE.Shape[], options: SvgExtrudeOptions): THREE.BufferGeometry;
+/**
+ * One-stop helper: SVG text → extruded BufferGeometry.
+ *
+ * @param svgText - the SVG source text.
+ * @param options - the extrusion options.
+ * @returns the extruded BufferGeometry.
+ */
+export declare function svgToExtrudedGeometry(svgText: string, options: SvgExtrudeOptions): THREE.BufferGeometry;
+//# sourceMappingURL=svg-extrude.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"svg-extrude.d.ts","sourceRoot":"","sources":["../../src/extras/svg-extrude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B;;;;;;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;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAiB7D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,EACrB,OAAO,EAAE,iBAAiB,GACzB,KAAK,CAAC,cAAc,CAqCtB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,GACzB,KAAK,CAAC,cAAc,CAGtB"}

package/dist/extras/svg-extrude.js

@@ -0,0 +1,78 @@
+import * as THREE from 'three';
+import { SVGLoader } from 'three/examples/jsm/loaders/SVGLoader.js';
+import { mergeBufferGeometries } from '@faicad/faijs/primitives/mesh-primitives';
+/**
+ * Parse SVG text into a list of THREE.Shape contours.
+ * Uses SVGLoader to convert the SVG paths into shapes usable by ExtrudeGeometry.
+ *
+ * @param svgText - the SVG source text.
+ * @returns the list of closed shapes found in the SVG.
+ * @throws when the SVG contains no closed contour.
+ */
+export function parseSvgShapes(svgText) {
+    const loader = new SVGLoader();
+    const svgData = loader.parse(svgText);
+    const allShapes = [];
+    for (const path of svgData.paths) {
+        const shapes = SVGLoader.createShapes(path);
+        for (const shape of shapes) {
+            allShapes.push(shape);
+        }
+    }
+    if (allShapes.length === 0) {
+        throw new Error('No closed contour found in SVG. Please check the file content.');
+    }
+    return allShapes;
+}
+/**
+ * Extrude a list of shapes into a single merged BufferGeometry.
+ * The scale factor is computed from naturalWidth/naturalHeight and targetLongSide.
+ *
+ * @param shapes - the shapes to extrude.
+ * @param options - the extrusion options (depth and scale inputs).
+ * @returns the merged, scaled, centred BufferGeometry.
+ */
+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;
+    // 先挤出，再整体缩放几何体
+    const geometries = shapes.map((shape) => {
+        const geo = new THREE.ExtrudeGeometry(shape, {
+            depth,
+            bevelEnabled: false,
+        });
+        // 应用缩放
+        geo.scale(scale, scale, 1);
+        return geo;
+    });
+    // 合并所有几何体为一个
+    const merged = mergeBufferGeometries(geometries);
+    merged.computeVertexNormals();
+    // 居中处理：XY 居中，Z 底部对齐到 0（3D 打印放在热床上）
+    merged.computeBoundingBox();
+    if (merged.boundingBox) {
+        const cx = (merged.boundingBox.max.x + merged.boundingBox.min.x) / 2;
+        const cy = (merged.boundingBox.max.y + merged.boundingBox.min.y) / 2;
+        const cz = merged.boundingBox.min.z;
+        merged.translate(-cx, -cy, -cz);
+    }
+    // 清理临时 geometry
+    for (const g of geometries) {
+        g.dispose();
+    }
+    return merged;
+}
+/**
+ * One-stop helper: SVG text → extruded BufferGeometry.
+ *
+ * @param svgText - the SVG source text.
+ * @param options - the extrusion options.
+ * @returns the extruded BufferGeometry.
+ */
+export function svgToExtrudedGeometry(svgText, options) {
+    const shapes = parseSvgShapes(svgText);
+    return extrudeShapes(shapes, options);
+}
+//# sourceMappingURL=svg-extrude.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"svg-extrude.js","sourceRoot":"","sources":["../../src/extras/svg-extrude.ts"],"names":[],"mappings":"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","sourcesContent":["import * as THREE from 'three'\nimport { SVGLoader, type SVGResult } from 'three/examples/jsm/loaders/SVGLoader.js'\nimport { mergeBufferGeometries } from '@faicad/faijs/primitives/mesh-primitives'\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 THREE.Shape contours.\n * Uses SVGLoader to convert the SVG paths into shapes usable by ExtrudeGeometry.\n *\n * @param svgText - the SVG source text.\n * @returns the list of closed shapes found in the SVG.\n * @throws when the SVG contains no closed contour.\n */\nexport function parseSvgShapes(svgText: string): THREE.Shape[] {\n  const loader = new SVGLoader()\n  const svgData: SVGResult = loader.parse(svgText)\n\n  const allShapes: THREE.Shape[] = []\n  for (const path of svgData.paths) {\n    const shapes = SVGLoader.createShapes(path)\n    for (const shape of shapes) {\n      allShapes.push(shape)\n    }\n  }\n\n  if (allShapes.length === 0) {\n    throw new Error('No closed contour found in SVG. Please check the file content.')\n  }\n\n  return allShapes\n}\n\n/**\n * Extrude a list of shapes into a single merged BufferGeometry.\n * The scale factor is computed from naturalWidth/naturalHeight and targetLongSide.\n *\n * @param shapes - the shapes to extrude.\n * @param options - the extrusion options (depth and scale inputs).\n * @returns the merged, scaled, centred BufferGeometry.\n */\nexport function extrudeShapes(\n  shapes: THREE.Shape[],\n  options: SvgExtrudeOptions,\n): THREE.BufferGeometry {\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  // 先挤出，再整体缩放几何体\n  const geometries = shapes.map((shape) => {\n    const geo = new THREE.ExtrudeGeometry(shape, {\n      depth,\n      bevelEnabled: false,\n    })\n    // 应用缩放\n    geo.scale(scale, scale, 1)\n    return geo\n  })\n\n  // 合并所有几何体为一个\n  const merged = mergeBufferGeometries(geometries)\n  merged.computeVertexNormals()\n\n  // 居中处理：XY 居中，Z 底部对齐到 0（3D 打印放在热床上）\n  merged.computeBoundingBox()\n  if (merged.boundingBox) {\n    const cx = (merged.boundingBox.max.x + merged.boundingBox.min.x) / 2\n    const cy = (merged.boundingBox.max.y + merged.boundingBox.min.y) / 2\n    const cz = merged.boundingBox.min.z\n    merged.translate(-cx, -cy, -cz)\n  }\n\n  // 清理临时 geometry\n  for (const g of geometries) {\n    g.dispose()\n  }\n\n  return merged\n}\n\n/**\n * One-stop helper: SVG text → extruded BufferGeometry.\n *\n * @param svgText - the SVG source text.\n * @param options - the extrusion options.\n * @returns the extruded BufferGeometry.\n */\nexport function svgToExtrudedGeometry(\n  svgText: string,\n  options: SvgExtrudeOptions,\n): THREE.BufferGeometry {\n  const shapes = parseSvgShapes(svgText)\n  return extrudeShapes(shapes, options)\n}"]}

package/dist/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 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.
+ *
+ * The character classification / system-font loading half lives in core
+ * (`@faicad/faijs/primitives/text/cjk-font`) and is deliberately three-free.
+ */
+import * as THREE from 'three';
+import type { Font } from 'opentype.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 geometry for the whole text.
+ */
+export declare function createMixedTextGeometry(text: string, size: number, depth: number, cjkFont: Font | null, defaultFont?: Font): Promise<THREE.BufferGeometry>;
+//# sourceMappingURL=text-cjk.d.ts.map

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

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

@@ -0,0 +1,146 @@
+/**
+ * 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 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.
+ *
+ * The character classification / system-font loading half lives in core
+ * (`@faicad/faijs/primitives/text/cjk-font`) and is deliberately three-free.
+ */
+import * as THREE from 'three';
+import { mergeBufferGeometries } from '@faicad/faijs/primitives/mesh-primitives';
+import { getOpentypeFont } from './text-geometry.js';
+/**
+ * Generate geometry for a single character using opentype.js.
+ * Uses the same shape/extrude chain as opentypePathToGeometry().
+ */
+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;
+    // Build shapes without centering (the per-character offset is handled here).
+    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=text-cjk.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text-cjk.js","sourceRoot":"","sources":["../../src/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 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 *\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 * as THREE from 'three'\n// Type-only: glyph parsing itself lives in core's fontRegistry; the extension\n// library never calls opentype at runtime (keeps it out of the A-group closure).\nimport type * as opentype from 'opentype.js'\nimport type { Font } from 'opentype.js'\nimport { mergeBufferGeometries } from '@faicad/faijs/primitives/mesh-primitives'\nimport { getOpentypeFont } 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 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  // Build shapes without centering (the per-character offset is handled here).\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/extras/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/extras/text-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-geometry.d.ts","sourceRoot":"","sources":["../../src/extras/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"}