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

package/dist/host-types-DvGv8s9L.d.cts

@@ -0,0 +1,131 @@
+import { ReactNode } from 'react';
+import { KindDefinition } from '@ai-matrx/content-ir';
+import { d as ComponentResolutionSource, a as ContentIrErrorReporter } from './component-resolution.types-BS1ySIg-.cjs';
+
+/**
+ * THE HOST CONTRACT — everything this package refuses to decide.
+ *
+ * The kernel (`@ai-matrx/content-ir`) proved the shape: extract the portable
+ * part, let host capability enter through explicit named seams. The render
+ * layer needs four things it must never own:
+ *
+ *  1. WHERE KIND DEFINITIONS COME FROM (a bundled table, `content_ir`, a REST
+ *     call). The route only asks "is this kind registered, and does it carry a
+ *     legacy bridge / a partial-ready opt-in".
+ *  2. WHERE COMPONENT ROWS COME FROM — {@link ComponentResolutionSource}. The
+ *     package ships `ComponentResolver`, which any host can construct with its
+ *     own loaders; a host with its own resolver only has to satisfy the type.
+ *  3. HOW A ROUTED BLOCK ACTUALLY DRAWS. `applyIrKindRoute` decides a block's
+ *     TYPE; turning that type into pixels is the host's dispatch table
+ *     (matrx-frontend's `BlockRenderer`, the dashboard's small map). The
+ *     package never imports a component library.
+ *  4. WHERE SCREAMS LAND — {@link ContentIrErrorReporter}.
+ *
+ * No Next.js, no Redux, no Supabase, no router, no host error capture. If a
+ * seam is missing, ADD A SEAM — never an import.
+ */
+
+/**
+ * The minimum a render block must expose for the kind route to work. Hosts
+ * pass their own richer block type through; the route is generic over `T` and
+ * preserves every extra field.
+ */
+interface IrRoutableBlock {
+    type: string;
+    serverData?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+/** A routable block that also carries its source text (the raw region). */
+interface IrRenderBlock extends IrRoutableBlock {
+    content: string;
+    language?: string;
+}
+/**
+ * Where registered kinds come from. `getDefinition` is the only method the
+ * pure route needs; the rest drive the granular repaint and the warm-up tick
+ * that keeps a cold registry from being mistaken for "this kind has no
+ * component".
+ */
+interface KindDefinitionSource {
+    getDefinition(kind: string): KindDefinition | undefined;
+    /** Monotonic per-kind version — the repaint snapshot key. */
+    getKindVersion(kind: string): number;
+    subscribeKind(kind: string, listener: () => void): () => void;
+    /** One definition load per app session. */
+    ensureWarm(): Promise<void>;
+}
+/**
+ * The rendering seams. Everything here returns host UI; the package supplies
+ * the DECISIONS and the chrome-free structure around them.
+ */
+interface ContentIrRenderSeams {
+    /**
+     * Draw a block the kind route has already typed. This is the host's dispatch
+     * table — the single place a component key becomes a component.
+     */
+    renderBlock(block: IrRenderBlock): ReactNode;
+    /**
+     * THE FLOOR: render ANY JSON value as a human document. Reached when a kind
+     * has no render-trusted component, when the value is not an object at all,
+     * and by the generic structured view.
+     *
+     * This is deliberately a seam and not a bundled component. Rendering a value
+     * WELL means prose through the host's markdown renderer, media through the
+     * host's file handler, and uniform arrays through the host's data table —
+     * all of which are host property. A host that has none of those can pass a
+     * `<pre>`; it will be honest, just plain.
+     */
+    renderValue(props: StructuredValueRenderProps): ReactNode;
+    /**
+     * The "still arriving" indicator used by the provisional frame. Optional —
+     * hosts without a shimmer get plain text.
+     */
+    renderShimmer?(text: string): ReactNode;
+    /**
+     * The honest "this shape has no custom component yet" notice. Optional: the
+     * package draws a plain amber line when a host supplies nothing, and a host
+     * with an icon set or its own callout component supplies that instead. It is
+     * a seam and not a bundled component because this package depends on no icon
+     * library.
+     */
+    renderNotice?(text: string): ReactNode;
+}
+interface StructuredValueRenderProps {
+    value: unknown;
+    /** The kind slug this value claims, when known. Honesty line only — never a renderer choice. */
+    kind?: string;
+    /** Why this shape has no custom view, in human words. */
+    note?: string;
+    /** Show the "what this is / raw data" footer. Default true. */
+    footer?: boolean;
+}
+/**
+ * One host, wired once, read by every component in this package through
+ * {@link ContentIrRenderProvider}.
+ */
+interface ContentIrHost extends ContentIrRenderSeams {
+    kinds: KindDefinitionSource;
+    components: ComponentResolutionSource;
+    reportError: ContentIrErrorReporter;
+    /**
+     * The `kind_component.platform` this host resolves as. "web" for every
+     * browser UI; the column already models "react-native" and friends, and a
+     * host that lies here renders the wrong component everywhere.
+     */
+    platform: string;
+}
+/**
+ * The pure route's dependencies — a strict subset of {@link ContentIrHost},
+ * because `applyIrKindRoute` is called OUTSIDE React (reducers, stream
+ * accumulators, tests) where there is no provider to read.
+ */
+interface KindRouteEnv {
+    kinds: Pick<KindDefinitionSource, "getDefinition">;
+    components: Pick<ComponentResolutionSource, "resolve">;
+    reportError: ContentIrErrorReporter;
+    platform: string;
+}
+/** Narrow a host (or anything host-shaped) to what the pure route needs. */
+declare function routeEnvOf(host: ContentIrHost): KindRouteEnv;
+
+export { type ContentIrHost as C, type IrRenderBlock as I, type KindRouteEnv as K, type StructuredValueRenderProps as S, type ContentIrRenderSeams as a, type IrRoutableBlock as b, type KindDefinitionSource as c, routeEnvOf as r };

package/dist/host.cjs

@@ -0,0 +1,74 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// host.ts
+var host_exports = {};
+__export(host_exports, {
+  ContentIrRenderProvider: () => ContentIrRenderProvider,
+  consoleErrorReporter: () => consoleErrorReporter,
+  routeEnvOf: () => routeEnvOf,
+  useContentIrHost: () => useContentIrHost,
+  useContentIrHostOrNull: () => useContentIrHostOrNull,
+  useKindRouteEnv: () => useKindRouteEnv
+});
+module.exports = __toCommonJS(host_exports);
+
+// host/error-report.ts
+var consoleErrorReporter = (report) => {
+  console.error(`[content-ir] ${report.message}`, report.raw ?? "");
+};
+
+// host/host-types.ts
+function routeEnvOf(host) {
+  return {
+    kinds: host.kinds,
+    components: host.components,
+    reportError: host.reportError,
+    platform: host.platform
+  };
+}
+
+// host/ContentIrProvider.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var ContentIrHostContext = (0, import_react.createContext)(null);
+function ContentIrRenderProvider({
+  host,
+  children
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ContentIrHostContext.Provider, { value: host, children });
+}
+function useContentIrHostOrNull() {
+  return (0, import_react.useContext)(ContentIrHostContext);
+}
+function useContentIrHost() {
+  const host = useContentIrHostOrNull();
+  if (!host) {
+    throw new Error(
+      "[content-ir-react] No ContentIrRenderProvider above this component. Mount one at the app root with your host adapter (kind definitions, component resolver, renderBlock, renderValue, reportError)."
+    );
+  }
+  return host;
+}
+function useKindRouteEnv() {
+  const host = useContentIrHost();
+  return (0, import_react.useMemo)(() => routeEnvOf(host), [host]);
+}
+//# sourceMappingURL=host.cjs.map

package/dist/host.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../host.ts","../host/error-report.ts","../host/host-types.ts","../host/ContentIrProvider.tsx"],"sourcesContent":["/**\n * `@ai-matrx/content-ir-react/host` — the contract every consumer wires once:\n * the scream seam, the host/seam types, and the React provider.\n *\n * NOTE: this entry is stamped \"use client\" (it carries the provider). The\n * TYPES here are importable from anywhere; a server-side module that needs\n * only pure route logic imports `/route` instead.\n */\nexport * from \"./host/error-report\";\nexport * from \"./host/host-types\";\nexport * from \"./host/ContentIrProvider\";\n","/**\n * THE SCREAM SEAM.\n *\n * Every recovery path in this package is loud: a defective component row, a\n * failed resolver load, a kind whose component throws on a provisional value.\n * The package refuses to own where those screams land — matrx-frontend routes\n * them to the Error Inspector, the dashboard to its own log, the extension to\n * its background page. Each host binds one function.\n *\n * A host that binds a no-op has chosen silence, which is a defect in itself;\n * {@link consoleErrorReporter} is the honest default.\n */\n\nexport interface ContentIrErrorReport {\n  /** Always `\"content-ir\"` — hosts key their capture stores on it. */\n  source: \"content-ir\";\n  message: string;\n  name?: string;\n  stack?: string;\n  /** Free-form grouping key (the host's `relation`), e.g. `\"partial-kind\"`. */\n  relation?: string;\n  raw?: unknown;\n}\n\nexport type ContentIrErrorReporter = (report: ContentIrErrorReport) => void;\n\n/** The default when a host binds nothing: never silent. */\nexport const consoleErrorReporter: ContentIrErrorReporter = (report) => {\n  console.error(`[content-ir] ${report.message}`, report.raw ?? \"\");\n};\n","/**\n * THE HOST CONTRACT — everything this package refuses to decide.\n *\n * The kernel (`@ai-matrx/content-ir`) proved the shape: extract the portable\n * part, let host capability enter through explicit named seams. The render\n * layer needs four things it must never own:\n *\n *  1. WHERE KIND DEFINITIONS COME FROM (a bundled table, `content_ir`, a REST\n *     call). The route only asks \"is this kind registered, and does it carry a\n *     legacy bridge / a partial-ready opt-in\".\n *  2. WHERE COMPONENT ROWS COME FROM — {@link ComponentResolutionSource}. The\n *     package ships `ComponentResolver`, which any host can construct with its\n *     own loaders; a host with its own resolver only has to satisfy the type.\n *  3. HOW A ROUTED BLOCK ACTUALLY DRAWS. `applyIrKindRoute` decides a block's\n *     TYPE; turning that type into pixels is the host's dispatch table\n *     (matrx-frontend's `BlockRenderer`, the dashboard's small map). The\n *     package never imports a component library.\n *  4. WHERE SCREAMS LAND — {@link ContentIrErrorReporter}.\n *\n * No Next.js, no Redux, no Supabase, no router, no host error capture. If a\n * seam is missing, ADD A SEAM — never an import.\n */\n\nimport type { ReactNode } from \"react\";\nimport type { KindDefinition } from \"@ai-matrx/content-ir\";\nimport type { ContentIrErrorReporter } from \"./error-report\";\nimport type { ComponentResolutionSource } from \"../resolver/component-resolution.types\";\n\n/**\n * The minimum a render block must expose for the kind route to work. Hosts\n * pass their own richer block type through; the route is generic over `T` and\n * preserves every extra field.\n */\nexport interface IrRoutableBlock {\n  type: string;\n  serverData?: Record<string, unknown>;\n  metadata?: Record<string, unknown>;\n}\n\n/** A routable block that also carries its source text (the raw region). */\nexport interface IrRenderBlock extends IrRoutableBlock {\n  content: string;\n  language?: string;\n}\n\n/**\n * Where registered kinds come from. `getDefinition` is the only method the\n * pure route needs; the rest drive the granular repaint and the warm-up tick\n * that keeps a cold registry from being mistaken for \"this kind has no\n * component\".\n */\nexport interface KindDefinitionSource {\n  getDefinition(kind: string): KindDefinition | undefined;\n  /** Monotonic per-kind version — the repaint snapshot key. */\n  getKindVersion(kind: string): number;\n  subscribeKind(kind: string, listener: () => void): () => void;\n  /** One definition load per app session. */\n  ensureWarm(): Promise<void>;\n}\n\n/**\n * The rendering seams. Everything here returns host UI; the package supplies\n * the DECISIONS and the chrome-free structure around them.\n */\nexport interface ContentIrRenderSeams {\n  /**\n   * Draw a block the kind route has already typed. This is the host's dispatch\n   * table — the single place a component key becomes a component.\n   */\n  renderBlock(block: IrRenderBlock): ReactNode;\n  /**\n   * THE FLOOR: render ANY JSON value as a human document. Reached when a kind\n   * has no render-trusted component, when the value is not an object at all,\n   * and by the generic structured view.\n   *\n   * This is deliberately a seam and not a bundled component. Rendering a value\n   * WELL means prose through the host's markdown renderer, media through the\n   * host's file handler, and uniform arrays through the host's data table —\n   * all of which are host property. A host that has none of those can pass a\n   * `<pre>`; it will be honest, just plain.\n   */\n  renderValue(props: StructuredValueRenderProps): ReactNode;\n  /**\n   * The \"still arriving\" indicator used by the provisional frame. Optional —\n   * hosts without a shimmer get plain text.\n   */\n  renderShimmer?(text: string): ReactNode;\n  /**\n   * The honest \"this shape has no custom component yet\" notice. Optional: the\n   * package draws a plain amber line when a host supplies nothing, and a host\n   * with an icon set or its own callout component supplies that instead. It is\n   * a seam and not a bundled component because this package depends on no icon\n   * library.\n   */\n  renderNotice?(text: string): ReactNode;\n}\n\nexport interface StructuredValueRenderProps {\n  value: unknown;\n  /** The kind slug this value claims, when known. Honesty line only — never a renderer choice. */\n  kind?: string;\n  /** Why this shape has no custom view, in human words. */\n  note?: string;\n  /** Show the \"what this is / raw data\" footer. Default true. */\n  footer?: boolean;\n}\n\n/**\n * One host, wired once, read by every component in this package through\n * {@link ContentIrRenderProvider}.\n */\nexport interface ContentIrHost extends ContentIrRenderSeams {\n  kinds: KindDefinitionSource;\n  components: ComponentResolutionSource;\n  reportError: ContentIrErrorReporter;\n  /**\n   * The `kind_component.platform` this host resolves as. \"web\" for every\n   * browser UI; the column already models \"react-native\" and friends, and a\n   * host that lies here renders the wrong component everywhere.\n   */\n  platform: string;\n}\n\n/**\n * The pure route's dependencies — a strict subset of {@link ContentIrHost},\n * because `applyIrKindRoute` is called OUTSIDE React (reducers, stream\n * accumulators, tests) where there is no provider to read.\n */\nexport interface KindRouteEnv {\n  kinds: Pick<KindDefinitionSource, \"getDefinition\">;\n  components: Pick<ComponentResolutionSource, \"resolve\">;\n  reportError: ContentIrErrorReporter;\n  platform: string;\n}\n\n/** Narrow a host (or anything host-shaped) to what the pure route needs. */\nexport function routeEnvOf(host: ContentIrHost): KindRouteEnv {\n  return {\n    kinds: host.kinds,\n    components: host.components,\n    reportError: host.reportError,\n    platform: host.platform,\n  };\n}\n","\"use client\";\n\n/**\n * The one place a host is wired in. Everything React in this package reads its\n * capability from here — no module singleton, no import into an app.\n *\n * A host mounts this ONCE, high enough that every kind-rendering surface is\n * inside it:\n *\n * ```tsx\n * <ContentIrRenderProvider host={matrxContentIrHost}>\n *   <App />\n * </ContentIrRenderProvider>\n * ```\n *\n * Reading it outside a provider THROWS rather than falling back to a default.\n * A silent default would render the wrong component for every kind in the app\n * and look like a data problem for weeks.\n */\n\nimport { createContext, useContext, useMemo, type ReactNode } from \"react\";\nimport type { ContentIrHost, KindRouteEnv } from \"./host-types\";\nimport { routeEnvOf } from \"./host-types\";\n\nconst ContentIrHostContext = createContext<ContentIrHost | null>(null);\n\nexport interface ContentIrRenderProviderProps {\n  host: ContentIrHost;\n  children: ReactNode;\n}\n\nexport function ContentIrRenderProvider({\n  host,\n  children,\n}: ContentIrRenderProviderProps) {\n  return (\n    <ContentIrHostContext.Provider value={host}>\n      {children}\n    </ContentIrHostContext.Provider>\n  );\n}\n\n/**\n * The wired host, or null. For the rare consumer that can legitimately run\n * without a provider because it was handed its sources explicitly (see\n * `useContentIrKindVersion`). Everything else uses {@link useContentIrHost}.\n */\nexport function useContentIrHostOrNull(): ContentIrHost | null {\n  return useContext(ContentIrHostContext);\n}\n\n/** The wired host. Throws outside a provider — see the module doc. */\nexport function useContentIrHost(): ContentIrHost {\n  const host = useContentIrHostOrNull();\n  if (!host) {\n    throw new Error(\n      \"[content-ir-react] No ContentIrRenderProvider above this component. \" +\n        \"Mount one at the app root with your host adapter (kind definitions, \" +\n        \"component resolver, renderBlock, renderValue, reportError).\",\n    );\n  }\n  return host;\n}\n\n/** The wired host narrowed to what the pure route functions take. */\nexport function useKindRouteEnv(): KindRouteEnv {\n  const host = useContentIrHost();\n  return useMemo(() => routeEnvOf(host), [host]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC2BO,IAAM,uBAA+C,CAAC,WAAW;AACtE,UAAQ,MAAM,gBAAgB,OAAO,OAAO,IAAI,OAAO,OAAO,EAAE;AAClE;;;AC2GO,SAAS,WAAW,MAAmC;AAC5D,SAAO;AAAA,IACL,OAAO,KAAK;AAAA,IACZ,YAAY,KAAK;AAAA,IACjB,aAAa,KAAK;AAAA,IAClB,UAAU,KAAK;AAAA,EACjB;AACF;;;AC3HA,mBAAmE;AAgB/D;AAZJ,IAAM,2BAAuB,4BAAoC,IAAI;AAO9D,SAAS,wBAAwB;AAAA,EACtC;AAAA,EACA;AACF,GAAiC;AAC/B,SACE,4CAAC,qBAAqB,UAArB,EAA8B,OAAO,MACnC,UACH;AAEJ;AAOO,SAAS,yBAA+C;AAC7D,aAAO,yBAAW,oBAAoB;AACxC;AAGO,SAAS,mBAAkC;AAChD,QAAM,OAAO,uBAAuB;AACpC,MAAI,CAAC,MAAM;AACT,UAAM,IAAI;AAAA,MACR;AAAA,IAGF;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,kBAAgC;AAC9C,QAAM,OAAO,iBAAiB;AAC9B,aAAO,sBAAQ,MAAM,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC;AAC/C;","names":[]}

package/dist/host.d.cts

@@ -0,0 +1,24 @@
+export { b as ContentIrErrorReport, a as ContentIrErrorReporter, c as consoleErrorReporter } from './component-resolution.types-BS1ySIg-.cjs';
+import { C as ContentIrHost, K as KindRouteEnv } from './host-types-DvGv8s9L.cjs';
+export { a as ContentIrRenderSeams, I as IrRenderBlock, b as IrRoutableBlock, c as KindDefinitionSource, S as StructuredValueRenderProps, r as routeEnvOf } from './host-types-DvGv8s9L.cjs';
+import * as React from 'react';
+import { ReactNode } from 'react';
+import '@ai-matrx/content-ir';
+
+interface ContentIrRenderProviderProps {
+    host: ContentIrHost;
+    children: ReactNode;
+}
+declare function ContentIrRenderProvider({ host, children, }: ContentIrRenderProviderProps): React.JSX.Element;
+/**
+ * The wired host, or null. For the rare consumer that can legitimately run
+ * without a provider because it was handed its sources explicitly (see
+ * `useContentIrKindVersion`). Everything else uses {@link useContentIrHost}.
+ */
+declare function useContentIrHostOrNull(): ContentIrHost | null;
+/** The wired host. Throws outside a provider — see the module doc. */
+declare function useContentIrHost(): ContentIrHost;
+/** The wired host narrowed to what the pure route functions take. */
+declare function useKindRouteEnv(): KindRouteEnv;
+
+export { ContentIrHost, ContentIrRenderProvider, type ContentIrRenderProviderProps, KindRouteEnv, useContentIrHost, useContentIrHostOrNull, useKindRouteEnv };

package/dist/host.d.ts

@@ -0,0 +1,24 @@
+export { b as ContentIrErrorReport, a as ContentIrErrorReporter, c as consoleErrorReporter } from './component-resolution.types-BS1ySIg-.js';
+import { C as ContentIrHost, K as KindRouteEnv } from './host-types-CZ_Bkp4R.js';
+export { a as ContentIrRenderSeams, I as IrRenderBlock, b as IrRoutableBlock, c as KindDefinitionSource, S as StructuredValueRenderProps, r as routeEnvOf } from './host-types-CZ_Bkp4R.js';
+import * as React from 'react';
+import { ReactNode } from 'react';
+import '@ai-matrx/content-ir';
+
+interface ContentIrRenderProviderProps {
+    host: ContentIrHost;
+    children: ReactNode;
+}
+declare function ContentIrRenderProvider({ host, children, }: ContentIrRenderProviderProps): React.JSX.Element;
+/**
+ * The wired host, or null. For the rare consumer that can legitimately run
+ * without a provider because it was handed its sources explicitly (see
+ * `useContentIrKindVersion`). Everything else uses {@link useContentIrHost}.
+ */
+declare function useContentIrHostOrNull(): ContentIrHost | null;
+/** The wired host. Throws outside a provider — see the module doc. */
+declare function useContentIrHost(): ContentIrHost;
+/** The wired host narrowed to what the pure route functions take. */
+declare function useKindRouteEnv(): KindRouteEnv;
+
+export { ContentIrHost, ContentIrRenderProvider, type ContentIrRenderProviderProps, KindRouteEnv, useContentIrHost, useContentIrHostOrNull, useKindRouteEnv };

package/dist/host.js

@@ -0,0 +1,52 @@
+"use client";
+
+// host/error-report.ts
+var consoleErrorReporter = (report) => {
+  console.error(`[content-ir] ${report.message}`, report.raw ?? "");
+};
+
+// host/host-types.ts
+function routeEnvOf(host) {
+  return {
+    kinds: host.kinds,
+    components: host.components,
+    reportError: host.reportError,
+    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,
+  children
+}) {
+  return /* @__PURE__ */ jsx(ContentIrHostContext.Provider, { value: host, children });
+}
+function useContentIrHostOrNull() {
+  return useContext(ContentIrHostContext);
+}
+function useContentIrHost() {
+  const host = useContentIrHostOrNull();
+  if (!host) {
+    throw new Error(
+      "[content-ir-react] No ContentIrRenderProvider above this component. Mount one at the app root with your host adapter (kind definitions, component resolver, renderBlock, renderValue, reportError)."
+    );
+  }
+  return host;
+}
+function useKindRouteEnv() {
+  const host = useContentIrHost();
+  return useMemo(() => routeEnvOf(host), [host]);
+}
+export {
+  ContentIrRenderProvider,
+  consoleErrorReporter,
+  routeEnvOf,
+  useContentIrHost,
+  useContentIrHostOrNull,
+  useKindRouteEnv
+};
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../host/error-report.ts","../host/host-types.ts","../host/ContentIrProvider.tsx"],"sourcesContent":["/**\n * THE SCREAM SEAM.\n *\n * Every recovery path in this package is loud: a defective component row, a\n * failed resolver load, a kind whose component throws on a provisional value.\n * The package refuses to own where those screams land — matrx-frontend routes\n * them to the Error Inspector, the dashboard to its own log, the extension to\n * its background page. Each host binds one function.\n *\n * A host that binds a no-op has chosen silence, which is a defect in itself;\n * {@link consoleErrorReporter} is the honest default.\n */\n\nexport interface ContentIrErrorReport {\n  /** Always `\"content-ir\"` — hosts key their capture stores on it. */\n  source: \"content-ir\";\n  message: string;\n  name?: string;\n  stack?: string;\n  /** Free-form grouping key (the host's `relation`), e.g. `\"partial-kind\"`. */\n  relation?: string;\n  raw?: unknown;\n}\n\nexport type ContentIrErrorReporter = (report: ContentIrErrorReport) => void;\n\n/** The default when a host binds nothing: never silent. */\nexport const consoleErrorReporter: ContentIrErrorReporter = (report) => {\n  console.error(`[content-ir] ${report.message}`, report.raw ?? \"\");\n};\n","/**\n * THE HOST CONTRACT — everything this package refuses to decide.\n *\n * The kernel (`@ai-matrx/content-ir`) proved the shape: extract the portable\n * part, let host capability enter through explicit named seams. The render\n * layer needs four things it must never own:\n *\n *  1. WHERE KIND DEFINITIONS COME FROM (a bundled table, `content_ir`, a REST\n *     call). The route only asks \"is this kind registered, and does it carry a\n *     legacy bridge / a partial-ready opt-in\".\n *  2. WHERE COMPONENT ROWS COME FROM — {@link ComponentResolutionSource}. The\n *     package ships `ComponentResolver`, which any host can construct with its\n *     own loaders; a host with its own resolver only has to satisfy the type.\n *  3. HOW A ROUTED BLOCK ACTUALLY DRAWS. `applyIrKindRoute` decides a block's\n *     TYPE; turning that type into pixels is the host's dispatch table\n *     (matrx-frontend's `BlockRenderer`, the dashboard's small map). The\n *     package never imports a component library.\n *  4. WHERE SCREAMS LAND — {@link ContentIrErrorReporter}.\n *\n * No Next.js, no Redux, no Supabase, no router, no host error capture. If a\n * seam is missing, ADD A SEAM — never an import.\n */\n\nimport type { ReactNode } from \"react\";\nimport type { KindDefinition } from \"@ai-matrx/content-ir\";\nimport type { ContentIrErrorReporter } from \"./error-report\";\nimport type { ComponentResolutionSource } from \"../resolver/component-resolution.types\";\n\n/**\n * The minimum a render block must expose for the kind route to work. Hosts\n * pass their own richer block type through; the route is generic over `T` and\n * preserves every extra field.\n */\nexport interface IrRoutableBlock {\n  type: string;\n  serverData?: Record<string, unknown>;\n  metadata?: Record<string, unknown>;\n}\n\n/** A routable block that also carries its source text (the raw region). */\nexport interface IrRenderBlock extends IrRoutableBlock {\n  content: string;\n  language?: string;\n}\n\n/**\n * Where registered kinds come from. `getDefinition` is the only method the\n * pure route needs; the rest drive the granular repaint and the warm-up tick\n * that keeps a cold registry from being mistaken for \"this kind has no\n * component\".\n */\nexport interface KindDefinitionSource {\n  getDefinition(kind: string): KindDefinition | undefined;\n  /** Monotonic per-kind version — the repaint snapshot key. */\n  getKindVersion(kind: string): number;\n  subscribeKind(kind: string, listener: () => void): () => void;\n  /** One definition load per app session. */\n  ensureWarm(): Promise<void>;\n}\n\n/**\n * The rendering seams. Everything here returns host UI; the package supplies\n * the DECISIONS and the chrome-free structure around them.\n */\nexport interface ContentIrRenderSeams {\n  /**\n   * Draw a block the kind route has already typed. This is the host's dispatch\n   * table — the single place a component key becomes a component.\n   */\n  renderBlock(block: IrRenderBlock): ReactNode;\n  /**\n   * THE FLOOR: render ANY JSON value as a human document. Reached when a kind\n   * has no render-trusted component, when the value is not an object at all,\n   * and by the generic structured view.\n   *\n   * This is deliberately a seam and not a bundled component. Rendering a value\n   * WELL means prose through the host's markdown renderer, media through the\n   * host's file handler, and uniform arrays through the host's data table —\n   * all of which are host property. A host that has none of those can pass a\n   * `<pre>`; it will be honest, just plain.\n   */\n  renderValue(props: StructuredValueRenderProps): ReactNode;\n  /**\n   * The \"still arriving\" indicator used by the provisional frame. Optional —\n   * hosts without a shimmer get plain text.\n   */\n  renderShimmer?(text: string): ReactNode;\n  /**\n   * The honest \"this shape has no custom component yet\" notice. Optional: the\n   * package draws a plain amber line when a host supplies nothing, and a host\n   * with an icon set or its own callout component supplies that instead. It is\n   * a seam and not a bundled component because this package depends on no icon\n   * library.\n   */\n  renderNotice?(text: string): ReactNode;\n}\n\nexport interface StructuredValueRenderProps {\n  value: unknown;\n  /** The kind slug this value claims, when known. Honesty line only — never a renderer choice. */\n  kind?: string;\n  /** Why this shape has no custom view, in human words. */\n  note?: string;\n  /** Show the \"what this is / raw data\" footer. Default true. */\n  footer?: boolean;\n}\n\n/**\n * One host, wired once, read by every component in this package through\n * {@link ContentIrRenderProvider}.\n */\nexport interface ContentIrHost extends ContentIrRenderSeams {\n  kinds: KindDefinitionSource;\n  components: ComponentResolutionSource;\n  reportError: ContentIrErrorReporter;\n  /**\n   * The `kind_component.platform` this host resolves as. \"web\" for every\n   * browser UI; the column already models \"react-native\" and friends, and a\n   * host that lies here renders the wrong component everywhere.\n   */\n  platform: string;\n}\n\n/**\n * The pure route's dependencies — a strict subset of {@link ContentIrHost},\n * because `applyIrKindRoute` is called OUTSIDE React (reducers, stream\n * accumulators, tests) where there is no provider to read.\n */\nexport interface KindRouteEnv {\n  kinds: Pick<KindDefinitionSource, \"getDefinition\">;\n  components: Pick<ComponentResolutionSource, \"resolve\">;\n  reportError: ContentIrErrorReporter;\n  platform: string;\n}\n\n/** Narrow a host (or anything host-shaped) to what the pure route needs. */\nexport function routeEnvOf(host: ContentIrHost): KindRouteEnv {\n  return {\n    kinds: host.kinds,\n    components: host.components,\n    reportError: host.reportError,\n    platform: host.platform,\n  };\n}\n","\"use client\";\n\n/**\n * The one place a host is wired in. Everything React in this package reads its\n * capability from here — no module singleton, no import into an app.\n *\n * A host mounts this ONCE, high enough that every kind-rendering surface is\n * inside it:\n *\n * ```tsx\n * <ContentIrRenderProvider host={matrxContentIrHost}>\n *   <App />\n * </ContentIrRenderProvider>\n * ```\n *\n * Reading it outside a provider THROWS rather than falling back to a default.\n * A silent default would render the wrong component for every kind in the app\n * and look like a data problem for weeks.\n */\n\nimport { createContext, useContext, useMemo, type ReactNode } from \"react\";\nimport type { ContentIrHost, KindRouteEnv } from \"./host-types\";\nimport { routeEnvOf } from \"./host-types\";\n\nconst ContentIrHostContext = createContext<ContentIrHost | null>(null);\n\nexport interface ContentIrRenderProviderProps {\n  host: ContentIrHost;\n  children: ReactNode;\n}\n\nexport function ContentIrRenderProvider({\n  host,\n  children,\n}: ContentIrRenderProviderProps) {\n  return (\n    <ContentIrHostContext.Provider value={host}>\n      {children}\n    </ContentIrHostContext.Provider>\n  );\n}\n\n/**\n * The wired host, or null. For the rare consumer that can legitimately run\n * without a provider because it was handed its sources explicitly (see\n * `useContentIrKindVersion`). Everything else uses {@link useContentIrHost}.\n */\nexport function useContentIrHostOrNull(): ContentIrHost | null {\n  return useContext(ContentIrHostContext);\n}\n\n/** The wired host. Throws outside a provider — see the module doc. */\nexport function useContentIrHost(): ContentIrHost {\n  const host = useContentIrHostOrNull();\n  if (!host) {\n    throw new Error(\n      \"[content-ir-react] No ContentIrRenderProvider above this component. \" +\n        \"Mount one at the app root with your host adapter (kind definitions, \" +\n        \"component resolver, renderBlock, renderValue, reportError).\",\n    );\n  }\n  return host;\n}\n\n/** The wired host narrowed to what the pure route functions take. */\nexport function useKindRouteEnv(): KindRouteEnv {\n  const host = useContentIrHost();\n  return useMemo(() => routeEnvOf(host), [host]);\n}\n"],"mappings":";;;AA2BO,IAAM,uBAA+C,CAAC,WAAW;AACtE,UAAQ,MAAM,gBAAgB,OAAO,OAAO,IAAI,OAAO,OAAO,EAAE;AAClE;;;AC2GO,SAAS,WAAW,MAAmC;AAC5D,SAAO;AAAA,IACL,OAAO,KAAK;AAAA,IACZ,YAAY,KAAK;AAAA,IACjB,aAAa,KAAK;AAAA,IAClB,UAAU,KAAK;AAAA,EACjB;AACF;;;AC3HA,SAAS,eAAe,YAAY,eAA+B;AAgB/D;AAZJ,IAAM,uBAAuB,cAAoC,IAAI;AAO9D,SAAS,wBAAwB;AAAA,EACtC;AAAA,EACA;AACF,GAAiC;AAC/B,SACE,oBAAC,qBAAqB,UAArB,EAA8B,OAAO,MACnC,UACH;AAEJ;AAOO,SAAS,yBAA+C;AAC7D,SAAO,WAAW,oBAAoB;AACxC;AAGO,SAAS,mBAAkC;AAChD,QAAM,OAAO,uBAAuB;AACpC,MAAI,CAAC,MAAM;AACT,UAAM,IAAI;AAAA,MACR;AAAA,IAGF;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,kBAAgC;AAC9C,QAAM,OAAO,iBAAiB;AAC9B,SAAO,QAAQ,MAAM,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC;AAC/C;","names":[]}