@ai-matrx/content-ir-react 0.11.11 → 0.12.1

package/dist/{route-B9U-9QCw.d.cts → route-DxK1SoPh.d.cts}

@@ -6,6 +6,43 @@ import { DecodedDirective, DirectiveNounCatalog, DirectiveItemKindLookup, KindDe
 interface DirectiveApplyResult {
     applied: number;
     failed: number;
+    /**
+     * The server's own receipt sentence ("Deleted task “Ship it”."), shown in
+     * place of a bare count. Never composed client-side.
+     */
+    message?: string | null;
+    /**
+     * The records the apply created or changed, so the tally is a way IN to them
+     * (no dead ends). Rendered through `renderRecord`; absent → the sentence alone.
+     */
+    records?: DirectiveRecordRef[];
+}
+/** One record a directive names: the noun it is, and its id. */
+interface DirectiveRecordRef {
+    noun: string;
+    id: string;
+}
+interface DirectiveRecordProps extends DirectiveRecordRef {
+    /**
+     * What to show until (or unless) the host resolves the live name —
+     * "Task 1a2b3c4d". Never blank, never "Item".
+     */
+    fallback: string;
+    /** Where it is drawn: an item row, the confirm dialog, or the applied tally. */
+    context: "row" | "dialog" | "applied";
+    /**
+     * True when the record is (about to be) in the trash — the host may still
+     * name it but should not promise it opens as a live record.
+     */
+    trashed?: boolean;
+}
+/** What the person is being asked to approve — everything the card knows. */
+interface DirectiveAskRequest {
+    directive: DecodedDirective;
+    /** The items, exactly as they will be sent. */
+    items: Record<string, unknown>[];
+    /** The noun's human label ("Task"), from the host's catalog when it has one. */
+    nounLabel: string;
 }
 interface DirectiveOpenItemOptions {
     /** The item, `__kind`-stamped when the shape has an item kind. */
@@ -38,6 +75,22 @@ interface DirectiveHost {
         __kind: string;
         items: Record<string, unknown>[];
     }) => Promise<DirectiveApplyResult>;
+    /**
+     * Ask the person BEFORE anything runs, naming the consequence (the records,
+     * what changes). Resolve `true` to go ahead, `false` to leave the card as it
+     * was. The Apply control stays idle while this is open — nothing reads as
+     * "applying" until the person has said yes. Absent → `confirm` is called
+     * directly (a host that asks inside `confirm` keeps working, but its card
+     * will read "Applying…" while its dialog is up).
+     */
+    ask?: (request: DirectiveAskRequest) => Promise<boolean>;
+    /**
+     * 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
+     * dialog if it likes, and on the applied tally (what was written). Absent →
+     * the fallback text, unlinked.
+     */
+    renderRecord?: (props: DirectiveRecordProps) => ReactNode;
     /** Open ONE item to read it properly before approving the write. */
     openItem?: (options: DirectiveOpenItemOptions) => void;
     /** Host copy controls. */
@@ -549,4 +602,4 @@ interface KindRouteBinding {
 /** Bind the pure routes to one host's env + owned block types. */
 declare function createKindRouteBinding(env: KindRouteEnv, options?: KindRouteOptions): KindRouteBinding;
 
-export { resetPartialUnsafeKinds as A, resetSourcelessDbRowReports as B, type ContentIrHost as C, DB_KIND_COMPONENT_KEY as D, resolveAnnouncedKindLoading as E, resolveProvisionalKindRender as F, GENERIC_STRUCTURED_COMPONENT_KEY as G, resolveSupersededKindRender as H, IR_PROVISIONAL_KEY as I, routeEnvOf as J, type KindRouteEnv as K, useDirectiveHost as L, 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 DirectiveCopyProps as e, type DirectiveHost as f, DirectiveHostProvider as g, type DirectiveHostProviderProps as h, type DirectiveOpenItemOptions as i, type GenericFallbackReason as j, IR_ROUTE_KEY as k, type IrRenderBlock as l, type IrRoutableBlock as m, type IrRouteMarker as n, type KindRouteBinding as o, type KindRouteOptions as p, type ProvisionalKindRender as q, type SupersededKindRender as r, applyIrKindRoute as s, createKindRouteBinding as t, envelopeFromPartialKind as u, isPartialReadyKind as v, isProvisionalBlock as w, kindServerDataFromStoredValue as x, markKindPartialUnsafe as y, readIrRouteMarker as z };
+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 };

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

@@ -6,6 +6,43 @@ import { DecodedDirective, DirectiveNounCatalog, DirectiveItemKindLookup, KindDe
 interface DirectiveApplyResult {
     applied: number;
     failed: number;
+    /**
+     * The server's own receipt sentence ("Deleted task “Ship it”."), shown in
+     * place of a bare count. Never composed client-side.
+     */
+    message?: string | null;
+    /**
+     * The records the apply created or changed, so the tally is a way IN to them
+     * (no dead ends). Rendered through `renderRecord`; absent → the sentence alone.
+     */
+    records?: DirectiveRecordRef[];
+}
+/** One record a directive names: the noun it is, and its id. */
+interface DirectiveRecordRef {
+    noun: string;
+    id: string;
+}
+interface DirectiveRecordProps extends DirectiveRecordRef {
+    /**
+     * What to show until (or unless) the host resolves the live name —
+     * "Task 1a2b3c4d". Never blank, never "Item".
+     */
+    fallback: string;
+    /** Where it is drawn: an item row, the confirm dialog, or the applied tally. */
+    context: "row" | "dialog" | "applied";
+    /**
+     * True when the record is (about to be) in the trash — the host may still
+     * name it but should not promise it opens as a live record.
+     */
+    trashed?: boolean;
+}
+/** What the person is being asked to approve — everything the card knows. */
+interface DirectiveAskRequest {
+    directive: DecodedDirective;
+    /** The items, exactly as they will be sent. */
+    items: Record<string, unknown>[];
+    /** The noun's human label ("Task"), from the host's catalog when it has one. */
+    nounLabel: string;
 }
 interface DirectiveOpenItemOptions {
     /** The item, `__kind`-stamped when the shape has an item kind. */
@@ -38,6 +75,22 @@ interface DirectiveHost {
         __kind: string;
         items: Record<string, unknown>[];
     }) => Promise<DirectiveApplyResult>;
+    /**
+     * Ask the person BEFORE anything runs, naming the consequence (the records,
+     * what changes). Resolve `true` to go ahead, `false` to leave the card as it
+     * was. The Apply control stays idle while this is open — nothing reads as
+     * "applying" until the person has said yes. Absent → `confirm` is called
+     * directly (a host that asks inside `confirm` keeps working, but its card
+     * will read "Applying…" while its dialog is up).
+     */
+    ask?: (request: DirectiveAskRequest) => Promise<boolean>;
+    /**
+     * 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
+     * dialog if it likes, and on the applied tally (what was written). Absent →
+     * the fallback text, unlinked.
+     */
+    renderRecord?: (props: DirectiveRecordProps) => ReactNode;
     /** Open ONE item to read it properly before approving the write. */
     openItem?: (options: DirectiveOpenItemOptions) => void;
     /** Host copy controls. */
@@ -549,4 +602,4 @@ interface KindRouteBinding {
 /** Bind the pure routes to one host's env + owned block types. */
 declare function createKindRouteBinding(env: KindRouteEnv, options?: KindRouteOptions): KindRouteBinding;
 
-export { resetPartialUnsafeKinds as A, resetSourcelessDbRowReports as B, type ContentIrHost as C, DB_KIND_COMPONENT_KEY as D, resolveAnnouncedKindLoading as E, resolveProvisionalKindRender as F, GENERIC_STRUCTURED_COMPONENT_KEY as G, resolveSupersededKindRender as H, IR_PROVISIONAL_KEY as I, routeEnvOf as J, type KindRouteEnv as K, useDirectiveHost as L, 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 DirectiveCopyProps as e, type DirectiveHost as f, DirectiveHostProvider as g, type DirectiveHostProviderProps as h, type DirectiveOpenItemOptions as i, type GenericFallbackReason as j, IR_ROUTE_KEY as k, type IrRenderBlock as l, type IrRoutableBlock as m, type IrRouteMarker as n, type KindRouteBinding as o, type KindRouteOptions as p, type ProvisionalKindRender as q, type SupersededKindRender as r, applyIrKindRoute as s, createKindRouteBinding as t, envelopeFromPartialKind as u, isPartialReadyKind as v, isProvisionalBlock as w, kindServerDataFromStoredValue as x, markKindPartialUnsafe as y, readIrRouteMarker as z };
+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 };

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, j as GenericFallbackReason, I as IR_PROVISIONAL_KEY, k as IR_ROUTE_KEY, n as IrRouteMarker, o as KindRouteBinding, p as KindRouteOptions, P as PartialRenderOptions, q as ProvisionalKindRender, 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 } from './route-B9U-9QCw.cjs';
+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';
 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, j as GenericFallbackReason, I as IR_PROVISIONAL_KEY, k as IR_ROUTE_KEY, n as IrRouteMarker, o as KindRouteBinding, p as KindRouteOptions, P as PartialRenderOptions, q as ProvisionalKindRender, 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 } from './route-gNpJ8zzW.js';
+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';
 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.11.11",
+  "version": "0.12.1",
   "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",
@@ -124,7 +124,8 @@
     "react": ">=19.0.0"
   },
   "dependencies": {
-    "@ai-matrx/content-ir": "latest"
+    "@ai-matrx/content-ir": "latest",
+    "@ai-matrx/kit": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",

package/dist/directive-host-DAb7Keg8.d.cts

@@ -1,63 +0,0 @@
-import * as react from 'react';
-import { ReactNode } from 'react';
-import { DecodedDirective, DirectiveNounCatalog, DirectiveItemKindLookup } from '@ai-matrx/content-ir';
-
-interface DirectiveApplyResult {
-    applied: number;
-    failed: number;
-}
-interface DirectiveOpenItemOptions {
-    /** The item, `__kind`-stamped when the shape has an item kind. */
-    item: Record<string, unknown>;
-    /** The content-IR kind this item IS, or null when the shape has none. */
-    itemKind: string | null;
-    /** What the item is called — the same title the card shows. */
-    title: string;
-    /** "Run Create agent definition · item 1 of 1". */
-    subtitle: string | null;
-    directive: DecodedDirective;
-    index: number;
-    total: number;
-}
-interface DirectiveCopyProps {
-    label: string;
-    /** The value to copy — the whole shell or one item. */
-    value: unknown;
-    /** The item's kind, when copying an item. */
-    kind?: string | null;
-    size: "icon" | "xs";
-}
-interface DirectiveHost {
-    /**
-     * Apply a side-effect directive as the user (the server re-validates every
-     * item against the registered model and runs the ONE handler; idempotent).
-     * Reject with an Error whose message is safe to show.
-     */
-    confirm?: (shell: {
-        __kind: string;
-        items: Record<string, unknown>[];
-    }) => Promise<DirectiveApplyResult>;
-    /** Open ONE item to read it properly before approving the write. */
-    openItem?: (options: DirectiveOpenItemOptions) => void;
-    /** Host copy controls. */
-    renderCopy?: (props: DirectiveCopyProps) => ReactNode;
-    /** The mirrored noun catalog (label / family / title column). */
-    nouns?: DirectiveNounCatalog;
-    /** slug → the kind ONE item is (THE DIRECTIVE⇄KIND SEAM), or null. */
-    itemKind?: DirectiveItemKindLookup;
-    /** Where a decode failure or an unhonourable shell is reported. Default: console.error. */
-    reportError?: (message: string) => void;
-}
-interface DirectiveHostProviderProps {
-    host: DirectiveHost;
-    children: ReactNode;
-}
-declare function DirectiveHostProvider({ host, children }: DirectiveHostProviderProps): react.JSX.Element;
-/**
- * The wired directive host. Unlike the render host this does NOT throw when
- * unwired: a directive still renders (named, itemised, copy-less, apply-less)
- * — degrading the chrome is honest, hiding the content is not.
- */
-declare function useDirectiveHost(): DirectiveHost;
-
-export { type DirectiveApplyResult as D, type DirectiveCopyProps as a, type DirectiveHost as b, DirectiveHostProvider as c, type DirectiveHostProviderProps as d, type DirectiveOpenItemOptions as e, useDirectiveHost as u };

package/dist/directive-host-DAb7Keg8.d.ts

@@ -1,63 +0,0 @@
-import * as react from 'react';
-import { ReactNode } from 'react';
-import { DecodedDirective, DirectiveNounCatalog, DirectiveItemKindLookup } from '@ai-matrx/content-ir';
-
-interface DirectiveApplyResult {
-    applied: number;
-    failed: number;
-}
-interface DirectiveOpenItemOptions {
-    /** The item, `__kind`-stamped when the shape has an item kind. */
-    item: Record<string, unknown>;
-    /** The content-IR kind this item IS, or null when the shape has none. */
-    itemKind: string | null;
-    /** What the item is called — the same title the card shows. */
-    title: string;
-    /** "Run Create agent definition · item 1 of 1". */
-    subtitle: string | null;
-    directive: DecodedDirective;
-    index: number;
-    total: number;
-}
-interface DirectiveCopyProps {
-    label: string;
-    /** The value to copy — the whole shell or one item. */
-    value: unknown;
-    /** The item's kind, when copying an item. */
-    kind?: string | null;
-    size: "icon" | "xs";
-}
-interface DirectiveHost {
-    /**
-     * Apply a side-effect directive as the user (the server re-validates every
-     * item against the registered model and runs the ONE handler; idempotent).
-     * Reject with an Error whose message is safe to show.
-     */
-    confirm?: (shell: {
-        __kind: string;
-        items: Record<string, unknown>[];
-    }) => Promise<DirectiveApplyResult>;
-    /** Open ONE item to read it properly before approving the write. */
-    openItem?: (options: DirectiveOpenItemOptions) => void;
-    /** Host copy controls. */
-    renderCopy?: (props: DirectiveCopyProps) => ReactNode;
-    /** The mirrored noun catalog (label / family / title column). */
-    nouns?: DirectiveNounCatalog;
-    /** slug → the kind ONE item is (THE DIRECTIVE⇄KIND SEAM), or null. */
-    itemKind?: DirectiveItemKindLookup;
-    /** Where a decode failure or an unhonourable shell is reported. Default: console.error. */
-    reportError?: (message: string) => void;
-}
-interface DirectiveHostProviderProps {
-    host: DirectiveHost;
-    children: ReactNode;
-}
-declare function DirectiveHostProvider({ host, children }: DirectiveHostProviderProps): react.JSX.Element;
-/**
- * The wired directive host. Unlike the render host this does NOT throw when
- * unwired: a directive still renders (named, itemised, copy-less, apply-less)
- * — degrading the chrome is honest, hiding the content is not.
- */
-declare function useDirectiveHost(): DirectiveHost;
-
-export { type DirectiveApplyResult as D, type DirectiveCopyProps as a, type DirectiveHost as b, DirectiveHostProvider as c, type DirectiveHostProviderProps as d, type DirectiveOpenItemOptions as e, useDirectiveHost as u };