@runtypelabs/persona 3.6.0 → 3.8.0

package/dist/theme-editor.d.cts

@@ -214,6 +214,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: {
@@ -242,6 +253,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: {
@@ -361,6 +393,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). */
@@ -387,6 +426,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. */
@@ -395,6 +436,8 @@ interface ComponentTokens {
         tab?: ArtifactTabTokens;
         pane?: ArtifactPaneTokens;
     };
+    /** Collapsible widget chrome (tool/reasoning/approval bubbles). */
+    collapsibleWidget?: CollapsibleWidgetTokens;
 }
 interface PaletteExtras {
     transitions?: Record<string, string>;
@@ -1063,10 +1106,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) */
@@ -1289,11 +1353,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;
@@ -3788,6 +3857,7 @@ declare const ROLE_HEADER: RoleAssignmentOptions;
 declare const ROLE_USER_MESSAGES: RoleAssignmentOptions;
 declare const ROLE_ASSISTANT_MESSAGES: RoleAssignmentOptions;
 declare const ROLE_PRIMARY_ACTIONS: RoleAssignmentOptions;
+declare const ROLE_SCROLL_TO_BOTTOM: RoleAssignmentOptions;
 declare const ROLE_INPUT: RoleAssignmentOptions;
 declare const ROLE_LINKS_FOCUS: RoleAssignmentOptions;
 declare const ROLE_BORDERS: RoleAssignmentOptions;
@@ -3854,4 +3924,4 @@ declare function paletteColorPath(family: string, shade: string): string;
 declare function resolveThemeColorPath(get: (path: string) => unknown, path: string, depth?: number): string;
 declare function tokenRefDisplayName(path: string): string;
 
-export { ADVANCED_TOKENS_SECTION, ALL_ROLES, ALL_TABS, BRAND_PALETTE_SECTION, BUILT_IN_PRESETS, COLORS_SECTIONS, COLOR_FAMILIES, COMPONENTS_SECTIONS, COMPONENT_COLOR_SECTIONS, COMPONENT_SHAPE_SECTIONS, CONFIGURE_SECTIONS, CONFIGURE_SUB_GROUPS, type ColorScaleOptions, type CompareMode, type ConfigChangeListener, type ConfiguratorSnapshot, DEVICE_DIMENSIONS, type DetectedRoleAssignment, type FieldDef, type FieldType, HOME_SUGGESTION_CHIPS, INTERFACE_ROLES_SECTION, MOCK_BROWSER_CONTENT, MOCK_WORKSPACE_CONTENT, type OnChangeCallback, PALETTE_SECTION, PREVIEW_STORAGE_ADAPTER, type PreviewConfigOptions, type PreviewDevice, type PreviewLifecycleContext, type PreviewScene, type PreviewShellMode, type PreviewShellPalette, ROLE_ASSISTANT_MESSAGES, ROLE_BORDERS, ROLE_FAMILIES, ROLE_FAMILY_LABELS, ROLE_HEADER, ROLE_INPUT, ROLE_INTENSITIES, ROLE_LINKS_FOCUS, ROLE_PRIMARY_ACTIONS, ROLE_SURFACES, ROLE_USER_MESSAGES, type RoleAssignmentOptions, type RoleFamily, type RoleIntensity, type RoleTarget, type RoleTargetKind, SEMANTIC_COLORS_SECTION, SHADE_KEYS, SHELL_STYLE_ID, STATUS_COLORS_SECTION, STATUS_PALETTE_SECTION, STYLE_SECTIONS, STYLE_SECTIONS_V2, type SectionDef, type SectionPreset, type SelectOption, type SliderOptions, type SubGroupDef, THEME_EDITOR_PRESETS, THEME_SECTION, type TabDef, type ThemeEditorPreset, ThemeEditorState, type ThemePreviewHandle, type ThemePreviewOptions, type TokenRefOptions, ZOOM_MAX, ZOOM_MIN, applySceneConfig, applyShellTheme, buildPreviewConfig, buildShellCss, buildSrcdoc, convertFromPx, convertToPx, createPreviewMessages, createThemePreview, detectRoleAssignment, escapeHtml, findSection, formatCssValue, generateColorScale, getShellPalette, getThemeEditorPreset, hexToHsl, hslToHex, isValidHex, normalizeColorValue, paletteColorPath, parseCssValue, resolveRoleAssignment, resolveThemeColorPath, scopeSection, tokenRefDisplayName, wcagContrastRatio };
+export { ADVANCED_TOKENS_SECTION, ALL_ROLES, ALL_TABS, BRAND_PALETTE_SECTION, BUILT_IN_PRESETS, COLORS_SECTIONS, COLOR_FAMILIES, COMPONENTS_SECTIONS, COMPONENT_COLOR_SECTIONS, COMPONENT_SHAPE_SECTIONS, CONFIGURE_SECTIONS, CONFIGURE_SUB_GROUPS, type ColorScaleOptions, type CompareMode, type ConfigChangeListener, type ConfiguratorSnapshot, DEVICE_DIMENSIONS, type DetectedRoleAssignment, type FieldDef, type FieldType, HOME_SUGGESTION_CHIPS, INTERFACE_ROLES_SECTION, MOCK_BROWSER_CONTENT, MOCK_WORKSPACE_CONTENT, type OnChangeCallback, PALETTE_SECTION, PREVIEW_STORAGE_ADAPTER, type PreviewConfigOptions, type PreviewDevice, type PreviewLifecycleContext, type PreviewScene, type PreviewShellMode, type PreviewShellPalette, ROLE_ASSISTANT_MESSAGES, ROLE_BORDERS, ROLE_FAMILIES, ROLE_FAMILY_LABELS, ROLE_HEADER, ROLE_INPUT, ROLE_INTENSITIES, ROLE_LINKS_FOCUS, ROLE_PRIMARY_ACTIONS, ROLE_SCROLL_TO_BOTTOM, ROLE_SURFACES, ROLE_USER_MESSAGES, type RoleAssignmentOptions, type RoleFamily, type RoleIntensity, type RoleTarget, type RoleTargetKind, SEMANTIC_COLORS_SECTION, SHADE_KEYS, SHELL_STYLE_ID, STATUS_COLORS_SECTION, STATUS_PALETTE_SECTION, STYLE_SECTIONS, STYLE_SECTIONS_V2, type SectionDef, type SectionPreset, type SelectOption, type SliderOptions, type SubGroupDef, THEME_EDITOR_PRESETS, THEME_SECTION, type TabDef, type ThemeEditorPreset, ThemeEditorState, type ThemePreviewHandle, type ThemePreviewOptions, type TokenRefOptions, ZOOM_MAX, ZOOM_MIN, applySceneConfig, applyShellTheme, buildPreviewConfig, buildShellCss, buildSrcdoc, convertFromPx, convertToPx, createPreviewMessages, createThemePreview, detectRoleAssignment, escapeHtml, findSection, formatCssValue, generateColorScale, getShellPalette, getThemeEditorPreset, hexToHsl, hslToHex, isValidHex, normalizeColorValue, paletteColorPath, parseCssValue, resolveRoleAssignment, resolveThemeColorPath, scopeSection, tokenRefDisplayName, wcagContrastRatio };

package/dist/theme-editor.d.ts

@@ -214,6 +214,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: {
@@ -242,6 +253,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: {
@@ -361,6 +393,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). */
@@ -387,6 +426,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. */
@@ -395,6 +436,8 @@ interface ComponentTokens {
         tab?: ArtifactTabTokens;
         pane?: ArtifactPaneTokens;
     };
+    /** Collapsible widget chrome (tool/reasoning/approval bubbles). */
+    collapsibleWidget?: CollapsibleWidgetTokens;
 }
 interface PaletteExtras {
     transitions?: Record<string, string>;
@@ -1063,10 +1106,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) */
@@ -1289,11 +1353,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;
@@ -3788,6 +3857,7 @@ declare const ROLE_HEADER: RoleAssignmentOptions;
 declare const ROLE_USER_MESSAGES: RoleAssignmentOptions;
 declare const ROLE_ASSISTANT_MESSAGES: RoleAssignmentOptions;
 declare const ROLE_PRIMARY_ACTIONS: RoleAssignmentOptions;
+declare const ROLE_SCROLL_TO_BOTTOM: RoleAssignmentOptions;
 declare const ROLE_INPUT: RoleAssignmentOptions;
 declare const ROLE_LINKS_FOCUS: RoleAssignmentOptions;
 declare const ROLE_BORDERS: RoleAssignmentOptions;
@@ -3854,4 +3924,4 @@ declare function paletteColorPath(family: string, shade: string): string;
 declare function resolveThemeColorPath(get: (path: string) => unknown, path: string, depth?: number): string;
 declare function tokenRefDisplayName(path: string): string;
 
-export { ADVANCED_TOKENS_SECTION, ALL_ROLES, ALL_TABS, BRAND_PALETTE_SECTION, BUILT_IN_PRESETS, COLORS_SECTIONS, COLOR_FAMILIES, COMPONENTS_SECTIONS, COMPONENT_COLOR_SECTIONS, COMPONENT_SHAPE_SECTIONS, CONFIGURE_SECTIONS, CONFIGURE_SUB_GROUPS, type ColorScaleOptions, type CompareMode, type ConfigChangeListener, type ConfiguratorSnapshot, DEVICE_DIMENSIONS, type DetectedRoleAssignment, type FieldDef, type FieldType, HOME_SUGGESTION_CHIPS, INTERFACE_ROLES_SECTION, MOCK_BROWSER_CONTENT, MOCK_WORKSPACE_CONTENT, type OnChangeCallback, PALETTE_SECTION, PREVIEW_STORAGE_ADAPTER, type PreviewConfigOptions, type PreviewDevice, type PreviewLifecycleContext, type PreviewScene, type PreviewShellMode, type PreviewShellPalette, ROLE_ASSISTANT_MESSAGES, ROLE_BORDERS, ROLE_FAMILIES, ROLE_FAMILY_LABELS, ROLE_HEADER, ROLE_INPUT, ROLE_INTENSITIES, ROLE_LINKS_FOCUS, ROLE_PRIMARY_ACTIONS, ROLE_SURFACES, ROLE_USER_MESSAGES, type RoleAssignmentOptions, type RoleFamily, type RoleIntensity, type RoleTarget, type RoleTargetKind, SEMANTIC_COLORS_SECTION, SHADE_KEYS, SHELL_STYLE_ID, STATUS_COLORS_SECTION, STATUS_PALETTE_SECTION, STYLE_SECTIONS, STYLE_SECTIONS_V2, type SectionDef, type SectionPreset, type SelectOption, type SliderOptions, type SubGroupDef, THEME_EDITOR_PRESETS, THEME_SECTION, type TabDef, type ThemeEditorPreset, ThemeEditorState, type ThemePreviewHandle, type ThemePreviewOptions, type TokenRefOptions, ZOOM_MAX, ZOOM_MIN, applySceneConfig, applyShellTheme, buildPreviewConfig, buildShellCss, buildSrcdoc, convertFromPx, convertToPx, createPreviewMessages, createThemePreview, detectRoleAssignment, escapeHtml, findSection, formatCssValue, generateColorScale, getShellPalette, getThemeEditorPreset, hexToHsl, hslToHex, isValidHex, normalizeColorValue, paletteColorPath, parseCssValue, resolveRoleAssignment, resolveThemeColorPath, scopeSection, tokenRefDisplayName, wcagContrastRatio };
+export { ADVANCED_TOKENS_SECTION, ALL_ROLES, ALL_TABS, BRAND_PALETTE_SECTION, BUILT_IN_PRESETS, COLORS_SECTIONS, COLOR_FAMILIES, COMPONENTS_SECTIONS, COMPONENT_COLOR_SECTIONS, COMPONENT_SHAPE_SECTIONS, CONFIGURE_SECTIONS, CONFIGURE_SUB_GROUPS, type ColorScaleOptions, type CompareMode, type ConfigChangeListener, type ConfiguratorSnapshot, DEVICE_DIMENSIONS, type DetectedRoleAssignment, type FieldDef, type FieldType, HOME_SUGGESTION_CHIPS, INTERFACE_ROLES_SECTION, MOCK_BROWSER_CONTENT, MOCK_WORKSPACE_CONTENT, type OnChangeCallback, PALETTE_SECTION, PREVIEW_STORAGE_ADAPTER, type PreviewConfigOptions, type PreviewDevice, type PreviewLifecycleContext, type PreviewScene, type PreviewShellMode, type PreviewShellPalette, ROLE_ASSISTANT_MESSAGES, ROLE_BORDERS, ROLE_FAMILIES, ROLE_FAMILY_LABELS, ROLE_HEADER, ROLE_INPUT, ROLE_INTENSITIES, ROLE_LINKS_FOCUS, ROLE_PRIMARY_ACTIONS, ROLE_SCROLL_TO_BOTTOM, ROLE_SURFACES, ROLE_USER_MESSAGES, type RoleAssignmentOptions, type RoleFamily, type RoleIntensity, type RoleTarget, type RoleTargetKind, SEMANTIC_COLORS_SECTION, SHADE_KEYS, SHELL_STYLE_ID, STATUS_COLORS_SECTION, STATUS_PALETTE_SECTION, STYLE_SECTIONS, STYLE_SECTIONS_V2, type SectionDef, type SectionPreset, type SelectOption, type SliderOptions, type SubGroupDef, THEME_EDITOR_PRESETS, THEME_SECTION, type TabDef, type ThemeEditorPreset, ThemeEditorState, type ThemePreviewHandle, type ThemePreviewOptions, type TokenRefOptions, ZOOM_MAX, ZOOM_MIN, applySceneConfig, applyShellTheme, buildPreviewConfig, buildShellCss, buildSrcdoc, convertFromPx, convertToPx, createPreviewMessages, createThemePreview, detectRoleAssignment, escapeHtml, findSection, formatCssValue, generateColorScale, getShellPalette, getThemeEditorPreset, hexToHsl, hslToHex, isValidHex, normalizeColorValue, paletteColorPath, parseCssValue, resolveRoleAssignment, resolveThemeColorPath, scopeSection, tokenRefDisplayName, wcagContrastRatio };