@ai-matrx/content-ir-react 0.24.1 → 0.24.2

package/dist/index.d.cts

@@ -511,8 +511,9 @@ declare function useRecordValues(read: RecordReader | undefined, ref: DirectiveR
  *
  * Contract (the db-row component contract, SHAPE_SYSTEM.md):
  *  - `component_source` compiles to a React component receiving
- *    `{ data, kind, config, runAction, onResolve?, uiOptions? }` where `data`
- *    is the kind instance value.
+ *    `{ data, kind, config, runAction, itemState?, onResolve?, uiOptions? }`
+ *    where `data` is the kind instance value and `itemState` what actions
+ *    saved onto this item.
  *  - `props_transform` (optional) compiles to a `(data) => data` function
  *    applied to the value BEFORE it reaches the component. A throwing or
  *    non-compiling transform screams and the untransformed value is used
@@ -579,6 +580,13 @@ interface DbKindComponentRenderProps {
     onResolve?: ResolveKindValue;
     /** Settings the mounting surface dictates (e.g. `{ selectionMode: "single" }`). */
     uiOptions?: KindComponentUiOptions;
+    /**
+     * This item's durable state: what `save_item_state` / `run_shortcut` with
+     * `saveAs` wrote onto it (`{}` when nothing yet; survives reload). The host
+     * adds `src` to every saved image ref (`{ file_id, mime_type, width, height }`)
+     * so the component renders `<img src={itemState.key.src}>`.
+     */
+    itemState?: Record<string, unknown>;
 }
 interface CompiledDbKindComponent {
     Component: react.ComponentType<DbKindComponentRenderProps>;

package/dist/index.d.ts

@@ -511,8 +511,9 @@ declare function useRecordValues(read: RecordReader | undefined, ref: DirectiveR
  *
  * Contract (the db-row component contract, SHAPE_SYSTEM.md):
  *  - `component_source` compiles to a React component receiving
- *    `{ data, kind, config, runAction, onResolve?, uiOptions? }` where `data`
- *    is the kind instance value.
+ *    `{ data, kind, config, runAction, itemState?, onResolve?, uiOptions? }`
+ *    where `data` is the kind instance value and `itemState` what actions
+ *    saved onto this item.
  *  - `props_transform` (optional) compiles to a `(data) => data` function
  *    applied to the value BEFORE it reaches the component. A throwing or
  *    non-compiling transform screams and the untransformed value is used
@@ -579,6 +580,13 @@ interface DbKindComponentRenderProps {
     onResolve?: ResolveKindValue;
     /** Settings the mounting surface dictates (e.g. `{ selectionMode: "single" }`). */
     uiOptions?: KindComponentUiOptions;
+    /**
+     * This item's durable state: what `save_item_state` / `run_shortcut` with
+     * `saveAs` wrote onto it (`{}` when nothing yet; survives reload). The host
+     * adds `src` to every saved image ref (`{ file_id, mime_type, width, height }`)
+     * so the component renders `<img src={itemState.key.src}>`.
+     */
+    itemState?: Record<string, unknown>;
 }
 interface CompiledDbKindComponent {
     Component: react.ComponentType<DbKindComponentRenderProps>;