@faicad/faijs 0.30.9 → 0.32.2

package/dist/cad-runtime/runtime.js

@@ -27,7 +27,7 @@ import { DirectExecutor } from './direct-executor.js';
 import { ModuleRegistry, ModuleRegistryError, isRelativeSpecifier } from './module-registry.js';
 import { computeLiveShapes, lineConsumes, blockConsumes } from './live-shapes.js';
 import { extractMetadata } from '../lang/metadata-extractor.js';
-import { configureBackends, CONTRACT_VERSION, assertContractVersion, } from '../runtime-state.js';
+import { configureBackends, CONTRACT_VERSION, assertContractVersion, configureTessellation, } from '../runtime-state.js';
 import { admitCompatLib } from './admit-compat-lib.js';
 import { hasDualOp, dualOpMetaOf } from '../define-op.js';
 import { computeLibId } from './lib-id.js';
@@ -118,7 +118,6 @@ export class CadRuntime {
     // P0 增量闸门用：上次成功执行的指纹快照
     lastParamsFingerprint = null;
     lastLibIdsFingerprint = null;
-    lastPartTransformFingerprint = null;
     lastHadKinematics = false;
     /**
      * PartName → OCCT 实体句柄，跨 execute 存活，持有所有权（顶替释放/删除/dispose 的唯一操作对象）。
@@ -246,12 +245,14 @@ export class CadRuntime {
                 if (typeof value !== 'function')
                     continue;
                 const meta = dualOpMetaOf(value);
-                if (!meta || (!meta.paramDims && !meta.retDim))
+                if (!meta || (!meta.paramDims && !meta.retDim && !meta.spec))
                     continue;
                 out[`${binding}.${name}`] = {
                     paramDims: meta.paramDims,
                     retDim: meta.retDim,
                     ...(meta.slotMap ? { slotMap: meta.slotMap } : {}),
+                    ...(meta.spec ? { spec: meta.spec } : {}),
+                    ...(meta.dimCheck ? { dimCheck: meta.dimCheck } : {}),
                 };
             }
         }
@@ -275,6 +276,8 @@ export class CadRuntime {
         this.namespaces = { ...libs };
         this.securityPolicy = options.security ?? 'strict';
         this.determinismPolicy = options.determinism ?? 'error';
+        if (options.tessellation)
+            configureTessellation(options.tessellation);
         // P6/D7: register script-side unit constants (MM, INCH, DEGREE, …) on globalThis.
         // Both the VM backend (new Function resolves free identifiers from the global scope)
         // and the interpreter backend (env.ts reads globalThis[name] for S4_SAFE_GLOBALS)
@@ -318,11 +321,8 @@ export class CadRuntime {
                 get brepEngineId() {
                     return getActiveBrepEngineId();
                 },
-                get brepCapabilities() {
-                    return brepChainOf()?.capabilities;
-                },
-                get partTransform() {
-                    return brepChainOf()?.partTransform;
+                get hostEnv() {
+                    return portsOf().hostEnv;
                 },
             },
             kernel: {
@@ -370,7 +370,6 @@ export class CadRuntime {
         this.brepChain = {
             solidCache: this.solidCache,
             kernel,
-            capabilities: engine?.capabilities,
             faceEvolutionCache: this.faceEvolutionCache,
             roleTableCache: this.roleTableCache,
             meshShapeCache: new Map(),
@@ -541,13 +540,7 @@ export class CadRuntime {
         const moduleLoad = await this.loadDirectModuleImports(meta, opts?.entryKey);
         if (!('seed' in moduleLoad))
             return moduleLoad;
-        const brepChain = await this.ensureBrepChain();
-        if (opts?.partTransform?.position) {
-            brepChain.partTransform = {
-                position: opts.partTransform.position,
-                scale: opts.partTransform.scale,
-            };
-        }
+        await this.ensureBrepChain();
         const outcome = await de.execute(code, {
             imports: moduleLoad.seed,
             params: opts?.params,
@@ -634,13 +627,7 @@ export class CadRuntime {
         const moduleLoad = await this.loadDirectModuleImports(meta, opts?.entryKey);
         if (!('seed' in moduleLoad))
             return moduleLoad;
-        const brepChain = await this.ensureBrepChain();
-        if (opts?.partTransform?.position) {
-            brepChain.partTransform = {
-                position: opts.partTransform.position,
-                scale: opts.partTransform.scale,
-            };
-        }
+        await this.ensureBrepChain();
         const outcome = await de.append(code, {
             imports: moduleLoad.seed,
             params: opts?.params,
@@ -1262,10 +1249,11 @@ export class CadRuntime {
     check(code) {
         try {
             const meta = extractMetadata(code, { defaultNs: this.defaultNsName, security: this.securityPolicy, namespaces: Object.keys(this.libs), opDims: this.buildOpDims() });
+            const dimWarnings = (meta.dimWarnings ?? []).map((w) => `line ${w.line}: ${w.message}`);
             return {
                 ok: true,
                 errors: [],
-                warnings: [],
+                warnings: dimWarnings,
                 script: {
                     statements: meta.lines.length,
                     callees: meta.lines.map((l) => l.callee),
@@ -1376,11 +1364,6 @@ export class CadRuntime {
         if (libIdsFp !== this.lastLibIdsFingerprint) {
             return this.executeDirectText(newCode, opts);
         }
-        // G8: partTransform 变化
-        const ptFp = stableFingerprint(opts?.partTransform ?? null);
-        if (ptFp !== this.lastPartTransformFingerprint) {
-            return this.executeDirectText(newCode, opts);
-        }
         // G5: 上一轮产生了装配运动学位姿
         if (this.lastHadKinematics) {
             return this.executeDirectText(newCode, opts);
@@ -1450,14 +1433,6 @@ export class CadRuntime {
         }
         // ── 派生缓存失效 ──
         this.releasePartCaches(replayKeys.map((k) => asPartName(k)));
-        // ── BREP 链与 partTransform 同步 ──
-        const brepChain = await this.ensureBrepChain();
-        if (opts?.partTransform?.position) {
-            brepChain.partTransform = {
-                position: opts.partTransform.position,
-                scale: opts.partTransform.scale,
-            };
-        }
         // ── 重放 ──
         // G4 already checked: no relative imports → moduleLoad.seed = {}
         const libLoadFailure = await this.autoLoadLibsFromImports(meta.imports);
@@ -1493,13 +1468,7 @@ export class CadRuntime {
         const libLoadFailure = await this.autoLoadLibsFromImports(meta.imports);
         if (libLoadFailure)
             return libLoadFailure;
-        const brepChain = await this.ensureBrepChain();
-        if (opts?.partTransform?.position) {
-            brepChain.partTransform = {
-                position: opts.partTransform.position,
-                scale: opts.partTransform.scale,
-            };
-        }
+        await this.ensureBrepChain();
         de.clearRoundState();
         return this.collectDirectResult(meta, opts);
     }
@@ -1510,7 +1479,6 @@ export class CadRuntime {
         this.lastParamsFingerprint = stableFingerprint(opts?.params ?? null);
         const libIdsEntries = [...this.libIds.entries()].sort((a, b) => a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0);
         this.lastLibIdsFingerprint = stableFingerprint(libIdsEntries);
-        this.lastPartTransformFingerprint = stableFingerprint(opts?.partTransform ?? null);
         this.lastHadKinematics = this.directExecutor.kinematicsSnapshot.size > 0;
     }
     // ── 公开：释放 ──
@@ -1539,16 +1507,47 @@ export class CadRuntime {
     }
 }
 // ── 工厂函数 ──
+import { createApiNamespace } from '../api/api-namespace.js';
 /**
- * Create a CadRuntime instance.
+ * Create a CadRuntime with the built-in `cad` namespace auto-registered as the
+ * default library.
+ *
+ * This is the single public `createRuntime` entry point. Hosts get "engine +
+ * standard library" in one call. If `libs` already contains a `cad` key, that
+ * caller-supplied namespace is kept (not overwritten).
+ *
  * @param ports - the host-injected environment capabilities.
  * @param mode - the execution mode (default 'auto').
- * @param libs - the host-injected library namespaces (including `cad`, which the
- * root facade injects automatically; core does not assemble it by default).
- * @param options - optional runtime options (e.g. `executor: 'direct' | 'module'`).
- * @returns a new CadRuntime.
+ * @param libs - the host-injected library namespaces. If `libs.cad` is omitted,
+ *   the built-in cad namespace is auto-registered as the default lib.
+ * @param options - optional runtime options (e.g. `execBackend`, `tessellation`).
+ * @returns a new CadRuntime with `cad` registered as the default namespace.
  */
 export function createRuntime(ports, mode, libs, options) {
+    const rt = new CadRuntime(ports, mode, libs, options);
+    if (!libs?.cad) {
+        rt.registerLib('cad', createApiNamespace(), {
+            default: true,
+            packageName: '@faicad/faijs',
+        });
+    }
+    return rt;
+}
+/**
+ * Create a bare CadRuntime without auto-registering the built-in `cad` namespace.
+ *
+ * For hosts that want a pure engine (e.g. only using the parser / runtime
+ * framework with a custom op set). `CadRuntime` itself can also be constructed
+ * directly via `new CadRuntime(...)` — this function is the named factory
+ * counterpart to avoid creating another same-name variant.
+ *
+ * @param ports - the host-injected environment capabilities.
+ * @param mode - the execution mode (default 'auto').
+ * @param libs - the host-injected library namespaces (no cad auto-registration).
+ * @param options - optional runtime options.
+ * @returns a new CadRuntime without cad registered.
+ */
+export function createBareRuntime(ports, mode, libs, options) {
     return new CadRuntime(ports, mode, libs, options);
 }
 //# sourceMappingURL=runtime.js.map