@runtypelabs/persona 3.6.0 → 3.8.0

package/dist/index.d.cts

@@ -381,6 +381,17 @@ interface MessageTokens {
         /** Assistant bubble box-shadow (token ref or raw CSS, e.g. `none`). */
         shadow?: string;
     };
+    /** Border color between messages in the thread. */
+    border?: TokenReference<'color'>;
+}
+/** Collapsible widget chrome (tool bubbles, reasoning bubbles, approval bubbles). */
+interface CollapsibleWidgetTokens {
+    /** Background for content areas. */
+    container?: TokenReference<'color'>;
+    /** Background for code blocks inside collapsible sections. */
+    surface?: TokenReference<'color'>;
+    /** Border color for collapsible sections. */
+    border?: TokenReference<'color'>;
 }
 interface MarkdownTokens {
     inlineCode: {
@@ -409,6 +420,27 @@ interface MarkdownTokens {
             fontWeight?: string;
         };
     };
+    /** Fenced code block styling. */
+    codeBlock?: {
+        background?: TokenReference<'color'>;
+        borderColor?: TokenReference<'color'>;
+        textColor?: TokenReference<'color'>;
+    };
+    /** Table styling. */
+    table?: {
+        headerBackground?: TokenReference<'color'>;
+        borderColor?: TokenReference<'color'>;
+    };
+    /** Horizontal rule styling. */
+    hr?: {
+        color?: TokenReference<'color'>;
+    };
+    /** Blockquote styling. */
+    blockquote?: {
+        borderColor?: TokenReference<'color'>;
+        background?: TokenReference<'color'>;
+        textColor?: TokenReference<'color'>;
+    };
 }
 interface VoiceTokens {
     recording: {
@@ -528,6 +560,13 @@ interface LabelButtonTokens {
     fontSize?: string;
     gap?: string;
 }
+/** Scroll-to-bottom pill chrome shared by transcript + event stream. */
+interface ScrollToBottomTokens extends ComponentTokenSet {
+    size?: string;
+    gap?: string;
+    fontSize?: string;
+    iconSize?: string;
+}
 /** Toggle group chrome (used by createToggleGroup). */
 interface ToggleGroupTokens {
     /** Gap between toggle buttons. Default: 0 (connected). */
@@ -554,6 +593,8 @@ interface ComponentTokens {
     iconButton?: IconButtonTokens;
     /** Label button styling tokens. */
     labelButton?: LabelButtonTokens;
+    /** Scroll-to-bottom indicator styling tokens. */
+    scrollToBottom?: ScrollToBottomTokens;
     /** Toggle group styling tokens. */
     toggleGroup?: ToggleGroupTokens;
     /** Artifact toolbar, tab strip, and pane chrome. */
@@ -562,6 +603,8 @@ interface ComponentTokens {
         tab?: ArtifactTabTokens;
         pane?: ArtifactPaneTokens;
     };
+    /** Collapsible widget chrome (tool/reasoning/approval bubbles). */
+    collapsibleWidget?: CollapsibleWidgetTokens;
 }
 interface PaletteExtras {
     transitions?: Record<string, string>;
@@ -1114,10 +1157,31 @@ type AgentWidgetArtifactsFeature = {
         defaultRenderer: () => HTMLElement;
     }) => HTMLElement | null;
 };
+type AgentWidgetScrollToBottomFeature = {
+    /**
+     * When true, Persona shows a scroll-to-bottom affordance when the user breaks
+     * away from the latest transcript or event stream content.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Lucide icon name used for the affordance.
+     * @default "arrow-down"
+     */
+    iconName?: string;
+    /**
+     * Optional label text shown next to the icon. Set to an empty string for an
+     * icon-only affordance.
+     * @default ""
+     */
+    label?: string;
+};
 type AgentWidgetFeatureFlags = {
     showReasoning?: boolean;
     showToolCalls?: boolean;
     showEventStreamToggle?: boolean;
+    /** Shared transcript + event stream scroll-to-bottom affordance. */
+    scrollToBottom?: AgentWidgetScrollToBottomFeature;
     /** Configuration for the Event Stream inspector view */
     eventStream?: EventStreamConfig;
     /** Optional artifact sidebar (split pane / mobile drawer) */
@@ -1340,11 +1404,16 @@ type AgentWidgetLauncherConfig = {
      */
     mobileBreakpoint?: number;
     /**
-     * CSS z-index applied to the widget wrapper when it is in a positioned mode
-     * (floating panel, mobile fullscreen, or sidebar). Increase this value if
-     * other elements on the host page appear on top of the widget.
+     * CSS z-index applied to the widget wrapper and launcher button in all
+     * positioned modes (floating panel, mobile fullscreen, sidebar, docked
+     * mobile fullscreen). Increase this value if other elements on the host
+     * page appear on top of the widget.
+     *
+     * In viewport-covering modes (sidebar, mobile fullscreen), the widget
+     * also elevates the host element's stacking context and locks
+     * document scroll to prevent background scrolling.
      *
-     * @default 9999 in overlay modes (mobile fullscreen / sidebar); 50 for the regular floating panel
+     * @default 100000
      */
     zIndex?: number;
     callToActionIconText?: string;

package/dist/index.d.ts

@@ -381,6 +381,17 @@ interface MessageTokens {
         /** Assistant bubble box-shadow (token ref or raw CSS, e.g. `none`). */
         shadow?: string;
     };
+    /** Border color between messages in the thread. */
+    border?: TokenReference<'color'>;
+}
+/** Collapsible widget chrome (tool bubbles, reasoning bubbles, approval bubbles). */
+interface CollapsibleWidgetTokens {
+    /** Background for content areas. */
+    container?: TokenReference<'color'>;
+    /** Background for code blocks inside collapsible sections. */
+    surface?: TokenReference<'color'>;
+    /** Border color for collapsible sections. */
+    border?: TokenReference<'color'>;
 }
 interface MarkdownTokens {
     inlineCode: {
@@ -409,6 +420,27 @@ interface MarkdownTokens {
             fontWeight?: string;
         };
     };
+    /** Fenced code block styling. */
+    codeBlock?: {
+        background?: TokenReference<'color'>;
+        borderColor?: TokenReference<'color'>;
+        textColor?: TokenReference<'color'>;
+    };
+    /** Table styling. */
+    table?: {
+        headerBackground?: TokenReference<'color'>;
+        borderColor?: TokenReference<'color'>;
+    };
+    /** Horizontal rule styling. */
+    hr?: {
+        color?: TokenReference<'color'>;
+    };
+    /** Blockquote styling. */
+    blockquote?: {
+        borderColor?: TokenReference<'color'>;
+        background?: TokenReference<'color'>;
+        textColor?: TokenReference<'color'>;
+    };
 }
 interface VoiceTokens {
     recording: {
@@ -528,6 +560,13 @@ interface LabelButtonTokens {
     fontSize?: string;
     gap?: string;
 }
+/** Scroll-to-bottom pill chrome shared by transcript + event stream. */
+interface ScrollToBottomTokens extends ComponentTokenSet {
+    size?: string;
+    gap?: string;
+    fontSize?: string;
+    iconSize?: string;
+}
 /** Toggle group chrome (used by createToggleGroup). */
 interface ToggleGroupTokens {
     /** Gap between toggle buttons. Default: 0 (connected). */
@@ -554,6 +593,8 @@ interface ComponentTokens {
     iconButton?: IconButtonTokens;
     /** Label button styling tokens. */
     labelButton?: LabelButtonTokens;
+    /** Scroll-to-bottom indicator styling tokens. */
+    scrollToBottom?: ScrollToBottomTokens;
     /** Toggle group styling tokens. */
     toggleGroup?: ToggleGroupTokens;
     /** Artifact toolbar, tab strip, and pane chrome. */
@@ -562,6 +603,8 @@ interface ComponentTokens {
         tab?: ArtifactTabTokens;
         pane?: ArtifactPaneTokens;
     };
+    /** Collapsible widget chrome (tool/reasoning/approval bubbles). */
+    collapsibleWidget?: CollapsibleWidgetTokens;
 }
 interface PaletteExtras {
     transitions?: Record<string, string>;
@@ -1114,10 +1157,31 @@ type AgentWidgetArtifactsFeature = {
         defaultRenderer: () => HTMLElement;
     }) => HTMLElement | null;
 };
+type AgentWidgetScrollToBottomFeature = {
+    /**
+     * When true, Persona shows a scroll-to-bottom affordance when the user breaks
+     * away from the latest transcript or event stream content.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Lucide icon name used for the affordance.
+     * @default "arrow-down"
+     */
+    iconName?: string;
+    /**
+     * Optional label text shown next to the icon. Set to an empty string for an
+     * icon-only affordance.
+     * @default ""
+     */
+    label?: string;
+};
 type AgentWidgetFeatureFlags = {
     showReasoning?: boolean;
     showToolCalls?: boolean;
     showEventStreamToggle?: boolean;
+    /** Shared transcript + event stream scroll-to-bottom affordance. */
+    scrollToBottom?: AgentWidgetScrollToBottomFeature;
     /** Configuration for the Event Stream inspector view */
     eventStream?: EventStreamConfig;
     /** Optional artifact sidebar (split pane / mobile drawer) */
@@ -1340,11 +1404,16 @@ type AgentWidgetLauncherConfig = {
      */
     mobileBreakpoint?: number;
     /**
-     * CSS z-index applied to the widget wrapper when it is in a positioned mode
-     * (floating panel, mobile fullscreen, or sidebar). Increase this value if
-     * other elements on the host page appear on top of the widget.
+     * CSS z-index applied to the widget wrapper and launcher button in all
+     * positioned modes (floating panel, mobile fullscreen, sidebar, docked
+     * mobile fullscreen). Increase this value if other elements on the host
+     * page appear on top of the widget.
+     *
+     * In viewport-covering modes (sidebar, mobile fullscreen), the widget
+     * also elevates the host element's stacking context and locks
+     * document scroll to prevent background scrolling.
      *
-     * @default 9999 in overlay modes (mobile fullscreen / sidebar); 50 for the regular floating panel
+     * @default 100000
      */
     zIndex?: number;
     callToActionIconText?: string;