@trinityui/design-system 2.11.1 → 2.13.0

package/dist/components/AI/AIVoiceInput.d.ts

@@ -18,10 +18,11 @@
  */
 import React from 'react';
 import { SxProps, Theme } from '@mui/material';
+import { type TrinityRootProps, type TrinitySlotProps } from '../shared/rootProps';
 /**
- * Props for AIVoiceOverlay component.
+ * AIVoiceOverlay's own props.
  */
-export interface AIVoiceOverlayProps {
+export interface AIVoiceOverlayOwnProps {
     /** Whether the voice overlay is open */
     open: boolean;
     /** Whether currently listening */
@@ -30,30 +31,60 @@ export interface AIVoiceOverlayProps {
     onListeningToggle: () => void;
     /** Close the voice overlay */
     onClose: () => void;
-    /** Listening text */
+    /** Listening text. Default: `ai.voiceOverlay.listening`. */
     listeningText?: string;
-    /** Ready text */
+    /** Ready text. Default: `ai.voiceOverlay.ready`. */
     readyText?: string;
-    /** Listening instruction */
+    /** Listening instruction. Default: `ai.voiceOverlay.listeningInstruction`. */
     listeningInstruction?: string;
-    /** Ready instruction */
+    /** Ready instruction. Default: `ai.voiceOverlay.readyInstruction`. */
     readyInstruction?: string;
-    /** Custom sx props */
+    /**
+     * Added to the root's own class names: the panel (the ref's element).
+     * @since 2.13.0
+     */
+    className?: string;
+    /** Custom sx props for the panel, applied after its own styles (object, array or function). */
     sx?: SxProps<Theme>;
+    /**
+     * Props for the component's slots (ADR-04 (6)). `collapse`: the Collapse wrapper around the
+     * panel, which animates it open and closed.
+     * @since 2.13.0
+     */
+    slotProps?: {
+        collapse?: TrinitySlotProps<HTMLDivElement>;
+    };
 }
 /**
- * Props for AIListeningIndicator component.
+ * Props for AIVoiceOverlay: its own props, plus the HTML attributes of its root, the panel
+ * (`id`, `data-*`, `aria-*`), which reach it (ADR-04, WI-40).
  */
-export interface AIListeningIndicatorProps {
+export interface AIVoiceOverlayProps extends AIVoiceOverlayOwnProps, TrinityRootProps<HTMLDivElement, AIVoiceOverlayOwnProps> {
+}
+/**
+ * AIListeningIndicator's own props.
+ */
+export interface AIListeningIndicatorOwnProps {
     /** Whether currently listening */
     isListening: boolean;
     /** Stop listening callback */
     onStop: () => void;
-    /** Display text */
+    /** Display text. Default: `ai.listeningIndicator.text`. */
     text?: string;
-    /** Custom sx props */
+    /**
+     * Added to the root's own class names.
+     * @since 2.13.0
+     */
+    className?: string;
+    /** Custom sx props, applied after the indicator's own styles (object, array or function). */
     sx?: SxProps<Theme>;
 }
+/**
+ * Props for AIListeningIndicator: its own props, plus the HTML attributes of its root `div`
+ * (`id`, `data-*`, `aria-*`), which reach the root (ADR-04, WI-40).
+ */
+export interface AIListeningIndicatorProps extends AIListeningIndicatorOwnProps, TrinityRootProps<HTMLDivElement, AIListeningIndicatorOwnProps> {
+}
 /**
  * AI Voice Overlay - Full voice mode interface for hands-free input
  */

package/dist/components/AI/AIVoiceInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AIVoiceInput.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIVoiceInput.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAQL,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AAQvB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,kCAAkC;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,6BAA6B;IAC7B,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,kCAAkC;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAMD;;GAEG;AACH,eAAO,MAAM,cAAc,4FA4F1B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,oBAAoB,kGAgDhC,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"AIVoiceInput.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIVoiceInput.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAUL,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AASvB,OAAO,EAAgB,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAUjG;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,kCAAkC;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,6BAA6B;IAC7B,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+FAA+F;IAC/F,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB;;;;OAIG;IACH,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAA;KAAE,CAAC;CAC7D;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,sBAAsB,EAAE,gBAAgB,CAAC,cAAc,EAAE,sBAAsB,CAAC;CAAG;AAEhI;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,kCAAkC;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,yBAA0B,SAAQ,4BAA4B,EAAE,gBAAgB,CAAC,cAAc,EAAE,4BAA4B,CAAC;CAAG;AAMlJ;;GAEG;AACH,eAAO,MAAM,cAAc,4FA0I1B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,oBAAoB,kGA8DhC,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/components/AI/AIVoiceMode.d.ts

@@ -24,8 +24,10 @@
  */
 import React from 'react';
 import { SxProps, Theme } from '@mui/material';
+import { type TrinityRootProps } from '../shared/rootProps';
 export type AIVoiceStatus = 'connecting' | 'listening' | 'thinking' | 'speaking' | 'paused';
-export interface AIVoiceModeProps {
+/** AIVoiceMode's own props. */
+export interface AIVoiceModeOwnProps {
     /** Whether the full-screen voice mode is open */
     open: boolean;
     /** Current conversation state — drives the orb animation and status label */
@@ -38,7 +40,7 @@ export interface AIVoiceModeProps {
     onMuteToggle?: () => void;
     /** End / close voice mode */
     onClose: () => void;
-    /** Heading shown in the top bar */
+    /** Heading shown in the top bar, and the surface's name. Default: `ai.voiceMode.title` ('Voice mode'). */
     title?: string;
     /**
      * How the voice mode surface is presented.
@@ -47,9 +49,21 @@ export interface AIVoiceModeProps {
      *   so the surrounding UI and the user's context stay visible.
      */
     variant?: 'fullscreen' | 'inline';
+    /**
+     * Added to the root's own class names: the surface (the dialog, or the inline group).
+     * @since 2.13.0
+     */
+    className?: string;
     /** Custom sx applied to the overlay surface */
     sx?: SxProps<Theme>;
 }
+/**
+ * Props for AIVoiceMode: its own props, plus the HTML attributes of its surface `div` (`id`,
+ * `data-*`, `aria-*`), which reach it (ADR-04, WI-40). The surface owns `role` (dialog or
+ * group) and, full screen, `aria-modal`; a consumer `aria-labelledby` joins the title's id.
+ */
+export interface AIVoiceModeProps extends AIVoiceModeOwnProps, TrinityRootProps<HTMLDivElement, AIVoiceModeOwnProps> {
+}
 export declare const AIVoiceMode: React.ForwardRefExoticComponent<AIVoiceModeProps & React.RefAttributes<HTMLDivElement>>;
 export default AIVoiceMode;
 //# sourceMappingURL=AIVoiceMode.d.ts.map

package/dist/components/AI/AIVoiceMode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AIVoiceMode.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIVoiceMode.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EASL,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AAQvB,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE5F,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,IAAI,EAAE,OAAO,CAAC;IACd,6EAA6E;IAC7E,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,OAAO,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC;IAClC,+CAA+C;IAC/C,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAcD,eAAO,MAAM,WAAW,yFAgRtB,CAAC;AAEH,eAAe,WAAW,CAAC"}
+{"version":3,"file":"AIVoiceMode.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIVoiceMode.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EASL,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AASvB,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAkD1E,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE5F,+BAA+B;AAC/B,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,IAAI,EAAE,OAAO,CAAC;IACd,6EAA6E;IAC7E,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,0GAA0G;IAC1G,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,OAAO,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB,EAAE,gBAAgB,CAAC,cAAc,EAAE,mBAAmB,CAAC;CAAG;AAmCvH,eAAO,MAAM,WAAW,yFA+TtB,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/dist/components/AI/BlockErrorBoundary.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @internal — not part of the public API; see ADR-02
+ *
+ * Per-block error isolation for AIResponseRenderer (master plan G-39+). A response is model
+ * output: a block can be malformed, and a consumer's renderer can throw on it. Without isolation
+ * one throwing block unmounts the whole response, and inside a ChatThread or InsightEngine the
+ * whole conversation.
+ *
+ * - `BlockErrorBoundary` wraps one block. When the block throws while rendering, it shows
+ *   `BlockUnavailable` in its place, calls `onBlockError(error, { blockId, type })`, and the
+ *   fallback warns once per block type in development (from an effect). The sibling blocks and the other messages keep rendering. It
+ *   resets when `resetKey` changes (the renderer passes the block object, so a corrected or
+ *   streamed block renders again).
+ * - `BlockUnavailable` is the read-only 'unavailable' state: one line of secondary text,
+ *   'This part of the response is unavailable' (`ai.responseRenderer.blockUnavailable`). It is not
+ *   a live region (a thread's log reads it like any added content) and has no controls. Block
+ *   renderers render it themselves for a block whose required fields are missing, instead of
+ *   throwing.
+ *
+ * A flat file in src/components/AI (ADR-02 has no AI/internal folder). Registered in
+ * src/components/internal/index.ts under AI ORGANISMS INTERNALS (G-30); no package entry exports it.
+ *
+ * @module components/AI/BlockErrorBoundary
+ */
+import * as React from 'react';
+/** What `onBlockError` receives besides the error. @internal */
+export interface BlockErrorContext {
+    /** The block's `id`, when it has one. */
+    blockId?: string;
+    /** The block's `type`. */
+    type: string;
+}
+/** Props of {@link BlockUnavailable}. @internal */
+export interface BlockUnavailableProps {
+    /** The block's DOM id (`getBlockDomId`), kept so links to the block still land. */
+    id?: string;
+    /** The block's raw id, as `data-block-id`. */
+    blockId?: string;
+    /** The type of a block whose renderer threw: warns once per type, from an effect (ADR-30). */
+    failedType?: string;
+}
+/**
+ * The read-only state of a block that cannot render. Not live, no controls.
+ *
+ * @internal
+ */
+export declare function BlockUnavailable({ id, blockId, failedType }: BlockUnavailableProps): React.ReactElement;
+/** Props of {@link BlockErrorBoundary}. @internal */
+export interface BlockErrorBoundaryProps extends BlockErrorContext {
+    /** The block's DOM id, for the fallback. */
+    domId?: string;
+    /** A new value clears a caught error and renders the children again. */
+    resetKey: unknown;
+    /** Called once per caught error. */
+    onBlockError?: (error: unknown, context: BlockErrorContext) => void;
+    children?: React.ReactNode;
+}
+interface BlockErrorBoundaryState {
+    error: unknown;
+    hasError: boolean;
+    resetKey: unknown;
+}
+/**
+ * Isolates one block: a render error shows `BlockUnavailable` instead of unmounting the response.
+ *
+ * @internal
+ */
+export declare class BlockErrorBoundary extends React.Component<BlockErrorBoundaryProps, BlockErrorBoundaryState> {
+    static displayName: string;
+    state: BlockErrorBoundaryState;
+    static getDerivedStateFromError(error: unknown): Partial<BlockErrorBoundaryState>;
+    static getDerivedStateFromProps(props: BlockErrorBoundaryProps, state: BlockErrorBoundaryState): Partial<BlockErrorBoundaryState> | null;
+    componentDidCatch(error: unknown): void;
+    render(): React.ReactNode;
+}
+export {};
+//# sourceMappingURL=BlockErrorBoundary.d.ts.map

package/dist/components/AI/BlockErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockErrorBoundary.d.ts","sourceRoot":"","sources":["../../../src/components/AI/BlockErrorBoundary.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,mFAAmF;IACnF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,CAcvG;AAED,qDAAqD;AACrD,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACpE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,UAAU,uBAAuB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK,CAAC,SAAS,CAAC,uBAAuB,EAAE,uBAAuB,CAAC;IACvG,MAAM,CAAC,WAAW,SAAwB;IAE1C,KAAK,EAAE,uBAAuB,CAAmE;IAEjG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIjF,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,EAAE,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC,GAAG,IAAI;IAKxI,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAavC,MAAM,IAAI,KAAK,CAAC,SAAS;CAI1B"}

package/dist/components/AI/ChatHeader.d.ts

@@ -21,24 +21,56 @@
  */
 import React from 'react';
 import { SxProps, Theme } from '@mui/material';
+import { type HeadingLevel } from '../shared/headingLevel';
+import { type TrinityRootProps } from '../shared/rootProps';
 export type ChatViewMode = 'sidepanel' | 'expanded';
 /**
- * Props for ChatHeader component.
+ * ChatHeader's own props.
  */
-export interface ChatHeaderProps {
+export interface ChatHeaderOwnProps {
     /** Header title */
     title: string;
+    /**
+     * Heading level of the title: 2 to 6 for h2 to h6. Set it to fit the page outline.
+     * @default 2 (the h2 the title rendered before the prop existed)
+     * @since 2.13.0
+     */
+    headingLevel?: HeadingLevel;
+    /**
+     * Id of the title element, for `aria-labelledby` on the panel or dialog that holds the
+     * header. Without it, the component generates one.
+     * @since 2.13.0
+     */
+    titleId?: string;
     /** Current view mode */
     viewMode: ChatViewMode;
     /** Toggle between sidepanel and expanded view */
     onToggleView?: () => void;
-    /** Close the panel */
+    /** Close the panel. Without it the header shows no Close button. */
     onClose?: () => void;
+    /**
+     * Controls of the host before the expand toggle and Close (for example 'New chat', or a
+     * fullscreen toggle in AppLayout's AI panel). Give each control its own accessible name and
+     * a matching tooltip.
+     * @since 2.13.0
+     */
+    actions?: React.ReactNode;
     /** Show gradient AI logo before title */
     showLogo?: boolean;
-    /** Custom sx props */
+    /**
+     * Added to the root's own class names.
+     * @since 2.13.0
+     */
+    className?: string;
+    /** Custom sx props, applied after the header's own styles (object, array or function). */
     sx?: SxProps<Theme>;
 }
+/**
+ * Props for ChatHeader: its own props, plus the HTML attributes of its root `div` (`id`,
+ * `data-*`, `aria-*`), which reach the root (ADR-04, WI-40).
+ */
+export interface ChatHeaderProps extends ChatHeaderOwnProps, TrinityRootProps<HTMLDivElement, ChatHeaderOwnProps> {
+}
 /**
  * ChatHeader - Stateless header with title and view controls.
  *
@@ -46,6 +78,11 @@ export interface ChatHeaderProps {
  *
  * Uses MUI AppBar/Toolbar for consistent elevation and structure.
  * Semantic tokens only - no hardcoded colors.
+ *
+ * The root is a `div`, not AppBar's default `<header>`: a panel header is never
+ * the page banner. A `<header>` outside article, aside, main, nav and section
+ * maps to the banner landmark, so a panel mounted at body level (such as
+ * InsightEngine's drawer) would add a second banner to the page.
  */
 export declare const ChatHeader: React.ForwardRefExoticComponent<ChatHeaderProps & React.RefAttributes<HTMLDivElement>>;
 export default ChatHeader;

package/dist/components/AI/ChatHeader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatHeader.d.ts","sourceRoot":"","sources":["../../../src/components/AI/ChatHeader.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAOL,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AASvB,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,UAAU,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,QAAQ,EAAE,YAAY,CAAC;IACvB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,wFAuErB,CAAC;AAEH,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ChatHeader.d.ts","sourceRoot":"","sources":["../../../src/components/AI/ChatHeader.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAOL,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG7E,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAM1E,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,UAAU,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,QAAQ,EAAE,YAAY,CAAC;IACvB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,kBAAkB,EAAE,gBAAgB,CAAC,cAAc,EAAE,kBAAkB,CAAC;CAAG;AAMpH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,wFAqFrB,CAAC;AAEH,eAAe,UAAU,CAAC"}

package/dist/components/AI/ChatHistoryList.d.ts

@@ -8,7 +8,7 @@
  * - Allow selecting an active conversation
  * - Visually indicate active chat
  * - Compact for sidepanel, expandable in expanded view
- * - Keyboard navigation support
+ * - A list of buttons: Tab reaches each conversation (ADR-34)
  *
  * @example
  * ```tsx
@@ -21,6 +21,7 @@
  */
 import React from 'react';
 import { SxProps, Theme } from '@mui/material';
+import { type TrinityRootProps } from '../shared/rootProps';
 export interface ChatHistoryItem {
     /** Unique identifier */
     id: string;
@@ -32,9 +33,9 @@ export interface ChatHistoryItem {
     pinned?: boolean;
 }
 /**
- * Props for ChatHistoryList component.
+ * ChatHistoryList's own props.
  */
-export interface ChatHistoryListProps {
+export interface ChatHistoryListOwnProps {
     /** List of chat history items */
     chats: ChatHistoryItem[];
     /** Currently active chat ID */
@@ -51,13 +52,25 @@ export interface ChatHistoryListProps {
     onPin?: (id: string) => void;
     /** Add to project callback */
     onAddToProject?: (id: string) => void;
-    /** Empty state message */
+    /** Empty state message. Default: the `ai.chatHistoryList.empty` string ('No conversations yet'). */
     emptyMessage?: string;
     /** Compact mode for sidepanel */
     compact?: boolean;
-    /** Custom sx props */
+    /**
+     * Added to the root's own class names (the list, or the empty state's `div`).
+     * @since 2.13.0
+     */
+    className?: string;
+    /** Custom sx props, applied after the root's own styles (object, array or function). */
     sx?: SxProps<Theme>;
 }
+/**
+ * Props for ChatHistoryList: its own props, plus the HTML attributes of its root (`id`,
+ * `data-*`, `aria-*`), which reach the root in every state: the `ul`, or the empty state's
+ * `div` (ADR-04, WI-40). A consumer `aria-label` replaces the list's default name.
+ */
+export interface ChatHistoryListProps extends ChatHistoryListOwnProps, TrinityRootProps<HTMLElement, ChatHistoryListOwnProps> {
+}
 /**
  * ChatHistoryList - Stateless list of conversation history.
  *
@@ -68,13 +81,13 @@ export interface ChatHistoryListProps {
  * │ 💬 Customer Feedback...    2 days ago │
  * └────────────────────────────────────┘
  *
- * Accessibility:
- * - Uses MUI List/ListItemButton for built-in keyboard navigation
- * - Arrow keys navigate between items
- * - Enter/Space selects item
- * - aria-selected indicates active item
- * - role="listbox" for selection semantics
+ * Accessibility (WI-23a, ADR-34; docs/remediation/keyboard-models.md "ChatHistoryList"):
+ * - A plain list (`ul`, named by `ai.chatHistoryList.listLabel`, "Conversation history") of buttons, not a listbox
+ * - Each conversation is a button and a tab stop; Enter and Space select it. There are no
+ *   arrow-key bindings
+ * - The active conversation has `aria-current="true"`
+ * - The options button is a separate tab stop after its conversation, never inside it
  */
-export declare const ChatHistoryList: React.ForwardRefExoticComponent<ChatHistoryListProps & React.RefAttributes<HTMLUListElement>>;
+export declare const ChatHistoryList: React.ForwardRefExoticComponent<ChatHistoryListProps & React.RefAttributes<HTMLElement>>;
 export default ChatHistoryList;
 //# sourceMappingURL=ChatHistoryList.d.ts.map

package/dist/components/AI/ChatHistoryList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatHistoryList.d.ts","sourceRoot":"","sources":["../../../src/components/AI/ChatHistoryList.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AACxC,OAAO,EAYL,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AAQvB,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iCAAiC;IACjC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,qBAAqB;IACrB,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,yBAAyB;IACzB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,8BAA8B;IAC9B,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,+FAsP3B,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ChatHistoryList.d.ts","sourceRoot":"","sources":["../../../src/components/AI/ChatHistoryList.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAcL,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AAQvB,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAuI1E,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,iCAAiC;IACjC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,qBAAqB;IACrB,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,yBAAyB;IACzB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,8BAA8B;IAC9B,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,oGAAoG;IACpG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,uBAAuB,EAAE,gBAAgB,CAAC,WAAW,EAAE,uBAAuB,CAAC;CAAG;AAMhI;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,0FAqK3B,CAAC;AAEF,eAAe,eAAe,CAAC"}