@faicad/faijs 0.29.3 → 0.30.9

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":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAA;AAC5E,OAAO,EAAE,aAAa,EAAoB,MAAM,8BAA8B,CAAA;AAE9E,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAc/E;;;;;;;;;GASG;AACH,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,EAAE,GAAG,CAAC,CAAA;AACtE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAqB,EACrB,OAA0B,EAC1B,QAAmB;IAEnB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC,kBAAkB,EAAE,CAAA;IAChD,gDAAgD;IAChD,0CAA0C;IAC1C,MAAM,YAAY,GAAiB,EAAE,CAAA;IAErC,IAAI,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,oCAAoC;YACpC,IAAI,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;YACvB,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oBAChB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;gBACtE,CAAC;gBACD,KAAK,GAAG,wBAAwB,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;gBAClF,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAC1B,CAAC;YAED,uDAAuD;YACvD,8CAA8C;YAC9C,uDAAuD;YACvD,kDAAkD;YAClD,sDAAsD;YACtD,2BAA2B;YAC3B,IAAI,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YAC9C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YAC5C,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;YAC3C,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;YAC3C,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,0DAA0D;gBAC1D,wDAAwD;gBACxD,8CAA8C;gBAC9C,0DAA0D;gBAC1D,iCAAiC;gBACjC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;YAChB,CAAC;YACD,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;gBACxC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAA;gBACpB,mCAAmC;gBACnC,IAAI,KAAK,KAAK,GAAG;oBAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACzC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;oBAC1B,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,MAAM,KAAK,EAAE,GAAG,CAAC,GAAG;oBACvC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAA;gBACd,yDAAyD;gBACzD,6CAA6C;gBAC7C,MAAM,KAAK,GAAyC,KAAK,CAAC,KAAK;oBAC7D,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC5F,CAAC,CAAC,SAAS,CAAA;gBACb,4DAA4D;gBAC5D,sBAAsB;gBACtB,GAAG,CAAC,QAAQ,CAAC,GAA6B,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;YAC9D,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,EAAE,CAAA;QACjC,mEAAmE;QACnE,wDAAwD;QACxD,MAAM,GAAG,GAAG,QAAQ,IAAI,uBAAuB,CAAC,QAAQ,CAAC;YACvD,CAAC,CAAC,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC;YACvC,CAAC,CAAC,QAAQ,CAAA;QACZ,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAA;IAC7C,CAAC;YAAS,CAAC;QACT,2BAA2B;QAC3B,GAAG,CAAC,KAAK,EAAE,CAAA;QACX,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,mBAAmB;YACrB,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAiB,EACjB,MAAqB;IAErB,OAAO,oBAAoB,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;AAClD,CAAC","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/handle-bridge.d.ts

@@ -19,7 +19,7 @@ import type { BrepEngineApi } from './engine/primitives.js';
  * ("OCCT kernel") no longer matches what it returns — the current engine's raw
  * kernel, whatever engine that is. Prefer `getBrepApi()` (typed, engine-neutral,
  * same file) for neutral ops; platform-only code (L2 face) should use
- * `getOcctKernel()` (D3). Kept for vendored-face bridging and existing tests.
+ * `getOcctKernel()` (D3). Kept for compat-face bridging and existing tests.
  * @returns the current BREP engine's kernel instance.
  * @throws when the kernel is not ready (mesh mode or uninitialized) — never silently returns null.
  */
@@ -48,7 +48,7 @@ export interface MeshHandleOptions {
 /**
  * OCC 句柄身份契约判别（单一真源）。
  *
- * occt-wasm 的 `handle()` 工厂（vendored occtWasm helpers.ts:25）构造的句柄对象
+ * occt-wasm 的 `handle()` 工厂（occtWasm helpers.ts:25）构造的句柄对象
  * 统一携带 `__occtWasm: true`。本叶子是 faijs 侧唯一允许的判据：
  * define-op 的 `wrapBrepOne` 用它区分"几何句柄"与"纯数据记录"，本文件
  * `fromHandle`/`meshHandle` 入口用它做形态断言。禁止在其他文件硬编码

package/dist/brep/handle-bridge.js

@@ -18,7 +18,7 @@ import { fromBrep } from '../shape.js';
  * ("OCCT kernel") no longer matches what it returns — the current engine's raw
  * kernel, whatever engine that is. Prefer `getBrepApi()` (typed, engine-neutral,
  * same file) for neutral ops; platform-only code (L2 face) should use
- * `getOcctKernel()` (D3). Kept for vendored-face bridging and existing tests.
+ * `getOcctKernel()` (D3). Kept for compat-face bridging and existing tests.
  * @returns the current BREP engine's kernel instance.
  * @throws when the kernel is not ready (mesh mode or uninitialized) — never silently returns null.
  */
@@ -50,7 +50,7 @@ export function getBrepApi() {
 /**
  * OCC 句柄身份契约判别（单一真源）。
  *
- * occt-wasm 的 `handle()` 工厂（vendored occtWasm helpers.ts:25）构造的句柄对象
+ * occt-wasm 的 `handle()` 工厂（occtWasm helpers.ts:25）构造的句柄对象
  * 统一携带 `__occtWasm: true`。本叶子是 faijs 侧唯一允许的判据：
  * define-op 的 `wrapBrepOne` 用它区分"几何句柄"与"纯数据记录"，本文件
  * `fromHandle`/`meshHandle` 入口用它做形态断言。禁止在其他文件硬编码

package/dist/brep/handle-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"handle-bridge.js","sourceRoot":"","sources":["../../src/brep/handle-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAWnC;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAA;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAA;IAC5G,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAA;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAA;IACH,CAAC;IACD,OAAO,MAAuB,CAAA;AAChC,CAAC;AAYD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAK,CAA8B,CAAC,UAAU,KAAK,IAAI,CAAA;AACnG,CAAC;AAED;0CAC0C;AAC1C,SAAS,YAAY,CAAC,CAAU;IAC9B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,CAAA;AACjD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,MAAe,EAAE,MAAc;IACpD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,yDAAyD;YAC/E,kCAAkC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,MAAM,IAAI;YAC9E,wDAAwD,CAC3D,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAe,EAAE,IAAwB;IAClE,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACnC,MAAM,MAAM,GAAG,SAAS,EAAoB,CAAA;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE;QACpC,gBAAgB,EAAE,IAAI,EAAE,gBAAgB,IAAI,GAAG;QAC/C,iBAAiB,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;KACrE,CAAC,CAAA;IACF,OAAO;QACL,SAAS,EAAE,IAAI,YAAY,CAAC,IAAI,CAAC,SAA8B,CAAC;QAChE,OAAO,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,OAA4B,CAAC;KAC5D,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,MAAe,EAAE,IAAwB;IAClE,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACnC,OAAO,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;AAC9D,CAAC","sourcesContent":["/**\n * handle-bridge — OCCT 句柄 → faijs Shape 的 SDK 桥接（B1）\n *\n *\n * 第三方库要造 BREP 产物，需要\"OCCT handle → mesh\"。`src/brep/brep-ops.ts:17`\n * 有 `import * as THREE from 'three'`，SDK 绝不能 import 它（会把 three 拉进\n * SDK bundle，违反 `src/sdk.test.ts` 的零 heavy 依赖守卫）。本文件在**新建的\n * 零依赖模块**中实现，直接调运行时注入的 `kernel.meshShape`。\n *\n * 依赖约束（硬性）：只允许 import `runtime-state`、`api/shape`、type-only\n * `mesh/types`——任何新增依赖必须保持 dist/sdk.js 零 heavy 依赖守卫通过。\n */\n\nimport type { Shape } from '../mesh/types'\nimport { getBackends } from '../runtime-state'\nimport { fromBrep } from '../shape'\nimport type { BrepEngineApi } from './engine/primitives'\n\n/** 结构化内核接口（不 import occt-wasm，只做结构匹配，避免 heavy 依赖） */\ninterface MeshableKernel {\n  meshShape(\n    handle: unknown,\n    opts: { linearDeflection: number; angularDeflection: number },\n  ): { positions: ArrayLike<number>; indices: ArrayLike<number> }\n}\n\n/**\n * Get the currently injected BREP kernel instance (untyped escape hatch).\n * @deprecated D12: this exit predates the engine-neutral L1 surface and its name\n * (\"OCCT kernel\") no longer matches what it returns — the current engine's raw\n * kernel, whatever engine that is. Prefer `getBrepApi()` (typed, engine-neutral,\n * same file) for neutral ops; platform-only code (L2 face) should use\n * `getOcctKernel()` (D3). Kept for vendored-face bridging and existing tests.\n * @returns the current BREP engine's kernel instance.\n * @throws when the kernel is not ready (mesh mode or uninitialized) — never silently returns null.\n */\nexport function getKernel(): unknown {\n  const kernel = getBackends().kernel.brep\n  if (!kernel) {\n    throw new Error('[faijs/bridge] OCCT kernel not available: BREP operations require an initialized kernel')\n  }\n  return kernel\n}\n\n/**\n * Get the current BREP engine as the **L1 core surface** (`BrepEngineApi`).\n *\n * 2026-09-24 narrowing plan（D12）：中立 op 的取内核唯一出口——取代\n * `getBackends().kernel.brep as BrepEngineApi` 的逐点断言。本文件是 L1 契约\n * 的注册点（`registerBrepEngine` 注入的就是 `BrepEngineApi` 实例），此处断言\n * 诚实；平台面（L1 之外的 occt 独有能力）仍走 `getOcctKernel()`（D3）。\n *\n * @returns the current engine's L1 contract surface (`BrepEngineApi`) — typed, engine-neutral.\n * @throws when no BREP engine is registered (uninitialized) — never silently returns null.\n */\nexport function getBrepApi(): BrepEngineApi {\n  const kernel = getBackends().kernel.brep\n  if (!kernel) {\n    throw new Error(\n      '[faijs/bridge] BREP engine API not available: BREP operations require an initialized engine',\n    )\n  }\n  return kernel as BrepEngineApi\n}\n\n/**\n * Options controlling how a handle is tessellated.\n */\nexport interface MeshHandleOptions {\n  /** linear deflection (mm), default 0.1 — matches the built-in ops (src/brep/brep-ops.ts:27). */\n  linearDeflection?: number\n  /** angular segment count, default 32 — angularDeflection = 2π / segments. */\n  segments?: number\n}\n\n/**\n * OCC 句柄身份契约判别（单一真源）。\n *\n * occt-wasm 的 `handle()` 工厂（vendored occtWasm helpers.ts:25）构造的句柄对象\n * 统一携带 `__occtWasm: true`。本叶子是 faijs 侧唯一允许的判据：\n * define-op 的 `wrapBrepOne` 用它区分\"几何句柄\"与\"纯数据记录\"，本文件\n * `fromHandle`/`meshHandle` 入口用它做形态断言。禁止在其他文件硬编码\n * `'__occtWasm' in v` 字符串直查——句柄/数据判定的任何新消费点都必须引用本叶子。\n * @param v - 待判别的值。\n * @returns `true` 当且仅当 `v` 是携带 `__occtWasm: true` 标记的句柄对象。\n */\nexport function isOcctHandle(v: unknown): boolean {\n  return typeof v === 'object' && v !== null && (v as { __occtWasm?: unknown }).__occtWasm === true\n}\n\n/** 合法句柄输入：branded numeric id（occt-wasm 的 `ShapeHandle` 运行时形态）或\n *  `__occtWasm` 标记对象（`handle()` 工厂产物）。 */\nfunction isHandleLike(v: unknown): boolean {\n  return typeof v === 'number' || isOcctHandle(v)\n}\n\n/**\n * 入口形态断言：拒绝把纯数据记录当句柄三角化。\n * 纯数据记录（无 `__occtWasm` 标记的 plain object，如 sheetmetal part 数据）\n * 必须在 SDK 边界被显式拒绝（E_BAD_HANDLE），而不是在 kernel 深处以\n * `OcctError: meshShape: Invalid shape ID 0` 崩溃——define-op 的 wrapBrepOne\n * 已在第一道透传过滤，本断言是第二道防线（防未来未带标记的新句柄形态漏网）。\n */\nfunction requireHandle(handle: unknown, caller: string): void {\n  if (!isHandleLike(handle)) {\n    throw new Error(\n      `[faijs/bridge] ${caller}: E_BAD_HANDLE: expected an OCCT handle (numeric id or ` +\n        `__occtWasm-tagged object); got ${handle === null ? 'null' : typeof handle}. ` +\n        `Plain data records must not be tessellated as handles.`,\n    )\n  }\n}\n\n/**\n * Tessellate an OCCT handle into a Shape (without registering a BREP slot).\n * @param handle - the OCCT solid handle to tessellate (numeric id or `__occtWasm`-tagged object).\n * @param opts - optional tessellation options.\n * @returns the tessellated Shape.\n */\nexport function meshHandle(handle: unknown, opts?: MeshHandleOptions): Shape {\n  requireHandle(handle, 'meshHandle')\n  const kernel = getKernel() as MeshableKernel\n  const mesh = kernel.meshShape(handle, {\n    linearDeflection: opts?.linearDeflection ?? 0.1,\n    angularDeflection: (2 * Math.PI) / Math.max(3, opts?.segments ?? 32),\n  })\n  return {\n    positions: new Float32Array(mesh.positions as ArrayLike<number>),\n    indices: new Uint32Array(mesh.indices as ArrayLike<number>),\n  }\n}\n\n/**\n * Default path (recommended): tessellate + register the BREP slot in one step.\n * Equivalent to meshHandle(h) + fromBrep(sh, { solid: h }).\n * Library authors only fall back to the meshHandle + fromBrep combination when\n * they need custom tessellation precision.\n * @param handle - the OCCT solid handle to bridge (numeric id or `__occtWasm`-tagged object).\n * @param opts - optional tessellation options.\n * @returns the registered Shape, as returned by fromBrep.\n */\nexport function fromHandle(handle: unknown, opts?: MeshHandleOptions): ReturnType<typeof fromBrep> {\n  requireHandle(handle, 'fromHandle')\n  return fromBrep(meshHandle(handle, opts), { solid: handle })\n}\n"]}
+{"version":3,"file":"handle-bridge.js","sourceRoot":"","sources":["../../src/brep/handle-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAWnC;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAA;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAA;IAC5G,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAA;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAA;IACH,CAAC;IACD,OAAO,MAAuB,CAAA;AAChC,CAAC;AAYD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAK,CAA8B,CAAC,UAAU,KAAK,IAAI,CAAA;AACnG,CAAC;AAED;0CAC0C;AAC1C,SAAS,YAAY,CAAC,CAAU;IAC9B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,CAAA;AACjD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,MAAe,EAAE,MAAc;IACpD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,yDAAyD;YAC/E,kCAAkC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,MAAM,IAAI;YAC9E,wDAAwD,CAC3D,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAe,EAAE,IAAwB;IAClE,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACnC,MAAM,MAAM,GAAG,SAAS,EAAoB,CAAA;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE;QACpC,gBAAgB,EAAE,IAAI,EAAE,gBAAgB,IAAI,GAAG;QAC/C,iBAAiB,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;KACrE,CAAC,CAAA;IACF,OAAO;QACL,SAAS,EAAE,IAAI,YAAY,CAAC,IAAI,CAAC,SAA8B,CAAC;QAChE,OAAO,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,OAA4B,CAAC;KAC5D,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,MAAe,EAAE,IAAwB;IAClE,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACnC,OAAO,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;AAC9D,CAAC","sourcesContent":["/**\n * handle-bridge — OCCT 句柄 → faijs Shape 的 SDK 桥接（B1）\n *\n *\n * 第三方库要造 BREP 产物，需要\"OCCT handle → mesh\"。`src/brep/brep-ops.ts:17`\n * 有 `import * as THREE from 'three'`，SDK 绝不能 import 它（会把 three 拉进\n * SDK bundle，违反 `src/sdk.test.ts` 的零 heavy 依赖守卫）。本文件在**新建的\n * 零依赖模块**中实现，直接调运行时注入的 `kernel.meshShape`。\n *\n * 依赖约束（硬性）：只允许 import `runtime-state`、`api/shape`、type-only\n * `mesh/types`——任何新增依赖必须保持 dist/sdk.js 零 heavy 依赖守卫通过。\n */\n\nimport type { Shape } from '../mesh/types'\nimport { getBackends } from '../runtime-state'\nimport { fromBrep } from '../shape'\nimport type { BrepEngineApi } from './engine/primitives'\n\n/** 结构化内核接口（不 import occt-wasm，只做结构匹配，避免 heavy 依赖） */\ninterface MeshableKernel {\n  meshShape(\n    handle: unknown,\n    opts: { linearDeflection: number; angularDeflection: number },\n  ): { positions: ArrayLike<number>; indices: ArrayLike<number> }\n}\n\n/**\n * Get the currently injected BREP kernel instance (untyped escape hatch).\n * @deprecated D12: this exit predates the engine-neutral L1 surface and its name\n * (\"OCCT kernel\") no longer matches what it returns — the current engine's raw\n * kernel, whatever engine that is. Prefer `getBrepApi()` (typed, engine-neutral,\n * same file) for neutral ops; platform-only code (L2 face) should use\n * `getOcctKernel()` (D3). Kept for compat-face bridging and existing tests.\n * @returns the current BREP engine's kernel instance.\n * @throws when the kernel is not ready (mesh mode or uninitialized) — never silently returns null.\n */\nexport function getKernel(): unknown {\n  const kernel = getBackends().kernel.brep\n  if (!kernel) {\n    throw new Error('[faijs/bridge] OCCT kernel not available: BREP operations require an initialized kernel')\n  }\n  return kernel\n}\n\n/**\n * Get the current BREP engine as the **L1 core surface** (`BrepEngineApi`).\n *\n * 2026-09-24 narrowing plan（D12）：中立 op 的取内核唯一出口——取代\n * `getBackends().kernel.brep as BrepEngineApi` 的逐点断言。本文件是 L1 契约\n * 的注册点（`registerBrepEngine` 注入的就是 `BrepEngineApi` 实例），此处断言\n * 诚实；平台面（L1 之外的 occt 独有能力）仍走 `getOcctKernel()`（D3）。\n *\n * @returns the current engine's L1 contract surface (`BrepEngineApi`) — typed, engine-neutral.\n * @throws when no BREP engine is registered (uninitialized) — never silently returns null.\n */\nexport function getBrepApi(): BrepEngineApi {\n  const kernel = getBackends().kernel.brep\n  if (!kernel) {\n    throw new Error(\n      '[faijs/bridge] BREP engine API not available: BREP operations require an initialized engine',\n    )\n  }\n  return kernel as BrepEngineApi\n}\n\n/**\n * Options controlling how a handle is tessellated.\n */\nexport interface MeshHandleOptions {\n  /** linear deflection (mm), default 0.1 — matches the built-in ops (src/brep/brep-ops.ts:27). */\n  linearDeflection?: number\n  /** angular segment count, default 32 — angularDeflection = 2π / segments. */\n  segments?: number\n}\n\n/**\n * OCC 句柄身份契约判别（单一真源）。\n *\n * occt-wasm 的 `handle()` 工厂（occtWasm helpers.ts:25）构造的句柄对象\n * 统一携带 `__occtWasm: true`。本叶子是 faijs 侧唯一允许的判据：\n * define-op 的 `wrapBrepOne` 用它区分\"几何句柄\"与\"纯数据记录\"，本文件\n * `fromHandle`/`meshHandle` 入口用它做形态断言。禁止在其他文件硬编码\n * `'__occtWasm' in v` 字符串直查——句柄/数据判定的任何新消费点都必须引用本叶子。\n * @param v - 待判别的值。\n * @returns `true` 当且仅当 `v` 是携带 `__occtWasm: true` 标记的句柄对象。\n */\nexport function isOcctHandle(v: unknown): boolean {\n  return typeof v === 'object' && v !== null && (v as { __occtWasm?: unknown }).__occtWasm === true\n}\n\n/** 合法句柄输入：branded numeric id（occt-wasm 的 `ShapeHandle` 运行时形态）或\n *  `__occtWasm` 标记对象（`handle()` 工厂产物）。 */\nfunction isHandleLike(v: unknown): boolean {\n  return typeof v === 'number' || isOcctHandle(v)\n}\n\n/**\n * 入口形态断言：拒绝把纯数据记录当句柄三角化。\n * 纯数据记录（无 `__occtWasm` 标记的 plain object，如 sheetmetal part 数据）\n * 必须在 SDK 边界被显式拒绝（E_BAD_HANDLE），而不是在 kernel 深处以\n * `OcctError: meshShape: Invalid shape ID 0` 崩溃——define-op 的 wrapBrepOne\n * 已在第一道透传过滤，本断言是第二道防线（防未来未带标记的新句柄形态漏网）。\n */\nfunction requireHandle(handle: unknown, caller: string): void {\n  if (!isHandleLike(handle)) {\n    throw new Error(\n      `[faijs/bridge] ${caller}: E_BAD_HANDLE: expected an OCCT handle (numeric id or ` +\n        `__occtWasm-tagged object); got ${handle === null ? 'null' : typeof handle}. ` +\n        `Plain data records must not be tessellated as handles.`,\n    )\n  }\n}\n\n/**\n * Tessellate an OCCT handle into a Shape (without registering a BREP slot).\n * @param handle - the OCCT solid handle to tessellate (numeric id or `__occtWasm`-tagged object).\n * @param opts - optional tessellation options.\n * @returns the tessellated Shape.\n */\nexport function meshHandle(handle: unknown, opts?: MeshHandleOptions): Shape {\n  requireHandle(handle, 'meshHandle')\n  const kernel = getKernel() as MeshableKernel\n  const mesh = kernel.meshShape(handle, {\n    linearDeflection: opts?.linearDeflection ?? 0.1,\n    angularDeflection: (2 * Math.PI) / Math.max(3, opts?.segments ?? 32),\n  })\n  return {\n    positions: new Float32Array(mesh.positions as ArrayLike<number>),\n    indices: new Uint32Array(mesh.indices as ArrayLike<number>),\n  }\n}\n\n/**\n * Default path (recommended): tessellate + register the BREP slot in one step.\n * Equivalent to meshHandle(h) + fromBrep(sh, { solid: h }).\n * Library authors only fall back to the meshHandle + fromBrep combination when\n * they need custom tessellation precision.\n * @param handle - the OCCT solid handle to bridge (numeric id or `__occtWasm`-tagged object).\n * @param opts - optional tessellation options.\n * @returns the registered Shape, as returned by fromBrep.\n */\nexport function fromHandle(handle: unknown, opts?: MeshHandleOptions): ReturnType<typeof fromBrep> {\n  requireHandle(handle, 'fromHandle')\n  return fromBrep(meshHandle(handle, opts), { solid: handle })\n}\n"]}

package/dist/brep/index.d.ts

@@ -5,9 +5,12 @@
  * - brep-ops.ts: 核心 BREP 操作（变换、布尔、钻孔、分割、拉伸）
  * - brep-chain.ts: BREP 链状态管理
  * - brep-utils.ts: 通用工具
- * - brepjs-mirror/: 从 brepjs 参考的操作实现（镜像 brepjs src/operations/，勿手改核心算法）
- * - text/: 文字 BREP 实现（镜像 brepjs src/text/）
- * - ops/: 每个操作的 BREP + Mesh 分派器（src/ops/）
+ * - brep-topology.ts / primitives-brep.ts / mesh-solid.ts: 拓扑查询、原型、实体化
+ * - face-evolution.ts / handle-bridge.ts / effective-deflection.ts: 面演化、句柄桥、偏转
+ * - engine/: BREP 引擎注册表与适配器（adapters/ 下 occt、brepkit、brep-mock）
+ * - export/: 导出（stl.ts、step.ts、export-model.ts）
+ * - svg/: SVG → 实体
+ * - text/: 文字 BREP（fontRegistry.ts、text-to-solid.ts）
  */
 export { solidToShape, translateBrep, rotateBrep, scaleBrep, fuseBrep, cutBrep, commonBrep, drillBrep, splitBrep, extrudeBrep, loadBrep, matrixToArray, type DrillBrepParams, type SplitBrepParams, type SplitBrepResult, type ExtrudeBrepParams, } from './brep-ops.js';
 export { type BrepChainState, createBrepChainState, initBrepChainState, releaseBrepChainState, isCadFormat, } from './brep-chain.js';

package/dist/brep/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/brep/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,YAAY,EACZ,aAAa,EAAE,UAAU,EAAE,SAAS,EACpC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAC7B,SAAS,EAAE,SAAS,EAAE,WAAW,EACjC,QAAQ,EAAE,aAAa,EACvB,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,iBAAiB,GACzF,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,KAAK,cAAc,EACnB,oBAAoB,EAAE,kBAAkB,EACxC,qBAAqB,EACrB,WAAW,GACZ,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/brep/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EACL,YAAY,EACZ,aAAa,EAAE,UAAU,EAAE,SAAS,EACpC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAC7B,SAAS,EAAE,SAAS,EAAE,WAAW,EACjC,QAAQ,EAAE,aAAa,EACvB,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,iBAAiB,GACzF,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,KAAK,cAAc,EACnB,oBAAoB,EAAE,kBAAkB,EACxC,qBAAqB,EACrB,WAAW,GACZ,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA"}

package/dist/brep/index.js

@@ -5,9 +5,12 @@
  * - brep-ops.ts: 核心 BREP 操作（变换、布尔、钻孔、分割、拉伸）
  * - brep-chain.ts: BREP 链状态管理
  * - brep-utils.ts: 通用工具
- * - brepjs-mirror/: 从 brepjs 参考的操作实现（镜像 brepjs src/operations/，勿手改核心算法）
- * - text/: 文字 BREP 实现（镜像 brepjs src/text/）
- * - ops/: 每个操作的 BREP + Mesh 分派器（src/ops/）
+ * - brep-topology.ts / primitives-brep.ts / mesh-solid.ts: 拓扑查询、原型、实体化
+ * - face-evolution.ts / handle-bridge.ts / effective-deflection.ts: 面演化、句柄桥、偏转
+ * - engine/: BREP 引擎注册表与适配器（adapters/ 下 occt、brepkit、brep-mock）
+ * - export/: 导出（stl.ts、step.ts、export-model.ts）
+ * - svg/: SVG → 实体
+ * - text/: 文字 BREP（fontRegistry.ts、text-to-solid.ts）
  */
 // 核心 BREP 操作
 export { solidToShape, translateBrep, rotateBrep, scaleBrep, fuseBrep, cutBrep, commonBrep, drillBrep, splitBrep, extrudeBrep, loadBrep, matrixToArray, } from './brep-ops.js';

package/dist/brep/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/brep/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,aAAa;AACb,OAAO,EACL,YAAY,EACZ,aAAa,EAAE,UAAU,EAAE,SAAS,EACpC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAC7B,SAAS,EAAE,SAAS,EAAE,WAAW,EACjC,QAAQ,EAAE,aAAa,GAExB,MAAM,YAAY,CAAA;AAEnB,aAAa;AACb,OAAO,EAEL,oBAAoB,EAAE,kBAAkB,EACxC,qBAAqB,EACrB,WAAW,GACZ,MAAM,cAAc,CAAA;AAErB,OAAO;AACP,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD,yDAAyD;AACzD,oFAAoF","sourcesContent":["/**\n * BREP 操作统一导出\n *\n * 目录结构：\n * - brep-ops.ts: 核心 BREP 操作（变换、布尔、钻孔、分割、拉伸）\n * - brep-chain.ts: BREP 链状态管理\n * - brep-utils.ts: 通用工具\n * - brepjs-mirror/: 从 brepjs 参考的操作实现（镜像 brepjs src/operations/，勿手改核心算法）\n * - text/: 文字 BREP 实现（镜像 brepjs src/text/）\n * - ops/: 每个操作的 BREP + Mesh 分派器（src/ops/）\n */\n\n// 核心 BREP 操作\nexport {\n  solidToShape,\n  translateBrep, rotateBrep, scaleBrep,\n  fuseBrep, cutBrep, commonBrep,\n  drillBrep, splitBrep, extrudeBrep,\n  loadBrep, matrixToArray,\n  type DrillBrepParams, type SplitBrepParams, type SplitBrepResult, type ExtrudeBrepParams,\n} from './brep-ops'\n\n// BREP 链状态管理\nexport {\n  type BrepChainState,\n  createBrepChainState, initBrepChainState,\n  releaseBrepChainState,\n  isCadFormat,\n} from './brep-chain'\n\n// 通用工具\nexport { getSolidBoundingBox } from './brep-utils'\n\n// F4 修复：不再反向 re-export executeStatement（ops/dispatcher）。\n// brep/ 不应 re-export ops/ 的符号。宿主从 @faicad/faijs/browser 直接 import executeStatement。\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/brep/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,aAAa;AACb,OAAO,EACL,YAAY,EACZ,aAAa,EAAE,UAAU,EAAE,SAAS,EACpC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAC7B,SAAS,EAAE,SAAS,EAAE,WAAW,EACjC,QAAQ,EAAE,aAAa,GAExB,MAAM,YAAY,CAAA;AAEnB,aAAa;AACb,OAAO,EAEL,oBAAoB,EAAE,kBAAkB,EACxC,qBAAqB,EACrB,WAAW,GACZ,MAAM,cAAc,CAAA;AAErB,OAAO;AACP,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD,yDAAyD;AACzD,oFAAoF","sourcesContent":["/**\n * BREP 操作统一导出\n *\n * 目录结构：\n * - brep-ops.ts: 核心 BREP 操作（变换、布尔、钻孔、分割、拉伸）\n * - brep-chain.ts: BREP 链状态管理\n * - brep-utils.ts: 通用工具\n * - brep-topology.ts / primitives-brep.ts / mesh-solid.ts: 拓扑查询、原型、实体化\n * - face-evolution.ts / handle-bridge.ts / effective-deflection.ts: 面演化、句柄桥、偏转\n * - engine/: BREP 引擎注册表与适配器（adapters/ 下 occt、brepkit、brep-mock）\n * - export/: 导出（stl.ts、step.ts、export-model.ts）\n * - svg/: SVG → 实体\n * - text/: 文字 BREP（fontRegistry.ts、text-to-solid.ts）\n */\n\n// 核心 BREP 操作\nexport {\n  solidToShape,\n  translateBrep, rotateBrep, scaleBrep,\n  fuseBrep, cutBrep, commonBrep,\n  drillBrep, splitBrep, extrudeBrep,\n  loadBrep, matrixToArray,\n  type DrillBrepParams, type SplitBrepParams, type SplitBrepResult, type ExtrudeBrepParams,\n} from './brep-ops'\n\n// BREP 链状态管理\nexport {\n  type BrepChainState,\n  createBrepChainState, initBrepChainState,\n  releaseBrepChainState,\n  isCadFormat,\n} from './brep-chain'\n\n// 通用工具\nexport { getSolidBoundingBox } from './brep-utils'\n\n// F4 修复：不再反向 re-export executeStatement（ops/dispatcher）。\n// brep/ 不应 re-export ops/ 的符号。宿主从 @faicad/faijs/browser 直接 import executeStatement。\n"]}