@ai-matrx/content-ir-react 0.13.17 → 0.14.0

package/dist/{route-DxK1SoPh.d.cts → route-Bf-kciHw.d.cts}

@@ -17,6 +17,25 @@ interface DirectiveApplyResult {
      */
     records?: DirectiveRecordRef[];
 }
+/**
+ * What the server's action ledger says about ONE block, read on mount so a
+ * reloaded page never offers "Apply" for work that already ran (reviewer
+ * defect 5, 2026-10-02).
+ *
+ *  - `not_applied` — still to do (or partly done: the batch re-applies, and the
+ *    server replays the members it already holds). The card offers Apply.
+ *  - `in_flight` — another request is applying it right now. The card says it
+ *    is finishing and asks again shortly; it offers neither Apply nor a tally.
+ *  - `applied` — the ledger holds every item. The card shows the tally exactly
+ *    as a fresh apply would: the ledger's own sentence and the records, as doors.
+ */
+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. */
+    records?: DirectiveRecordRef[];
+}
 /** One record a directive names: the noun it is, and its id. */
 interface DirectiveRecordRef {
     noun: string;
@@ -84,6 +103,20 @@ interface DirectiveHost {
      * will read "Applying…" while its dialog is up).
      */
     ask?: (request: DirectiveAskRequest) => Promise<boolean>;
+    /**
+     * Has this exact block already been applied? Read ONCE when the card mounts
+     * (and again while the answer is `in_flight`), so the card survives a reload:
+     * the server ledger, not component state, is what knows. The identity is the
+     * server's (it hashes the validated items in the same namespace `confirm`
+     * applies in), so a host asks — it never computes. Batch on the host side if
+     * a page carries many cards. Reject with an Error when the ledger cannot be
+     * read: the card reports it and offers Apply, which is safe because `confirm`
+     * is idempotent. Absent → the card starts at Apply, as before.
+     */
+    applyState?: (shell: {
+        __kind: string;
+        items: Record<string, unknown>[];
+    }) => Promise<DirectiveApplyState>;
     /**
      * 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
@@ -602,4 +635,4 @@ interface KindRouteBinding {
 /** Bind the pure routes to one host's env + owned block types. */
 declare function createKindRouteBinding(env: KindRouteEnv, options?: KindRouteOptions): KindRouteBinding;
 
-export { kindServerDataFromStoredValue as A, markKindPartialUnsafe as B, type ContentIrHost as C, DB_KIND_COMPONENT_KEY as D, readIrRouteMarker as E, resetPartialUnsafeKinds as F, GENERIC_STRUCTURED_COMPONENT_KEY as G, resetSourcelessDbRowReports as H, IR_PROVISIONAL_KEY as I, resolveAnnouncedKindLoading as J, type KindRouteEnv as K, resolveProvisionalKindRender as L, resolveSupersededKindRender as M, routeEnvOf as N, useDirectiveHost as O, type PartialRenderOptions as P, type StructuredValueRenderProps as S, type KindDefinitionSource as a, type ContentIrRenderSeams as b, DIRECTIVE_BLOCK_TYPE as c, type DirectiveApplyResult as d, type DirectiveAskRequest as e, type DirectiveCopyProps as f, type DirectiveHost as g, DirectiveHostProvider as h, type DirectiveHostProviderProps as i, type DirectiveOpenItemOptions as j, type DirectiveRecordProps as k, type DirectiveRecordRef as l, type GenericFallbackReason as m, IR_ROUTE_KEY as n, type IrRenderBlock as o, type IrRoutableBlock as p, type IrRouteMarker as q, type KindRouteBinding as r, type KindRouteOptions as s, type ProvisionalKindRender as t, type SupersededKindRender as u, applyIrKindRoute as v, createKindRouteBinding as w, envelopeFromPartialKind as x, isPartialReadyKind as y, isProvisionalBlock as z };
+export { isProvisionalBlock as A, kindServerDataFromStoredValue as B, type ContentIrHost as C, DB_KIND_COMPONENT_KEY as D, markKindPartialUnsafe as E, readIrRouteMarker as F, GENERIC_STRUCTURED_COMPONENT_KEY as G, resetPartialUnsafeKinds as H, IR_PROVISIONAL_KEY as I, resetSourcelessDbRowReports as J, type KindRouteEnv as K, resolveAnnouncedKindLoading as L, resolveProvisionalKindRender as M, resolveSupersededKindRender as N, routeEnvOf as O, type PartialRenderOptions as P, useDirectiveHost as Q, type StructuredValueRenderProps as S, 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 GenericFallbackReason as n, IR_ROUTE_KEY as o, type IrRenderBlock as p, type IrRoutableBlock as q, type IrRouteMarker as r, type KindRouteBinding as s, type KindRouteOptions as t, type ProvisionalKindRender as u, type SupersededKindRender as v, applyIrKindRoute as w, createKindRouteBinding as x, envelopeFromPartialKind as y, isPartialReadyKind as z };

package/dist/{route-JGZfl2nL.d.ts → route-ymqupVjr.d.ts}

@@ -17,6 +17,25 @@ interface DirectiveApplyResult {
      */
     records?: DirectiveRecordRef[];
 }
+/**
+ * What the server's action ledger says about ONE block, read on mount so a
+ * reloaded page never offers "Apply" for work that already ran (reviewer
+ * defect 5, 2026-10-02).
+ *
+ *  - `not_applied` — still to do (or partly done: the batch re-applies, and the
+ *    server replays the members it already holds). The card offers Apply.
+ *  - `in_flight` — another request is applying it right now. The card says it
+ *    is finishing and asks again shortly; it offers neither Apply nor a tally.
+ *  - `applied` — the ledger holds every item. The card shows the tally exactly
+ *    as a fresh apply would: the ledger's own sentence and the records, as doors.
+ */
+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. */
+    records?: DirectiveRecordRef[];
+}
 /** One record a directive names: the noun it is, and its id. */
 interface DirectiveRecordRef {
     noun: string;
@@ -84,6 +103,20 @@ interface DirectiveHost {
      * will read "Applying…" while its dialog is up).
      */
     ask?: (request: DirectiveAskRequest) => Promise<boolean>;
+    /**
+     * Has this exact block already been applied? Read ONCE when the card mounts
+     * (and again while the answer is `in_flight`), so the card survives a reload:
+     * the server ledger, not component state, is what knows. The identity is the
+     * server's (it hashes the validated items in the same namespace `confirm`
+     * applies in), so a host asks — it never computes. Batch on the host side if
+     * a page carries many cards. Reject with an Error when the ledger cannot be
+     * read: the card reports it and offers Apply, which is safe because `confirm`
+     * is idempotent. Absent → the card starts at Apply, as before.
+     */
+    applyState?: (shell: {
+        __kind: string;
+        items: Record<string, unknown>[];
+    }) => Promise<DirectiveApplyState>;
     /**
      * 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
@@ -602,4 +635,4 @@ interface KindRouteBinding {
 /** Bind the pure routes to one host's env + owned block types. */
 declare function createKindRouteBinding(env: KindRouteEnv, options?: KindRouteOptions): KindRouteBinding;
 
-export { kindServerDataFromStoredValue as A, markKindPartialUnsafe as B, type ContentIrHost as C, DB_KIND_COMPONENT_KEY as D, readIrRouteMarker as E, resetPartialUnsafeKinds as F, GENERIC_STRUCTURED_COMPONENT_KEY as G, resetSourcelessDbRowReports as H, IR_PROVISIONAL_KEY as I, resolveAnnouncedKindLoading as J, type KindRouteEnv as K, resolveProvisionalKindRender as L, resolveSupersededKindRender as M, routeEnvOf as N, useDirectiveHost as O, type PartialRenderOptions as P, type StructuredValueRenderProps as S, type KindDefinitionSource as a, type ContentIrRenderSeams as b, DIRECTIVE_BLOCK_TYPE as c, type DirectiveApplyResult as d, type DirectiveAskRequest as e, type DirectiveCopyProps as f, type DirectiveHost as g, DirectiveHostProvider as h, type DirectiveHostProviderProps as i, type DirectiveOpenItemOptions as j, type DirectiveRecordProps as k, type DirectiveRecordRef as l, type GenericFallbackReason as m, IR_ROUTE_KEY as n, type IrRenderBlock as o, type IrRoutableBlock as p, type IrRouteMarker as q, type KindRouteBinding as r, type KindRouteOptions as s, type ProvisionalKindRender as t, type SupersededKindRender as u, applyIrKindRoute as v, createKindRouteBinding as w, envelopeFromPartialKind as x, isPartialReadyKind as y, isProvisionalBlock as z };
+export { isProvisionalBlock as A, kindServerDataFromStoredValue as B, type ContentIrHost as C, DB_KIND_COMPONENT_KEY as D, markKindPartialUnsafe as E, readIrRouteMarker as F, GENERIC_STRUCTURED_COMPONENT_KEY as G, resetPartialUnsafeKinds as H, IR_PROVISIONAL_KEY as I, resetSourcelessDbRowReports as J, type KindRouteEnv as K, resolveAnnouncedKindLoading as L, resolveProvisionalKindRender as M, resolveSupersededKindRender as N, routeEnvOf as O, type PartialRenderOptions as P, useDirectiveHost as Q, type StructuredValueRenderProps as S, 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 GenericFallbackReason as n, IR_ROUTE_KEY as o, type IrRenderBlock as p, type IrRoutableBlock as q, type IrRouteMarker as r, type KindRouteBinding as s, type KindRouteOptions as t, type ProvisionalKindRender as u, type SupersededKindRender as v, applyIrKindRoute as w, createKindRouteBinding as x, envelopeFromPartialKind as y, isPartialReadyKind 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, m as GenericFallbackReason, I as IR_PROVISIONAL_KEY, n as IR_ROUTE_KEY, q as IrRouteMarker, r as KindRouteBinding, s as KindRouteOptions, P as PartialRenderOptions, t as ProvisionalKindRender, 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 } from './route-DxK1SoPh.cjs';
+export { D as DB_KIND_COMPONENT_KEY, c as DIRECTIVE_BLOCK_TYPE, G as GENERIC_STRUCTURED_COMPONENT_KEY, n as GenericFallbackReason, I as IR_PROVISIONAL_KEY, o as IR_ROUTE_KEY, r as IrRouteMarker, s as KindRouteBinding, t as KindRouteOptions, P as PartialRenderOptions, u as ProvisionalKindRender, v as SupersededKindRender, w as applyIrKindRoute, x as createKindRouteBinding, y as envelopeFromPartialKind, z as isPartialReadyKind, A as isProvisionalBlock, B as kindServerDataFromStoredValue, E as markKindPartialUnsafe, F as readIrRouteMarker, H as resetPartialUnsafeKinds, J as resetSourcelessDbRowReports, L as resolveAnnouncedKindLoading, M as resolveProvisionalKindRender, N as resolveSupersededKindRender } from './route-Bf-kciHw.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, m as GenericFallbackReason, I as IR_PROVISIONAL_KEY, n as IR_ROUTE_KEY, q as IrRouteMarker, r as KindRouteBinding, s as KindRouteOptions, P as PartialRenderOptions, t as ProvisionalKindRender, 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 } from './route-JGZfl2nL.js';
+export { D as DB_KIND_COMPONENT_KEY, c as DIRECTIVE_BLOCK_TYPE, G as GENERIC_STRUCTURED_COMPONENT_KEY, n as GenericFallbackReason, I as IR_PROVISIONAL_KEY, o as IR_ROUTE_KEY, r as IrRouteMarker, s as KindRouteBinding, t as KindRouteOptions, P as PartialRenderOptions, u as ProvisionalKindRender, v as SupersededKindRender, w as applyIrKindRoute, x as createKindRouteBinding, y as envelopeFromPartialKind, z as isPartialReadyKind, A as isProvisionalBlock, B as kindServerDataFromStoredValue, E as markKindPartialUnsafe, F as readIrRouteMarker, H as resetPartialUnsafeKinds, J as resetSourcelessDbRowReports, L as resolveAnnouncedKindLoading, M as resolveProvisionalKindRender, N as resolveSupersededKindRender } from './route-ymqupVjr.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.13.17",
+  "version": "0.14.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",