@ai-matrx/content-ir-react 0.10.0 → 0.11.1

package/dist/index.d.cts

@@ -1,17 +1,17 @@
 import { C as ComponentResolutionSource, a as ComponentResolution, b as ContentIrErrorReporter } from './component-resolution.types-DLO2w-0n.cjs';
 export { c as ComponentRole, d as ContentIrErrorReport, J as JsonObject, K as KindComponentRow, S as SystemComponentEntry, e as consoleErrorReporter } from './component-resolution.types-DLO2w-0n.cjs';
-import { C as ContentIrHost, K as KindRouteEnv, a as KindDefinitionSource } from './route-QL2Vqf2e.cjs';
-export { b as ContentIrRenderSeams, D as DB_KIND_COMPONENT_KEY, G as GENERIC_STRUCTURED_COMPONENT_KEY, c as GenericFallbackReason, I as IR_PROVISIONAL_KEY, d as IR_ROUTE_KEY, e as IrRenderBlock, f as IrRoutableBlock, g as IrRouteMarker, h as KindRouteBinding, i as KindRouteOptions, P as PartialRenderOptions, j as ProvisionalKindRender, S as StructuredValueRenderProps, k as applyIrKindRoute, l as createKindRouteBinding, m as envelopeFromPartialKind, n as isPartialReadyKind, o as isProvisionalBlock, p as kindServerDataFromStoredValue, q as markKindPartialUnsafe, r as readIrRouteMarker, s as resetPartialUnsafeKinds, t as resetSourcelessDbRowReports, u as resolveAnnouncedKindLoading, v as resolveProvisionalKindRender, w as routeEnvOf } from './route-QL2Vqf2e.cjs';
-import * as React from 'react';
-import React__default, { ReactNode } from 'react';
+import { C as ContentIrHost, K as KindRouteEnv, a as KindDefinitionSource } from './route-B9U-9QCw.cjs';
+export { b as ContentIrRenderSeams, D as DB_KIND_COMPONENT_KEY, c as DIRECTIVE_BLOCK_TYPE, d as DirectiveApplyResult, e as DirectiveCopyProps, f as DirectiveHost, g as DirectiveHostProvider, h as DirectiveHostProviderProps, i as DirectiveOpenItemOptions, G as GENERIC_STRUCTURED_COMPONENT_KEY, j as GenericFallbackReason, I as IR_PROVISIONAL_KEY, k as IR_ROUTE_KEY, l as IrRenderBlock, m as IrRoutableBlock, n as IrRouteMarker, o as KindRouteBinding, p as KindRouteOptions, P as PartialRenderOptions, q as ProvisionalKindRender, S as StructuredValueRenderProps, r as SupersededKindRender, s as applyIrKindRoute, t as createKindRouteBinding, u as envelopeFromPartialKind, v as isPartialReadyKind, w as isProvisionalBlock, x as kindServerDataFromStoredValue, y as markKindPartialUnsafe, z as readIrRouteMarker, A as resetPartialUnsafeKinds, B as resetSourcelessDbRowReports, E as resolveAnnouncedKindLoading, F as resolveProvisionalKindRender, H as resolveSupersededKindRender, J as routeEnvOf, L as useDirectiveHost } from './route-B9U-9QCw.cjs';
+import * as react from 'react';
+import react__default, { ReactNode, ComponentType } from 'react';
 export { ComponentResolver, ComponentResolverOptions } from './resolver.cjs';
-import '@ai-matrx/content-ir';
+import { DecodedDirective, DirectiveClass } from '@ai-matrx/content-ir';
 
 interface ContentIrRenderProviderProps {
     host: ContentIrHost;
     children: ReactNode;
 }
-declare function ContentIrRenderProvider({ host, children, }: ContentIrRenderProviderProps): React.JSX.Element;
+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
@@ -100,7 +100,7 @@ interface KindInstanceRenderProps {
     variant?: "card" | "bare";
     className?: string;
 }
-declare function KindInstanceRender({ kind, value, showRoutingNote, unroutableFallback, variant, className, }: KindInstanceRenderProps): React.JSX.Element;
+declare function KindInstanceRender(props: KindInstanceRenderProps): react.JSX.Element;
 
 /**
  * The safety net + the "still arriving" affordance for a provisional kind
@@ -134,7 +134,7 @@ interface ProvisionalKindBoundaryOwnProps {
     fallback: ReactNode;
     children: ReactNode;
 }
-declare function ProvisionalKindBoundary(props: ProvisionalKindBoundaryOwnProps): React__default.JSX.Element;
+declare function ProvisionalKindBoundary(props: ProvisionalKindBoundaryOwnProps): react__default.JSX.Element;
 /**
  * The "still arriving" frame. `aria-busy` carries the same fact to assistive
  * tech that the chip carries visually. The chip's own rendering is a host seam
@@ -143,7 +143,7 @@ declare function ProvisionalKindBoundary(props: ProvisionalKindBoundaryOwnProps)
  */
 declare function ProvisionalKindFrame({ children }: {
     children: ReactNode;
-}): React__default.JSX.Element;
+}): react__default.JSX.Element;
 
 interface GenericStructuredViewProps {
     /** The raw region source — the zero-loss floor when no envelope survived. */
@@ -157,7 +157,7 @@ interface GenericStructuredViewProps {
     streamingIndicator?: ReactNode;
     className?: string;
 }
-declare function GenericStructuredView({ content, metadata, streamingIndicator, className, }: GenericStructuredViewProps): React.JSX.Element;
+declare function GenericStructuredView({ content, metadata, streamingIndicator, className, }: GenericStructuredViewProps): react.JSX.Element;
 
 interface DelegatedOutputProps {
     output: unknown;
@@ -185,14 +185,14 @@ interface DelegatedOutputProps {
  * holding, so it is what routes. With no kind at all there is nothing to route
  * to, and the host's fallback (or the floor) shows what the step produced.
  */
-declare function DelegatedOutput({ output, declaredKind, fallback, emptyLabel, }: DelegatedOutputProps): React.JSX.Element;
+declare function DelegatedOutput({ output, declaredKind, fallback, emptyLabel, }: DelegatedOutputProps): react.JSX.Element;
 interface NodeOutcomeViewProps {
     serverData?: unknown;
     /** Passed through to {@link DelegatedOutput}. */
     fallback?: (output: unknown) => ReactNode;
 }
 /** THE renderer for the `node_outcome` runtime wrapper kind. */
-declare function NodeOutcomeView({ serverData, fallback }: NodeOutcomeViewProps): React.JSX.Element | null;
+declare function NodeOutcomeView({ serverData, fallback }: NodeOutcomeViewProps): react.JSX.Element | null;
 interface RunResultViewProps {
     serverData?: unknown;
     fallback?: (output: unknown) => ReactNode;
@@ -209,7 +209,71 @@ interface RunResultViewProps {
  * outcomes — otherwise it is the same content the outcomes already carry, and
  * showing both is the duplication the wrapper exists to prevent.
  */
-declare function RunResultView({ serverData, fallback }: RunResultViewProps): React.JSX.Element | null;
+declare function RunResultView({ serverData, fallback }: RunResultViewProps): react.JSX.Element | null;
+
+/**
+ * Kind Directives — the renderer registry, and THE PREFIX TIER.
+ *
+ * A directive IS a kind instance, so the renderer for one is resolved from its
+ * SLUG, in the same shape the kind component resolver uses:
+ *
+ *   getDirectiveRenderer(directive)
+ *     → an exact-slug renderer            (directive_v1_action_plan_tree)
+ *     → else the CLASS prefix rule        (every directive_v1_reference_*)
+ *     → else null                         (DirectiveRender's own tier: the
+ *                                          side-effect card, then the floor)
+ *
+ * THE PREFIX RULE is Arman's routing-language ruling made real: registering
+ * `reference` once gives EVERY enrolled noun a renderer for free; a custom
+ * renderer for one slug overrides it; a brand-new server noun renders with
+ * ZERO client edits. Hosts register their bespoke renderers (reference chips,
+ * plan trees) here; the package supplies the side-effect card and the floor.
+ */
+
+interface DirectiveRendererProps {
+    /** The decoded two-key shell — slug, class, noun, items, position law. */
+    directive: DecodedDirective;
+}
+type DirectiveRenderer = ComponentType<DirectiveRendererProps>;
+/**
+ * Register a renderer for a whole CLASS (the prefix rule), or for one exact
+ * `(class, noun)` pair, which wins. `noun` is passed as a noun, never a
+ * hand-typed slug: the slug is BUILT by the grammar, so a registration whose
+ * slug could not be parsed back is unconstructable rather than unreachable.
+ */
+declare function registerDirectiveRenderer(directiveClass: DirectiveClass, renderer: DirectiveRenderer, noun?: string): void;
+/** The renderer for a slug: exact → class prefix rule → null. */
+declare function getDirectiveRenderer(directive: Pick<DecodedDirective, "slug" | "directiveClass">): DirectiveRenderer | null;
+/** Tests only. */
+declare function resetDirectiveRenderers(): void;
+
+interface ApplyDirectiveButtonProps {
+    directive: DecodedDirective;
+    label?: string;
+    /** How many things this will write — shown during the wait so a long apply reads as work, not a frozen spinner. */
+    itemCount?: number;
+    onApplied?: () => void;
+}
+declare function ApplyDirectiveButton({ directive, label, itemCount, onApplied, }: ApplyDirectiveButtonProps): react.JSX.Element | null;
+
+interface SideEffectDirectiveCardProps {
+    directive: DecodedDirective;
+}
+declare function SideEffectDirectiveCard({ directive }: SideEffectDirectiveCardProps): react.JSX.Element;
+
+interface DirectiveFallbackCardProps {
+    directive: DecodedDirective;
+    /** Short, human explanation of why the rich renderer degraded. */
+    reason?: string;
+}
+declare function DirectiveFallbackCard({ directive, reason }: DirectiveFallbackCardProps): react.JSX.Element;
+
+interface DirectiveRenderProps {
+    /** The fence body (JSON string) or an already-parsed shell / value. */
+    content: unknown;
+    className?: string;
+}
+declare function DirectiveRender({ content, className }: DirectiveRenderProps): react.JSX.Element;
 
 /**
  * The DB-component COMPILE CACHE — session-scoped, keyed per winning row
@@ -307,7 +371,7 @@ interface DbKindComponentRenderProps {
     uiOptions?: KindComponentUiOptions;
 }
 interface CompiledDbKindComponent {
-    Component: React.ComponentType<DbKindComponentRenderProps>;
+    Component: react.ComponentType<DbKindComponentRenderProps>;
     /** Compiled `props_transform`, or null when the row declares none. */
     transform: ((data: unknown) => unknown) | null;
 }
@@ -357,7 +421,7 @@ type DbKindComponentCompiler = (args: {
     code: string;
     allowedImports: string[];
 }) => {
-    Component: React.ComponentType<Record<string, unknown>> | null;
+    Component: react.ComponentType<Record<string, unknown>> | null;
     error: string | null;
 };
 interface DbKindComponentCachePorts {
@@ -444,8 +508,8 @@ interface DbKindComponentErrorBoundaryProps {
     kind: string;
     /** The resolved component's `updated_at`; a change means a new version. */
     resetSignal: string | null;
-    fallback: React.ReactNode;
-    children: React.ReactNode;
+    fallback: react.ReactNode;
+    children: react.ReactNode;
     /**
      * Where the catch lands. A host binds structured capture + incident filing
      * here; the default screams to the console. NOTE for hosts whose console
@@ -466,12 +530,12 @@ interface State {
      */
     signalAtLastRender: string | null;
 }
-declare class DbKindComponentErrorBoundary extends React.Component<DbKindComponentErrorBoundaryProps, State> {
+declare class DbKindComponentErrorBoundary extends react.Component<DbKindComponentErrorBoundaryProps, State> {
     constructor(props: DbKindComponentErrorBoundaryProps);
     static getDerivedStateFromError(): Partial<State>;
     static getDerivedStateFromProps(props: DbKindComponentErrorBoundaryProps, state: State): State | null;
-    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
-    render(): React.ReactNode;
+    componentDidCatch(error: Error, errorInfo: react.ErrorInfo): void;
+    render(): react.ReactNode;
 }
 
-export { type CompiledDbKindComponent, ComponentResolution, ComponentResolutionSource, ContentIrErrorReporter, ContentIrHost, ContentIrRenderProvider, type ContentIrRenderProviderProps, type DbKindActionResult, type DbKindCompileResult, type DbKindComponentCache, type DbKindComponentCachePorts, type DbKindComponentCompiler, DbKindComponentErrorBoundary, type DbKindComponentErrorBoundaryProps, type DbKindComponentIncident, type DbKindComponentIncidentSink, type DbKindComponentIncidentType, type DbKindComponentRenderProps, DelegatedOutput, type DelegatedOutputProps, GenericStructuredView, type GenericStructuredViewProps, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NodeOutcomeView, type NodeOutcomeViewProps, ProvisionalKindBoundary, ProvisionalKindFrame, type ResolveKindValue, type RunDbKindAction, RunResultView, type RunResultViewProps, createDbKindComponentCache, isDbKindComponentBodyPending, isRecordValue, kindIsRoutable, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv };
+export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, type CompiledDbKindComponent, ComponentResolution, ComponentResolutionSource, ContentIrErrorReporter, ContentIrHost, ContentIrRenderProvider, type ContentIrRenderProviderProps, type DbKindActionResult, type DbKindCompileResult, type DbKindComponentCache, type DbKindComponentCachePorts, type DbKindComponentCompiler, DbKindComponentErrorBoundary, type DbKindComponentErrorBoundaryProps, type DbKindComponentIncident, type DbKindComponentIncidentSink, type DbKindComponentIncidentType, type DbKindComponentRenderProps, DelegatedOutput, type DelegatedOutputProps, DirectiveFallbackCard, type DirectiveFallbackCardProps, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, GenericStructuredView, type GenericStructuredViewProps, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NodeOutcomeView, type NodeOutcomeViewProps, ProvisionalKindBoundary, ProvisionalKindFrame, type ResolveKindValue, type RunDbKindAction, RunResultView, type RunResultViewProps, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, createDbKindComponentCache, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, kindIsRoutable, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv };

package/dist/index.d.ts

@@ -1,17 +1,17 @@
 import { C as ComponentResolutionSource, a as ComponentResolution, b as ContentIrErrorReporter } from './component-resolution.types-DLO2w-0n.js';
 export { c as ComponentRole, d as ContentIrErrorReport, J as JsonObject, K as KindComponentRow, S as SystemComponentEntry, e as consoleErrorReporter } from './component-resolution.types-DLO2w-0n.js';
-import { C as ContentIrHost, K as KindRouteEnv, a as KindDefinitionSource } from './route-PUuEuEug.js';
-export { b as ContentIrRenderSeams, D as DB_KIND_COMPONENT_KEY, G as GENERIC_STRUCTURED_COMPONENT_KEY, c as GenericFallbackReason, I as IR_PROVISIONAL_KEY, d as IR_ROUTE_KEY, e as IrRenderBlock, f as IrRoutableBlock, g as IrRouteMarker, h as KindRouteBinding, i as KindRouteOptions, P as PartialRenderOptions, j as ProvisionalKindRender, S as StructuredValueRenderProps, k as applyIrKindRoute, l as createKindRouteBinding, m as envelopeFromPartialKind, n as isPartialReadyKind, o as isProvisionalBlock, p as kindServerDataFromStoredValue, q as markKindPartialUnsafe, r as readIrRouteMarker, s as resetPartialUnsafeKinds, t as resetSourcelessDbRowReports, u as resolveAnnouncedKindLoading, v as resolveProvisionalKindRender, w as routeEnvOf } from './route-PUuEuEug.js';
-import * as React from 'react';
-import React__default, { ReactNode } from 'react';
+import { C as ContentIrHost, K as KindRouteEnv, a as KindDefinitionSource } from './route-gNpJ8zzW.js';
+export { b as ContentIrRenderSeams, D as DB_KIND_COMPONENT_KEY, c as DIRECTIVE_BLOCK_TYPE, d as DirectiveApplyResult, e as DirectiveCopyProps, f as DirectiveHost, g as DirectiveHostProvider, h as DirectiveHostProviderProps, i as DirectiveOpenItemOptions, G as GENERIC_STRUCTURED_COMPONENT_KEY, j as GenericFallbackReason, I as IR_PROVISIONAL_KEY, k as IR_ROUTE_KEY, l as IrRenderBlock, m as IrRoutableBlock, n as IrRouteMarker, o as KindRouteBinding, p as KindRouteOptions, P as PartialRenderOptions, q as ProvisionalKindRender, S as StructuredValueRenderProps, r as SupersededKindRender, s as applyIrKindRoute, t as createKindRouteBinding, u as envelopeFromPartialKind, v as isPartialReadyKind, w as isProvisionalBlock, x as kindServerDataFromStoredValue, y as markKindPartialUnsafe, z as readIrRouteMarker, A as resetPartialUnsafeKinds, B as resetSourcelessDbRowReports, E as resolveAnnouncedKindLoading, F as resolveProvisionalKindRender, H as resolveSupersededKindRender, J as routeEnvOf, L as useDirectiveHost } from './route-gNpJ8zzW.js';
+import * as react from 'react';
+import react__default, { ReactNode, ComponentType } from 'react';
 export { ComponentResolver, ComponentResolverOptions } from './resolver.js';
-import '@ai-matrx/content-ir';
+import { DecodedDirective, DirectiveClass } from '@ai-matrx/content-ir';
 
 interface ContentIrRenderProviderProps {
     host: ContentIrHost;
     children: ReactNode;
 }
-declare function ContentIrRenderProvider({ host, children, }: ContentIrRenderProviderProps): React.JSX.Element;
+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
@@ -100,7 +100,7 @@ interface KindInstanceRenderProps {
     variant?: "card" | "bare";
     className?: string;
 }
-declare function KindInstanceRender({ kind, value, showRoutingNote, unroutableFallback, variant, className, }: KindInstanceRenderProps): React.JSX.Element;
+declare function KindInstanceRender(props: KindInstanceRenderProps): react.JSX.Element;
 
 /**
  * The safety net + the "still arriving" affordance for a provisional kind
@@ -134,7 +134,7 @@ interface ProvisionalKindBoundaryOwnProps {
     fallback: ReactNode;
     children: ReactNode;
 }
-declare function ProvisionalKindBoundary(props: ProvisionalKindBoundaryOwnProps): React__default.JSX.Element;
+declare function ProvisionalKindBoundary(props: ProvisionalKindBoundaryOwnProps): react__default.JSX.Element;
 /**
  * The "still arriving" frame. `aria-busy` carries the same fact to assistive
  * tech that the chip carries visually. The chip's own rendering is a host seam
@@ -143,7 +143,7 @@ declare function ProvisionalKindBoundary(props: ProvisionalKindBoundaryOwnProps)
  */
 declare function ProvisionalKindFrame({ children }: {
     children: ReactNode;
-}): React__default.JSX.Element;
+}): react__default.JSX.Element;
 
 interface GenericStructuredViewProps {
     /** The raw region source — the zero-loss floor when no envelope survived. */
@@ -157,7 +157,7 @@ interface GenericStructuredViewProps {
     streamingIndicator?: ReactNode;
     className?: string;
 }
-declare function GenericStructuredView({ content, metadata, streamingIndicator, className, }: GenericStructuredViewProps): React.JSX.Element;
+declare function GenericStructuredView({ content, metadata, streamingIndicator, className, }: GenericStructuredViewProps): react.JSX.Element;
 
 interface DelegatedOutputProps {
     output: unknown;
@@ -185,14 +185,14 @@ interface DelegatedOutputProps {
  * holding, so it is what routes. With no kind at all there is nothing to route
  * to, and the host's fallback (or the floor) shows what the step produced.
  */
-declare function DelegatedOutput({ output, declaredKind, fallback, emptyLabel, }: DelegatedOutputProps): React.JSX.Element;
+declare function DelegatedOutput({ output, declaredKind, fallback, emptyLabel, }: DelegatedOutputProps): react.JSX.Element;
 interface NodeOutcomeViewProps {
     serverData?: unknown;
     /** Passed through to {@link DelegatedOutput}. */
     fallback?: (output: unknown) => ReactNode;
 }
 /** THE renderer for the `node_outcome` runtime wrapper kind. */
-declare function NodeOutcomeView({ serverData, fallback }: NodeOutcomeViewProps): React.JSX.Element | null;
+declare function NodeOutcomeView({ serverData, fallback }: NodeOutcomeViewProps): react.JSX.Element | null;
 interface RunResultViewProps {
     serverData?: unknown;
     fallback?: (output: unknown) => ReactNode;
@@ -209,7 +209,71 @@ interface RunResultViewProps {
  * outcomes — otherwise it is the same content the outcomes already carry, and
  * showing both is the duplication the wrapper exists to prevent.
  */
-declare function RunResultView({ serverData, fallback }: RunResultViewProps): React.JSX.Element | null;
+declare function RunResultView({ serverData, fallback }: RunResultViewProps): react.JSX.Element | null;
+
+/**
+ * Kind Directives — the renderer registry, and THE PREFIX TIER.
+ *
+ * A directive IS a kind instance, so the renderer for one is resolved from its
+ * SLUG, in the same shape the kind component resolver uses:
+ *
+ *   getDirectiveRenderer(directive)
+ *     → an exact-slug renderer            (directive_v1_action_plan_tree)
+ *     → else the CLASS prefix rule        (every directive_v1_reference_*)
+ *     → else null                         (DirectiveRender's own tier: the
+ *                                          side-effect card, then the floor)
+ *
+ * THE PREFIX RULE is Arman's routing-language ruling made real: registering
+ * `reference` once gives EVERY enrolled noun a renderer for free; a custom
+ * renderer for one slug overrides it; a brand-new server noun renders with
+ * ZERO client edits. Hosts register their bespoke renderers (reference chips,
+ * plan trees) here; the package supplies the side-effect card and the floor.
+ */
+
+interface DirectiveRendererProps {
+    /** The decoded two-key shell — slug, class, noun, items, position law. */
+    directive: DecodedDirective;
+}
+type DirectiveRenderer = ComponentType<DirectiveRendererProps>;
+/**
+ * Register a renderer for a whole CLASS (the prefix rule), or for one exact
+ * `(class, noun)` pair, which wins. `noun` is passed as a noun, never a
+ * hand-typed slug: the slug is BUILT by the grammar, so a registration whose
+ * slug could not be parsed back is unconstructable rather than unreachable.
+ */
+declare function registerDirectiveRenderer(directiveClass: DirectiveClass, renderer: DirectiveRenderer, noun?: string): void;
+/** The renderer for a slug: exact → class prefix rule → null. */
+declare function getDirectiveRenderer(directive: Pick<DecodedDirective, "slug" | "directiveClass">): DirectiveRenderer | null;
+/** Tests only. */
+declare function resetDirectiveRenderers(): void;
+
+interface ApplyDirectiveButtonProps {
+    directive: DecodedDirective;
+    label?: string;
+    /** How many things this will write — shown during the wait so a long apply reads as work, not a frozen spinner. */
+    itemCount?: number;
+    onApplied?: () => void;
+}
+declare function ApplyDirectiveButton({ directive, label, itemCount, onApplied, }: ApplyDirectiveButtonProps): react.JSX.Element | null;
+
+interface SideEffectDirectiveCardProps {
+    directive: DecodedDirective;
+}
+declare function SideEffectDirectiveCard({ directive }: SideEffectDirectiveCardProps): react.JSX.Element;
+
+interface DirectiveFallbackCardProps {
+    directive: DecodedDirective;
+    /** Short, human explanation of why the rich renderer degraded. */
+    reason?: string;
+}
+declare function DirectiveFallbackCard({ directive, reason }: DirectiveFallbackCardProps): react.JSX.Element;
+
+interface DirectiveRenderProps {
+    /** The fence body (JSON string) or an already-parsed shell / value. */
+    content: unknown;
+    className?: string;
+}
+declare function DirectiveRender({ content, className }: DirectiveRenderProps): react.JSX.Element;
 
 /**
  * The DB-component COMPILE CACHE — session-scoped, keyed per winning row
@@ -307,7 +371,7 @@ interface DbKindComponentRenderProps {
     uiOptions?: KindComponentUiOptions;
 }
 interface CompiledDbKindComponent {
-    Component: React.ComponentType<DbKindComponentRenderProps>;
+    Component: react.ComponentType<DbKindComponentRenderProps>;
     /** Compiled `props_transform`, or null when the row declares none. */
     transform: ((data: unknown) => unknown) | null;
 }
@@ -357,7 +421,7 @@ type DbKindComponentCompiler = (args: {
     code: string;
     allowedImports: string[];
 }) => {
-    Component: React.ComponentType<Record<string, unknown>> | null;
+    Component: react.ComponentType<Record<string, unknown>> | null;
     error: string | null;
 };
 interface DbKindComponentCachePorts {
@@ -444,8 +508,8 @@ interface DbKindComponentErrorBoundaryProps {
     kind: string;
     /** The resolved component's `updated_at`; a change means a new version. */
     resetSignal: string | null;
-    fallback: React.ReactNode;
-    children: React.ReactNode;
+    fallback: react.ReactNode;
+    children: react.ReactNode;
     /**
      * Where the catch lands. A host binds structured capture + incident filing
      * here; the default screams to the console. NOTE for hosts whose console
@@ -466,12 +530,12 @@ interface State {
      */
     signalAtLastRender: string | null;
 }
-declare class DbKindComponentErrorBoundary extends React.Component<DbKindComponentErrorBoundaryProps, State> {
+declare class DbKindComponentErrorBoundary extends react.Component<DbKindComponentErrorBoundaryProps, State> {
     constructor(props: DbKindComponentErrorBoundaryProps);
     static getDerivedStateFromError(): Partial<State>;
     static getDerivedStateFromProps(props: DbKindComponentErrorBoundaryProps, state: State): State | null;
-    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
-    render(): React.ReactNode;
+    componentDidCatch(error: Error, errorInfo: react.ErrorInfo): void;
+    render(): react.ReactNode;
 }
 
-export { type CompiledDbKindComponent, ComponentResolution, ComponentResolutionSource, ContentIrErrorReporter, ContentIrHost, ContentIrRenderProvider, type ContentIrRenderProviderProps, type DbKindActionResult, type DbKindCompileResult, type DbKindComponentCache, type DbKindComponentCachePorts, type DbKindComponentCompiler, DbKindComponentErrorBoundary, type DbKindComponentErrorBoundaryProps, type DbKindComponentIncident, type DbKindComponentIncidentSink, type DbKindComponentIncidentType, type DbKindComponentRenderProps, DelegatedOutput, type DelegatedOutputProps, GenericStructuredView, type GenericStructuredViewProps, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NodeOutcomeView, type NodeOutcomeViewProps, ProvisionalKindBoundary, ProvisionalKindFrame, type ResolveKindValue, type RunDbKindAction, RunResultView, type RunResultViewProps, createDbKindComponentCache, isDbKindComponentBodyPending, isRecordValue, kindIsRoutable, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv };
+export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, type CompiledDbKindComponent, ComponentResolution, ComponentResolutionSource, ContentIrErrorReporter, ContentIrHost, ContentIrRenderProvider, type ContentIrRenderProviderProps, type DbKindActionResult, type DbKindCompileResult, type DbKindComponentCache, type DbKindComponentCachePorts, type DbKindComponentCompiler, DbKindComponentErrorBoundary, type DbKindComponentErrorBoundaryProps, type DbKindComponentIncident, type DbKindComponentIncidentSink, type DbKindComponentIncidentType, type DbKindComponentRenderProps, DelegatedOutput, type DelegatedOutputProps, DirectiveFallbackCard, type DirectiveFallbackCardProps, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, GenericStructuredView, type GenericStructuredViewProps, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NodeOutcomeView, type NodeOutcomeViewProps, ProvisionalKindBoundary, ProvisionalKindFrame, type ResolveKindValue, type RunDbKindAction, RunResultView, type RunResultViewProps, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, createDbKindComponentCache, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, kindIsRoutable, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv };