@faicad/faijs 0.13.2 → 0.16.0

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/knurl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knurl.d.ts","sourceRoot":"","sources":["../../src/api/knurl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAQ,MAAM,eAAe,CAAA;AAMhD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEvE;AAED;;;;;;;;;;;;;;;;;;;;IAoBI;AACJ,eAAO,MAAM,KAAK;;CAoBhB,CAAA"}
+{"version":3,"file":"knurl.d.ts","sourceRoot":"","sources":["../../src/api/knurl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAQ,MAAM,eAAe,CAAA;AAOhD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEvE;AAED;;;;;;;;;;;;;;;;;;;;IAoBI;AACJ,eAAO,MAAM,KAAK;;CAqBhB,CAAA"}

package/dist/api/knurl.js

@@ -58,5 +58,6 @@ export const knurl = defineOp({
             knurlMappingMode: params.knurlMappingMode ?? 5,
         });
     },
+    naming: { kind: 'unmodeled', reason: 'knurl is mesh-only, no BREP face identity' },
 });
 //# sourceMappingURL=knurl.js.map

package/dist/api/knurl.js.map

@@ -1 +1 @@
-{"version":3,"file":"knurl.js","sourceRoot":"","sources":["../../src/api/knurl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAE/C;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA+B;IAC/D,oBAAoB,CAAC,MAAM,CAAC,kBAAkB,EAAE,0BAA0B,CAAC,CAAA;AAC7E,CAAC;AAED;;;;;;;;;;;;;;;;;;;;IAoBI;AACJ,MAAM,CAAC,MAAM,KAAK,GAAG,QAAQ,CAAC;IAC5B,IAAI,EAAE,KAAK,EAAE,KAAY,EAAE,MAA+B,EAAE,EAAE;QAC5D,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;QAC/D,iBAAiB,CAAC,MAAM,CAAC,CAAA;QACzB,+CAA+C;QAC/C,iEAAiE;QACjE,MAAM,CAAC,SAAS,CAAC,GAAG,mBAAmB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;QAChD,OAAO,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE;YAC1B,IAAI,EAAE;gBACJ,MAAM,EAAG,MAAM,CAAC,UAA+B,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;gBAC5E,MAAM,EAAG,MAAM,CAAC,UAA+B,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;aAC7D;YACD,kBAAkB,EAAG,MAAM,CAAC,kBAAyC,IAAI,GAAG;YAC5E,uBAAuB,EAAG,MAAM,CAAC,uBAA+C,IAAI,KAAK;YACzF,iBAAiB,EAAG,MAAM,CAAC,iBAAwC,IAAI,GAAG;YAC1E,WAAW,EAAG,MAAM,CAAC,WAAkC,IAAI,IAAI;YAC/D,WAAW,EAAG,MAAM,CAAC,WAAkC,IAAI,IAAI;YAC/D,gBAAgB,EAAG,MAAM,CAAC,gBAAuC,IAAI,CAAC;SACvE,CAAC,CAAA;IACJ,CAAC;CACF,CAAC,CAAA","sourcesContent":["/**\n * stdlib knurl — 滚花库函数（mesh-only）\n *\n *\n * knurl 无 BREP 实现（mesh-only）——dispatchPath 在 brep 模式下调用前抛错。\n * part-brep-lost 事件由引擎统一发（P4，库不再 emit）。\n */\n\nimport type { Shape, Vec3 } from '../mesh/types'\nimport { cad } from '../mesh'\nimport { reconcileBrepInputs } from './reconcile'\nimport { defineOp } from '../sdk'\nimport { assertPositiveNumber } from './assert'\n\n/**\n * Validate knurl parameters: `knurlTextureHeight` must be a positive number.\n * @param params - the raw knurl operation parameters.\n */\nexport function assertKnurlParams(params: Record<string, unknown>): void {\n  assertPositiveNumber(params.knurlTextureHeight, 'knurl.knurlTextureHeight')\n}\n\n/**\n * 施加滚花（顶点位移，非布尔）。mesh-only。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual warn\n * @name knurl\n * @note knurl 无 BREP 实现（mesh-only），本质是顶点位移（网格操作），网格参数可接受；brep 模式下调用前抛 BrepUnsupportedError。面锚定建议用几何引用。\n * @returns Shape 滚花后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @param params.knurlTextureHeight - 纹路高度（mm）。type:number 默认 0.5\n * @param params.knurlScaleU - 纹路 U 向频率。type:number 默认 0.15\n * @param params.knurlScaleV - 纹路 V 向频率。type:number 默认 0.15\n * @param params.knurlInvertDisplacement - 反向位移。type:boolean 默认 false\n * @param params.knurlRefineLength - 细分长度（mm）。type:number 默认 1.0\n * @param params.knurlMappingMode - UV 映射模式。type:number 默认 5\n * @param params.faceCenter - 面锚点中心。type:[x,y,z] 默认 bboxCenter\n * @param params.faceNormal - 面法向。type:[x,y,z] 默认 [0,0,1]\n * @example\n * const p = await cad.knurl(part0, { knurlTextureHeight: 0.5, knurlScaleU: 0.15, knurlScaleV: 0.15, knurlInvertDisplacement: false, knurlRefineLength: 1.0, knurlMappingMode: 5 })\n  */\nexport const knurl = defineOp({\n  mesh: async (input: Shape, params: Record<string, unknown>) => {\n    if (!input) throw new Error('[stdlib/knurl] no input geometry')\n    assertKnurlParams(params)\n    // 断链时刻（用户点名场景）：BREP 建模的模型最后做滚花 → BREP 输入必须先归约为\n    // 合法 2-manifold 网格再进 mesh 路径（reconcileBrepInputs 对 mesh 侧输入原样透传）\n    const [meshInput] = reconcileBrepInputs([input])\n    return cad.knurl(meshInput, {\n      face: {\n        center: (params.faceCenter as Vec3 | undefined) ?? cad.bboxCenter(meshInput),\n        normal: (params.faceNormal as Vec3 | undefined) ?? [0, 0, 1],\n      },\n      knurlTextureHeight: (params.knurlTextureHeight as number | undefined) ?? 0.5,\n      knurlInvertDisplacement: (params.knurlInvertDisplacement as boolean | undefined) ?? false,\n      knurlRefineLength: (params.knurlRefineLength as number | undefined) ?? 1.0,\n      knurlScaleU: (params.knurlScaleU as number | undefined) ?? 0.15,\n      knurlScaleV: (params.knurlScaleV as number | undefined) ?? 0.15,\n      knurlMappingMode: (params.knurlMappingMode as number | undefined) ?? 5,\n    })\n  },\n})\n"]}
+{"version":3,"file":"knurl.js","sourceRoot":"","sources":["../../src/api/knurl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAE/C;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA+B;IAC/D,oBAAoB,CAAC,MAAM,CAAC,kBAAkB,EAAE,0BAA0B,CAAC,CAAA;AAC7E,CAAC;AAED;;;;;;;;;;;;;;;;;;;;IAoBI;AACJ,MAAM,CAAC,MAAM,KAAK,GAAG,QAAQ,CAAC;IAC5B,IAAI,EAAE,KAAK,EAAE,KAAY,EAAE,MAA+B,EAAE,EAAE;QAC5D,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;QAC/D,iBAAiB,CAAC,MAAM,CAAC,CAAA;QACzB,+CAA+C;QAC/C,iEAAiE;QACjE,MAAM,CAAC,SAAS,CAAC,GAAG,mBAAmB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;QAChD,OAAO,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE;YAC1B,IAAI,EAAE;gBACJ,MAAM,EAAG,MAAM,CAAC,UAA+B,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;gBAC5E,MAAM,EAAG,MAAM,CAAC,UAA+B,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;aAC7D;YACD,kBAAkB,EAAG,MAAM,CAAC,kBAAyC,IAAI,GAAG;YAC5E,uBAAuB,EAAG,MAAM,CAAC,uBAA+C,IAAI,KAAK;YACzF,iBAAiB,EAAG,MAAM,CAAC,iBAAwC,IAAI,GAAG;YAC1E,WAAW,EAAG,MAAM,CAAC,WAAkC,IAAI,IAAI;YAC/D,WAAW,EAAG,MAAM,CAAC,WAAkC,IAAI,IAAI;YAC/D,gBAAgB,EAAG,MAAM,CAAC,gBAAuC,IAAI,CAAC;SACvE,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,2CAA2C,EAAgB;CACjG,CAAC,CAAA","sourcesContent":["/**\n * stdlib knurl — 滚花库函数（mesh-only）\n *\n *\n * knurl 无 BREP 实现（mesh-only）——dispatchPath 在 brep 模式下调用前抛错。\n * part-brep-lost 事件由引擎统一发（P4，库不再 emit）。\n */\n\nimport type { Shape, Vec3 } from '../mesh/types'\nimport { cad } from '../mesh'\nimport { reconcileBrepInputs } from './reconcile'\nimport { defineOp } from '../sdk'\nimport type { Provenance } from '../topology/naming/lineage'\nimport { assertPositiveNumber } from './assert'\n\n/**\n * Validate knurl parameters: `knurlTextureHeight` must be a positive number.\n * @param params - the raw knurl operation parameters.\n */\nexport function assertKnurlParams(params: Record<string, unknown>): void {\n  assertPositiveNumber(params.knurlTextureHeight, 'knurl.knurlTextureHeight')\n}\n\n/**\n * 施加滚花（顶点位移，非布尔）。mesh-only。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual warn\n * @name knurl\n * @note knurl 无 BREP 实现（mesh-only），本质是顶点位移（网格操作），网格参数可接受；brep 模式下调用前抛 BrepUnsupportedError。面锚定建议用几何引用。\n * @returns Shape 滚花后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @param params.knurlTextureHeight - 纹路高度（mm）。type:number 默认 0.5\n * @param params.knurlScaleU - 纹路 U 向频率。type:number 默认 0.15\n * @param params.knurlScaleV - 纹路 V 向频率。type:number 默认 0.15\n * @param params.knurlInvertDisplacement - 反向位移。type:boolean 默认 false\n * @param params.knurlRefineLength - 细分长度（mm）。type:number 默认 1.0\n * @param params.knurlMappingMode - UV 映射模式。type:number 默认 5\n * @param params.faceCenter - 面锚点中心。type:[x,y,z] 默认 bboxCenter\n * @param params.faceNormal - 面法向。type:[x,y,z] 默认 [0,0,1]\n * @example\n * const p = await cad.knurl(part0, { knurlTextureHeight: 0.5, knurlScaleU: 0.15, knurlScaleV: 0.15, knurlInvertDisplacement: false, knurlRefineLength: 1.0, knurlMappingMode: 5 })\n  */\nexport const knurl = defineOp({\n  mesh: async (input: Shape, params: Record<string, unknown>) => {\n    if (!input) throw new Error('[stdlib/knurl] no input geometry')\n    assertKnurlParams(params)\n    // 断链时刻（用户点名场景）：BREP 建模的模型最后做滚花 → BREP 输入必须先归约为\n    // 合法 2-manifold 网格再进 mesh 路径（reconcileBrepInputs 对 mesh 侧输入原样透传）\n    const [meshInput] = reconcileBrepInputs([input])\n    return cad.knurl(meshInput, {\n      face: {\n        center: (params.faceCenter as Vec3 | undefined) ?? cad.bboxCenter(meshInput),\n        normal: (params.faceNormal as Vec3 | undefined) ?? [0, 0, 1],\n      },\n      knurlTextureHeight: (params.knurlTextureHeight as number | undefined) ?? 0.5,\n      knurlInvertDisplacement: (params.knurlInvertDisplacement as boolean | undefined) ?? false,\n      knurlRefineLength: (params.knurlRefineLength as number | undefined) ?? 1.0,\n      knurlScaleU: (params.knurlScaleU as number | undefined) ?? 0.15,\n      knurlScaleV: (params.knurlScaleV as number | undefined) ?? 0.15,\n      knurlMappingMode: (params.knurlMappingMode as number | undefined) ?? 5,\n    })\n  },\n  naming: { kind: 'unmodeled', reason: 'knurl is mesh-only, no BREP face identity' } as Provenance,\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"}

package/dist/api/occt-kernel-bridge.js

@@ -1,65 +1,279 @@
 /**
- * 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 { getKernel as getFaijsKernel } from '../occt-kernel/occtKernel.js';
+import { getBrepEngine } from '../brep/engine/registry.js';
 import { OcctWasmAdapter } from '../vendored/brepjs/kernel/occtWasm/occtWasmAdapter.js';
-import { freezeKernels, getActiveKernelId, getKernel as getVendoredKernel, registerKernel, syncRegistryFromGlobal, syncRegistryToGlobal, } from '../vendored/brepjs/kernel/index.js';
-let _bound = false;
+import { freezeKernels, getActiveKernelId, getKernel as getVendoredKernel, registerKernel, syncRegistryFromGlobal, syncRegistryToGlobal, __resetKernelRegistryForTests, } from '../vendored/brepjs/kernel/index.js';
+/** occt-wasm 适配器在 vendored registry 中的注册 id。这是 vendored 注册表的
+ * 槽位名（宿主侧判据 + D10 globalThis 单例兼容），**不是**引擎身份标识——
+ * 实际引擎由注入的 adapter 决定（vendored 面全部无参 `getKernel()` 取默认）。 */
+export const VENDORED_OCCT_KERNEL_ID = 'occt-wasm';
 /**
- * Bind the ported kernel registry to the faijs single occt-wasm instance.
+ * 装配期完整性检查清单——vendored 面辅助构造/生命周期胶水方法。
  *
- * 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).
+ * 这些方法不在 `BrepMethodKind` 能力名体系内（能力判定无法覆盖），但 vendored 面
+ * 大量使用（kernelBoundary.ts / wrapperFns / castShape 等）。当前引擎的
+ * KernelAdapter 包装必须全部具备，否则对应 compat op / TS compat 面会在执行期崩。
  *
- * @returns the registered kernel adapter.
+ * Phase 0 盘点实证：36 个 compat op 的 vendored 函数（capability-map 64 方法）与
+ * kernelBoundary 都不需要 createAxis*（2D sketcher / TS compat 面需要）——清单按
+ * 「vendored 面实际触发面」保守枚举，缺即装配期报错。
  */
-export function bindOcctKernel() {
-    // Check the SHARED registry first (globalThis singleton): a CDN-bundled faijs
-    // instance has its own module-level `_bound = false`, but the host bundle may
-    // already have registered+bound 'occt-wasm'. Re-registering would throw
-    // "registry frozen" — treat an existing binding as bound instead.
+const GLUE_METHODS = [
+    'createVector3d',
+    'createPoint3d',
+    'createDirection3d',
+    'createAxis1',
+    'createAxis2',
+    'createAxis3',
+];
+let _injected = false;
+/**
+ * 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：
+ *
+ * - occt：`OcctWasmAdapter.fromKernel(当前引擎 primitives)`——同一 occt-wasm 单实例
+ *   （D10 不变），211 方法完整适配器，vendored 函数行为与旧 bindOcctKernel 完全一致；
+ * - 其它引擎（brepkit/mock）：将 BrepEngineApi 透传包装为 KernelAdapter 形态
+ *   （`dispose`→`release` 等方法名映射 + pattern 返回形态适配），**不做方法伪造**；
+ * - 任一引擎注入前都做**装配期完整性检查**（GLUE_METHODS 齐备断言）。
+ *
+ * 幂等：首次调用后注册并冻结；重复调用返回已注入的适配器。
+ *
+ * @returns 注册进 vendored registry 的 kernel adapter。
+ * @throws 无 BREP 引擎注册；或完整性检查失败（胶水方法缺失）——装配期报错。
+ */
+export async function injectCurrentBrepEngineAsKernel() {
+    // CDN 宿主跨实例同步：host bundle 已注入则直接复用（同旧 bindOcctKernel 语义）。
+    // 短路判据与 isKernelInjected() 一致（含 registry 侧激活 id 分支），避免
+    // 「registry 已注入但模块级 _injected=false」时走完整路径撞 frozen 抛错。
     syncRegistryFromGlobal();
-    if (_bound)
-        return getVendoredKernel('occt-wasm');
-    const faijsKernel = getFaijsKernel();
-    const adapter = OcctWasmAdapter.fromKernel(faijsKernel);
-    registerKernel('occt-wasm', adapter);
+    if (isKernelInjected())
+        return getVendoredKernel();
+    const engine = await getBrepEngine();
+    const adapter = buildKernelAdapter(engine);
+    assertGlueMethodsComplete(engine.id, adapter);
+    registerKernel(VENDORED_OCCT_KERNEL_ID, adapter);
     freezeKernels();
-    _bound = true;
+    _injected = true;
     syncRegistryToGlobal();
     return adapter;
 }
 /**
- * Whether the vendored kernel registry has been bound (D10).
- * @returns true once bound to the occt-wasm kernel.
+ * 按引擎 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 function buildKernelAdapter(engine) {
+    if (engine.id === 'occt') {
+        const faijsKernel = engine.primitives;
+        return OcctWasmAdapter.fromKernel(faijsKernel);
+    }
+    return wrapBrepEngineApi(engine.primitives);
+}
+/** No-op `delete` for synthesized glue objects (mirrors vendored `noop`). */
+const noop = () => { };
+/**
+ * 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 function isOcctKernelBound() {
-    return _bound && getActiveKernelId() === 'occt-wasm';
+export const UNMAPPED_VENDORED_MEASURE_METHODS = [
+    'area',
+    'length',
+    'linearCenterOfMass',
+];
+/** Unwrap a vendored KernelShape (handle view or bare number) to a BrepHandle. */
+function unwrapHandle(h) {
+    if (typeof h === 'number')
+        return h;
+    const view = h;
+    return typeof view.id === 'number' ? view.id : h;
+}
+/**
+ * Map vendored measure method names/shapes onto BrepEngineApi capabilities.
+ * The vendored measure face calls `kernel.volume/area/length/centerOfMass/...`
+ * (its own naming); the occt adapter carries an internal mapping layer — this
+ * is the engine-neutral equivalent for any wrapped BrepEngineApi. Only real
+ * BrepEngineApi capabilities are mapped; the rest stay in the gap registry.
+ */
+function mapMeasureMethods(adapter, api) {
+    adapter['volume'] = (s) => api.getVolume(unwrapHandle(s));
+    adapter['centerOfMass'] = (s) => {
+        const v = api.getCenterOfMass(unwrapHandle(s));
+        return [v.x, v.y, v.z];
+    };
+    adapter['boundingBox'] = (s) => {
+        const bb = api.getBoundingBox(unwrapHandle(s), true);
+        return {
+            min: [bb.xmin, bb.ymin, bb.zmin],
+            max: [bb.xmax, bb.ymax, bb.zmax],
+        };
+    };
+    // shapeType / isNull: same name, same semantics — already covered by the
+    // transparent pass-through in wrapBrepEngineApi; listed here for docs only.
+    // Known contract gaps (UNMAPPED_VENDORED_MEASURE_METHODS) are NOT stubbed:
+    // they remain undefined so tests can pin the gap explicitly.
 }
 /**
- * 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.
+ * Synthesize the vendored glue/auxiliary construction methods over any engine's
+ * primitives. These 6 methods are pure JS data-literal constructors in the
+ * vendored surface (zero kernel calls — see vendored constructionOps.ts), i.e.
+ * a *calling convention*, not a kernel capability — so they are synthesized at
+ * the faijs wrapper layer (engine-neutral) rather than added to BrepEngineApi.
+ * Field shapes are copied verbatim from the vendored occt adapter; `delete` is
+ * mandatory (kernelBoundary's with* helpers call it in `finally`).
+ */
+function synthesizeGlueMethods(adapter) {
+    const pnt = (x, y, z, __type) => ({ x, y, z, __type, delete: noop });
+    adapter['createPoint3d'] = (x, y, z) => pnt(x, y, z, 'point3d');
+    adapter['createDirection3d'] = (x, y, z) => pnt(x, y, z, 'direction3d');
+    adapter['createVector3d'] = (x, y, z) => pnt(x, y, z, 'vector3d');
+    adapter['createAxis1'] = (cx, cy, cz, dx, dy, dz) => ({
+        origin: { x: cx, y: cy, z: cz },
+        direction: { x: dx, y: dy, z: dz },
+        __type: 'axis1',
+        delete: noop,
+    });
+    // axis2/axis3: 6- or 9-arg forms (origin + zDir + optional xDir).
+    const makeAxis = (__type) => (ox, oy, oz, zx, zy, zz, xx, xy, xz) => ({
+        origin: { x: ox, y: oy, z: oz },
+        zDir: { x: zx, y: zy, z: zz },
+        xDir: xx !== undefined ? { x: xx, y: xy, z: xz } : undefined,
+        __type,
+        delete: noop,
+    });
+    adapter['createAxis2'] = makeAxis('axis2');
+    adapter['createAxis3'] = makeAxis('axis3');
+}
+/** 把 BrepEngineApi 透传包装为 KernelAdapter 形态（非 occt 引擎）。 */
+function wrapBrepEngineApi(api) {
+    const adapter = {
+        // 生命周期：vendored 面统一用 dispose（BrepEngineApi 用 release）。
+        dispose: (h) => api.release(h),
+    };
+    synthesizeGlueMethods(adapter);
+    for (const key of Object.keys(api)) {
+        if (key === 'release')
+            continue; // 上面已映射为 dispose
+        adapter[key] = api[key];
+    }
+    // 测量面映射在透传之后追加，覆盖同名键（vendored 名 → BrepEngineApi 名 + 形态转换）。
+    mapMeasureMethods(adapter, api);
+    // pattern 族形态适配（BrepEngineApi 对象 Vec3 ↔ vendored 三元组）。
+    adapter['linearPattern'] = (shape, direction, spacing, count) => api.linearPattern(shape, { x: direction[0], y: direction[1], z: direction[2] }, spacing, count).map((h) => ({ wrapped: h, type: 'solid' }));
+    adapter['circularPattern'] = (shape, center, axis, angleStep, count) => api.circularPattern(shape, { x: center[0], y: center[1], z: center[2] }, { x: axis[0], y: axis[1], z: axis[2] }, angleStep, count).map((h) => ({ wrapped: h, type: 'solid' }));
+    adapter['gridPattern'] = (shape, directionX, directionY, spacingX, spacingY, countX, countY) => ({
+        wrapped: api.gridPattern(shape, { x: directionX[0], y: directionX[1], z: directionX[2] }, { x: directionY[0], y: directionY[1], z: directionY[2] }, spacingX, spacingY, countX, countY),
+        type: 'compound',
+    });
+    return adapter;
+}
+/**
+ * 装配期完整性检查：KernelAdapter 胶水方法齐备断言。
+ *
+ * @param id - 引擎注册 id（报错时定位到引擎）。
+ * @param adapter - 待注入 vendored registry 的 KernelAdapter。
+ * @throws 缺失任一胶水方法 → 装配期报错（列出引擎 id 与缺失方法名）。
+ */
+export function assertGlueMethodsComplete(id, adapter) {
+    const missing = GLUE_METHODS.filter((m) => typeof adapter[m] !== 'function');
+    if (missing.length > 0) {
+        throw new Error(`[faijs] BREP engine '${id}' cannot back the vendored compat surface: KernelAdapter ` +
+            `missing glue method(s): ${missing.join(', ')}. These auxiliary construction methods ` +
+            `(createVector3d / createPoint3d / createDirection3d / createAxis1/2/3) are required by ` +
+            `the vendored kernel boundary and cannot be covered by capability declarations. ` +
+            `Fix the adapter (add real implementations) or do not inject this engine into the vendored registry.`);
+    }
+}
+/**
+ * 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 function __resetKernelInjectionForTests() {
+    _injected = false;
+    __resetKernelRegistryForTests();
+}
+/**
+ * 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 function isKernelInjected() {
+    syncRegistryFromGlobal();
+    return _injected || getActiveKernelId() !== null;
+}
+/**
+ * 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 function getBrepjsKernel() {
-    return getVendoredKernel('occt-wasm');
+    return getVendoredKernel();
+}
+/**
+ * 固定绑定 occt 内核到 vendored registry（Phase 2 前的装配方式）。
+ *
+ * @deprecated Phase 2 P2-5：固定绑定已被引擎中立的 injectCurrentBrepEngineAsKernel
+ * 取代。保留导出仅为兼容旧调用点（适配器层迁移期）；新代码一律用注入函数。
+ * @returns 恒抛错——本函数已移除，仅保留签名占位。
+ */
+export function bindOcctKernel() {
+    void getFaijsKernel;
+    throw new Error('[faijs] bindOcctKernel() removed (Phase 2 P2-5): use injectCurrentBrepEngineAsKernel() ' +
+        'during host assembly to inject the current BREP engine into the vendored registry.');
+}
+/**
+ * 旧 occt 专用注入判据（Phase 2 前语义：绑定且激活内核为 occt-wasm）。
+ *
+ * @deprecated Phase 2 P2-5：occt 专用判据已被引擎中立的 isKernelInjected() 取代。
+ * @returns 当前是否已注入（透传 isKernelInjected()）。
+ */
+export function isOcctKernelBound() {
+    return isKernelInjected();
 }
 //# sourceMappingURL=occt-kernel-bridge.js.map