@ai-matrx/content-ir-react 0.22.0 → 0.24.0

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog
 
+## 0.24.0 — 2026-10-06
+
+`KindActionButton` joins the kind kit: the one-click door from a kind component to a host Action.
+
+- `KindActionButton` / `KindActionButtonProps` in `/kind-kit`. Wraps the component's `runAction(key, input)`
+  prop: busy state with no double fire, an optional inline `confirm` (one-sentence consequence + confirm
+  button, never `window.confirm`), a one-line inline error (<=60 chars, full text in `title`) on
+  `{ok:false}`, `onDone(result)` on ok, `compact` icon-only mode.
+
+### Consumer action
+
+- Stored code imports it as `@/components/kind-kit/KindActionButton`: add that path to the host's stored
+  scope (`"@/components/kind-kit/KindActionButton": kindKit`) and to the gate lists (code-runtime >= 0.3.0).
+
+## 0.23.1 — 2026-10-06
+
+- `KindKitCopyProps` is `MatrxCopyMenuProps` from `@ai-matrx/alchemy/react/workspace` (ALC-16); adds the
+  `@ai-matrx/alchemy` dependency.
+- Consumer action: none.
+
+## 0.23.0 — 2026-10-06
+
+The kind kit moves into the package (Applets AP-5): `@ai-matrx/content-ir-react/kind-kit`.
+
+- Carries `SortableList`, `KindPanelGrid`, `KindPanel`, `KindHeaderBar`, `StreamingSkeleton`,
+  `useStreamingValue`, `streamList`, `streamText`, `KeywordChip`, `TagList` and the icon-slot
+  helper `renderKindKitIcon` — same props, markup and class names as the matrx-frontend copy.
+- Host slots: `setKindKitHost({ CopyButtons?, ReadEmpty?, ReadStaleNotice? })` (state on
+  `globalThis`, `Symbol.for("ai-matrx.content-ir-react.kind-kit-host")`), `getKindKitHost`,
+  `resetKindKitHost`, and the defaults (`DefaultCopyButtons`, `DefaultReadEmpty`,
+  `DefaultReadStaleNotice`). Defaults: a plain "Copy" button; loading / "Could not load X."
+  with a retry / the empty state; a stale-rows notice with retry.
+- New dependency `@ai-matrx/design-system`; glyphs are inlined SVGs (no icon library).
+- Type tightening only (`exactOptionalPropertyTypes`): `KeywordChipProps` optional fields accept
+  `undefined`; `KindPanel` passes `disabled ?? false`.
+
+### Consumer action
+
+- Hosts call `setKindKitHost` once at boot with their copy bar (`CopyButtons`) and read notices
+  (`ReadEmpty`, `ReadStaleNotice`).
+- matrx-frontend: point the `@/components/kind-kit/*` scope entries at
+  `@ai-matrx/content-ir-react/kind-kit`, then delete `components/kind-kit/`.
+
 ## 0.22.0 — 2026-10-06
 
 Kind components call Actions (Applets AP-5, CONTRACTS §6/§7).

package/dist/db-component.d.cts

@@ -1,4 +1,4 @@
-import * as react from 'react';
+import * as React from 'react';
 import { C as ComponentResolution, a as ContentIrErrorReporter } from './component-resolution.types-BQa2ik3i.cjs';
 
 /**
@@ -97,7 +97,7 @@ interface DbKindComponentRenderProps {
     uiOptions?: KindComponentUiOptions;
 }
 interface CompiledDbKindComponent {
-    Component: react.ComponentType<DbKindComponentRenderProps>;
+    Component: React.ComponentType<DbKindComponentRenderProps>;
     /** Compiled `props_transform`, or null when the row declares none. */
     transform: ((data: unknown) => unknown) | null;
 }
@@ -147,7 +147,7 @@ type DbKindComponentCompiler = (args: {
     code: string;
     allowedImports: string[];
 }) => {
-    Component: react.ComponentType<Record<string, unknown>> | null;
+    Component: React.ComponentType<Record<string, unknown>> | null;
     error: string | null;
 };
 interface DbKindComponentCachePorts {
@@ -234,8 +234,8 @@ interface DbKindComponentErrorBoundaryProps {
     kind: string;
     /** The resolved component's `updated_at`; a change means a new version. */
     resetSignal: string | null;
-    fallback: react.ReactNode;
-    children: react.ReactNode;
+    fallback: React.ReactNode;
+    children: React.ReactNode;
     /**
      * Where the catch lands. A host binds structured capture + incident filing
      * here; the default screams to the console. NOTE for hosts whose console
@@ -256,12 +256,12 @@ interface State {
      */
     signalAtLastRender: string | null;
 }
-declare class DbKindComponentErrorBoundary extends react.Component<DbKindComponentErrorBoundaryProps, State> {
+declare class DbKindComponentErrorBoundary extends React.Component<DbKindComponentErrorBoundaryProps, State> {
     constructor(props: DbKindComponentErrorBoundaryProps);
     static getDerivedStateFromError(): Partial<State>;
     static getDerivedStateFromProps(props: DbKindComponentErrorBoundaryProps, state: State): State | null;
-    componentDidCatch(error: Error, errorInfo: react.ErrorInfo): void;
-    render(): react.ReactNode;
+    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
+    render(): React.ReactNode;
 }
 
 /**

package/dist/db-component.d.ts

@@ -1,4 +1,4 @@
-import * as react from 'react';
+import * as React from 'react';
 import { C as ComponentResolution, a as ContentIrErrorReporter } from './component-resolution.types-BQa2ik3i.js';
 
 /**
@@ -97,7 +97,7 @@ interface DbKindComponentRenderProps {
     uiOptions?: KindComponentUiOptions;
 }
 interface CompiledDbKindComponent {
-    Component: react.ComponentType<DbKindComponentRenderProps>;
+    Component: React.ComponentType<DbKindComponentRenderProps>;
     /** Compiled `props_transform`, or null when the row declares none. */
     transform: ((data: unknown) => unknown) | null;
 }
@@ -147,7 +147,7 @@ type DbKindComponentCompiler = (args: {
     code: string;
     allowedImports: string[];
 }) => {
-    Component: react.ComponentType<Record<string, unknown>> | null;
+    Component: React.ComponentType<Record<string, unknown>> | null;
     error: string | null;
 };
 interface DbKindComponentCachePorts {
@@ -234,8 +234,8 @@ interface DbKindComponentErrorBoundaryProps {
     kind: string;
     /** The resolved component's `updated_at`; a change means a new version. */
     resetSignal: string | null;
-    fallback: react.ReactNode;
-    children: react.ReactNode;
+    fallback: React.ReactNode;
+    children: React.ReactNode;
     /**
      * Where the catch lands. A host binds structured capture + incident filing
      * here; the default screams to the console. NOTE for hosts whose console
@@ -256,12 +256,12 @@ interface State {
      */
     signalAtLastRender: string | null;
 }
-declare class DbKindComponentErrorBoundary extends react.Component<DbKindComponentErrorBoundaryProps, State> {
+declare class DbKindComponentErrorBoundary extends React.Component<DbKindComponentErrorBoundaryProps, State> {
     constructor(props: DbKindComponentErrorBoundaryProps);
     static getDerivedStateFromError(): Partial<State>;
     static getDerivedStateFromProps(props: DbKindComponentErrorBoundaryProps, state: State): State | null;
-    componentDidCatch(error: Error, errorInfo: react.ErrorInfo): void;
-    render(): react.ReactNode;
+    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
+    render(): React.ReactNode;
 }
 
 /**

package/dist/{directive-host-CtFMuSZc.d.cts → directive-host-QjoZEeik.d.cts}

@@ -1,4 +1,4 @@
-import * as react from 'react';
+import * as React from 'react';
 import { ReactNode } from 'react';
 import { DecodedDirective, DirectiveNounCatalog, DirectiveItemKindLookup } from '@ai-matrx/content-ir';
 
@@ -241,13 +241,13 @@ interface DirectiveScope {
  */
 declare function DirectiveScopeProvider({ conversationId, children, }: DirectiveScope & {
     children: ReactNode;
-}): react.JSX.Element;
+}): React.JSX.Element;
 declare function useDirectiveScope(): DirectiveScope;
 interface DirectiveHostProviderProps {
     host: DirectiveHost;
     children: ReactNode;
 }
-declare function DirectiveHostProvider({ host, children }: DirectiveHostProviderProps): react.JSX.Element;
+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)

package/dist/{directive-host-CtFMuSZc.d.ts → directive-host-QjoZEeik.d.ts}

@@ -1,4 +1,4 @@
-import * as react from 'react';
+import * as React from 'react';
 import { ReactNode } from 'react';
 import { DecodedDirective, DirectiveNounCatalog, DirectiveItemKindLookup } from '@ai-matrx/content-ir';
 
@@ -241,13 +241,13 @@ interface DirectiveScope {
  */
 declare function DirectiveScopeProvider({ conversationId, children, }: DirectiveScope & {
     children: ReactNode;
-}): react.JSX.Element;
+}): React.JSX.Element;
 declare function useDirectiveScope(): DirectiveScope;
 interface DirectiveHostProviderProps {
     host: DirectiveHost;
     children: ReactNode;
 }
-declare function DirectiveHostProvider({ host, children }: DirectiveHostProviderProps): react.JSX.Element;
+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)

package/dist/directives.d.cts

@@ -1,6 +1,6 @@
-import { D as DirectiveHost, a as DirectiveFailure, b as DirectiveFailureWords, c as DirectiveRecordRef } from './directive-host-CtFMuSZc.cjs';
-export { d as DirectiveApplyResult, e as DirectiveApplyState, f as DirectiveAskRequest, g as DirectiveCopyProps, h as DirectiveHostProvider, i as DirectiveHostProviderProps, j as DirectiveOpenItemOptions, k as DirectiveRecordProps, l as DirectiveScope, m as DirectiveScopeProvider, n as DirectiveShell, o as DirectiveValueRef, u as useDirectiveHost, p as useDirectiveScope } from './directive-host-CtFMuSZc.cjs';
-import * as react from 'react';
+import { D as DirectiveHost, a as DirectiveFailure, b as DirectiveFailureWords, c as DirectiveRecordRef } from './directive-host-QjoZEeik.cjs';
+export { d as DirectiveApplyResult, e as DirectiveApplyState, f as DirectiveAskRequest, g as DirectiveCopyProps, h as DirectiveHostProvider, i as DirectiveHostProviderProps, j as DirectiveOpenItemOptions, k as DirectiveRecordProps, l as DirectiveScope, m as DirectiveScopeProvider, n as DirectiveShell, o as DirectiveValueRef, u as useDirectiveHost, p as useDirectiveScope } from './directive-host-QjoZEeik.cjs';
+import * as React from 'react';
 import { ComponentType } from 'react';
 import { DecodedDirective, DirectiveClass } from '@ai-matrx/content-ir';
 
@@ -75,7 +75,7 @@ interface ApplyDirectiveButtonProps {
      */
     nothingToChange?: boolean;
 }
-declare function ApplyDirectiveButton({ directive, label, itemCount, onApplied, onPhase, nothingToChange, }: ApplyDirectiveButtonProps): react.JSX.Element | null;
+declare function ApplyDirectiveButton({ directive, label, itemCount, onApplied, onPhase, nothingToChange, }: ApplyDirectiveButtonProps): React.JSX.Element | null;
 
 /**
  * WHAT A DIRECTIVE ITEM WILL DO TO AN EXISTING RECORD — for the card, the
@@ -200,15 +200,15 @@ declare function directiveValueWord(host: Pick<DirectiveHost, "valueLabel">, nou
 declare function DirectiveChangeList({ changes, className, }: {
     changes: ItemChange[];
     className?: string;
-}): react.JSX.Element;
-declare function SideEffectDirectiveCard({ directive }: SideEffectDirectiveCardProps): react.JSX.Element;
+}): React.JSX.Element;
+declare function SideEffectDirectiveCard({ directive }: SideEffectDirectiveCardProps): React.JSX.Element;
 
 interface DirectiveFallbackCardProps {
     directive: DecodedDirective;
     /** Short, human explanation of why the rich renderer degraded. */
     reason?: string;
 }
-declare function DirectiveFallbackCard({ directive, reason }: DirectiveFallbackCardProps): react.JSX.Element;
+declare function DirectiveFallbackCard({ directive, reason }: DirectiveFallbackCardProps): React.JSX.Element;
 
 /** The directive slug of a partial document, once its closing quote has arrived. */
 declare function provisionalDirectiveSlug(content: string): string | null;
@@ -222,7 +222,7 @@ interface DirectiveProvisionalCardProps {
     streaming: boolean;
     className?: string | undefined;
 }
-declare function DirectiveProvisionalCard({ content, streaming, className }: DirectiveProvisionalCardProps): react.JSX.Element;
+declare function DirectiveProvisionalCard({ content, streaming, className }: DirectiveProvisionalCardProps): React.JSX.Element;
 
 interface DirectiveRenderProps {
     /** The fence body (JSON string) or an already-parsed shell / value. */
@@ -242,7 +242,7 @@ interface DirectiveRenderProps {
      */
     conversationId?: string | null;
 }
-declare function DirectiveRender({ conversationId, ...props }: DirectiveRenderProps): react.JSX.Element;
+declare function DirectiveRender({ conversationId, ...props }: DirectiveRenderProps): React.JSX.Element;
 
 /**
  * THE WORDS A FAILED APPLY SHOWS A PERSON.

package/dist/directives.d.ts

@@ -1,6 +1,6 @@
-import { D as DirectiveHost, a as DirectiveFailure, b as DirectiveFailureWords, c as DirectiveRecordRef } from './directive-host-CtFMuSZc.js';
-export { d as DirectiveApplyResult, e as DirectiveApplyState, f as DirectiveAskRequest, g as DirectiveCopyProps, h as DirectiveHostProvider, i as DirectiveHostProviderProps, j as DirectiveOpenItemOptions, k as DirectiveRecordProps, l as DirectiveScope, m as DirectiveScopeProvider, n as DirectiveShell, o as DirectiveValueRef, u as useDirectiveHost, p as useDirectiveScope } from './directive-host-CtFMuSZc.js';
-import * as react from 'react';
+import { D as DirectiveHost, a as DirectiveFailure, b as DirectiveFailureWords, c as DirectiveRecordRef } from './directive-host-QjoZEeik.js';
+export { d as DirectiveApplyResult, e as DirectiveApplyState, f as DirectiveAskRequest, g as DirectiveCopyProps, h as DirectiveHostProvider, i as DirectiveHostProviderProps, j as DirectiveOpenItemOptions, k as DirectiveRecordProps, l as DirectiveScope, m as DirectiveScopeProvider, n as DirectiveShell, o as DirectiveValueRef, u as useDirectiveHost, p as useDirectiveScope } from './directive-host-QjoZEeik.js';
+import * as React from 'react';
 import { ComponentType } from 'react';
 import { DecodedDirective, DirectiveClass } from '@ai-matrx/content-ir';
 
@@ -75,7 +75,7 @@ interface ApplyDirectiveButtonProps {
      */
     nothingToChange?: boolean;
 }
-declare function ApplyDirectiveButton({ directive, label, itemCount, onApplied, onPhase, nothingToChange, }: ApplyDirectiveButtonProps): react.JSX.Element | null;
+declare function ApplyDirectiveButton({ directive, label, itemCount, onApplied, onPhase, nothingToChange, }: ApplyDirectiveButtonProps): React.JSX.Element | null;
 
 /**
  * WHAT A DIRECTIVE ITEM WILL DO TO AN EXISTING RECORD — for the card, the
@@ -200,15 +200,15 @@ declare function directiveValueWord(host: Pick<DirectiveHost, "valueLabel">, nou
 declare function DirectiveChangeList({ changes, className, }: {
     changes: ItemChange[];
     className?: string;
-}): react.JSX.Element;
-declare function SideEffectDirectiveCard({ directive }: SideEffectDirectiveCardProps): react.JSX.Element;
+}): React.JSX.Element;
+declare function SideEffectDirectiveCard({ directive }: SideEffectDirectiveCardProps): React.JSX.Element;
 
 interface DirectiveFallbackCardProps {
     directive: DecodedDirective;
     /** Short, human explanation of why the rich renderer degraded. */
     reason?: string;
 }
-declare function DirectiveFallbackCard({ directive, reason }: DirectiveFallbackCardProps): react.JSX.Element;
+declare function DirectiveFallbackCard({ directive, reason }: DirectiveFallbackCardProps): React.JSX.Element;
 
 /** The directive slug of a partial document, once its closing quote has arrived. */
 declare function provisionalDirectiveSlug(content: string): string | null;
@@ -222,7 +222,7 @@ interface DirectiveProvisionalCardProps {
     streaming: boolean;
     className?: string | undefined;
 }
-declare function DirectiveProvisionalCard({ content, streaming, className }: DirectiveProvisionalCardProps): react.JSX.Element;
+declare function DirectiveProvisionalCard({ content, streaming, className }: DirectiveProvisionalCardProps): React.JSX.Element;
 
 interface DirectiveRenderProps {
     /** The fence body (JSON string) or an already-parsed shell / value. */
@@ -242,7 +242,7 @@ interface DirectiveRenderProps {
      */
     conversationId?: string | null;
 }
-declare function DirectiveRender({ conversationId, ...props }: DirectiveRenderProps): react.JSX.Element;
+declare function DirectiveRender({ conversationId, ...props }: DirectiveRenderProps): React.JSX.Element;
 
 /**
  * THE WORDS A FAILED APPLY SHOWS A PERSON.

package/dist/{host-types-mMFt5-hQ.d.cts → host-types-B2Q8fiU8.d.cts}

@@ -1,7 +1,7 @@
 import { ReactNode } from 'react';
 import { KindDefinition } from '@ai-matrx/content-ir';
 import { d as ComponentResolutionSource, a as ContentIrErrorReporter } from './component-resolution.types-BQa2ik3i.cjs';
-import { D as DirectiveHost } from './directive-host-CtFMuSZc.cjs';
+import { D as DirectiveHost } from './directive-host-QjoZEeik.cjs';
 
 /**
  * THE HOST CONTRACT — everything this package refuses to decide.

package/dist/{host-types-CGcK8Nib.d.ts → host-types-DvZukz6J.d.ts}

@@ -1,7 +1,7 @@
 import { ReactNode } from 'react';
 import { KindDefinition } from '@ai-matrx/content-ir';
 import { d as ComponentResolutionSource, a as ContentIrErrorReporter } from './component-resolution.types-BQa2ik3i.js';
-import { D as DirectiveHost } from './directive-host-CtFMuSZc.js';
+import { D as DirectiveHost } from './directive-host-QjoZEeik.js';
 
 /**
  * THE HOST CONTRACT — everything this package refuses to decide.

package/dist/host.d.cts

@@ -1,16 +1,16 @@
 export { b as ContentIrErrorReport, a as ContentIrErrorReporter, c as consoleErrorReporter } from './component-resolution.types-BQa2ik3i.cjs';
-import { C as ContentIrHost, K as KindRouteEnv } from './host-types-mMFt5-hQ.cjs';
-export { a as ContentIrRenderSeams, I as IrRenderBlock, b as IrRoutableBlock, c as KindDefinitionSource, S as StructuredValueRenderProps, r as routeEnvOf } from './host-types-mMFt5-hQ.cjs';
-import * as react from 'react';
+import { C as ContentIrHost, K as KindRouteEnv } from './host-types-B2Q8fiU8.cjs';
+export { a as ContentIrRenderSeams, I as IrRenderBlock, b as IrRoutableBlock, c as KindDefinitionSource, S as StructuredValueRenderProps, r as routeEnvOf } from './host-types-B2Q8fiU8.cjs';
+import * as React from 'react';
 import { ReactNode } from 'react';
 import '@ai-matrx/content-ir';
-import './directive-host-CtFMuSZc.cjs';
+import './directive-host-QjoZEeik.cjs';
 
 interface ContentIrRenderProviderProps {
     host: ContentIrHost;
     children: ReactNode;
 }
-declare function ContentIrRenderProvider({ host, children, }: ContentIrRenderProviderProps): react.JSX.Element;
+declare function ContentIrRenderProvider({ host, children, }: ContentIrRenderProviderProps): React.JSX.Element;
 /**
  * The wired host, or null. For the rare consumer that can legitimately run
  * without a provider because it was handed its sources explicitly (see

package/dist/host.d.ts

@@ -1,16 +1,16 @@
 export { b as ContentIrErrorReport, a as ContentIrErrorReporter, c as consoleErrorReporter } from './component-resolution.types-BQa2ik3i.js';
-import { C as ContentIrHost, K as KindRouteEnv } from './host-types-CGcK8Nib.js';
-export { a as ContentIrRenderSeams, I as IrRenderBlock, b as IrRoutableBlock, c as KindDefinitionSource, S as StructuredValueRenderProps, r as routeEnvOf } from './host-types-CGcK8Nib.js';
-import * as react from 'react';
+import { C as ContentIrHost, K as KindRouteEnv } from './host-types-DvZukz6J.js';
+export { a as ContentIrRenderSeams, I as IrRenderBlock, b as IrRoutableBlock, c as KindDefinitionSource, S as StructuredValueRenderProps, r as routeEnvOf } from './host-types-DvZukz6J.js';
+import * as React from 'react';
 import { ReactNode } from 'react';
 import '@ai-matrx/content-ir';
-import './directive-host-CtFMuSZc.js';
+import './directive-host-QjoZEeik.js';
 
 interface ContentIrRenderProviderProps {
     host: ContentIrHost;
     children: ReactNode;
 }
-declare function ContentIrRenderProvider({ host, children, }: ContentIrRenderProviderProps): react.JSX.Element;
+declare function ContentIrRenderProvider({ host, children, }: ContentIrRenderProviderProps): React.JSX.Element;
 /**
  * The wired host, or null. For the rare consumer that can legitimately run
  * without a provider because it was handed its sources explicitly (see