@happyvertical/smrt-core 0.30.0

package/dist/registry/collision-policy.js

@@ -0,0 +1,153 @@
+const ROWS = [
+  // --- Cross-origin: constructor identity and stub replacement ----------
+  {
+    scenario: "same-constructor-reregistration",
+    match: (i) => i.sameConstructor,
+    policy: "accept",
+    reason: () => "Same constructor identity — module re-evaluation. Update metadata only."
+  },
+  {
+    // Decorator-only: the decorator fires after a manifest builder
+    // pre-registered a stub placeholder under this name. The real class
+    // takes over. Manifest-origin stub-to-stub arrivals fall through to
+    // the source-file / STI rows instead.
+    scenario: "manifest-stub-replacement",
+    match: (i) => i.origin === "decorator" && i.existingIsManifestStub && !i.sameConstructor,
+    policy: "replace",
+    reason: () => "Existing entry is a manifest stub placeholder; the real implementation takes over."
+  },
+  // --- Manifest-origin rows (checked before decorator-origin) -----------
+  {
+    scenario: "manifest-same-source-file",
+    match: (i) => i.origin === "manifest" && i.sameSourceFile,
+    policy: "skip",
+    reason: () => "Same source file — consumer manifest re-export, not a real collision."
+  },
+  {
+    scenario: "manifest-sti-child-wins",
+    match: (i) => i.origin === "manifest" && i.newExtendsExisting && !i.existingExtendsNew,
+    policy: "replace",
+    reason: () => "Manifest entry extends existing — STI child wins over parent."
+  },
+  {
+    scenario: "manifest-sti-parent-skip",
+    match: (i) => i.origin === "manifest" && i.existingExtendsNew && !i.newExtendsExisting,
+    policy: "skip",
+    reason: () => "Existing entry is the STI child of the incoming manifest parent; keep the child."
+  },
+  {
+    // Uses `existingHasAnyPackage` not `existingIsPackageQualified`: the
+    // pre-Release-C `allowCoexistingQualifiedRegistration` check only
+    // required both packages to be present and differ, regardless of
+    // whether they were scoped (`@scope/pkg`) or unscoped (`smrt-profiles`).
+    // Narrowing to scoped would silently drop coexistence for unscoped
+    // manifests. See PR #1140 review (willgriffin P2 at line 251).
+    scenario: "manifest-different-packages-qualified-coexist",
+    match: (i) => i.origin === "manifest" && !i.samePackage && i.hasNewQualifiedKey && i.existingHasAnyPackage,
+    policy: "coexist-qualified",
+    reason: () => "Different packages share a simple name; both registrations live under their qualified keys (issue #951)."
+  },
+  {
+    // Covers three related scenarios:
+    //   (a) `samePackage`          — decorator + manifest from the same
+    //       package land on the same class; merge fields (issue #1000).
+    //   (b) `existingHasNoPackage` — source registration hasn't been
+    //       promoted to a qualified key yet and a manifest now provides
+    //       the package identity (issue #951:144-200). The merge runs
+    //       AND the caller aliases the existing entry under the new
+    //       qualified key.
+    //   (c) The same scenarios when the existing entry is a manifest
+    //       stub from an earlier unqualified/local manifest registration
+    //       — the pre-Release-C code merged whenever
+    //       `!existing.packageName || packageName === existing.packageName`
+    //       regardless of stub status. Release C preserves that: removing
+    //       the `!existingIsManifestStub` gate lets a later
+    //       package-qualified manifest upgrade a stub's fields + alias
+    //       under the qualified key. See PR #1140 review (willgriffin P1
+    //       at line 270).
+    scenario: "manifest-same-package-merge",
+    match: (i) => i.origin === "manifest" && (i.samePackage || i.existingHasNoPackage && i.hasNewQualifiedKey) && i.hasManifestContent,
+    policy: "merge-manifest",
+    reason: () => "Manifest arriving for an existing same-package or unqualified source registration; fold fields in and alias the qualified key if keys differ."
+  },
+  {
+    scenario: "manifest-default-skip",
+    match: (i) => i.origin === "manifest",
+    policy: "skip",
+    reason: () => "Manifest collision with no inheritance relationship; keep existing entry (pre-Release-C resolveManifestCollision default)."
+  },
+  // --- Decorator-origin rows --------------------------------------------
+  {
+    scenario: "decorator-exact-match-same-package-external",
+    match: (i) => i.origin === "decorator" && i.matchKind === "exact-key" && i.existingIsPackageQualified && i.samePackage && !i.sameConstructor,
+    policy: "accept",
+    reason: () => "External package manifest entry being replaced by its own decorator-registered class (issue #584)."
+  },
+  {
+    // pnpm-dup allows unscoped package names (old code didn't gate on
+    // scoped-only). `samePackage` already requires both sides to have a
+    // packageName and match, so no extra existingHasAnyPackage check
+    // is needed.
+    scenario: "decorator-case-insensitive-pnpm-duplicate",
+    match: (i) => i.origin === "decorator" && i.matchKind === "case-insensitive" && i.existingKeyIsQualified && i.samePackage && i.sameName && !i.sameConstructor,
+    policy: "accept",
+    reason: () => "pnpm store duplicated the same package; different physical constructors but semantically identical."
+  },
+  {
+    scenario: "decorator-bundled-context-known-package",
+    match: (i) => i.origin === "decorator" && i.newInBundledContext && i.existingIsPackageQualified,
+    policy: "accept",
+    reason: () => "Bundled output duplicated a known package class across chunks; treat as re-registration."
+  },
+  {
+    scenario: "decorator-same-source-file",
+    match: (i) => i.origin === "decorator" && i.sameSourceFile,
+    policy: "accept",
+    reason: () => "Same source file — module re-evaluated (vitest test-isolation or HMR)."
+  },
+  {
+    scenario: "decorator-unknown-source-fallback",
+    match: (i) => i.origin === "decorator" && !i.bothSourceFilesKnown,
+    policy: "accept",
+    reason: () => "Source file unavailable for comparison; allow re-registration rather than block legitimate updates."
+  },
+  // --- Cross-origin STI fallbacks (used by decorator path; manifest
+  //     path has its own explicit rows above that come first) ------------
+  {
+    scenario: "sti-child-wins",
+    match: (i) => i.newExtendsExisting && !i.existingExtendsNew,
+    policy: "replace",
+    reason: () => "New class extends existing — STI child wins over parent."
+  },
+  {
+    scenario: "sti-parent-skip",
+    match: (i) => i.existingExtendsNew && !i.newExtendsExisting,
+    policy: "skip",
+    reason: () => "Existing entry extends new — STI child already registered."
+  },
+  // --- Default: unresolvable decorator collision ------------------------
+  {
+    scenario: "true-collision",
+    match: () => true,
+    policy: "throw",
+    reason: () => "Different constructors, different source files, no inheritance relationship. Unresolvable collision."
+  }
+];
+function decideCollisionPolicy(inputs) {
+  for (const row of ROWS) {
+    if (row.match(inputs)) {
+      return {
+        policy: row.policy,
+        scenario: row.scenario,
+        reason: row.reason(inputs)
+      };
+    }
+  }
+  throw new Error(
+    `decideCollisionPolicy: no row matched (should be unreachable). Inputs: ${JSON.stringify(inputs)}`
+  );
+}
+export {
+  decideCollisionPolicy
+};
+//# sourceMappingURL=collision-policy.js.map

package/dist/registry/collision-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collision-policy.js","sources":["../../src/registry/collision-policy.ts"],"sourcesContent":["/**\n * Release C (#1134) — unified collision policy for class registration.\n *\n * `register()` and `registerFromManifest()` both need to decide what to do\n * when a new registration lands on an existing class with the same (or a\n * case-insensitive-matching) name. Before Release C the decision logic was\n * a ~300-line if/else tree duplicated across three code paths:\n *\n *   - `register()` exact-match branch          (class-registration.ts:159-275)\n *   - `register()` case-insensitive branch     (class-registration.ts:286-391)\n *   - `resolveManifestCollision()`             (class-registration.ts:876-929)\n *\n * This module collapses all three onto a single decision table. Each row\n * names a scenario that exists in the current test suite; the row order\n * encodes specificity (first match wins).\n *\n * # Invocation contract\n *\n * `decideCollisionPolicy(inputs)` is ONLY called when the caller has already\n * identified exactly one colliding candidate for the new registration. Two\n * cases MUST be handled upstream without consulting the table:\n *\n *   1. No colliding candidate exists  → register fresh.\n *   2. Ambiguous simple name matches >1 existing entry across different\n *      packages (`getCanonicalClassName()` returns undefined) → fall through\n *      to the exact-key path and allow coexistence under qualified keys.\n *      See issue #951 for the semantics being preserved.\n *\n * Feeding the ambiguous case through the table would lose the\n * `coexist-qualified` behavior that's crucial for multi-package apps.\n *\n * @see https://github.com/happyvertical/smrt/issues/1134\n */\n\nexport type RegistrationOrigin = 'decorator' | 'manifest';\n\n/**\n * How the colliding candidate was identified.\n *\n *   - `exact-key`          : `classes.get(name)` returned the candidate.\n *                            `existingKey === name`.\n *   - `case-insensitive`   : Iteration found a case-insensitive match on\n *                            either the registry key or the entry's `name`\n *                            property. `existingKey !== name`.\n *   - `canonical-name`     : Looked up via `getCanonicalClassName(simpleName)`\n *                            — unambiguous single match under a lowered\n *                            simple name. Used by the manifest path.\n */\nexport type MatchKind = 'exact-key' | 'case-insensitive' | 'canonical-name';\n\nexport type Policy =\n  /** Keep existing identity, update metadata via `upsertExistingEntry`. */\n  | 'accept'\n  /** Drop existing, register new as replacement. */\n  | 'replace'\n  /**\n   * Fold manifest fields into existing registration. The **caller MUST**:\n   *   (1) call `mergeManifestIntoExistingRegistration(existing, objectDef, packageName)`\n   *   (2) if `registrationKey !== existingCanonical`, alias the existing entry\n   *       under `registrationKey` via `classes.set()` + `constructorIndex.set()`\n   * Both steps together preserve the `issue-951:144-200` contract.\n   */\n  | 'merge-manifest'\n  /**\n   * Different packages, different qualified keys. Both registrations stay\n   * in the classes Map under their respective qualified keys. Ambiguity is\n   * surfaced at `findClass` time. Preserves issue #951.\n   */\n  | 'coexist-qualified'\n  /** Existing wins; silently ignore the new registration. */\n  | 'skip'\n  /** Unresolvable collision — raise a user-facing error. */\n  | 'throw';\n\n/**\n * Every signal the decision table can read. Computed by the caller from\n * inspection of the new and existing registrations.\n */\nexport interface CollisionInputs {\n  readonly origin: RegistrationOrigin;\n  readonly matchKind: MatchKind;\n\n  /** `new.ctor === existing.constructor` (decorator path only; false for manifest). */\n  readonly sameConstructor: boolean;\n\n  /** `new.sourceFile === existing.sourceFilePath`, both truthy. */\n  readonly sameSourceFile: boolean;\n\n  /** Both the new and existing registrations have known source files. */\n  readonly bothSourceFilesKnown: boolean;\n\n  /** `existing.constructor._isManifestStub === true`. */\n  readonly existingIsManifestStub: boolean;\n\n  /**\n   * New registration's source file lives in a bundled output directory\n   * (`.svelte-kit/output/`, `/dist/`, `/build/`, `.next/`, `.nuxt/`).\n   */\n  readonly newInBundledContext: boolean;\n\n  /**\n   * New class extends existing.\n   *   - decorator path: `new.ctor.prototype instanceof existing.constructor`\n   *   - manifest path : `new.objectDef.extends` names existing\n   */\n  readonly newExtendsExisting: boolean;\n\n  /** Inverse direction: existing extends new. */\n  readonly existingExtendsNew: boolean;\n\n  /** `new.packageName === existing.packageName` (both truthy). */\n  readonly samePackage: boolean;\n\n  /**\n   * `existing.packageName?.startsWith('@')` — existing entry came from a\n   * **scoped** package manifest (e.g. `@happyvertical/smrt-core`). Used by\n   * the external-package-replace (#584) and bundled-context scenarios\n   * that were gated on `@` in pre-Release-C code.\n   */\n  readonly existingIsPackageQualified: boolean;\n\n  /**\n   * Existing entry carries any packageName, scoped or not. Broader than\n   * `existingIsPackageQualified`. Used for the different-packages\n   * coexistence scenario where pre-Release-C code only required both\n   * packageNames to be present and different (unscoped manifests like\n   * `smrt-profiles` count here).\n   */\n  readonly existingHasAnyPackage: boolean;\n\n  /**\n   * Case-sensitive equality between `new.name` and `existing.name`.\n   * Used to distinguish a pnpm-duplicate (same exact name) from a genuine\n   * case-insensitive collision (different names that lower to the same string).\n   */\n  readonly sameName: boolean;\n\n  /**\n   * New registration has (or can derive) a qualified key `@pkg:Name`.\n   * Paired with `existingIsPackageQualified` to drive the different-packages\n   * coexistence behavior from issue #951.\n   */\n  readonly hasNewQualifiedKey: boolean;\n\n  /**\n   * Existing registry key contains a `:` separator. Needed alongside\n   * `existingIsPackageQualified` to identify valid pnpm-dup candidates\n   * (old code required both).\n   */\n  readonly existingKeyIsQualified: boolean;\n\n  /**\n   * Manifest-origin only: the incoming `objectDef` carries at least one of\n   * `fields`, `methods`, `schema`, or `decoratorConfig`. Without that, the\n   * merge path has nothing to fold in and the caller should skip the\n   * merge-manifest policy entirely.\n   */\n  readonly hasManifestContent: boolean;\n\n  /**\n   * Manifest-origin only: the new registration's qualified key differs\n   * from the existing entry's canonical key. When true and the policy is\n   * `merge-manifest`, the caller MUST also alias the existing entry under\n   * the new qualified key (step 2 of the merge-manifest contract).\n   */\n  readonly registrationKeyDiffersFromExistingKey: boolean;\n\n  /**\n   * Existing registration has no `packageName` set. Distinct from\n   * `!samePackage`: this specifically means the existing entry is a bare\n   * source registration waiting for a package manifest to promote it. When\n   * true and the new registration carries a packageName, merge-manifest\n   * treats it as promotion rather than collision.\n   */\n  readonly existingHasNoPackage: boolean;\n}\n\nexport interface PolicyDecision {\n  readonly policy: Policy;\n  /** Stable id. Matches the scenario name in the test suite 1-to-1. */\n  readonly scenario: string;\n  /** Human-readable explanation. Used by verboseLog + the error message. */\n  readonly reason: string;\n}\n\ninterface Row {\n  readonly scenario: string;\n  readonly match: (inputs: CollisionInputs) => boolean;\n  readonly policy: Policy;\n  readonly reason: (inputs: CollisionInputs) => string;\n}\n\n/**\n * Ordered decision table. First row whose `match` returns true wins.\n * Order reflects specificity — scenarios that narrow down earlier\n * scenarios come before them.\n *\n * Each row is named to match a scenario in the test suite so a reviewer\n * can bisect one-to-one between \"new class extends existing\" (the code)\n * and \"sti-child-wins\" (the test row and the verbose-log output).\n */\nconst ROWS: readonly Row[] = [\n  // --- Cross-origin: constructor identity and stub replacement ----------\n\n  {\n    scenario: 'same-constructor-reregistration',\n    match: (i) => i.sameConstructor,\n    policy: 'accept',\n    reason: () =>\n      'Same constructor identity — module re-evaluation. Update metadata only.',\n  },\n\n  {\n    // Decorator-only: the decorator fires after a manifest builder\n    // pre-registered a stub placeholder under this name. The real class\n    // takes over. Manifest-origin stub-to-stub arrivals fall through to\n    // the source-file / STI rows instead.\n    scenario: 'manifest-stub-replacement',\n    match: (i) =>\n      i.origin === 'decorator' &&\n      i.existingIsManifestStub &&\n      !i.sameConstructor,\n    policy: 'replace',\n    reason: () =>\n      'Existing entry is a manifest stub placeholder; the real implementation takes over.',\n  },\n\n  // --- Manifest-origin rows (checked before decorator-origin) -----------\n\n  {\n    scenario: 'manifest-same-source-file',\n    match: (i) => i.origin === 'manifest' && i.sameSourceFile,\n    policy: 'skip',\n    reason: () =>\n      'Same source file — consumer manifest re-export, not a real collision.',\n  },\n\n  {\n    scenario: 'manifest-sti-child-wins',\n    match: (i) =>\n      i.origin === 'manifest' && i.newExtendsExisting && !i.existingExtendsNew,\n    policy: 'replace',\n    reason: () =>\n      'Manifest entry extends existing — STI child wins over parent.',\n  },\n\n  {\n    scenario: 'manifest-sti-parent-skip',\n    match: (i) =>\n      i.origin === 'manifest' && i.existingExtendsNew && !i.newExtendsExisting,\n    policy: 'skip',\n    reason: () =>\n      'Existing entry is the STI child of the incoming manifest parent; keep the child.',\n  },\n\n  {\n    // Uses `existingHasAnyPackage` not `existingIsPackageQualified`: the\n    // pre-Release-C `allowCoexistingQualifiedRegistration` check only\n    // required both packages to be present and differ, regardless of\n    // whether they were scoped (`@scope/pkg`) or unscoped (`smrt-profiles`).\n    // Narrowing to scoped would silently drop coexistence for unscoped\n    // manifests. See PR #1140 review (willgriffin P2 at line 251).\n    scenario: 'manifest-different-packages-qualified-coexist',\n    match: (i) =>\n      i.origin === 'manifest' &&\n      !i.samePackage &&\n      i.hasNewQualifiedKey &&\n      i.existingHasAnyPackage,\n    policy: 'coexist-qualified',\n    reason: () =>\n      'Different packages share a simple name; both registrations live under their qualified keys (issue #951).',\n  },\n\n  {\n    // Covers three related scenarios:\n    //   (a) `samePackage`          — decorator + manifest from the same\n    //       package land on the same class; merge fields (issue #1000).\n    //   (b) `existingHasNoPackage` — source registration hasn't been\n    //       promoted to a qualified key yet and a manifest now provides\n    //       the package identity (issue #951:144-200). The merge runs\n    //       AND the caller aliases the existing entry under the new\n    //       qualified key.\n    //   (c) The same scenarios when the existing entry is a manifest\n    //       stub from an earlier unqualified/local manifest registration\n    //       — the pre-Release-C code merged whenever\n    //       `!existing.packageName || packageName === existing.packageName`\n    //       regardless of stub status. Release C preserves that: removing\n    //       the `!existingIsManifestStub` gate lets a later\n    //       package-qualified manifest upgrade a stub's fields + alias\n    //       under the qualified key. See PR #1140 review (willgriffin P1\n    //       at line 270).\n    scenario: 'manifest-same-package-merge',\n    match: (i) =>\n      i.origin === 'manifest' &&\n      (i.samePackage || (i.existingHasNoPackage && i.hasNewQualifiedKey)) &&\n      i.hasManifestContent,\n    policy: 'merge-manifest',\n    reason: () =>\n      'Manifest arriving for an existing same-package or unqualified source registration; fold fields in and alias the qualified key if keys differ.',\n  },\n\n  {\n    scenario: 'manifest-default-skip',\n    match: (i) => i.origin === 'manifest',\n    policy: 'skip',\n    reason: () =>\n      'Manifest collision with no inheritance relationship; keep existing entry (pre-Release-C resolveManifestCollision default).',\n  },\n\n  // --- Decorator-origin rows --------------------------------------------\n\n  {\n    scenario: 'decorator-exact-match-same-package-external',\n    match: (i) =>\n      i.origin === 'decorator' &&\n      i.matchKind === 'exact-key' &&\n      i.existingIsPackageQualified &&\n      i.samePackage &&\n      !i.sameConstructor,\n    policy: 'accept',\n    reason: () =>\n      'External package manifest entry being replaced by its own decorator-registered class (issue #584).',\n  },\n\n  {\n    // pnpm-dup allows unscoped package names (old code didn't gate on\n    // scoped-only). `samePackage` already requires both sides to have a\n    // packageName and match, so no extra existingHasAnyPackage check\n    // is needed.\n    scenario: 'decorator-case-insensitive-pnpm-duplicate',\n    match: (i) =>\n      i.origin === 'decorator' &&\n      i.matchKind === 'case-insensitive' &&\n      i.existingKeyIsQualified &&\n      i.samePackage &&\n      i.sameName &&\n      !i.sameConstructor,\n    policy: 'accept',\n    reason: () =>\n      'pnpm store duplicated the same package; different physical constructors but semantically identical.',\n  },\n\n  {\n    scenario: 'decorator-bundled-context-known-package',\n    match: (i) =>\n      i.origin === 'decorator' &&\n      i.newInBundledContext &&\n      i.existingIsPackageQualified,\n    policy: 'accept',\n    reason: () =>\n      'Bundled output duplicated a known package class across chunks; treat as re-registration.',\n  },\n\n  {\n    scenario: 'decorator-same-source-file',\n    match: (i) => i.origin === 'decorator' && i.sameSourceFile,\n    policy: 'accept',\n    reason: () =>\n      'Same source file — module re-evaluated (vitest test-isolation or HMR).',\n  },\n\n  {\n    scenario: 'decorator-unknown-source-fallback',\n    match: (i) => i.origin === 'decorator' && !i.bothSourceFilesKnown,\n    policy: 'accept',\n    reason: () =>\n      'Source file unavailable for comparison; allow re-registration rather than block legitimate updates.',\n  },\n\n  // --- Cross-origin STI fallbacks (used by decorator path; manifest\n  //     path has its own explicit rows above that come first) ------------\n\n  {\n    scenario: 'sti-child-wins',\n    match: (i) => i.newExtendsExisting && !i.existingExtendsNew,\n    policy: 'replace',\n    reason: () => 'New class extends existing — STI child wins over parent.',\n  },\n\n  {\n    scenario: 'sti-parent-skip',\n    match: (i) => i.existingExtendsNew && !i.newExtendsExisting,\n    policy: 'skip',\n    reason: () => 'Existing entry extends new — STI child already registered.',\n  },\n\n  // --- Default: unresolvable decorator collision ------------------------\n\n  {\n    scenario: 'true-collision',\n    match: () => true,\n    policy: 'throw',\n    reason: () =>\n      'Different constructors, different source files, no inheritance relationship. Unresolvable collision.',\n  },\n];\n\n/**\n * Resolve a collision to a policy. See module docstring for the invocation\n * contract — callers MUST NOT invoke this for the no-candidate or\n * ambiguous-simple-name cases.\n */\nexport function decideCollisionPolicy(inputs: CollisionInputs): PolicyDecision {\n  for (const row of ROWS) {\n    if (row.match(inputs)) {\n      return {\n        policy: row.policy,\n        scenario: row.scenario,\n        reason: row.reason(inputs),\n      };\n    }\n  }\n  // Unreachable — `true-collision` is the final catch-all.\n  throw new Error(\n    `decideCollisionPolicy: no row matched (should be unreachable). Inputs: ${JSON.stringify(inputs)}`,\n  );\n}\n\n/** Test-only: expose the row list so integration tests can scenario-id. */\nexport const __POLICY_ROWS_FOR_TEST: readonly Row[] = ROWS;\n"],"names":[],"mappings":"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"}

package/dist/registry/diagnostics.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Registry diagnostic collector.
+ *
+ * ObjectRegistry's manifest-loading paths previously swallowed failure
+ * modes with `console.warn(...); return null`. That was fine for the
+ * average case but made #1132-style debugging hard: the only evidence of
+ * the problem was fields silently missing at save time.
+ *
+ * This module is the collection point for those failures. Callers
+ * `record()` a diagnostic when they would otherwise `console.warn`; apps
+ * and tests can call `ObjectRegistry.getDiagnostics()` to inspect what
+ * was missed.
+ *
+ * Release A shipped the collector as passive (off-by-default strict).
+ * Release C (#1134) flips strict mode to **on by default**: severity
+ * `'error'` diagnostics now throw at record time so misconfiguration
+ * surfaces at registration rather than at silent field-drop time. Opt
+ * out with `SMRT_STRICT_REGISTRY=false` if you have manifest-loading
+ * paths that must stay permissive (fix the underlying manifest issue
+ * instead when you can).
+ *
+ * @see https://github.com/happyvertical/smrt/issues/1132
+ * @see https://github.com/happyvertical/smrt/issues/1134
+ */
+export type RegistryDiagnosticSeverity = 'warn' | 'error';
+export interface RegistryDiagnostic {
+    severity: RegistryDiagnosticSeverity;
+    /** Stable machine-readable identifier, e.g., 'MANIFEST_LOAD_FAILED'. */
+    code: string;
+    /** Short human message. */
+    message: string;
+    /** Optional structured context (package name, path, etc.). */
+    context?: Record<string, unknown>;
+    /** Captured at record time. */
+    timestamp: number;
+}
+declare global {
+    var __smrtRegistryDiagnostics: RegistryDiagnostic[] | undefined;
+}
+/**
+ * Record a diagnostic from a registry load path.
+ *
+ * Always appends to the buffer. In strict mode (`SMRT_STRICT_REGISTRY=true`),
+ * severity `'error'` diagnostics also throw so the failure surfaces at the
+ * site of the drop instead of later during field access.
+ */
+export declare function recordRegistryDiagnostic(severity: RegistryDiagnosticSeverity, code: string, message: string, context?: Record<string, unknown>): void;
+/** Snapshot of diagnostics recorded so far. */
+export declare function getRegistryDiagnostics(): readonly RegistryDiagnostic[];
+/** Clear the diagnostic buffer — typically used in tests. */
+export declare function clearRegistryDiagnostics(): void;
+/**
+ * Pretty-print the diagnostic buffer to `console.warn` / `console.error`.
+ * Apps can call this at startup or on an error route to surface anything the
+ * registry swallowed. Does nothing if the buffer is empty.
+ */
+export declare function flushRegistryDiagnostics(): void;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/registry/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/registry/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,MAAM,MAAM,0BAA0B,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,yBAAyB,EAAE,kBAAkB,EAAE,GAAG,SAAS,CAAC;CACjE;AAoBD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,0BAA0B,EACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAoBN;AAED,+CAA+C;AAC/C,wBAAgB,sBAAsB,IAAI,SAAS,kBAAkB,EAAE,CAEtE;AAED,6DAA6D;AAC7D,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAgB/C"}

package/dist/registry/diagnostics.js

@@ -0,0 +1,54 @@
+import { createLogger } from "@happyvertical/logger";
+const logger = createLogger({ level: "info" });
+function getBuffer() {
+  if (!globalThis.__smrtRegistryDiagnostics) {
+    globalThis.__smrtRegistryDiagnostics = [];
+  }
+  return globalThis.__smrtRegistryDiagnostics;
+}
+function strictModeEnabled() {
+  return process.env.SMRT_STRICT_REGISTRY !== "false";
+}
+function recordRegistryDiagnostic(severity, code, message, context) {
+  const diagnostic = {
+    severity,
+    code,
+    message,
+    context,
+    timestamp: Date.now()
+  };
+  getBuffer().push(diagnostic);
+  if (severity === "error" && strictModeEnabled()) {
+    const suffix = context ? ` (${JSON.stringify(context)})` : "";
+    throw new Error(
+      `[smrt:${code}] ${message}${suffix} — set SMRT_STRICT_REGISTRY=false to record this diagnostic without throwing.`
+    );
+  }
+}
+function getRegistryDiagnostics() {
+  return [...getBuffer()];
+}
+function clearRegistryDiagnostics() {
+  getBuffer().length = 0;
+}
+function flushRegistryDiagnostics() {
+  const diagnostics = getBuffer();
+  if (diagnostics.length === 0) {
+    return;
+  }
+  for (const diag of diagnostics) {
+    const line = `[smrt:${diag.code}] ${diag.message}`;
+    if (diag.severity === "error") {
+      logger.error(line, diag.context);
+    } else {
+      logger.warn(line, diag.context);
+    }
+  }
+}
+export {
+  clearRegistryDiagnostics,
+  flushRegistryDiagnostics,
+  getRegistryDiagnostics,
+  recordRegistryDiagnostic
+};
+//# sourceMappingURL=diagnostics.js.map

package/dist/registry/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sources":["../../src/registry/diagnostics.ts"],"sourcesContent":["/**\n * Registry diagnostic collector.\n *\n * ObjectRegistry's manifest-loading paths previously swallowed failure\n * modes with `console.warn(...); return null`. That was fine for the\n * average case but made #1132-style debugging hard: the only evidence of\n * the problem was fields silently missing at save time.\n *\n * This module is the collection point for those failures. Callers\n * `record()` a diagnostic when they would otherwise `console.warn`; apps\n * and tests can call `ObjectRegistry.getDiagnostics()` to inspect what\n * was missed.\n *\n * Release A shipped the collector as passive (off-by-default strict).\n * Release C (#1134) flips strict mode to **on by default**: severity\n * `'error'` diagnostics now throw at record time so misconfiguration\n * surfaces at registration rather than at silent field-drop time. Opt\n * out with `SMRT_STRICT_REGISTRY=false` if you have manifest-loading\n * paths that must stay permissive (fix the underlying manifest issue\n * instead when you can).\n *\n * @see https://github.com/happyvertical/smrt/issues/1132\n * @see https://github.com/happyvertical/smrt/issues/1134\n */\n\nimport { createLogger } from '@happyvertical/logger';\n\nconst logger = createLogger({ level: 'info' });\n\nexport type RegistryDiagnosticSeverity = 'warn' | 'error';\n\nexport interface RegistryDiagnostic {\n  severity: RegistryDiagnosticSeverity;\n  /** Stable machine-readable identifier, e.g., 'MANIFEST_LOAD_FAILED'. */\n  code: string;\n  /** Short human message. */\n  message: string;\n  /** Optional structured context (package name, path, etc.). */\n  context?: Record<string, unknown>;\n  /** Captured at record time. */\n  timestamp: number;\n}\n\ndeclare global {\n  // eslint-disable-next-line no-var\n  var __smrtRegistryDiagnostics: RegistryDiagnostic[] | undefined;\n}\n\nfunction getBuffer(): RegistryDiagnostic[] {\n  if (!globalThis.__smrtRegistryDiagnostics) {\n    globalThis.__smrtRegistryDiagnostics = [];\n  }\n  return globalThis.__smrtRegistryDiagnostics;\n}\n\n/**\n * Strict mode: ON by default (Release C, #1134).\n *\n * When true, severity `'error'` diagnostics throw at record time instead\n * of just appending to the buffer. Set `SMRT_STRICT_REGISTRY=false` to\n * restore the pre-Release-C permissive behavior.\n */\nfunction strictModeEnabled(): boolean {\n  return process.env.SMRT_STRICT_REGISTRY !== 'false';\n}\n\n/**\n * Record a diagnostic from a registry load path.\n *\n * Always appends to the buffer. In strict mode (`SMRT_STRICT_REGISTRY=true`),\n * severity `'error'` diagnostics also throw so the failure surfaces at the\n * site of the drop instead of later during field access.\n */\nexport function recordRegistryDiagnostic(\n  severity: RegistryDiagnosticSeverity,\n  code: string,\n  message: string,\n  context?: Record<string, unknown>,\n): void {\n  const diagnostic: RegistryDiagnostic = {\n    severity,\n    code,\n    message,\n    context,\n    timestamp: Date.now(),\n  };\n  getBuffer().push(diagnostic);\n\n  if (severity === 'error' && strictModeEnabled()) {\n    const suffix = context ? ` (${JSON.stringify(context)})` : '';\n    // The opt-out hint is load-bearing when this throw propagates out of a\n    // `__smrt-register__.ts` side effect at module-import time — the\n    // consumer may have no other recovery path visible in the stack.\n    throw new Error(\n      `[smrt:${code}] ${message}${suffix} — set SMRT_STRICT_REGISTRY=false ` +\n        `to record this diagnostic without throwing.`,\n    );\n  }\n}\n\n/** Snapshot of diagnostics recorded so far. */\nexport function getRegistryDiagnostics(): readonly RegistryDiagnostic[] {\n  return [...getBuffer()];\n}\n\n/** Clear the diagnostic buffer — typically used in tests. */\nexport function clearRegistryDiagnostics(): void {\n  getBuffer().length = 0;\n}\n\n/**\n * Pretty-print the diagnostic buffer to `console.warn` / `console.error`.\n * Apps can call this at startup or on an error route to surface anything the\n * registry swallowed. Does nothing if the buffer is empty.\n */\nexport function flushRegistryDiagnostics(): void {\n  const diagnostics = getBuffer();\n  if (diagnostics.length === 0) {\n    return;\n  }\n\n  for (const diag of diagnostics) {\n    const line = `[smrt:${diag.code}] ${diag.message}`;\n    // diag.context is already a structured object; pass it through directly\n    // rather than nesting it under a redundant `context` key.\n    if (diag.severity === 'error') {\n      logger.error(line, diag.context);\n    } else {\n      logger.warn(line, diag.context);\n    }\n  }\n}\n"],"names":[],"mappings":";AA2BA,MAAM,SAAS,aAAa,EAAE,OAAO,QAAQ;AAqB7C,SAAS,YAAkC;AACzC,MAAI,CAAC,WAAW,2BAA2B;AACzC,eAAW,4BAA4B,CAAA;AAAA,EACzC;AACA,SAAO,WAAW;AACpB;AASA,SAAS,oBAA6B;AACpC,SAAO,QAAQ,IAAI,yBAAyB;AAC9C;AASO,SAAS,yBACd,UACA,MACA,SACA,SACM;AACN,QAAM,aAAiC;AAAA,IACrC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW,KAAK,IAAA;AAAA,EAAI;AAEtB,YAAA,EAAY,KAAK,UAAU;AAE3B,MAAI,aAAa,WAAW,qBAAqB;AAC/C,UAAM,SAAS,UAAU,KAAK,KAAK,UAAU,OAAO,CAAC,MAAM;AAI3D,UAAM,IAAI;AAAA,MACR,SAAS,IAAI,KAAK,OAAO,GAAG,MAAM;AAAA,IAAA;AAAA,EAGtC;AACF;AAGO,SAAS,yBAAwD;AACtE,SAAO,CAAC,GAAG,WAAW;AACxB;AAGO,SAAS,2BAAiC;AAC/C,YAAA,EAAY,SAAS;AACvB;AAOO,SAAS,2BAAiC;AAC/C,QAAM,cAAc,UAAA;AACpB,MAAI,YAAY,WAAW,GAAG;AAC5B;AAAA,EACF;AAEA,aAAW,QAAQ,aAAa;AAC9B,UAAM,OAAO,SAAS,KAAK,IAAI,KAAK,KAAK,OAAO;AAGhD,QAAI,KAAK,aAAa,SAAS;AAC7B,aAAO,MAAM,MAAM,KAAK,OAAO;AAAA,IACjC,OAAO;AACL,aAAO,KAAK,MAAM,KAAK,OAAO;AAAA,IAChC;AAAA,EACF;AACF;"}

package/dist/registry/embedding-manager.d.ts

@@ -0,0 +1,23 @@
+import { ClassEmbeddingConfig, ProjectEmbeddingConfig, ResolvedEmbeddingConfig } from '../embeddings/types';
+/**
+ * Get embedding configuration for a class.
+ */
+export declare function getEmbeddingConfig(className: string): ClassEmbeddingConfig | undefined;
+/**
+ * Check if a class has embeddings enabled.
+ */
+export declare function hasEmbeddings(className: string): boolean;
+/**
+ * Get all registered classes that have embeddings enabled.
+ */
+export declare function getEmbeddingClasses(): string[];
+/**
+ * Get project-level embedding configuration with defaults applied.
+ */
+export declare function getProjectEmbeddingConfig(): ProjectEmbeddingConfig;
+/**
+ * Resolve complete embedding configuration for a class.
+ * Merges project-level config with class-level overrides.
+ */
+export declare function resolveEmbeddingConfig(className: string): ResolvedEmbeddingConfig | undefined;
+//# sourceMappingURL=embedding-manager.d.ts.map

package/dist/registry/embedding-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-manager.d.ts","sourceRoot":"","sources":["../../src/registry/embedding-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAI7B;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,GAChB,oBAAoB,GAAG,SAAS,CAMlC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAS9C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,sBAAsB,CAYlE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,GAChB,uBAAuB,GAAG,SAAS,CAmBrC"}

package/dist/registry/embedding-manager.js

@@ -0,0 +1,62 @@
+import { getSmrtModuleConfig } from "../config/global-config.js";
+import { findClass } from "./name-resolver.js";
+import { getClasses } from "./shared-state.js";
+function getEmbeddingConfig(className) {
+  const registered = findClass(className);
+  if (!registered?.config?.embeddings) {
+    return void 0;
+  }
+  return registered.config.embeddings;
+}
+function hasEmbeddings(className) {
+  const config = getEmbeddingConfig(className);
+  return config !== void 0 && config.fields.length > 0;
+}
+function getEmbeddingClasses() {
+  const embeddingClasses = [];
+  for (const [_key, entry] of getClasses()) {
+    const simpleName = entry.name || _key;
+    if (hasEmbeddings(simpleName)) {
+      embeddingClasses.push(simpleName);
+    }
+  }
+  return embeddingClasses;
+}
+function getProjectEmbeddingConfig() {
+  const globalConfig = getSmrtModuleConfig("smrt", {});
+  const embeddingConfig = globalConfig?.embeddings;
+  return {
+    dimensions: embeddingConfig?.dimensions ?? 768,
+    provider: embeddingConfig?.provider ?? "local",
+    localModel: embeddingConfig?.localModel ?? "Xenova/bge-base-en-v1.5",
+    aiModel: embeddingConfig?.aiModel ?? "text-embedding-3-small",
+    fallbackToAI: embeddingConfig?.fallbackToAI ?? false,
+    storage: embeddingConfig?.storage ?? "json"
+  };
+}
+function resolveEmbeddingConfig(className) {
+  const classConfig = getEmbeddingConfig(className);
+  if (!classConfig) {
+    return void 0;
+  }
+  const projectConfig = getProjectEmbeddingConfig();
+  return {
+    fields: classConfig.fields,
+    combinedField: classConfig.combinedField,
+    dimensions: projectConfig.dimensions,
+    provider: classConfig.provider ?? projectConfig.provider,
+    localModel: projectConfig.localModel ?? "Xenova/bge-base-en-v1.5",
+    aiModel: projectConfig.aiModel ?? "text-embedding-3-small",
+    fallbackToAI: projectConfig.fallbackToAI ?? false,
+    autoGenerate: classConfig.autoGenerate ?? true,
+    regenerateOnChange: classConfig.regenerateOnChange ?? true
+  };
+}
+export {
+  getEmbeddingClasses,
+  getEmbeddingConfig,
+  getProjectEmbeddingConfig,
+  hasEmbeddings,
+  resolveEmbeddingConfig
+};
+//# sourceMappingURL=embedding-manager.js.map

package/dist/registry/embedding-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-manager.js","sources":["../../src/registry/embedding-manager.ts"],"sourcesContent":["/**\n * Embedding configuration management for the SMRT ObjectRegistry.\n *\n * Handles class-level and project-level embedding config resolution.\n *\n * Extracted from registry.ts as part of issue #1006.\n * @see https://github.com/happyvertical/smrt/issues/1006\n */\n\nimport {\n  getSmrtModuleConfig,\n  type SmrtGlobalConfig,\n} from '../config/global-config.js';\nimport type {\n  ClassEmbeddingConfig,\n  ProjectEmbeddingConfig,\n  ResolvedEmbeddingConfig,\n} from '../embeddings/types';\nimport { findClass } from './name-resolver';\nimport { getClasses } from './shared-state';\n\n/**\n * Get embedding configuration for a class.\n */\nexport function getEmbeddingConfig(\n  className: string,\n): ClassEmbeddingConfig | undefined {\n  const registered = findClass(className);\n  if (!registered?.config?.embeddings) {\n    return undefined;\n  }\n  return registered.config.embeddings as ClassEmbeddingConfig;\n}\n\n/**\n * Check if a class has embeddings enabled.\n */\nexport function hasEmbeddings(className: string): boolean {\n  const config = getEmbeddingConfig(className);\n  return config !== undefined && config.fields.length > 0;\n}\n\n/**\n * Get all registered classes that have embeddings enabled.\n */\nexport function getEmbeddingClasses(): string[] {\n  const embeddingClasses: string[] = [];\n  for (const [_key, entry] of getClasses()) {\n    const simpleName = entry.name || _key;\n    if (hasEmbeddings(simpleName)) {\n      embeddingClasses.push(simpleName);\n    }\n  }\n  return embeddingClasses;\n}\n\n/**\n * Get project-level embedding configuration with defaults applied.\n */\nexport function getProjectEmbeddingConfig(): ProjectEmbeddingConfig {\n  const globalConfig = getSmrtModuleConfig<SmrtGlobalConfig>('smrt', {});\n  const embeddingConfig = globalConfig?.embeddings;\n\n  return {\n    dimensions: embeddingConfig?.dimensions ?? 768,\n    provider: embeddingConfig?.provider ?? 'local',\n    localModel: embeddingConfig?.localModel ?? 'Xenova/bge-base-en-v1.5',\n    aiModel: embeddingConfig?.aiModel ?? 'text-embedding-3-small',\n    fallbackToAI: embeddingConfig?.fallbackToAI ?? false,\n    storage: embeddingConfig?.storage ?? 'json',\n  };\n}\n\n/**\n * Resolve complete embedding configuration for a class.\n * Merges project-level config with class-level overrides.\n */\nexport function resolveEmbeddingConfig(\n  className: string,\n): ResolvedEmbeddingConfig | undefined {\n  const classConfig = getEmbeddingConfig(className);\n  if (!classConfig) {\n    return undefined;\n  }\n\n  const projectConfig = getProjectEmbeddingConfig();\n\n  return {\n    fields: classConfig.fields,\n    combinedField: classConfig.combinedField,\n    dimensions: projectConfig.dimensions,\n    provider: classConfig.provider ?? projectConfig.provider,\n    localModel: projectConfig.localModel ?? 'Xenova/bge-base-en-v1.5',\n    aiModel: projectConfig.aiModel ?? 'text-embedding-3-small',\n    fallbackToAI: projectConfig.fallbackToAI ?? false,\n    autoGenerate: classConfig.autoGenerate ?? true,\n    regenerateOnChange: classConfig.regenerateOnChange ?? true,\n  };\n}\n"],"names":[],"mappings":";;;AAwBO,SAAS,mBACd,WACkC;AAClC,QAAM,aAAa,UAAU,SAAS;AACtC,MAAI,CAAC,YAAY,QAAQ,YAAY;AACnC,WAAO;AAAA,EACT;AACA,SAAO,WAAW,OAAO;AAC3B;AAKO,SAAS,cAAc,WAA4B;AACxD,QAAM,SAAS,mBAAmB,SAAS;AAC3C,SAAO,WAAW,UAAa,OAAO,OAAO,SAAS;AACxD;AAKO,SAAS,sBAAgC;AAC9C,QAAM,mBAA6B,CAAA;AACnC,aAAW,CAAC,MAAM,KAAK,KAAK,cAAc;AACxC,UAAM,aAAa,MAAM,QAAQ;AACjC,QAAI,cAAc,UAAU,GAAG;AAC7B,uBAAiB,KAAK,UAAU;AAAA,IAClC;AAAA,EACF;AACA,SAAO;AACT;AAKO,SAAS,4BAAoD;AAClE,QAAM,eAAe,oBAAsC,QAAQ,EAAE;AACrE,QAAM,kBAAkB,cAAc;AAEtC,SAAO;AAAA,IACL,YAAY,iBAAiB,cAAc;AAAA,IAC3C,UAAU,iBAAiB,YAAY;AAAA,IACvC,YAAY,iBAAiB,cAAc;AAAA,IAC3C,SAAS,iBAAiB,WAAW;AAAA,IACrC,cAAc,iBAAiB,gBAAgB;AAAA,IAC/C,SAAS,iBAAiB,WAAW;AAAA,EAAA;AAEzC;AAMO,SAAS,uBACd,WACqC;AACrC,QAAM,cAAc,mBAAmB,SAAS;AAChD,MAAI,CAAC,aAAa;AAChB,WAAO;AAAA,EACT;AAEA,QAAM,gBAAgB,0BAAA;AAEtB,SAAO;AAAA,IACL,QAAQ,YAAY;AAAA,IACpB,eAAe,YAAY;AAAA,IAC3B,YAAY,cAAc;AAAA,IAC1B,UAAU,YAAY,YAAY,cAAc;AAAA,IAChD,YAAY,cAAc,cAAc;AAAA,IACxC,SAAS,cAAc,WAAW;AAAA,IAClC,cAAc,cAAc,gBAAgB;AAAA,IAC5C,cAAc,YAAY,gBAAgB;AAAA,IAC1C,oBAAoB,YAAY,sBAAsB;AAAA,EAAA;AAE1D;"}

package/dist/registry/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Registry module barrel export.
+ *
+ * Re-exports all sub-modules for convenient importing.
+ * @see https://github.com/happyvertical/smrt/issues/1006
+ */
+export { getEmbeddingClasses, getEmbeddingConfig, getProjectEmbeddingConfig, hasEmbeddings, resolveEmbeddingConfig, } from './embedding-manager';
+export { findClass, findClassesByName, findClassStrict, getAllClasses, getCanonicalClassName, getClass, getClassByConstructor, getClassByQualifiedName, getClassesByPackage, getClassesByVisibility, getClassInPackage, getClassNames, getPublicClasses, getQualifiedClassNames, hasClass, hasClassCaseInsensitive, qualifyExtendsName, resolveType, } from './name-resolver';
+export { getDependencyGraph, getRelationshipMap } from './relationship-graph';
+export { getClasses, getCollectionCache, getCollections, getCollectionTableNames, getConstructorIndex, getDbInstanceIds, getDiscoveryAttemptCache, getFieldDecorators, getInheritanceCache, getInheritanceConfig, getNextDbId, getSchemasInitialized, getSourceFileFromStack, getStiSiblingsLoaded, setNextDbId, VERBOSE_ENABLED, verboseLog, } from './shared-state';
+export type { ApiConfig, RegisteredClass, RelationshipMetadata, RelationshipType, SmartObjectConfig, SmrtObjectConstructor, ValidatorFunction, } from './types';
+export { compileValidators } from './validator';
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,aAAa,EACb,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,QAAQ,EACR,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,QAAQ,EACR,uBAAuB,EACvB,kBAAkB,EAClB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,EACX,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,UAAU,GACX,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/registry/inheritance-resolver.d.ts

@@ -0,0 +1,13 @@
+import { SmrtObject } from '../object';
+/**
+ * Build inheritance chain by walking prototype chain
+ *
+ * Walks from child → parent → ... → SmrtObject, building array from base to child.
+ * Stops at SmrtObject (the framework base class).
+ */
+export declare function buildInheritanceChain(ctor: typeof SmrtObject): string[];
+export declare function getInheritanceChain(className: string): string[];
+export declare function getAllFields(className: string): Promise<Map<string, any>>;
+export declare function mergeFieldConfigs(parentField: any, childField: any, fieldName: string): any;
+export declare function getAllMethods(className: string): Promise<Map<string, any>>;
+//# sourceMappingURL=inheritance-resolver.d.ts.map

package/dist/registry/inheritance-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inheritance-resolver.d.ts","sourceRoot":"","sources":["../../src/registry/inheritance-resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAY5C;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,UAAU,GAAG,MAAM,EAAE,CAyBvE;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAgG/D;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAkG3B;AA4BD,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,GAAG,EAChB,UAAU,EAAE,GAAG,EACf,SAAS,EAAE,MAAM,GAChB,GAAG,CA6EL;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAiD3B"}