@runtypelabs/persona 3.1.0 → 3.2.0

package/dist/index.d.cts

@@ -1375,6 +1375,13 @@ type AgentWidgetLauncherConfig = {
      * @default "0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -4px rgba(0, 0, 0, 0.1)"
      */
     shadow?: string;
+    /**
+     * CSS `max-width` for the floating launcher button when the panel is closed.
+     * Title and subtitle each truncate with an ellipsis when space is tight; full strings are available via the native `title` tooltip. Does not affect the open chat panel (`width` / `launcherWidth`).
+     *
+     * @example "min(380px, calc(100vw - 48px))"
+     */
+    collapsedMaxWidth?: string;
 };
 type AgentWidgetSendButtonConfig = {
     borderWidth?: string;
@@ -2797,11 +2804,15 @@ type AgentWidgetConfig = {
      *
      * This hook runs synchronously and must return the (potentially modified) state.
      *
+     * Returning `{ state, open: true }` also signals that the widget panel should
+     * open after initialization — useful when injecting a post-navigation message
+     * that the user should immediately see.
+     *
      * @example
      * ```typescript
+     * // Plain state transform (existing form, still supported)
      * config: {
      *   onStateLoaded: (state) => {
-     *     // Check for pending navigation message
      *     const navMessage = consumeNavigationFlag();
      *     if (navMessage) {
      *       return {
@@ -2818,8 +2829,36 @@ type AgentWidgetConfig = {
      *   }
      * }
      * ```
+     *
+     * @example
+     * ```typescript
+     * // Return { state, open: true } to also open the panel
+     * config: {
+     *   onStateLoaded: (state) => {
+     *     const navMessage = consumeNavigationFlag();
+     *     if (navMessage) {
+     *       return {
+     *         state: {
+     *           ...state,
+     *           messages: [...(state.messages || []), {
+     *             id: `nav-${Date.now()}`,
+     *             role: 'assistant',
+     *             content: navMessage,
+     *             createdAt: new Date().toISOString()
+     *           }]
+     *         },
+     *         open: true
+     *       };
+     *     }
+     *     return state;
+     *   }
+     * }
+     * ```
      */
-    onStateLoaded?: (state: AgentWidgetStoredState) => AgentWidgetStoredState;
+    onStateLoaded?: (state: AgentWidgetStoredState) => AgentWidgetStoredState | {
+        state: AgentWidgetStoredState;
+        open?: boolean;
+    };
     /**
      * Registry of custom components that can be rendered from JSON directives.
      * Components are registered by name and can be invoked via JSON responses

package/dist/index.d.ts

@@ -1375,6 +1375,13 @@ type AgentWidgetLauncherConfig = {
      * @default "0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -4px rgba(0, 0, 0, 0.1)"
      */
     shadow?: string;
+    /**
+     * CSS `max-width` for the floating launcher button when the panel is closed.
+     * Title and subtitle each truncate with an ellipsis when space is tight; full strings are available via the native `title` tooltip. Does not affect the open chat panel (`width` / `launcherWidth`).
+     *
+     * @example "min(380px, calc(100vw - 48px))"
+     */
+    collapsedMaxWidth?: string;
 };
 type AgentWidgetSendButtonConfig = {
     borderWidth?: string;
@@ -2797,11 +2804,15 @@ type AgentWidgetConfig = {
      *
      * This hook runs synchronously and must return the (potentially modified) state.
      *
+     * Returning `{ state, open: true }` also signals that the widget panel should
+     * open after initialization — useful when injecting a post-navigation message
+     * that the user should immediately see.
+     *
      * @example
      * ```typescript
+     * // Plain state transform (existing form, still supported)
      * config: {
      *   onStateLoaded: (state) => {
-     *     // Check for pending navigation message
      *     const navMessage = consumeNavigationFlag();
      *     if (navMessage) {
      *       return {
@@ -2818,8 +2829,36 @@ type AgentWidgetConfig = {
      *   }
      * }
      * ```
+     *
+     * @example
+     * ```typescript
+     * // Return { state, open: true } to also open the panel
+     * config: {
+     *   onStateLoaded: (state) => {
+     *     const navMessage = consumeNavigationFlag();
+     *     if (navMessage) {
+     *       return {
+     *         state: {
+     *           ...state,
+     *           messages: [...(state.messages || []), {
+     *             id: `nav-${Date.now()}`,
+     *             role: 'assistant',
+     *             content: navMessage,
+     *             createdAt: new Date().toISOString()
+     *           }]
+     *         },
+     *         open: true
+     *       };
+     *     }
+     *     return state;
+     *   }
+     * }
+     * ```
      */
-    onStateLoaded?: (state: AgentWidgetStoredState) => AgentWidgetStoredState;
+    onStateLoaded?: (state: AgentWidgetStoredState) => AgentWidgetStoredState | {
+        state: AgentWidgetStoredState;
+        open?: boolean;
+    };
     /**
      * Registry of custom components that can be rendered from JSON directives.
      * Components are registered by name and can be invoked via JSON responses