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

package/dist/{route-DDbgc-ID.d.ts → route-De9c5YgW.d.ts}

@@ -33,8 +33,17 @@ interface DirectiveApplyState {
     state: "not_applied" | "in_flight" | "applied";
     /** The ledger row's sentence ("Created task."), never composed client-side. */
     message?: string | null;
-    /** The records the original apply wrote — the tally's doors. */
+    /**
+     * The records the LATEST apply wrote — the tally's doors. After "Run again"
+     * that is the newest copy, never the first.
+     */
     records?: DirectiveRecordRef[];
+    /**
+     * How many times the ledger holds this block as applied: 1 for the original,
+     * one more for every "Run again". Absent → 1. A create that ran twice made
+     * two records, and the card says so (reviewer, 2026-10-02).
+     */
+    copies?: number;
 }
 /** One record a directive names: the noun it is, and its id. */
 interface DirectiveRecordRef {
@@ -133,6 +142,14 @@ interface DirectiveHost {
      * is idempotent. Absent → the card starts at Apply, as before.
      */
     applyState?: (shell: DirectiveShell) => Promise<DirectiveApplyState>;
+    /**
+     * Read the CURRENT values of ONE existing record, so an update says what it
+     * replaces — "Status open → done", never just "→ done" (reviewer,
+     * 2026-10-02). Resolve `null` when the record cannot be read (no access, no
+     * such record, a noun the host cannot read); reject only for a real failure.
+     * Absent → an update row shows the new values alone, as before.
+     */
+    readRecord?: (ref: DirectiveRecordRef) => Promise<Record<string, unknown> | null>;
     /**
      * Draw ONE existing record by its live name, as a way to open it. Used on
      * update/delete rows (the record that will change), in the host's own ask
@@ -665,4 +682,4 @@ interface KindRouteBinding {
 /** Bind the pure routes to one host's env + owned block types. */
 declare function createKindRouteBinding(env: KindRouteEnv, options?: KindRouteOptions): KindRouteBinding;
 
-export { createKindRouteBinding as A, envelopeFromPartialKind as B, type ContentIrHost as C, DB_KIND_COMPONENT_KEY as D, isPartialReadyKind as E, isProvisionalBlock as F, GENERIC_STRUCTURED_COMPONENT_KEY as G, kindServerDataFromStoredValue as H, IR_PROVISIONAL_KEY as I, markKindPartialUnsafe as J, type KindRouteEnv as K, readIrRouteMarker as L, resetPartialUnsafeKinds as M, resetSourcelessDbRowReports as N, resolveAnnouncedKindLoading as O, type PartialRenderOptions as P, resolveProvisionalKindRender as Q, resolveSupersededKindRender as R, type StructuredValueRenderProps as S, routeEnvOf as T, useDirectiveHost as U, useDirectiveScope as V, type KindDefinitionSource as a, type ContentIrRenderSeams as b, DIRECTIVE_BLOCK_TYPE as c, type DirectiveApplyResult as d, type DirectiveApplyState as e, type DirectiveAskRequest as f, type DirectiveCopyProps as g, type DirectiveHost as h, DirectiveHostProvider as i, type DirectiveHostProviderProps as j, type DirectiveOpenItemOptions as k, type DirectiveRecordProps as l, type DirectiveRecordRef as m, type DirectiveScope as n, DirectiveScopeProvider as o, type DirectiveShell as p, type GenericFallbackReason as q, IR_ROUTE_KEY as r, type IrRenderBlock as s, type IrRoutableBlock as t, type IrRouteMarker as u, type KindRouteBinding as v, type KindRouteOptions as w, type ProvisionalKindRender as x, type SupersededKindRender as y, applyIrKindRoute as z };
+export { createKindRouteBinding as A, envelopeFromPartialKind as B, type ContentIrHost as C, type DirectiveRecordRef as D, isPartialReadyKind as E, isProvisionalBlock as F, GENERIC_STRUCTURED_COMPONENT_KEY as G, kindServerDataFromStoredValue as H, IR_PROVISIONAL_KEY as I, markKindPartialUnsafe as J, type KindRouteEnv as K, readIrRouteMarker as L, resetPartialUnsafeKinds as M, resetSourcelessDbRowReports as N, resolveAnnouncedKindLoading as O, type PartialRenderOptions as P, resolveProvisionalKindRender as Q, resolveSupersededKindRender as R, type StructuredValueRenderProps as S, routeEnvOf as T, useDirectiveHost as U, useDirectiveScope as V, type KindDefinitionSource as a, type ContentIrRenderSeams as b, DB_KIND_COMPONENT_KEY as c, DIRECTIVE_BLOCK_TYPE as d, type DirectiveApplyResult as e, type DirectiveApplyState as f, type DirectiveAskRequest as g, type DirectiveCopyProps as h, type DirectiveHost as i, DirectiveHostProvider as j, type DirectiveHostProviderProps as k, type DirectiveOpenItemOptions as l, type DirectiveRecordProps as m, type DirectiveScope as n, DirectiveScopeProvider as o, type DirectiveShell as p, type GenericFallbackReason as q, IR_ROUTE_KEY as r, type IrRenderBlock as s, type IrRoutableBlock as t, type IrRouteMarker as u, type KindRouteBinding as v, type KindRouteOptions as w, type ProvisionalKindRender as x, type SupersededKindRender as y, applyIrKindRoute as z };

package/dist/{route-BCtPhF7W.d.cts → route-YcoyR3Fj.d.cts}

@@ -33,8 +33,17 @@ interface DirectiveApplyState {
     state: "not_applied" | "in_flight" | "applied";
     /** The ledger row's sentence ("Created task."), never composed client-side. */
     message?: string | null;
-    /** The records the original apply wrote — the tally's doors. */
+    /**
+     * The records the LATEST apply wrote — the tally's doors. After "Run again"
+     * that is the newest copy, never the first.
+     */
     records?: DirectiveRecordRef[];
+    /**
+     * How many times the ledger holds this block as applied: 1 for the original,
+     * one more for every "Run again". Absent → 1. A create that ran twice made
+     * two records, and the card says so (reviewer, 2026-10-02).
+     */
+    copies?: number;
 }
 /** One record a directive names: the noun it is, and its id. */
 interface DirectiveRecordRef {
@@ -133,6 +142,14 @@ interface DirectiveHost {
      * is idempotent. Absent → the card starts at Apply, as before.
      */
     applyState?: (shell: DirectiveShell) => Promise<DirectiveApplyState>;
+    /**
+     * Read the CURRENT values of ONE existing record, so an update says what it
+     * replaces — "Status open → done", never just "→ done" (reviewer,
+     * 2026-10-02). Resolve `null` when the record cannot be read (no access, no
+     * such record, a noun the host cannot read); reject only for a real failure.
+     * Absent → an update row shows the new values alone, as before.
+     */
+    readRecord?: (ref: DirectiveRecordRef) => Promise<Record<string, unknown> | null>;
     /**
      * Draw ONE existing record by its live name, as a way to open it. Used on
      * update/delete rows (the record that will change), in the host's own ask
@@ -665,4 +682,4 @@ interface KindRouteBinding {
 /** Bind the pure routes to one host's env + owned block types. */
 declare function createKindRouteBinding(env: KindRouteEnv, options?: KindRouteOptions): KindRouteBinding;
 
-export { createKindRouteBinding as A, envelopeFromPartialKind as B, type ContentIrHost as C, DB_KIND_COMPONENT_KEY as D, isPartialReadyKind as E, isProvisionalBlock as F, GENERIC_STRUCTURED_COMPONENT_KEY as G, kindServerDataFromStoredValue as H, IR_PROVISIONAL_KEY as I, markKindPartialUnsafe as J, type KindRouteEnv as K, readIrRouteMarker as L, resetPartialUnsafeKinds as M, resetSourcelessDbRowReports as N, resolveAnnouncedKindLoading as O, type PartialRenderOptions as P, resolveProvisionalKindRender as Q, resolveSupersededKindRender as R, type StructuredValueRenderProps as S, routeEnvOf as T, useDirectiveHost as U, useDirectiveScope as V, type KindDefinitionSource as a, type ContentIrRenderSeams as b, DIRECTIVE_BLOCK_TYPE as c, type DirectiveApplyResult as d, type DirectiveApplyState as e, type DirectiveAskRequest as f, type DirectiveCopyProps as g, type DirectiveHost as h, DirectiveHostProvider as i, type DirectiveHostProviderProps as j, type DirectiveOpenItemOptions as k, type DirectiveRecordProps as l, type DirectiveRecordRef as m, type DirectiveScope as n, DirectiveScopeProvider as o, type DirectiveShell as p, type GenericFallbackReason as q, IR_ROUTE_KEY as r, type IrRenderBlock as s, type IrRoutableBlock as t, type IrRouteMarker as u, type KindRouteBinding as v, type KindRouteOptions as w, type ProvisionalKindRender as x, type SupersededKindRender as y, applyIrKindRoute as z };
+export { createKindRouteBinding as A, envelopeFromPartialKind as B, type ContentIrHost as C, type DirectiveRecordRef as D, isPartialReadyKind as E, isProvisionalBlock as F, GENERIC_STRUCTURED_COMPONENT_KEY as G, kindServerDataFromStoredValue as H, IR_PROVISIONAL_KEY as I, markKindPartialUnsafe as J, type KindRouteEnv as K, readIrRouteMarker as L, resetPartialUnsafeKinds as M, resetSourcelessDbRowReports as N, resolveAnnouncedKindLoading as O, type PartialRenderOptions as P, resolveProvisionalKindRender as Q, resolveSupersededKindRender as R, type StructuredValueRenderProps as S, routeEnvOf as T, useDirectiveHost as U, useDirectiveScope as V, type KindDefinitionSource as a, type ContentIrRenderSeams as b, DB_KIND_COMPONENT_KEY as c, DIRECTIVE_BLOCK_TYPE as d, type DirectiveApplyResult as e, type DirectiveApplyState as f, type DirectiveAskRequest as g, type DirectiveCopyProps as h, type DirectiveHost as i, DirectiveHostProvider as j, type DirectiveHostProviderProps as k, type DirectiveOpenItemOptions as l, type DirectiveRecordProps as m, type DirectiveScope as n, DirectiveScopeProvider as o, type DirectiveShell as p, type GenericFallbackReason as q, IR_ROUTE_KEY as r, type IrRenderBlock as s, type IrRoutableBlock as t, type IrRouteMarker as u, type KindRouteBinding as v, type KindRouteOptions as w, type ProvisionalKindRender as x, type SupersededKindRender as y, applyIrKindRoute as z };

package/dist/route.d.cts

@@ -1,4 +1,4 @@
-export { D as DB_KIND_COMPONENT_KEY, c as DIRECTIVE_BLOCK_TYPE, G as GENERIC_STRUCTURED_COMPONENT_KEY, q as GenericFallbackReason, I as IR_PROVISIONAL_KEY, r as IR_ROUTE_KEY, u as IrRouteMarker, v as KindRouteBinding, w as KindRouteOptions, P as PartialRenderOptions, x as ProvisionalKindRender, 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 } from './route-BCtPhF7W.cjs';
+export { c as DB_KIND_COMPONENT_KEY, d as DIRECTIVE_BLOCK_TYPE, G as GENERIC_STRUCTURED_COMPONENT_KEY, q as GenericFallbackReason, I as IR_PROVISIONAL_KEY, r as IR_ROUTE_KEY, u as IrRouteMarker, v as KindRouteBinding, w as KindRouteOptions, P as PartialRenderOptions, x as ProvisionalKindRender, 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 } from './route-YcoyR3Fj.cjs';
 import './component-resolution.types-DLO2w-0n.cjs';
 import 'react';
 import '@ai-matrx/content-ir';

package/dist/route.d.ts

@@ -1,4 +1,4 @@
-export { D as DB_KIND_COMPONENT_KEY, c as DIRECTIVE_BLOCK_TYPE, G as GENERIC_STRUCTURED_COMPONENT_KEY, q as GenericFallbackReason, I as IR_PROVISIONAL_KEY, r as IR_ROUTE_KEY, u as IrRouteMarker, v as KindRouteBinding, w as KindRouteOptions, P as PartialRenderOptions, x as ProvisionalKindRender, 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 } from './route-DDbgc-ID.js';
+export { c as DB_KIND_COMPONENT_KEY, d as DIRECTIVE_BLOCK_TYPE, G as GENERIC_STRUCTURED_COMPONENT_KEY, q as GenericFallbackReason, I as IR_PROVISIONAL_KEY, r as IR_ROUTE_KEY, u as IrRouteMarker, v as KindRouteBinding, w as KindRouteOptions, P as PartialRenderOptions, x as ProvisionalKindRender, 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 } from './route-De9c5YgW.js';
 import './component-resolution.types-DLO2w-0n.js';
 import 'react';
 import '@ai-matrx/content-ir';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/content-ir-react",
-  "version": "0.15.2",
+  "version": "0.16.0",
   "description": "The shared AI Matrx Content IR RENDER layer: kind routing, the component resolver, provisional (streaming) rendering, the runtime-wrapper chrome, and the generic structured floor — as portable React.",
   "type": "module",
   "main": "./dist/index.cjs",