@faicad/faijs 0.14.1 → 0.16.0

package/dist/api/internal/replica-role-table.d.ts

@@ -0,0 +1,36 @@
+/**
+ * replica-role-table — generalized replica[k] role-table builder (Phase 3 L3).
+ *
+ * Shared by the handwritten replicate ops (circularPattern / gridPattern /
+ * rectangularPattern / mirrorJoin). Every replica is a rigid transform T_k of
+ * the input; result faces = ∪ T_k(input faces). For each result face, its
+ * centroid is mapped back through T_k⁻¹ into input coordinates and matched to
+ * the nearest input-face centroid, recovering the input role, prefixed with
+ * the replica label: `replica[k]/<inner>`.
+ *
+ * Same mechanism as pattern.ts linearPattern (centroid clustering), generalized
+ * from a projection along one direction to arbitrary per-replica inverses.
+ */
+import type { Shape } from '../../mesh/types.js';
+import type { BrepHandle, BrepVec3 } from '../../brep/engine/types.js';
+import type { BrepEngineApi } from '../../brep/engine/primitives.js';
+import type { RoleTable } from '../../topology/naming/types.js';
+/** One replica: role-table label prefix + inverse of its placement transform. */
+export interface ReplicaTransform {
+    /** Label prefix, e.g. 'replica[2]' / 'replica[1_0]'. */
+    label: string;
+    /** Map a result-face centroid back into the input coordinate frame (T_k⁻¹). */
+    inverse: (c: BrepVec3) => BrepVec3;
+}
+/**
+ * Build the `replica[*]/<inner>` role table for a fused multi-replica result.
+ *
+ * @param kernel - the BREP engine api.
+ * @param input - the source Shape (its role table provides inner roles).
+ * @param resultSolid - the fused result handle.
+ * @param replicas - per-replica label + inverse transform.
+ * @param outStmt - the output statement id (role-table key).
+ * @returns the role table keyed by outStmt.
+ */
+export declare function buildReplicaRoleTable(kernel: BrepEngineApi, input: Shape, resultSolid: BrepHandle, replicas: ReplicaTransform[], outStmt: string): RoleTable;
+//# sourceMappingURL=replica-role-table.d.ts.map

package/dist/api/internal/replica-role-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replica-role-table.d.ts","sourceRoot":"","sources":["../../../src/api/internal/replica-role-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AAI5D,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAA;IACb,+EAA+E;IAC/E,OAAO,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,QAAQ,CAAA;CACnC;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,UAAU,EACvB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,OAAO,EAAE,MAAM,GACd,SAAS,CA8CX"}

package/dist/api/internal/replica-role-table.js

@@ -0,0 +1,73 @@
+/**
+ * replica-role-table — generalized replica[k] role-table builder (Phase 3 L3).
+ *
+ * Shared by the handwritten replicate ops (circularPattern / gridPattern /
+ * rectangularPattern / mirrorJoin). Every replica is a rigid transform T_k of
+ * the input; result faces = ∪ T_k(input faces). For each result face, its
+ * centroid is mapped back through T_k⁻¹ into input coordinates and matched to
+ * the nearest input-face centroid, recovering the input role, prefixed with
+ * the replica label: `replica[k]/<inner>`.
+ *
+ * Same mechanism as pattern.ts linearPattern (centroid clustering), generalized
+ * from a projection along one direction to arbitrary per-replica inverses.
+ */
+import { brepOf, inputRoleTable } from '../../shape.js';
+import { getFaceHashes } from '../../brep/face-evolution.js';
+/**
+ * Build the `replica[*]/<inner>` role table for a fused multi-replica result.
+ *
+ * @param kernel - the BREP engine api.
+ * @param input - the source Shape (its role table provides inner roles).
+ * @param resultSolid - the fused result handle.
+ * @param replicas - per-replica label + inverse transform.
+ * @param outStmt - the output statement id (role-table key).
+ * @returns the role table keyed by outStmt.
+ */
+export function buildReplicaRoleTable(kernel, input, resultSolid, replicas, outStmt) {
+    const inputSolid = brepOf(input);
+    const inputTable = inputRoleTable(input);
+    // input face hash → role (for inner-role recovery)
+    const inputHashes = getFaceHashes(kernel, inputSolid);
+    const inputHashToRole = new Map();
+    if (inputTable) {
+        for (const roles of inputTable.values()) {
+            for (const [role, hashes] of roles)
+                for (const h of hashes)
+                    inputHashToRole.set(h, role);
+        }
+    }
+    const inputFaces = kernel.getSubShapes(inputSolid, 'face');
+    const inputCentroids = inputFaces.map((f) => kernel.getSurfaceCenterOfMass(f));
+    const resultHashes = getFaceHashes(kernel, resultSolid);
+    const resultFaces = kernel.getSubShapes(resultSolid, 'face');
+    const resultCentroids = resultFaces.map((f) => kernel.getSurfaceCenterOfMass(f));
+    const roleTable = new Map();
+    const inner = new Map();
+    for (let i = 0; i < resultHashes.length; i++) {
+        const c = resultCentroids[i];
+        // Try every replica inverse; the one mapping closest to an input face
+        // centroid wins (identifies both the replica k and the inner role).
+        let bestLabel = replicas[0].label;
+        let bestRole;
+        let bestDist = Infinity;
+        for (const r of replicas) {
+            const p = r.inverse(c);
+            for (let j = 0; j < inputCentroids.length; j++) {
+                const ic = inputCentroids[j];
+                const d = (p.x - ic.x) ** 2 + (p.y - ic.y) ** 2 + (p.z - ic.z) ** 2;
+                if (d < bestDist) {
+                    bestDist = d;
+                    bestLabel = r.label;
+                    bestRole = inputHashToRole.get(inputHashes[j]);
+                }
+            }
+        }
+        const role = `${bestLabel}/${bestRole ?? 'face'}`;
+        if (!inner.has(role))
+            inner.set(role, []);
+        inner.get(role).push(resultHashes[i]);
+    }
+    roleTable.set(outStmt, inner);
+    return roleTable;
+}
+//# sourceMappingURL=replica-role-table.js.map

package/dist/api/internal/replica-role-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replica-role-table.js","sourceRoot":"","sources":["../../../src/api/internal/replica-role-table.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * replica-role-table — generalized replica[k] role-table builder (Phase 3 L3).\n *\n * Shared by the handwritten replicate ops (circularPattern / gridPattern /\n * rectangularPattern / mirrorJoin). Every replica is a rigid transform T_k of\n * the input; result faces = ∪ T_k(input faces). For each result face, its\n * centroid is mapped back through T_k⁻¹ into input coordinates and matched to\n * the nearest input-face centroid, recovering the input role, prefixed with\n * the replica label: `replica[k]/<inner>`.\n *\n * Same mechanism as pattern.ts linearPattern (centroid clustering), generalized\n * from a projection along one direction to arbitrary per-replica inverses.\n */\n\nimport type { Shape } from '../../mesh/types'\nimport type { BrepHandle, BrepVec3 } from '../../brep/engine/types'\nimport type { BrepEngineApi } from '../../brep/engine/primitives'\nimport type { RoleTable } from '../../topology/naming/types'\nimport { brepOf, inputRoleTable } from '../../shape'\nimport { getFaceHashes } from '../../brep/face-evolution'\n\n/** One replica: role-table label prefix + inverse of its placement transform. */\nexport interface ReplicaTransform {\n  /** Label prefix, e.g. 'replica[2]' / 'replica[1_0]'. */\n  label: string\n  /** Map a result-face centroid back into the input coordinate frame (T_k⁻¹). */\n  inverse: (c: BrepVec3) => BrepVec3\n}\n\n/**\n * Build the `replica[*]/<inner>` role table for a fused multi-replica result.\n *\n * @param kernel - the BREP engine api.\n * @param input - the source Shape (its role table provides inner roles).\n * @param resultSolid - the fused result handle.\n * @param replicas - per-replica label + inverse transform.\n * @param outStmt - the output statement id (role-table key).\n * @returns the role table keyed by outStmt.\n */\nexport function buildReplicaRoleTable(\n  kernel: BrepEngineApi,\n  input: Shape,\n  resultSolid: BrepHandle,\n  replicas: ReplicaTransform[],\n  outStmt: string,\n): RoleTable {\n  const inputSolid = brepOf(input) as BrepHandle\n  const inputTable = inputRoleTable(input) as RoleTable | undefined\n\n  // input face hash → role (for inner-role recovery)\n  const inputHashes = getFaceHashes(kernel, inputSolid)\n  const inputHashToRole = new Map<number, string>()\n  if (inputTable) {\n    for (const roles of inputTable.values()) {\n      for (const [role, hashes] of roles) for (const h of hashes) inputHashToRole.set(h, role)\n    }\n  }\n  const inputFaces = kernel.getSubShapes(inputSolid, 'face')\n  const inputCentroids = inputFaces.map((f) => kernel.getSurfaceCenterOfMass(f))\n\n  const resultHashes = getFaceHashes(kernel, resultSolid)\n  const resultFaces = kernel.getSubShapes(resultSolid, 'face')\n  const resultCentroids = resultFaces.map((f) => kernel.getSurfaceCenterOfMass(f))\n\n  const roleTable = new Map<string, Map<string, number[]>>()\n  const inner = new Map<string, number[]>()\n  for (let i = 0; i < resultHashes.length; i++) {\n    const c = resultCentroids[i]!\n    // Try every replica inverse; the one mapping closest to an input face\n    // centroid wins (identifies both the replica k and the inner role).\n    let bestLabel = replicas[0]!.label\n    let bestRole: string | undefined\n    let bestDist = Infinity\n    for (const r of replicas) {\n      const p = r.inverse(c)\n      for (let j = 0; j < inputCentroids.length; j++) {\n        const ic = inputCentroids[j]!\n        const d = (p.x - ic.x) ** 2 + (p.y - ic.y) ** 2 + (p.z - ic.z) ** 2\n        if (d < bestDist) {\n          bestDist = d\n          bestLabel = r.label\n          bestRole = inputHashToRole.get(inputHashes[j]!)\n        }\n      }\n    }\n    const role = `${bestLabel}/${bestRole ?? 'face'}`\n    if (!inner.has(role)) inner.set(role, [])\n    inner.get(role)!.push(resultHashes[i]!)\n  }\n  roleTable.set(outStmt as never, inner)\n  return roleTable as unknown as RoleTable\n}\n"]}

package/dist/api/internal/result-unwrap.d.ts

@@ -47,7 +47,9 @@ export declare class OpError extends Error {
     readonly op: string;
     /** The `BrepError.code`, or `'E_OP_FAILED'` when the library sent none. */
     readonly code: string;
-    constructor(op: string, code: string, message: string);
+    constructor(op: string, code: string, message: string, options?: {
+        cause?: unknown;
+    });
 }
 /**
  * Structural test for a Result value.

package/dist/api/internal/result-unwrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result-unwrap.d.ts","sourceRoot":"","sources":["../../../src/api/internal/result-unwrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,oGAAoG;AACpG,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAA;AAE7D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,OAAQ,SAAQ,KAAK;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBACT,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAMtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,UAAU,CAExD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,KAAK,CAO3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAO/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAU9D"}
+{"version":3,"file":"result-unwrap.d.ts","sourceRoot":"","sources":["../../../src/api/internal/result-unwrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,oGAAoG;AACpG,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAA;AAE7D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,OAAQ,SAAQ,KAAK;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBACT,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAMrF;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,UAAU,CAExD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,KAAK,CAO3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAO/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAU9D"}

package/dist/api/internal/result-unwrap.js

@@ -36,8 +36,8 @@ export class OpError extends Error {
     op;
     /** The `BrepError.code`, or `'E_OP_FAILED'` when the library sent none. */
     code;
-    constructor(op, code, message) {
-        super(message);
+    constructor(op, code, message, options) {
+        super(message, options);
         this.name = 'OpError';
         this.op = op;
         this.code = code;

package/dist/api/internal/result-unwrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"result-unwrap.js","sourceRoot":"","sources":["../../../src/api/internal/result-unwrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,OAAQ,SAAQ,KAAK;IAChC,6CAA6C;IACpC,EAAE,CAAQ;IACnB,2EAA2E;IAClE,IAAI,CAAQ;IACrB,YAAY,EAAU,EAAE,IAAY,EAAE,OAAe;QACnD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,SAAS,CAAA;QACrB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;QACZ,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,OAAQ,CAAsB,CAAC,EAAE,KAAK,SAAS,CAAA;AAC/F,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,GAAY;IAClD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAI,GAA0B,CAAC,IAAI,CAAA;QAC7C,MAAM,MAAM,GAAG,cAAc,IAAI,KAAK,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;QACnF,OAAO,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,CAAA;IACxC,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,cAAc,IAAI,kBAAkB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AACrE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,GAAY;IACpD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAI,GAA0B,CAAC,IAAI,CAAA;QAC7C,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAA;QAC/D,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,cAAc,IAAI,KAAK,OAAO,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;IACrF,CAAC;IACD,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,cAAc,IAAI,kBAAkB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AAC5F,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,CAAU,EAAE,IAAY;IACnD,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAA;IAC9B,IAAI,CAAC,CAAC,EAAE;QAAE,OAAO,CAAC,CAAC,KAAK,CAAA;IACxB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAwC,CAAA;IAChE,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,aAAa,CAAA;IACpC,MAAM,IAAI,OAAO,CACf,IAAI,EACJ,IAAI,EACJ,yBAAyB,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,OAAO,IAAI,kBAAkB,EAAE,CAC7E,CAAA;AACH,CAAC","sourcesContent":["/**\n * result-unwrap — the single Result→throw bridge shared by every faijs\n * statement boundary (D1).\n *\n * Design: docs/plans/2026-09-03-faijs-brepjs-compat-api.md §5.1 / §5.2\n *\n * Three-layer error semantics (§5.1):\n *   library internals / TS compat face → `Result<T>` native (BrepError)\n *   statement boundary                 → `err` unwrapped into a throw\n *   faijs-specific op impls            → may return `Result`; same unwrap\n *\n * This module is a **leaf**: it imports nothing, so both the SDK layer\n * (`src/define-op.ts`, whose `dist/sdk.js` must stay free of heavy static\n * imports) and the compat bridge (`api/internal/compat-op.ts`) can share one\n * implementation. Having two copies would let the two boundaries drift.\n *\n * @module\n */\n\n/** Structural shape of the vendored `Ok`/`Err` records (`vendored/brepjs/core/result.ts:12-21`). */\nexport type ResultLike =\n  | { ok: true; value: unknown }\n  | { ok: false; error: { code?: string; message?: string } }\n\n/**\n * Statement-boundary op failure (D1 unwrap / compat adoption).\n *\n * An `err` Result unwrapped at the statement boundary used to be thrown as a\n * plain `Error`, which `CadRuntime.runWithFailureHandling` (recognizing only\n * `BrepUnsupportedError`/`MeshUnsupportedError` by `instanceof`) re-threw out\n * of `execute()` instead of converting it into `ExecutionResult.failedAt`.\n * This class is the engine-recognizable carrier: defined in this leaf module\n * (zero imports) so both `define-op` and the compat bridge can throw it while\n * CadRuntime can catch it without importing anything heavier.\n *\n * A thrown `Error` that is *not* an `OpError` keeps its old meaning: an\n * unexpected implementation bug that must propagate (Result 体系 — expected\n * failures are `err` values, exceptions are bugs).\n */\nexport class OpError extends Error {\n  /** The op name that produced the failure. */\n  readonly op: string\n  /** The `BrepError.code`, or `'E_OP_FAILED'` when the library sent none. */\n  readonly code: string\n  constructor(op: string, code: string, message: string) {\n    super(message)\n    this.name = 'OpError'\n    this.op = op\n    this.code = code\n  }\n}\n\n/**\n * Structural test for a Result value.\n *\n * Only the `ok: boolean` discriminant is checked — the vendored `Result` is a\n * plain record, so no `instanceof` and no import is needed (which is what keeps\n * this module a leaf).\n *\n * @param v - the candidate value.\n * @returns true when `v` looks like an Ok/Err record.\n */\nexport function isResultLike(v: unknown): v is ResultLike {\n  return typeof v === 'object' && v !== null && typeof (v as { ok?: unknown }).ok === 'boolean'\n}\n\n/**\n * Render an error thrown by (or returned from) an implementation as a\n * statement-level failure.\n *\n * The op name and the `BrepError.code` (when present) are always kept so the\n * engine's statement-level catch reports the same shape the plan's trace A/B\n * describe (`[faijs/brepjs-compat] <op>: <CODE>: <message>`).\n *\n * @param name - the op name.\n * @param err  - the thrown value (Error or anything else).\n * @returns an Error carrying the op context.\n */\nexport function toOpError(name: string, err: unknown): Error {\n  if (err instanceof Error) {\n    const code = (err as { code?: unknown }).code\n    const prefix = `[faijs/op] ${name}: ${typeof code === 'string' ? code + ': ' : ''}`\n    return new Error(prefix + err.message)\n  }\n  return new Error(`[faijs/op] ${name}: E_OP_FAILED: ${String(err)}`)\n}\n\n/**\n * Wrap an implementation-thrown exception as an {@link OpError} (statement-\n * level failure carrier). Used by `define-op.ts` `runImpl` so that\n * `CadRuntime.directFailedAtOrThrow` recognizes the error as an op failure\n * (not a bug to re-throw).\n *\n * @param name - the op name.\n * @param err  - the thrown value.\n * @returns an OpError carrying the op context and code.\n */\nexport function toOpFailure(name: string, err: unknown): OpError {\n  if (err instanceof Error) {\n    const code = (err as { code?: unknown }).code\n    const codeStr = typeof code === 'string' ? code : 'E_OP_FAILED'\n    return new OpError(name, codeStr, `[faijs/op] ${name}: ${codeStr}: ${err.message}`)\n  }\n  return new OpError(name, 'E_OP_FAILED', `[faijs/op] ${name}: E_OP_FAILED: ${String(err)}`)\n}\n\n/**\n * Statement-boundary unwrap (D1).\n *\n * - a non-Result product → returned untouched (plain-data ops, mesh products);\n * - `ok`  → `.value`;\n * - `err` → throws an {@link OpError} carrying the op name and BrepError code\n *   (the engine converts `OpError` into `ExecutionResult.failedAt`).\n *\n * @param r    - the implementation product.\n * @param name - the op name (error messages).\n * @returns the unwrapped value, or the input when it was not a Result.\n * @throws an {@link OpError} when `r` is an `Err`.\n */\nexport function unwrapResult(r: unknown, name: string): unknown {\n  if (!isResultLike(r)) return r\n  if (r.ok) return r.value\n  const e = (r.error ?? {}) as { code?: string; message?: string }\n  const code = e.code ?? 'E_OP_FAILED'\n  throw new OpError(\n    name,\n    code,\n    `[faijs/brepjs-compat] ${name}: ${code}: ${e.message ?? 'operation failed'}`,\n  )\n}\n"]}
+{"version":3,"file":"result-unwrap.js","sourceRoot":"","sources":["../../../src/api/internal/result-unwrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,OAAQ,SAAQ,KAAK;IAChC,6CAA6C;IACpC,EAAE,CAAQ;IACnB,2EAA2E;IAClE,IAAI,CAAQ;IACrB,YAAY,EAAU,EAAE,IAAY,EAAE,OAAe,EAAE,OAA6B;QAClF,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAA;QACrB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;QACZ,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,OAAQ,CAAsB,CAAC,EAAE,KAAK,SAAS,CAAA;AAC/F,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,GAAY;IAClD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAI,GAA0B,CAAC,IAAI,CAAA;QAC7C,MAAM,MAAM,GAAG,cAAc,IAAI,KAAK,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;QACnF,OAAO,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,CAAA;IACxC,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,cAAc,IAAI,kBAAkB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AACrE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,GAAY;IACpD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAI,GAA0B,CAAC,IAAI,CAAA;QAC7C,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAA;QAC/D,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,cAAc,IAAI,KAAK,OAAO,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;IACrF,CAAC;IACD,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,cAAc,IAAI,kBAAkB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AAC5F,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,CAAU,EAAE,IAAY;IACnD,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAA;IAC9B,IAAI,CAAC,CAAC,EAAE;QAAE,OAAO,CAAC,CAAC,KAAK,CAAA;IACxB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAwC,CAAA;IAChE,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,aAAa,CAAA;IACpC,MAAM,IAAI,OAAO,CACf,IAAI,EACJ,IAAI,EACJ,yBAAyB,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,OAAO,IAAI,kBAAkB,EAAE,CAC7E,CAAA;AACH,CAAC","sourcesContent":["/**\n * result-unwrap — the single Result→throw bridge shared by every faijs\n * statement boundary (D1).\n *\n * Design: docs/plans/2026-09-03-faijs-brepjs-compat-api.md §5.1 / §5.2\n *\n * Three-layer error semantics (§5.1):\n *   library internals / TS compat face → `Result<T>` native (BrepError)\n *   statement boundary                 → `err` unwrapped into a throw\n *   faijs-specific op impls            → may return `Result`; same unwrap\n *\n * This module is a **leaf**: it imports nothing, so both the SDK layer\n * (`src/define-op.ts`, whose `dist/sdk.js` must stay free of heavy static\n * imports) and the compat bridge (`api/internal/compat-op.ts`) can share one\n * implementation. Having two copies would let the two boundaries drift.\n *\n * @module\n */\n\n/** Structural shape of the vendored `Ok`/`Err` records (`vendored/brepjs/core/result.ts:12-21`). */\nexport type ResultLike =\n  | { ok: true; value: unknown }\n  | { ok: false; error: { code?: string; message?: string } }\n\n/**\n * Statement-boundary op failure (D1 unwrap / compat adoption).\n *\n * An `err` Result unwrapped at the statement boundary used to be thrown as a\n * plain `Error`, which `CadRuntime.runWithFailureHandling` (recognizing only\n * `BrepUnsupportedError`/`MeshUnsupportedError` by `instanceof`) re-threw out\n * of `execute()` instead of converting it into `ExecutionResult.failedAt`.\n * This class is the engine-recognizable carrier: defined in this leaf module\n * (zero imports) so both `define-op` and the compat bridge can throw it while\n * CadRuntime can catch it without importing anything heavier.\n *\n * A thrown `Error` that is *not* an `OpError` keeps its old meaning: an\n * unexpected implementation bug that must propagate (Result 体系 — expected\n * failures are `err` values, exceptions are bugs).\n */\nexport class OpError extends Error {\n  /** The op name that produced the failure. */\n  readonly op: string\n  /** The `BrepError.code`, or `'E_OP_FAILED'` when the library sent none. */\n  readonly code: string\n  constructor(op: string, code: string, message: string, options?: { cause?: unknown }) {\n    super(message, options)\n    this.name = 'OpError'\n    this.op = op\n    this.code = code\n  }\n}\n\n/**\n * Structural test for a Result value.\n *\n * Only the `ok: boolean` discriminant is checked — the vendored `Result` is a\n * plain record, so no `instanceof` and no import is needed (which is what keeps\n * this module a leaf).\n *\n * @param v - the candidate value.\n * @returns true when `v` looks like an Ok/Err record.\n */\nexport function isResultLike(v: unknown): v is ResultLike {\n  return typeof v === 'object' && v !== null && typeof (v as { ok?: unknown }).ok === 'boolean'\n}\n\n/**\n * Render an error thrown by (or returned from) an implementation as a\n * statement-level failure.\n *\n * The op name and the `BrepError.code` (when present) are always kept so the\n * engine's statement-level catch reports the same shape the plan's trace A/B\n * describe (`[faijs/brepjs-compat] <op>: <CODE>: <message>`).\n *\n * @param name - the op name.\n * @param err  - the thrown value (Error or anything else).\n * @returns an Error carrying the op context.\n */\nexport function toOpError(name: string, err: unknown): Error {\n  if (err instanceof Error) {\n    const code = (err as { code?: unknown }).code\n    const prefix = `[faijs/op] ${name}: ${typeof code === 'string' ? code + ': ' : ''}`\n    return new Error(prefix + err.message)\n  }\n  return new Error(`[faijs/op] ${name}: E_OP_FAILED: ${String(err)}`)\n}\n\n/**\n * Wrap an implementation-thrown exception as an {@link OpError} (statement-\n * level failure carrier). Used by `define-op.ts` `runImpl` so that\n * `CadRuntime.directFailedAtOrThrow` recognizes the error as an op failure\n * (not a bug to re-throw).\n *\n * @param name - the op name.\n * @param err  - the thrown value.\n * @returns an OpError carrying the op context and code.\n */\nexport function toOpFailure(name: string, err: unknown): OpError {\n  if (err instanceof Error) {\n    const code = (err as { code?: unknown }).code\n    const codeStr = typeof code === 'string' ? code : 'E_OP_FAILED'\n    return new OpError(name, codeStr, `[faijs/op] ${name}: ${codeStr}: ${err.message}`)\n  }\n  return new OpError(name, 'E_OP_FAILED', `[faijs/op] ${name}: E_OP_FAILED: ${String(err)}`)\n}\n\n/**\n * Statement-boundary unwrap (D1).\n *\n * - a non-Result product → returned untouched (plain-data ops, mesh products);\n * - `ok`  → `.value`;\n * - `err` → throws an {@link OpError} carrying the op name and BrepError code\n *   (the engine converts `OpError` into `ExecutionResult.failedAt`).\n *\n * @param r    - the implementation product.\n * @param name - the op name (error messages).\n * @returns the unwrapped value, or the input when it was not a Result.\n * @throws an {@link OpError} when `r` is an `Err`.\n */\nexport function unwrapResult(r: unknown, name: string): unknown {\n  if (!isResultLike(r)) return r\n  if (r.ok) return r.value\n  const e = (r.error ?? {}) as { code?: string; message?: string }\n  const code = e.code ?? 'E_OP_FAILED'\n  throw new OpError(\n    name,\n    code,\n    `[faijs/brepjs-compat] ${name}: ${code}: ${e.message ?? 'operation failed'}`,\n  )\n}\n"]}

package/dist/api/occt-kernel-bridge.d.ts

@@ -1,43 +1,121 @@
 /**
- * L3 bridge — occt-wasm kernel single-instance injection (D10).
+ * L3 bridge — vendored kernel registry injection (engine-neutral, Phase 2 P2-5).
  *
- * The ported `kernel/occtWasm` adapter is constructor-injected (DI form, never
- * imports `occt-wasm` itself). This file is the **only** faijs-side place
- * wiring the two together (boundary rule D8/R5: core side may import the
- * vendored tree only from `api/`):
+ * 原 occt-kernel-bridge 的职责是「把 vendored kernel registry 冻结绑定到 occt-wasm
+ * 单实例」（D10）。Phase 2 起改为**跟随当前 BREP 引擎**：装配期把 registry 里当前
+ * 引擎（occt / brepkit / mock）的 `BrepEngineApi` 适配器包装为 brepjs `KernelAdapter`
+ * 形态注册进 vendored registry，使 `vendoredRegistry.getKernel()` 返回当前引擎——
+ * vendored 函数全部逻辑（命名/角色表/Result）原样保留、零改动。
  *
- *   initOcctWasm()  ──same instance──▶  OcctWasmAdapter  ──▶  registerKernel
- *   (faijs existing                (vendored, DI)             (vendored kernel
- *    occt singleton)                                            registry, D10)
+ * 边界规则（D8/R5）不变：本文件是 faijs 侧唯一把 vendored kernel registry 与
+ * faijs 引擎接线的地方；core 侧只从 `api/` import vendored 树。
  *
- * `occtKernel.getKernel()` returns the faijs singleton `OcctKernel`; building
- * the adapter over that exact instance guarantees the single-instance ban
- * (D10: two wasm instances would put handles in different pointer spaces and
- * silently desync `hasBrep`/`brepOf`/face evolution).
- *
- * See docs/plans/2026-09-01-layered-api-architecture.md §D10 / §D8.
+ * 装配期完整性检查（方案 §Phase 2.5）：KernelAdapter 是 211 方法大接口，但 vendored
+ * 面存在大量**辅助构造方法**（createVector3d / createPoint3d / createDirection3d /
+ * createAxis1 / createAxis2 / createAxis3，见 vendored core/kernelBoundary.ts）——
+ * 它们不落在能力名体系内（BrepMethodKind 之外）、无法由 op 声明覆盖，任何 compat
+ * op / TS compat 面都可能触发。⇒ 注入前必须断言这些胶水方法在适配器上齐备，缺失
+ * 则在**装配期**报错（而非执行期崩）。清单见 {@link GLUE_METHODS}。
  */
+import { type BrepEngine } from '../brep/engine/registry.js';
 import type { KernelAdapter } from '../vendored/brepjs/kernel/types.js';
+/** occt-wasm 适配器在 vendored registry 中的注册 id。这是 vendored 注册表的
+ * 槽位名（宿主侧判据 + D10 globalThis 单例兼容），**不是**引擎身份标识——
+ * 实际引擎由注入的 adapter 决定（vendored 面全部无参 `getKernel()` 取默认）。 */
+export declare const VENDORED_OCCT_KERNEL_ID = "occt-wasm";
 /**
- * Bind the ported kernel registry to the faijs single occt-wasm instance.
+ * Inject the currently-registered BREP engine into the vendored kernel registry
+ * (replaces the old occt-only `bindOcctKernel()` fixed binding, Phase 2 P2-5).
+ *
+ * 装配期调用（在 `registerOcctBrepEngine()` / 其它引擎注册之后）。从引擎注册表取
+ * 当前默认 BREP 引擎，按其 id 构造 KernelAdapter 形态注册进 vendored registry：
  *
- * Idempotent: the first call registers the adapter and freezes the registry
- * (D10 冻结); subsequent calls return the already-bound adapter without
- * re-registering. Call after `initOcctWasm()` has been run (e.g. inside
- * `registerOcctBrepEngine()` host assembly).
+ * - occt：`OcctWasmAdapter.fromKernel(当前引擎 primitives)`——同一 occt-wasm 单实例
+ *   （D10 不变），211 方法完整适配器，vendored 函数行为与旧 bindOcctKernel 完全一致；
+ * - 其它引擎（brepkit/mock）：将 BrepEngineApi 透传包装为 KernelAdapter 形态
+ *   （`dispose`→`release` 等方法名映射 + pattern 返回形态适配），**不做方法伪造**；
+ * - 任一引擎注入前都做**装配期完整性检查**（GLUE_METHODS 齐备断言）。
  *
- * @returns the registered kernel adapter.
+ * 幂等：首次调用后注册并冻结；重复调用返回已注入的适配器。
+ *
+ * @returns 注册进 vendored registry 的 kernel adapter。
+ * @throws 无 BREP 引擎注册；或完整性检查失败（胶水方法缺失）——装配期报错。
  */
-export declare function bindOcctKernel(): KernelAdapter;
+export declare function injectCurrentBrepEngineAsKernel(): Promise<KernelAdapter>;
+/**
+ * 按引擎 id 构造 KernelAdapter 形态（occt 走完整适配器；其它引擎透传包装）。
+ *
+ * occt 分支保持旧 bindOcctKernel 行为：OcctWasmAdapter.fromKernel 需要 occt-wasm
+ * 实例（OcctKernelOwner）。当前引擎的 primitives 即 initOcctWasm 单例（occtApi 是
+ * 同一实例的实例覆盖，方法面完整），转换安全。
+ *
+ * 其它引擎分支：BrepEngineApi → KernelAdapter 契约面——
+ *   - `dispose` → `release`（vendored 面用 dispose，BrepEngineApi 用 release）；
+ *   - `linearPattern` / `circularPattern` 的方向/中心/轴参数是 Vec3 对象（BrepEngineApi
+ *     口径），vendored 面传 [x,y,z] 三元组——包装为对象再转发；
+ *   - 返回 BrepHandle[]（BrepEngineApi）→ KernelShape[]（vendored castResultShape 消费
+ *     `.wrapped` + `.type`）——包装为 `{ wrapped, type: 'solid' }`；
+ *   - `gridPattern` 返回单 BrepHandle → 单 KernelShape（compound 语义一致）。
+ * 不声明 `rectangularPattern`（纯 JS 组合，不调内核——capability-map 实证）。
+ *
+ * ⚠️ 不伪造：BrepEngineApi 未提供的方法**不**补桩；vendored 函数若触发，由
+ * compat op 的静态能力判定（backend-dispatch，Phase 1）在执行前拦截。
+ *
+ * @param engine - 当前 BREP 引擎（装配期从引擎注册表取得）。
+ * @returns 该引擎的 vendored KernelAdapter（occt → OcctWasmAdapter.fromKernel；
+ *   其它引擎 → BrepEngineApi 透传包装，pattern 族 Vec3↔三元组适配）。
+ */
+export declare function buildKernelAdapter(engine: BrepEngine): KernelAdapter;
 /**
- * Whether the vendored kernel registry has been bound (D10).
- * @returns true once bound to the occt-wasm kernel.
+ * vendored kernel methods with no source capability in BrepEngineApi.
+ * Registered explicitly (not silently undefined): tests assert this list and
+ * the engine-contract gap is a separate decision, not a wrapping bug. No
+ * stubs, no fake zeros — a silent 0 is worse than a crash.
  */
-export declare function isOcctKernelBound(): boolean;
+export declare const UNMAPPED_VENDORED_MEASURE_METHODS: readonly ["area", "length", "linearCenterOfMass"];
+/**
+ * 装配期完整性检查：KernelAdapter 胶水方法齐备断言。
+ *
+ * @param id - 引擎注册 id（报错时定位到引擎）。
+ * @param adapter - 待注入 vendored registry 的 KernelAdapter。
+ * @throws 缺失任一胶水方法 → 装配期报错（列出引擎 id 与缺失方法名）。
+ */
+export declare function assertGlueMethodsComplete(id: string, adapter: KernelAdapter): void;
 /**
- * Access the currently bound vendored kernel adapter (reads the registry).
- * @throws If the bridge has not been bound.
- * @returns the vendored occt-wasm kernel adapter.
+ * Test-only: clear the injection cache and reset the vendored kernel registry
+ * so a re-assembly (e.g. switching engines in tests) re-runs buildKernelAdapter
+ * + assertGlueMethodsComplete for the new engine. Never called in prod.
+ */
+export declare function __resetKernelInjectionForTests(): void;
+/**
+ * Whether the vendored kernel registry has been injected (engine-neutral D10).
+ *
+ * 取代旧的 `isOcctKernelBound()`（其判据 `_bound && getActiveKernelId() === 'occt-wasm'`
+ * 把注入面写死为 occt）。新判据只问「vendored registry 是否已注入当前引擎」——
+ * 不关心引擎 id，装配期换引擎（brepkit/mock）同样成立。
+ *
+ * @returns 注入是否已完成（vendored registry 已装配当前 BREP 引擎）。
+ */
+export declare function isKernelInjected(): boolean;
+/**
+ * Access the currently injected vendored kernel adapter (reads the registry).
+ * @throws If the bridge has not been injected.
+ * @returns the vendored kernel adapter for the current BREP engine.
  */
 export declare function getBrepjsKernel(): KernelAdapter;
+/**
+ * 固定绑定 occt 内核到 vendored registry（Phase 2 前的装配方式）。
+ *
+ * @deprecated Phase 2 P2-5：固定绑定已被引擎中立的 injectCurrentBrepEngineAsKernel
+ * 取代。保留导出仅为兼容旧调用点（适配器层迁移期）；新代码一律用注入函数。
+ * @returns 恒抛错——本函数已移除，仅保留签名占位。
+ */
+export declare function bindOcctKernel(): KernelAdapter;
+/**
+ * 旧 occt 专用注入判据（Phase 2 前语义：绑定且激活内核为 occt-wasm）。
+ *
+ * @deprecated Phase 2 P2-5：occt 专用判据已被引擎中立的 isKernelInjected() 取代。
+ * @returns 当前是否已注入（透传 isKernelInjected()）。
+ */
+export declare function isOcctKernelBound(): boolean;
 //# sourceMappingURL=occt-kernel-bridge.d.ts.map

package/dist/api/occt-kernel-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"occt-kernel-bridge.d.ts","sourceRoot":"","sources":["../../src/api/occt-kernel-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAaH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAA;AAIvE;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,aAAa,CAe9C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,aAAa,CAE/C"}
+{"version":3,"file":"occt-kernel-bridge.d.ts","sourceRoot":"","sources":["../../src/api/occt-kernel-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAYxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAA;AAEvE;;4DAE4D;AAC5D,eAAO,MAAM,uBAAuB,cAAc,CAAA;AAwBlD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,+BAA+B,IAAI,OAAO,CAAC,aAAa,CAAC,CAgB9E;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAMpE;AAKD;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,mDAIpC,CAAA;AAmIV;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAWlF;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAGrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,aAAa,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,aAAa,CAM9C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}