@faicad/faijs 0.13.0

package/dist/brep/engine/registry.js

@@ -0,0 +1,139 @@
+/**
+ * engine/registry — BREP / mesh 双槽位注册表（§6.2，R8 构建时切换）
+ *
+ *
+ * 与 brepjs 的 registerKernel 同构（首个注册者为默认），但两张表、两套 getter——
+ * 这是 R2（双槽位正交：mesh 引擎与 BREP 引擎独立注册、单独切换）的直接落地。
+ *
+ * BREP 槽以「异步 provider」注册：引擎可能需异步初始化（occt-wasm 加载、
+ * 外部内核 wasm 下载等），provider 只解析一次，结果缓存。
+ *
+ * 注册只发生在宿主启动装配期（R8）：构建时选定的适配器包在初始化时完成注册，
+ * 之后注册表运行期只读。不提供运行时的 unregister / setDefault / 切换 API；
+ * 装配完成后调用 freezeEngineRegistries() 冻结，冻结后任何注册尝试抛错（E2 验收）。
+ */
+const brepEngineProviders = new Map();
+const brepEngineCache = new Map();
+let defaultBrepId = null;
+const meshEngines = new Map();
+let defaultMeshId = null;
+let frozen = false;
+/**
+ * 冻结注册表：宿主启动装配完成后调用（R8）。
+ * 冻结后任何 registerBrepEngine / registerMeshEngine 尝试抛错。
+ * 已解析的引擎实例仍可读取（运行期只读，不冻结读取）。
+ */
+export function freezeEngineRegistries() {
+    frozen = true;
+}
+/**
+ * Register a BREP engine (slot 1). The first registrant automatically becomes the default.
+ * @param id - the engine registration id.
+ * @param provider - the async provider that resolves the engine instance.
+ */
+export function registerBrepEngine(id, provider) {
+    if (frozen) {
+        throw new Error(`[engine/registry] registry frozen — cannot register BREP engine '${id}' after assembly (R8)`);
+    }
+    if (brepEngineProviders.has(id)) {
+        throw new Error(`[engine/registry] BREP engine '${id}' already registered`);
+    }
+    brepEngineProviders.set(id, provider);
+    if (defaultBrepId === null)
+        defaultBrepId = id;
+}
+/**
+ * Register a mesh engine (slot 2). The first registrant automatically becomes the default.
+ * @param id - the engine registration id.
+ * @param engine - the engine instance to register.
+ */
+export function registerMeshEngine(id, engine) {
+    if (frozen) {
+        throw new Error(`[engine/registry] registry frozen — cannot register mesh engine '${id}' after assembly (R8)`);
+    }
+    if (meshEngines.has(id)) {
+        throw new Error(`[engine/registry] mesh engine '${id}' already registered`);
+    }
+    meshEngines.set(id, engine);
+    if (defaultMeshId === null)
+        defaultMeshId = id;
+}
+/**
+ * Whether a default BREP engine is registered (none → mesh mode, equivalent to "no BREP capability").
+ * @returns true when a default BREP engine is registered.
+ */
+export function hasBrepEngine() {
+    return defaultBrepId !== null;
+}
+/**
+ * Whether the given BREP engine is registered (used for idempotent adapter registration).
+ * @param id - the engine registration id to look up.
+ * @returns true when the engine is registered.
+ */
+export function isBrepEngineRegistered(id) {
+    return brepEngineProviders.has(id);
+}
+/**
+ * Resolve a BREP engine (asynchronously, resolving its provider; throws when not registered).
+ * Omitting id uses the default (the first registrant).
+ * @param id - optional engine registration id; defaults to the active engine.
+ * @returns a Promise resolving to the BREP engine instance.
+ */
+export async function getBrepEngine(id) {
+    const key = id ?? defaultBrepId;
+    if (key === null) {
+        throw new Error('[engine/registry] no BREP engine registered — call registerBrepEngine() during host assembly (R8)');
+    }
+    const cached = brepEngineCache.get(key);
+    if (cached)
+        return cached;
+    const provider = brepEngineProviders.get(key);
+    if (!provider) {
+        throw new Error(`[engine/registry] BREP engine '${key}' not registered`);
+    }
+    const engine = await provider();
+    brepEngineCache.set(key, engine);
+    return engine;
+}
+/**
+ * Get a mesh engine (throws when not registered). Omitting id uses the default (the first registrant).
+ * @param id - optional engine registration id; defaults to the active engine.
+ * @returns the mesh engine instance.
+ */
+export function getMeshEngine(id) {
+    const key = id ?? defaultMeshId;
+    const engine = key === null ? undefined : meshEngines.get(key);
+    if (!engine) {
+        throw new Error(`[engine/registry] mesh engine '${key ?? '<none>'}' not registered`);
+    }
+    return engine;
+}
+/**
+ * The current default BREP engine id (null when none is registered).
+ * @returns the active BREP engine id or null.
+ */
+export function getActiveBrepEngineId() {
+    return defaultBrepId;
+}
+/**
+ * The current default mesh engine id (null when none is registered).
+ * @returns the active mesh engine id or null.
+ */
+export function getActiveMeshEngineId() {
+    return defaultMeshId;
+}
+/**
+ * 仅测试用：重置注册表状态。
+ *
+ * R8 不提供运行期的 unregister / setDefault；此函数仅供 registry.test.ts
+ * 重置模块级单例，不进入任何公共导出面（index/browser/node/sdk 均不 re-export）。
+ */
+export function __resetEngineRegistriesForTests() {
+    brepEngineProviders.clear();
+    brepEngineCache.clear();
+    meshEngines.clear();
+    defaultBrepId = null;
+    defaultMeshId = null;
+    frozen = false;
+}
+//# sourceMappingURL=registry.js.map

package/dist/brep/engine/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/brep/engine/registry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * engine/registry — BREP / mesh 双槽位注册表（§6.2，R8 构建时切换）\n *\n *\n * 与 brepjs 的 registerKernel 同构（首个注册者为默认），但两张表、两套 getter——\n * 这是 R2（双槽位正交：mesh 引擎与 BREP 引擎独立注册、单独切换）的直接落地。\n *\n * BREP 槽以「异步 provider」注册：引擎可能需异步初始化（occt-wasm 加载、\n * 外部内核 wasm 下载等），provider 只解析一次，结果缓存。\n *\n * 注册只发生在宿主启动装配期（R8）：构建时选定的适配器包在初始化时完成注册，\n * 之后注册表运行期只读。不提供运行时的 unregister / setDefault / 切换 API；\n * 装配完成后调用 freezeEngineRegistries() 冻结，冻结后任何注册尝试抛错（E2 验收）。\n */\n\nimport type { BrepEngineApi } from './primitives'\nimport type { BrepCapabilities } from './types'\n\n/** BREP 引擎实例（槽位 1）：原语契约 + 可选能力声明。 */\nexport interface BrepEngine {\n  readonly id: string\n  readonly primitives: BrepEngineApi\n  readonly capabilities?: BrepCapabilities\n}\n\n/** BREP 引擎异步提供者（宿主装配时注册；引擎初始化完成后 resolve）。 */\nexport type BrepEngineProvider = () => Promise<BrepEngine>\n\n/** mesh 引擎实例（槽位 2）——与 BREP 槽完全独立（R2）。Phase 3 钉死形态。 */\nexport interface MeshEngine {\n  readonly id: string\n}\n\nconst brepEngineProviders = new Map<string, BrepEngineProvider>()\nconst brepEngineCache = new Map<string, BrepEngine>()\nlet defaultBrepId: string | null = null\n\nconst meshEngines = new Map<string, MeshEngine>()\nlet defaultMeshId: string | null = null\n\nlet frozen = false\n\n/**\n * 冻结注册表：宿主启动装配完成后调用（R8）。\n * 冻结后任何 registerBrepEngine / registerMeshEngine 尝试抛错。\n * 已解析的引擎实例仍可读取（运行期只读，不冻结读取）。\n */\nexport function freezeEngineRegistries(): void {\n  frozen = true\n}\n\n/**\n * Register a BREP engine (slot 1). The first registrant automatically becomes the default.\n * @param id - the engine registration id.\n * @param provider - the async provider that resolves the engine instance.\n */\nexport function registerBrepEngine(id: string, provider: BrepEngineProvider): void {\n  if (frozen) {\n    throw new Error(`[engine/registry] registry frozen — cannot register BREP engine '${id}' after assembly (R8)`)\n  }\n  if (brepEngineProviders.has(id)) {\n    throw new Error(`[engine/registry] BREP engine '${id}' already registered`)\n  }\n  brepEngineProviders.set(id, provider)\n  if (defaultBrepId === null) defaultBrepId = id\n}\n\n/**\n * Register a mesh engine (slot 2). The first registrant automatically becomes the default.\n * @param id - the engine registration id.\n * @param engine - the engine instance to register.\n */\nexport function registerMeshEngine(id: string, engine: MeshEngine): void {\n  if (frozen) {\n    throw new Error(`[engine/registry] registry frozen — cannot register mesh engine '${id}' after assembly (R8)`)\n  }\n  if (meshEngines.has(id)) {\n    throw new Error(`[engine/registry] mesh engine '${id}' already registered`)\n  }\n  meshEngines.set(id, engine)\n  if (defaultMeshId === null) defaultMeshId = id\n}\n\n/**\n * Whether a default BREP engine is registered (none → mesh mode, equivalent to \"no BREP capability\").\n * @returns true when a default BREP engine is registered.\n */\nexport function hasBrepEngine(): boolean {\n  return defaultBrepId !== null\n}\n\n/**\n * Whether the given BREP engine is registered (used for idempotent adapter registration).\n * @param id - the engine registration id to look up.\n * @returns true when the engine is registered.\n */\nexport function isBrepEngineRegistered(id: string): boolean {\n  return brepEngineProviders.has(id)\n}\n\n/**\n * Resolve a BREP engine (asynchronously, resolving its provider; throws when not registered).\n * Omitting id uses the default (the first registrant).\n * @param id - optional engine registration id; defaults to the active engine.\n * @returns a Promise resolving to the BREP engine instance.\n */\nexport async function getBrepEngine(id?: string): Promise<BrepEngine> {\n  const key = id ?? defaultBrepId\n  if (key === null) {\n    throw new Error('[engine/registry] no BREP engine registered — call registerBrepEngine() during host assembly (R8)')\n  }\n  const cached = brepEngineCache.get(key)\n  if (cached) return cached\n  const provider = brepEngineProviders.get(key)\n  if (!provider) {\n    throw new Error(`[engine/registry] BREP engine '${key}' not registered`)\n  }\n  const engine = await provider()\n  brepEngineCache.set(key, engine)\n  return engine\n}\n\n/**\n * Get a mesh engine (throws when not registered). Omitting id uses the default (the first registrant).\n * @param id - optional engine registration id; defaults to the active engine.\n * @returns the mesh engine instance.\n */\nexport function getMeshEngine(id?: string): MeshEngine {\n  const key = id ?? defaultMeshId\n  const engine = key === null ? undefined : meshEngines.get(key)\n  if (!engine) {\n    throw new Error(`[engine/registry] mesh engine '${key ?? '<none>'}' not registered`)\n  }\n  return engine\n}\n\n/**\n * The current default BREP engine id (null when none is registered).\n * @returns the active BREP engine id or null.\n */\nexport function getActiveBrepEngineId(): string | null {\n  return defaultBrepId\n}\n\n/**\n * The current default mesh engine id (null when none is registered).\n * @returns the active mesh engine id or null.\n */\nexport function getActiveMeshEngineId(): string | null {\n  return defaultMeshId\n}\n\n/**\n * 仅测试用：重置注册表状态。\n *\n * R8 不提供运行期的 unregister / setDefault；此函数仅供 registry.test.ts\n * 重置模块级单例，不进入任何公共导出面（index/browser/node/sdk 均不 re-export）。\n */\nexport function __resetEngineRegistriesForTests(): void {\n  brepEngineProviders.clear()\n  brepEngineCache.clear()\n  meshEngines.clear()\n  defaultBrepId = null\n  defaultMeshId = null\n  frozen = false\n}\n"]}

package/dist/brep/engine/types.d.ts

@@ -0,0 +1,157 @@
+/**
+ * engine/types — BREP 引擎中立类型（零具体实现依赖，不 import 任何内核包）
+ *
+ *
+ * 契约（对应 brepjs 的 KernelShape 约定）：
+ * - L1 及以上代码永远不对句柄调用任何方法，只把它传回产生它的那个引擎；
+ * - 句柄不得跨引擎传递——跨引擎必须先经 mesh 层（§8.3 的结构保证）。
+ * - OCCT 适配器的句柄运行时就是 number，加 brand 是零成本的类型层转换。
+ */
+declare const BrepHandleBrand: unique symbol;
+/**
+ * BREP 实体句柄——不透明值。
+ *
+ * 与 occt-wasm 的 ShapeHandle 同构（number & brand）。OCCT 适配器
+ * （occt-kernel/）内部以 `as unknown as` 双向转换，跨适配器边界零运行时成本。
+ */
+export type BrepHandle = number & {
+    readonly [BrepHandleBrand]: never;
+};
+/** 三维点/向量（与内核无关的中立形态）。 */
+export interface BrepVec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+/** 轴对齐包围盒。 */
+export interface BrepBoundingBox {
+    xmin: number;
+    ymin: number;
+    zmin: number;
+    xmax: number;
+    ymax: number;
+    zmax: number;
+}
+/** BRepMesh 三角化输出（镜像 occt-wasm Mesh 的中立形态）。 */
+export interface BrepMeshResult {
+    /** XYZ 交错顶点坐标，长度 = vertexCount * 3 */
+    positions: Float32Array;
+    /** XYZ 交错顶点法线，长度 = vertexCount * 3 */
+    normals: Float32Array;
+    /** 三角形索引 */
+    indices: Uint32Array;
+    /** 顶点数（positions.length / 3） */
+    vertexCount: number;
+    /** 三角形数（indices.length / 3） */
+    triangleCount: number;
+    /** 面组：[triStart, triCount, faceHash] 三元组（meshShape 时存在） */
+    faceGroups?: Int32Array;
+    /** 面组数（meshShape 时存在） */
+    faceCount?: number;
+}
+/** 三角化精度选项。 */
+export interface BrepTessellateOptions {
+    /** 最大弦偏差（mm），默认 0.1 */
+    linearDeflection?: number;
+    /** 最大角偏差（弧度），默认 0.5 */
+    angularDeflection?: number;
+    /** 按每条边长度相对解释 linearDeflection */
+    relative?: boolean;
+}
+/** 边折线数据（wireframe 输出）。 */
+export interface BrepEdgeData {
+    /** XYZ 交错边采样点 */
+    points: Float32Array;
+    /** 每边分组：[pointStart, pointCount, edgeHash] 三元组 */
+    edgeGroups: Int32Array;
+    /** points 中的浮点数总数（= XYZ 坐标数） */
+    pointCount: number;
+    /** 不同边的数量 */
+    edgeCount: number;
+}
+/** *WithHistory 面演化数据（modified/generated/deleted 用面 hash 编码）。 */
+export interface BrepEvolutionData {
+    /** 结果句柄 */
+    result: BrepHandle;
+    /** 输入面中被修改的面 hash */
+    modified: number[];
+    /** 操作新生成的面 hash */
+    generated: number[];
+    /** 输入面中已不存在的面 hash */
+    deleted: number[];
+}
+/** 曲线参数区间（与内核 curveParameters 返回同构：first/last）。 */
+export interface BrepCurveParameters {
+    first: number;
+    last: number;
+}
+/** 曲面 UV 边界。 */
+export interface BrepUvBounds {
+    uMin: number;
+    uMax: number;
+    vMin: number;
+    vMax: number;
+}
+/** 子形状类型（getSubShapes / subShapeHashes 等）。 */
+export type BrepSubShapeType = 'vertex' | 'edge' | 'wire' | 'face' | 'shell' | 'solid';
+/**
+ * XCAF 装配文档句柄（可选能力槽 AssemblyCapability 的文档形态）。
+ *
+ * 形态来自 occt-wasm XCAFDocumentImpl 的被调用子集（step.ts / occt-kernel 装配链）。
+ */
+export interface BrepXcafDocument {
+    addShape(shape: BrepHandle, opts?: {
+        name?: string;
+        color?: [number, number, number];
+    }): void;
+    exportSTEP(): string;
+    close(): void;
+}
+/**
+ * 曲面细分精度控制模型（与 brepjs KernelCapabilities.tessellationModel 同构的中立镜像，
+ * P7 并入；faijs 侧零内核依赖，不 import vendored 树——D8 反向只允许发生在 api/）。
+ *
+ * - `'build-time'`  — 网格在实体构造时固定（如 manifold 全局分段设置）；质量参数须在构造前应用。
+ * - `'extract-time'`— 形状是精确的，按需以每调用 deflection 细分（如 OCCT）；质量是
+ *                    `mesh()`/导出时的默认 deflection。
+ * - `'none'`        — 无细分控制（或非网格内核）。
+ */
+export type BrepTessellationModel = 'build-time' | 'extract-time' | 'none';
+/**
+ * 可选能力槽声明（§7.5，Phase 1 钉死成员）。
+ *
+ * 缺失的能力 → 依赖它的功能静态降级走 mesh（§8.4），绝不伪造。
+ *
+ * P7 并入（D4）：移植 brepjs `KernelCapabilities` 的数据字段（exact/brepExport/
+ * exactMeasurement/tessellationModel）进本模型，由适配器在注册时如实声明；分派逻辑
+ * （backend-dispatch 的 BrepCapabilityName 路由）不改——新字段是引擎本质描述，不是
+ * 逐 op 路由键。
+ *
+ * 未并入 `disposalModel`（D5 决策，与 vendored port 一致）：faijs 的句柄释放由
+ * `cad-runtime` 顶替释放统一编排（增量失败回滚前提），brepjs 的 DisposalScope/arena
+ * 语义不强制统一，故不作为能力位记录。
+ */
+export interface BrepCapabilities {
+    /** *WithHistory 面演化族 */
+    evolution?: boolean;
+    /** 修复族（healSolid/fixShape/fixFaceOrientations/...） */
+    heal?: boolean;
+    /** 直接编辑族（C1：moveFace/replaceFace/...） */
+    directEdit?: boolean;
+    /** 高级曲面族（C1：boundarySurface/fillSurface/...） */
+    advSurface?: boolean;
+    /** XCAF 装配族 */
+    assembly?: boolean;
+    /** mesh→BREP 提升（buildTriFace/sewAndSolidify） */
+    meshLift?: boolean;
+    /** 精确 B-rep 几何（vs mesh 近似）——brepjs KernelCapabilities.exact 并入 */
+    exact?: boolean;
+    /** 可序列化为 B-rep 交换格式（BREP/STEP）——brepjs brepExport 并入 */
+    brepExport?: boolean;
+    /** 体积/面积/长度匹配解析值（vs mesh 近似）——brepjs exactMeasurement 并入 */
+    exactMeasurement?: boolean;
+    /** 细分精度控制模型——brepjs tessellationModel 并入 */
+    tessellationModel?: BrepTessellationModel;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/brep/engine/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/brep/engine/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,CAAC,MAAM,eAAe,EAAE,OAAO,MAAM,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AAEvE,0BAA0B;AAC1B,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,cAAc;AACd,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,SAAS,EAAE,YAAY,CAAA;IACvB,sCAAsC;IACtC,OAAO,EAAE,YAAY,CAAA;IACrB,YAAY;IACZ,OAAO,EAAE,WAAW,CAAA;IACpB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAA;IACrB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,eAAe;AACf,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,uBAAuB;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,2BAA2B;AAC3B,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,MAAM,EAAE,YAAY,CAAA;IACpB,kDAAkD;IAClD,UAAU,EAAE,UAAU,CAAA;IACtB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa;IACb,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,WAAW;IACX,MAAM,EAAE,UAAU,CAAA;IAClB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,mBAAmB;IACnB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,sBAAsB;IACtB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAED,gBAAgB;AAChB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,8CAA8C;AAC9C,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAEtF;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,IAAI,CAAA;IAC7F,UAAU,IAAI,MAAM,CAAA;IACpB,KAAK,IAAI,IAAI,CAAA;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,cAAc,GAAG,MAAM,CAAA;AAE1E;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,sDAAsD;IACtD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,gDAAgD;IAChD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,eAAe;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,wDAAwD;IACxD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,qBAAqB,CAAA;CAC1C"}

package/dist/brep/engine/types.js

@@ -0,0 +1,11 @@
+/**
+ * engine/types — BREP 引擎中立类型（零具体实现依赖，不 import 任何内核包）
+ *
+ *
+ * 契约（对应 brepjs 的 KernelShape 约定）：
+ * - L1 及以上代码永远不对句柄调用任何方法，只把它传回产生它的那个引擎；
+ * - 句柄不得跨引擎传递——跨引擎必须先经 mesh 层（§8.3 的结构保证）。
+ * - OCCT 适配器的句柄运行时就是 number，加 brand 是零成本的类型层转换。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/brep/engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/brep/engine/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG","sourcesContent":["/**\n * engine/types — BREP 引擎中立类型（零具体实现依赖，不 import 任何内核包）\n *\n *\n * 契约（对应 brepjs 的 KernelShape 约定）：\n * - L1 及以上代码永远不对句柄调用任何方法，只把它传回产生它的那个引擎；\n * - 句柄不得跨引擎传递——跨引擎必须先经 mesh 层（§8.3 的结构保证）。\n * - OCCT 适配器的句柄运行时就是 number，加 brand 是零成本的类型层转换。\n */\n\ndeclare const BrepHandleBrand: unique symbol\n\n/**\n * BREP 实体句柄——不透明值。\n *\n * 与 occt-wasm 的 ShapeHandle 同构（number & brand）。OCCT 适配器\n * （occt-kernel/）内部以 `as unknown as` 双向转换，跨适配器边界零运行时成本。\n */\nexport type BrepHandle = number & { readonly [BrepHandleBrand]: never }\n\n/** 三维点/向量（与内核无关的中立形态）。 */\nexport interface BrepVec3 {\n  x: number\n  y: number\n  z: number\n}\n\n/** 轴对齐包围盒。 */\nexport interface BrepBoundingBox {\n  xmin: number\n  ymin: number\n  zmin: number\n  xmax: number\n  ymax: number\n  zmax: number\n}\n\n/** BRepMesh 三角化输出（镜像 occt-wasm Mesh 的中立形态）。 */\nexport interface BrepMeshResult {\n  /** XYZ 交错顶点坐标，长度 = vertexCount * 3 */\n  positions: Float32Array\n  /** XYZ 交错顶点法线，长度 = vertexCount * 3 */\n  normals: Float32Array\n  /** 三角形索引 */\n  indices: Uint32Array\n  /** 顶点数（positions.length / 3） */\n  vertexCount: number\n  /** 三角形数（indices.length / 3） */\n  triangleCount: number\n  /** 面组：[triStart, triCount, faceHash] 三元组（meshShape 时存在） */\n  faceGroups?: Int32Array\n  /** 面组数（meshShape 时存在） */\n  faceCount?: number\n}\n\n/** 三角化精度选项。 */\nexport interface BrepTessellateOptions {\n  /** 最大弦偏差（mm），默认 0.1 */\n  linearDeflection?: number\n  /** 最大角偏差（弧度），默认 0.5 */\n  angularDeflection?: number\n  /** 按每条边长度相对解释 linearDeflection */\n  relative?: boolean\n}\n\n/** 边折线数据（wireframe 输出）。 */\nexport interface BrepEdgeData {\n  /** XYZ 交错边采样点 */\n  points: Float32Array\n  /** 每边分组：[pointStart, pointCount, edgeHash] 三元组 */\n  edgeGroups: Int32Array\n  /** points 中的浮点数总数（= XYZ 坐标数） */\n  pointCount: number\n  /** 不同边的数量 */\n  edgeCount: number\n}\n\n/** *WithHistory 面演化数据（modified/generated/deleted 用面 hash 编码）。 */\nexport interface BrepEvolutionData {\n  /** 结果句柄 */\n  result: BrepHandle\n  /** 输入面中被修改的面 hash */\n  modified: number[]\n  /** 操作新生成的面 hash */\n  generated: number[]\n  /** 输入面中已不存在的面 hash */\n  deleted: number[]\n}\n\n/** 曲线参数区间（与内核 curveParameters 返回同构：first/last）。 */\nexport interface BrepCurveParameters {\n  first: number\n  last: number\n}\n\n/** 曲面 UV 边界。 */\nexport interface BrepUvBounds {\n  uMin: number\n  uMax: number\n  vMin: number\n  vMax: number\n}\n\n/** 子形状类型（getSubShapes / subShapeHashes 等）。 */\nexport type BrepSubShapeType = 'vertex' | 'edge' | 'wire' | 'face' | 'shell' | 'solid'\n\n/**\n * XCAF 装配文档句柄（可选能力槽 AssemblyCapability 的文档形态）。\n *\n * 形态来自 occt-wasm XCAFDocumentImpl 的被调用子集（step.ts / occt-kernel 装配链）。\n */\nexport interface BrepXcafDocument {\n  addShape(shape: BrepHandle, opts?: { name?: string; color?: [number, number, number] }): void\n  exportSTEP(): string\n  close(): void\n}\n\n/**\n * 曲面细分精度控制模型（与 brepjs KernelCapabilities.tessellationModel 同构的中立镜像，\n * P7 并入；faijs 侧零内核依赖，不 import vendored 树——D8 反向只允许发生在 api/）。\n *\n * - `'build-time'`  — 网格在实体构造时固定（如 manifold 全局分段设置）；质量参数须在构造前应用。\n * - `'extract-time'`— 形状是精确的，按需以每调用 deflection 细分（如 OCCT）；质量是\n *                    `mesh()`/导出时的默认 deflection。\n * - `'none'`        — 无细分控制（或非网格内核）。\n */\nexport type BrepTessellationModel = 'build-time' | 'extract-time' | 'none'\n\n/**\n * 可选能力槽声明（§7.5，Phase 1 钉死成员）。\n *\n * 缺失的能力 → 依赖它的功能静态降级走 mesh（§8.4），绝不伪造。\n *\n * P7 并入（D4）：移植 brepjs `KernelCapabilities` 的数据字段（exact/brepExport/\n * exactMeasurement/tessellationModel）进本模型，由适配器在注册时如实声明；分派逻辑\n * （backend-dispatch 的 BrepCapabilityName 路由）不改——新字段是引擎本质描述，不是\n * 逐 op 路由键。\n *\n * 未并入 `disposalModel`（D5 决策，与 vendored port 一致）：faijs 的句柄释放由\n * `cad-runtime` 顶替释放统一编排（增量失败回滚前提），brepjs 的 DisposalScope/arena\n * 语义不强制统一，故不作为能力位记录。\n */\nexport interface BrepCapabilities {\n  /** *WithHistory 面演化族 */\n  evolution?: boolean\n  /** 修复族（healSolid/fixShape/fixFaceOrientations/...） */\n  heal?: boolean\n  /** 直接编辑族（C1：moveFace/replaceFace/...） */\n  directEdit?: boolean\n  /** 高级曲面族（C1：boundarySurface/fillSurface/...） */\n  advSurface?: boolean\n  /** XCAF 装配族 */\n  assembly?: boolean\n  /** mesh→BREP 提升（buildTriFace/sewAndSolidify） */\n  meshLift?: boolean\n  /** 精确 B-rep 几何（vs mesh 近似）——brepjs KernelCapabilities.exact 并入 */\n  exact?: boolean\n  /** 可序列化为 B-rep 交换格式（BREP/STEP）——brepjs brepExport 并入 */\n  brepExport?: boolean\n  /** 体积/面积/长度匹配解析值（vs mesh 近似）——brepjs exactMeasurement 并入 */\n  exactMeasurement?: boolean\n  /** 细分精度控制模型——brepjs tessellationModel 并入 */\n  tessellationModel?: BrepTessellationModel\n}\n"]}

package/dist/brep/export/step.d.ts

@@ -0,0 +1,48 @@
+/**
+ * exportStepFromSolids — L1 STEP 导出（从 OCCT solid 句柄，多实体、零 fuse）
+ *
+ * 每个 entry 作为 STEP 中一个独立实体（独立 XCAF label / PRODUCT）导出，
+ * 保留名称与颜色。多实体之间绝不 fuse —— 这是硬性约定：
+ * fuse 只允许作为用户脚本里的几何布尔运算，禁止作为导出时的实体合并手段。
+ *
+ * 导出 → 再导入身份闭环：导入侧 importAssemblyFromStep（XCAF）会把
+ * 多实体 STEP 还原为多个 part；多 solid compound 拆分出的子节点命名为
+ * `name [n]`，与本节点的展平命名规则一致。
+ */
+import type { BrepHandle } from '../engine/types.js';
+import type { BrepEngineApi } from '../engine/primitives.js';
+/** STEP 导出条目：一个 part（精确 BREP 形状或三角网格，二选一）。 */
+export interface StepExportEntry {
+    /** 精确 BREP 形状（solid/shell/face/compound，来自宿主导出缓存）。与 mesh 二选一，solid 优先。 */
+    solid?: BrepHandle;
+    /** 三角网格（世界坐标、已按单位缩放），经 reconstructSolidFromMesh 重建为实体。 */
+    mesh?: {
+        positions: Float32Array;
+        indices: Uint32Array;
+    };
+    /** 实体名称（写入 label name，导出为 PRODUCT 名称）。 */
+    name?: string;
+    /** RGB 0..1 颜色（sRGB 编码，如宿主材质 base color）。写入前转 linear。 */
+    color?: [number, number, number];
+}
+/**
+ * Export multiple BREP solids (and/or triangle meshes) to STEP, one
+ * independent entity per entry — no fuse, no string splicing.
+ *
+ * @param kernel  OCCT kernel (must match the one that created the solids)
+ * @param entries parts to export; each becomes its own XCAF label
+ * @returns STEP file content as ArrayBuffer
+ * @throws if entries is empty, or a mesh entry fails to reconstruct
+ */
+export declare function exportStepFromSolids(kernel: BrepEngineApi, entries: StepExportEntry[]): ArrayBuffer;
+/**
+ * Export a BREP solid (OCCT native) to STEP format.
+ *
+ * 单实体导出 = exportStepFromSolids 的单条目特例（同一实现，无第二真源）。
+ *
+ * @param solid   OCCT solid handle
+ * @param kernel  OCCT kernel (must match the one that created the solid)
+ * @returns STEP file content as ArrayBuffer
+ */
+export declare function exportStepFromSolid(solid: BrepHandle, kernel: BrepEngineApi): ArrayBuffer;
+//# sourceMappingURL=step.d.ts.map

package/dist/brep/export/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../src/brep/export/step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGzD,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,0DAA0D;IAC1D,IAAI,CAAC,EAAE;QAAE,SAAS,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,CAAA;IACxD,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,eAAe,EAAE,GACzB,WAAW,CAyEb;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,aAAa,GACpB,WAAW,CAEb"}

package/dist/brep/export/step.js

@@ -0,0 +1,118 @@
+/**
+ * exportStepFromSolids — L1 STEP 导出（从 OCCT solid 句柄，多实体、零 fuse）
+ *
+ * 每个 entry 作为 STEP 中一个独立实体（独立 XCAF label / PRODUCT）导出，
+ * 保留名称与颜色。多实体之间绝不 fuse —— 这是硬性约定：
+ * fuse 只允许作为用户脚本里的几何布尔运算，禁止作为导出时的实体合并手段。
+ *
+ * 导出 → 再导入身份闭环：导入侧 importAssemblyFromStep（XCAF）会把
+ * 多实体 STEP 还原为多个 part；多 solid compound 拆分出的子节点命名为
+ * `name [n]`，与本节点的展平命名规则一致。
+ */
+import { reconstructSolidFromMesh } from '../../occt-kernel/meshReconstruct.js';
+/**
+ * sRGB → linear 转换。
+ *
+ * OCCT XCAF 内部按 linear RGB 存储颜色，STEP writer（xcafExportSTEP）
+ * 导出时做 linear→sRGB 编码写 COLOUR_RGB。为了让"宿主传入的 sRGB 颜色 ==
+ * STEP 文件中的 COLOUR_RGB == 回读颜色"，写入前必须先转 linear。
+ *
+ * @param c sRGB 编码值（0..1）
+ * @returns linear 值（0..1）
+ */
+function srgbToLinear(c) {
+    return c <= 0.04045 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4);
+}
+/**
+ * Export multiple BREP solids (and/or triangle meshes) to STEP, one
+ * independent entity per entry — no fuse, no string splicing.
+ *
+ * @param kernel  OCCT kernel (must match the one that created the solids)
+ * @param entries parts to export; each becomes its own XCAF label
+ * @returns STEP file content as ArrayBuffer
+ * @throws if entries is empty, or a mesh entry fails to reconstruct
+ */
+export function exportStepFromSolids(kernel, entries) {
+    if (entries.length === 0) {
+        throw new Error('No exportable geometry');
+    }
+    const doc = kernel.createXCAFDocument();
+    // 本函数创建的句柄（展平出的子 solid + mesh 重建的 solid），导出后释放。
+    // 缓存里的原 solid（entry.solid）绝不释放，归调用方/缓存所有。
+    const ownedHandles = [];
+    try {
+        for (const entry of entries) {
+            // 1. 解析 solid：优先用精确 solid；无则从三角网格重建
+            let solid = entry.solid;
+            if (!solid) {
+                if (!entry.mesh) {
+                    throw new Error('StepExportEntry must provide either solid or mesh');
+                }
+                solid = reconstructSolidFromMesh(kernel, entry.mesh.positions, entry.mesh.indices);
+                ownedHandles.push(solid);
+            }
+            // 2. 展平 Compound（多 solid 导入的 part 其 solid 是 Compound）；
+            //    纯 solid 时 getSubShapes('solid') 返回 [自身]。
+            //    形状类型分派：solid → shell → face → edge。ref 侧（cadquery
+            //    Shape.exportStep）可导出任意类型的形状，面/壳/边 compound（如
+            //    Shape.faces('>Z') / shape.edges('>Z') 的结果）同样要能写进
+            //    STEP（U22，2026-09-09）。
+            let subs = kernel.getSubShapes(solid, 'solid');
+            if (subs.length === 0) {
+                subs = kernel.getSubShapes(solid, 'shell');
+            }
+            if (subs.length === 0) {
+                subs = kernel.getSubShapes(solid, 'face');
+            }
+            if (subs.length === 0) {
+                subs = kernel.getSubShapes(solid, 'edge');
+            }
+            if (subs.length === 0) {
+                throw new Error('[exportStepFromSolids] shape contains no solid, shell, face or edge sub-shapes');
+            }
+            for (let si = 0; si < subs.length; si++) {
+                const sub = subs[si];
+                // 展平出的子句柄若不属于调用方缓存，记入 ownedHandles
+                if (solid !== sub)
+                    ownedHandles.push(sub);
+                const name = subs.length > 1
+                    ? `${entry.name ?? 'part'} [${si + 1}]`
+                    : entry.name;
+                // sRGB → linear：XCAF 按 linear 存储，STEP writer 输出时线性→sRGB，
+                // 转换后 STEP 文件里的 COLOUR_RGB 才是宿主传入的原始 sRGB 值。
+                const color = entry.color
+                    ? [srgbToLinear(entry.color[0]), srgbToLinear(entry.color[1]), srgbToLinear(entry.color[2])]
+                    : undefined;
+                doc.addShape(sub, { name, color });
+            }
+        }
+        // 3. 导出（每个 label 一个独立 PRODUCT，保留名称/颜色）
+        const stepText = doc.exportSTEP();
+        return new TextEncoder().encode(stepText).buffer;
+    }
+    finally {
+        // 4. 释放顺序：先关文档，再释放本函数创建的句柄
+        doc.close();
+        for (const h of ownedHandles) {
+            try {
+                kernel.release(h);
+            }
+            catch {
+                // already released
+            }
+        }
+    }
+}
+/**
+ * Export a BREP solid (OCCT native) to STEP format.
+ *
+ * 单实体导出 = exportStepFromSolids 的单条目特例（同一实现，无第二真源）。
+ *
+ * @param solid   OCCT solid handle
+ * @param kernel  OCCT kernel (must match the one that created the solid)
+ * @returns STEP file content as ArrayBuffer
+ */
+export function exportStepFromSolid(solid, kernel) {
+    return exportStepFromSolids(kernel, [{ solid }]);
+}
+//# sourceMappingURL=step.js.map

package/dist/brep/export/step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.js","sourceRoot":"","sources":["../../../src/brep/export/step.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * exportStepFromSolids — L1 STEP 导出（从 OCCT solid 句柄，多实体、零 fuse）\n *\n * 每个 entry 作为 STEP 中一个独立实体（独立 XCAF label / PRODUCT）导出，\n * 保留名称与颜色。多实体之间绝不 fuse —— 这是硬性约定：\n * fuse 只允许作为用户脚本里的几何布尔运算，禁止作为导出时的实体合并手段。\n *\n * 导出 → 再导入身份闭环：导入侧 importAssemblyFromStep（XCAF）会把\n * 多实体 STEP 还原为多个 part；多 solid compound 拆分出的子节点命名为\n * `name [n]`，与本节点的展平命名规则一致。\n */\n\nimport type { BrepHandle } from '../engine/types'\nimport type { BrepEngineApi } from '../engine/primitives'\nimport { reconstructSolidFromMesh } from '../../occt-kernel/meshReconstruct'\n\n/** STEP 导出条目：一个 part（精确 BREP 形状或三角网格，二选一）。 */\nexport interface StepExportEntry {\n  /** 精确 BREP 形状（solid/shell/face/compound，来自宿主导出缓存）。与 mesh 二选一，solid 优先。 */\n  solid?: BrepHandle\n  /** 三角网格（世界坐标、已按单位缩放），经 reconstructSolidFromMesh 重建为实体。 */\n  mesh?: { positions: Float32Array; indices: Uint32Array }\n  /** 实体名称（写入 label name，导出为 PRODUCT 名称）。 */\n  name?: string\n  /** RGB 0..1 颜色（sRGB 编码，如宿主材质 base color）。写入前转 linear。 */\n  color?: [number, number, number]\n}\n\n/**\n * sRGB → linear 转换。\n *\n * OCCT XCAF 内部按 linear RGB 存储颜色，STEP writer（xcafExportSTEP）\n * 导出时做 linear→sRGB 编码写 COLOUR_RGB。为了让\"宿主传入的 sRGB 颜色 ==\n * STEP 文件中的 COLOUR_RGB == 回读颜色\"，写入前必须先转 linear。\n *\n * @param c sRGB 编码值（0..1）\n * @returns linear 值（0..1）\n */\nfunction srgbToLinear(c: number): number {\n  return c <= 0.04045 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4)\n}\n\n/**\n * Export multiple BREP solids (and/or triangle meshes) to STEP, one\n * independent entity per entry — no fuse, no string splicing.\n *\n * @param kernel  OCCT kernel (must match the one that created the solids)\n * @param entries parts to export; each becomes its own XCAF label\n * @returns STEP file content as ArrayBuffer\n * @throws if entries is empty, or a mesh entry fails to reconstruct\n */\nexport function exportStepFromSolids(\n  kernel: BrepEngineApi,\n  entries: StepExportEntry[],\n): ArrayBuffer {\n  if (entries.length === 0) {\n    throw new Error('No exportable geometry')\n  }\n\n  const doc = kernel.createXCAFDocument()\n  // 本函数创建的句柄（展平出的子 solid + mesh 重建的 solid），导出后释放。\n  // 缓存里的原 solid（entry.solid）绝不释放，归调用方/缓存所有。\n  const ownedHandles: BrepHandle[] = []\n\n  try {\n    for (const entry of entries) {\n      // 1. 解析 solid：优先用精确 solid；无则从三角网格重建\n      let solid = entry.solid\n      if (!solid) {\n        if (!entry.mesh) {\n          throw new Error('StepExportEntry must provide either solid or mesh')\n        }\n        solid = reconstructSolidFromMesh(kernel, entry.mesh.positions, entry.mesh.indices)\n        ownedHandles.push(solid)\n      }\n\n      // 2. 展平 Compound（多 solid 导入的 part 其 solid 是 Compound）；\n      //    纯 solid 时 getSubShapes('solid') 返回 [自身]。\n      //    形状类型分派：solid → shell → face → edge。ref 侧（cadquery\n      //    Shape.exportStep）可导出任意类型的形状，面/壳/边 compound（如\n      //    Shape.faces('>Z') / shape.edges('>Z') 的结果）同样要能写进\n      //    STEP（U22，2026-09-09）。\n      let subs = kernel.getSubShapes(solid, 'solid')\n      if (subs.length === 0) {\n        subs = kernel.getSubShapes(solid, 'shell')\n      }\n      if (subs.length === 0) {\n        subs = kernel.getSubShapes(solid, 'face')\n      }\n      if (subs.length === 0) {\n        subs = kernel.getSubShapes(solid, 'edge')\n      }\n      if (subs.length === 0) {\n        throw new Error(\n          '[exportStepFromSolids] shape contains no solid, shell, face or edge sub-shapes',\n        )\n      }\n      for (let si = 0; si < subs.length; si++) {\n        const sub = subs[si]\n        // 展平出的子句柄若不属于调用方缓存，记入 ownedHandles\n        if (solid !== sub) ownedHandles.push(sub)\n        const name = subs.length > 1\n          ? `${entry.name ?? 'part'} [${si + 1}]`\n          : entry.name\n        // sRGB → linear：XCAF 按 linear 存储，STEP writer 输出时线性→sRGB，\n        // 转换后 STEP 文件里的 COLOUR_RGB 才是宿主传入的原始 sRGB 值。\n        const color: [number, number, number] | undefined = entry.color\n          ? [srgbToLinear(entry.color[0]), srgbToLinear(entry.color[1]), srgbToLinear(entry.color[2])]\n          : undefined\n        doc.addShape(sub, { name, color })\n      }\n    }\n\n    // 3. 导出（每个 label 一个独立 PRODUCT，保留名称/颜色）\n    const stepText = doc.exportSTEP()\n    return new TextEncoder().encode(stepText).buffer\n  } finally {\n    // 4. 释放顺序：先关文档，再释放本函数创建的句柄\n    doc.close()\n    for (const h of ownedHandles) {\n      try {\n        kernel.release(h)\n      } catch {\n        // already released\n      }\n    }\n  }\n}\n\n/**\n * Export a BREP solid (OCCT native) to STEP format.\n *\n * 单实体导出 = exportStepFromSolids 的单条目特例（同一实现，无第二真源）。\n *\n * @param solid   OCCT solid handle\n * @param kernel  OCCT kernel (must match the one that created the solid)\n * @returns STEP file content as ArrayBuffer\n */\nexport function exportStepFromSolid(\n  solid: BrepHandle,\n  kernel: BrepEngineApi,\n): ArrayBuffer {\n  return exportStepFromSolids(kernel, [{ solid }])\n}"]}

package/dist/brep/export/stl.d.ts

@@ -0,0 +1,27 @@
+/**
+ * buildStlBufferFromMesh — L1 纯数据 STL 导出（无 THREE 依赖）
+ *
+ *
+ * 从原始 positions + indices 构建 binary STL buffer。
+ * 与 src/renderer/lib/build-stl.ts 的 buildStlBuffer() 功能相同，
+ * 但不依赖 THREE.BufferGeometry，可在 Node 环境直接使用。
+ *
+ * Binary STL format:
+ *   bytes 0-79:    80-byte header
+ *   bytes 80-83:   4-byte uint32 triangle count N
+ *   bytes 84+:     N × 50-byte triangles
+ *     - normal:   3 × float32 (12 bytes)
+ *     - vertex1:  3 × float32 (12 bytes)
+ *     - vertex2:  3 × float32 (12 bytes)
+ *     - vertex3:  3 × float32 (12 bytes)
+ *     - attr:     2 bytes (0)
+ */
+/**
+ * Build a binary STL buffer from raw positions and indices (no THREE dependency).
+ * @param positions - the interleaved vertex positions (x,y,z per vertex).
+ * @param indices - the triangle indices (3 indices per triangle).
+ * @param header - optional 80-byte header text (defaults to 'Faicad STL').
+ * @returns an ArrayBuffer holding the binary STL data.
+ */
+export declare function buildStlBufferFromMesh(positions: Float32Array, indices: Uint32Array, header?: string): ArrayBuffer;
+//# sourceMappingURL=stl.d.ts.map

package/dist/brep/export/stl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stl.d.ts","sourceRoot":"","sources":["../../../src/brep/export/stl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,MAAM,GACd,WAAW,CA+Eb"}