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

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

@@ -167,6 +167,32 @@ interface DirectiveHost {
     itemKind?: DirectiveItemKindLookup;
     /** Where a decode failure or an unhonourable shell is reported. Default: console.error. */
     reportError?: (message: string) => void;
+    /**
+     * Plain words for a failed apply the host recognises ("This button can't
+     * create a task yet." + "Create it from Tasks instead."). The card never shows
+     * the server's raw text as its sentence: it shows these words — or its own
+     * verb-aware default — and keeps the raw text behind "Details". Return null
+     * to use the default.
+     */
+    explainFailure?: (failure: DirectiveFailure) => DirectiveFailureWords | null;
+}
+/** One failed apply, as the card knows it. */
+interface DirectiveFailure {
+    /** The server's / host's own text — technical; shown only behind Details. */
+    raw: string;
+    directiveClass: string;
+    noun: string;
+    /** The noun's display label ("Task"). */
+    nounLabel: string;
+    /** Items that failed, when some applied and some did not. */
+    failed?: number;
+    /** Items in the block. */
+    total?: number;
+}
+/** What failed and what to do — each one short sentence. */
+interface DirectiveFailureWords {
+    what: string;
+    next: string;
 }
 /** Where a directive renders — today, the conversation it sits in (if any). */
 interface DirectiveScope {
@@ -682,4 +708,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, 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 };
+export { type SupersededKindRender as A, applyIrKindRoute as B, type ContentIrHost as C, type DirectiveFailure as D, createKindRouteBinding as E, envelopeFromPartialKind as F, GENERIC_STRUCTURED_COMPONENT_KEY as G, isPartialReadyKind as H, IR_PROVISIONAL_KEY as I, isProvisionalBlock as J, type KindRouteEnv as K, kindServerDataFromStoredValue as L, markKindPartialUnsafe as M, readIrRouteMarker as N, resetPartialUnsafeKinds as O, type PartialRenderOptions as P, resetSourcelessDbRowReports as Q, resolveAnnouncedKindLoading as R, type StructuredValueRenderProps as S, resolveProvisionalKindRender as T, resolveSupersededKindRender as U, routeEnvOf as V, useDirectiveHost as W, useDirectiveScope as X, type KindDefinitionSource as a, type DirectiveFailureWords as b, type DirectiveRecordRef as c, type ContentIrRenderSeams as d, DB_KIND_COMPONENT_KEY as e, DIRECTIVE_BLOCK_TYPE as f, type DirectiveApplyResult as g, type DirectiveApplyState as h, type DirectiveAskRequest as i, type DirectiveCopyProps as j, type DirectiveHost as k, DirectiveHostProvider as l, type DirectiveHostProviderProps as m, type DirectiveOpenItemOptions as n, type DirectiveRecordProps as o, type DirectiveScope as p, DirectiveScopeProvider as q, type DirectiveShell as r, type GenericFallbackReason as s, IR_ROUTE_KEY as t, type IrRenderBlock as u, type IrRoutableBlock as v, type IrRouteMarker as w, type KindRouteBinding as x, type KindRouteOptions as y, type ProvisionalKindRender as z };

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

@@ -167,6 +167,32 @@ interface DirectiveHost {
     itemKind?: DirectiveItemKindLookup;
     /** Where a decode failure or an unhonourable shell is reported. Default: console.error. */
     reportError?: (message: string) => void;
+    /**
+     * Plain words for a failed apply the host recognises ("This button can't
+     * create a task yet." + "Create it from Tasks instead."). The card never shows
+     * the server's raw text as its sentence: it shows these words — or its own
+     * verb-aware default — and keeps the raw text behind "Details". Return null
+     * to use the default.
+     */
+    explainFailure?: (failure: DirectiveFailure) => DirectiveFailureWords | null;
+}
+/** One failed apply, as the card knows it. */
+interface DirectiveFailure {
+    /** The server's / host's own text — technical; shown only behind Details. */
+    raw: string;
+    directiveClass: string;
+    noun: string;
+    /** The noun's display label ("Task"). */
+    nounLabel: string;
+    /** Items that failed, when some applied and some did not. */
+    failed?: number;
+    /** Items in the block. */
+    total?: number;
+}
+/** What failed and what to do — each one short sentence. */
+interface DirectiveFailureWords {
+    what: string;
+    next: string;
 }
 /** Where a directive renders — today, the conversation it sits in (if any). */
 interface DirectiveScope {
@@ -682,4 +708,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, 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 };
+export { type SupersededKindRender as A, applyIrKindRoute as B, type ContentIrHost as C, type DirectiveFailure as D, createKindRouteBinding as E, envelopeFromPartialKind as F, GENERIC_STRUCTURED_COMPONENT_KEY as G, isPartialReadyKind as H, IR_PROVISIONAL_KEY as I, isProvisionalBlock as J, type KindRouteEnv as K, kindServerDataFromStoredValue as L, markKindPartialUnsafe as M, readIrRouteMarker as N, resetPartialUnsafeKinds as O, type PartialRenderOptions as P, resetSourcelessDbRowReports as Q, resolveAnnouncedKindLoading as R, type StructuredValueRenderProps as S, resolveProvisionalKindRender as T, resolveSupersededKindRender as U, routeEnvOf as V, useDirectiveHost as W, useDirectiveScope as X, type KindDefinitionSource as a, type DirectiveFailureWords as b, type DirectiveRecordRef as c, type ContentIrRenderSeams as d, DB_KIND_COMPONENT_KEY as e, DIRECTIVE_BLOCK_TYPE as f, type DirectiveApplyResult as g, type DirectiveApplyState as h, type DirectiveAskRequest as i, type DirectiveCopyProps as j, type DirectiveHost as k, DirectiveHostProvider as l, type DirectiveHostProviderProps as m, type DirectiveOpenItemOptions as n, type DirectiveRecordProps as o, type DirectiveScope as p, DirectiveScopeProvider as q, type DirectiveShell as r, type GenericFallbackReason as s, IR_ROUTE_KEY as t, type IrRenderBlock as u, type IrRoutableBlock as v, type IrRouteMarker as w, type KindRouteBinding as x, type KindRouteOptions as y, type ProvisionalKindRender as z };

package/dist/route.d.cts

@@ -1,4 +1,4 @@
-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';
+export { e as DB_KIND_COMPONENT_KEY, f as DIRECTIVE_BLOCK_TYPE, G as GENERIC_STRUCTURED_COMPONENT_KEY, s as GenericFallbackReason, I as IR_PROVISIONAL_KEY, t as IR_ROUTE_KEY, w as IrRouteMarker, x as KindRouteBinding, y as KindRouteOptions, P as PartialRenderOptions, z as ProvisionalKindRender, A as SupersededKindRender, B as applyIrKindRoute, E as createKindRouteBinding, F as envelopeFromPartialKind, H as isPartialReadyKind, J as isProvisionalBlock, L as kindServerDataFromStoredValue, M as markKindPartialUnsafe, N as readIrRouteMarker, O as resetPartialUnsafeKinds, Q as resetSourcelessDbRowReports, R as resolveAnnouncedKindLoading, T as resolveProvisionalKindRender, U as resolveSupersededKindRender } from './route-DjGv9skd.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 { 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';
+export { e as DB_KIND_COMPONENT_KEY, f as DIRECTIVE_BLOCK_TYPE, G as GENERIC_STRUCTURED_COMPONENT_KEY, s as GenericFallbackReason, I as IR_PROVISIONAL_KEY, t as IR_ROUTE_KEY, w as IrRouteMarker, x as KindRouteBinding, y as KindRouteOptions, P as PartialRenderOptions, z as ProvisionalKindRender, A as SupersededKindRender, B as applyIrKindRoute, E as createKindRouteBinding, F as envelopeFromPartialKind, H as isPartialReadyKind, J as isProvisionalBlock, L as kindServerDataFromStoredValue, M as markKindPartialUnsafe, N as readIrRouteMarker, O as resetPartialUnsafeKinds, Q as resetSourcelessDbRowReports, R as resolveAnnouncedKindLoading, T as resolveProvisionalKindRender, U as resolveSupersededKindRender } from './route-CfKxIEdj.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.16.0",
+  "version": "0.17.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",
@@ -124,8 +124,8 @@
     "react": ">=19.0.0"
   },
   "dependencies": {
-    "@ai-matrx/content-ir": "latest",
-    "@ai-matrx/kit": "latest"
+    "@ai-matrx/kit": "latest",
+    "@ai-matrx/content-ir": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",