@ai-matrx/content-ir-react 0.19.1 → 0.20.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -122,7 +122,14 @@ interface DirectiveOpenItemOptions {
122
122
  total: number;
123
123
  }
124
124
  interface DirectiveCopyProps {
125
+ /**
126
+ * What the control is called to a screen reader. Never an id: for a record it
127
+ * is type-generic ("this task"); a host with the record's live name replaces
128
+ * it through `record`.
129
+ */
125
130
  label: string;
131
+ /** The existing record this control copies, when it copies one — to name it. */
132
+ record?: DirectiveRecordRef;
126
133
  /** The value to copy — the whole shell or one item. */
127
134
  value: unknown;
128
135
  /** The item's kind, when copying an item. */
@@ -175,6 +182,15 @@ interface DirectiveHost {
175
182
  openItem?: (options: DirectiveOpenItemOptions) => void;
176
183
  /** Host copy controls. */
177
184
  renderCopy?: (props: DirectiveCopyProps) => ReactNode;
185
+ /**
186
+ * The app's word for one stored value of one pick-list field — the SAME word
187
+ * the record's own screens and the write forms show ("incomplete" on a task
188
+ * reads "Inbox"). One value, one display word everywhere (G8A review,
189
+ * 2026-10-02: the card said "Status incomplete → completed"). Return null for
190
+ * a field that is not a pick-list: its value is shown as written. Absent →
191
+ * every value is shown as stored.
192
+ */
193
+ valueLabel?: (ref: DirectiveValueRef) => string | null;
178
194
  /** The mirrored noun catalog (label / family / title column). */
179
195
  nouns?: DirectiveNounCatalog;
180
196
  /** slug → the kind ONE item is (THE DIRECTIVE⇄KIND SEAM), or null. */
@@ -190,6 +206,12 @@ interface DirectiveHost {
190
206
  */
191
207
  explainFailure?: (failure: DirectiveFailure) => DirectiveFailureWords | null;
192
208
  }
209
+ /** One stored value of one field of one record type. */
210
+ interface DirectiveValueRef {
211
+ noun: string;
212
+ field: string;
213
+ value: string;
214
+ }
193
215
  /** One failed apply, as the card knows it. */
194
216
  interface DirectiveFailure {
195
217
  /** The server's / host's own text — technical; shown only behind Details. */
@@ -722,4 +744,4 @@ interface KindRouteBinding {
722
744
  /** Bind the pure routes to one host's env + owned block types. */
723
745
  declare function createKindRouteBinding(env: KindRouteEnv, options?: KindRouteOptions): KindRouteBinding;
724
746
 
725
- 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 };
747
+ export { type ProvisionalKindRender as A, type SupersededKindRender as B, type ContentIrHost as C, type DirectiveHost as D, applyIrKindRoute as E, createKindRouteBinding as F, GENERIC_STRUCTURED_COMPONENT_KEY as G, envelopeFromPartialKind as H, IR_PROVISIONAL_KEY as I, isPartialReadyKind as J, type KindRouteEnv as K, isProvisionalBlock as L, kindServerDataFromStoredValue as M, markKindPartialUnsafe as N, readIrRouteMarker as O, type PartialRenderOptions as P, resetPartialUnsafeKinds as Q, resetSourcelessDbRowReports as R, type StructuredValueRenderProps as S, resolveAnnouncedKindLoading as T, resolveProvisionalKindRender as U, resolveSupersededKindRender as V, routeEnvOf as W, useDirectiveHost as X, useDirectiveScope as Y, type KindDefinitionSource as a, type DirectiveFailure as b, type DirectiveFailureWords as c, type DirectiveRecordRef as d, type ContentIrRenderSeams as e, DB_KIND_COMPONENT_KEY as f, DIRECTIVE_BLOCK_TYPE as g, type DirectiveApplyResult as h, type DirectiveApplyState as i, type DirectiveAskRequest as j, type DirectiveCopyProps 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 DirectiveValueRef as s, type GenericFallbackReason as t, IR_ROUTE_KEY as u, type IrRenderBlock as v, type IrRoutableBlock as w, type IrRouteMarker as x, type KindRouteBinding as y, type KindRouteOptions as z };
@@ -122,7 +122,14 @@ interface DirectiveOpenItemOptions {
122
122
  total: number;
123
123
  }
124
124
  interface DirectiveCopyProps {
125
+ /**
126
+ * What the control is called to a screen reader. Never an id: for a record it
127
+ * is type-generic ("this task"); a host with the record's live name replaces
128
+ * it through `record`.
129
+ */
125
130
  label: string;
131
+ /** The existing record this control copies, when it copies one — to name it. */
132
+ record?: DirectiveRecordRef;
126
133
  /** The value to copy — the whole shell or one item. */
127
134
  value: unknown;
128
135
  /** The item's kind, when copying an item. */
@@ -175,6 +182,15 @@ interface DirectiveHost {
175
182
  openItem?: (options: DirectiveOpenItemOptions) => void;
176
183
  /** Host copy controls. */
177
184
  renderCopy?: (props: DirectiveCopyProps) => ReactNode;
185
+ /**
186
+ * The app's word for one stored value of one pick-list field — the SAME word
187
+ * the record's own screens and the write forms show ("incomplete" on a task
188
+ * reads "Inbox"). One value, one display word everywhere (G8A review,
189
+ * 2026-10-02: the card said "Status incomplete → completed"). Return null for
190
+ * a field that is not a pick-list: its value is shown as written. Absent →
191
+ * every value is shown as stored.
192
+ */
193
+ valueLabel?: (ref: DirectiveValueRef) => string | null;
178
194
  /** The mirrored noun catalog (label / family / title column). */
179
195
  nouns?: DirectiveNounCatalog;
180
196
  /** slug → the kind ONE item is (THE DIRECTIVE⇄KIND SEAM), or null. */
@@ -190,6 +206,12 @@ interface DirectiveHost {
190
206
  */
191
207
  explainFailure?: (failure: DirectiveFailure) => DirectiveFailureWords | null;
192
208
  }
209
+ /** One stored value of one field of one record type. */
210
+ interface DirectiveValueRef {
211
+ noun: string;
212
+ field: string;
213
+ value: string;
214
+ }
193
215
  /** One failed apply, as the card knows it. */
194
216
  interface DirectiveFailure {
195
217
  /** The server's / host's own text — technical; shown only behind Details. */
@@ -722,4 +744,4 @@ interface KindRouteBinding {
722
744
  /** Bind the pure routes to one host's env + owned block types. */
723
745
  declare function createKindRouteBinding(env: KindRouteEnv, options?: KindRouteOptions): KindRouteBinding;
724
746
 
725
- 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 };
747
+ export { type ProvisionalKindRender as A, type SupersededKindRender as B, type ContentIrHost as C, type DirectiveHost as D, applyIrKindRoute as E, createKindRouteBinding as F, GENERIC_STRUCTURED_COMPONENT_KEY as G, envelopeFromPartialKind as H, IR_PROVISIONAL_KEY as I, isPartialReadyKind as J, type KindRouteEnv as K, isProvisionalBlock as L, kindServerDataFromStoredValue as M, markKindPartialUnsafe as N, readIrRouteMarker as O, type PartialRenderOptions as P, resetPartialUnsafeKinds as Q, resetSourcelessDbRowReports as R, type StructuredValueRenderProps as S, resolveAnnouncedKindLoading as T, resolveProvisionalKindRender as U, resolveSupersededKindRender as V, routeEnvOf as W, useDirectiveHost as X, useDirectiveScope as Y, type KindDefinitionSource as a, type DirectiveFailure as b, type DirectiveFailureWords as c, type DirectiveRecordRef as d, type ContentIrRenderSeams as e, DB_KIND_COMPONENT_KEY as f, DIRECTIVE_BLOCK_TYPE as g, type DirectiveApplyResult as h, type DirectiveApplyState as i, type DirectiveAskRequest as j, type DirectiveCopyProps 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 DirectiveValueRef as s, type GenericFallbackReason as t, IR_ROUTE_KEY as u, type IrRenderBlock as v, type IrRoutableBlock as w, type IrRouteMarker as x, type KindRouteBinding as y, type KindRouteOptions as z };
package/dist/route.d.cts CHANGED
@@ -1,4 +1,4 @@
1
- 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-KoRMp3Qn.cjs';
1
+ export { f as DB_KIND_COMPONENT_KEY, g as DIRECTIVE_BLOCK_TYPE, G as GENERIC_STRUCTURED_COMPONENT_KEY, t as GenericFallbackReason, I as IR_PROVISIONAL_KEY, u as IR_ROUTE_KEY, x as IrRouteMarker, y as KindRouteBinding, z as KindRouteOptions, P as PartialRenderOptions, A as ProvisionalKindRender, B as SupersededKindRender, E as applyIrKindRoute, F as createKindRouteBinding, H as envelopeFromPartialKind, J as isPartialReadyKind, L as isProvisionalBlock, M as kindServerDataFromStoredValue, N as markKindPartialUnsafe, O as readIrRouteMarker, Q as resetPartialUnsafeKinds, R as resetSourcelessDbRowReports, T as resolveAnnouncedKindLoading, U as resolveProvisionalKindRender, V as resolveSupersededKindRender } from './route-DMTBn8w4.cjs';
2
2
  import './component-resolution.types-DY4pGymy.cjs';
3
3
  import 'react';
4
4
  import '@ai-matrx/content-ir';
package/dist/route.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- 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-CtYw2cTN.js';
1
+ export { f as DB_KIND_COMPONENT_KEY, g as DIRECTIVE_BLOCK_TYPE, G as GENERIC_STRUCTURED_COMPONENT_KEY, t as GenericFallbackReason, I as IR_PROVISIONAL_KEY, u as IR_ROUTE_KEY, x as IrRouteMarker, y as KindRouteBinding, z as KindRouteOptions, P as PartialRenderOptions, A as ProvisionalKindRender, B as SupersededKindRender, E as applyIrKindRoute, F as createKindRouteBinding, H as envelopeFromPartialKind, J as isPartialReadyKind, L as isProvisionalBlock, M as kindServerDataFromStoredValue, N as markKindPartialUnsafe, O as readIrRouteMarker, Q as resetPartialUnsafeKinds, R as resetSourcelessDbRowReports, T as resolveAnnouncedKindLoading, U as resolveProvisionalKindRender, V as resolveSupersededKindRender } from './route-CiCUQGAB.js';
2
2
  import './component-resolution.types-DY4pGymy.js';
3
3
  import 'react';
4
4
  import '@ai-matrx/content-ir';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ai-matrx/content-ir-react",
3
- "version": "0.19.1",
3
+ "version": "0.20.1",
4
4
  "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.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",
@@ -124,8 +124,8 @@
124
124
  "react": ">=19.0.0"
125
125
  },
126
126
  "dependencies": {
127
- "@ai-matrx/kit": "latest",
128
- "@ai-matrx/content-ir": "latest"
127
+ "@ai-matrx/content-ir": "latest",
128
+ "@ai-matrx/kit": "latest"
129
129
  },
130
130
  "devDependencies": {
131
131
  "@arethetypeswrong/cli": "^0.18.5",