@ai-matrx/content-ir-react 0.7.1 → 0.8.0

package/dist/index.js

@@ -1,7 +1,3 @@
-import React, { createContext, useContext, useMemo, useCallback, useSyncExternalStore, useState, useEffect } from 'react';
-import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
-import { readEnvelope, readObjectKind, envelopeFromCompleteValue, IR_VERSION, readPartialKindEvent, isProvisionalKind, IR_PARTIAL_KEY, IR_ENVELOPE_KEY, reconstructRegionValue, readNodeOutcomeValue, readRunResultValue } from '@ai-matrx/content-ir';
-
 // host/error-report.ts
 var consoleErrorReporter = (report) => {
   console.error(`[content-ir] ${report.message}`, report.raw ?? "");
@@ -16,6 +12,10 @@ function routeEnvOf(host) {
     platform: host.platform
   };
 }
+
+// host/ContentIrProvider.tsx
+import { createContext, useContext, useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
 var ContentIrHostContext = createContext(null);
 function ContentIrRenderProvider({
   host,
@@ -335,13 +335,23 @@ var ComponentResolver = class {
     return this.warmPromise;
   }
 };
+
+// route/kind-route.ts
+import {
+  envelopeFromCompleteValue,
+  readEnvelope,
+  readObjectKind
+} from "@ai-matrx/content-ir";
 var IR_ROUTE_KEY = "__ir_route";
 var GENERIC_STRUCTURED_COMPONENT_KEY = "generic_structured";
 var DB_KIND_COMPONENT_KEY = "db_kind_component";
 function isDbSourceResolution(resolution) {
   return resolution !== null && resolution.resolvedBy === "db" && resolution.source === "db" && resolution.isActive;
 }
-var reportedSourcelessDbRows = /* @__PURE__ */ new Set();
+var SOURCELESS_DB_ROW_SLOT = /* @__PURE__ */ Symbol.for(
+  "ai-matrx.content-ir-react.sourceless-db-row-reports"
+);
+var reportedSourcelessDbRows = globalThis[SOURCELESS_DB_ROW_SLOT] ??= /* @__PURE__ */ new Set();
 function reportDbRowWithoutSource(kind, env) {
   const message = `[content-ir] kind_component for "${kind}" declares source='db' + is_active but has NO component_source \u2014 data defect; falling through to bundled rendering.`;
   if (!reportedSourcelessDbRows.has(kind)) {
@@ -462,6 +472,16 @@ function kindServerDataFromStoredValue(value, env) {
   if (!def?.toLegacyServerData) return null;
   return def.toLegacyServerData(envelopeFromCompleteValue(value, kind)) ?? null;
 }
+
+// route/partial-kind-route.ts
+import {
+  IR_ENVELOPE_KEY,
+  IR_PARTIAL_KEY,
+  IR_VERSION,
+  isProvisionalKind,
+  readEnvelope as readEnvelope2,
+  readPartialKindEvent
+} from "@ai-matrx/content-ir";
 var IR_PROVISIONAL_KEY = "__ir_provisional";
 function isProvisionalBlock(metadata) {
   return metadata?.[IR_PROVISIONAL_KEY] === true;
@@ -477,7 +497,10 @@ function envelopeFromPartialKind(event) {
     root: event.root
   };
 }
-var partialUnsafeKinds = /* @__PURE__ */ new Set();
+var PARTIAL_UNSAFE_SLOT = /* @__PURE__ */ Symbol.for(
+  "ai-matrx.content-ir-react.partial-unsafe-kinds"
+);
+var partialUnsafeKinds = globalThis[PARTIAL_UNSAFE_SLOT] ??= /* @__PURE__ */ new Set();
 function markKindPartialUnsafe(kind) {
   partialUnsafeKinds.add(kind);
 }
@@ -494,7 +517,7 @@ function resolveAnnouncedKindLoading(block, options) {
   if (!isProvisionalKind(event)) return null;
   const kind = event.root.kind;
   if (!kind) return null;
-  const verified = readEnvelope(block.metadata);
+  const verified = readEnvelope2(block.metadata);
   if (verified && verified.root.status === "complete") return null;
   return { kind, envelope: envelopeFromPartialKind(event) };
 }
@@ -504,9 +527,10 @@ function resolveProvisionalKindRender(block, env, options) {
   if (!isProvisionalKind(event)) return null;
   const kind = event.root.kind;
   if (!isPartialReadyKind(kind, env)) return null;
-  const verified = readEnvelope(block.metadata);
+  const verified = readEnvelope2(block.metadata);
   if (verified && verified.root.status === "complete") return null;
   const { [IR_PARTIAL_KEY]: _partial, ...rest } = block.metadata ?? {};
+  void _partial;
   const envelope = envelopeFromPartialKind(event);
   const provisionalBlock = {
     ...block,
@@ -526,6 +550,23 @@ function resolveProvisionalKindRender(block, env, options) {
   }
   return { block: routed, kind, seq: event.seq, envelope };
 }
+
+// route/route-binding.ts
+function createKindRouteBinding(env, options) {
+  const ownedTypes = options?.ownedTypes;
+  return {
+    applyIrKindRoute: (block) => applyIrKindRoute(block, env, ownedTypes ? { ownedTypes } : void 0),
+    kindServerDataFromStoredValue: (value) => kindServerDataFromStoredValue(value, env),
+    isPartialReadyKind: (kind) => isPartialReadyKind(kind, env),
+    resolveProvisionalKindRender: (block, streamOptions) => resolveProvisionalKindRender(block, env, {
+      ...streamOptions,
+      ...ownedTypes ? { ownedTypes } : null
+    })
+  };
+}
+
+// react/use-kind-version.ts
+import { useCallback, useSyncExternalStore } from "react";
 var noopSubscribe = () => () => {
 };
 var zero = () => 0;
@@ -562,6 +603,11 @@ function useContentIrKindVersion(kind, sources) {
   );
   return useSyncExternalStore(subscribe, getSnapshot, zero);
 }
+
+// react/KindInstanceRender.tsx
+import { useEffect, useState } from "react";
+import { envelopeFromCompleteValue as envelopeFromCompleteValue2, IR_ENVELOPE_KEY as IR_ENVELOPE_KEY2 } from "@ai-matrx/content-ir";
+import { Fragment, jsx as jsx2, jsxs } from "react/jsx-runtime";
 function isRecordValue(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -615,20 +661,24 @@ function KindInstanceRender({
     content: JSON.stringify(value, null, 2),
     language: "json",
     metadata: {
-      [IR_ENVELOPE_KEY]: envelopeFromCompleteValue(value, kind)
+      [IR_ENVELOPE_KEY2]: envelopeFromCompleteValue2(value, kind)
     }
   } : null;
   const frameClass = variant === "bare" ? void 0 : "rounded-md border border-border bg-card p-3";
   if (routingStatus === "unroutable" && unroutableFallback !== void 0) {
-    return /* @__PURE__ */ jsx(Fragment, { children: unroutableFallback });
+    return /* @__PURE__ */ jsx2(Fragment, { children: unroutableFallback });
   }
   const onTheFloor = block === null || routingStatus === "unroutable";
   const notice = "This shape has no custom component yet, so it renders through the universal viewer \u2014 exactly what production shows today.";
   return /* @__PURE__ */ jsxs("div", { className: className ? `space-y-3 ${className}` : "space-y-3", children: [
-    showRoutingNote && routingStatus === "unroutable" ? host.renderNotice?.(notice) ?? /* @__PURE__ */ jsx("div", { className: "rounded-md border border-amber-500/30 bg-amber-500/5 px-3 py-2 text-xs text-amber-800 dark:text-amber-200", children: notice }) : null,
-    /* @__PURE__ */ jsx("div", { className: frameClass, children: onTheFloor ? host.renderValue({ value, kind }) : host.renderBlock(block) })
+    showRoutingNote && routingStatus === "unroutable" ? host.renderNotice?.(notice) ?? /* @__PURE__ */ jsx2("div", { className: "rounded-md border border-amber-500/30 bg-amber-500/5 px-3 py-2 text-xs text-amber-800 dark:text-amber-200", children: notice }) : null,
+    /* @__PURE__ */ jsx2("div", { className: frameClass, children: onTheFloor ? host.renderValue({ value, kind }) : host.renderBlock(block) })
   ] });
 }
+
+// react/ProvisionalKindBoundary.tsx
+import React from "react";
+import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
 var ProvisionalKindBoundaryInner = class extends React.Component {
   state = { failed: false };
   static getDerivedStateFromError() {
@@ -653,18 +703,27 @@ var ProvisionalKindBoundaryInner = class extends React.Component {
 };
 function ProvisionalKindBoundary(props) {
   const host = useContentIrHost();
-  return /* @__PURE__ */ jsx(ProvisionalKindBoundaryInner, { ...props, reportError: host.reportError });
+  return /* @__PURE__ */ jsx3(ProvisionalKindBoundaryInner, { ...props, reportError: host.reportError });
 }
 function ProvisionalKindFrame({ children }) {
   const host = useContentIrHost();
   const label = "Still arriving";
-  return /* @__PURE__ */ jsxs("div", { className: "relative", "aria-busy": "true", children: [
+  return /* @__PURE__ */ jsxs2("div", { className: "relative", "aria-busy": "true", children: [
     children,
-    /* @__PURE__ */ jsx("span", { className: "pointer-events-none absolute -top-2 right-4 z-10 select-none rounded-full bg-background px-1.5 leading-4", children: host.renderShimmer?.(label) ?? /* @__PURE__ */ jsx("span", { className: "text-[10px] text-muted-foreground", children: label }) })
+    /* @__PURE__ */ jsx3("span", { className: "pointer-events-none absolute -top-2 right-4 z-10 select-none rounded-full bg-background px-1.5 leading-4", children: host.renderShimmer?.(label) ?? /* @__PURE__ */ jsx3("span", { className: "text-[10px] text-muted-foreground", children: label }) })
   ] });
 }
+
+// react/GenericStructuredView.tsx
+import "react";
+import {
+  readEnvelope as readEnvelope3,
+  readObjectKind as readObjectKind2,
+  reconstructRegionValue
+} from "@ai-matrx/content-ir";
+import { jsx as jsx4, jsxs as jsxs3 } from "react/jsx-runtime";
 function readStructuredValue(content, metadata) {
-  const envelope = readEnvelope(metadata);
+  const envelope = readEnvelope3(metadata);
   if (envelope) {
     return { value: reconstructRegionValue(envelope), recovered: true };
   }
@@ -681,21 +740,25 @@ function GenericStructuredView({
   className
 }) {
   const host = useContentIrHost();
-  const envelope = readEnvelope(metadata);
+  const envelope = readEnvelope3(metadata);
   const status = envelope?.root.status ?? "complete";
   const { value, recovered } = readStructuredValue(content, metadata);
-  const kind = envelope?.root.kind ?? (typeof value === "object" && value !== null && !Array.isArray(value) ? readObjectKind(value) : null) ?? "";
+  const kind = envelope?.root.kind ?? (typeof value === "object" && value !== null && !Array.isArray(value) ? readObjectKind2(value) : null) ?? "";
   const marker = readIrRouteMarker(metadata);
   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,
+  return /* @__PURE__ */ jsxs3("div", { className: className ? `my-2 min-w-0 ${className}` : "my-2 min-w-0", children: [
+    status === "streaming" ? streamingIndicator ?? /* @__PURE__ */ jsx4("div", { className: "mb-2 text-xs text-muted-foreground", children: "Still arriving\u2026" }) : null,
     recovered ? host.renderValue({ value, ...kind ? { kind } : {}, note }) : (
       // Zero-data-loss backstop: the region never parsed, so show the source
       // verbatim rather than swallowing it.
-      /* @__PURE__ */ jsx("pre", { className: "max-h-96 overflow-auto font-mono text-xs leading-relaxed text-muted-foreground", children: content })
+      /* @__PURE__ */ jsx4("pre", { className: "max-h-96 overflow-auto font-mono text-xs leading-relaxed text-muted-foreground", children: content })
     )
   ] });
 }
+
+// react/RuntimeWrapperViews.tsx
+import { readNodeOutcomeValue, readObjectKind as readObjectKind3, readRunResultValue } from "@ai-matrx/content-ir";
+import { Fragment as Fragment2, jsx as jsx5 } from "react/jsx-runtime";
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -711,16 +774,16 @@ function DelegatedOutput({
 }) {
   const host = useContentIrHost();
   if (output === null || output === void 0) {
-    return /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: emptyLabel });
+    return /* @__PURE__ */ jsx5("p", { className: "text-xs text-muted-foreground", children: emptyLabel });
   }
   if (!isRecord2(output)) {
-    return /* @__PURE__ */ jsx(Fragment, { children: host.renderValue({ value: output }) });
+    return /* @__PURE__ */ jsx5(Fragment2, { children: host.renderValue({ value: output }) });
   }
-  const kind = readObjectKind(output) ?? declaredKind;
+  const kind = readObjectKind3(output) ?? declaredKind;
   if (!kind) {
-    return /* @__PURE__ */ jsx(Fragment, { children: fallback?.(output) ?? host.renderValue({ value: output }) });
+    return /* @__PURE__ */ jsx5(Fragment2, { children: fallback?.(output) ?? host.renderValue({ value: output }) });
   }
-  return /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx5(
     KindInstanceRender,
     {
       kind,
@@ -737,7 +800,7 @@ function NodeOutcomeView({ serverData, fallback }) {
     readNodeOutcomeValue
   );
   if (!wrapper) return null;
-  return /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx5(
     DelegatedOutput,
     {
       output: wrapper.output,
@@ -752,14 +815,14 @@ function RunResultView({ serverData, fallback }) {
     readRunResultValue
   );
   if (!wrapper) return null;
-  return /* @__PURE__ */ jsx("div", { className: "space-y-2", children: wrapper.outputs.length > 0 ? wrapper.outputs.map((outcome) => /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx5("div", { className: "space-y-2", children: wrapper.outputs.length > 0 ? wrapper.outputs.map((outcome) => /* @__PURE__ */ jsx5(
     NodeOutcomeView,
     {
       serverData: { wrapper: outcome },
       ...fallback === void 0 ? {} : { fallback }
     },
     `${outcome.node_id}:${outcome.attempt}`
-  )) : /* @__PURE__ */ jsx(
+  )) : /* @__PURE__ */ jsx5(
     DelegatedOutput,
     {
       output: wrapper.output,
@@ -769,6 +832,228 @@ function RunResultView({ serverData, fallback }) {
   ) });
 }
 
-export { ComponentResolver, ContentIrRenderProvider, DB_KIND_COMPONENT_KEY, DelegatedOutput, GENERIC_STRUCTURED_COMPONENT_KEY, GenericStructuredView, IR_PROVISIONAL_KEY, IR_ROUTE_KEY, KindInstanceRender, NodeOutcomeView, ProvisionalKindBoundary, ProvisionalKindFrame, RunResultView, applyIrKindRoute, consoleErrorReporter, envelopeFromPartialKind, isPartialReadyKind, isProvisionalBlock, isRecordValue, kindIsRoutable, kindServerDataFromStoredValue, markKindPartialUnsafe, readIrRouteMarker, resetPartialUnsafeKinds, resetSourcelessDbRowReports, resolveAnnouncedKindLoading, resolveProvisionalKindRender, routeEnvOf, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv };
-//# sourceMappingURL=index.js.map
+// db-component/db-kind-component-cache.ts
+function isDbKindComponentBodyPending(resolution) {
+  return resolution.hasComponentSource && resolution.componentSource === null;
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function createDbKindComponentCache(ports) {
+  const cache = /* @__PURE__ */ new Map();
+  const screamedKeys = /* @__PURE__ */ new Set();
+  const defaultPlatform = ports.platform ?? "web";
+  function cacheKey(kind, platform, role, updatedAt) {
+    return `${kind}${platform}${role}${updatedAt ?? ""}`;
+  }
+  function screamCompileFailure(key, kind, error, resolution, platform, role) {
+    const message = `[content-ir] DB kind component for "${kind}" failed to compile \u2014 rendering the generic structured viewer instead: ${error}`;
+    if (!screamedKeys.has(key)) {
+      screamedKeys.add(key);
+      console.error(message);
+    }
+    ports.reportError({ source: "content-ir", message, raw: { kind, error } });
+    ports.reportIncident?.({
+      kind,
+      errorType: "compile_error",
+      message,
+      platform,
+      role,
+      componentKey: resolution.componentKey,
+      componentUpdatedAt: resolution.updatedAt
+    });
+  }
+  function config(value, kind) {
+    if (isPlainObject(value)) return value;
+    if (value === null || value === void 0) return {};
+    const message = `[content-ir] kind_component.config for "${kind}" is not a JSON object (${typeof value}) \u2014 rendering with an empty config.`;
+    console.error(message);
+    ports.reportError({ source: "content-ir", message, raw: { kind } });
+    return {};
+  }
+  function resolveAllowedImports(rowConfig) {
+    const declared = rowConfig.allowed_imports;
+    if (Array.isArray(declared) && declared.every((entry) => typeof entry === "string")) {
+      return declared;
+    }
+    return ports.defaultAllowedImports();
+  }
+  function getOrCompile(kind, resolution, platform = defaultPlatform, role = "output") {
+    const key = cacheKey(kind, platform, role, resolution.updatedAt);
+    const cached = cache.get(key);
+    if (cached) return cached;
+    const source = resolution.componentSource;
+    if (!source || !source.trim()) {
+      const result2 = {
+        ok: false,
+        error: "db-source resolution has no component_source"
+      };
+      screamCompileFailure(key, kind, result2.error, resolution, platform, role);
+      cache.set(key, result2);
+      return result2;
+    }
+    const allowedImports = resolveAllowedImports(
+      config(resolution.config, kind)
+    );
+    const { Component: Component2, error } = ports.compile({ code: source, allowedImports });
+    if (!Component2 || error) {
+      const result2 = {
+        ok: false,
+        error: error ?? "compile produced no component"
+      };
+      screamCompileFailure(key, kind, result2.error, resolution, platform, role);
+      cache.set(key, result2);
+      return result2;
+    }
+    let transform = null;
+    if (resolution.propsTransform && resolution.propsTransform.trim()) {
+      const { Component: transformFn, error: transformError } = ports.compile({
+        code: resolution.propsTransform,
+        allowedImports: []
+      });
+      if (typeof transformFn === "function" && !transformError) {
+        transform = transformFn;
+      } else {
+        const message = `[content-ir] props_transform for kind "${kind}" failed to compile \u2014 value passes through untransformed: ${transformError ?? "no function produced"}`;
+        console.error(message);
+        ports.reportError({
+          source: "content-ir",
+          message,
+          raw: { kind, error: transformError }
+        });
+        ports.reportIncident?.({
+          kind,
+          errorType: "transform_error",
+          message,
+          platform,
+          role,
+          componentKey: resolution.componentKey,
+          componentUpdatedAt: resolution.updatedAt
+        });
+      }
+    }
+    const result = {
+      ok: true,
+      compiled: {
+        // The injected compiler types components as
+        // ComponentType<Record<string, unknown>>; the callsite always passes
+        // DbKindComponentRenderProps — the single deliberate narrowing where
+        // the generic compiler meets the kind contract.
+        Component: Component2,
+        transform
+      }
+    };
+    cache.set(key, result);
+    return result;
+  }
+  function applyPropsTransform(kind, compiled, value) {
+    if (!compiled.transform) return value;
+    try {
+      return compiled.transform(value);
+    } catch (error) {
+      const message = `[content-ir] props_transform for kind "${kind}" threw \u2014 using the untransformed value: ${error instanceof Error ? error.message : String(error)}`;
+      console.error(message);
+      ports.reportError({ source: "content-ir", message, raw: { kind } });
+      ports.reportIncident?.({
+        kind,
+        errorType: "transform_error",
+        message,
+        stack: error instanceof Error ? error.stack ?? null : null,
+        data: value
+      });
+      return value;
+    }
+  }
+  function invalidate(kind, platform = defaultPlatform, role = "output") {
+    const prefix = `${kind}${platform}${role}`;
+    for (const key of [...cache.keys()]) {
+      if (key.startsWith(prefix)) cache.delete(key);
+    }
+    for (const key of [...screamedKeys]) {
+      if (key.startsWith(prefix)) screamedKeys.delete(key);
+    }
+  }
+  function invalidateAll() {
+    cache.clear();
+    screamedKeys.clear();
+  }
+  const api = {
+    getOrCompile,
+    applyPropsTransform,
+    config,
+    invalidate,
+    invalidateAll
+  };
+  ports.registerInvalidation?.(() => invalidateAll());
+  return api;
+}
+
+// db-component/DbKindComponentErrorBoundary.tsx
+import * as React2 from "react";
+var DbKindComponentErrorBoundary = class extends React2.Component {
+  constructor(props) {
+    super(props);
+    this.state = { hasError: false, signalAtLastRender: props.resetSignal };
+  }
+  static getDerivedStateFromError() {
+    return { hasError: true };
+  }
+  static getDerivedStateFromProps(props, state) {
+    if (props.resetSignal === state.signalAtLastRender) return null;
+    return { hasError: false, signalAtLastRender: props.resetSignal };
+  }
+  componentDidCatch(error, errorInfo) {
+    const info = { componentStack: errorInfo.componentStack ?? null };
+    if (this.props.onCaught) {
+      this.props.onCaught(error, info);
+      return;
+    }
+    console.error(
+      `[content-ir] DB kind component for "${this.props.kind}" threw during render \u2014 showing the fallback:`,
+      error
+    );
+  }
+  render() {
+    if (this.state.hasError) return this.props.fallback;
+    return this.props.children;
+  }
+};
+export {
+  ComponentResolver,
+  ContentIrRenderProvider,
+  DB_KIND_COMPONENT_KEY,
+  DbKindComponentErrorBoundary,
+  DelegatedOutput,
+  GENERIC_STRUCTURED_COMPONENT_KEY,
+  GenericStructuredView,
+  IR_PROVISIONAL_KEY,
+  IR_ROUTE_KEY,
+  KindInstanceRender,
+  NodeOutcomeView,
+  ProvisionalKindBoundary,
+  ProvisionalKindFrame,
+  RunResultView,
+  applyIrKindRoute,
+  consoleErrorReporter,
+  createDbKindComponentCache,
+  createKindRouteBinding,
+  envelopeFromPartialKind,
+  isDbKindComponentBodyPending,
+  isPartialReadyKind,
+  isProvisionalBlock,
+  isRecordValue,
+  kindIsRoutable,
+  kindServerDataFromStoredValue,
+  markKindPartialUnsafe,
+  readIrRouteMarker,
+  resetPartialUnsafeKinds,
+  resetSourcelessDbRowReports,
+  resolveAnnouncedKindLoading,
+  resolveProvisionalKindRender,
+  routeEnvOf,
+  useContentIrHost,
+  useContentIrHostOrNull,
+  useContentIrKindVersion,
+  useKindRouteEnv
+};
 //# sourceMappingURL=index.js.map