@faicad/faijs 0.22.2 → 0.29.5

package/dist/brep/export/step-meta-header.d.ts

@@ -0,0 +1,102 @@
+/**
+ * STEP 文件级元数据 → P21 header 重写（`FILE_NAME`/`FILE_DESCRIPTION`）。
+ *
+ * 独立成模块使 `export-model.ts`（ExportModel 入口）与 `step.ts`
+ * （exportStepFromSolids）都能复用，避免 `export-model → export → export-model`
+ * 的循环依赖：本模块只依赖 `../../api/meta` 的 `FileMeta` 类型（type-only）。
+ *
+ * 设计文档 2026-10-05-meta §6.2 第 6 步：`exportModel` 已有 SI_UNIT 声明重写的先例
+ * ——同样只对 header 里 FILE_NAME(...)/FILE_DESCRIPTION(...) 行做文本替换，绝不碰
+ * DATA 段几何实体（红线 §10.3 3a：文本层只改声明/元数据，坐标不动）。
+ *
+ * FILE_NAME(name, time_stamp, author, organization, preprocessor_version, ...)
+ * FILE_DESCRIPTION(description_list, implementation_level)
+ * 映射（§3.3）：title→name, creationDate→time_stamp, designer/author→author,
+ * organization→organization, application→preprocessor, description→description。
+ * 无对应位置的字段（copyright/licenseTerms/rating/modificationDate）**不写**
+ * （STEP 无标准位置，不发明）。
+ *
+ * 宽容失败：找不到 FILE_NAME/FILE_DESCRIPTION 行则留空（P21 头由内核写出，形态
+ * 已知为 `FILE_DESCRIPTION(('Open CASCADE Model'),'2;1');` 一行，但在字符串内）。
+ */
+import type { FileMeta } from '../../api/meta.js';
+/**
+ * FileMeta 是否含可映射到 STEP header 的字段（避免对无 header 字段的 fileMeta
+ * 做无谓解码重写）。
+ *
+ * @param f 文件级元数据；undefined 视为无 header 字段。
+ * @returns 存在任一可映射字段时为 true。
+ */
+export declare function fileMetaHasHeaderFields(f: FileMeta | undefined): boolean;
+/**
+ * STEP 文件级元数据 → P21 header 重写：仅碰 `FILE_NAME`/`FILE_DESCRIPTION` 两处
+ * 标准实体，其余文本（含 DATA 段几何）原样保留。
+ *
+ * @param stepText 内核产出的 STEP 全文（ISO-10303-21）。
+ * @param fileMeta 目标文件级元数据。
+ * @returns 改写后的 STEP 文本。
+ */
+export declare function rewriteStepHeader(stepText: string, fileMeta: FileMeta): string;
+/**
+ * 用 replacement 替换字符串 [start, end) 区间，返回新字符串（不可变，纯函数）。
+ *
+ * @param s 原始字符串。
+ * @param start 替换区起始偏移（含）。
+ * @param end 替换区结束偏移（不含）。
+ * @param replacement 替换内容。
+ * @returns 替换后的新字符串。
+ */
+export declare function splice(s: string, start: number, end: number, replacement: string): string;
+/**
+ * 旧名别名：正文使用 {@link rewriteStepHeader}。保留导出以免破坏既有调用/test 引用。
+ *
+ * @param stepText 内核产出的 STEP 全文（ISO-10303-21）。
+ * @param fileMeta 目标文件级元数据。
+ * @returns 改写后的 STEP 文本。
+ */
+export declare const rewriteFileMetaHeader: (stepText: string, fileMeta: FileMeta) => string;
+/**
+ * 在文本中定位 `NAME(` … 匹配的 `)` （引号忽略、内层括号计入）并返回
+ * `{ start, end, inner }`；找不到返回 null。start/end 是 `NAME(` 起始/闭合 `)` 之后
+ * 一位的偏移，供调用方做字符串拼接替换（不做正则整行匹配——行内可含 `;` 等字符）。
+ *
+ * @param text 待搜索的 STEP 全文。
+ * @param name 实体名（如 `FILE_NAME`），大小写敏感。
+ * @returns 匹配区间 `{ start, end, inner }`；未找到时 null。
+ */
+export declare function matchEntity(text: string, name: string): {
+    start: number;
+    end: number;
+    inner: string;
+} | null;
+/** 把一层参数（逗号分隔，忽略括号与字符串内的逗号）拆分（trim，原样保留字面量）。 */
+/**
+ * 把一层 P21 参数（逗号分隔，忽略括号与字符串内的逗号）拆成数组；每项 trim，
+ * 字符串字面量原样保留（不做解引号）。
+ *
+ * @param inner 实体括号内、不含首尾括号的原文（如 `matchEntity` 返回的 `inner`）。
+ * @returns 拆解后的参数数组（可能为空数组）。
+ */
+export declare function splitP21Params(inner: string): string[];
+/**
+ * 单个 P21 字符串字面量的未转义内容（剥离包裹引号与 `''` 转义）。
+ *
+ * @param p 可能带包裹引号的 P21 字符串字面量（含 trim），或 undefined。
+ * @returns 未转义内容；非字面量/undefined 时返回 undefined。
+ */
+export declare function paramStr(p: string | undefined): string | undefined;
+/**
+ * 单个 P21 字符串字面量（已转义）。
+ *
+ * @param v 原始字符串内容（未转义）。
+ * @returns 包裹单引号并按 P21 规则转义后的字面量（如 `'a''b'`）。
+ */
+export declare function stepStr(v: string): string;
+/**
+ * P21 列表字面量：把多项字符串转为带外层圆括号的字面量列表。
+ *
+ * @param items 待序列化的字符串数组。
+ * @returns 形如 `('a','b')` 的 P21 列表字面量。
+ */
+export declare function p21List(items: string[]): string;
+//# sourceMappingURL=step-meta-header.d.ts.map

package/dist/brep/export/step-meta-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-meta-header.d.ts","sourceRoot":"","sources":["../../../src/brep/export/step-meta-header.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAIxE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CA6C9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,MAA0B,CAAA;AAExG;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsB5G;AAED,gDAAgD;AAChD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BtD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIlE;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAE/C"}

package/dist/brep/export/step-meta-header.js

@@ -0,0 +1,225 @@
+/**
+ * STEP 文件级元数据 → P21 header 重写（`FILE_NAME`/`FILE_DESCRIPTION`）。
+ *
+ * 独立成模块使 `export-model.ts`（ExportModel 入口）与 `step.ts`
+ * （exportStepFromSolids）都能复用，避免 `export-model → export → export-model`
+ * 的循环依赖：本模块只依赖 `../../api/meta` 的 `FileMeta` 类型（type-only）。
+ *
+ * 设计文档 2026-10-05-meta §6.2 第 6 步：`exportModel` 已有 SI_UNIT 声明重写的先例
+ * ——同样只对 header 里 FILE_NAME(...)/FILE_DESCRIPTION(...) 行做文本替换，绝不碰
+ * DATA 段几何实体（红线 §10.3 3a：文本层只改声明/元数据，坐标不动）。
+ *
+ * FILE_NAME(name, time_stamp, author, organization, preprocessor_version, ...)
+ * FILE_DESCRIPTION(description_list, implementation_level)
+ * 映射（§3.3）：title→name, creationDate→time_stamp, designer/author→author,
+ * organization→organization, application→preprocessor, description→description。
+ * 无对应位置的字段（copyright/licenseTerms/rating/modificationDate）**不写**
+ * （STEP 无标准位置，不发明）。
+ *
+ * 宽容失败：找不到 FILE_NAME/FILE_DESCRIPTION 行则留空（P21 头由内核写出，形态
+ * 已知为 `FILE_DESCRIPTION(('Open CASCADE Model'),'2;1');` 一行，但在字符串内）。
+ */
+/**
+ * FileMeta 是否含可映射到 STEP header 的字段（避免对无 header 字段的 fileMeta
+ * 做无谓解码重写）。
+ *
+ * @param f 文件级元数据；undefined 视为无 header 字段。
+ * @returns 存在任一可映射字段时为 true。
+ */
+export function fileMetaHasHeaderFields(f) {
+    if (!f)
+        return false;
+    return !!(f.title || f.description || f.designer || f.author || f.organization || f.application
+        || f.creationDate || f.modificationDate);
+}
+/**
+ * STEP 文件级元数据 → P21 header 重写：仅碰 `FILE_NAME`/`FILE_DESCRIPTION` 两处
+ * 标准实体，其余文本（含 DATA 段几何）原样保留。
+ *
+ * @param stepText 内核产出的 STEP 全文（ISO-10303-21）。
+ * @param fileMeta 目标文件级元数据。
+ * @returns 改写后的 STEP 文本。
+ */
+export function rewriteStepHeader(stepText, fileMeta) {
+    let out = stepText;
+    const title = fileMeta.title && fileMeta.title.length > 0 ? fileMeta.title : undefined;
+    const ts = fileMeta.creationDate && fileMeta.creationDate.length > 0
+        ? fileMeta.creationDate
+        : (fileMeta.modificationDate && fileMeta.modificationDate.length > 0 ? fileMeta.modificationDate : undefined);
+    const authorList = fileMeta.author && fileMeta.author.length > 0 ? [fileMeta.author] : [];
+    const org = fileMeta.organization && fileMeta.organization.length > 0 ? fileMeta.organization : undefined;
+    const preproc = fileMeta.application && fileMeta.application.length > 0 ? fileMeta.application : undefined;
+    const designer = fileMeta.designer && fileMeta.designer.length > 0 ? fileMeta.designer : undefined;
+    const desc = fileMeta.description && fileMeta.description.length > 0 ? fileMeta.description : undefined;
+    // 1) FILE_NAME（用平衡括号/引号感知的枚举，整块替换 —— 逐参安全，不依赖行结构）。
+    const fn = matchEntity(out, 'FILE_NAME');
+    if (fn) {
+        const params = splitP21Params(fn.inner);
+        const next = [];
+        if (title !== undefined || ts !== undefined || authorList.length > 0 || org !== undefined || preproc !== undefined || designer !== undefined) {
+            next.push(stepStr(title ?? paramStr(params[0]) ?? 'STEP File'));
+            next.push(stepStr(ts ?? paramStr(params[1]) ?? ''));
+            next.push(authorList.length > 0 ? p21List(authorList) : (params[2] ?? "('')"));
+            next.push(org !== undefined ? p21List([org]) : (params[3] ?? "('')"));
+            // 保留内核写出的后续参数原样（preprocessor_version / originating_system /
+            // authorisation）——FILE_NAME 可带 6..7 参，不丢既有值。
+            next.push(preproc !== undefined ? stepStr(preproc) : (params[4] ?? ''));
+            next.push(designer !== undefined ? stepStr(designer) : (params[5] ?? ''));
+            for (let i = 6; i < params.length; i++)
+                next.push(params[i]);
+            // 末尾空参保留则拼 ',' 会使整行以 ',' 结尾 → 过滤空的尾部。
+            while (next.length > 0 && next[next.length - 1] === '')
+                next.pop();
+            out = splice(out, fn.start, fn.end, `FILE_NAME(${next.join(',')})`);
+        }
+    }
+    // 2) FILE_DESCRIPTION(description_list, implementation_level)：替换描述列表。
+    const fd = matchEntity(out, 'FILE_DESCRIPTION');
+    if (fd) {
+        const params = splitP21Params(fd.inner);
+        if (desc !== undefined && params.length > 0) {
+            const impl = params[params.length - 1];
+            out = splice(out, fd.start, fd.end, `FILE_DESCRIPTION((${stepStr(desc)}),${impl})`);
+        }
+    }
+    return out;
+}
+/**
+ * 用 replacement 替换字符串 [start, end) 区间，返回新字符串（不可变，纯函数）。
+ *
+ * @param s 原始字符串。
+ * @param start 替换区起始偏移（含）。
+ * @param end 替换区结束偏移（不含）。
+ * @param replacement 替换内容。
+ * @returns 替换后的新字符串。
+ */
+export function splice(s, start, end, replacement) {
+    return s.slice(0, start) + replacement + s.slice(end);
+}
+/**
+ * 旧名别名：正文使用 {@link rewriteStepHeader}。保留导出以免破坏既有调用/test 引用。
+ *
+ * @param stepText 内核产出的 STEP 全文（ISO-10303-21）。
+ * @param fileMeta 目标文件级元数据。
+ * @returns 改写后的 STEP 文本。
+ */
+export const rewriteFileMetaHeader = rewriteStepHeader;
+/**
+ * 在文本中定位 `NAME(` … 匹配的 `)` （引号忽略、内层括号计入）并返回
+ * `{ start, end, inner }`；找不到返回 null。start/end 是 `NAME(` 起始/闭合 `)` 之后
+ * 一位的偏移，供调用方做字符串拼接替换（不做正则整行匹配——行内可含 `;` 等字符）。
+ *
+ * @param text 待搜索的 STEP 全文。
+ * @param name 实体名（如 `FILE_NAME`），大小写敏感。
+ * @returns 匹配区间 `{ start, end, inner }`；未找到时 null。
+ */
+export function matchEntity(text, name) {
+    const re = new RegExp(`${name}\\s*\\(`);
+    const m = re.exec(text);
+    if (!m)
+        return null;
+    const start = m.index;
+    const head = m.index + m[0].length;
+    let depth = 1;
+    let i = head;
+    for (; i < text.length && depth > 0; i++) {
+        const c = text[i];
+        if (c === `'`) {
+            // 跳过字符串字面量（含 ISO10303-21 双引号转义）
+            i++;
+            while (i < text.length) {
+                if (text[i] === `'` && text[i + 1] === `'`) {
+                    i += 2;
+                    continue;
+                }
+                if (text[i] === `'`)
+                    break;
+                i++;
+            }
+        }
+        else if (c === '(')
+            depth++;
+        else if (c === ')')
+            depth--;
+    }
+    return { start, end: i - 1, inner: text.slice(head, i - 1) };
+}
+/** 把一层参数（逗号分隔，忽略括号与字符串内的逗号）拆分（trim，原样保留字面量）。 */
+/**
+ * 把一层 P21 参数（逗号分隔，忽略括号与字符串内的逗号）拆成数组；每项 trim，
+ * 字符串字面量原样保留（不做解引号）。
+ *
+ * @param inner 实体括号内、不含首尾括号的原文（如 `matchEntity` 返回的 `inner`）。
+ * @returns 拆解后的参数数组（可能为空数组）。
+ */
+export function splitP21Params(inner) {
+    const out = [];
+    let cur = '';
+    let depth = 0;
+    for (let i = 0; i < inner.length; i++) {
+        const c = inner[i];
+        if (c === `'`) {
+            // 字符串字面量：整体吸收（含 ISO10303-21 转义 ''），不拆其内逗号/括号。
+            const start = i;
+            i++;
+            while (i < inner.length) {
+                if (inner[i] === `'` && inner[i + 1] === `'`) {
+                    i += 2;
+                    continue;
+                }
+                if (inner[i] === `'`) {
+                    i++;
+                    break;
+                }
+                i++;
+            }
+            cur += inner.slice(start, i);
+            i--; // for 循环还会 +1，落到字符串结束引号后一个字符
+            continue;
+        }
+        if (c === '(')
+            depth++;
+        else if (c === ')')
+            depth--;
+        if (c === ',' && depth === 0) {
+            out.push(cur.trim());
+            cur = '';
+        }
+        else
+            cur += c;
+    }
+    if (cur.trim() !== '')
+        out.push(cur.trim());
+    return out;
+}
+/**
+ * 单个 P21 字符串字面量的未转义内容（剥离包裹引号与 `''` 转义）。
+ *
+ * @param p 可能带包裹引号的 P21 字符串字面量（含 trim），或 undefined。
+ * @returns 未转义内容；非字面量/undefined 时返回 undefined。
+ */
+export function paramStr(p) {
+    if (p === undefined)
+        return undefined;
+    const m = /^'((?:[^']|'')*)'$/.exec(p.trim());
+    return m ? m[1].replace(/''/g, `'`) : undefined;
+}
+/**
+ * 单个 P21 字符串字面量（已转义）。
+ *
+ * @param v 原始字符串内容（未转义）。
+ * @returns 包裹单引号并按 P21 规则转义后的字面量（如 `'a''b'`）。
+ */
+export function stepStr(v) {
+    return `'${v.replace(/'/g, "''")}'`;
+}
+/**
+ * P21 列表字面量：把多项字符串转为带外层圆括号的字面量列表。
+ *
+ * @param items 待序列化的字符串数组。
+ * @returns 形如 `('a','b')` 的 P21 列表字面量。
+ */
+export function p21List(items) {
+    return `(${items.map(stepStr).join(',')})`;
+}
+//# sourceMappingURL=step-meta-header.js.map

package/dist/brep/export/step-meta-header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-meta-header.js","sourceRoot":"","sources":["../../../src/brep/export/step-meta-header.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * STEP 文件级元数据 → P21 header 重写（`FILE_NAME`/`FILE_DESCRIPTION`）。\n *\n * 独立成模块使 `export-model.ts`（ExportModel 入口）与 `step.ts`\n * （exportStepFromSolids）都能复用，避免 `export-model → export → export-model`\n * 的循环依赖：本模块只依赖 `../../api/meta` 的 `FileMeta` 类型（type-only）。\n *\n * 设计文档 2026-10-05-meta §6.2 第 6 步：`exportModel` 已有 SI_UNIT 声明重写的先例\n * ——同样只对 header 里 FILE_NAME(...)/FILE_DESCRIPTION(...) 行做文本替换，绝不碰\n * DATA 段几何实体（红线 §10.3 3a：文本层只改声明/元数据，坐标不动）。\n *\n * FILE_NAME(name, time_stamp, author, organization, preprocessor_version, ...)\n * FILE_DESCRIPTION(description_list, implementation_level)\n * 映射（§3.3）：title→name, creationDate→time_stamp, designer/author→author,\n * organization→organization, application→preprocessor, description→description。\n * 无对应位置的字段（copyright/licenseTerms/rating/modificationDate）**不写**\n * （STEP 无标准位置，不发明）。\n *\n * 宽容失败：找不到 FILE_NAME/FILE_DESCRIPTION 行则留空（P21 头由内核写出，形态\n * 已知为 `FILE_DESCRIPTION(('Open CASCADE Model'),'2;1');` 一行，但在字符串内）。\n */\n\nimport type { FileMeta } from '../../api/meta'\n\n/**\n * FileMeta 是否含可映射到 STEP header 的字段（避免对无 header 字段的 fileMeta\n * 做无谓解码重写）。\n *\n * @param f 文件级元数据；undefined 视为无 header 字段。\n * @returns 存在任一可映射字段时为 true。\n */\nexport function fileMetaHasHeaderFields(f: FileMeta | undefined): boolean {\n  if (!f) return false\n  return !!(f.title || f.description || f.designer || f.author || f.organization || f.application\n    || f.creationDate || f.modificationDate)\n}\n\n/**\n * STEP 文件级元数据 → P21 header 重写：仅碰 `FILE_NAME`/`FILE_DESCRIPTION` 两处\n * 标准实体，其余文本（含 DATA 段几何）原样保留。\n *\n * @param stepText 内核产出的 STEP 全文（ISO-10303-21）。\n * @param fileMeta 目标文件级元数据。\n * @returns 改写后的 STEP 文本。\n */\nexport function rewriteStepHeader(stepText: string, fileMeta: FileMeta): string {\n  let out = stepText\n\n  const title = fileMeta.title && fileMeta.title.length > 0 ? fileMeta.title : undefined\n  const ts = fileMeta.creationDate && fileMeta.creationDate.length > 0\n    ? fileMeta.creationDate\n    : (fileMeta.modificationDate && fileMeta.modificationDate.length > 0 ? fileMeta.modificationDate : undefined)\n  const authorList = fileMeta.author && fileMeta.author.length > 0 ? [fileMeta.author] : []\n  const org = fileMeta.organization && fileMeta.organization.length > 0 ? fileMeta.organization : undefined\n  const preproc = fileMeta.application && fileMeta.application.length > 0 ? fileMeta.application : undefined\n  const designer = fileMeta.designer && fileMeta.designer.length > 0 ? fileMeta.designer : undefined\n  const desc = fileMeta.description && fileMeta.description.length > 0 ? fileMeta.description : undefined\n\n  // 1) FILE_NAME（用平衡括号/引号感知的枚举，整块替换 —— 逐参安全，不依赖行结构）。\n  const fn = matchEntity(out, 'FILE_NAME')\n  if (fn) {\n    const params = splitP21Params(fn.inner)\n    const next: string[] = []\n    if (title !== undefined || ts !== undefined || authorList.length > 0 || org !== undefined || preproc !== undefined || designer !== undefined) {\n      next.push(stepStr(title ?? paramStr(params[0]) ?? 'STEP File'))\n      next.push(stepStr(ts ?? paramStr(params[1]) ?? ''))\n      next.push(authorList.length > 0 ? p21List(authorList) : (params[2] ?? \"('')\"))\n      next.push(org !== undefined ? p21List([org]) : (params[3] ?? \"('')\"))\n      // 保留内核写出的后续参数原样（preprocessor_version / originating_system /\n      // authorisation）——FILE_NAME 可带 6..7 参，不丢既有值。\n      next.push(preproc !== undefined ? stepStr(preproc) : (params[4] ?? ''))\n      next.push(designer !== undefined ? stepStr(designer) : (params[5] ?? ''))\n      for (let i = 6; i < params.length; i++) next.push(params[i])\n      // 末尾空参保留则拼 ',' 会使整行以 ',' 结尾 → 过滤空的尾部。\n      while (next.length > 0 && next[next.length - 1] === '') next.pop()\n      out = splice(out, fn.start, fn.end, `FILE_NAME(${next.join(',')})`)\n    }\n  }\n\n  // 2) FILE_DESCRIPTION(description_list, implementation_level)：替换描述列表。\n  const fd = matchEntity(out, 'FILE_DESCRIPTION')\n  if (fd) {\n    const params = splitP21Params(fd.inner)\n    if (desc !== undefined && params.length > 0) {\n      const impl = params[params.length - 1]\n      out = splice(out, fd.start, fd.end, `FILE_DESCRIPTION((${stepStr(desc)}),${impl})`)\n    }\n  }\n\n  return out\n}\n\n/**\n * 用 replacement 替换字符串 [start, end) 区间，返回新字符串（不可变，纯函数）。\n *\n * @param s 原始字符串。\n * @param start 替换区起始偏移（含）。\n * @param end 替换区结束偏移（不含）。\n * @param replacement 替换内容。\n * @returns 替换后的新字符串。\n */\nexport function splice(s: string, start: number, end: number, replacement: string): string {\n  return s.slice(0, start) + replacement + s.slice(end)\n}\n\n/**\n * 旧名别名：正文使用 {@link rewriteStepHeader}。保留导出以免破坏既有调用/test 引用。\n *\n * @param stepText 内核产出的 STEP 全文（ISO-10303-21）。\n * @param fileMeta 目标文件级元数据。\n * @returns 改写后的 STEP 文本。\n */\nexport const rewriteFileMetaHeader: (stepText: string, fileMeta: FileMeta) => string = rewriteStepHeader\n\n/**\n * 在文本中定位 `NAME(` … 匹配的 `)` （引号忽略、内层括号计入）并返回\n * `{ start, end, inner }`；找不到返回 null。start/end 是 `NAME(` 起始/闭合 `)` 之后\n * 一位的偏移，供调用方做字符串拼接替换（不做正则整行匹配——行内可含 `;` 等字符）。\n *\n * @param text 待搜索的 STEP 全文。\n * @param name 实体名（如 `FILE_NAME`），大小写敏感。\n * @returns 匹配区间 `{ start, end, inner }`；未找到时 null。\n */\nexport function matchEntity(text: string, name: string): { start: number; end: number; inner: string } | null {\n  const re = new RegExp(`${name}\\\\s*\\\\(`)\n  const m = re.exec(text)\n  if (!m) return null\n  const start = m.index\n  const head = m.index + m[0].length\n  let depth = 1\n  let i = head\n  for (; i < text.length && depth > 0; i++) {\n    const c = text[i]\n    if (c === `'`) {\n      // 跳过字符串字面量（含 ISO10303-21 双引号转义）\n      i++\n      while (i < text.length) {\n        if (text[i] === `'` && text[i + 1] === `'`) { i += 2; continue }\n        if (text[i] === `'`) break\n        i++\n      }\n    } else if (c === '(') depth++\n    else if (c === ')') depth--\n  }\n  return { start, end: i - 1, inner: text.slice(head, i - 1) }\n}\n\n/** 把一层参数（逗号分隔，忽略括号与字符串内的逗号）拆分（trim，原样保留字面量）。 */\n/**\n * 把一层 P21 参数（逗号分隔，忽略括号与字符串内的逗号）拆成数组；每项 trim，\n * 字符串字面量原样保留（不做解引号）。\n *\n * @param inner 实体括号内、不含首尾括号的原文（如 `matchEntity` 返回的 `inner`）。\n * @returns 拆解后的参数数组（可能为空数组）。\n */\nexport function splitP21Params(inner: string): string[] {\n  const out: string[] = []\n  let cur = ''\n  let depth = 0\n  for (let i = 0; i < inner.length; i++) {\n    const c = inner[i]\n    if (c === `'`) {\n      // 字符串字面量：整体吸收（含 ISO10303-21 转义 ''），不拆其内逗号/括号。\n      const start = i\n      i++\n      while (i < inner.length) {\n        if (inner[i] === `'` && inner[i + 1] === `'`) { i += 2; continue }\n        if (inner[i] === `'`) { i++; break }\n        i++\n      }\n      cur += inner.slice(start, i)\n      i-- // for 循环还会 +1，落到字符串结束引号后一个字符\n      continue\n    }\n    if (c === '(') depth++\n    else if (c === ')') depth--\n    if (c === ',' && depth === 0) { out.push(cur.trim()); cur = '' }\n    else cur += c\n  }\n  if (cur.trim() !== '') out.push(cur.trim())\n  return out\n}\n\n/**\n * 单个 P21 字符串字面量的未转义内容（剥离包裹引号与 `''` 转义）。\n *\n * @param p 可能带包裹引号的 P21 字符串字面量（含 trim），或 undefined。\n * @returns 未转义内容；非字面量/undefined 时返回 undefined。\n */\nexport function paramStr(p: string | undefined): string | undefined {\n  if (p === undefined) return undefined\n  const m = /^'((?:[^']|'')*)'$/.exec(p.trim())\n  return m ? m[1].replace(/''/g, `'`) : undefined\n}\n\n/**\n * 单个 P21 字符串字面量（已转义）。\n *\n * @param v 原始字符串内容（未转义）。\n * @returns 包裹单引号并按 P21 规则转义后的字面量（如 `'a''b'`）。\n */\nexport function stepStr(v: string): string {\n  return `'${v.replace(/'/g, \"''\")}'`\n}\n\n/**\n * P21 列表字面量：把多项字符串转为带外层圆括号的字面量列表。\n *\n * @param items 待序列化的字符串数组。\n * @returns 形如 `('a','b')` 的 P21 列表字面量。\n */\nexport function p21List(items: string[]): string {\n  return `(${items.map(stepStr).join(',')})`\n}"]}

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

@@ -14,6 +14,7 @@
  */
 import type { BrepHandle } from '../engine/types.js';
 import type { BrepEngineApi } from '../engine/primitives.js';
+import type { FileMeta } from '../../api/meta.js';
 /** STEP 导出条目：一个 part（精确 BREP 形状或三角网格，二选一）。 */
 export interface StepExportEntry {
     /** 精确 BREP 形状（solid/shell/face/compound，来自宿主导出缓存）。与 mesh 二选一，solid 优先。 */
@@ -34,10 +35,13 @@ export interface StepExportEntry {
  *
  * @param kernel  OCCT kernel (must match the one that created the solids)
  * @param entries parts to export; each becomes its own XCAF label
+ * @param fileMeta optional file-level metadata; mapped to the P21 header
+ *                 (`FILE_NAME`/`FILE_DESCRIPTION`) via text rewrite
+ *                 (`rewriteStepHeader`). No effect on geometry/DATA entities.
  * @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 declare function exportStepFromSolids(kernel: BrepEngineApi, entries: StepExportEntry[], fileMeta?: FileMeta): ArrayBuffer;
 /**
  * Export a BREP solid (OCCT native) to STEP format.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../src/brep/export/step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAIzD,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,CA8Eb;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,aAAa,GACpB,WAAW,CAEb"}
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../src/brep/export/step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAG9C,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;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,eAAe,EAAE,EAC1B,QAAQ,CAAC,EAAE,QAAQ,GAClB,WAAW,CAmFb;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,aAAa,GACpB,WAAW,CAEb"}

package/dist/brep/export/step.js

@@ -14,6 +14,7 @@
  */
 import { reconstructSolidFromMesh } from '../../occt-kernel/meshReconstruct.js';
 import { getOcctKernel } from '../../occt-kernel/occtKernel.js';
+import { rewriteStepHeader, fileMetaHasHeaderFields } from './step-meta-header.js';
 /**
  * sRGB → linear 转换。
  *
@@ -33,10 +34,13 @@ function srgbToLinear(c) {
  *
  * @param kernel  OCCT kernel (must match the one that created the solids)
  * @param entries parts to export; each becomes its own XCAF label
+ * @param fileMeta optional file-level metadata; mapped to the P21 header
+ *                 (`FILE_NAME`/`FILE_DESCRIPTION`) via text rewrite
+ *                 (`rewriteStepHeader`). No effect on geometry/DATA entities.
  * @returns STEP file content as ArrayBuffer
  * @throws if entries is empty, or a mesh entry fails to reconstruct
  */
-export function exportStepFromSolids(kernel, entries) {
+export function exportStepFromSolids(kernel, entries, fileMeta) {
     if (entries.length === 0) {
         throw new Error('No exportable geometry');
     }
@@ -99,7 +103,12 @@ export function exportStepFromSolids(kernel, entries) {
         }
         // 3. 导出（每个 label 一个独立 PRODUCT，保留名称/颜色）
         const stepText = doc.exportSTEP();
-        return new TextEncoder().encode(stepText).buffer;
+        // 文件级 meta → P21 header 重写（title/creationDate/createor/author/org/
+        // application/description）。无 header 字段时不重写。文本层只改声明不碰几何。
+        const out = fileMeta && fileMetaHasHeaderFields(fileMeta)
+            ? rewriteStepHeader(stepText, fileMeta)
+            : stepText;
+        return new TextEncoder().encode(out).buffer;
     }
     finally {
         // 4. 释放顺序：先关文档，再释放本函数创建的句柄

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

@@ -1 +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 * @platform occt — 本文件 import occt-kernel（createXCAFDocument/XCAF label 写入是\n * occt-only 平台面，D3）。文件级标注满足守卫①（平台 import 自证身份）。\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'\nimport { getOcctKernel, type ShapeHandle } from '../../occt-kernel/occtKernel'\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 = getOcctKernel().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        // wasm getSubShapes 不展开 compound 层（TopExp_Explorer 默认跳过），\n        // 纯面/壳/边 compound（如 Shape.siblings / faces('>Z') 结果）在这里\n        // 拿不到子形状。把 compound 整体作为单个 XCAF label 写入（STEP\n        // writer 支持 compound 形状，与 ref 侧 cadquery Shape.exportStep\n        // 对 faces/edges compound 的行为一致）。\n        subs = [solid]\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        // 平台面（D3）：XCAF label 写入是 occt-only。BrepHandle ↔ ShapeHandle\n        // 运行时同构，品牌转换只发生在平台边界。\n        doc.addShape(sub as unknown as ShapeHandle, { 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}"]}
+{"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 * @platform occt — 本文件 import occt-kernel（createXCAFDocument/XCAF label 写入是\n * occt-only 平台面，D3）。文件级标注满足守卫①（平台 import 自证身份）。\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'\nimport { getOcctKernel, type ShapeHandle } from '../../occt-kernel/occtKernel'\nimport type { FileMeta } from '../../api/meta'\nimport { rewriteStepHeader, fileMetaHasHeaderFields } from './step-meta-header'\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 * @param fileMeta optional file-level metadata; mapped to the P21 header\n *                 (`FILE_NAME`/`FILE_DESCRIPTION`) via text rewrite\n *                 (`rewriteStepHeader`). No effect on geometry/DATA entities.\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  fileMeta?: FileMeta,\n): ArrayBuffer {\n  if (entries.length === 0) {\n    throw new Error('No exportable geometry')\n  }\n\n  const doc = getOcctKernel().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        // wasm getSubShapes 不展开 compound 层（TopExp_Explorer 默认跳过），\n        // 纯面/壳/边 compound（如 Shape.siblings / faces('>Z') 结果）在这里\n        // 拿不到子形状。把 compound 整体作为单个 XCAF label 写入（STEP\n        // writer 支持 compound 形状，与 ref 侧 cadquery Shape.exportStep\n        // 对 faces/edges compound 的行为一致）。\n        subs = [solid]\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        // 平台面（D3）：XCAF label 写入是 occt-only。BrepHandle ↔ ShapeHandle\n        // 运行时同构，品牌转换只发生在平台边界。\n        doc.addShape(sub as unknown as ShapeHandle, { name, color })\n      }\n    }\n\n    // 3. 导出（每个 label 一个独立 PRODUCT，保留名称/颜色）\n    const stepText = doc.exportSTEP()\n    // 文件级 meta → P21 header 重写（title/creationDate/createor/author/org/\n    // application/description）。无 header 字段时不重写。文本层只改声明不碰几何。\n    const out = fileMeta && fileMetaHasHeaderFields(fileMeta)\n      ? rewriteStepHeader(stepText, fileMeta)\n      : stepText\n    return new TextEncoder().encode(out).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/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，用结构等价实现）。 */