@faicad/faijs 0.29.3 → 0.29.5

package/dist/step/stepMetaParser.d.ts

@@ -0,0 +1,55 @@
+/**
+ * STEP 元数据解析器 — 从 STEP (P21) 文本头部与 PRODUCT 层提取
+ * FileMeta（文件级）与 ShapeMeta（零件级描述字/料号）。
+ *
+ * 与 stepColorParser 同一原则：纯文本扫描，不依赖 OCCT 内核（XCAF label 层
+ * 是否暴露 description/属性不确定，见设计文档 2026-10-05-meta §6.3 风险 2）。
+ *
+ * 读取面映射（§3.3）：
+ * - HEADER FILE_NAME(name,time_stamp,author,organization,preprocessor,originator)
+ *   → title / creationDate / author / organization / application / designer。
+ * - HEADER FILE_DESCRIPTION(...) → description（逗号拼接，去首尾引号）。
+ * - DATA PRODUCT(name,description,frame)（第一个、leaf 使用的）→ 零件 description。
+ *   name 已由 OCCT label 提供（不在本解析器处理）。
+ * - PRODUCT → PRODUCT_DEFINITION_FORMATION/WITH_SPECIFIED_SOURCE-关联的料号通道：
+ *   PART_NUMBER_PROPERTY/IDENTIFICATION 命名在 §3.3 表里列出的 PART 层通道（P4
+ *   标 "IDENTIFICATION 内核支持" 待实测），这里尽量从 PRODUCT_DEFINITION 挂的
+ *   UDA（GENERAL_PROPERTY + PROPERTY_DEFINITION）捞自定义属性。
+ *
+ * 所有扫描都容错：找不到就不给对应字段，绝不让解析器抛（信息性收益）。
+ */
+/** Header 级人物贡献字段（FILE_NAME 组内的三四五参数）。 */
+export interface StepFileMeta {
+    title?: string;
+    creationDate?: string;
+    designer?: string;
+    author?: string;
+    organization?: string;
+    application?: string;
+    description?: string;
+    /** 自定义 FILE_DESCRIPTION/FILE_NAME 之外的 vendor 属性（metadata 笼）。 */
+    metadata?: Record<string, string>;
+}
+/** STEP 伙伴级 P21 解析出的轻量属性。 */
+export interface StepPartMeta {
+    /** 产品描述（PRODUCT( ..., description, id )）。空串/缺省不设。 */
+    description?: string;
+    /** 自定义属性：`PROPERTY_DEFINITION(...)` + `GENERAL_PROPERTY('name', value, ...)`。 */
+    metadata?: Record<string, string>;
+}
+/**
+ * Header 段整块（FILE_NAME / FILE_DESCRIPTION）→ `StepFileMeta`。
+ *
+ * @param text STEP 全文（ISO-10303-21）。
+ * @returns 解析出的文件级元数据；无 header 时返回空对象。
+ */
+export declare function parseStepHeaderMeta(text: string): StepFileMeta;
+/**
+ * 伙伴层 `PRODUCT` 描述 + 根自定义属性（UDA，`GENERAL_PROPERTY`）解析
+ * （简化：description 只取第一个 `PRODUCT`）。
+ *
+ * @param text STEP 全文（ISO-10303-21）。
+ * @returns 解析出的部分级元数据（`description`/`metadata`）。
+ */
+export declare function parseStepPartMeta(text: string): StepPartMeta;
+//# sourceMappingURL=stepMetaParser.d.ts.map

package/dist/step/stepMetaParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepMetaParser.d.ts","sourceRoot":"","sources":["../../src/step/stepMetaParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED,6BAA6B;AAC7B,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AA2DD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CA+C9D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAyB5D"}

package/dist/step/stepMetaParser.js

@@ -0,0 +1,177 @@
+/**
+ * STEP 元数据解析器 — 从 STEP (P21) 文本头部与 PRODUCT 层提取
+ * FileMeta（文件级）与 ShapeMeta（零件级描述字/料号）。
+ *
+ * 与 stepColorParser 同一原则：纯文本扫描，不依赖 OCCT 内核（XCAF label 层
+ * 是否暴露 description/属性不确定，见设计文档 2026-10-05-meta §6.3 风险 2）。
+ *
+ * 读取面映射（§3.3）：
+ * - HEADER FILE_NAME(name,time_stamp,author,organization,preprocessor,originator)
+ *   → title / creationDate / author / organization / application / designer。
+ * - HEADER FILE_DESCRIPTION(...) → description（逗号拼接，去首尾引号）。
+ * - DATA PRODUCT(name,description,frame)（第一个、leaf 使用的）→ 零件 description。
+ *   name 已由 OCCT label 提供（不在本解析器处理）。
+ * - PRODUCT → PRODUCT_DEFINITION_FORMATION/WITH_SPECIFIED_SOURCE-关联的料号通道：
+ *   PART_NUMBER_PROPERTY/IDENTIFICATION 命名在 §3.3 表里列出的 PART 层通道（P4
+ *   标 "IDENTIFICATION 内核支持" 待实测），这里尽量从 PRODUCT_DEFINITION 挂的
+ *   UDA（GENERAL_PROPERTY + PROPERTY_DEFINITION）捞自定义属性。
+ *
+ * 所有扫描都容错：找不到就不给对应字段，绝不让解析器抛（信息性收益）。
+ */
+/** 剥离一层引号（STEP 字符串形如 `'abc'`），出双引号化转义；去末尾换行。 */
+function unquote(s) {
+    const t = s.trim();
+    if (t.startsWith("'") && t.endsWith("'"))
+        return t.slice(1, -1);
+    return t;
+}
+/** 任一 `HEADER`/`DATA` 段中的实体文本（多行），从 header 段中取整行。 */
+function headerLines(text) {
+    const m = /HEADER;\n([\s\S]*?)\nENDSEC;/.exec(text);
+    return m ? m[1] : '';
+}
+/** `TYPE(...)` 实体块捕获：从开括号起做括号配平扫描到闭合（容错 LIST/嵌套）。 */
+function entityBlock(text, type) {
+    const re = new RegExp(`${type}\\s*\\(`, 'g');
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        let depth = 0;
+        let inQuote = false;
+        let i = m.index + m[0].length - 1; // 停在开括号
+        for (; i < text.length; i++) {
+            const c = text[i];
+            if (c === "'")
+                inQuote = !inQuote;
+            if (inQuote)
+                continue;
+            if (c === '(')
+                depth++;
+            else if (c === ')') {
+                depth--;
+                if (depth === 0)
+                    return text.slice(m.index, i + 1);
+            }
+        }
+    }
+    return undefined;
+}
+/** 逗号分隔的顶层简单参数（忽略嵌套括号内容仍按逗号简单切——够用即可）。 */
+function splitTopLevel(body) {
+    // 剥离外层括号后，按未被引号包裹的逗号切分（不处理嵌套括号——STEP 伙伴级
+    // FILE_NAME/FILE_DESCRIPTION 参数都是简单标量/字符串，不涉及深层嵌套）。
+    const s = body.slice(body.indexOf('(') + 1, body.lastIndexOf(')'));
+    const parts = [];
+    let cur = '';
+    let inQuote = false;
+    for (let i = 0; i < s.length; i++) {
+        const c = s[i];
+        if (c === "'")
+            inQuote = !inQuote;
+        if (c === ',' && !inQuote) {
+            parts.push(cur);
+            cur = '';
+        }
+        else {
+            cur += c;
+        }
+    }
+    parts.push(cur);
+    return parts.map((p) => p.trim());
+}
+/**
+ * Header 段整块（FILE_NAME / FILE_DESCRIPTION）→ `StepFileMeta`。
+ *
+ * @param text STEP 全文（ISO-10303-21）。
+ * @returns 解析出的文件级元数据；无 header 时返回空对象。
+ */
+export function parseStepHeaderMeta(text) {
+    const meta = {};
+    const header = headerLines(text);
+    if (!header)
+        return meta;
+    const fileBlock = entityBlock(header, 'FILE_NAME');
+    if (fileBlock) {
+        const parts = splitTopLevel(fileBlock);
+        // FILE_NAME(name, time_stamp, author(list), organization(list), preprocessor, originator)
+        // 引号数组形如 `('x')`，去首尾括号后 unquote；author/organization 可能为列表。
+        const inline = (p) => {
+            if (!p)
+                return undefined;
+            const v = unquote(p.replace(/^\(|\)$/g, ''));
+            return v === '' ? undefined : v;
+        };
+        const title = inline(parts[0]);
+        if (title)
+            meta.title = title;
+        const cdate = inline(parts[1]);
+        if (cdate)
+            meta.creationDate = cdate;
+        const author = inline(parts[2] ?? '');
+        if (author)
+            meta.author = author;
+        const org = inline(parts[3] ?? '');
+        if (org)
+            meta.organization = org;
+        // preprocessor → application（编辑器导入后端把 preprocessor 视为 APP）；
+        // originator → designer。
+        const pre = inline(parts[4] ?? '');
+        if (pre)
+            meta.application = pre;
+        const origin = inline(parts[5] ?? '');
+        if (origin)
+            meta.designer = origin;
+    }
+    const descBlock = entityBlock(header, 'FILE_DESCRIPTION');
+    if (descBlock) {
+        // FILE_DESCRIPTION(description_list, implementation_context)：描述只取第一个
+        // 顶层参数（描述串列表，`('a','b')` 形态含内层逗号）；实现上下文不算。
+        // 直接取 `FILE_DESCRIPTION((…),` 里第一层括号内的引号字符串列表。
+        const m = /FILE_DESCRIPTION\s*\(\s*\((.*?)\)\s*,\s*/.exec(descBlock);
+        if (m) {
+            const joined = m[1]
+                .split(',')
+                .map((p) => unquote(p.trim()))
+                .filter((v) => v !== '');
+            if (joined.length > 0)
+                meta.description = joined.join(', ');
+        }
+    }
+    return meta;
+}
+/**
+ * 伙伴层 `PRODUCT` 描述 + 根自定义属性（UDA，`GENERAL_PROPERTY`）解析
+ * （简化：description 只取第一个 `PRODUCT`）。
+ *
+ * @param text STEP 全文（ISO-10303-21）。
+ * @returns 解析出的部分级元数据（`description`/`metadata`）。
+ */
+export function parseStepPartMeta(text) {
+    const out = {};
+    // 逐 PRODUCT 取 description（第 2 个参数）。
+    const dataRe = /PRODUCT\s*\(/g;
+    let m;
+    while ((m = dataRe.exec(text)) !== null) {
+        const close = text.indexOf(')', m.index);
+        if (close < 0)
+            break;
+        const inner = text.slice(m.index, close + 1);
+        const descM = /,\s*'([^']*)'/.exec(inner);
+        if (descM) {
+            const d = descM[1];
+            if (d !== '')
+                out.description = d;
+            break; // 只取第一个
+        }
+    }
+    // 属性笼（UDA：GENERAL_PROPERTY('name', value?) 挂在 PROPERTY_DEFINITION 上）。
+    const props = {};
+    const gpRe = /GENERAL_PROPERTY\s*\(\s*'([^']*)'\s*,\s*([^,)]+)/g;
+    let gm;
+    while ((gm = gpRe.exec(text)) !== null) {
+        props[gm[1]] = unquote(gm[2]);
+    }
+    if (Object.keys(props).length > 0)
+        out.metadata = props;
+    return out;
+}
+//# sourceMappingURL=stepMetaParser.js.map

package/dist/step/stepMetaParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepMetaParser.js","sourceRoot":"","sources":["../../src/step/stepMetaParser.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * STEP 元数据解析器 — 从 STEP (P21) 文本头部与 PRODUCT 层提取\n * FileMeta（文件级）与 ShapeMeta（零件级描述字/料号）。\n *\n * 与 stepColorParser 同一原则：纯文本扫描，不依赖 OCCT 内核（XCAF label 层\n * 是否暴露 description/属性不确定，见设计文档 2026-10-05-meta §6.3 风险 2）。\n *\n * 读取面映射（§3.3）：\n * - HEADER FILE_NAME(name,time_stamp,author,organization,preprocessor,originator)\n *   → title / creationDate / author / organization / application / designer。\n * - HEADER FILE_DESCRIPTION(...) → description（逗号拼接，去首尾引号）。\n * - DATA PRODUCT(name,description,frame)（第一个、leaf 使用的）→ 零件 description。\n *   name 已由 OCCT label 提供（不在本解析器处理）。\n * - PRODUCT → PRODUCT_DEFINITION_FORMATION/WITH_SPECIFIED_SOURCE-关联的料号通道：\n *   PART_NUMBER_PROPERTY/IDENTIFICATION 命名在 §3.3 表里列出的 PART 层通道（P4\n *   标 \"IDENTIFICATION 内核支持\" 待实测），这里尽量从 PRODUCT_DEFINITION 挂的\n *   UDA（GENERAL_PROPERTY + PROPERTY_DEFINITION）捞自定义属性。\n *\n * 所有扫描都容错：找不到就不给对应字段，绝不让解析器抛（信息性收益）。\n */\n\n/** Header 级人物贡献字段（FILE_NAME 组内的三四五参数）。 */\nexport interface StepFileMeta {\n  title?: string\n  creationDate?: string\n  designer?: string\n  author?: string\n  organization?: string\n  application?: string\n  description?: string\n  /** 自定义 FILE_DESCRIPTION/FILE_NAME 之外的 vendor 属性（metadata 笼）。 */\n  metadata?: Record<string, string>\n}\n\n/** STEP 伙伴级 P21 解析出的轻量属性。 */\nexport interface StepPartMeta {\n  /** 产品描述（PRODUCT( ..., description, id )）。空串/缺省不设。 */\n  description?: string\n  /** 自定义属性：`PROPERTY_DEFINITION(...)` + `GENERAL_PROPERTY('name', value, ...)`。 */\n  metadata?: Record<string, string>\n}\n\n/** 剥离一层引号（STEP 字符串形如 `'abc'`），出双引号化转义；去末尾换行。 */\nfunction unquote(s: string): string {\n  const t = s.trim()\n  if (t.startsWith(\"'\") && t.endsWith(\"'\")) return t.slice(1, -1)\n  return t\n}\n\n/** 任一 `HEADER`/`DATA` 段中的实体文本（多行），从 header 段中取整行。 */\nfunction headerLines(text: string): string {\n  const m = /HEADER;\\n([\\s\\S]*?)\\nENDSEC;/.exec(text)\n  return m ? m[1] : ''\n}\n\n/** `TYPE(...)` 实体块捕获：从开括号起做括号配平扫描到闭合（容错 LIST/嵌套）。 */\nfunction entityBlock(text: string, type: string): string | undefined {\n  const re = new RegExp(`${type}\\\\s*\\\\(`, 'g')\n  let m: RegExpExecArray | null\n  while ((m = re.exec(text)) !== null) {\n    let depth = 0\n    let inQuote = false\n    let i = m.index + m[0].length - 1 // 停在开括号\n    for (; i < text.length; i++) {\n      const c = text[i]\n      if (c === \"'\") inQuote = !inQuote\n      if (inQuote) continue\n      if (c === '(') depth++\n      else if (c === ')') {\n        depth--\n        if (depth === 0) return text.slice(m.index, i + 1)\n      }\n    }\n  }\n  return undefined\n}\n\n/** 逗号分隔的顶层简单参数（忽略嵌套括号内容仍按逗号简单切——够用即可）。 */\nfunction splitTopLevel(body: string): string[] {\n  // 剥离外层括号后，按未被引号包裹的逗号切分（不处理嵌套括号——STEP 伙伴级\n  // FILE_NAME/FILE_DESCRIPTION 参数都是简单标量/字符串，不涉及深层嵌套）。\n  const s = body.slice(body.indexOf('(') + 1, body.lastIndexOf(')'))\n  const parts: string[] = []\n  let cur = ''\n  let inQuote = false\n  for (let i = 0; i < s.length; i++) {\n    const c = s[i]\n    if (c === \"'\") inQuote = !inQuote\n    if (c === ',' && !inQuote) {\n      parts.push(cur)\n      cur = ''\n    } else {\n      cur += c\n    }\n  }\n  parts.push(cur)\n  return parts.map((p) => p.trim())\n}\n\n/**\n * Header 段整块（FILE_NAME / FILE_DESCRIPTION）→ `StepFileMeta`。\n *\n * @param text STEP 全文（ISO-10303-21）。\n * @returns 解析出的文件级元数据；无 header 时返回空对象。\n */\nexport function parseStepHeaderMeta(text: string): StepFileMeta {\n  const meta: StepFileMeta = {}\n  const header = headerLines(text)\n  if (!header) return meta\n\n  const fileBlock = entityBlock(header, 'FILE_NAME')\n  if (fileBlock) {\n    const parts = splitTopLevel(fileBlock)\n    // FILE_NAME(name, time_stamp, author(list), organization(list), preprocessor, originator)\n    // 引号数组形如 `('x')`，去首尾括号后 unquote；author/organization 可能为列表。\n    const inline = (p: string): string | undefined => {\n      if (!p) return undefined\n      const v = unquote(p.replace(/^\\(|\\)$/g, ''))\n      return v === '' ? undefined : v\n    }\n    const title = inline(parts[0])\n    if (title) meta.title = title\n    const cdate = inline(parts[1])\n    if (cdate) meta.creationDate = cdate\n    const author = inline(parts[2] ?? '')\n    if (author) meta.author = author\n    const org = inline(parts[3] ?? '')\n    if (org) meta.organization = org\n    // preprocessor → application（编辑器导入后端把 preprocessor 视为 APP）；\n    // originator → designer。\n    const pre = inline(parts[4] ?? '')\n    if (pre) meta.application = pre\n    const origin = inline(parts[5] ?? '')\n    if (origin) meta.designer = origin\n  }\n\n  const descBlock = entityBlock(header, 'FILE_DESCRIPTION')\n  if (descBlock) {\n    // FILE_DESCRIPTION(description_list, implementation_context)：描述只取第一个\n    // 顶层参数（描述串列表，`('a','b')` 形态含内层逗号）；实现上下文不算。\n    // 直接取 `FILE_DESCRIPTION((…),` 里第一层括号内的引号字符串列表。\n    const m = /FILE_DESCRIPTION\\s*\\(\\s*\\((.*?)\\)\\s*,\\s*/.exec(descBlock)\n    if (m) {\n      const joined = m[1]\n        .split(',')\n        .map((p) => unquote(p.trim()))\n        .filter((v) => v !== '')\n      if (joined.length > 0) meta.description = joined.join(', ')\n    }\n  }\n\n  return meta\n}\n\n/**\n * 伙伴层 `PRODUCT` 描述 + 根自定义属性（UDA，`GENERAL_PROPERTY`）解析\n * （简化：description 只取第一个 `PRODUCT`）。\n *\n * @param text STEP 全文（ISO-10303-21）。\n * @returns 解析出的部分级元数据（`description`/`metadata`）。\n */\nexport function parseStepPartMeta(text: string): StepPartMeta {\n  const out: StepPartMeta = {}\n  // 逐 PRODUCT 取 description（第 2 个参数）。\n  const dataRe = /PRODUCT\\s*\\(/g\n  let m: RegExpExecArray | null\n  while ((m = dataRe.exec(text)) !== null) {\n    const close = text.indexOf(')', m.index)\n    if (close < 0) break\n    const inner = text.slice(m.index, close + 1)\n    const descM = /,\\s*'([^']*)'/.exec(inner)\n    if (descM) {\n      const d = descM[1]\n      if (d !== '') out.description = d\n      break // 只取第一个\n    }\n  }\n  // 属性笼（UDA：GENERAL_PROPERTY('name', value?) 挂在 PROPERTY_DEFINITION 上）。\n  const props: Record<string, string> = {}\n  const gpRe = /GENERAL_PROPERTY\\s*\\(\\s*'([^']*)'\\s*,\\s*([^,)]+)/g\n  let gm: RegExpExecArray | null\n  while ((gm = gpRe.exec(text)) !== null) {\n    props[gm[1]] = unquote(gm[2])\n  }\n  if (Object.keys(props).length > 0) out.metadata = props\n  return out\n}"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faicad/faijs",
-  "version": "0.29.3",
+  "version": "0.29.5",
   "type": "module",
   "license": "Apache-2.0",
   "repository": {
@@ -168,7 +168,7 @@
     "opentype.js": "^1.3.4"
   },
   "peerDependencies": {
-    "occt-wasm": "^3.8.4",
+    "occt-wasm": "^5.6.0",
     "three": "^0.162.0 || ^0.184.0"
   },
   "devDependencies": {