@ai-matrx/content-ir-react 0.15.2 → 0.16.1

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 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-BCtPhF7W.cjs';
-export { b as ContentIrRenderSeams, D as DB_KIND_COMPONENT_KEY, c as DIRECTIVE_BLOCK_TYPE, d as DirectiveApplyResult, e as DirectiveApplyState, f as DirectiveAskRequest, g as DirectiveCopyProps, h as DirectiveHost, i as DirectiveHostProvider, j as DirectiveHostProviderProps, k as DirectiveOpenItemOptions, l as DirectiveRecordProps, m as DirectiveRecordRef, n as DirectiveScope, o as DirectiveScopeProvider, p as DirectiveShell, G as GENERIC_STRUCTURED_COMPONENT_KEY, q as GenericFallbackReason, I as IR_PROVISIONAL_KEY, r as IR_ROUTE_KEY, s as IrRenderBlock, t as IrRoutableBlock, u as IrRouteMarker, v as KindRouteBinding, w as KindRouteOptions, P as PartialRenderOptions, x as ProvisionalKindRender, S as StructuredValueRenderProps, y as SupersededKindRender, z as applyIrKindRoute, A as createKindRouteBinding, B as envelopeFromPartialKind, E as isPartialReadyKind, F as isProvisionalBlock, H as kindServerDataFromStoredValue, J as markKindPartialUnsafe, L as readIrRouteMarker, M as resetPartialUnsafeKinds, N as resetSourcelessDbRowReports, O as resolveAnnouncedKindLoading, Q as resolveProvisionalKindRender, R as resolveSupersededKindRender, T as routeEnvOf, U as useDirectiveHost, V as useDirectiveScope } from './route-BCtPhF7W.cjs';
+import { C as ContentIrHost, K as KindRouteEnv, a as KindDefinitionSource, D as DirectiveRecordRef } from './route-YcoyR3Fj.cjs';
+export { b as ContentIrRenderSeams, c as DB_KIND_COMPONENT_KEY, d as DIRECTIVE_BLOCK_TYPE, e as DirectiveApplyResult, f as DirectiveApplyState, g as DirectiveAskRequest, h as DirectiveCopyProps, i as DirectiveHost, j as DirectiveHostProvider, k as DirectiveHostProviderProps, l as DirectiveOpenItemOptions, m as DirectiveRecordProps, n as DirectiveScope, o as DirectiveScopeProvider, p as DirectiveShell, G as GENERIC_STRUCTURED_COMPONENT_KEY, q as GenericFallbackReason, I as IR_PROVISIONAL_KEY, r as IR_ROUTE_KEY, s as IrRenderBlock, t as IrRoutableBlock, u as IrRouteMarker, v as KindRouteBinding, w as KindRouteOptions, P as PartialRenderOptions, x as ProvisionalKindRender, S as StructuredValueRenderProps, y as SupersededKindRender, z as applyIrKindRoute, A as createKindRouteBinding, B as envelopeFromPartialKind, E as isPartialReadyKind, F as isProvisionalBlock, H as kindServerDataFromStoredValue, J as markKindPartialUnsafe, L as readIrRouteMarker, M as resetPartialUnsafeKinds, N as resetSourcelessDbRowReports, O as resolveAnnouncedKindLoading, Q as resolveProvisionalKindRender, R as resolveSupersededKindRender, T as routeEnvOf, U as useDirectiveHost, V as useDirectiveScope } from './route-YcoyR3Fj.cjs';
 import * as react from 'react';
 import react__default, { ReactNode, ComponentType } from 'react';
 export { ComponentResolver, ComponentResolverOptions } from './resolver.cjs';
@@ -256,9 +256,84 @@ interface ApplyDirectiveButtonProps {
 }
 declare function ApplyDirectiveButton({ directive, label, itemCount, onApplied, }: ApplyDirectiveButtonProps): react.JSX.Element | null;
 
+/**
+ * WHAT A DIRECTIVE ITEM WILL DO TO AN EXISTING RECORD — for the card, the
+ * confirm dialog, and anything else that must say it before the click.
+ *
+ * WHY (reviewer, 2026-09-30): an Update card and a Delete card showed each item
+ * as "Item" — they never named the record they would change, and an Update card
+ * never said what it would change. The item-summary helpers name a thing to be
+ * CREATED from its own fields; an update or delete item carries the TARGET's id
+ * and, for an update, the NEW values — so its "title" field is the new title,
+ * not the name of the record being changed. Naming the target is the host's
+ * live lookup (`DirectiveHost.renderRecord`); what changes is right here.
+ *
+ * Law: common-docs/policies/destructive-and-expensive-actions.md — the sentence
+ * names what changes.
+ */
+/** Classes whose items point at an EXISTING record by `id`. */
+declare const TARGETING_CLASSES: ReadonlySet<string>;
+/** How long a changed value may read before it is shortened (full value on hover). */
+declare const CHANGE_VALUE_MAX = 60;
+/** The id of the existing record an update/delete item targets, or null. */
+declare function itemRecordId(item: Record<string, unknown>): string | null;
+/** "due_date" → "Due date". Underscores read as developer output. */
+declare function fieldLabel(key: string): string;
+/** A short, honest name for a record we could not look up: "Task 1a2b3c4d". */
+declare function recordFallbackName(nounLabel: string, id: string): string;
+/** One value as a row reads it: shortened, the whole of it, and whether it is empty. */
+interface ChangeValue {
+    value: string;
+    full: string;
+    clears: boolean;
+}
+interface ItemChange extends ChangeValue {
+    key: string;
+    /** "Due date". */
+    label: string;
+    /**
+     * What the field holds NOW, when the host could read the record — so an
+     * update reads "old → new", never just the new value (reviewer, 2026-10-02).
+     * Absent when the current record is unknown.
+     */
+    before?: ChangeValue;
+    /** True when the record already holds exactly this value — nothing changes. */
+    same?: boolean;
+}
+/** One value, described for a change row (`value` shortened, `full` whole). */
+declare function describeChangeValue(value: unknown): ChangeValue;
+/**
+ * Every field an UPDATE item sets, in the order the item carries them — ALL of
+ * them, never a sample: a person approving an overwrite sees the whole of it.
+ *
+ * Pass `current` — the record as it is now (`DirectiveHost.readRecord`) — and
+ * each change also carries what it REPLACES (`before`) and whether it changes
+ * anything at all (`same`). A field the record does not carry gets no `before`.
+ */
+interface ItemChangesOptions {
+    /**
+     * The noun's title column (catalog `title_column` — `nounTitleColumn`). It is
+     * labelled "Title" whatever it is called: a note's title is stored in
+     * `label`, and the confirm said "Label" while the form said "Title"
+     * (reviewer, 2026-10-02). The same rule the directive builder's form uses.
+     */
+    titleColumn?: string | null;
+}
+declare function itemChanges(item: Record<string, unknown>, current?: Record<string, unknown> | null, options?: ItemChangesOptions): ItemChange[];
+
 interface SideEffectDirectiveCardProps {
     directive: DecodedDirective;
 }
+/**
+ * THE CHANGE LIST — every field an update sets, as "Label  old → new" when the
+ * record's current value is known, "Label → new" when it is not. ONE component
+ * for the card row and the host's confirm dialog, so the two can never read
+ * differently (reviewer, 2026-10-02: the confirm showed only the new value).
+ */
+declare function DirectiveChangeList({ changes, className, }: {
+    changes: ItemChange[];
+    className?: string;
+}): react.JSX.Element;
 declare function SideEffectDirectiveCard({ directive }: SideEffectDirectiveCardProps): react.JSX.Element;
 
 interface DirectiveFallbackCardProps {
@@ -302,46 +377,14 @@ interface DirectiveRenderProps {
 }
 declare function DirectiveRender({ conversationId, ...props }: DirectiveRenderProps): react.JSX.Element;
 
-/**
- * WHAT A DIRECTIVE ITEM WILL DO TO AN EXISTING RECORD — for the card, the
- * confirm dialog, and anything else that must say it before the click.
- *
- * WHY (reviewer, 2026-09-30): an Update card and a Delete card showed each item
- * as "Item" — they never named the record they would change, and an Update card
- * never said what it would change. The item-summary helpers name a thing to be
- * CREATED from its own fields; an update or delete item carries the TARGET's id
- * and, for an update, the NEW values — so its "title" field is the new title,
- * not the name of the record being changed. Naming the target is the host's
- * live lookup (`DirectiveHost.renderRecord`); what changes is right here.
- *
- * Law: common-docs/policies/destructive-and-expensive-actions.md — the sentence
- * names what changes.
- */
-/** Classes whose items point at an EXISTING record by `id`. */
-declare const TARGETING_CLASSES: ReadonlySet<string>;
-/** How long a changed value may read before it is shortened (full value on hover). */
-declare const CHANGE_VALUE_MAX = 60;
-/** The id of the existing record an update/delete item targets, or null. */
-declare function itemRecordId(item: Record<string, unknown>): string | null;
-/** "due_date" → "Due date". Underscores read as developer output. */
-declare function fieldLabel(key: string): string;
-/** A short, honest name for a record we could not look up: "Task 1a2b3c4d". */
-declare function recordFallbackName(nounLabel: string, id: string): string;
-interface ItemChange {
-    key: string;
-    /** "Due date". */
-    label: string;
-    /** What it becomes, shortened for a row; `full` carries the whole value. */
-    value: string;
-    full: string;
-    /** True when the new value empties the field. */
-    clears: boolean;
+type RecordValuesStatus = "idle" | "loading" | "ready" | "unavailable";
+interface RecordValues {
+    /** The record's fields now, or null until (or unless) they are read. */
+    values: Record<string, unknown> | null;
+    status: RecordValuesStatus;
 }
-/**
- * Every field an UPDATE item sets, in the order the item carries them — ALL of
- * them, never a sample: a person approving an overwrite sees the whole of it.
- */
-declare function itemChanges(item: Record<string, unknown>): ItemChange[];
+type RecordReader = (ref: DirectiveRecordRef) => Promise<Record<string, unknown> | null>;
+declare function useRecordValues(read: RecordReader | undefined, ref: DirectiveRecordRef | null): RecordValues;
 
 /**
  * The DB-component COMPILE CACHE — session-scoped, keyed per winning row
@@ -606,4 +649,4 @@ declare class DbKindComponentErrorBoundary extends react.Component<DbKindCompone
     render(): react.ReactNode;
 }
 
-export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, CHANGE_VALUE_MAX, 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, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, GenericStructuredView, type GenericStructuredViewProps, type ItemChange, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NodeOutcomeView, type NodeOutcomeViewProps, ProvisionalKindBoundary, ProvisionalKindFrame, type ResolveKindValue, type RunDbKindAction, RunResultView, type RunResultViewProps, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, TARGETING_CLASSES, createDbKindComponentCache, fieldLabel, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, itemChanges, itemRecordId, kindIsRoutable, provisionalDirectiveSlug, recordFallbackName, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv };
+export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, CHANGE_VALUE_MAX, type ChangeValue, 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, DirectiveChangeList, DirectiveFallbackCard, type DirectiveFallbackCardProps, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRecordRef, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, GenericStructuredView, type GenericStructuredViewProps, type ItemChange, type ItemChangesOptions, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NodeOutcomeView, type NodeOutcomeViewProps, ProvisionalKindBoundary, ProvisionalKindFrame, type RecordReader, type RecordValues, type RecordValuesStatus, type ResolveKindValue, type RunDbKindAction, RunResultView, type RunResultViewProps, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, TARGETING_CLASSES, createDbKindComponentCache, describeChangeValue, fieldLabel, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, itemChanges, itemRecordId, kindIsRoutable, provisionalDirectiveSlug, recordFallbackName, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv, useRecordValues };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 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-DDbgc-ID.js';
-export { b as ContentIrRenderSeams, D as DB_KIND_COMPONENT_KEY, c as DIRECTIVE_BLOCK_TYPE, d as DirectiveApplyResult, e as DirectiveApplyState, f as DirectiveAskRequest, g as DirectiveCopyProps, h as DirectiveHost, i as DirectiveHostProvider, j as DirectiveHostProviderProps, k as DirectiveOpenItemOptions, l as DirectiveRecordProps, m as DirectiveRecordRef, n as DirectiveScope, o as DirectiveScopeProvider, p as DirectiveShell, G as GENERIC_STRUCTURED_COMPONENT_KEY, q as GenericFallbackReason, I as IR_PROVISIONAL_KEY, r as IR_ROUTE_KEY, s as IrRenderBlock, t as IrRoutableBlock, u as IrRouteMarker, v as KindRouteBinding, w as KindRouteOptions, P as PartialRenderOptions, x as ProvisionalKindRender, S as StructuredValueRenderProps, y as SupersededKindRender, z as applyIrKindRoute, A as createKindRouteBinding, B as envelopeFromPartialKind, E as isPartialReadyKind, F as isProvisionalBlock, H as kindServerDataFromStoredValue, J as markKindPartialUnsafe, L as readIrRouteMarker, M as resetPartialUnsafeKinds, N as resetSourcelessDbRowReports, O as resolveAnnouncedKindLoading, Q as resolveProvisionalKindRender, R as resolveSupersededKindRender, T as routeEnvOf, U as useDirectiveHost, V as useDirectiveScope } from './route-DDbgc-ID.js';
+import { C as ContentIrHost, K as KindRouteEnv, a as KindDefinitionSource, D as DirectiveRecordRef } from './route-De9c5YgW.js';
+export { b as ContentIrRenderSeams, c as DB_KIND_COMPONENT_KEY, d as DIRECTIVE_BLOCK_TYPE, e as DirectiveApplyResult, f as DirectiveApplyState, g as DirectiveAskRequest, h as DirectiveCopyProps, i as DirectiveHost, j as DirectiveHostProvider, k as DirectiveHostProviderProps, l as DirectiveOpenItemOptions, m as DirectiveRecordProps, n as DirectiveScope, o as DirectiveScopeProvider, p as DirectiveShell, G as GENERIC_STRUCTURED_COMPONENT_KEY, q as GenericFallbackReason, I as IR_PROVISIONAL_KEY, r as IR_ROUTE_KEY, s as IrRenderBlock, t as IrRoutableBlock, u as IrRouteMarker, v as KindRouteBinding, w as KindRouteOptions, P as PartialRenderOptions, x as ProvisionalKindRender, S as StructuredValueRenderProps, y as SupersededKindRender, z as applyIrKindRoute, A as createKindRouteBinding, B as envelopeFromPartialKind, E as isPartialReadyKind, F as isProvisionalBlock, H as kindServerDataFromStoredValue, J as markKindPartialUnsafe, L as readIrRouteMarker, M as resetPartialUnsafeKinds, N as resetSourcelessDbRowReports, O as resolveAnnouncedKindLoading, Q as resolveProvisionalKindRender, R as resolveSupersededKindRender, T as routeEnvOf, U as useDirectiveHost, V as useDirectiveScope } from './route-De9c5YgW.js';
 import * as react from 'react';
 import react__default, { ReactNode, ComponentType } from 'react';
 export { ComponentResolver, ComponentResolverOptions } from './resolver.js';
@@ -256,9 +256,84 @@ interface ApplyDirectiveButtonProps {
 }
 declare function ApplyDirectiveButton({ directive, label, itemCount, onApplied, }: ApplyDirectiveButtonProps): react.JSX.Element | null;
 
+/**
+ * WHAT A DIRECTIVE ITEM WILL DO TO AN EXISTING RECORD — for the card, the
+ * confirm dialog, and anything else that must say it before the click.
+ *
+ * WHY (reviewer, 2026-09-30): an Update card and a Delete card showed each item
+ * as "Item" — they never named the record they would change, and an Update card
+ * never said what it would change. The item-summary helpers name a thing to be
+ * CREATED from its own fields; an update or delete item carries the TARGET's id
+ * and, for an update, the NEW values — so its "title" field is the new title,
+ * not the name of the record being changed. Naming the target is the host's
+ * live lookup (`DirectiveHost.renderRecord`); what changes is right here.
+ *
+ * Law: common-docs/policies/destructive-and-expensive-actions.md — the sentence
+ * names what changes.
+ */
+/** Classes whose items point at an EXISTING record by `id`. */
+declare const TARGETING_CLASSES: ReadonlySet<string>;
+/** How long a changed value may read before it is shortened (full value on hover). */
+declare const CHANGE_VALUE_MAX = 60;
+/** The id of the existing record an update/delete item targets, or null. */
+declare function itemRecordId(item: Record<string, unknown>): string | null;
+/** "due_date" → "Due date". Underscores read as developer output. */
+declare function fieldLabel(key: string): string;
+/** A short, honest name for a record we could not look up: "Task 1a2b3c4d". */
+declare function recordFallbackName(nounLabel: string, id: string): string;
+/** One value as a row reads it: shortened, the whole of it, and whether it is empty. */
+interface ChangeValue {
+    value: string;
+    full: string;
+    clears: boolean;
+}
+interface ItemChange extends ChangeValue {
+    key: string;
+    /** "Due date". */
+    label: string;
+    /**
+     * What the field holds NOW, when the host could read the record — so an
+     * update reads "old → new", never just the new value (reviewer, 2026-10-02).
+     * Absent when the current record is unknown.
+     */
+    before?: ChangeValue;
+    /** True when the record already holds exactly this value — nothing changes. */
+    same?: boolean;
+}
+/** One value, described for a change row (`value` shortened, `full` whole). */
+declare function describeChangeValue(value: unknown): ChangeValue;
+/**
+ * Every field an UPDATE item sets, in the order the item carries them — ALL of
+ * them, never a sample: a person approving an overwrite sees the whole of it.
+ *
+ * Pass `current` — the record as it is now (`DirectiveHost.readRecord`) — and
+ * each change also carries what it REPLACES (`before`) and whether it changes
+ * anything at all (`same`). A field the record does not carry gets no `before`.
+ */
+interface ItemChangesOptions {
+    /**
+     * The noun's title column (catalog `title_column` — `nounTitleColumn`). It is
+     * labelled "Title" whatever it is called: a note's title is stored in
+     * `label`, and the confirm said "Label" while the form said "Title"
+     * (reviewer, 2026-10-02). The same rule the directive builder's form uses.
+     */
+    titleColumn?: string | null;
+}
+declare function itemChanges(item: Record<string, unknown>, current?: Record<string, unknown> | null, options?: ItemChangesOptions): ItemChange[];
+
 interface SideEffectDirectiveCardProps {
     directive: DecodedDirective;
 }
+/**
+ * THE CHANGE LIST — every field an update sets, as "Label  old → new" when the
+ * record's current value is known, "Label → new" when it is not. ONE component
+ * for the card row and the host's confirm dialog, so the two can never read
+ * differently (reviewer, 2026-10-02: the confirm showed only the new value).
+ */
+declare function DirectiveChangeList({ changes, className, }: {
+    changes: ItemChange[];
+    className?: string;
+}): react.JSX.Element;
 declare function SideEffectDirectiveCard({ directive }: SideEffectDirectiveCardProps): react.JSX.Element;
 
 interface DirectiveFallbackCardProps {
@@ -302,46 +377,14 @@ interface DirectiveRenderProps {
 }
 declare function DirectiveRender({ conversationId, ...props }: DirectiveRenderProps): react.JSX.Element;
 
-/**
- * WHAT A DIRECTIVE ITEM WILL DO TO AN EXISTING RECORD — for the card, the
- * confirm dialog, and anything else that must say it before the click.
- *
- * WHY (reviewer, 2026-09-30): an Update card and a Delete card showed each item
- * as "Item" — they never named the record they would change, and an Update card
- * never said what it would change. The item-summary helpers name a thing to be
- * CREATED from its own fields; an update or delete item carries the TARGET's id
- * and, for an update, the NEW values — so its "title" field is the new title,
- * not the name of the record being changed. Naming the target is the host's
- * live lookup (`DirectiveHost.renderRecord`); what changes is right here.
- *
- * Law: common-docs/policies/destructive-and-expensive-actions.md — the sentence
- * names what changes.
- */
-/** Classes whose items point at an EXISTING record by `id`. */
-declare const TARGETING_CLASSES: ReadonlySet<string>;
-/** How long a changed value may read before it is shortened (full value on hover). */
-declare const CHANGE_VALUE_MAX = 60;
-/** The id of the existing record an update/delete item targets, or null. */
-declare function itemRecordId(item: Record<string, unknown>): string | null;
-/** "due_date" → "Due date". Underscores read as developer output. */
-declare function fieldLabel(key: string): string;
-/** A short, honest name for a record we could not look up: "Task 1a2b3c4d". */
-declare function recordFallbackName(nounLabel: string, id: string): string;
-interface ItemChange {
-    key: string;
-    /** "Due date". */
-    label: string;
-    /** What it becomes, shortened for a row; `full` carries the whole value. */
-    value: string;
-    full: string;
-    /** True when the new value empties the field. */
-    clears: boolean;
+type RecordValuesStatus = "idle" | "loading" | "ready" | "unavailable";
+interface RecordValues {
+    /** The record's fields now, or null until (or unless) they are read. */
+    values: Record<string, unknown> | null;
+    status: RecordValuesStatus;
 }
-/**
- * Every field an UPDATE item sets, in the order the item carries them — ALL of
- * them, never a sample: a person approving an overwrite sees the whole of it.
- */
-declare function itemChanges(item: Record<string, unknown>): ItemChange[];
+type RecordReader = (ref: DirectiveRecordRef) => Promise<Record<string, unknown> | null>;
+declare function useRecordValues(read: RecordReader | undefined, ref: DirectiveRecordRef | null): RecordValues;
 
 /**
  * The DB-component COMPILE CACHE — session-scoped, keyed per winning row
@@ -606,4 +649,4 @@ declare class DbKindComponentErrorBoundary extends react.Component<DbKindCompone
     render(): react.ReactNode;
 }
 
-export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, CHANGE_VALUE_MAX, 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, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, GenericStructuredView, type GenericStructuredViewProps, type ItemChange, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NodeOutcomeView, type NodeOutcomeViewProps, ProvisionalKindBoundary, ProvisionalKindFrame, type ResolveKindValue, type RunDbKindAction, RunResultView, type RunResultViewProps, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, TARGETING_CLASSES, createDbKindComponentCache, fieldLabel, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, itemChanges, itemRecordId, kindIsRoutable, provisionalDirectiveSlug, recordFallbackName, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv };
+export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, CHANGE_VALUE_MAX, type ChangeValue, 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, DirectiveChangeList, DirectiveFallbackCard, type DirectiveFallbackCardProps, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRecordRef, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, GenericStructuredView, type GenericStructuredViewProps, type ItemChange, type ItemChangesOptions, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NodeOutcomeView, type NodeOutcomeViewProps, ProvisionalKindBoundary, ProvisionalKindFrame, type RecordReader, type RecordValues, type RecordValuesStatus, type ResolveKindValue, type RunDbKindAction, RunResultView, type RunResultViewProps, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, TARGETING_CLASSES, createDbKindComponentCache, describeChangeValue, fieldLabel, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, itemChanges, itemRecordId, kindIsRoutable, provisionalDirectiveSlug, recordFallbackName, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv, useRecordValues };