@faicad/faijs 0.19.0 → 0.29.3

package/dist/brep/export/export-model.js

@@ -0,0 +1,336 @@
+/**
+ * exportModel — 统一导出入口（unit-system §10.6 二 / R11 / 裁决 J）
+ *
+ * 单一真源：坐标单位换算与文件单位声明由**同一次换算**产出（§10.3 规则 3），
+ * 声明与坐标必须同源。CLI（writeOutput）与宿主（3d_editor）共用本入口。
+ *
+ * 格式分派（§10.6 表）：
+ * - stl：坐标缩放到 unit 刻度，无声明（格式不支持）。
+ * - step：预缩放 + 文本层只改写单位实体（§10.3 规则 3a；OCCT 恒写
+ *   SI_UNIT(.MILLI.,.METRE.)，坐标预先缩放到目标刻度后声明必须跟上）。
+ * - 3mf：坐标缩放到 unit 刻度 + <model unit> 与坐标同源；yard 不在 3MF
+ *   枚举 → 成对回落到 mm（§10.3 规则 2）。
+ *
+ * 红线（§10.3 3a）：绝不文本级改坐标 — 坐标只在几何层缩放，文本层只碰单位实体。
+ */
+import { buildStlBufferFromMesh } from './stl.js';
+import { writeZipEntries } from '../../io/zip.js';
+import { UNIT_SCALE } from '../../units.js';
+import { getBrepApi } from '../handle-bridge.js';
+import { exportStepFromSolids } from './step.js';
+import { detectStepUnit, STEP_UNIT_SCAN_PREFIX } from '../../mesh/io.js';
+/** UnitName → 3MF <model unit> 枚举全名（唯一真源；yard 无对应值）。 */
+export const UNIT_NAME_TO_3MF = {
+    mm: 'millimeter',
+    cm: 'centimeter',
+    m: 'meter',
+    micron: 'micron',
+    inch: 'inch',
+    foot: 'foot',
+    // yard 无 3MF 枚举值 — 调用方必须先成对回落到 mm（§10.3 规则 2）。
+};
+/** 缩放 Float32 positions 到目标单位刻度（基准值 ÷ unitScale(unit)）。 */
+function scalePositions(positions, scale) {
+    if (scale === 1)
+        return positions;
+    const out = new Float32Array(positions.length);
+    for (let i = 0; i < positions.length; i++)
+        out[i] = positions[i] * scale;
+    return out;
+}
+/** STEP 单位声明改写：SI_UNIT(.MILLI.,.METRE.) → 目标单位实体（只碰单位实体，红线）。 */
+function rewriteStepUnitEntities(stepText, unit) {
+    // mm 是 OCCT 的原生写出形态，无需改写。
+    if (unit === 'mm')
+        return stepText;
+    // SI 面积/体积单位实体的前缀同样要跟着换（LENGTH/AREA/VOLUME 挂同一前缀链），
+    // 但坐标已缩放 → 只需把 LENGTH 链上的前缀换掉；面积/体积单位在 STEP 里由
+    // SI_UNIT 前缀 + 幂次表达，XCAF 写出的实体形态是 SI_UNIT(.MILLI.,.METRE.)
+    // 挂在长度、平方与立方三条依赖链上。为保守起见只改写显式 LENGTH_UNIT 链上的
+    // SI_UNIT —— 具体做法：全局替换 SI_UNIT 前缀（同一文件里坐标相关单位恒为
+    // 长度链；角度 SI_UNIT(.RADIAN.) 不含 METRE 不会被命中）。
+    let out = stepText;
+    if (unit === 'cm' || unit === 'm' || unit === 'micron') {
+        const prefix = unit === 'cm' ? '.CENTI.' : unit === 'm' ? '$' : '.MICRO.';
+        // OCCT 写出恒为 SI_UNIT(.MILLI.,.METRE.)（实测）；$ 前缀形态（无前缀=米）
+        // 在 OCCT 输出中不会出现，但容错处理（若上游将来变化）。
+        out = out.replace(/SI_UNIT\s*\(\s*\.MILLI\.\s*,\s*\.METRE\.\s*\)/g, prefix === '$' ? 'SI_UNIT($,.METRE.)' : `SI_UNIT(${prefix},.METRE.)`);
+        return out;
+    }
+    // inch / foot：CONVERSION_BASED_UNIT 形态。需要注入换算因子实体并替换
+    // LENGTH_UNIT 依赖。最简形态：把 SI_UNIT(.MILLI.,.METRE.) 替换为
+    // CONVERSION_BASED_UNIT('INCH', #factor)，并附加 MEASURE_WITH_UNIT 实体。
+    // 实体编号：取文件内最大 #n + 1、+2（附加实体挂在文件尾部 DATA 段内合法）。
+    const inchFactor = unit === 'inch' ? 25.4 : 304.8;
+    const name = unit === 'inch' ? 'INCH' : 'FOOT';
+    // 1) 收集现有最大实体编号
+    let maxId = 0;
+    for (const m of out.matchAll(/#(\d+)\s*=/g)) {
+        const id = Number(m[1]);
+        if (id > maxId)
+            maxId = id;
+    }
+    const lenId = maxId + 1;
+    const convId = maxId + 2;
+    // 2) 找到 LENGTH_UNIT() 里挂 SI_UNIT 的实体行，替换为 CONVERSION_BASED_UNIT
+    //    并把 SI_UNIT 挂到 LENGTH_MEASURE 上。OCCT 输出形态（实测）：
+    //    #n=(LENGTH_UNIT()NAMED_UNIT(*)SI_UNIT(.MILLI.,.METRE.));
+    const siLine = out.match(/#(\d+)\s*=\s*\([^)]*SI_UNIT\s*\(\s*\.MILLI\.\s*,\s*\.METRE\.\s*\)[^)]*\)\s*;/);
+    if (!siLine) {
+        throw new Error(`[export/step] no SI_UNIT(.MILLI.,.METRE.) entity found; cannot rewrite declaration to ${name}`);
+    }
+    // 3) 替换原 SI_UNIT 实体为 CONVERSION_BASED_UNIT，插入换算因子与基准米实体：
+    //   #si=(LENGTH_UNIT()NAMED_UNIT(*)SI_UNIT(.MILLI.,.METRE.));
+    // → #si=(LENGTH_UNIT()NAMED_UNIT(*)CONVERSION_BASED_UNIT('INCH',#conv));
+    //   #conv=LENGTH_MEASURE_WITH_UNIT(LENGTH_MEASURE(25.4),#len);
+    //   #len=(LENGTH_UNIT()NAMED_UNIT(*)SI_UNIT($,.METRE.));
+    out = out.replace(siLine[0], siLine[0].replace(/SI_UNIT\s*\(\s*\.MILLI\.\s*,\s*\.METRE\.\s*\)/, `CONVERSION_BASED_UNIT('${name}',#${convId})`));
+    // 在 DATA 段结束前（ENDSEC;）插入新实体。
+    const insert = [
+        `#${convId}=LENGTH_MEASURE_WITH_UNIT(LENGTH_MEASURE(${inchFactor}),#${lenId});`,
+        `#${lenId}=(LENGTH_UNIT()NAMED_UNIT(*)SI_UNIT($,.METRE.));`,
+    ].join('\n');
+    out = out.replace(/ENDSEC\s*;/, `${insert}\nENDSEC;`);
+    return out;
+}
+/** 3MF写出：最小 ZIP 容器（deflate），落 3D/3dmodel.model + [Content_Types].xml + _rels。 */
+function build3mfBuffer(modelXml) {
+    const contentTypes = `<?xml version="1.0" encoding="UTF-8"?>
+<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="model" ContentType="application/vnd.ms-package.3dmanufacturing-3dmodel+xml"/></Types>`;
+    const rels = `<?xml version="1.0" encoding="UTF-8"?>
+<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Target="/3D/3dmodel.model" Id="rel0" Type="http://schemas.microsoft.com/3dmanufacturing/2013/01/3dmodel"/></Relationships>`;
+    const zipped = writeZipEntries({
+        '[Content_Types].xml': new TextEncoder().encode(contentTypes),
+        '_rels/.rels': new TextEncoder().encode(rels),
+        '3D/3dmodel.model': new TextEncoder().encode(modelXml),
+    });
+    return zipped.buffer.slice(zipped.byteOffset, zipped.byteOffset + zipped.byteLength);
+}
+/** 组 3MF <model> XML：单位声明与坐标由同一 scale 变量产出（同源，§10.3 规则 3）。 */
+function build3mfModelXml(entries, unit, scale, printConfig) {
+    const unitAttr = UNIT_NAME_TO_3MF[unit];
+    if (!unitAttr) {
+        // 调用方（exportModel）保证 unit 已成对回落；直接到这里 = 内部错误。
+        throw new Error(`[export/3mf] unit ${unit} has no 3MF enum value`);
+    }
+    const objs = [];
+    const items = [];
+    entries.forEach((e, i) => {
+        if (!e.mesh)
+            return;
+        const pos = scalePositions(e.mesh.positions, scale);
+        const verts = [];
+        for (let v = 0; v < pos.length; v += 3) {
+            verts.push(`<vertex x="${pos[v]}" y="${pos[v + 1]}" z="${pos[v + 2]}"/>`);
+        }
+        const tris = [];
+        for (let t = 0; t < e.mesh.indices.length; t += 3) {
+            tris.push(`<triangle v1="${e.mesh.indices[t]}" v2="${e.mesh.indices[t + 1]}" v3="${e.mesh.indices[t + 2]}"/>`);
+        }
+        const colorXml = e.color
+            ? `<basematerials><base name="${e.name ?? 'p' + i}" displaycolor="${hexColor(e.color)}"/></basematerials>`
+            : '';
+        objs.push(`<object id="${i + 1}" type="model" name="${xmlAttr(e.name ?? `part${i + 1}`)}">${colorXml}<mesh><vertices>${verts.join('')}</vertices><triangles>${tris.join('')}</triangles></mesh></object>`);
+        items.push(`<item objectid="${i + 1}"/>`);
+    });
+    const pc = printConfig ? `<metadata name="printConfig">${xmlAttr(String(printConfig))}</metadata>` : '';
+    return `<model unit="${unitAttr}" xml:lang="en-US" xmlns="http://schemas.microsoft.com/3dmanufacturing/core/2015/02">${pc}<resources>${objs.join('')}</resources><build>${items.join('')}</build></model>`;
+}
+function xmlAttr(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+function hexColor(c) {
+    const h = (v) => Math.round(Math.min(1, Math.max(0, v)) * 255).toString(16).padStart(2, '0');
+    return `#${h(c[0])}${h(c[1])}${h(c[2])}FF`;
+}
+/**
+ * Synchronous twin of {@link exportModel} for hosts already holding a live
+ * kernel (CLI, in-process consumers). Same invariants: declared unit ==
+ * written coordinate scale. Only 'stl' / 'step' (3mf is also sync but is
+ * routed through the same code path below).
+ *
+ * @param entries - the shapes to export (BREP solids preferred, mesh fallback).
+ * @param format - output format: 'stl' | 'step' | '3mf'.
+ * @param opts - optional target unit and 3MF print config.
+ * @returns the serialized file bytes (ArrayBuffer).
+ */
+export function exportModelSync(entries, format, opts) {
+    if (entries.length === 0)
+        throw new Error('[export] no exportable entries');
+    let unit = opts?.unit ?? 'mm';
+    if (format === '3mf' && !UNIT_NAME_TO_3MF[unit])
+        unit = 'mm';
+    const scale = 1 / UNIT_SCALE[unit];
+    if (format === 'stl') {
+        const bufs = entries.filter((e) => e.mesh).map((e) => ({ pos: scalePositions(e.mesh.positions, scale), idx: e.mesh.indices }));
+        if (bufs.length === 0)
+            throw new Error('[export/stl] no mesh entries');
+        if (bufs.length === 1)
+            return buildStlBufferFromMesh(bufs[0].pos, bufs[0].idx);
+        const totalTris = bufs.reduce((n, b) => n + b.idx.length / 3, 0);
+        const mergedPos = new Float32Array(bufs.reduce((n, b) => n + b.pos.length, 0));
+        const mergedIdx = new Uint32Array(totalTris * 3);
+        let po = 0;
+        let io2 = 0;
+        let base = 0;
+        for (const b of bufs) {
+            mergedPos.set(b.pos, po);
+            for (let i = 0; i < b.idx.length; i++)
+                mergedIdx[io2++] = b.idx[i] + base;
+            base += b.pos.length / 3;
+            po += b.pos.length;
+        }
+        return buildStlBufferFromMesh(mergedPos, mergedIdx);
+    }
+    if (format === 'step') {
+        const kernel = getBrepApi();
+        const ownedHandles = [];
+        const stepEntries = entries.map((e) => {
+            if (e.solid) {
+                if (scale === 1)
+                    return { solid: e.solid, ...(e.name ? { name: e.name } : {}), ...(e.color ? { color: [...e.color] } : {}) };
+                const scaled = kernel.scale(e.solid, { x: 0, y: 0, z: 0 }, scale);
+                ownedHandles.push(scaled);
+                return { solid: scaled, ...(e.name ? { name: e.name } : {}), ...(e.color ? { color: [...e.color] } : {}) };
+            }
+            return {
+                ...(e.mesh ? { mesh: { positions: scalePositions(e.mesh.positions, scale), indices: e.mesh.indices } } : {}),
+                ...(e.name ? { name: e.name } : {}),
+                ...(e.color ? { color: [...e.color] } : {}),
+            };
+        });
+        let buffer = exportStepFromSolids(kernel, stepEntries);
+        for (const h of ownedHandles) {
+            try {
+                kernel.release(h);
+            }
+            catch { /* already released */ }
+        }
+        if (unit !== 'mm') {
+            const text = new TextDecoder().decode(new Uint8Array(buffer));
+            buffer = new TextEncoder().encode(rewriteStepUnitEntities(text, unit)).buffer;
+        }
+        return buffer;
+    }
+    if (format === '3mf') {
+        return build3mfBuffer(build3mfModelXml(entries, unit, scale, opts?.printConfig));
+    }
+    throw new Error(`[export] unsupported format: ${format}`);
+}
+/**
+ * 统一导出入口：按 format 分派到各写出器。
+ * **内部不变式：写出的坐标刻度 == 文件声明的单位。** 这是本 API 存在的唯一理由。
+ * @param entries - 待导出的几何条目（BREP solid 优先，缺则走 mesh）。
+ * @param format - 输出格式：'stl' | 'step' | '3mf'。
+ * @param opts - 可选的目标单位与 3MF 打印配置。
+ * @returns 文件字节
+ * @throws 目标单位该格式不支持且无法回落时（不静默降级）
+ */
+export async function exportModel(entries, format, opts) {
+    if (entries.length === 0)
+        throw new Error('[export] no exportable entries');
+    let unit = opts?.unit ?? 'mm';
+    // 3MF 枚举回落（§10.3 规则 2）：yard 不在枚举 → 成对回落到 mm（坐标+声明）。
+    if (format === '3mf' && !UNIT_NAME_TO_3MF[unit]) {
+        unit = 'mm';
+    }
+    // scale = 基准值 → 目标单位刻度（fromBase(1, unit, 'length') 的表实现）。
+    const scale = 1 / UNIT_SCALE[unit];
+    if (format === 'stl') {
+        // STL 无声明：坐标按 unit 刻度写出，调用方保证 unit 语义（当前文档单位）。
+        const parts = [];
+        for (const e of entries) {
+            if (!e.mesh)
+                continue; // STL 只吃 mesh；solid 条目由宿主先三角化
+            parts.push(buildStlBufferFromMesh(scalePositions(e.mesh.positions, scale), e.mesh.indices));
+        }
+        if (parts.length === 0)
+            throw new Error('[export/stl] no mesh entries');
+        if (parts.length === 1)
+            return parts[0];
+        // 多 mesh：合并顶点后再写（binary STL 无对象概念，多实体合一个 soup）。
+        const bufs = entries.filter((e) => e.mesh).map((e) => {
+            const pos = scalePositions(e.mesh.positions, scale);
+            return { pos, idx: e.mesh.indices };
+        });
+        const totalTris = bufs.reduce((n, b) => n + b.idx.length / 3, 0);
+        const mergedPos = new Float32Array(bufs.reduce((n, b) => n + b.pos.length, 0));
+        const mergedIdx = new Uint32Array(totalTris * 3);
+        let po = 0;
+        let io2 = 0;
+        let base = 0;
+        for (const b of bufs) {
+            mergedPos.set(b.pos, po);
+            for (let i = 0; i < b.idx.length; i++)
+                mergedIdx[io2++] = b.idx[i] + base;
+            base += b.pos.length / 3;
+            po += b.pos.length;
+        }
+        return buildStlBufferFromMesh(mergedPos, mergedIdx);
+    }
+    if (format === 'step') {
+        // 同一 scale 变量喂两类条目（§10.3 规则 7，修 E4）：mesh 缩放 positions，
+        // solid 用 owned copy 做 kernel.scale —— 不释放调用方缓存里的原句柄。
+        // 先过门禁再取内核（同同步分支：拒绝理由与引擎装配状态无关）。
+        const kernel = (await import('../handle-bridge.js')).getBrepApi();
+        const ownedHandles = [];
+        const stepEntries = entries.map((e) => {
+            if (e.solid) {
+                if (scale === 1)
+                    return { solid: e.solid, ...(e.name ? { name: e.name } : {}), ...(e.color ? { color: [...e.color] } : {}) };
+                const scaled = kernel.scale(e.solid, { x: 0, y: 0, z: 0 }, scale);
+                ownedHandles.push(scaled);
+                return { solid: scaled, ...(e.name ? { name: e.name } : {}), ...(e.color ? { color: [...e.color] } : {}) };
+            }
+            return {
+                ...(e.mesh ? { mesh: { positions: scalePositions(e.mesh.positions, scale), indices: e.mesh.indices } } : {}),
+                ...(e.name ? { name: e.name } : {}),
+                ...(e.color ? { color: [...e.color] } : {}),
+            };
+        });
+        let buffer = exportStepFromSolids(kernel, stepEntries);
+        for (const h of ownedHandles) {
+            try {
+                kernel.release(h);
+            }
+            catch { /* already released */ }
+        }
+        // 文本层只替换单位实体（红线：绝不文本级改坐标——坐标已在几何层缩放）。
+        if (unit !== 'mm') {
+            const text = new TextDecoder().decode(new Uint8Array(buffer));
+            const rewritten = rewriteStepUnitEntities(text, unit);
+            buffer = new TextEncoder().encode(rewritten).buffer;
+        }
+        return buffer;
+    }
+    if (format === '3mf') {
+        return build3mfBuffer(build3mfModelXml(entries, unit, scale, opts?.printConfig));
+    }
+    throw new Error(`[export] unsupported format: ${format}`);
+}
+/**
+ * 导出后回读声明单位（自检与验收用；与 detectStepUnit 互为对偶）。
+ * @param data - the exported file bytes (ArrayBuffer or decoded Uint8Array).
+ * @param format - the format the bytes were produced in.
+ * @returns the declared unit, or null when the format cannot declare one (STL)
+ *   or the declaration cannot be parsed.
+ */
+export function readDeclaredUnit(data, format) {
+    if (format === 'stl')
+        return null;
+    const bytes = data instanceof Uint8Array ? data : new Uint8Array(data);
+    const text = new TextDecoder().decode(bytes).slice(0, STEP_UNIT_SCAN_PREFIX);
+    if (format === '3mf') {
+        const m = text.match(/<model[^>]*\sunit="([^"]+)"/);
+        if (!m)
+            return null;
+        for (const [name, val] of Object.entries(UNIT_NAME_TO_3MF)) {
+            if (val === m[1])
+                return name;
+        }
+        return null;
+    }
+    // step
+    return detectStepUnit(text);
+}
+//# sourceMappingURL=export-model.js.map

package/dist/brep/export/export-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-model.js","sourceRoot":"","sources":["../../../src/brep/export/export-model.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * exportModel — 统一导出入口（unit-system §10.6 二 / R11 / 裁决 J）\n *\n * 单一真源：坐标单位换算与文件单位声明由**同一次换算**产出（§10.3 规则 3），\n * 声明与坐标必须同源。CLI（writeOutput）与宿主（3d_editor）共用本入口。\n *\n * 格式分派（§10.6 表）：\n * - stl：坐标缩放到 unit 刻度，无声明（格式不支持）。\n * - step：预缩放 + 文本层只改写单位实体（§10.3 规则 3a；OCCT 恒写\n *   SI_UNIT(.MILLI.,.METRE.)，坐标预先缩放到目标刻度后声明必须跟上）。\n * - 3mf：坐标缩放到 unit 刻度 + <model unit> 与坐标同源；yard 不在 3MF\n *   枚举 → 成对回落到 mm（§10.3 规则 2）。\n *\n * 红线（§10.3 3a）：绝不文本级改坐标 — 坐标只在几何层缩放，文本层只碰单位实体。\n */\n\nimport { buildStlBufferFromMesh } from './stl'\nimport { writeZipEntries } from '../../io/zip'\nimport { UNIT_SCALE, type UnitName } from '../../units'\nimport type { BrepHandle } from '../engine/types'\nimport type { BrepEngineApi } from '../engine/primitives'\nimport { getBrepApi } from '../handle-bridge'\nimport { exportStepFromSolids, type StepExportEntry } from './step'\nimport { detectStepUnit, STEP_UNIT_SCAN_PREFIX } from '../../mesh/io'\n\n/** 导出条目：一个 part 的几何来源。精确 BREP 与三角网格二选一，solid 优先。 */\nexport interface ExportEntry {\n  /** 精确 BREP 句柄（来自 brep 链，导出 ADVANCED_FACE）。 */\n  solid?: BrepHandle\n  /** 三角网格（基准单位刻度；调用方只做世界变换烘焙，不做单位缩放）。 */\n  mesh?: { positions: Float32Array; indices: Uint32Array }\n  /** 实体名（写 STEP PRODUCT 名 / 3MF <object name>）。 */\n  name?: string\n  /** sRGB 0..1 颜色（STEP 走 XCAF COLOUR_RGB，3MF 走 basematerials）。 */\n  color?: readonly [number, number, number]\n}\n\n/** Output formats supported by the unified {@link exportModel} entry. */\nexport type ExportFormat = 'stl' | 'step' | '3mf'\n\n/**\n * Options controlling {@link exportModel}/{@link exportModelSync} output\n * (unit-system §10.3): the declared target unit and optional 3MF print config.\n */\nexport interface ExportOptions {\n  /**\n   * 目标长度单位。缺省 'mm'。语义是「文件里声明的单位」——\n   * 实现负责把坐标换算到该单位刻度并与声明成对写出（§10.3）。\n   */\n  unit?: UnitName\n  /** 3MF 打印配置（可选，原样进 model 层）。 */\n  printConfig?: unknown\n}\n\n/** UnitName → 3MF <model unit> 枚举全名（唯一真源；yard 无对应值）。 */\nexport const UNIT_NAME_TO_3MF: Partial<Record<UnitName, 'micron' | 'millimeter' | 'centimeter' | 'inch' | 'foot' | 'meter'>> = {\n  mm: 'millimeter',\n  cm: 'centimeter',\n  m: 'meter',\n  micron: 'micron',\n  inch: 'inch',\n  foot: 'foot',\n  // yard 无 3MF 枚举值 — 调用方必须先成对回落到 mm（§10.3 规则 2）。\n}\n\n/** 缩放 Float32 positions 到目标单位刻度（基准值 ÷ unitScale(unit)）。 */\nfunction scalePositions(positions: Float32Array, scale: number): Float32Array {\n  if (scale === 1) return positions\n  const out = new Float32Array(positions.length)\n  for (let i = 0; i < positions.length; i++) out[i] = positions[i] * scale\n  return out\n}\n\n/** STEP 单位声明改写：SI_UNIT(.MILLI.,.METRE.) → 目标单位实体（只碰单位实体，红线）。 */\nfunction rewriteStepUnitEntities(stepText: string, unit: UnitName): string {\n  // mm 是 OCCT 的原生写出形态，无需改写。\n  if (unit === 'mm') return stepText\n\n  // SI 面积/体积单位实体的前缀同样要跟着换（LENGTH/AREA/VOLUME 挂同一前缀链），\n  // 但坐标已缩放 → 只需把 LENGTH 链上的前缀换掉；面积/体积单位在 STEP 里由\n  // SI_UNIT 前缀 + 幂次表达，XCAF 写出的实体形态是 SI_UNIT(.MILLI.,.METRE.)\n  // 挂在长度、平方与立方三条依赖链上。为保守起见只改写显式 LENGTH_UNIT 链上的\n  // SI_UNIT —— 具体做法：全局替换 SI_UNIT 前缀（同一文件里坐标相关单位恒为\n  // 长度链；角度 SI_UNIT(.RADIAN.) 不含 METRE 不会被命中）。\n  let out = stepText\n\n  if (unit === 'cm' || unit === 'm' || unit === 'micron') {\n    const prefix = unit === 'cm' ? '.CENTI.' : unit === 'm' ? '$' : '.MICRO.'\n    // OCCT 写出恒为 SI_UNIT(.MILLI.,.METRE.)（实测）；$ 前缀形态（无前缀=米）\n    // 在 OCCT 输出中不会出现，但容错处理（若上游将来变化）。\n    out = out.replace(/SI_UNIT\\s*\\(\\s*\\.MILLI\\.\\s*,\\s*\\.METRE\\.\\s*\\)/g,\n      prefix === '$' ? 'SI_UNIT($,.METRE.)' : `SI_UNIT(${prefix},.METRE.)`)\n    return out\n  }\n\n  // inch / foot：CONVERSION_BASED_UNIT 形态。需要注入换算因子实体并替换\n  // LENGTH_UNIT 依赖。最简形态：把 SI_UNIT(.MILLI.,.METRE.) 替换为\n  // CONVERSION_BASED_UNIT('INCH', #factor)，并附加 MEASURE_WITH_UNIT 实体。\n  // 实体编号：取文件内最大 #n + 1、+2（附加实体挂在文件尾部 DATA 段内合法）。\n  const inchFactor = unit === 'inch' ? 25.4 : 304.8\n  const name = unit === 'inch' ? 'INCH' : 'FOOT'\n\n  // 1) 收集现有最大实体编号\n  let maxId = 0\n  for (const m of out.matchAll(/#(\\d+)\\s*=/g)) {\n    const id = Number(m[1])\n    if (id > maxId) maxId = id\n  }\n  const lenId = maxId + 1\n  const convId = maxId + 2\n\n  // 2) 找到 LENGTH_UNIT() 里挂 SI_UNIT 的实体行，替换为 CONVERSION_BASED_UNIT\n  //    并把 SI_UNIT 挂到 LENGTH_MEASURE 上。OCCT 输出形态（实测）：\n  //    #n=(LENGTH_UNIT()NAMED_UNIT(*)SI_UNIT(.MILLI.,.METRE.));\n  const siLine = out.match(/#(\\d+)\\s*=\\s*\\([^)]*SI_UNIT\\s*\\(\\s*\\.MILLI\\.\\s*,\\s*\\.METRE\\.\\s*\\)[^)]*\\)\\s*;/)\n  if (!siLine) {\n    throw new Error(`[export/step] no SI_UNIT(.MILLI.,.METRE.) entity found; cannot rewrite declaration to ${name}`)\n  }\n\n  // 3) 替换原 SI_UNIT 实体为 CONVERSION_BASED_UNIT，插入换算因子与基准米实体：\n  //   #si=(LENGTH_UNIT()NAMED_UNIT(*)SI_UNIT(.MILLI.,.METRE.));\n  // → #si=(LENGTH_UNIT()NAMED_UNIT(*)CONVERSION_BASED_UNIT('INCH',#conv));\n  //   #conv=LENGTH_MEASURE_WITH_UNIT(LENGTH_MEASURE(25.4),#len);\n  //   #len=(LENGTH_UNIT()NAMED_UNIT(*)SI_UNIT($,.METRE.));\n  out = out.replace(siLine[0], siLine[0].replace(/SI_UNIT\\s*\\(\\s*\\.MILLI\\.\\s*,\\s*\\.METRE\\.\\s*\\)/, `CONVERSION_BASED_UNIT('${name}',#${convId})`))\n  // 在 DATA 段结束前（ENDSEC;）插入新实体。\n  const insert = [\n    `#${convId}=LENGTH_MEASURE_WITH_UNIT(LENGTH_MEASURE(${inchFactor}),#${lenId});`,\n    `#${lenId}=(LENGTH_UNIT()NAMED_UNIT(*)SI_UNIT($,.METRE.));`,\n  ].join('\\n')\n  out = out.replace(/ENDSEC\\s*;/, `${insert}\\nENDSEC;`)\n  return out\n}\n\n/** 3MF写出：最小 ZIP 容器（deflate），落 3D/3dmodel.model + [Content_Types].xml + _rels。 */\nfunction build3mfBuffer(modelXml: string): ArrayBuffer {\n  const contentTypes = `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Types xmlns=\"http://schemas.openxmlformats.org/package/2006/content-types\"><Default Extension=\"rels\" ContentType=\"application/vnd.openxmlformats-package.relationships+xml\"/><Default Extension=\"model\" ContentType=\"application/vnd.ms-package.3dmanufacturing-3dmodel+xml\"/></Types>`\n  const rels = `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\"><Relationship Target=\"/3D/3dmodel.model\" Id=\"rel0\" Type=\"http://schemas.microsoft.com/3dmanufacturing/2013/01/3dmodel\"/></Relationships>`\n\n  const zipped = writeZipEntries({\n    '[Content_Types].xml': new TextEncoder().encode(contentTypes),\n    '_rels/.rels': new TextEncoder().encode(rels),\n    '3D/3dmodel.model': new TextEncoder().encode(modelXml),\n  })\n  return zipped.buffer.slice(zipped.byteOffset, zipped.byteOffset + zipped.byteLength) as ArrayBuffer\n}\n\n/** 组 3MF <model> XML：单位声明与坐标由同一 scale 变量产出（同源，§10.3 规则 3）。 */\nfunction build3mfModelXml(entries: ExportEntry[], unit: UnitName, scale: number, printConfig?: unknown): string {\n  const unitAttr = UNIT_NAME_TO_3MF[unit]\n  if (!unitAttr) {\n    // 调用方（exportModel）保证 unit 已成对回落；直接到这里 = 内部错误。\n    throw new Error(`[export/3mf] unit ${unit} has no 3MF enum value`)\n  }\n  const objs: string[] = []\n  const items: string[] = []\n  entries.forEach((e, i) => {\n    if (!e.mesh) return\n    const pos = scalePositions(e.mesh.positions, scale)\n    const verts: string[] = []\n    for (let v = 0; v < pos.length; v += 3) {\n      verts.push(`<vertex x=\"${pos[v]}\" y=\"${pos[v + 1]}\" z=\"${pos[v + 2]}\"/>`)\n    }\n    const tris: string[] = []\n    for (let t = 0; t < e.mesh.indices.length; t += 3) {\n      tris.push(`<triangle v1=\"${e.mesh.indices[t]}\" v2=\"${e.mesh.indices[t + 1]}\" v3=\"${e.mesh.indices[t + 2]}\"/>`)\n    }\n    const colorXml = e.color\n      ? `<basematerials><base name=\"${e.name ?? 'p' + i}\" displaycolor=\"${hexColor(e.color)}\"/></basematerials>`\n      : ''\n    objs.push(`<object id=\"${i + 1}\" type=\"model\" name=\"${xmlAttr(e.name ?? `part${i + 1}`)}\">${colorXml}<mesh><vertices>${verts.join('')}</vertices><triangles>${tris.join('')}</triangles></mesh></object>`)\n    items.push(`<item objectid=\"${i + 1}\"/>`)\n  })\n  const pc = printConfig ? `<metadata name=\"printConfig\">${xmlAttr(String(printConfig))}</metadata>` : ''\n  return `<model unit=\"${unitAttr}\" xml:lang=\"en-US\" xmlns=\"http://schemas.microsoft.com/3dmanufacturing/core/2015/02\">${pc}<resources>${objs.join('')}</resources><build>${items.join('')}</build></model>`\n}\n\nfunction xmlAttr(s: string): string {\n  return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/\"/g, '&quot;')\n}\n\nfunction hexColor(c: readonly [number, number, number]): string {\n  const h = (v: number) => Math.round(Math.min(1, Math.max(0, v)) * 255).toString(16).padStart(2, '0')\n  return `#${h(c[0])}${h(c[1])}${h(c[2])}FF`\n}\n\n/**\n * Synchronous twin of {@link exportModel} for hosts already holding a live\n * kernel (CLI, in-process consumers). Same invariants: declared unit ==\n * written coordinate scale. Only 'stl' / 'step' (3mf is also sync but is\n * routed through the same code path below).\n *\n * @param entries - the shapes to export (BREP solids preferred, mesh fallback).\n * @param format - output format: 'stl' | 'step' | '3mf'.\n * @param opts - optional target unit and 3MF print config.\n * @returns the serialized file bytes (ArrayBuffer).\n */\nexport function exportModelSync(\n  entries: ExportEntry[],\n  format: ExportFormat,\n  opts?: ExportOptions,\n): ArrayBuffer {\n  if (entries.length === 0) throw new Error('[export] no exportable entries')\n\n  let unit = opts?.unit ?? 'mm'\n  if (format === '3mf' && !UNIT_NAME_TO_3MF[unit]) unit = 'mm'\n  const scale = 1 / UNIT_SCALE[unit]\n\n  if (format === 'stl') {\n    const bufs = entries.filter((e) => e.mesh).map((e) => ({ pos: scalePositions(e.mesh!.positions, scale), idx: e.mesh!.indices }))\n    if (bufs.length === 0) throw new Error('[export/stl] no mesh entries')\n    if (bufs.length === 1) return buildStlBufferFromMesh(bufs[0]!.pos, bufs[0]!.idx)\n    const totalTris = bufs.reduce((n, b) => n + b.idx.length / 3, 0)\n    const mergedPos = new Float32Array(bufs.reduce((n, b) => n + b.pos.length, 0))\n    const mergedIdx = new Uint32Array(totalTris * 3)\n    let po = 0\n    let io2 = 0\n    let base = 0\n    for (const b of bufs) {\n      mergedPos.set(b.pos, po)\n      for (let i = 0; i < b.idx.length; i++) mergedIdx[io2++] = b.idx[i] + base\n      base += b.pos.length / 3\n      po += b.pos.length\n    }\n    return buildStlBufferFromMesh(mergedPos, mergedIdx)\n  }\n\n  if (format === 'step') {\n    const kernel = getBrepApi()\n    const ownedHandles: BrepHandle[] = []\n    const stepEntries: StepExportEntry[] = entries.map((e) => {\n      if (e.solid) {\n        if (scale === 1) return { solid: e.solid, ...(e.name ? { name: e.name } : {}), ...(e.color ? { color: [...e.color] as [number, number, number] } : {}) }\n        const scaled = kernel.scale(e.solid, { x: 0, y: 0, z: 0 }, scale)\n        ownedHandles.push(scaled)\n        return { solid: scaled, ...(e.name ? { name: e.name } : {}), ...(e.color ? { color: [...e.color] as [number, number, number] } : {}) }\n      }\n      return {\n        ...(e.mesh ? { mesh: { positions: scalePositions(e.mesh.positions, scale), indices: e.mesh.indices } } : {}),\n        ...(e.name ? { name: e.name } : {}),\n        ...(e.color ? { color: [...e.color] as [number, number, number] } : {}),\n      }\n    })\n    let buffer = exportStepFromSolids(kernel, stepEntries)\n    for (const h of ownedHandles) {\n      try { kernel.release(h) } catch { /* already released */ }\n    }\n    if (unit !== 'mm') {\n      const text = new TextDecoder().decode(new Uint8Array(buffer))\n      buffer = new TextEncoder().encode(rewriteStepUnitEntities(text, unit)).buffer\n    }\n    return buffer\n  }\n\n  if (format === '3mf') {\n    return build3mfBuffer(build3mfModelXml(entries, unit, scale, opts?.printConfig))\n  }\n\n  throw new Error(`[export] unsupported format: ${format}`)\n}\n\n/**\n * 统一导出入口：按 format 分派到各写出器。\n * **内部不变式：写出的坐标刻度 == 文件声明的单位。** 这是本 API 存在的唯一理由。\n * @param entries - 待导出的几何条目（BREP solid 优先，缺则走 mesh）。\n * @param format - 输出格式：'stl' | 'step' | '3mf'。\n * @param opts - 可选的目标单位与 3MF 打印配置。\n * @returns 文件字节\n * @throws 目标单位该格式不支持且无法回落时（不静默降级）\n */\nexport async function exportModel(\n  entries: ExportEntry[],\n  format: ExportFormat,\n  opts?: ExportOptions,\n): Promise<ArrayBuffer> {\n  if (entries.length === 0) throw new Error('[export] no exportable entries')\n\n  let unit = opts?.unit ?? 'mm'\n\n  // 3MF 枚举回落（§10.3 规则 2）：yard 不在枚举 → 成对回落到 mm（坐标+声明）。\n  if (format === '3mf' && !UNIT_NAME_TO_3MF[unit]) {\n    unit = 'mm'\n  }\n\n  // scale = 基准值 → 目标单位刻度（fromBase(1, unit, 'length') 的表实现）。\n  const scale = 1 / UNIT_SCALE[unit]\n\n  if (format === 'stl') {\n    // STL 无声明：坐标按 unit 刻度写出，调用方保证 unit 语义（当前文档单位）。\n    const parts: ArrayBuffer[] = []\n    for (const e of entries) {\n      if (!e.mesh) continue // STL 只吃 mesh；solid 条目由宿主先三角化\n      parts.push(buildStlBufferFromMesh(scalePositions(e.mesh.positions, scale), e.mesh.indices))\n    }\n    if (parts.length === 0) throw new Error('[export/stl] no mesh entries')\n    if (parts.length === 1) return parts[0]!\n    // 多 mesh：合并顶点后再写（binary STL 无对象概念，多实体合一个 soup）。\n    const bufs = entries.filter((e) => e.mesh).map((e) => {\n      const pos = scalePositions(e.mesh!.positions, scale)\n      return { pos, idx: e.mesh!.indices }\n    })\n    const totalTris = bufs.reduce((n, b) => n + b.idx.length / 3, 0)\n    const mergedPos = new Float32Array(bufs.reduce((n, b) => n + b.pos.length, 0))\n    const mergedIdx = new Uint32Array(totalTris * 3)\n    let po = 0\n    let io2 = 0\n    let base = 0\n    for (const b of bufs) {\n      mergedPos.set(b.pos, po)\n      for (let i = 0; i < b.idx.length; i++) mergedIdx[io2++] = b.idx[i] + base\n      base += b.pos.length / 3\n      po += b.pos.length\n    }\n    return buildStlBufferFromMesh(mergedPos, mergedIdx)\n  }\n\n  if (format === 'step') {\n    // 同一 scale 变量喂两类条目（§10.3 规则 7，修 E4）：mesh 缩放 positions，\n    // solid 用 owned copy 做 kernel.scale —— 不释放调用方缓存里的原句柄。\n    // 先过门禁再取内核（同同步分支：拒绝理由与引擎装配状态无关）。\n    const kernel = (await import('../handle-bridge')).getBrepApi() as BrepEngineApi\n    const ownedHandles: BrepHandle[] = []\n    const stepEntries: StepExportEntry[] = entries.map((e) => {\n      if (e.solid) {\n        if (scale === 1) return { solid: e.solid, ...(e.name ? { name: e.name } : {}), ...(e.color ? { color: [...e.color] as [number, number, number] } : {}) }\n        const scaled = kernel.scale(e.solid, { x: 0, y: 0, z: 0 }, scale)\n        ownedHandles.push(scaled)\n        return { solid: scaled, ...(e.name ? { name: e.name } : {}), ...(e.color ? { color: [...e.color] as [number, number, number] } : {}) }\n      }\n      return {\n        ...(e.mesh ? { mesh: { positions: scalePositions(e.mesh.positions, scale), indices: e.mesh.indices } } : {}),\n        ...(e.name ? { name: e.name } : {}),\n        ...(e.color ? { color: [...e.color] as [number, number, number] } : {}),\n      }\n    })\n    let buffer = exportStepFromSolids(kernel, stepEntries)\n    for (const h of ownedHandles) {\n      try { kernel.release(h) } catch { /* already released */ }\n    }\n    // 文本层只替换单位实体（红线：绝不文本级改坐标——坐标已在几何层缩放）。\n    if (unit !== 'mm') {\n      const text = new TextDecoder().decode(new Uint8Array(buffer))\n      const rewritten = rewriteStepUnitEntities(text, unit)\n      buffer = new TextEncoder().encode(rewritten).buffer\n    }\n    return buffer\n  }\n\n  if (format === '3mf') {\n    return build3mfBuffer(build3mfModelXml(entries, unit, scale, opts?.printConfig))\n  }\n\n  throw new Error(`[export] unsupported format: ${format}`)\n}\n\n/**\n * 导出后回读声明单位（自检与验收用；与 detectStepUnit 互为对偶）。\n * @param data - the exported file bytes (ArrayBuffer or decoded Uint8Array).\n * @param format - the format the bytes were produced in.\n * @returns the declared unit, or null when the format cannot declare one (STL)\n *   or the declaration cannot be parsed.\n */\nexport function readDeclaredUnit(data: ArrayBuffer | Uint8Array, format: ExportFormat): UnitName | null {\n  if (format === 'stl') return null\n  const bytes = data instanceof Uint8Array ? data : new Uint8Array(data)\n  const text = new TextDecoder().decode(bytes).slice(0, STEP_UNIT_SCAN_PREFIX)\n\n  if (format === '3mf') {\n    const m = text.match(/<model[^>]*\\sunit=\"([^\"]+)\"/)\n    if (!m) return null\n    for (const [name, val] of Object.entries(UNIT_NAME_TO_3MF)) {\n      if (val === m[1]) return name as UnitName\n    }\n    return null\n  }\n\n  // step\n  return detectStepUnit(text)\n}\n"]}

package/dist/brep/face-evolution.d.ts

@@ -168,7 +168,7 @@ export declare function scaleWithHashEvolution(kernel: BrepEngineApi, shape: Bre
     evolution: HashEvolution;
 };
 /**
- * 双输入布尔 + roleTable 合流组合封装（§3.4，stdlib boolean 链式调用用）。
+ * 双输入布尔 + roleTable 合流组合封装（§3.4，api boolean 链式调用用）。
  *
  * 一次 *WithHistory 内核调用同时产出：
  * - result：结果实体

package/dist/brep/face-evolution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"face-evolution.d.ts","sourceRoot":"","sources":["../../src/brep/face-evolution.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"face-evolution.d.ts","sourceRoot":"","sources":["../../src/brep/face-evolution.ts"],"names":[],"mappings":"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"}

package/dist/brep/face-evolution.js

@@ -231,7 +231,7 @@ export function scaleWithHashEvolution(kernel, shape, center, factor) {
     return { result: evo.result, evolution: decodeHashEvolution(evo) };
 }
 /**
- * 双输入布尔 + roleTable 合流组合封装（§3.4，stdlib boolean 链式调用用）。
+ * 双输入布尔 + roleTable 合流组合封装（§3.4，api boolean 链式调用用）。
  *
  * 一次 *WithHistory 内核调用同时产出：
  * - result：结果实体
@@ -266,6 +266,25 @@ export function booleanWithRoleTable(kernel, op, a, b, tableA, tableB, outStmt)
     const hashesB = getFaceHashes(kernel, b);
     const { a: evoA, b: evoB } = splitHashEvolutionByOrigin(evo, hashesA, hashesB);
     const merged = mergeRoleTablesLocal(tableA, evoA, tableB, evoB, outStmt);
+    // G 组（2026-10-03，Flapper LHS 语料）：fuse 的接缝面（两半挤出 union 时
+    // 共享平面被 BOP 重建的面）既不属于 A 也不属于 B 的血缘，merge 后无 role —
+    // 下游 edgeRef/fillet 查邻面时报 "no role lineage"（face-evolution 注释里
+    // 一直挂着的 "seam faces are a Phase 4+ concern" 正是本盲区）。把不属于任何
+    // 已知血缘的结果面登记为新 origin（本次语句）的 `seam` 角色——血缘真实
+    // （该面确实诞生于本次布尔），不是伪造映射。
+    if (op === 'fuse') {
+        const covered = new Set();
+        for (const roles of merged.values()) {
+            for (const hs of roles.values()) {
+                for (const h of hs)
+                    covered.add(h);
+            }
+        }
+        const seamHashes = getFaceHashes(kernel, evo.result).filter((h) => !covered.has(h));
+        if (seamHashes.length > 0) {
+            merged.set(outStmt, new Map([['seam', seamHashes]]));
+        }
+    }
     return { result: evo.result, faceEvolution, roleTable: merged };
 }
 /** 合表（避免 naming/roles 循环依赖：本文件不 import naming，用结构等价实现）。 */