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

package/dist/index.d.ts

@@ -70,6 +70,13 @@ interface KindComponentRow {
     isActive: boolean;
     componentSource: string | null;
     propsTransform: string | null;
+    /**
+     * Whether the row carries a real `component_source` body — supplied by the
+     * host when its warm list is BODY-LESS (the lazy design: metadata travels
+     * on the list, the body arrives per kind via the cold fetch). Omitted →
+     * derived from `componentSource` itself, so eager hosts change nothing.
+     */
+    hasComponentSource?: boolean;
     pinnedKindVersion: number | null;
     updatedAt: string | null;
     createdBy: string | null;
@@ -101,6 +108,14 @@ interface ComponentResolution {
     resolvedBy: "compiled" | "db";
     componentSource: string | null;
     propsTransform: string | null;
+    /**
+     * TRUE when the row owns a real component body — even if `componentSource`
+     * is null because the host's warm list is body-less and the cold fetch has
+     * not landed it yet. THE routing gate: `routeToDbComponent` re-types on
+     * this flag, never on body presence, so a body-less row still routes and
+     * the renderer fetches/compiles the body lazily.
+     */
+    hasComponentSource: boolean;
     pinnedKindVersion: number | null;
     /** The db row's `updated_at` — the compile-cache staleness key. */
     updatedAt: string | null;
@@ -452,7 +467,22 @@ type GenericFallbackReason =
  * kinds came to be certified as renderable while rendering generically
  * (found 2026-08-23).
  */
- | "generic-row";
+ | "generic-row"
+/**
+ * The envelope carries a kind-preserved RAW: the payload identified a
+ * registered kind but its value failed the schema (or the schema never
+ * arrived before the region closed). The instance is BROKEN, not
+ * component-less — the repair is fixing the payload/schema, and the generic
+ * floor must acknowledge the kind and surface the recorded problems.
+ */
+ | "broken-instance"
+/**
+ * The slug is not in the registry at all (typo, foreign emitter, a shape
+ * not yet created). Routed anyway — Arman's 2026-08-29 ruling: a root
+ * `__kind` key means the kind system owns the render, no exceptions. The
+ * repair is creating/registering the shape (or fixing the slug).
+ */
+ | "unregistered";
 interface IrRouteMarker {
     by: ComponentResolution["resolvedBy"] | "generic";
     key: string;

package/dist/index.js

@@ -120,6 +120,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
@@ -136,6 +137,7 @@ var ComponentResolver = class {
         resolvedBy: "compiled",
         componentSource: null,
         propsTransform: null,
+        hasComponentSource: false,
         pinnedKindVersion: null,
         updatedAt: null,
         createdBy: null
@@ -322,7 +324,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;
   }
@@ -381,6 +383,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) {
@@ -413,7 +421,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;
@@ -647,7 +655,7 @@ function GenericStructuredView({
   const { value, recovered } = readStructuredValue(content, metadata);
   const kind = envelope?.root.kind ?? (typeof value === "object" && value !== null && !Array.isArray(value) ? 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__ */ jsxs("div", { className: className ? `my-2 min-w-0 ${className}` : "my-2 min-w-0", children: [
     status === "streaming" ? streamingIndicator ?? /* @__PURE__ */ jsx("div", { className: "mb-2 text-xs text-muted-foreground", children: "Still arriving\u2026" }) : null,
     recovered ? host.renderValue({ value, ...kind ? { kind } : {}, note }) : (