@faicad/faijs 0.29.3 → 0.30.9

package/dist/occt-kernel/stepMetaParser.js

@@ -0,0 +1,166 @@
+/**
+ * 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 / FILE_SCHEMA）→ FileMeta。 */
+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 描述 + 根相关字段解析（简化：只取第一个 PRODUCT）。 */
+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/occt-kernel/stepMetaParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepMetaParser.js","sourceRoot":"","sources":["../../src/occt-kernel/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/** Header 段整块（FILE_NAME / FILE_DESCRIPTION / FILE_SCHEMA）→ FileMeta。 */\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/** 伙伴层 PRODUCT 描述 + 根相关字段解析（简化：只取第一个 PRODUCT）。 */\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/dist/occt-scan/recognize.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @internal — occt-scan 识别层（仅供 `scripts/scan-occt-op-coverage.ts` 与回归测试使用，
+ * 不是 faijs 公开 API，勿从业务代码 import）。
+ *
+ * 识别「occt 原生内核直调」的源码分析。判据（方案 §7.2 缺陷 1 + §7.5 陷阱 1）：
+ * 只有从 `getOcctKernel()` / `getKernel()` / `initOcctWasm()` 拿到的变量才是 occt 原生
+ * 句柄；`const kernel = getBrepApi()`（L1 契约句柄）的调用**不**算 occt 直调——把它的
+ * 方法调用算进去会把中立 op 全误判成平台 op。
+ *
+ * 用 TypeScript AST（ts.createSourceFile）做语法层分析，按符号声明位置判定，能穿透
+ * §7.2 要求的三类形态（正则在此处两头都错，见方案）：
+ *   - `const x = <handle>.<m>.bind(k)`     → x(...) 与绑定点的 `<m>` 都计入
+ *   - `(<cast>).<m>.call(k, ...)`             → `<m>` 计入
+ *   - `const { m } = <handle>` 解构           → 别名 m(...) 调用计入
+ *   以及最普通 `<handle>.<m>(...)` 链式直调。
+ */
+/**
+ * 收集文件里「持有 occt 内核」的标识符集合。
+ *
+ * - 直接获取：`const k = getOcctKernel()` / `await initOcctWasm()` / `getKernel()`。
+ * - 派生别名不动点：`const raw = k as unknown as T` 等其初始化式判定为内核派生者的
+ *   局部 const 也收为内核标识（覆盖层层 cast/别名）。
+ *
+ * 注意：`getBrepApi()` 不在内核获取器之列，故 `const kernel = getBrepApi()` 的 `kernel`
+ * 不会进入返回值——§7.5 陷阱 1 的防线。
+ *
+ * @param src 待扫描的 TS 源码文本。
+ * @returns 内核标识符（变量名）集合，按字典序排列。
+ */
+export declare function kernelIdentifiers(src: string): Set<string>;
+/**
+ * 收集「方法别名」：把 occt 方法绑定/解构到局部变量后，后续 `alias(...)` 调用要还原
+ * 成底层方法名。形态：
+ *   - `const x = <内核值>.<m>.bind(k)`             → x ⇒ m（覆盖 `raw.linearPattern.bind(k)` 后 `nativeLP(...)`）
+ *   - `const { m } = <内核值>` / `{ m: mm }`          → m ⇒ m / mm ⇒ m（解构）
+ * 只认内核派生基；`kernel = getBrepApi()` 的 .m 不作数（§7.5 陷阱 1）。
+ *
+ * @param src 待扫描的 TS 源码文本。
+ * @param kernelIds 内核标识符集合（来自 {@link kernelIdentifiers}）。
+ * @returns 别名 → 底层 occt 方法名的映射。
+ */
+export declare function methodAliases(src: string, kernelIds: Set<string>): Map<string, string>;
+/**
+ * 返回 src 里被调用的、基类是内核派生的 occt 方法名（与 occtNames 交集）。
+ *
+ * 覆盖形态（§7.2 缺陷 1）：
+ *   - `<k>.method(`                    普通直调（k 为内核标识）
+ *   - `getOcctKernel().method(...)`      链式（调用表达式基即内核）→ 属性访问基命中
+ *   - `raw.method.bind(k)` / `(<cast>).m.call(k,…)`   绑定点属性访问把 `<m>` 计入
+ *   - `const x = k.m.bind(...); x(...)` const 绑定别名调用
+ *   - `const { m } = k; m(...)`          解构别名调用
+ *
+ * @param src 待扫描的 TS 源码文本。
+ * @param occtNames occt 方法名全集（用于交集过滤）。
+ * @returns 被调用的 occt 方法名集合。
+ */
+export declare function kernelCallsIn(src: string, occtNames: Set<string>): Set<string>;
+//# sourceMappingURL=recognize.d.ts.map

package/dist/occt-scan/recognize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recognize.d.ts","sourceRoot":"","sources":["../../src/occt-scan/recognize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA8DH;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CA8B1D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAmCtF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CA2B9E"}

package/dist/occt-scan/recognize.js

@@ -0,0 +1,216 @@
+/**
+ * @internal — occt-scan 识别层（仅供 `scripts/scan-occt-op-coverage.ts` 与回归测试使用，
+ * 不是 faijs 公开 API，勿从业务代码 import）。
+ *
+ * 识别「occt 原生内核直调」的源码分析。判据（方案 §7.2 缺陷 1 + §7.5 陷阱 1）：
+ * 只有从 `getOcctKernel()` / `getKernel()` / `initOcctWasm()` 拿到的变量才是 occt 原生
+ * 句柄；`const kernel = getBrepApi()`（L1 契约句柄）的调用**不**算 occt 直调——把它的
+ * 方法调用算进去会把中立 op 全误判成平台 op。
+ *
+ * 用 TypeScript AST（ts.createSourceFile）做语法层分析，按符号声明位置判定，能穿透
+ * §7.2 要求的三类形态（正则在此处两头都错，见方案）：
+ *   - `const x = <handle>.<m>.bind(k)`     → x(...) 与绑定点的 `<m>` 都计入
+ *   - `(<cast>).<m>.call(k, ...)`             → `<m>` 计入
+ *   - `const { m } = <handle>` 解构           → 别名 m(...) 调用计入
+ *   以及最普通 `<handle>.<m>(...)` 链式直调。
+ */
+import ts from 'typescript';
+/** 返回函数调用表达式的被调用名（裸标识符或属性名），否则 null。 */
+function calleeName(callee) {
+    if (!callee)
+        return null;
+    if (ts.isIdentifier(callee))
+        return callee.text;
+    if (ts.isPropertyAccessExpression(callee))
+        return callee.name.text;
+    return null;
+}
+/** 去掉括号/类型断言/`as`/`!`/`satisfies`，拿到最内层表达式。 */
+function unwrap(n) {
+    let x = n;
+    for (;;) {
+        if (ts.isParenthesizedExpression(x))
+            x = x.expression;
+        else if (ts.isAsExpression(x))
+            x = x.expression;
+        else if (ts.isTypeAssertionExpression(x))
+            x = x.expression;
+        else if (ts.isNonNullExpression(x))
+            x = x.expression;
+        else if (ts.isSatisfiesExpression?.(x)) {
+            x = x.expression;
+        }
+        else
+            break;
+    }
+    return x;
+}
+function makeIsKernel(kernelIds) {
+    return (e) => {
+        const u = unwrap(e);
+        if (ts.isIdentifier(u))
+            return kernelIds.has(u.text);
+        if (ts.isCallExpression(u)) {
+            const nm = calleeName(u.expression);
+            return nm === 'getOcctKernel' || nm === 'getKernel' || nm === 'initOcctWasm';
+        }
+        return false;
+    };
+}
+/** 绑定模式里导出的名字。 */
+function bindingNames(name) {
+    if (ts.isIdentifier(name))
+        return [name.text];
+    const out = [];
+    if (ts.isObjectBindingPattern(name)) {
+        for (const el of name.elements) {
+            if (ts.isBindingElement(el)) {
+                const prop = el.propertyName ? el.propertyName.getText() : el.name.getText();
+                out.push(prop);
+            }
+        }
+    }
+    else if (ts.isArrayBindingPattern(name)) {
+        for (const el of name.elements) {
+            if (ts.isBindingElement(el) && ts.isIdentifier(el.name))
+                out.push(el.name.text);
+            else if (ts.isBindingElement(el))
+                out.push(...bindingNames(el.name));
+        }
+    }
+    return out;
+}
+/**
+ * 收集文件里「持有 occt 内核」的标识符集合。
+ *
+ * - 直接获取：`const k = getOcctKernel()` / `await initOcctWasm()` / `getKernel()`。
+ * - 派生别名不动点：`const raw = k as unknown as T` 等其初始化式判定为内核派生者的
+ *   局部 const 也收为内核标识（覆盖层层 cast/别名）。
+ *
+ * 注意：`getBrepApi()` 不在内核获取器之列，故 `const kernel = getBrepApi()` 的 `kernel`
+ * 不会进入返回值——§7.5 陷阱 1 的防线。
+ *
+ * @param src 待扫描的 TS 源码文本。
+ * @returns 内核标识符（变量名）集合，按字典序排列。
+ */
+export function kernelIdentifiers(src) {
+    const sf = ts.createSourceFile('recognize.ts', src, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const KERNEL_ACQUIRE = /(?:const|let|var)\s+([A-Za-z_$][\w$]*)[^;=\n]*?=\s*(?:await\s+)?[^;\n]*(?:getOcctKernel|getKernel|initOcctWasm)\s*\(\s*\)/g;
+    const kernelIds = new Set();
+    KERNEL_ACQUIRE.lastIndex = 0;
+    for (let m = KERNEL_ACQUIRE.exec(src); m; m = KERNEL_ACQUIRE.exec(src))
+        kernelIds.add(m[1]);
+    // 收集文件内所有变声明的「名 → 初始化式」。
+    const initByVar = new Map();
+    (function collect(n) {
+        if (ts.isVariableDeclaration(n) && n.initializer) {
+            for (const nm of bindingNames(n.name))
+                initByVar.set(nm, n.initializer);
+        }
+        ts.forEachChild(n, collect);
+    })(sf);
+    const isKernelInDecl = makeIsKernel(kernelIds);
+    let changed = true;
+    while (changed) {
+        changed = false;
+        for (const [name, init] of initByVar) {
+            if (!kernelIds.has(name) && isKernelInDecl(init)) {
+                kernelIds.add(name);
+                changed = true;
+            }
+        }
+    }
+    return new Set([...kernelIds].sort());
+}
+/**
+ * 收集「方法别名」：把 occt 方法绑定/解构到局部变量后，后续 `alias(...)` 调用要还原
+ * 成底层方法名。形态：
+ *   - `const x = <内核值>.<m>.bind(k)`             → x ⇒ m（覆盖 `raw.linearPattern.bind(k)` 后 `nativeLP(...)`）
+ *   - `const { m } = <内核值>` / `{ m: mm }`          → m ⇒ m / mm ⇒ m（解构）
+ * 只认内核派生基；`kernel = getBrepApi()` 的 .m 不作数（§7.5 陷阱 1）。
+ *
+ * @param src 待扫描的 TS 源码文本。
+ * @param kernelIds 内核标识符集合（来自 {@link kernelIdentifiers}）。
+ * @returns 别名 → 底层 occt 方法名的映射。
+ */
+export function methodAliases(src, kernelIds) {
+    const sf = ts.createSourceFile('aliases.ts', src, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const isKernelIdent = makeIsKernel(kernelIds);
+    const alias = new Map();
+    for (const stmt of sf.statements) {
+        if (!ts.isVariableStatement(stmt))
+            continue;
+        for (const d of stmt.declarationList.declarations) {
+            if (!d.initializer)
+                continue;
+            // 形态 1：`const x = <值>.<m>.bind(k)` / `<值>.<m>.call(k, …)` ，<值> 是内核
+            if (ts.isIdentifier(d.name) || ts.isObjectBindingPattern(d.name)) {
+                const names = bindingNames(d.name);
+                // 解构出别名：const { m: mm } = kernel
+                if (ts.isObjectBindingPattern(d.name)) {
+                    for (const el of d.name.elements) {
+                        if (ts.isBindingElement(el)) {
+                            const mth = el.propertyName ? el.propertyName.getText() : el.name.getText();
+                            alias.set(el.name.getText(), mth);
+                        }
+                    }
+                }
+                if (names.length === 1 && ts.isCallExpression(d.initializer)) {
+                    const init = d.initializer;
+                    const outerName = calleeName(init.expression);
+                    if (outerName === 'bind' || outerName === 'call') {
+                        const prop = init.expression;
+                        if (ts.isPropertyAccessExpression(prop) && ts.isPropertyAccessExpression(prop.expression) && isKernelIdent(prop.expression.expression)) {
+                            alias.set(names[0], prop.name.text);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return alias;
+}
+/**
+ * 返回 src 里被调用的、基类是内核派生的 occt 方法名（与 occtNames 交集）。
+ *
+ * 覆盖形态（§7.2 缺陷 1）：
+ *   - `<k>.method(`                    普通直调（k 为内核标识）
+ *   - `getOcctKernel().method(...)`      链式（调用表达式基即内核）→ 属性访问基命中
+ *   - `raw.method.bind(k)` / `(<cast>).m.call(k,…)`   绑定点属性访问把 `<m>` 计入
+ *   - `const x = k.m.bind(...); x(...)` const 绑定别名调用
+ *   - `const { m } = k; m(...)`          解构别名调用
+ *
+ * @param src 待扫描的 TS 源码文本。
+ * @param occtNames occt 方法名全集（用于交集过滤）。
+ * @returns 被调用的 occt 方法名集合。
+ */
+export function kernelCallsIn(src, occtNames) {
+    const sf = ts.createSourceFile('scan.ts', src, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const kernelIds = kernelIdentifiers(src);
+    const alias = methodAliases(src, kernelIds);
+    const isKernelIdent = makeIsKernel(kernelIds);
+    const out = new Set();
+    const visit = (n) => {
+        // 别名调用：`nativeLP(...)` / `lp(...)` / `m(...)` 还原底层方法名
+        if (ts.isCallExpression(n)) {
+            const nm = calleeName(n.expression);
+            if (nm && alias.has(nm)) {
+                const real = alias.get(nm);
+                if (occtNames.has(real))
+                    out.add(real);
+            }
+        }
+        // 内核派生基 . 属性访问 → 属性是 occt 方法（属性访问即方法引用/调用）
+        if (ts.isPropertyAccessExpression(n)) {
+            if (isKernelIdent(n.expression)) {
+                const name = n.name.text;
+                if (occtNames.has(name))
+                    out.add(name);
+            }
+        }
+        ts.forEachChild(n, visit);
+    };
+    visit(sf);
+    return out;
+}
+//# sourceMappingURL=recognize.js.map

package/dist/occt-scan/recognize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recognize.js","sourceRoot":"","sources":["../../src/occt-scan/recognize.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @internal — occt-scan 识别层（仅供 `scripts/scan-occt-op-coverage.ts` 与回归测试使用，\n * 不是 faijs 公开 API，勿从业务代码 import）。\n *\n * 识别「occt 原生内核直调」的源码分析。判据（方案 §7.2 缺陷 1 + §7.5 陷阱 1）：\n * 只有从 `getOcctKernel()` / `getKernel()` / `initOcctWasm()` 拿到的变量才是 occt 原生\n * 句柄；`const kernel = getBrepApi()`（L1 契约句柄）的调用**不**算 occt 直调——把它的\n * 方法调用算进去会把中立 op 全误判成平台 op。\n *\n * 用 TypeScript AST（ts.createSourceFile）做语法层分析，按符号声明位置判定，能穿透\n * §7.2 要求的三类形态（正则在此处两头都错，见方案）：\n *   - `const x = <handle>.<m>.bind(k)`     → x(...) 与绑定点的 `<m>` 都计入\n *   - `(<cast>).<m>.call(k, ...)`             → `<m>` 计入\n *   - `const { m } = <handle>` 解构           → 别名 m(...) 调用计入\n *   以及最普通 `<handle>.<m>(...)` 链式直调。\n */\n\nimport ts from 'typescript'\n\n/** 返回函数调用表达式的被调用名（裸标识符或属性名），否则 null。 */\nfunction calleeName(callee: ts.Expression | undefined): string | null {\n  if (!callee) return null\n  if (ts.isIdentifier(callee)) return callee.text\n  if (ts.isPropertyAccessExpression(callee)) return callee.name.text\n  return null\n}\n\n/** 去掉括号/类型断言/`as`/`!`/`satisfies`，拿到最内层表达式。 */\nfunction unwrap(n: ts.Expression): ts.Expression {\n  let x = n\n  for (;;) {\n    if (ts.isParenthesizedExpression(x)) x = x.expression\n    else if (ts.isAsExpression(x)) x = x.expression\n    else if (ts.isTypeAssertionExpression(x)) x = x.expression\n    else if (ts.isNonNullExpression(x)) x = x.expression\n    else if ((ts as unknown as { isSatisfiesExpression?: (x: ts.Node) => boolean }).isSatisfiesExpression?.(x)) {\n      x = (x as ts.Expression & { expression: ts.Expression }).expression\n    } else break\n  }\n  return x\n}\n\n/** 一个表达式是否「判定为 occt 内核派生句柄」（依据 kernelIds + 直接获取器）。 */\ntype IsKernel = (e: ts.Expression) => boolean\n\nfunction makeIsKernel(kernelIds: Set<string>): IsKernel {\n  return (e) => {\n    const u = unwrap(e)\n    if (ts.isIdentifier(u)) return kernelIds.has(u.text)\n    if (ts.isCallExpression(u)) {\n      const nm = calleeName(u.expression)\n      return nm === 'getOcctKernel' || nm === 'getKernel' || nm === 'initOcctWasm'\n    }\n    return false\n  }\n}\n\n/** 绑定模式里导出的名字。 */\nfunction bindingNames(name: ts.BindingName): string[] {\n  if (ts.isIdentifier(name)) return [name.text]\n  const out: string[] = []\n  if (ts.isObjectBindingPattern(name)) {\n    for (const el of name.elements) {\n      if (ts.isBindingElement(el)) {\n        const prop = el.propertyName ? el.propertyName.getText() : el.name.getText()\n        out.push(prop)\n      }\n    }\n  } else if (ts.isArrayBindingPattern(name)) {\n    for (const el of name.elements) {\n      if (ts.isBindingElement(el) && ts.isIdentifier(el.name)) out.push(el.name.text)\n      else if (ts.isBindingElement(el)) out.push(...bindingNames(el.name))\n    }\n  }\n  return out\n}\n\n/**\n * 收集文件里「持有 occt 内核」的标识符集合。\n *\n * - 直接获取：`const k = getOcctKernel()` / `await initOcctWasm()` / `getKernel()`。\n * - 派生别名不动点：`const raw = k as unknown as T` 等其初始化式判定为内核派生者的\n *   局部 const 也收为内核标识（覆盖层层 cast/别名）。\n *\n * 注意：`getBrepApi()` 不在内核获取器之列，故 `const kernel = getBrepApi()` 的 `kernel`\n * 不会进入返回值——§7.5 陷阱 1 的防线。\n *\n * @param src 待扫描的 TS 源码文本。\n * @returns 内核标识符（变量名）集合，按字典序排列。\n */\nexport function kernelIdentifiers(src: string): Set<string> {\n  const sf = ts.createSourceFile('recognize.ts', src, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS)\n\n  const KERNEL_ACQUIRE =\n    /(?:const|let|var)\\s+([A-Za-z_$][\\w$]*)[^;=\\n]*?=\\s*(?:await\\s+)?[^;\\n]*(?:getOcctKernel|getKernel|initOcctWasm)\\s*\\(\\s*\\)/g\n  const kernelIds = new Set<string>()\n  KERNEL_ACQUIRE.lastIndex = 0\n  for (let m = KERNEL_ACQUIRE.exec(src); m; m = KERNEL_ACQUIRE.exec(src)) kernelIds.add(m[1])\n\n  // 收集文件内所有变声明的「名 → 初始化式」。\n  const initByVar = new Map<string, ts.Expression>()\n  ;(function collect(n: ts.Node): void {\n    if (ts.isVariableDeclaration(n) && n.initializer) {\n      for (const nm of bindingNames(n.name)) initByVar.set(nm, n.initializer)\n    }\n    ts.forEachChild(n, collect)\n  })(sf)\n\n  const isKernelInDecl = makeIsKernel(kernelIds)\n  let changed = true\n  while (changed) {\n    changed = false\n    for (const [name, init] of initByVar) {\n      if (!kernelIds.has(name) && isKernelInDecl(init)) {\n        kernelIds.add(name)\n        changed = true\n      }\n    }\n  }\n  return new Set([...kernelIds].sort())\n}\n\n/**\n * 收集「方法别名」：把 occt 方法绑定/解构到局部变量后，后续 `alias(...)` 调用要还原\n * 成底层方法名。形态：\n *   - `const x = <内核值>.<m>.bind(k)`             → x ⇒ m（覆盖 `raw.linearPattern.bind(k)` 后 `nativeLP(...)`）\n *   - `const { m } = <内核值>` / `{ m: mm }`          → m ⇒ m / mm ⇒ m（解构）\n * 只认内核派生基；`kernel = getBrepApi()` 的 .m 不作数（§7.5 陷阱 1）。\n *\n * @param src 待扫描的 TS 源码文本。\n * @param kernelIds 内核标识符集合（来自 {@link kernelIdentifiers}）。\n * @returns 别名 → 底层 occt 方法名的映射。\n */\nexport function methodAliases(src: string, kernelIds: Set<string>): Map<string, string> {\n  const sf = ts.createSourceFile('aliases.ts', src, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS)\n  const isKernelIdent = makeIsKernel(kernelIds)\n  const alias = new Map<string, string>()\n\n  for (const stmt of sf.statements as unknown as ts.Node[]) {\n    if (!ts.isVariableStatement(stmt)) continue\n    for (const d of stmt.declarationList.declarations) {\n      if (!d.initializer) continue\n      // 形态 1：`const x = <值>.<m>.bind(k)` / `<值>.<m>.call(k, …)` ，<值> 是内核\n      if (ts.isIdentifier(d.name) || ts.isObjectBindingPattern(d.name)) {\n        const names = bindingNames(d.name)\n        // 解构出别名：const { m: mm } = kernel\n        if (ts.isObjectBindingPattern(d.name)) {\n          for (const el of d.name.elements) {\n            if (ts.isBindingElement(el)) {\n              const mth = el.propertyName ? el.propertyName.getText() : el.name.getText()\n              alias.set(el.name.getText(), mth)\n            }\n          }\n        }\n        if (names.length === 1 && ts.isCallExpression(d.initializer)) {\n          const init = d.initializer\n          const outerName = calleeName(init.expression)\n          if (outerName === 'bind' || outerName === 'call') {\n            const prop = init.expression as ts.PropertyAccessExpression\n            if (ts.isPropertyAccessExpression(prop) && ts.isPropertyAccessExpression(prop.expression) && isKernelIdent(prop.expression.expression)) {\n              alias.set(names[0]!, prop.name.text)\n            }\n          }\n        }\n      }\n    }\n  }\n  return alias\n}\n\n/**\n * 返回 src 里被调用的、基类是内核派生的 occt 方法名（与 occtNames 交集）。\n *\n * 覆盖形态（§7.2 缺陷 1）：\n *   - `<k>.method(`                    普通直调（k 为内核标识）\n *   - `getOcctKernel().method(...)`      链式（调用表达式基即内核）→ 属性访问基命中\n *   - `raw.method.bind(k)` / `(<cast>).m.call(k,…)`   绑定点属性访问把 `<m>` 计入\n *   - `const x = k.m.bind(...); x(...)` const 绑定别名调用\n *   - `const { m } = k; m(...)`          解构别名调用\n *\n * @param src 待扫描的 TS 源码文本。\n * @param occtNames occt 方法名全集（用于交集过滤）。\n * @returns 被调用的 occt 方法名集合。\n */\nexport function kernelCallsIn(src: string, occtNames: Set<string>): Set<string> {\n  const sf = ts.createSourceFile('scan.ts', src, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS)\n  const kernelIds = kernelIdentifiers(src)\n  const alias = methodAliases(src, kernelIds)\n  const isKernelIdent = makeIsKernel(kernelIds)\n  const out = new Set<string>()\n\n  const visit = (n: ts.Node): void => {\n    // 别名调用：`nativeLP(...)` / `lp(...)` / `m(...)` 还原底层方法名\n    if (ts.isCallExpression(n)) {\n      const nm = calleeName(n.expression)\n      if (nm && alias.has(nm)) {\n        const real = alias.get(nm)!\n        if (occtNames.has(real)) out.add(real)\n      }\n    }\n    // 内核派生基 . 属性访问 → 属性是 occt 方法（属性访问即方法引用/调用）\n    if (ts.isPropertyAccessExpression(n)) {\n      if (isKernelIdent(n.expression)) {\n        const name = n.name.text\n        if (occtNames.has(name)) out.add(name)\n      }\n    }\n    ts.forEachChild(n, visit)\n  }\n  visit(sf)\n  return out\n}"]}

package/dist/primitives/brep-primitives.js

@@ -63,10 +63,10 @@ function applyCenter(kernel, solid, center) {
     return translated;
 }
 /**
- * 用 OCCT 直接构造一个长方体 Solid（brepjs `box(width, depth, height,
+ * 用 OCCT 直接构造一个长方体 Solid（原 brepjs `box(width, depth, height,
  * {at?, centered?})` 契约，§4.1 A 决策；与 mesh 路径逐点对齐）。
  *
- * 几何语义与 vendored `primitiveFns.box` 完全一致：
+ * 几何语义与旧 `primitiveFns.box` 完全一致：
  * 默认 min 角点在原点；`centered:true`（无 at 时）居中到原点；`at` 为中心
  * 语义且优先于 `centered`。
  */
@@ -74,7 +74,7 @@ function cubeToCadSolid(kernel, params) {
     const w = params.width;
     const d = params.depth;
     const h = params.height;
-    // brepjs box: center = at ?? (centered ? [0,0,0] : undefined)；未给 center →
+    // 原 brepjs box: center = at ?? (centered ? [0,0,0] : undefined)；未给 center →
     // 构造角点实体不平移（这里统一中心构造 + 平移量，等价）。
     const center = params.at !== undefined
         ? params.at
@@ -94,10 +94,10 @@ function sphereToCadSolid(kernel, params) {
     return applyCenter(kernel, solid, params.center);
 }
 /**
- * 用 OCCT 直接构造一个圆柱体 Solid（brepjs `cylinder(radius, height, {
+ * 用 OCCT 直接构造一个圆柱体 Solid（原 brepjs `cylinder(radius, height, {
  * at, centered })` 契约，§4.3 A 决策；与 mesh 路径逐点对齐）。
  *
- * 锚点同 vendored `primitiveFns.cylinder`：`at` 是底面轴心（BASE）语义（默认
+ * 锚点同旧 `primitiveFns.cylinder`：`at` 是底面轴心（BASE）语义（默认
  * [0,0,0]），OCCT makeCylinder 原生从 z=0 沿 +Z 建高 → 无需重居中；`centered:true`
  * 指底面沿轴下移 −h/2（无 at 时居中到原点；与 `at` 同给时以 `at` 为中心）。
  */
@@ -114,10 +114,10 @@ function cylinderToCadSolid(kernel, params) {
     return solid;
 }
 /**
- * 用 OCCT 直接构造一个圆锥体 Solid（brepjs `cone(bottomRadius, topRadius,
+ * 用 OCCT 直接构造一个圆锥体 Solid（原 brepjs `cone(bottomRadius, topRadius,
  * height, { at, centered })` 契约，§4.1 P 决策；与 mesh 路径逐点对齐）。
  *
- * 锚点同 vendored `primitiveFns.cone`：`at` 是底面轴心（BASE）语义（默认
+ * 锚点同旧 `primitiveFns.cone`：`at` 是底面轴心（BASE）语义（默认
  * [0,0,0]），OCCT makeCone 原生从 z=0 沿 +Z 建高 → 无需重居中；`centered:true`
  * 指底面沿轴下移 −h/2（无 at 时居中到原点；与 `at` 同给时以 `at` 为中心）。
  */