@faicad/faijs 0.13.0

package/dist/api/surface/projection-overrides.d.ts

@@ -0,0 +1,38 @@
+/**
+ * projection-overrides — P2 例外覆盖表（唯一人工维护点）。
+ *
+ * 设计文档：docs/plans/2026-09-07-compat-surface-unified-projection.md §5.4 / §9.1
+ *
+ * 规模目标：约 60~80 条（对比现状 866 条手工表，维护量下降 ~90%）。
+ * 每条 `exported` 条目必须有非 `unknown` 的 `semantics` 值（§8 验收 9）。
+ */
+export interface Override {
+    kind?: 'type' | 'pure' | 'query' | 'brep-op' | 'skip';
+    wrap?: 'raw' | 'guard' | 'dual' | 'custom';
+    semantics?: 'S1' | 'S2' | 'S3' | 'S4' | 'S5' | 'S6' | 'ok' | 'unknown';
+    /** wrap === 'custom' 时必填：手写适配器模块名 */
+    adapter?: string;
+    /** D11 参数名表（对象形态 → 位置形态） */
+    params?: string[];
+    /** 脚本面准入（§5.3 第四层） */
+    scriptFace?: boolean;
+    /** faijs 同名冲突时的导出名 */
+    rename?: string;
+    /** 指定 vendored 源文件 */
+    source?: string;
+    /** 必填：为什么这条不能被规则推导 */
+    note: string;
+}
+/**
+ * The exception override table (§5.4). Each entry overrides the classifier's
+ * automatic derivation for a specific symbol. Keys are symbol names.
+ * Entries with `semantics: 'unknown'` are forbidden from `exported` status (§8 ⑨).
+ */
+export declare const OVERRIDES: Record<string, Override>;
+/**
+ * Default semantics for symbols not in the override table.
+ * The generator fills this in, then P2 requires manual review to upgrade
+ * from 'unknown' to a specific S1-S6 or 'ok' before the symbol can be exported.
+ */
+export declare const DEFAULT_SEMANTICS: "unknown";
+//# sourceMappingURL=projection-overrides.d.ts.map

package/dist/api/surface/projection-overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-overrides.d.ts","sourceRoot":"","sources":["../../../src/api/surface/projection-overrides.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;IACrD,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;IAC1C,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAA;IACtE,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,sBAAsB;IACtB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAmJ9C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAG,SAAkB,CAAA"}

package/dist/api/surface/projection-overrides.js

@@ -0,0 +1,163 @@
+/**
+ * projection-overrides — P2 例外覆盖表（唯一人工维护点）。
+ *
+ * 设计文档：docs/plans/2026-09-07-compat-surface-unified-projection.md §5.4 / §9.1
+ *
+ * 规模目标：约 60~80 条（对比现状 866 条手工表，维护量下降 ~90%）。
+ * 每条 `exported` 条目必须有非 `unknown` 的 `semantics` 值（§8 验收 9）。
+ */
+/**
+ * The exception override table (§5.4). Each entry overrides the classifier's
+ * automatic derivation for a specific symbol. Keys are symbol names.
+ * Entries with `semantics: 'unknown'` are forbidden from `exported` status (§8 ⑨).
+ */
+export const OVERRIDES = {
+    // ── §3.6 手写面独有逻辑（4 类）──
+    box: {
+        wrap: 'custom',
+        adapter: 'box-adapter',
+        source: 'topology/primitiveFns.js',
+        semantics: 'ok',
+        note: '§3.6: {size} object form + custom E_ARGS_FORM',
+    },
+    rotate: {
+        wrap: 'custom',
+        adapter: 'rotate-adapter',
+        source: 'topology/transformFns.js',
+        semantics: 'ok',
+        note: '§3.6: upstream-18 {at,axis} options adapter (not transformFns four-arg positional)',
+    },
+    cylinder: {
+        wrap: 'raw',
+        semantics: 'ok',
+        note: 'P25: library authors want raw morph form (no kernel assert)',
+    },
+    sphere: {
+        wrap: 'raw',
+        semantics: 'ok',
+        note: 'P25: same as cylinder — raw morph form',
+    },
+    // ── §2.2 包装项（15 个已由 P1 从 compat-ast 解析，覆盖表只补充语义分级） ──
+    cone: {
+        wrap: 'dual',
+        params: ['bottomRadius', 'topRadius', 'height'],
+        semantics: 'ok',
+        note: '§2.2: wrapDual — kernel assert + D11 dual form',
+    },
+    torus: {
+        wrap: 'dual',
+        params: ['majorRadius', 'minorRadius'],
+        semantics: 'ok',
+        note: '§2.2: wrapDual',
+    },
+    ellipsoid: {
+        wrap: 'dual',
+        params: ['rx', 'ry', 'rz'],
+        semantics: 'ok',
+        note: '§2.2: wrapDual',
+    },
+    fuse: {
+        wrap: 'guard',
+        semantics: 'ok',
+        note: '§2.2: wrapGuarded — kernel assert + forward',
+    },
+    cut: {
+        wrap: 'guard',
+        semantics: 'ok',
+        note: '§2.2: wrapGuarded',
+    },
+    extrude: {
+        wrap: 'guard',
+        semantics: 'ok',
+        note: '§2.2: wrapGuarded',
+    },
+    revolve: {
+        wrap: 'guard',
+        semantics: 'ok',
+        note: '§2.2: wrapGuarded',
+    },
+    loft: {
+        wrap: 'guard',
+        scriptFace: false,
+        semantics: 'ok',
+        note: '§2.2: wrapGuarded; Wire[] input — library face only (§3.7)',
+    },
+    intersect: {
+        wrap: 'guard',
+        semantics: 'ok',
+        note: '§2.2: wrapGuarded; vendored intersect is Result contract, compat face only',
+    },
+    makeExternalGear: {
+        wrap: 'guard',
+        semantics: 'ok',
+        note: '§2.2: wrapGuarded — library builder factory (P24)',
+    },
+    makeInternalGear: {
+        wrap: 'guard',
+        semantics: 'ok',
+        note: '§2.2: wrapGuarded',
+    },
+    makePlanetaryGear: {
+        wrap: 'guard',
+        semantics: 'ok',
+        note: '§2.2: wrapGuarded',
+    },
+    thread: {
+        wrap: 'guard',
+        semantics: 'ok',
+        note: '§2.2: wrapGuarded',
+    },
+    // ── §5.3 第四层 scriptFace 覆盖 ──
+    split: {
+        scriptFace: true,
+        semantics: 'ok',
+        note: '§5.3: multi-product op but in current 27 — do not exclude by "single Shape" rule',
+    },
+    // ── §1.3 A 类规则漏洞 ──
+    io: {
+        kind: 'skip',
+        semantics: 'unknown',
+        note: '§1.3: ns.io forwards byte-type API, module field is ns not io',
+    },
+    // ── §9.1 S3: global side-effects (destructive / singleton state) ──
+    resetDisposalStats: {
+        semantics: 'S3',
+        note: '§9.1: destructive global state — clears faijs handle stats',
+    },
+    getDisposalStats: {
+        semantics: 'S3',
+        note: '§9.1: reads module-level singleton _stats',
+    },
+    kernelCall: {
+        semantics: 'S3',
+        note: '§9.1: raw kernel call bypass — global OCCT state mutation',
+    },
+    kernelCallScoped: {
+        semantics: 'S3',
+        note: '§9.1: scoped kernel call — still mutates global OCCT state',
+    },
+    // ── §9.1 S4: host-injected resource dependency (fonts / files / network) ──
+    getFont: {
+        semantics: 'S4',
+        note: '§9.1: depends on font source (host-injected vs vendored internal path)',
+    },
+    loadFont: {
+        semantics: 'S4',
+        note: '§9.1: same as getFont',
+    },
+    sketchText: {
+        semantics: 'S4',
+        note: '§9.1: same font dependency',
+    },
+    surfaceFromImage: {
+        semantics: 'S4',
+        note: '§9.1: depends on image file loading (host ports)',
+    },
+};
+/**
+ * Default semantics for symbols not in the override table.
+ * The generator fills this in, then P2 requires manual review to upgrade
+ * from 'unknown' to a specific S1-S6 or 'ok' before the symbol can be exported.
+ */
+export const DEFAULT_SEMANTICS = 'unknown';
+//# sourceMappingURL=projection-overrides.js.map

package/dist/api/surface/projection-overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-overrides.js","sourceRoot":"","sources":["../../../src/api/surface/projection-overrides.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * projection-overrides — P2 例外覆盖表（唯一人工维护点）。\n *\n * 设计文档：docs/plans/2026-09-07-compat-surface-unified-projection.md §5.4 / §9.1\n *\n * 规模目标：约 60~80 条（对比现状 866 条手工表，维护量下降 ~90%）。\n * 每条 `exported` 条目必须有非 `unknown` 的 `semantics` 值（§8 验收 9）。\n */\n\nexport interface Override {\n  kind?: 'type' | 'pure' | 'query' | 'brep-op' | 'skip'\n  wrap?: 'raw' | 'guard' | 'dual' | 'custom'\n  semantics?: 'S1' | 'S2' | 'S3' | 'S4' | 'S5' | 'S6' | 'ok' | 'unknown'\n  /** wrap === 'custom' 时必填：手写适配器模块名 */\n  adapter?: string\n  /** D11 参数名表（对象形态 → 位置形态） */\n  params?: string[]\n  /** 脚本面准入（§5.3 第四层） */\n  scriptFace?: boolean\n  /** faijs 同名冲突时的导出名 */\n  rename?: string\n  /** 指定 vendored 源文件 */\n  source?: string\n  /** 必填：为什么这条不能被规则推导 */\n  note: string\n}\n\n/**\n * The exception override table (§5.4). Each entry overrides the classifier's\n * automatic derivation for a specific symbol. Keys are symbol names.\n * Entries with `semantics: 'unknown'` are forbidden from `exported` status (§8 ⑨).\n */\nexport const OVERRIDES: Record<string, Override> = {\n  // ── §3.6 手写面独有逻辑（4 类）──\n  box: {\n    wrap: 'custom',\n    adapter: 'box-adapter',\n    source: 'topology/primitiveFns.js',\n    semantics: 'ok',\n    note: '§3.6: {size} object form + custom E_ARGS_FORM',\n  },\n  rotate: {\n    wrap: 'custom',\n    adapter: 'rotate-adapter',\n    source: 'topology/transformFns.js',\n    semantics: 'ok',\n    note: '§3.6: upstream-18 {at,axis} options adapter (not transformFns four-arg positional)',\n  },\n  cylinder: {\n    wrap: 'raw',\n    semantics: 'ok',\n    note: 'P25: library authors want raw morph form (no kernel assert)',\n  },\n  sphere: {\n    wrap: 'raw',\n    semantics: 'ok',\n    note: 'P25: same as cylinder — raw morph form',\n  },\n\n  // ── §2.2 包装项（15 个已由 P1 从 compat-ast 解析，覆盖表只补充语义分级） ──\n  cone: {\n    wrap: 'dual',\n    params: ['bottomRadius', 'topRadius', 'height'],\n    semantics: 'ok',\n    note: '§2.2: wrapDual — kernel assert + D11 dual form',\n  },\n  torus: {\n    wrap: 'dual',\n    params: ['majorRadius', 'minorRadius'],\n    semantics: 'ok',\n    note: '§2.2: wrapDual',\n  },\n  ellipsoid: {\n    wrap: 'dual',\n    params: ['rx', 'ry', 'rz'],\n    semantics: 'ok',\n    note: '§2.2: wrapDual',\n  },\n  fuse: {\n    wrap: 'guard',\n    semantics: 'ok',\n    note: '§2.2: wrapGuarded — kernel assert + forward',\n  },\n  cut: {\n    wrap: 'guard',\n    semantics: 'ok',\n    note: '§2.2: wrapGuarded',\n  },\n  extrude: {\n    wrap: 'guard',\n    semantics: 'ok',\n    note: '§2.2: wrapGuarded',\n  },\n  revolve: {\n    wrap: 'guard',\n    semantics: 'ok',\n    note: '§2.2: wrapGuarded',\n  },\n  loft: {\n    wrap: 'guard',\n    scriptFace: false,\n    semantics: 'ok',\n    note: '§2.2: wrapGuarded; Wire[] input — library face only (§3.7)',\n  },\n  intersect: {\n    wrap: 'guard',\n    semantics: 'ok',\n    note: '§2.2: wrapGuarded; vendored intersect is Result contract, compat face only',\n  },\n  makeExternalGear: {\n    wrap: 'guard',\n    semantics: 'ok',\n    note: '§2.2: wrapGuarded — library builder factory (P24)',\n  },\n  makeInternalGear: {\n    wrap: 'guard',\n    semantics: 'ok',\n    note: '§2.2: wrapGuarded',\n  },\n  makePlanetaryGear: {\n    wrap: 'guard',\n    semantics: 'ok',\n    note: '§2.2: wrapGuarded',\n  },\n  thread: {\n    wrap: 'guard',\n    semantics: 'ok',\n    note: '§2.2: wrapGuarded',\n  },\n\n  // ── §5.3 第四层 scriptFace 覆盖 ──\n  split: {\n    scriptFace: true,\n    semantics: 'ok',\n    note: '§5.3: multi-product op but in current 27 — do not exclude by \"single Shape\" rule',\n  },\n\n  // ── §1.3 A 类规则漏洞 ──\n  io: {\n    kind: 'skip',\n    semantics: 'unknown',\n    note: '§1.3: ns.io forwards byte-type API, module field is ns not io',\n  },\n\n  // ── §9.1 S3: global side-effects (destructive / singleton state) ──\n  resetDisposalStats: {\n    semantics: 'S3',\n    note: '§9.1: destructive global state — clears faijs handle stats',\n  },\n  getDisposalStats: {\n    semantics: 'S3',\n    note: '§9.1: reads module-level singleton _stats',\n  },\n  kernelCall: {\n    semantics: 'S3',\n    note: '§9.1: raw kernel call bypass — global OCCT state mutation',\n  },\n  kernelCallScoped: {\n    semantics: 'S3',\n    note: '§9.1: scoped kernel call — still mutates global OCCT state',\n  },\n\n  // ── §9.1 S4: host-injected resource dependency (fonts / files / network) ──\n  getFont: {\n    semantics: 'S4',\n    note: '§9.1: depends on font source (host-injected vs vendored internal path)',\n  },\n  loadFont: {\n    semantics: 'S4',\n    note: '§9.1: same as getFont',\n  },\n  sketchText: {\n    semantics: 'S4',\n    note: '§9.1: same font dependency',\n  },\n  surfaceFromImage: {\n    semantics: 'S4',\n    note: '§9.1: depends on image file loading (host ports)',\n  },\n}\n\n/**\n * Default semantics for symbols not in the override table.\n * The generator fills this in, then P2 requires manual review to upgrade\n * from 'unknown' to a specific S1-S6 or 'ok' before the symbol can be exported.\n */\nexport const DEFAULT_SEMANTICS = 'unknown' as const\n"]}

package/dist/api/svgExtrude.d.ts

@@ -0,0 +1,32 @@
+/**
+ * stdlib svgExtrude — SVG 挤出创建库函数（creator 函数，无输入）
+ *
+ *
+ * dispatchPath 静态判定 brep/mesh，产物经 solid()/fromBrep() 构造器创建。
+ */
+import type { Shape } from '../mesh/types.js';
+/**
+ * Validate svgExtrude parameters: `svg` is required and `depth` must be a
+ * positive number.
+ * @param params - the raw svgExtrude operation parameters.
+ */
+export declare function assertSvgExtrudeParams(params: Record<string, unknown>): void;
+/**
+ * 从二维 SVG 轮廓挤出零件（拓扑操作）。
+ * @group 创建
+ * @inputs 0
+ * @async true
+ * @qual warn
+ * @name svgExtrude
+ * @note SVG 是外部资产，应优先用资产引用（`cad.asset(key)` 经 CallRefIR）而非整份 XML 内联拷贝。自然尺寸（viewBox）与缩放已显式成参数（mesh/BREP 两条路径都解析 viewBox 并传递 naturalWidth/naturalHeight），尺寸语义不再依赖两套实现各自推导。
+ * @returns Shape SVG 挤出几何，生成独立零件。
+ * @param params.svg - SVG 内容：资产 key（推荐）或整份 SVG 文本（兼容）。type:string required:true
+ * @param params.depth - 挤出深度（mm）。type:number required:true
+ * @param params.targetLongSide - 长边目标尺寸（mm）。type:number 默认 20
+ * @example
+ * const s = await cad.svgExtrude({ svg: 'logo.svg', depth: 5, targetLongSide: 20 })
+  */
+export declare const svgExtrude: ((params: Record<string, unknown>) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../define-op.js").DualOpMeta;
+};
+//# sourceMappingURL=svgExtrude.d.ts.map

package/dist/api/svgExtrude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svgExtrude.d.ts","sourceRoot":"","sources":["../../src/api/svgExtrude.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAa1C;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAK5E;AAeD;;;;;;;;;;;;;;IAcI;AACJ,eAAO,MAAM,UAAU;;CAmBrB,CAAA"}

package/dist/api/svgExtrude.js

@@ -0,0 +1,73 @@
+/**
+ * stdlib svgExtrude — SVG 挤出创建库函数（creator 函数，无输入）
+ *
+ *
+ * dispatchPath 静态判定 brep/mesh，产物经 solid()/fromBrep() 构造器创建。
+ */
+import { cad } from '../mesh/index.js';
+import { parseSvgNaturalSize } from '../primitives/parse-svg-size.js';
+import { svgToSolid } from '../brep/svg/svg-to-solid.js';
+import { solidToShape } from '../brep/brep-ops.js';
+import { resolveSvgArg } from './internal/svg-asset-resolver.js';
+import { getBackends } from '../runtime-state.js';
+import { fromBrep } from '../shape.js';
+import { defineOp } from '../sdk.js';
+import { assertPositiveNumber } from './assert.js';
+/**
+ * Validate svgExtrude parameters: `svg` is required and `depth` must be a
+ * positive number.
+ * @param params - the raw svgExtrude operation parameters.
+ */
+export function assertSvgExtrudeParams(params) {
+    if (params.svg === undefined || params.svg === null || params.svg === '') {
+        throw new Error(`[stdlib/svgExtrude] svg is required, got ${JSON.stringify(params.svg)}`);
+    }
+    assertPositiveNumber(params.depth, 'svgExtrude.depth');
+}
+/** BREP 路径：SVG path 解析 → OCCT wire/face → extrude + fromBrep 登记。 */
+function svgExtrudeBrep(params, svgText) {
+    const kernel = getBackends().kernel.brep;
+    if (!kernel)
+        throw new Error('[stdlib/svgExtrude] no OCCT kernel');
+    const solidHandle = svgToSolid(kernel, svgText, {
+        depth: params.depth,
+        targetLongSide: params.targetLongSide ?? 20,
+    });
+    return fromBrep(solidToShape(kernel, solidHandle), { solid: solidHandle });
+}
+/**
+ * 从二维 SVG 轮廓挤出零件（拓扑操作）。
+ * @group 创建
+ * @inputs 0
+ * @async true
+ * @qual warn
+ * @name svgExtrude
+ * @note SVG 是外部资产，应优先用资产引用（`cad.asset(key)` 经 CallRefIR）而非整份 XML 内联拷贝。自然尺寸（viewBox）与缩放已显式成参数（mesh/BREP 两条路径都解析 viewBox 并传递 naturalWidth/naturalHeight），尺寸语义不再依赖两套实现各自推导。
+ * @returns Shape SVG 挤出几何，生成独立零件。
+ * @param params.svg - SVG 内容：资产 key（推荐）或整份 SVG 文本（兼容）。type:string required:true
+ * @param params.depth - 挤出深度（mm）。type:number required:true
+ * @param params.targetLongSide - 长边目标尺寸（mm）。type:number 默认 20
+ * @example
+ * const s = await cad.svgExtrude({ svg: 'logo.svg', depth: 5, targetLongSide: 20 })
+  */
+export const svgExtrude = defineOp({
+    mesh: async (params) => {
+        assertSvgExtrudeParams(params);
+        const svgText = await resolveSvgArg(params.svg, { assets: getBackends().assets });
+        // mesh 路径：与 BREP 路径一致，内部解析 SVG 自然尺寸后缩放
+        const { naturalWidth, naturalHeight } = parseSvgNaturalSize(svgText);
+        return cad.svgExtrude({
+            svg: svgText,
+            depth: params.depth,
+            targetLongSide: params.targetLongSide ?? 20,
+            naturalWidth,
+            naturalHeight,
+        });
+    },
+    brep: async (params) => {
+        assertSvgExtrudeParams(params);
+        const svgText = await resolveSvgArg(params.svg, { assets: getBackends().assets });
+        return svgExtrudeBrep(params, svgText);
+    },
+});
+//# sourceMappingURL=svgExtrude.js.map

package/dist/api/svgExtrude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svgExtrude.js","sourceRoot":"","sources":["../../src/api/svgExtrude.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAG/C;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA+B;IACpE,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,KAAK,EAAE,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC3F,CAAC;IACD,oBAAoB,CAAC,MAAM,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAA;AACxD,CAAC;AAED,oEAAoE;AACpE,SAAS,cAAc,CAAC,MAA+B,EAAE,OAAe;IACtE,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,IAA4B,CAAA;IAChE,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IAElE,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE;QAC9C,KAAK,EAAE,MAAM,CAAC,KAAe;QAC7B,cAAc,EAAG,MAAM,CAAC,cAAqC,IAAI,EAAE;KACpE,CAAC,CAAA;IAEF,OAAO,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;AAC5E,CAAC;AAED;;;;;;;;;;;;;;IAcI;AACJ,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;IACjC,IAAI,EAAE,KAAK,EAAE,MAA+B,EAAE,EAAE;QAC9C,sBAAsB,CAAC,MAAM,CAAC,CAAA;QAC9B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,MAAmC,EAAE,CAAC,CAAA;QAC9G,uCAAuC;QACvC,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAA;QACpE,OAAO,GAAG,CAAC,UAAU,CAAC;YACpB,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,MAAM,CAAC,KAAe;YAC7B,cAAc,EAAG,MAAM,CAAC,cAAqC,IAAI,EAAE;YACnE,YAAY;YACZ,aAAa;SACd,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,EAAE,KAAK,EAAE,MAA+B,EAAE,EAAE;QAC9C,sBAAsB,CAAC,MAAM,CAAC,CAAA;QAC9B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,MAAmC,EAAE,CAAC,CAAA;QAC9G,OAAO,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,CAAC;CACF,CAAC,CAAA","sourcesContent":["/**\n * stdlib svgExtrude — SVG 挤出创建库函数（creator 函数，无输入）\n *\n *\n * dispatchPath 静态判定 brep/mesh，产物经 solid()/fromBrep() 构造器创建。\n */\n\nimport type { Shape } from '../mesh/types'\nimport type { AssetResolver } from '../cad-runtime/ports'\nimport { cad } from '../mesh'\nimport { parseSvgNaturalSize } from '../primitives/parse-svg-size'\nimport { svgToSolid } from '../brep/svg/svg-to-solid'\nimport { solidToShape } from '../brep/brep-ops'\nimport { resolveSvgArg } from './internal/svg-asset-resolver'\nimport { getBackends } from '../runtime-state'\nimport { fromBrep } from '../shape'\nimport { defineOp } from '../sdk'\nimport { assertPositiveNumber } from './assert'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\n\n/**\n * Validate svgExtrude parameters: `svg` is required and `depth` must be a\n * positive number.\n * @param params - the raw svgExtrude operation parameters.\n */\nexport function assertSvgExtrudeParams(params: Record<string, unknown>): void {\n  if (params.svg === undefined || params.svg === null || params.svg === '') {\n    throw new Error(`[stdlib/svgExtrude] svg is required, got ${JSON.stringify(params.svg)}`)\n  }\n  assertPositiveNumber(params.depth, 'svgExtrude.depth')\n}\n\n/** BREP 路径：SVG path 解析 → OCCT wire/face → extrude + fromBrep 登记。 */\nfunction svgExtrudeBrep(params: Record<string, unknown>, svgText: string): Shape {\n  const kernel = getBackends().kernel.brep as BrepEngineApi | null\n  if (!kernel) throw new Error('[stdlib/svgExtrude] no OCCT kernel')\n\n  const solidHandle = svgToSolid(kernel, svgText, {\n    depth: params.depth as number,\n    targetLongSide: (params.targetLongSide as number | undefined) ?? 20,\n  })\n\n  return fromBrep(solidToShape(kernel, solidHandle), { solid: solidHandle })\n}\n\n/**\n * 从二维 SVG 轮廓挤出零件（拓扑操作）。\n * @group 创建\n * @inputs 0\n * @async true\n * @qual warn\n * @name svgExtrude\n * @note SVG 是外部资产，应优先用资产引用（`cad.asset(key)` 经 CallRefIR）而非整份 XML 内联拷贝。自然尺寸（viewBox）与缩放已显式成参数（mesh/BREP 两条路径都解析 viewBox 并传递 naturalWidth/naturalHeight），尺寸语义不再依赖两套实现各自推导。\n * @returns Shape SVG 挤出几何，生成独立零件。\n * @param params.svg - SVG 内容：资产 key（推荐）或整份 SVG 文本（兼容）。type:string required:true\n * @param params.depth - 挤出深度（mm）。type:number required:true\n * @param params.targetLongSide - 长边目标尺寸（mm）。type:number 默认 20\n * @example\n * const s = await cad.svgExtrude({ svg: 'logo.svg', depth: 5, targetLongSide: 20 })\n  */\nexport const svgExtrude = defineOp({\n  mesh: async (params: Record<string, unknown>) => {\n    assertSvgExtrudeParams(params)\n    const svgText = await resolveSvgArg(params.svg, { assets: getBackends().assets as AssetResolver | undefined })\n    // mesh 路径：与 BREP 路径一致，内部解析 SVG 自然尺寸后缩放\n    const { naturalWidth, naturalHeight } = parseSvgNaturalSize(svgText)\n    return cad.svgExtrude({\n      svg: svgText,\n      depth: params.depth as number,\n      targetLongSide: (params.targetLongSide as number | undefined) ?? 20,\n      naturalWidth,\n      naturalHeight,\n    })\n  },\n  brep: async (params: Record<string, unknown>) => {\n    assertSvgExtrudeParams(params)\n    const svgText = await resolveSvgArg(params.svg, { assets: getBackends().assets as AssetResolver | undefined })\n    return svgExtrudeBrep(params, svgText)\n  },\n})\n"]}

package/dist/api/text.d.ts

@@ -0,0 +1,34 @@
+/**
+ * stdlib text — 文字创建库函数（text）
+ *
+ *
+ * dispatchPath 静态判定 brep/mesh，产物经 solid()/fromBrep() 构造器创建。
+ */
+import type { Shape } from '../mesh/types.js';
+/**
+ * Validate text parameters: `text` must be a non-empty string, and `size` and
+ * `depth` must be positive numbers.
+ * @param params - the raw text operation parameters.
+ */
+export declare function assertTextParams(params: Record<string, unknown>): void;
+/**
+ * 生成文字零件（文字轮廓挤出，X/Z 居中、Y 底部对齐原点）。
+ * @group 创建
+ * @inputs 0
+ * @async true
+ * @qual warn
+ * @name text
+ * @returns Shape 文字几何，生成独立零件。
+ * @param maybeParams - 兼容形态的补充参数（正常不传）。type:Record<string, unknown> required:false
+ * @param inputOrParams.text - 要生成的文字。type:string required:true
+ * @param inputOrParams.size - 字号（mm）。type:number required:true
+ * @param inputOrParams.depth - 挤出深度（mm）。type:number required:true
+ * @param inputOrParams.font - 字体。type:string 默认 默认字体
+ * @note font 语义未定（当前只有默认字体），⚠️ 暂不要传。兼容 `cad.text(part0, {...})` 带输入形态（输入被忽略），正常写 `cad.text({...})` 即可。
+ * @example
+ * const t = await cad.text({ text: 'Hello', size: 20, depth: 5 })
+  */
+export declare const text: ((inputOrParams: unknown, maybeParams?: Record<string, unknown> | undefined) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../define-op.js").DualOpMeta;
+};
+//# sourceMappingURL=text.d.ts.map

package/dist/api/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/api/text.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAa1C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAMtE;AAmDD;;;;;;;;;;;;;;;;IAgBI;AACJ,eAAO,MAAM,IAAI;;CAWf,CAAA"}

package/dist/api/text.js

@@ -0,0 +1,100 @@
+/**
+ * stdlib text — 文字创建库函数（text）
+ *
+ *
+ * dispatchPath 静态判定 brep/mesh，产物经 solid()/fromBrep() 构造器创建。
+ */
+import { cad } from '../mesh/index.js';
+import { solidToShape } from '../brep/brep-ops.js';
+import { textToSolid } from '../brep/text/text-to-solid.js';
+import { ensureDefaultFont } from '../brep/text/fontRegistry.js';
+import { getSolidBoundingBox } from '../brep/brep-utils.js';
+import { containsCjk, loadSystemCjkFont } from '../primitives/text/cjk.js';
+import { getBackends } from '../runtime-state.js';
+import { fromBrep } from '../shape.js';
+import { defineOp } from '../sdk.js';
+import { assertPositiveNumber } from './assert.js';
+/**
+ * Validate text parameters: `text` must be a non-empty string, and `size` and
+ * `depth` must be positive numbers.
+ * @param params - the raw text operation parameters.
+ */
+export function assertTextParams(params) {
+    if (typeof params.text !== 'string' || params.text.trim() === '') {
+        throw new Error(`[stdlib/text] text must be a non-empty string, got ${JSON.stringify(params.text)}`);
+    }
+    assertPositiveNumber(params.size, 'text.size');
+    assertPositiveNumber(params.depth, 'text.depth');
+}
+/**
+ * BREP 路径：opentype.js → OCCT wire/face → extrude → center + fromBrep 登记。
+ *
+ * 与 mesh 路径一样，当文本包含 CJK 字符但没有 CJK 字体时，
+ * 将 CJK 字符替换为 '?' 以实现优雅降级。
+ */
+async function textBrep(params) {
+    const kernel = getBackends().kernel.brep;
+    if (!kernel)
+        throw new Error('[stdlib/text] no OCCT kernel');
+    await ensureDefaultFont();
+    const text = params.text;
+    const size = params.size;
+    const depth = params.depth;
+    // 如果文本包含 CJK 字符，检查是否有 CJK 字体
+    let renderText = text;
+    if (containsCjk(text)) {
+        const cjkResult = await loadSystemCjkFont();
+        if (!cjkResult) {
+            // 无 CJK 字体：将 CJK 字符替换为 '?' 以实现优雅降级
+            renderText = text.replace(/[\u4E00-\u9FFF\u3400-\u4DBF\u2F800-\u2FA1F\u3000-\u303F\uFF00-\uFFEF]/g, '?');
+        }
+    }
+    // 将文字转换为 OCCT solid
+    const rawSolid = textToSolid(kernel, renderText, {
+        fontSize: size,
+        depth,
+    });
+    // Center the solid to match mesh path behavior:
+    // X/Z centered at origin, Y bottom aligned to 0
+    const bbox = getSolidBoundingBox(kernel, rawSolid);
+    const cx = (bbox.min[0] + bbox.max[0]) / 2;
+    const cz = (bbox.min[2] + bbox.max[2]) / 2;
+    const centeredSolid = kernel.translate(rawSolid, -cx, -bbox.min[1], -cz);
+    kernel.release(rawSolid);
+    return fromBrep(solidToShape(kernel, centeredSolid), { solid: centeredSolid });
+}
+/** 兼容两种调用形态：`cad.text({ text, size, depth })`（创建类）与
+ * `cad.text(part0, { text, size, depth })`（历史 fixture 带输入参数，输入被忽略）。 */
+function textParamsOf(inputOrParams, maybeParams) {
+    return (maybeParams ?? inputOrParams ?? {});
+}
+/**
+ * 生成文字零件（文字轮廓挤出，X/Z 居中、Y 底部对齐原点）。
+ * @group 创建
+ * @inputs 0
+ * @async true
+ * @qual warn
+ * @name text
+ * @returns Shape 文字几何，生成独立零件。
+ * @param maybeParams - 兼容形态的补充参数（正常不传）。type:Record<string, unknown> required:false
+ * @param inputOrParams.text - 要生成的文字。type:string required:true
+ * @param inputOrParams.size - 字号（mm）。type:number required:true
+ * @param inputOrParams.depth - 挤出深度（mm）。type:number required:true
+ * @param inputOrParams.font - 字体。type:string 默认 默认字体
+ * @note font 语义未定（当前只有默认字体），⚠️ 暂不要传。兼容 `cad.text(part0, {...})` 带输入形态（输入被忽略），正常写 `cad.text({...})` 即可。
+ * @example
+ * const t = await cad.text({ text: 'Hello', size: 20, depth: 5 })
+  */
+export const text = defineOp({
+    mesh: async (inputOrParams, maybeParams) => {
+        const params = textParamsOf(inputOrParams, maybeParams);
+        assertTextParams(params);
+        return cad.text({ text: params.text, size: params.size, depth: params.depth });
+    },
+    brep: async (inputOrParams, maybeParams) => {
+        const params = textParamsOf(inputOrParams, maybeParams);
+        assertTextParams(params);
+        return textBrep(params);
+    },
+});
+//# sourceMappingURL=text.js.map

package/dist/api/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/api/text.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * stdlib text — 文字创建库函数（text）\n *\n *\n * dispatchPath 静态判定 brep/mesh，产物经 solid()/fromBrep() 构造器创建。\n */\n\nimport type { Shape } from '../mesh/types'\nimport { cad } from '../mesh'\nimport { solidToShape } from '../brep/brep-ops'\nimport { textToSolid } from '../brep/text/text-to-solid'\nimport { ensureDefaultFont } from '../brep/text/fontRegistry'\nimport { getSolidBoundingBox } from '../brep/brep-utils'\nimport { containsCjk, loadSystemCjkFont } from '../primitives/text/cjk'\nimport { getBackends } from '../runtime-state'\nimport { fromBrep } from '../shape'\nimport { defineOp } from '../sdk'\nimport { assertPositiveNumber } from './assert'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\n\n/**\n * Validate text parameters: `text` must be a non-empty string, and `size` and\n * `depth` must be positive numbers.\n * @param params - the raw text operation parameters.\n */\nexport function assertTextParams(params: Record<string, unknown>): void {\n  if (typeof params.text !== 'string' || params.text.trim() === '') {\n    throw new Error(`[stdlib/text] text must be a non-empty string, got ${JSON.stringify(params.text)}`)\n  }\n  assertPositiveNumber(params.size, 'text.size')\n  assertPositiveNumber(params.depth, 'text.depth')\n}\n\n/**\n * BREP 路径：opentype.js → OCCT wire/face → extrude → center + fromBrep 登记。\n *\n * 与 mesh 路径一样，当文本包含 CJK 字符但没有 CJK 字体时，\n * 将 CJK 字符替换为 '?' 以实现优雅降级。\n */\nasync function textBrep(params: Record<string, unknown>): Promise<Shape> {\n  const kernel = getBackends().kernel.brep as BrepEngineApi | null\n  if (!kernel) throw new Error('[stdlib/text] no OCCT kernel')\n\n  await ensureDefaultFont()\n\n  const text = params.text as string\n  const size = params.size as number\n  const depth = params.depth as number\n\n  // 如果文本包含 CJK 字符，检查是否有 CJK 字体\n  let renderText = text\n  if (containsCjk(text)) {\n    const cjkResult = await loadSystemCjkFont()\n    if (!cjkResult) {\n      // 无 CJK 字体：将 CJK 字符替换为 '?' 以实现优雅降级\n      renderText = text.replace(/[\\u4E00-\\u9FFF\\u3400-\\u4DBF\\u2F800-\\u2FA1F\\u3000-\\u303F\\uFF00-\\uFFEF]/g, '?')\n    }\n  }\n\n  // 将文字转换为 OCCT solid\n  const rawSolid = textToSolid(kernel, renderText, {\n    fontSize: size,\n    depth,\n  })\n\n  // Center the solid to match mesh path behavior:\n  // X/Z centered at origin, Y bottom aligned to 0\n  const bbox = getSolidBoundingBox(kernel, rawSolid)\n  const cx = (bbox.min[0] + bbox.max[0]) / 2\n  const cz = (bbox.min[2] + bbox.max[2]) / 2\n  const centeredSolid = kernel.translate(rawSolid, -cx, -bbox.min[1], -cz)\n  kernel.release(rawSolid)\n\n  return fromBrep(solidToShape(kernel, centeredSolid), { solid: centeredSolid })\n}\n\n/** 兼容两种调用形态：`cad.text({ text, size, depth })`（创建类）与\n * `cad.text(part0, { text, size, depth })`（历史 fixture 带输入参数，输入被忽略）。 */\nfunction textParamsOf(inputOrParams: unknown, maybeParams?: Record<string, unknown>): Record<string, unknown> {\n  return (maybeParams ?? inputOrParams ?? {}) as Record<string, unknown>\n}\n\n/**\n * 生成文字零件（文字轮廓挤出，X/Z 居中、Y 底部对齐原点）。\n * @group 创建\n * @inputs 0\n * @async true\n * @qual warn\n * @name text\n * @returns Shape 文字几何，生成独立零件。\n * @param maybeParams - 兼容形态的补充参数（正常不传）。type:Record<string, unknown> required:false\n * @param inputOrParams.text - 要生成的文字。type:string required:true\n * @param inputOrParams.size - 字号（mm）。type:number required:true\n * @param inputOrParams.depth - 挤出深度（mm）。type:number required:true\n * @param inputOrParams.font - 字体。type:string 默认 默认字体\n * @note font 语义未定（当前只有默认字体），⚠️ 暂不要传。兼容 `cad.text(part0, {...})` 带输入形态（输入被忽略），正常写 `cad.text({...})` 即可。\n * @example\n * const t = await cad.text({ text: 'Hello', size: 20, depth: 5 })\n  */\nexport const text = defineOp({\n  mesh: async (inputOrParams: unknown, maybeParams?: Record<string, unknown>) => {\n    const params = textParamsOf(inputOrParams, maybeParams)\n    assertTextParams(params)\n    return cad.text({ text: params.text as string, size: params.size as number, depth: params.depth as number })\n  },\n  brep: async (inputOrParams: unknown, maybeParams?: Record<string, unknown>) => {\n    const params = textParamsOf(inputOrParams, maybeParams)\n    assertTextParams(params)\n    return textBrep(params)\n  },\n})\n"]}

package/dist/api/topo-resolve.d.ts

@@ -0,0 +1,89 @@
+/**
+ * topo-resolve — 运行期 TopoRef 解析（装配/钻孔等面引用 op 共享，§6.2）
+ *
+ * 与 core/topology/naming 的分工：
+ * - naming（core）负责纯解析：给 ReactsContext + FaceTopoRef → ordinal/handle；
+ * - 本模块（stdlib）是「活 Shape → React块(ResolutionContext)」的引擎胶水：
+ *   从 Shape 身份槽读出运行期数据（BREP 活句柄 + RoleTable，或 setTopology 注入的
+ *   面 hint 快照），并把解析结果还原成求解需要的几何（center/normal/surfaceType）。
+ *
+ * 这样 drill（面 → 法向）与 compound/assembly（约束固定/移动面 → 几何）共用同一
+ * 条「TopoRef 执行期派生」通道，且不动 core 的纯 naming 层职责。
+ *
+ * 任何一步定不了案 → 抛 TopoRefError（三态错误码），绝不静默拿序号硬取。
+ */
+import type { Shape } from '../mesh/types.js';
+import type { BrepEngineApi } from '../brep/engine/primitives.js';
+import type { BrepHandle } from '../brep/engine/types.js';
+import { type FaceTopoRef, type ResolutionContext, type AxisHint, type RoleTable } from '../topology/naming/index.js';
+/** 求解面需要的当前几何（执行期派生）：与旧契约 fixedFace/movingFace 的 surfaceType/center/normal 同形。 */
+export interface ResolvedFaceGeometry {
+    surfaceType?: string;
+    center: [number, number, number];
+    normal: [number, number, number];
+    /** 圆柱/回转面的轴（装配轴约束用；平面/球面缺省，mesh 行快照由宿主注入）。 */
+    axis?: AxisHint;
+}
+/**
+ * 从活 Shape 的组装槽构建 ResolutionContext（BREAK 或 mesh/primitive 两条路）。
+ *
+ * - BREAK：`slot.solid` + `slot.roleTable` → 内核现场句柄 + hash（exact 路径）；
+ * - mesh/primitive：`slot.faceHints`（setTopology 注入时提炼写入）→ 行快照（geometric 路径）。
+ *
+ * 无命名槽 → undefined（调用方按 not-found 抛错）。
+ *
+ * @param kernel - the OCCT kernel (null on the mesh/primitive path).
+ * @param shape - the live input shape whose naming slot is read.
+ * @returns the resolution context (live BREP or hint rows), or undefined when the shape has no naming slot.
+ */
+export declare function buildShapeResolutionContext(kernel: BrepEngineApi | null, shape: object | undefined): ResolutionContext | undefined;
+/**
+ * 为 BREP 现场构建带边候选与邻接表的 ResolutionContext（edge TopoRef 解析用）。
+ *
+ * 与 `buildBrepResolutionContext` 的面候选同源（同一枚举序），并补充：
+ * - `edges`：边候选表（ordinal 1 起，含活句柄 + length/midpoint hint）；
+ * - `faceEdgeAdjacency` / `edgeFaceAdjacency`：邻接表（edge lineage 解析用，M3）。
+ *
+ * 只支持 BREP 现场（edge lineage 需要 face→edge 邻接）；mesh/primitive 路径
+ * 没有邻接能力（build-mesh-topology.ts:262，§5.3）→ 返回 undefined，调用方
+ * 按 E_TOPO_NOT_FOUND 处理。
+ *
+ * @param kernel - the OCCT kernel.
+ * @param shape - the live input shape whose naming slot is read.
+ * @returns the edge-enabled resolution context, or undefined when the shape has
+ *   no BREP naming slot.
+ */
+export declare function buildEdgeResolutionContext(kernel: BrepEngineApi, shape: object | undefined): ResolutionContext | undefined;
+/**
+ * 从 BREP 现场句柄建带边候选/邻接的 ResolutionContext（twoDistances 逐边重建用）。
+ *
+ * 与 `buildEdgeResolutionContext` 相同，但直接接收 live solid 句柄而非 Shape 槽——
+ * 用于真机逐边构建后，输入已从上一次结果演化，Shape 槽里的 roleTable/hash 不再
+ * 与当前句柄对应（§3.6 逐边构建，后续边要重新 resolve）。
+ *
+ * @param kernel - the OCCT kernel.
+ * @param solid - the live BREP solid handle.
+ * @param roleTable - optional role table to carry over (not used for strict matching).
+ * @returns the edge-enabled resolution context (faces/edges/adjacency live from `solid`).
+ */
+export declare function buildEdgeContextFromSolid(kernel: BrepEngineApi, solid: BrepHandle, roleTable?: RoleTable): ResolutionContext;
+/**
+ * 解析一个 face TopoRef 到「当前几何」，并从解析出的候选面派生求解几何。
+ *
+ * 结果与命名行的 surfaceType/center/normal 同口径（BREAK 现场 captureFaceHint /
+ * mesh 行快照），保证两侧派生值一致。
+ *
+ * @param kernel - the OCCT kernel (can be null on the mesh/primitive path).
+ * @param shape - the live input shape whose naming slot is being resolved.
+ * @param ref - the FaceTopoRef captured earlier.
+ * @returns the current face geometry (center/normal/surfaceType).
+ */
+export declare function resolveFaceGeometry(kernel: BrepEngineApi | null, shape: Shape, ref: FaceTopoRef): ResolvedFaceGeometry;
+/**
+ * FaceMateConstraint 面的等价重载：face 参数对象（`{topoRef}` 或旧快照）的守卫。
+ *
+ * @param v - the value to test.
+ * @returns true when the value is a FaceTopoRef (kind === 'face').
+ */
+export declare function isFaceTopoRef(v: unknown): v is FaceTopoRef;
+//# sourceMappingURL=topo-resolve.d.ts.map

package/dist/api/topo-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topo-resolve.d.ts","sourceRoot":"","sources":["../../src/api/topo-resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEtD,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,iBAAiB,EAEtB,KAAK,QAAQ,EAEb,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAA;AAE3B,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,QAAQ,CAAA;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,aAAa,GAAG,IAAI,EAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,iBAAiB,GAAG,SAAS,CAoB/B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,iBAAiB,GAAG,SAAS,CAwC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,UAAU,EACjB,SAAS,CAAC,EAAE,SAAS,GACpB,iBAAiB,CAyBnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,GAAG,IAAI,EAC5B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,WAAW,GACf,oBAAoB,CAqCtB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAE1D"}