@trinityui/design-system 2.11.1 → 2.13.0

package/dist/components/AppLayout/InsightEnginePanel.d.ts

@@ -12,15 +12,16 @@
  *
  * Section Hierarchy:
  * 1. Header (title, controls)
- * 2. Messages Area (scrollable)
- *    - Empty State
- *    - Message List (response → evidence → actions)
- * 3. Input Area (text input → toolbar → voice overlay)
+ * 2. Messages: ChatThread (H-08), the panel's scroll container and its one role=log
+ *    - Before the first message: AIChatWelcome, the start screen, with the composer centred in
+ *      it (`welcome`); an app's `emptyState` wins and keeps the composer at the bottom
+ *    - Messages: UserMessage and AIMessage (response, then sources and related questions as
+ *      attachments, then the actions)
+ * 3. Input Area (text input → toolbar → listening indicator when the consumer wires voice)
  *
  * Uses Trinity AI components:
- * - AIChatMessage, AITypingIndicator, AIAvatar
- * - AISourcesPanel, AIRelatedQuestions
- * - AIVoiceOverlay, AIListeningIndicator
+ * - ChatThread (AIMessage, UserMessage), AIAvatar, UserAvatar
+ * - InsightEngineInput, AIListeningIndicator
  * @example
  * ```tsx
  *  import { InsightEnginePanel } from '@trinityui/design-system';
@@ -29,7 +30,12 @@
  *  ```
  */
 import React from 'react';
-import { type AISourceCategory } from '../AI';
+import { type SxProps, type Theme } from '@mui/material';
+import { type AIActionErrorContext, type AIBlockEvent, type AIChainOfThoughtProps, type AIFeedbackRating, type AIMessageProps, type AIRelatedQuestion, type AIResponse, type AISourceCategory, type InsightModelOption, type InsightSourceOption } from '../AI';
+import { type ChatThreadMessageActions, type ChatThreadMessageSlots } from '../AI/ChatThread';
+import { type AIChatWelcomeOptions } from '../AI/AIChatWelcome';
+import { type HeadingLevel } from '../shared/headingLevel';
+import { type TrinityRootProps } from '../shared/rootProps';
 import { type ThreadGroup } from './ThreadHistorySidebar';
 export interface ChatMessage {
     id: string;
@@ -37,10 +43,51 @@ export interface ChatMessage {
     content: string;
     timestamp: Date;
     sources?: AISourceCategory[];
+    /**
+     * Whether this assistant message is still loading.
+     * @deprecated Use `streaming` (E-21's alias rule; `streaming` wins when both are set). Removed
+     * in v3.0.
+     */
     isLoading?: boolean;
-    relatedQuestions?: string[];
+    /**
+     * Follow-up questions shown under the answer. Strings, or {@link AIRelatedQuestion} objects
+     * for an id and the verified flag (a verified question shows the 'Verified' badge) since
+     * 2.13.0. Picking one puts its text in the composer.
+     */
+    relatedQuestions?: Array<string | AIRelatedQuestion>;
+    /**
+     * A structured answer (assistant messages): its blocks render instead of `content`, the
+     * interactive ones (a query, a clarification, a plan review) by default, with citations from
+     * `response.sources` and the confidence and verification badges from `response.metadata`.
+     * @since 2.13.0
+     */
+    response?: AIResponse;
+    /**
+     * Whether this assistant message is still being streamed in: its article is busy, and an empty
+     * one shows the shimmer placeholder. When it turns false the thread announces 'Response ready'
+     * once.
+     * @since 2.13.0
+     */
+    streaming?: boolean;
+    /**
+     * The rating already given to this assistant message (for example after a reload): it seeds
+     * the thumbs.
+     * @since 2.13.0
+     */
+    feedback?: AIFeedbackRating | null;
 }
 export type { AISourceCategory };
+/**
+ * The actions of each assistant message in the panel (H-08, D24): ChatThread's message actions,
+ * typed with the panel's own message. Every callback receives the panel's `ChatMessage` (looked up
+ * by id in the panel's messages), never the ChatThread message it renders from.
+ *
+ * An action shows only when its handler is passed; Copy always shows and, without `onCopy`,
+ * writes the message to the clipboard and announces 'Copied' or "Couldn't copy".
+ *
+ * @since 2.13.0
+ */
+export type InsightEnginePanelMessageActions = ChatThreadMessageActions<ChatMessage>;
 /**
  * @deprecated Use AISourceCategory from '@trinityui/design-system' instead.
  * Kept for backwards compatibility only.
@@ -72,28 +119,166 @@ export interface SourceReference {
     favicon?: string;
 }
 /**
- * Props for InsightEnginePanel component.
+ * InsightEnginePanel's own props, without the root element's HTML attributes.
+ * @since 2.13.0
  */
-export interface InsightEnginePanelProps {
-    /** Initial messages to display (uncontrolled mode) */
+export interface InsightEnginePanelOwnProps {
+    /** Initial messages to display (uncontrolled mode); read on the first render only. */
     initialMessages?: ChatMessage[];
     /** Controlled messages - when provided, component uses external state */
     messages?: ChatMessage[];
-    /** Callback when messages change - required for controlled mode */
+    /**
+     * Called with the next messages on every change, in both modes. Required with `messages`:
+     * without it the panel cannot add the user's message (a development warning says so).
+     */
     onMessagesChange?: (messages: ChatMessage[]) => void;
-    /** Placeholder text for input */
+    /** Placeholder of the composer. @default 'Ask anything. Type @ for mentions and / for shortcuts.' (`ai.insightEnginePanel.composerPlaceholder`) */
     placeholder?: string;
-    /** Title for the panel */
+    /** Title for the panel. @default 'Insight Engine' (`ai.insightEnginePanel.title`) */
     title?: string;
-    /** Subtitle for the panel */
+    /**
+     * Heading level of the title: 2 to 6 for h2 to h6. Set it to fit the page outline;
+     * `headingLevel={6}` restores the h6 the title rendered before the prop existed.
+     * @default 2
+     * @since 2.13.0
+     */
+    headingLevel?: HeadingLevel;
+    /**
+     * Id of the title heading, for `aria-labelledby` on the region or dialog that holds the
+     * panel. Without it, the panel generates one.
+     * @since 2.13.0
+     */
+    titleId?: string;
+    /** A caption under the title, outside the heading. Nothing renders without it. */
     subtitle?: string;
-    /** Callback when user sends a message */
+    /**
+     * Called once per send with the message and its options: `proSearch` (deep thinking),
+     * `model` (the selected model's id) and `sources` (the enabled sources' ids).
+     * `model` and `sources` @since 2.13.0.
+     */
     onSendMessage?: (message: string, options?: {
         proSearch?: boolean;
         focus?: string;
+        model?: string;
+        sources?: string[];
     }) => void;
-    /** Show typing indicator */
+    /**
+     * Shows a streaming entry (the shimmer placeholder) after the last message while an answer is
+     * awaited.
+     * @deprecated Use `streaming` (E-21's alias rule; `streaming` wins when both are passed).
+     * Removed in v3.0.
+     */
     isTyping?: boolean;
+    /**
+     * Whether an answer is on its way: a streaming entry (the shimmer placeholder) follows the last
+     * message. Replaces `isTyping`.
+     * @default false
+     * @since 2.13.0
+     */
+    streaming?: boolean;
+    /**
+     * Whether the conversation is loading (for example a thread opened from the history): the log
+     * is `aria-busy`, and without messages it shows decorative placeholders instead of the empty
+     * state.
+     * @default false
+     * @since 2.13.0
+     */
+    loading?: boolean;
+    /**
+     * The actions of each assistant message (D24): `onCopy` and `copyBehavior`, `onFeedback` (the
+     * thumbs), `onFeedbackSubmit` (the detailed feedback form), `onShare`, `onDownload`,
+     * `onRegenerate`, `getActions` (app actions) and `getGoldenDataset` (the built-in 'Add to golden
+     * dataset' action, shown only when it returns `canAdd: true` for your permitted users; GA-01).
+     * Each callback receives the panel's message. An
+     * action shows only when its handler is passed; Copy always shows and, without `onCopy`, writes
+     * to the clipboard. In demo mode the panel supplies working demo thumbs and Regenerate; a
+     * handler passed here wins.
+     * @since 2.13.0
+     */
+    messageActions?: InsightEnginePanelMessageActions;
+    /**
+     * Shows Regenerate on each assistant message and is called with the panel's message. Return a
+     * promise to show the action as busy until it settles; a rejection shows "Couldn't regenerate
+     * the response" with Try again. Shorthand for `messageActions.onRegenerate`, which wins when
+     * both are passed.
+     * @since 2.13.0
+     */
+    onRegenerate?: (message: ChatMessage) => void | Promise<void>;
+    /**
+     * Formats a message's `timestamp` into the time shown in its footer. Return `undefined` for
+     * none.
+     * @default () => undefined (no timestamp, as before)
+     * @since 2.13.0
+     */
+    formatTimestamp?: (date: Date) => string | undefined;
+    /**
+     * Called with the panel's message and what the user did in an interactive block of its
+     * `response` (answered a clarification, confirmed or edited a plan, opened a query). Return the
+     * promise of your request: it drives the block's pending state, and a rejection shows the
+     * block's error and reaches `onActionError`. While the latest answer holds a required
+     * clarification, the composer is unavailable with the reason shown; without this handler there
+     * is no gate.
+     * @since 2.13.0
+     */
+    onBlockEvent?: (message: ChatMessage, event: AIBlockEvent) => void | Promise<void>;
+    /**
+     * Block renderers by block type (ChatThread `blockRenderers`): the interactive blocks render by
+     * default with `hitlBlockRenderers`; an entry here wins for its type and `null` turns a default
+     * off. Keep the object stable (module scope or `useMemo`).
+     * @since 2.13.0
+     */
+    blockRenderers?: AIMessageProps['blockRenderers'];
+    /**
+     * Renders any block first: return a node, `null` to skip the block, or `undefined` to fall
+     * through (ChatThread `renderBlock`).
+     * @since 2.13.0
+     */
+    renderBlock?: AIMessageProps['renderBlock'];
+    /**
+     * Overrides the slots of an assistant message (`badges`, `feedbackControl`, `attachments`),
+     * called with the panel's message and the slots the panel built for it: return a node to
+     * replace a slot, `null` to leave it empty, or leave the key out to keep the default. With
+     * `getReasoning`, `defaults.attachments` already holds the reasoning before the sources and
+     * related questions.
+     * @since 2.13.0
+     */
+    getMessageSlots?: (message: ChatMessage, defaults: ChatThreadMessageSlots) => {
+        [K in keyof ChatThreadMessageSlots]?: React.ReactNode | null;
+    } | undefined;
+    /**
+     * The reasoning of an assistant message: return AIChainOfThought's props (its phases: the
+     * thinking, a plan awaiting confirmation, a failed task with Retry) to show the chain in the
+     * message, ahead of its sources and related questions, or nothing for none. The chain's
+     * content is markdown unless you pass `contentFormat`; its failures reach `onActionError`.
+     * @since 2.13.0
+     */
+    getReasoning?: (message: ChatMessage) => AIChainOfThoughtProps | null | undefined;
+    /**
+     * Called when an action of a message fails (Regenerate, Copy, an app action, a block event, the
+     * reasoning's Retry), with the message's id in the context. Without it the error goes to
+     * `globalThis.reportError`.
+     * @since 2.13.0
+     */
+    onActionError?: (error: unknown, context: AIActionErrorContext) => void;
+    /**
+     * The start screen before the first message: AIChatWelcome with the panel's composer centred
+     * in it, which moves to the bottom after the first message (no motion under reduced motion).
+     * Pass its options (`variant`, `userName`, `greeting`, `subtitle`, `suggestions`,
+     * `suggestionBehavior`, `onSuggestionSelect`, `updates`, `scope`, `recentThreads`,
+     * `onRecentThreadClick`, `disclaimer`, `guidelinesHref`, …). Without `recentThreads` the
+     * context variant's "Continue" lists the first two threads of `threadGroups`, opened through
+     * `onThreadSelect`. A suggestion sends through the panel by default. `false` shows the
+     * previous empty state ('What do you want to know?') above the bottom composer.
+     * @default {} (the showcase variant with the default greeting)
+     * @since 2.13.0
+     */
+    welcome?: AIChatWelcomeOptions | false;
+    /**
+     * What the thread shows before the first message, instead of the start screen: your node, in
+     * the thread, with the composer at the bottom (as before `welcome`). It wins over `welcome`.
+     * @since 2.13.0
+     */
+    emptyState?: React.ReactNode;
     /** Custom AI avatar */
     aiAvatar?: React.ReactNode;
     /** Callback when close button is clicked */
@@ -104,17 +289,30 @@ export interface InsightEnginePanelProps {
     onFullscreenToggle?: () => void;
     /** Show the panel controls (close, fullscreen) */
     showControls?: boolean;
-    /** Enable demo mode with fake responses */
+    /**
+     * Demo mode: canned answers after a 2 s delay and a sample thread history, labelled
+     * 'Demo responses' in the title. Undefined means derived: on when neither
+     * `onSendMessage` nor `messages` is passed, off when either is (a development warning
+     * says the demo was suppressed). Leaving it undefined on an unwired panel is
+     * deprecated: the default becomes `false` in v3.0, so pass `demoMode` explicitly.
+     */
     demoMode?: boolean;
     /** Callback when new thread is created */
     onNewThread?: () => void;
-    /** Theme mode - defaults to MUI theme */
+    /**
+     * Has no effect: the panel takes its mode from the MUI theme. Passing it logs a one-time
+     * development warning.
+     * @deprecated The mode comes from the theme (`ThemeProvider`); remove the prop. Removed in v3.0.
+     */
     themeMode?: 'light' | 'dark';
     /** Whether to use boxed layout (centered content with max-width) in fullscreen */
     boxedLayout?: boolean;
     /** Callback when boxed layout toggle is clicked */
     onBoxedLayoutToggle?: () => void;
-    /** User initials to display in avatar */
+    /**
+     * The signed-in user's initials, shown in the avatar of their messages. Without it the
+     * avatar shows the generic user avatar.
+     */
     userInitials?: string;
     /** Whether to show the history sidebar */
     showHistory?: boolean;
@@ -132,6 +330,102 @@ export interface InsightEnginePanelProps {
     onThreadRename?: (threadId: string, newTitle: string) => void;
     /** Callback when thread is starred/unstarred */
     onThreadStar?: (threadId: string) => void;
+    /**
+     * Adds 'Add files or photos' to the composer's tools menu and is called when it is chosen.
+     * Without it the item does not render.
+     * @since 2.13.0
+     */
+    onAttachmentClick?: () => void;
+    /**
+     * Whether web search is on: the checked state of the tools menu's 'Web search' item. Needs
+     * `onWebSearchToggle`.
+     * @default false
+     * @since 2.13.0
+     */
+    webSearchEnabled?: boolean;
+    /**
+     * Adds the 'Web search' toggle to the composer's tools menu and is called with the next
+     * value. Without it the item does not render.
+     * @since 2.13.0
+     */
+    onWebSearchToggle?: (enabled: boolean) => void;
+    /**
+     * Adds the 'Dictate' button to the composer and is called when it is pressed (start or stop
+     * your speech capture there). Without it the button does not render.
+     * @since 2.13.0
+     */
+    onVoiceClick?: () => void;
+    /**
+     * Whether your speech capture is listening (controlled): the pressed state of 'Dictate',
+     * and, with `onVoiceClick`, the listening indicator under the composer.
+     * @default false
+     * @since 2.13.0
+     */
+    listening?: boolean;
+    /**
+     * The models of the composer's model menu. Without it the panel shows a built-in sample list
+     * (deprecated: it becomes empty in v3.0, and a one-time development warning says so).
+     * @since 2.13.0
+     */
+    modelOptions?: InsightModelOption[];
+    /**
+     * The data sources of the composer's source menu. Without it the panel shows a built-in
+     * sample list (deprecated: it becomes empty in v3.0, and a one-time development warning says
+     * so).
+     * @since 2.13.0
+     */
+    sourceOptions?: InsightSourceOption[];
+    /**
+     * The selected model's id (controlled). Pair it with `onModelChange`.
+     * @since 2.13.0
+     */
+    selectedModel?: string;
+    /**
+     * The model selected first (uncontrolled).
+     * @default the first of `modelOptions`, else 'gpt-4o'
+     * @since 2.13.0
+     */
+    defaultSelectedModel?: string;
+    /**
+     * Called with the model id the user chooses, in both modes.
+     * @since 2.13.0
+     */
+    onModelChange?: (modelId: string) => void;
+    /**
+     * The enabled sources' ids (controlled). Pair it with `onSourcesChange`.
+     * @since 2.13.0
+     */
+    enabledSources?: string[];
+    /**
+     * The sources enabled first (uncontrolled).
+     * @default the `sourceOptions` marked `enabled`, else ['web', 'documents']
+     * @since 2.13.0
+     */
+    defaultEnabledSources?: string[];
+    /**
+     * Called with the next enabled sources' ids when the user toggles one, in both modes.
+     * @since 2.13.0
+     */
+    onSourcesChange?: (sourceIds: string[]) => void;
+    /**
+     * Added to the root's own class names.
+     * @since 2.13.0
+     */
+    className?: string;
+    /**
+     * Styles for the root, applied after its own. Object, array and function forms all apply.
+     * @since 2.13.0
+     */
+    sx?: SxProps<Theme>;
+}
+/**
+ * Props for InsightEnginePanel component.
+ *
+ * Besides its own props, the root takes the HTML attributes of its `div` (`id`, `data-*`,
+ * `aria-*`, event handlers), spread before its own (ADR-04). The panel owns no attribute on its
+ * root.
+ */
+export interface InsightEnginePanelProps extends InsightEnginePanelOwnProps, TrinityRootProps<HTMLDivElement, InsightEnginePanelOwnProps> {
 }
 /**
  * InsightEnginePanel - AI chat interface with Trinity branding

package/dist/components/AppLayout/InsightEnginePanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InsightEnginePanel.d.ts","sourceRoot":"","sources":["../../../src/components/AppLayout/InsightEnginePanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAsC,MAAM,OAAO,CAAC;AAW3D,OAAO,EAWL,KAAK,gBAAgB,EAGtB,MAAM,OAAO,CAAC;AAGf,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAehF,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAGD,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IACrD,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7F,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,wCAAwC;IACxC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,kDAAkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,kFAAkF;IAClF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mDAAmD;IACnD,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,4CAA4C;IAC5C,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,sCAAsC;IACtC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,sCAAsC;IACtC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D,gDAAgD;IAChD,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAsID;;GAEG;AACH,eAAO,MAAM,kBAAkB,gGA2b7B,CAAC;AAEH,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"InsightEnginePanel.d.ts","sourceRoot":"","sources":["../../../src/components/AppLayout/InsightEnginePanel.tsx"],"names":[],"mappings":"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"}

package/dist/components/AppLayout/ResizablePanel.d.ts

@@ -2,7 +2,8 @@
  * @fileoverview ResizablePanel component.
  * @module components/AppLayout/ResizablePanel
  * ResizablePanel Component
- * A panel that can be resized by dragging its edge
+ * A panel that can be resized by dragging its edge or, with the keyboard,
+ * through its focusable window-splitter handle.
  * @example
  * ```tsx
  *  import { ResizablePanel } from '@trinityui/design-system';
@@ -13,26 +14,153 @@
  *    <div>Example content</div>
  *  </ResizablePanel>
  *  ```
+ * @example
+ * ```tsx
+ *  // Controlled width: the parent owns the value.
+ *  const [width, setWidth] = React.useState(400);
+ *  <ResizablePanel open width={width} onWidthChange={setWidth}>
+ *    <div>Example content</div>
+ *  </ResizablePanel>
+ *  ```
  */
 import React from 'react';
 import { SxProps, Theme } from '@mui/material';
+/**
+ * The strings ResizablePanel renders, for `labels` (docs/NAMING.md, "Label
+ * overrides (non-AI)").
+ * @since 2.13.0
+ */
+export interface ResizablePanelLabels {
+    /**
+     * Accessible name of the resize handle (the window splitter,
+     * `role="separator"`).
+     * @default 'Resize panel'
+     */
+    resizeHandle: string;
+    /**
+     * Tooltip and accessible name of the header close button.
+     * @default 'Close panel'
+     */
+    close: string;
+}
 /**
  * Props for ResizablePanel component.
  */
 export interface ResizablePanelProps {
-    /** Whether the panel is open */
+    /**
+     * Whether the panel is open. A closed panel renders nothing (or, with
+     * `keepMounted`, stays mounted but hidden). Closing it during a pointer
+     * drag ends the drag (`onResizeEnd` fires once with the width reached), as
+     * `disableResize` does.
+     */
     open: boolean;
+    /**
+     * Keep the panel and its children mounted while it is closed, so their
+     * state (a draft, a scroll position, a conversation) survives closing and
+     * reopening. A closed kept-mounted panel is `display: none` (through `sx`,
+     * after the consumer's `sx`), `hidden` and `inert`: invisible, out of the
+     * Tab sequence and out of the accessibility tree.
+     * @default false
+     * @since 2.13.0
+     */
+    keepMounted?: boolean;
     /** Panel content */
     children: React.ReactNode;
-    /** Default width of the panel */
+    /**
+     * Initial width in px when uncontrolled (no `width` prop). Read on mount
+     * only: changing it later does not resize the panel. To reset an
+     * uncontrolled panel, remount it with a new `key`, or control `width`.
+     * @default 400
+     */
     defaultWidth?: number;
-    /** Minimum width the panel can be resized to */
+    /**
+     * Controlled width in px. When set, the panel renders this width (kept
+     * within `minWidth`–`maxWidth`) and never changes it on its own: drag and
+     * keyboard resizes report the next width through `onWidthChange`, and the
+     * parent applies it. Both start from the width the panel renders, so a
+     * width outside the range moves with the first pointer move or key press.
+     * Omit it to let the panel manage its own width from `defaultWidth`. The
+     * mode is decided on the first render; switching between `undefined` and a
+     * number afterwards is unsupported and logs a warning in development that
+     * names `ResizablePanel` and `width`.
+     * @since 2.13.0
+     */
+    width?: number;
+    /**
+     * Called with the next width in px, already clamped to
+     * `minWidth`–`maxWidth`, whenever the user resizes the panel, in both
+     * controlled and uncontrolled mode. During a drag it fires on every pointer
+     * move (the value can repeat at a bound); with the keyboard it fires once
+     * per key press that changes the width. Not called when a controlled
+     * `width` changes.
+     * @since 2.13.0
+     */
+    onWidthChange?: (width: number) => void;
+    /**
+     * Called once when a pointer (mouse or touch) drag on the handle starts.
+     * Keyboard resizes do not call it; they report through `onWidthChange`.
+     * Same contract as SplitPane's `onResizeStart`.
+     * @since 2.13.0
+     */
+    onResizeStart?: () => void;
+    /**
+     * Called once when a pointer (mouse or touch) drag on the handle ends, with
+     * the final width in px. Keyboard resizes do not call it. Same contract as
+     * SplitPane's `onResizeEnd`. The panel's own width animation stays off from
+     * `onResizeStart` until this call, so a parent that pauses its own
+     * transitions between the two callbacks turns them back on in the same
+     * commit as the panel.
+     * @since 2.13.0
+     */
+    onResizeEnd?: (width: number) => void;
+    /**
+     * Accessible name of the resize handle (a focusable window splitter,
+     * `role="separator"`). Same as `labels.resizeHandle`, which wins when both
+     * are passed.
+     * @default 'Resize panel'
+     * @since 2.13.0
+     */
+    resizeHandleLabel?: string;
+    /**
+     * Overrides for the strings the panel renders: `resizeHandle` (the
+     * splitter's accessible name, default 'Resize panel') and `close` (the close
+     * button's tooltip and name, default 'Close panel'). Pass only the keys you
+     * change; a key set to `undefined` keeps its default.
+     * @since 2.13.0
+     */
+    labels?: Partial<ResizablePanelLabels>;
+    /**
+     * Turns resizing off: the resize handle is not rendered, so there is no
+     * Tab stop, no drag and no `aria-valuenow` to read. Use it while the panel
+     * does not show its width, for example when it fills the screen. A drag in
+     * progress ends (`onResizeEnd` fires). The width is kept: an uncontrolled
+     * panel shows the same width when resizing is turned back on.
+     * @default false
+     * @since 2.13.0
+     */
+    disableResize?: boolean;
+    /**
+     * Minimum width the panel can be resized to. Also the handle's
+     * `aria-valuemin` and the width the Home key moves to.
+     * @default 320
+     */
     minWidth?: number;
-    /** Maximum width the panel can be resized to */
+    /**
+     * Maximum width the panel can be resized to. Also the handle's
+     * `aria-valuemax` and the width the End key moves to.
+     * @default 800
+     */
     maxWidth?: number;
     /** Callback when panel is closed */
     onClose?: () => void;
-    /** Which side the panel is on */
+    /**
+     * Which side the panel is on, as a logical side: `'right'` is the inline
+     * end and `'left'` the inline start. Left to right that is the right and
+     * the left edge; under a right-to-left theme (`theme.direction: 'rtl'`)
+     * the sides swap, and the drag and the arrow keys follow (the arrow that
+     * points toward the content widens the panel).
+     * @default 'right'
+     */
     side?: 'left' | 'right';
     /** Header content */
     header?: React.ReactNode;
@@ -44,8 +172,17 @@ export interface ResizablePanelProps {
     contentSx?: SxProps<Theme>;
 }
 /**
- * ResizablePanel - A panel that can be resized by dragging.
- * Used for sidebars, AI chat panels, and other expandable content areas.
+ * ResizablePanel - A panel that can be resized by dragging its edge or with
+ * the keyboard. Used for sidebars, AI chat panels, and other expandable
+ * content areas.
+ *
+ * The edge handle is a focusable window splitter (WAI-ARIA APG Window
+ * Splitter): `role="separator"` with `aria-orientation="vertical"`,
+ * `aria-valuenow` / `aria-valuemin` / `aria-valuemax` in px and
+ * `aria-controls` pointing at the panel. Left/Right Arrow move the splitter
+ * by 10px (50px with Shift) in the arrow's direction, also right to left;
+ * Home and End move it to `minWidth` and `maxWidth` (the shared keyboard
+ * model of SplitPane). With `disableResize` the handle is not rendered.
  */
 export declare const ResizablePanel: React.ForwardRefExoticComponent<ResizablePanelProps & React.RefAttributes<HTMLDivElement>>;
 export default ResizablePanel;

package/dist/components/AppLayout/ResizablePanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ResizablePanel.d.ts","sourceRoot":"","sources":["../../../src/components/AppLayout/ResizablePanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAmD,MAAM,OAAO,CAAC;AACxE,OAAO,EAA4B,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGzE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,oBAAoB;IACpB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,qBAAqB;IACrB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,kCAAkC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CAC5B;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,4FA2L1B,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"ResizablePanel.d.ts","sourceRoot":"","sources":["../../../src/components/AppLayout/ResizablePanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AACnD,OAAO,EAA4B,OAAO,EAAE,KAAK,EAAY,MAAM,eAAe,CAAC;AASnF;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,IAAI,EAAE,OAAO,CAAC;IACd;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oBAAoB;IACpB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACvC;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,qBAAqB;IACrB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,kCAAkC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CAC5B;AAQD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,4FA4R1B,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/components/AppLayout/ThreadHistorySidebar.d.ts

@@ -11,6 +11,7 @@
  *  ```
  */
 import React from 'react';
+import { type SxProps, type Theme } from '@mui/material';
 export interface ThreadItem {
     id: string;
     title: string;
@@ -47,6 +48,11 @@ export interface ThreadHistorySidebarProps {
     open?: boolean;
     /** Width of the sidebar */
     width?: number;
+    /**
+     * Styles merged after the root's own, for the host's layout (InsightEnginePanel stacks the
+     * history above the thread in a narrow panel).
+     */
+    sx?: SxProps<Theme>;
 }
 export declare const ThreadHistorySidebar: React.ForwardRefExoticComponent<ThreadHistorySidebarProps & React.RefAttributes<HTMLDivElement>>;
 export default ThreadHistorySidebar;

package/dist/components/AppLayout/ThreadHistorySidebar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThreadHistorySidebar.d.ts","sourceRoot":"","sources":["../../../src/components/AppLayout/ThreadHistorySidebar.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AA6BxC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,6CAA6C;IAC7C,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,sCAAsC;IACtC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,sCAAsC;IACtC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D,gDAAgD;IAChD,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAmCD,eAAO,MAAM,oBAAoB,kGAsVhC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"ThreadHistorySidebar.d.ts","sourceRoot":"","sources":["../../../src/components/AppLayout/ThreadHistorySidebar.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAsC,MAAM,OAAO,CAAC;AAC3D,OAAO,EAeL,KAAK,OAAO,EACZ,KAAK,KAAK,EACX,MAAM,eAAe,CAAC;AASvB,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,6CAA6C;IAC7C,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,sCAAsC;IACtC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,sCAAsC;IACtC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D,gDAAgD;IAChD,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AA+CD,eAAO,MAAM,oBAAoB,kGAkXhC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/components/AppLayout/index.d.ts

@@ -3,11 +3,11 @@
  * Reusable application layout templates with navigation and AI panel support
  */
 export { AppLayout } from './AppLayout';
-export type { AppLayoutProps, NavStyle, AITrigger, NavItem } from './AppLayout';
+export type { AppLayoutProps, AppLayoutAiPanelApi, NavStyle, AITrigger, NavItem } from './AppLayout';
 export { ResizablePanel } from './ResizablePanel';
-export type { ResizablePanelProps } from './ResizablePanel';
+export type { ResizablePanelProps, ResizablePanelLabels } from './ResizablePanel';
 export { InsightEnginePanel } from './InsightEnginePanel';
-export type { InsightEnginePanelProps, ChatMessage, SourceCategory, SourceItem, SourceReference } from './InsightEnginePanel';
+export type { InsightEnginePanelProps, InsightEnginePanelOwnProps, InsightEnginePanelMessageActions, ChatMessage, SourceCategory, SourceItem, SourceReference, } from './InsightEnginePanel';
 export { ThreadHistorySidebar } from './ThreadHistorySidebar';
 export type { ThreadHistorySidebarProps, ThreadItem, ThreadGroup } from './ThreadHistorySidebar';
 export { AIFab } from './AIFab';