@ai-matrx/content-ir-react 0.11.10 → 0.12.0

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-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 { C as ContentIrHost, K as KindRouteEnv, a as KindDefinitionSource } from './route-DxK1SoPh.cjs';
+export { b as ContentIrRenderSeams, D as DB_KIND_COMPONENT_KEY, c as DIRECTIVE_BLOCK_TYPE, d as DirectiveApplyResult, e as DirectiveAskRequest, f as DirectiveCopyProps, g as DirectiveHost, h as DirectiveHostProvider, i as DirectiveHostProviderProps, j as DirectiveOpenItemOptions, k as DirectiveRecordProps, l as DirectiveRecordRef, G as GENERIC_STRUCTURED_COMPONENT_KEY, m as GenericFallbackReason, I as IR_PROVISIONAL_KEY, n as IR_ROUTE_KEY, o as IrRenderBlock, p as IrRoutableBlock, q as IrRouteMarker, r as KindRouteBinding, s as KindRouteOptions, P as PartialRenderOptions, t as ProvisionalKindRender, S as StructuredValueRenderProps, u as SupersededKindRender, v as applyIrKindRoute, w as createKindRouteBinding, x as envelopeFromPartialKind, y as isPartialReadyKind, z as isProvisionalBlock, A as kindServerDataFromStoredValue, B as markKindPartialUnsafe, E as readIrRouteMarker, F as resetPartialUnsafeKinds, H as resetSourcelessDbRowReports, J as resolveAnnouncedKindLoading, L as resolveProvisionalKindRender, M as resolveSupersededKindRender, N as routeEnvOf, O as useDirectiveHost } from './route-DxK1SoPh.cjs';
 import * as react from 'react';
 import react__default, { ReactNode, ComponentType } from 'react';
 export { ComponentResolver, ComponentResolverOptions } from './resolver.cjs';
@@ -268,12 +268,73 @@ interface DirectiveFallbackCardProps {
 }
 declare function DirectiveFallbackCard({ directive, reason }: DirectiveFallbackCardProps): react.JSX.Element;
 
+/** The directive slug of a partial document, once its closing quote has arrived. */
+declare function provisionalDirectiveSlug(content: string): string | null;
+interface DirectiveProvisionalCardProps {
+    /** The partial fence body as received so far. */
+    content: string;
+    /**
+     * Whether the document may still be arriving. `false` means the stream is
+     * over and the document never completed — the card says it was cut off.
+     */
+    streaming: boolean;
+    className?: string | undefined;
+}
+declare function DirectiveProvisionalCard({ content, streaming, className }: DirectiveProvisionalCardProps): react.JSX.Element;
+
 interface DirectiveRenderProps {
     /** The fence body (JSON string) or an already-parsed shell / value. */
     content: unknown;
     className?: string;
+    /**
+     * Whether the document may still be arriving. A host that knows its stream
+     * has ended passes `false`, so an undecodable directive head is shown as CUT
+     * OFF rather than "writing…" forever. Omitted = it may still be arriving.
+     */
+    streaming?: boolean;
 }
-declare function DirectiveRender({ content, className }: DirectiveRenderProps): react.JSX.Element;
+declare function DirectiveRender({ content, className, streaming }: 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;
+}
+/**
+ * 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[];
 
 /**
  * The DB-component COMPILE CACHE — session-scoped, keyed per winning row
@@ -538,4 +599,4 @@ declare class DbKindComponentErrorBoundary extends react.Component<DbKindCompone
     render(): react.ReactNode;
 }
 
-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 };
+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 };

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-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 { C as ContentIrHost, K as KindRouteEnv, a as KindDefinitionSource } from './route-JGZfl2nL.js';
+export { b as ContentIrRenderSeams, D as DB_KIND_COMPONENT_KEY, c as DIRECTIVE_BLOCK_TYPE, d as DirectiveApplyResult, e as DirectiveAskRequest, f as DirectiveCopyProps, g as DirectiveHost, h as DirectiveHostProvider, i as DirectiveHostProviderProps, j as DirectiveOpenItemOptions, k as DirectiveRecordProps, l as DirectiveRecordRef, G as GENERIC_STRUCTURED_COMPONENT_KEY, m as GenericFallbackReason, I as IR_PROVISIONAL_KEY, n as IR_ROUTE_KEY, o as IrRenderBlock, p as IrRoutableBlock, q as IrRouteMarker, r as KindRouteBinding, s as KindRouteOptions, P as PartialRenderOptions, t as ProvisionalKindRender, S as StructuredValueRenderProps, u as SupersededKindRender, v as applyIrKindRoute, w as createKindRouteBinding, x as envelopeFromPartialKind, y as isPartialReadyKind, z as isProvisionalBlock, A as kindServerDataFromStoredValue, B as markKindPartialUnsafe, E as readIrRouteMarker, F as resetPartialUnsafeKinds, H as resetSourcelessDbRowReports, J as resolveAnnouncedKindLoading, L as resolveProvisionalKindRender, M as resolveSupersededKindRender, N as routeEnvOf, O as useDirectiveHost } from './route-JGZfl2nL.js';
 import * as react from 'react';
 import react__default, { ReactNode, ComponentType } from 'react';
 export { ComponentResolver, ComponentResolverOptions } from './resolver.js';
@@ -268,12 +268,73 @@ interface DirectiveFallbackCardProps {
 }
 declare function DirectiveFallbackCard({ directive, reason }: DirectiveFallbackCardProps): react.JSX.Element;
 
+/** The directive slug of a partial document, once its closing quote has arrived. */
+declare function provisionalDirectiveSlug(content: string): string | null;
+interface DirectiveProvisionalCardProps {
+    /** The partial fence body as received so far. */
+    content: string;
+    /**
+     * Whether the document may still be arriving. `false` means the stream is
+     * over and the document never completed — the card says it was cut off.
+     */
+    streaming: boolean;
+    className?: string | undefined;
+}
+declare function DirectiveProvisionalCard({ content, streaming, className }: DirectiveProvisionalCardProps): react.JSX.Element;
+
 interface DirectiveRenderProps {
     /** The fence body (JSON string) or an already-parsed shell / value. */
     content: unknown;
     className?: string;
+    /**
+     * Whether the document may still be arriving. A host that knows its stream
+     * has ended passes `false`, so an undecodable directive head is shown as CUT
+     * OFF rather than "writing…" forever. Omitted = it may still be arriving.
+     */
+    streaming?: boolean;
 }
-declare function DirectiveRender({ content, className }: DirectiveRenderProps): react.JSX.Element;
+declare function DirectiveRender({ content, className, streaming }: 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;
+}
+/**
+ * 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[];
 
 /**
  * The DB-component COMPILE CACHE — session-scoped, keyed per winning row
@@ -538,4 +599,4 @@ declare class DbKindComponentErrorBoundary extends react.Component<DbKindCompone
     render(): react.ReactNode;
 }
 
-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 };
+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 };