@runtypelabs/persona 4.33.0 → 4.34.0

package/src/types/theme.ts

@@ -530,6 +530,22 @@ export interface MessageActionsTokens {
   borderRadius?: TokenReference<'radius'>;
 }
 
+/**
+ * Long user message collapse (`features.userMessageCollapse`). Every key is
+ * optional; unset, the fade and the toggle follow the user bubble's own text
+ * color and type, so they already work on any fill in light and dark schemes.
+ */
+export interface UserMessageCollapseTokens {
+  /** Height of the bottom fade on a collapsed bubble. @default "48px" */
+  fadeHeight?: string;
+  /** "Show more" / "Show less" text color. Defaults to the user bubble text color. */
+  toggleForeground?: TokenReference<'color'>;
+  /** Toggle label type size. @default "0.8125rem" */
+  toggleFontSize?: string;
+  /** Toggle label weight. @default "600" */
+  toggleFontWeight?: string;
+}
+
 /**
  * Bubble geometry and type, per role. Every key is unset by default and each
  * one falls back to the value the message layout preset already produced, so
@@ -1307,6 +1323,17 @@ export interface ScrollToBottomTokens extends ComponentTokenSet {
     fontSize?: string;
     fontWeight?: string;
   };
+  /**
+   * The labelled "Approval needed" state shown while a pending approval is
+   * below the fold. Omitted values follow the control's own colors, so it
+   * matches the theme until you give it an accent.
+   */
+  approval?: {
+    background?: TokenReference<'color'>;
+    foreground?: TokenReference<'color'>;
+    border?: TokenReference<'color'>;
+    fontWeight?: string;
+  };
 }
 
 /** Visual tokens shared by one suggestion presentation variant. */
@@ -1357,6 +1384,8 @@ export interface ComponentTokens {
   message: MessageTokens;
   /** Hover-revealed per-message action row (copy, vote, read aloud). */
   messageActions?: MessageActionsTokens;
+  /** Fade and "Show more" toggle on collapsed long user messages. */
+  userMessageCollapse?: UserMessageCollapseTokens;
   /** Welcome / intro card shown above the message list. */
   introCard?: IntroCardTokens;
   /** Markdown surfaces (chat + artifact pane). */

package/src/types.ts

@@ -2228,10 +2228,13 @@ export type AgentWidgetArtifactsFeature = {
  *
  * - `"anchor-top"` (default): on send, scroll the user's message near the top
  *   of the viewport and hold it there while the response streams in beneath it
- *   (ChatGPT-style). When a turn has no user send to anchor to (a proactive
- *   greeting, an injected assistant message, a resubmit, or first-load
- *   streaming), it falls back to `"follow"` for that turn so content never
- *   streams in off-screen.
+ *   (ChatGPT-style). The anchor holds for the whole reply, even when the
+ *   message is taller than the viewport or tool calls push the answer below
+ *   the fold, until the reader scrolls away, jumps to the latest content with
+ *   the scroll-to-bottom control, or sends again. When a turn has no user send
+ *   to anchor to (a proactive greeting, an injected assistant message, a
+ *   resubmit, or first-load streaming), it falls back to `"follow"` for that
+ *   turn so content never streams in off-screen.
  * - `"follow"`: keep the newest content pinned to the bottom of the viewport,
  *   pausing when the user scrolls up and resuming when they return to the
  *   bottom. This was the default before 4.x.
@@ -2320,7 +2323,8 @@ export type AgentWidgetScrollBehaviorFeature = {
 
 /** Decorative glyph state. Hidden glyphs should pause host-owned animation. */
 export type AgentWidgetScrollToBottomIconState = {
-  activity: "idle" | "generating-below";
+  /** `"approval-below"`: a pending approval is below the fold and the turn waits on it. */
+  activity: "idle" | "generating-below" | "approval-below";
   visible: boolean;
   hovered: boolean;
   focused: boolean;
@@ -2360,6 +2364,15 @@ export type AgentWidgetScrollToBottomFeature = {
    * @default ""
    */
   label?: string;
+  /**
+   * Label shown while a pending approval sits below the fold. The control
+   * widens to a labelled pill with the approval's shield glyph, and the turn
+   * stays put until the reader jumps (anchor-top never scrolls them to it).
+   * Styled by `theme.components.scrollToBottom.approval`. Set to an empty
+   * string to keep the regular control.
+   * @default "Approval needed"
+   */
+  approvalLabel?: string;
   /** Glyph while a live response is arriving below. V4 defaults to arrow; V5 to dots. */
   streamingIndicator?: "dots" | "arrow";
   /** Visibility transition. V4 defaults to none; V5 to fade. Honors reduced motion. */
@@ -2788,6 +2801,31 @@ export type AgentWidgetStreamAnimationFeature = {
   plugins?: Record<string, StreamAnimationPlugin>;
 };
 
+/**
+ * Collapse long user messages behind a "Show more" / "Show less" toggle.
+ * Only the built-in user bubble collapses; `layout.messages.renderUserMessage`
+ * and plugin `renderMessage` output is left untouched.
+ */
+export type AgentWidgetUserMessageCollapseFeature = {
+  /**
+   * Clip a user bubble whose rendered content (text, markdown, code,
+   * attachments) is taller than `maxHeight`, with a bottom fade and a real
+   * toggle button. The full message stays in the DOM, so find-in-page, copy,
+   * selection and screen readers still reach it. Interim voice transcripts
+   * stay expanded and collapse once final. A reader's toggle is remembered
+   * per message for the life of the widget.
+   * @default false (`true` under `future.v5Defaults`)
+   */
+  enabled?: boolean;
+  /**
+   * Collapsed height in px. Content within about two lines (48px) of the
+   * limit is left expanded, so the toggle never hides just a line or two.
+   * The default shows about ten lines of bubble text.
+   * @default 240
+   */
+  maxHeight?: number;
+};
+
 export type AgentWidgetFeatureFlags = {
   showReasoning?: boolean;
   showToolCalls?: boolean;
@@ -2804,6 +2842,8 @@ export type AgentWidgetFeatureFlags = {
   scrollToBottom?: AgentWidgetScrollToBottomFeature;
   /** Transcript scroll behavior during streamed responses. */
   scrollBehavior?: AgentWidgetScrollBehaviorFeature;
+  /** "Show more" collapse for long user messages. Off by default; on under `future.v5Defaults`. */
+  userMessageCollapse?: AgentWidgetUserMessageCollapseFeature;
   /** Collapsed transcript behavior for tool call rows. */
   toolCallDisplay?: AgentWidgetToolCallDisplayFeature;
   /** Collapsed transcript behavior for reasoning rows. */
@@ -8433,6 +8473,10 @@ export type AgentWidgetConfig = {
     sendButtonLabel?: string;
     /** Button label shown in text mode while a response is streaming. Default: "Stop". */
     stopButtonLabel?: string;
+    /** Toggle label on a collapsed long user message (`features.userMessageCollapse`). @default "Show more" */
+    showMoreLabel?: string;
+    /** Toggle label on an expanded long user message (`features.userMessageCollapse`). @default "Show less" */
+    showLessLabel?: string;
     /**
      * When false, the welcome / intro card is not shown above the message list.
      * @deprecated Use `welcome.variant: "none"`.