@ai-matrx/content-ir-react 0.2.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## 0.5.0 — 2026-08-29
+
+- **`hasComponentSource` — the seam that lets component BODIES load lazily.**
+  `KindComponentRow` gains optional `hasComponentSource` (a host whose warm
+  list is body-less supplies it; omitted → derived from `componentSource`,
+  so eager hosts change nothing) and `ComponentResolution` carries it
+  computed. `routeToDbComponent` now gates on the FLAG, never on body
+  presence: a body-less row from a lazy warm list still routes to
+  `db_kind_component`, and the renderer fetches/compiles the body per kind
+  on demand. A row that truly has no body screams and falls through exactly
+  as before. Pinned by a new kind-route test.
+
+## 0.4.0 — 2026-08-29
+
+- **NO EXCEPTIONS for a root `__kind` (Arman's ruling, 2026-08-29).** The
+  strangler carve-out that left an UNREGISTERED kind slug untouched ("not
+  ours to claim" — teaching content, typos) is retired: any envelope with a
+  non-empty root kind now routes into the kind system. Unregistered slugs
+  reach the generic floor with the new `GenericFallbackReason`
+  `"unregistered"` (kind-preserved raws included), so the reader always sees
+  the payload acknowledged AS a kind instance — never an anonymous code
+  block. Both former pass-through tests flipped to pin the new behavior.
+
+## 0.3.0 — 2026-08-29
+
+- **`broken-instance` — the kind route now acknowledges BROKEN kind
+  instances.** An envelope whose root is a kind-preserved raw
+  (`kindState: "raw"`, kernel ≥ 0.3.0 preserves the kind on structural
+  failures too) routes to the generic floor with
+  `reason: "broken-instance"` when the kind is registered — never to a
+  bridge/db component (they must not receive non-compliant values) and never
+  as anonymous raw JSON. Unregistered slugs still pass through untouched.
+  New `GenericFallbackReason` member; `GenericStructuredView`'s honesty note
+  names the schema mismatch. Pinned by two new kind-route tests.
+- Depends on `@ai-matrx/content-ir` 0.3.0.
+
 ## 0.1.0 — 2026-08-23
 
 First release: the shared Content IR RENDER layer, extracted from

package/dist/index.cjs

@@ -126,6 +126,7 @@ var ComponentResolver = class {
         resolvedBy: "db",
         componentSource: dbRow.componentSource,
         propsTransform: dbRow.propsTransform,
+        hasComponentSource: dbRow.hasComponentSource ?? Boolean(dbRow.componentSource && dbRow.componentSource.trim()),
         pinnedKindVersion: dbRow.pinnedKindVersion,
         updatedAt: dbRow.updatedAt,
         createdBy: dbRow.createdBy
@@ -142,6 +143,7 @@ var ComponentResolver = class {
         resolvedBy: "compiled",
         componentSource: null,
         propsTransform: null,
+        hasComponentSource: false,
         pinnedKindVersion: null,
         updatedAt: null,
         createdBy: null
@@ -328,7 +330,7 @@ function resetSourcelessDbRowReports() {
 }
 function routeToDbComponent(block, kind, resolution, env) {
   if (!isDbSourceResolution(resolution)) return null;
-  if (!resolution.componentSource || !resolution.componentSource.trim()) {
+  if (!resolution.hasComponentSource) {
     reportDbRowWithoutSource(kind, env);
     return null;
   }
@@ -387,6 +389,12 @@ function applyIrKindRoute(block, env, options) {
   if (envelope.root.kindState === "pending_schema") return block;
   const def = env.kinds.getDefinition(kind);
   const resolution = env.components.resolve(kind, env.platform, "output");
+  if (envelope.root.kindState === "raw") {
+    return routeToGeneric(
+      block,
+      def || resolution ? "broken-instance" : "unregistered"
+    );
+  }
   const dbRouted = routeToDbComponent(block, kind, resolution, env);
   if (dbRouted) return dbRouted;
   if (def?.legacyBlockType) {
@@ -419,7 +427,7 @@ function applyIrKindRoute(block, env, options) {
   if (def) {
     return routeToGeneric(block, resolution ? "inactive" : "no-component");
   }
-  return block;
+  return routeToGeneric(block, "unregistered");
 }
 function kindServerDataFromStoredValue(value, env) {
   if (!isRecord(value)) return null;
@@ -653,7 +661,7 @@ function GenericStructuredView({
   const { value, recovered } = readStructuredValue(content, metadata);
   const kind = envelope?.root.kind ?? (typeof value === "object" && value !== null && !Array.isArray(value) ? contentIr.readObjectKind(value) : null) ?? "";
   const marker = readIrRouteMarker(metadata);
-  const note = marker?.reason === "inactive" ? "a custom view is registered but held inactive" : "no custom view yet";
+  const note = marker?.reason === "inactive" ? "a custom view is registered but held inactive" : marker?.reason === "broken-instance" ? "this instance did not match the shape's schema" : marker?.reason === "unregistered" ? "this shape isn't registered on this platform" : "no custom view yet";
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: className ? `my-2 min-w-0 ${className}` : "my-2 min-w-0", children: [
     status === "streaming" ? streamingIndicator ?? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "mb-2 text-xs text-muted-foreground", children: "Still arriving\u2026" }) : null,
     recovered ? host.renderValue({ value, ...kind ? { kind } : {}, note }) : (