@faicad/faijs 0.13.0

package/dist/node-host/node-font-provider.d.ts

@@ -0,0 +1,50 @@
+/**
+ * NodeFontProvider — Node 端字体加载（fs 读取）
+ *
+ *
+ * 实现 FontProvider 接口（ports.ts）+ FontLoader 接口（fontRegistry.ts）。
+ *
+ * - FontProvider.loadFont(key): 按 key 加载字体 ArrayBuffer
+ * - FontLoader.loadDefaultFont(): 返回默认字体
+ *
+ * 字体文件唯一真源：src/assets/fonts/OpenSans-Regular.ttf
+ * 额外字体可通过 --fonts <dir> 注册。
+ */
+import type { FontProvider } from '../cad-runtime/ports.js';
+import type { FontLoader } from '../brep/text/fontRegistry.js';
+/** Options for constructing a NodeFontProvider. */
+export interface NodeFontProviderOptions {
+    /** Default font path (falls back to the project single source of truth when omitted). */
+    defaultFontPath?: string;
+    /** Extra fonts directory: all .ttf/.otf files are registered by file name (without extension) as keys. */
+    fontsDir?: string;
+}
+/**
+ * Node-side font provider (fs loading).
+ *
+ * Implements the FontProvider interface (ports.ts) + FontLoader interface (fontRegistry.ts).
+ *
+ * - FontProvider.loadFont(key): load a font ArrayBuffer by key
+ * - FontLoader.loadDefaultFont(): return the default font
+ *
+ * Single source of truth for the default font file: src/assets/fonts/OpenSans-Regular.ttf.
+ * Extra fonts can be registered via the --fonts <dir> option.
+ */
+export declare class NodeFontProvider implements FontProvider, FontLoader {
+    private defaultFontPath;
+    private fontsDir;
+    /** key → 文件路径 映射（包含 'default' → 默认字体） */
+    private keyToPath;
+    /** 缓存的 ArrayBuffer（避免重复读磁盘） */
+    private cache;
+    constructor(opts?: NodeFontProviderOptions);
+    /** FontProvider.loadFont: load font bytes by key. */
+    loadFont(key: string): Promise<ArrayBuffer>;
+    /** FontLoader.loadDefaultFont: return the default font bytes. */
+    loadDefaultFont(): Promise<ArrayBuffer>;
+    /** FontProvider.listFonts: list the available font keys. */
+    listFonts(): string[];
+    /** 读取文件并缓存 */
+    private loadFile;
+}
+//# sourceMappingURL=node-font-provider.d.ts.map

package/dist/node-host/node-font-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-font-provider.d.ts","sourceRoot":"","sources":["../../src/node-host/node-font-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAQ3D,mDAAmD;AACnD,MAAM,WAAW,uBAAuB;IACtC,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,gBAAiB,YAAW,YAAY,EAAE,UAAU;IAC/D,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAoB;IACpC,yCAAyC;IACzC,OAAO,CAAC,SAAS,CAA4B;IAC7C,+BAA+B;IAC/B,OAAO,CAAC,KAAK,CAAiC;gBAElC,IAAI,CAAC,EAAE,uBAAuB;IAsB1C,qDAAqD;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQjD,iEAAiE;IAC3D,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC;IAI7C,4DAA4D;IAC5D,SAAS,IAAI,MAAM,EAAE;IAIrB,cAAc;IACd,OAAO,CAAC,QAAQ;CAajB"}

package/dist/node-host/node-font-provider.js

@@ -0,0 +1,87 @@
+/**
+ * NodeFontProvider — Node 端字体加载（fs 读取）
+ *
+ *
+ * 实现 FontProvider 接口（ports.ts）+ FontLoader 接口（fontRegistry.ts）。
+ *
+ * - FontProvider.loadFont(key): 按 key 加载字体 ArrayBuffer
+ * - FontLoader.loadDefaultFont(): 返回默认字体
+ *
+ * 字体文件唯一真源：src/assets/fonts/OpenSans-Regular.ttf
+ * 额外字体可通过 --fonts <dir> 注册。
+ */
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
+import { resolve, extname, basename } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// 默认字体路径（项目唯一真源）——模块相对（P6：与 cwd 无关；发布态由宿主注入覆盖）
+const DEFAULT_FONT_PATH = fileURLToPath(new URL('../assets/fonts/OpenSans-Regular.ttf', import.meta.url));
+/** 字体文件扩展名 */
+const FONT_EXTENSIONS = new Set(['.ttf', '.otf', '.woff', '.woff2']);
+/**
+ * Node-side font provider (fs loading).
+ *
+ * Implements the FontProvider interface (ports.ts) + FontLoader interface (fontRegistry.ts).
+ *
+ * - FontProvider.loadFont(key): load a font ArrayBuffer by key
+ * - FontLoader.loadDefaultFont(): return the default font
+ *
+ * Single source of truth for the default font file: src/assets/fonts/OpenSans-Regular.ttf.
+ * Extra fonts can be registered via the --fonts <dir> option.
+ */
+export class NodeFontProvider {
+    defaultFontPath;
+    fontsDir;
+    /** key → 文件路径 映射（包含 'default' → 默认字体） */
+    keyToPath = new Map();
+    /** 缓存的 ArrayBuffer（避免重复读磁盘） */
+    cache = new Map();
+    constructor(opts) {
+        this.defaultFontPath = opts?.defaultFontPath ?? DEFAULT_FONT_PATH;
+        this.fontsDir = opts?.fontsDir;
+        // 注册默认字体
+        this.keyToPath.set('default', this.defaultFontPath);
+        this.keyToPath.set('OpenSans', this.defaultFontPath);
+        this.keyToPath.set('OpenSans-Regular', this.defaultFontPath);
+        // 扫描额外字体目录
+        if (this.fontsDir && existsSync(this.fontsDir)) {
+            const files = readdirSync(this.fontsDir);
+            for (const file of files) {
+                const ext = extname(file).toLowerCase();
+                if (FONT_EXTENSIONS.has(ext)) {
+                    const key = basename(file, ext);
+                    this.keyToPath.set(key, resolve(this.fontsDir, file));
+                }
+            }
+        }
+    }
+    /** FontProvider.loadFont: load font bytes by key. */
+    async loadFont(key) {
+        const path = this.keyToPath.get(key);
+        if (!path) {
+            throw new Error(`[NodeFontProvider] font key "${key}" not found. Available: ${this.listFonts().join(', ')}`);
+        }
+        return this.loadFile(path);
+    }
+    /** FontLoader.loadDefaultFont: return the default font bytes. */
+    async loadDefaultFont() {
+        return this.loadFile(this.defaultFontPath);
+    }
+    /** FontProvider.listFonts: list the available font keys. */
+    listFonts() {
+        return Array.from(this.keyToPath.keys());
+    }
+    /** 读取文件并缓存 */
+    loadFile(path) {
+        const cached = this.cache.get(path);
+        if (cached)
+            return cached;
+        if (!existsSync(path)) {
+            throw new Error(`[NodeFontProvider] font file not found: ${path}`);
+        }
+        const buf = readFileSync(path);
+        const arrayBuffer = buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);
+        this.cache.set(path, arrayBuffer);
+        return arrayBuffer;
+    }
+}
+//# sourceMappingURL=node-font-provider.js.map

package/dist/node-host/node-font-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-font-provider.js","sourceRoot":"","sources":["../../src/node-host/node-font-provider.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * NodeFontProvider — Node 端字体加载（fs 读取）\n *\n *\n * 实现 FontProvider 接口（ports.ts）+ FontLoader 接口（fontRegistry.ts）。\n *\n * - FontProvider.loadFont(key): 按 key 加载字体 ArrayBuffer\n * - FontLoader.loadDefaultFont(): 返回默认字体\n *\n * 字体文件唯一真源：src/assets/fonts/OpenSans-Regular.ttf\n * 额外字体可通过 --fonts <dir> 注册。\n */\n\nimport { readFileSync, existsSync, readdirSync } from 'node:fs'\nimport { resolve, extname, basename } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport type { FontProvider } from '../cad-runtime/ports'\nimport type { FontLoader } from '../brep/text/fontRegistry'\n\n// 默认字体路径（项目唯一真源）——模块相对（P6：与 cwd 无关；发布态由宿主注入覆盖）\nconst DEFAULT_FONT_PATH = fileURLToPath(new URL('../assets/fonts/OpenSans-Regular.ttf', import.meta.url))\n\n/** 字体文件扩展名 */\nconst FONT_EXTENSIONS = new Set(['.ttf', '.otf', '.woff', '.woff2'])\n\n/** Options for constructing a NodeFontProvider. */\nexport interface NodeFontProviderOptions {\n  /** Default font path (falls back to the project single source of truth when omitted). */\n  defaultFontPath?: string\n  /** Extra fonts directory: all .ttf/.otf files are registered by file name (without extension) as keys. */\n  fontsDir?: string\n}\n\n/**\n * Node-side font provider (fs loading).\n *\n * Implements the FontProvider interface (ports.ts) + FontLoader interface (fontRegistry.ts).\n *\n * - FontProvider.loadFont(key): load a font ArrayBuffer by key\n * - FontLoader.loadDefaultFont(): return the default font\n *\n * Single source of truth for the default font file: src/assets/fonts/OpenSans-Regular.ttf.\n * Extra fonts can be registered via the --fonts <dir> option.\n */\nexport class NodeFontProvider implements FontProvider, FontLoader {\n  private defaultFontPath: string\n  private fontsDir: string | undefined\n  /** key → 文件路径 映射（包含 'default' → 默认字体） */\n  private keyToPath = new Map<string, string>()\n  /** 缓存的 ArrayBuffer（避免重复读磁盘） */\n  private cache = new Map<string, ArrayBuffer>()\n\n  constructor(opts?: NodeFontProviderOptions) {\n    this.defaultFontPath = opts?.defaultFontPath ?? DEFAULT_FONT_PATH\n    this.fontsDir = opts?.fontsDir\n\n    // 注册默认字体\n    this.keyToPath.set('default', this.defaultFontPath)\n    this.keyToPath.set('OpenSans', this.defaultFontPath)\n    this.keyToPath.set('OpenSans-Regular', this.defaultFontPath)\n\n    // 扫描额外字体目录\n    if (this.fontsDir && existsSync(this.fontsDir)) {\n      const files = readdirSync(this.fontsDir)\n      for (const file of files) {\n        const ext = extname(file).toLowerCase()\n        if (FONT_EXTENSIONS.has(ext)) {\n          const key = basename(file, ext)\n          this.keyToPath.set(key, resolve(this.fontsDir, file))\n        }\n      }\n    }\n  }\n\n  /** FontProvider.loadFont: load font bytes by key. */\n  async loadFont(key: string): Promise<ArrayBuffer> {\n    const path = this.keyToPath.get(key)\n    if (!path) {\n      throw new Error(`[NodeFontProvider] font key \"${key}\" not found. Available: ${this.listFonts().join(', ')}`)\n    }\n    return this.loadFile(path)\n  }\n\n  /** FontLoader.loadDefaultFont: return the default font bytes. */\n  async loadDefaultFont(): Promise<ArrayBuffer> {\n    return this.loadFile(this.defaultFontPath)\n  }\n\n  /** FontProvider.listFonts: list the available font keys. */\n  listFonts(): string[] {\n    return Array.from(this.keyToPath.keys())\n  }\n\n  /** 读取文件并缓存 */\n  private loadFile(path: string): ArrayBuffer {\n    const cached = this.cache.get(path)\n    if (cached) return cached\n\n    if (!existsSync(path)) {\n      throw new Error(`[NodeFontProvider] font file not found: ${path}`)\n    }\n\n    const buf = readFileSync(path)\n    const arrayBuffer = buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength) as ArrayBuffer\n    this.cache.set(path, arrayBuffer)\n    return arrayBuffer\n  }\n}\n"]}

package/dist/node.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Node.js 入口 — 仅在 Node.js 环境中使用
+ *
+ * 这个文件单独导出 node-host 相关的模块，避免主入口 index.ts
+ * 静态 import node-host 模块（在浏览器环境中会导致 404）。
+ *
+ * 消费者在 Node.js 环境中应从 @faicad/faijs/node 导入：
+ *   import { createNodePorts } from '@faicad/faijs/node'
+ */
+export * from './index.js';
+export { createNodePorts } from './node-host/index.js';
+export { createFsProjectLoader, findProjectRoot, projectKeyOf, } from './node-host/fs-project-loader.js';
+export type { ProjectLoader } from './cad-runtime/ports.js';
+export { setManifoldWasmUrl, getManifoldWasmUrl, getManifoldModule } from './mesh/manifold-loader.js';
+export { InlineCsgBackend } from './browser-host/inline-csg-backend.js';
+export { InlineSdfBackend } from './browser-host/inline-sdf-backend.js';
+export { NodeFontProvider } from './node-host/node-font-provider.js';
+export { FsAssetResolver } from './node-host/fs-asset-resolver.js';
+export { CliEventSink } from './node-host/cli-event-sink.js';
+export { cliCheck, cliRun, cliMain, parseArgs } from './node-host/cli.js';
+export type { CliCheckResult, CliRunResult, CliRunOptions } from './node-host/cli.js';
+export * from './topology/naming/index.js';
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,SAAS,CAAA;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,YAAY,GACb,MAAM,+BAA+B,CAAA;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAClG,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AACtE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAGlF,cAAc,mBAAmB,CAAA"}

package/dist/node.js

@@ -0,0 +1,23 @@
+/**
+ * Node.js 入口 — 仅在 Node.js 环境中使用
+ *
+ * 这个文件单独导出 node-host 相关的模块，避免主入口 index.ts
+ * 静态 import node-host 模块（在浏览器环境中会导致 404）。
+ *
+ * 消费者在 Node.js 环境中应从 @faicad/faijs/node 导入：
+ *   import { createNodePorts } from '@faicad/faijs/node'
+ */
+// D1（2026-09-19）：/node 入口与 /.、/browser 同源暴露 createRuntime（自带 cad 注册）。
+export * from './index.js';
+export { createNodePorts } from './node-host/index.js';
+export { createFsProjectLoader, findProjectRoot, projectKeyOf, } from './node-host/fs-project-loader.js';
+export { setManifoldWasmUrl, getManifoldWasmUrl, getManifoldModule } from './mesh/manifold-loader.js';
+export { InlineCsgBackend } from './browser-host/inline-csg-backend.js';
+export { InlineSdfBackend } from './browser-host/inline-sdf-backend.js';
+export { NodeFontProvider } from './node-host/node-font-provider.js';
+export { FsAssetResolver } from './node-host/fs-asset-resolver.js';
+export { CliEventSink } from './node-host/cli-event-sink.js';
+export { cliCheck, cliRun, cliMain, parseArgs } from './node-host/cli.js';
+// ── TopoRef 命名层（§3.7/§3.8：命名属于核心公共能力，随 browser/node 走）──
+export * from './topology/naming/index.js';
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,sEAAsE;AACtE,cAAc,SAAS,CAAA;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,YAAY,GACb,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAClG,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGtE,0DAA0D;AAC1D,cAAc,mBAAmB,CAAA","sourcesContent":["/**\n * Node.js 入口 — 仅在 Node.js 环境中使用\n *\n * 这个文件单独导出 node-host 相关的模块，避免主入口 index.ts\n * 静态 import node-host 模块（在浏览器环境中会导致 404）。\n *\n * 消费者在 Node.js 环境中应从 @faicad/faijs/node 导入：\n *   import { createNodePorts } from '@faicad/faijs/node'\n */\n\n// D1（2026-09-19）：/node 入口与 /.、/browser 同源暴露 createRuntime（自带 cad 注册）。\nexport * from './index'\n\nexport { createNodePorts } from './node-host'\nexport {\n  createFsProjectLoader,\n  findProjectRoot,\n  projectKeyOf,\n} from './node-host/fs-project-loader'\nexport type { ProjectLoader } from './cad-runtime/ports'\nexport { setManifoldWasmUrl, getManifoldWasmUrl, getManifoldModule } from './mesh/manifold-loader'\nexport { InlineCsgBackend } from './browser-host/inline-csg-backend'\nexport { InlineSdfBackend } from './browser-host/inline-sdf-backend'\nexport { NodeFontProvider } from './node-host/node-font-provider'\nexport { FsAssetResolver } from './node-host/fs-asset-resolver'\nexport { CliEventSink } from './node-host/cli-event-sink'\nexport { cliCheck, cliRun, cliMain, parseArgs } from './node-host/cli'\nexport type { CliCheckResult, CliRunResult, CliRunOptions } from './node-host/cli'\n\n// ── TopoRef 命名层（§3.7/§3.8：命名属于核心公共能力，随 browser/node 走）──\nexport * from './topology/naming'\n"]}

package/dist/occt-kernel/highLevelApi.d.ts

@@ -0,0 +1,106 @@
+/**
+ * OCCT 高层 API — E12.2
+ *
+ * 宿主不应再直接 import 底层 OCCT kernel 函数（initOcctWasm/importStepToMesh/meshesToStep 等），
+ * 而是使用这些高层 API。
+ *
+ * 高层 API 封装了初始化、导入、导出的完整流程，
+ * 返回标准化的 Shape / 拓扑数据 / STEP 字节流。
+ */
+import type { Shape } from '../mesh/types.js';
+import type { StepExportEntry } from '../brep/export/step.js';
+import type { ShapeHandle, OcctKernel, WasmTessellatedMesh, Mesh, MeshDeflectionOptions } from './occtKernel.js';
+/** Result of importing a single part from a multi-part STEP file. */
+export interface ImportStepPartResult {
+    /** The part's mesh (positions + indices). */
+    shape: Shape;
+    /** OCCT solid handle (with location, for later BREP operations or STEP export). */
+    solid: ShapeHandle;
+    /** Part name (from the XCAF label). */
+    name: string;
+    /** Part color [r,g,b] in 0..1, or null when there is no color. */
+    color: [number, number, number] | null;
+}
+/**
+ * High-level: import multi-part mesh + solid from a STEP file byte stream.
+ *
+ * Uses XCAF assembly-tree parsing, keeping each part's mesh and solid independent.
+ * Unlike importStep, this does not merge meshes — each part returns its own shape.
+ *
+ * @param bytes - STEP file byte stream
+ * @returns an array of per-part import results
+ */
+export declare function importStepMultiPart(bytes: ArrayBuffer | Uint8Array): Promise<ImportStepPartResult[]>;
+/** Result of importing a STEP/BREP file. */
+export interface ImportStepResult {
+    /** The merged mesh (all parts' positions/indices combined). */
+    shape: Shape;
+    /** Each part's mesh (for topology building). */
+    meshes: WasmTessellatedMesh[];
+    /** OCCT solid handle (for later BREP operations or STEP export). */
+    solid: ShapeHandle;
+    /** Face-group information (for topology building). */
+    meshWithGroups: Mesh;
+}
+/**
+ * High-level: import mesh + solid from a STEP/BREP file byte stream.
+ *
+ * Wraps the full importStepToMesh/importBrepToMesh + mesh merge flow.
+ * Hosts no longer need to operate the OCCT kernel directly.
+ *
+ * @param bytes - STEP/BREP file byte stream
+ * @param format - the file format: 'step' | 'brep'
+ * @param options - optional mesh deflection options
+ * @returns the import result
+ */
+export declare function importStep(bytes: ArrayBuffer | Uint8Array | string, format?: 'step' | 'brep', options?: MeshDeflectionOptions): Promise<ImportStepResult>;
+/** Options for exporting mesh data to a STEP string. */
+export interface ExportStepOptions {
+    /** Sewing tolerance. */
+    tolerance?: number;
+}
+/**
+ * High-level: export mesh data as a STEP string.
+ *
+ * Wraps the full meshesToStep flow. Hosts no longer need to operate the OCCT kernel directly.
+ *
+ * @param shape - mesh data (positions + indices)
+ * @param options - optional export options (sewing tolerance)
+ * @returns the STEP file text content
+ */
+export declare function exportStep(shape: Shape, options?: ExportStepOptions): string;
+/**
+ * High-level: release an OCCT solid handle.
+ *
+ * Wraps the full releaseShape flow.
+ *
+ * @param solid - the solid handle to release
+ */
+export declare function releaseSolid(solid: ShapeHandle): void;
+/**
+ * High-level: multi-solid STEP export (zero fuse).
+ *
+ * Each entry is exported as an independent entity in the STEP (independent XCAF
+ * label / PRODUCT), preserving name and color. Multiple solids are never fused.
+ *
+ * Wraps the full ensureOcctKernel + exportStepFromSolids flow.
+ * Hosts no longer need to operate the OCCT kernel directly.
+ *
+ * @param entries - parts to export; each becomes its own independent entity
+ * @returns STEP file content as ArrayBuffer
+ */
+export declare function exportStepFromSolidsHighLevel(entries: StepExportEntry[]): Promise<ArrayBuffer>;
+/**
+ * High-level: initialize the OCCT kernel.
+ * Returns the cached instance if already initialized.
+ *
+ * @returns the initialized OCCT kernel
+ */
+export declare function ensureOcctKernel(): Promise<OcctKernel>;
+/**
+ * High-level: dispose the OCCT kernel.
+ * Call when unloading the page or releasing WASM memory.
+ */
+export declare function disposeOcct(): void;
+export type { OcctKernel, ShapeHandle, WasmTessellatedMesh, Mesh, MeshDeflectionOptions };
+//# sourceMappingURL=highLevelApi.d.ts.map

package/dist/occt-kernel/highLevelApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"highLevelApi.d.ts","sourceRoot":"","sources":["../../src/occt-kernel/highLevelApi.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EAEV,mBAAmB,EACnB,IAAI,EACJ,qBAAqB,EACtB,MAAM,cAAc,CAAA;AAMrB,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,KAAK,EAAE,KAAK,CAAA;IACZ,mFAAmF;IACnF,KAAK,EAAE,WAAW,CAAA;IAClB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;CACvC;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,WAAW,GAAG,UAAU,GAC9B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAiCjC;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,KAAK,EAAE,KAAK,CAAA;IACZ,gDAAgD;IAChD,MAAM,EAAE,mBAAmB,EAAE,CAAA;IAC7B,oEAAoE;IACpE,KAAK,EAAE,WAAW,CAAA;IAClB,sDAAsD;IACtD,cAAc,EAAE,IAAI,CAAA;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,WAAW,GAAG,UAAU,GAAG,MAAM,EACxC,MAAM,GAAE,MAAM,GAAG,MAAe,EAChC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAmC3B;AAID,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAMR;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAErD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,eAAe,EAAE,GACzB,OAAO,CAAC,WAAW,CAAC,CAGtB;AAID;;;;;GAKG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,UAAU,CAAC,CAE5D;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAGD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/occt-kernel/highLevelApi.js

@@ -0,0 +1,149 @@
+/**
+ * OCCT 高层 API — E12.2
+ *
+ * 宿主不应再直接 import 底层 OCCT kernel 函数（initOcctWasm/importStepToMesh/meshesToStep 等），
+ * 而是使用这些高层 API。
+ *
+ * 高层 API 封装了初始化、导入、导出的完整流程，
+ * 返回标准化的 Shape / 拓扑数据 / STEP 字节流。
+ */
+import { initOcctWasm, disposeOcctWasm, importStepToMesh, importBrepToMesh, meshesToStep, releaseShape, importAssemblyFromStep, collectLeafParts, releaseAssemblyTree, computeEffectiveDeflection, } from './occtKernel.js';
+import { exportStepFromSolids } from '../brep/export/step.js';
+/**
+ * High-level: import multi-part mesh + solid from a STEP file byte stream.
+ *
+ * Uses XCAF assembly-tree parsing, keeping each part's mesh and solid independent.
+ * Unlike importStep, this does not merge meshes — each part returns its own shape.
+ *
+ * @param bytes - STEP file byte stream
+ * @returns an array of per-part import results
+ */
+export async function importStepMultiPart(bytes) {
+    const kernel = (await initOcctWasm());
+    // XCAF 解析 → 装配树
+    const nodes = await importAssemblyFromStep(bytes);
+    const leaves = collectLeafParts(nodes);
+    const results = [];
+    for (const leaf of leaves) {
+        if (!leaf.shapeHandle)
+            continue;
+        const eff = computeEffectiveDeflection(kernel, leaf.shapeHandle);
+        const mesh = kernel.meshShape(leaf.shapeHandle, {
+            linearDeflection: eff.linearDeflection,
+            angularDeflection: eff.angularDeflection,
+        });
+        results.push({
+            shape: {
+                positions: mesh.positions,
+                indices: mesh.indices,
+            },
+            solid: leaf.shapeHandle,
+            name: leaf.name,
+            color: leaf.color,
+        });
+    }
+    // 释放装配树中非 leaf 的 shapeHandle（assembly 节点的已由 walkLabel 释放）
+    // leaf 的 shapeHandle 由返回结果持有，调用方负责释放
+    releaseAssemblyTree(kernel, nodes.filter(n => n.isAssembly));
+    return results;
+}
+/**
+ * High-level: import mesh + solid from a STEP/BREP file byte stream.
+ *
+ * Wraps the full importStepToMesh/importBrepToMesh + mesh merge flow.
+ * Hosts no longer need to operate the OCCT kernel directly.
+ *
+ * @param bytes - STEP/BREP file byte stream
+ * @param format - the file format: 'step' | 'brep'
+ * @param options - optional mesh deflection options
+ * @returns the import result
+ */
+export async function importStep(bytes, format = 'step', options) {
+    const result = format === 'brep'
+        ? await importBrepToMesh(bytes, options)
+        : await importStepToMesh(bytes, options);
+    // 合并所有 mesh 的 positions/indices
+    let totalPositions = 0;
+    let totalIndices = 0;
+    for (const mesh of result.meshes) {
+        totalPositions += mesh.positions.length;
+        totalIndices += mesh.indices.length;
+    }
+    const positions = new Float32Array(totalPositions);
+    const indices = new Uint32Array(totalIndices);
+    let posOffset = 0;
+    let idxOffset = 0;
+    let idxBase = 0;
+    for (const mesh of result.meshes) {
+        positions.set(mesh.positions, posOffset);
+        posOffset += mesh.positions.length;
+        // 需要偏移索引
+        for (let i = 0; i < mesh.indices.length; i++) {
+            indices[idxOffset + i] = mesh.indices[i] + idxBase;
+        }
+        idxOffset += mesh.indices.length;
+        idxBase += mesh.positions.length / 3;
+    }
+    return {
+        shape: { positions, indices },
+        meshes: result.meshes,
+        solid: result.shapeHandle,
+        meshWithGroups: result.meshWithGroups,
+    };
+}
+/**
+ * High-level: export mesh data as a STEP string.
+ *
+ * Wraps the full meshesToStep flow. Hosts no longer need to operate the OCCT kernel directly.
+ *
+ * @param shape - mesh data (positions + indices)
+ * @param options - optional export options (sewing tolerance)
+ * @returns the STEP file text content
+ */
+export function exportStep(shape, options) {
+    return meshesToStep(shape.positions, shape.indices, options?.tolerance ?? 0.01);
+}
+/**
+ * High-level: release an OCCT solid handle.
+ *
+ * Wraps the full releaseShape flow.
+ *
+ * @param solid - the solid handle to release
+ */
+export function releaseSolid(solid) {
+    releaseShape(solid);
+}
+/**
+ * High-level: multi-solid STEP export (zero fuse).
+ *
+ * Each entry is exported as an independent entity in the STEP (independent XCAF
+ * label / PRODUCT), preserving name and color. Multiple solids are never fused.
+ *
+ * Wraps the full ensureOcctKernel + exportStepFromSolids flow.
+ * Hosts no longer need to operate the OCCT kernel directly.
+ *
+ * @param entries - parts to export; each becomes its own independent entity
+ * @returns STEP file content as ArrayBuffer
+ */
+export async function exportStepFromSolidsHighLevel(entries) {
+    const kernel = await ensureOcctKernel();
+    return exportStepFromSolids(kernel, entries);
+}
+// ── 管理函数 ──
+/**
+ * High-level: initialize the OCCT kernel.
+ * Returns the cached instance if already initialized.
+ *
+ * @returns the initialized OCCT kernel
+ */
+export async function ensureOcctKernel() {
+    return initOcctWasm();
+}
+/**
+ * High-level: dispose the OCCT kernel.
+ * Call when unloading the page or releasing WASM memory.
+ */
+export function disposeOcct() {
+    disposeOcctWasm();
+}
+//# sourceMappingURL=highLevelApi.js.map

package/dist/occt-kernel/highLevelApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"highLevelApi.js","sourceRoot":"","sources":["../../src/occt-kernel/highLevelApi.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * OCCT 高层 API — E12.2\n *\n * 宿主不应再直接 import 底层 OCCT kernel 函数（initOcctWasm/importStepToMesh/meshesToStep 等），\n * 而是使用这些高层 API。\n *\n * 高层 API 封装了初始化、导入、导出的完整流程，\n * 返回标准化的 Shape / 拓扑数据 / STEP 字节流。\n */\n\nimport {\n  initOcctWasm,\n  disposeOcctWasm,\n  importStepToMesh,\n  importBrepToMesh,\n  meshesToStep,\n  releaseShape,\n  importAssemblyFromStep,\n  collectLeafParts,\n  releaseAssemblyTree,\n  computeEffectiveDeflection,\n} from './occtKernel'\nimport type { Shape } from '../mesh/types'\nimport { exportStepFromSolids } from '../brep/export/step'\nimport type { StepExportEntry } from '../brep/export/step'\nimport type {\n  ShapeHandle,\n  OcctKernel,\n  WasmImportResult,\n  WasmTessellatedMesh,\n  Mesh,\n  MeshDeflectionOptions,\n} from './occtKernel'\nimport type { BrepHandle } from '../brep/engine/types'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\n\n// ── 导入 API ──\n\n/** Result of importing a single part from a multi-part STEP file. */\nexport interface ImportStepPartResult {\n  /** The part's mesh (positions + indices). */\n  shape: Shape\n  /** OCCT solid handle (with location, for later BREP operations or STEP export). */\n  solid: ShapeHandle\n  /** Part name (from the XCAF label). */\n  name: string\n  /** Part color [r,g,b] in 0..1, or null when there is no color. */\n  color: [number, number, number] | null\n}\n\n/**\n * High-level: import multi-part mesh + solid from a STEP file byte stream.\n *\n * Uses XCAF assembly-tree parsing, keeping each part's mesh and solid independent.\n * Unlike importStep, this does not merge meshes — each part returns its own shape.\n *\n * @param bytes - STEP file byte stream\n * @returns an array of per-part import results\n */\nexport async function importStepMultiPart(\n  bytes: ArrayBuffer | Uint8Array,\n): Promise<ImportStepPartResult[]> {\n  const kernel = (await initOcctWasm()) as unknown as OcctKernel\n\n  // XCAF 解析 → 装配树\n  const nodes = await importAssemblyFromStep(bytes)\n  const leaves = collectLeafParts(nodes)\n\n  const results: ImportStepPartResult[] = []\n  for (const leaf of leaves) {\n    if (!leaf.shapeHandle) continue\n\n    const eff = computeEffectiveDeflection(kernel as unknown as BrepEngineApi, leaf.shapeHandle as unknown as BrepHandle)\n    const mesh = kernel.meshShape(leaf.shapeHandle, {\n      linearDeflection: eff.linearDeflection,\n      angularDeflection: eff.angularDeflection,\n    })\n\n    results.push({\n      shape: {\n        positions: mesh.positions,\n        indices: mesh.indices,\n      },\n      solid: leaf.shapeHandle,\n      name: leaf.name,\n      color: leaf.color,\n    })\n  }\n\n  // 释放装配树中非 leaf 的 shapeHandle（assembly 节点的已由 walkLabel 释放）\n  // leaf 的 shapeHandle 由返回结果持有，调用方负责释放\n  releaseAssemblyTree(kernel as unknown as BrepEngineApi, nodes.filter(n => n.isAssembly))\n\n  return results\n}\n\n/** Result of importing a STEP/BREP file. */\nexport interface ImportStepResult {\n  /** The merged mesh (all parts' positions/indices combined). */\n  shape: Shape\n  /** Each part's mesh (for topology building). */\n  meshes: WasmTessellatedMesh[]\n  /** OCCT solid handle (for later BREP operations or STEP export). */\n  solid: ShapeHandle\n  /** Face-group information (for topology building). */\n  meshWithGroups: Mesh\n}\n\n/**\n * High-level: import mesh + solid from a STEP/BREP file byte stream.\n *\n * Wraps the full importStepToMesh/importBrepToMesh + mesh merge flow.\n * Hosts no longer need to operate the OCCT kernel directly.\n *\n * @param bytes - STEP/BREP file byte stream\n * @param format - the file format: 'step' | 'brep'\n * @param options - optional mesh deflection options\n * @returns the import result\n */\nexport async function importStep(\n  bytes: ArrayBuffer | Uint8Array | string,\n  format: 'step' | 'brep' = 'step',\n  options?: MeshDeflectionOptions,\n): Promise<ImportStepResult> {\n  const result: WasmImportResult = format === 'brep'\n    ? await importBrepToMesh(bytes as string, options)\n    : await importStepToMesh(bytes as ArrayBuffer | Uint8Array, options)\n\n  // 合并所有 mesh 的 positions/indices\n  let totalPositions = 0\n  let totalIndices = 0\n  for (const mesh of result.meshes) {\n    totalPositions += mesh.positions.length\n    totalIndices += mesh.indices.length\n  }\n\n  const positions = new Float32Array(totalPositions)\n  const indices = new Uint32Array(totalIndices)\n  let posOffset = 0\n  let idxOffset = 0\n  let idxBase = 0\n  for (const mesh of result.meshes) {\n    positions.set(mesh.positions, posOffset)\n    posOffset += mesh.positions.length\n    // 需要偏移索引\n    for (let i = 0; i < mesh.indices.length; i++) {\n      indices[idxOffset + i] = mesh.indices[i] + idxBase\n    }\n    idxOffset += mesh.indices.length\n    idxBase += mesh.positions.length / 3\n  }\n\n  return {\n    shape: { positions, indices },\n    meshes: result.meshes,\n    solid: result.shapeHandle,\n    meshWithGroups: result.meshWithGroups,\n  }\n}\n\n// ── 导出 API ──\n\n/** Options for exporting mesh data to a STEP string. */\nexport interface ExportStepOptions {\n  /** Sewing tolerance. */\n  tolerance?: number\n}\n\n/**\n * High-level: export mesh data as a STEP string.\n *\n * Wraps the full meshesToStep flow. Hosts no longer need to operate the OCCT kernel directly.\n *\n * @param shape - mesh data (positions + indices)\n * @param options - optional export options (sewing tolerance)\n * @returns the STEP file text content\n */\nexport function exportStep(\n  shape: Shape,\n  options?: ExportStepOptions,\n): string {\n  return meshesToStep(\n    shape.positions,\n    shape.indices,\n    options?.tolerance ?? 0.01,\n  )\n}\n\n/**\n * High-level: release an OCCT solid handle.\n *\n * Wraps the full releaseShape flow.\n *\n * @param solid - the solid handle to release\n */\nexport function releaseSolid(solid: ShapeHandle): void {\n  releaseShape(solid)\n}\n\n/**\n * High-level: multi-solid STEP export (zero fuse).\n *\n * Each entry is exported as an independent entity in the STEP (independent XCAF\n * label / PRODUCT), preserving name and color. Multiple solids are never fused.\n *\n * Wraps the full ensureOcctKernel + exportStepFromSolids flow.\n * Hosts no longer need to operate the OCCT kernel directly.\n *\n * @param entries - parts to export; each becomes its own independent entity\n * @returns STEP file content as ArrayBuffer\n */\nexport async function exportStepFromSolidsHighLevel(\n  entries: StepExportEntry[],\n): Promise<ArrayBuffer> {\n  const kernel = await ensureOcctKernel()\n  return exportStepFromSolids(kernel as unknown as BrepEngineApi, entries)\n}\n\n// ── 管理函数 ──\n\n/**\n * High-level: initialize the OCCT kernel.\n * Returns the cached instance if already initialized.\n *\n * @returns the initialized OCCT kernel\n */\nexport async function ensureOcctKernel(): Promise<OcctKernel> {\n  return initOcctWasm() as unknown as Promise<OcctKernel>\n}\n\n/**\n * High-level: dispose the OCCT kernel.\n * Call when unloading the page or releasing WASM memory.\n */\nexport function disposeOcct(): void {\n  disposeOcctWasm()\n}\n\n// Re-export 底层类型供高层 API 用户使用\nexport type { OcctKernel, ShapeHandle, WasmTessellatedMesh, Mesh, MeshDeflectionOptions }\n"]}

package/dist/occt-kernel/meshReconstruct.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Mesh → CAD 实体重建管线。
+ *
+ * 移植自 SketchForge-3D 项目的 `cadModifier.worker.ts` 中的 mesh 路径
+ * (ported from SketchForge-3D cadModifier.worker.ts).
+ *
+ * 核心流程：
+ * 1. 三角网格 → ASCII STL 文本 → OCCT importStl
+ * 2. 首次修复 fixShape
+ * 3. 若 isSolid → 直接愈合管线（healSolid + fixFaceOrientations + removeDegenerateEdges + unifySameDomain）
+ * 4. 若失败 → 面缝合管线（多容差 sewAndSolidify 循环）
+ *
+ * 与 occtWasmKernel.ts 中已有的 meshesToStep() 相比，此管线更健壮：
+ * - 使用 importStl（而非逐三角形 buildTriFace）
+ * - 多阶段愈合（fixShape → healSolid → fixFaceOrientations → removeDegenerateEdges → unifySameDomain）
+ * - 多容差面缝合回退（1e-5 → 1e-4 → 1e-3 → 1e-2）
+ * - isValid 验证
+ */
+import type { BrepHandle } from '../brep/engine/types.js';
+import type { BrepEngineApi } from '../brep/engine/primitives.js';
+/**
+ * Validate whether an OCCT shape is a legal topology.
+ * Calls kernel.isValid() to check: solid closedness, each edge belongs to exactly
+ * two faces, consistent face orientation, etc.
+ *
+ * @param kernel - the initialized OCCT kernel
+ * @param shape - the shape to validate
+ * @returns true when the shape is valid, false otherwise
+ */
+export declare function cadShapeIsValid(kernel: BrepEngineApi, shape: BrepHandle): boolean;
+/**
+ * Serialize triangle mesh data as ASCII STL text.
+ *
+ * OCCT's importStl accepts a string input, so ASCII STL can be built directly
+ * without any File/Blob dependency.
+ *
+ * Each triangle emits a facet block containing a normal and three vertex
+ * coordinates. The normal is computed via cross product and normalized (OCCT
+ * recomputes normals after import; this is only temporary).
+ *
+ * @param positions - vertex array [x0,y0,z0, x1,y1,z1, ...]
+ * @param indices - triangle index array [i0,i1,i2, i3,i4,i5, ...]
+ * @returns the ASCII STL text
+ */
+export declare function meshToAsciiStl(positions: Float32Array, indices: Uint32Array): string;
+/**
+ * Rebuild a CAD solid from a triangle mesh.
+ *
+ * Full flow:
+ * 1. mesh → ASCII STL → OCCT importStl
+ * 2. fixShape base repair
+ * 3. if isSolid → direct healing pipeline
+ * 4. on failure → multi-tolerance face-sewing pipeline
+ *
+ * @param kernel - the initialized OCCT kernel
+ * @param positions - vertex array [x0,y0,z0, x1,y1,z1, ...]
+ * @param indices - triangle index array [i0,j0,k0, i1,j1,k1, ...]
+ * @returns the reconstructed solid shape handle (caller is responsible for releasing)
+ * @throws if the mesh is open or non-manifold
+ */
+export declare function reconstructSolidFromMesh(kernel: BrepEngineApi, positions: Float32Array, indices: Uint32Array): BrepHandle;
+/**
+ * Rebuild a CAD solid from a triangle mesh and export it as a STEP string.
+ *
+ * Internally calls reconstructSolidFromMesh, then exportStep.
+ * The returned STEP uses a BREP representation (ADVANCED_FACE + exact surfaces)
+ * rather than a faceted representation (POLYGONAL_FACE).
+ *
+ * @param kernel - the initialized OCCT kernel
+ * @param positions - vertex array
+ * @param indices - triangle index array
+ * @returns the STEP file content string
+ */
+export declare function meshToStepBrep(kernel: BrepEngineApi, positions: Float32Array, indices: Uint32Array): string;
+//# sourceMappingURL=meshReconstruct.d.ts.map

package/dist/occt-kernel/meshReconstruct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meshReconstruct.d.ts","sourceRoot":"","sources":["../../src/occt-kernel/meshReconstruct.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAI9D;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAMjF;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CAsCpF;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,WAAW,GACnB,UAAU,CAgEZ;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,WAAW,GACnB,MAAM,CAOR"}