react-dockable-desktop 6.1.0 → 6.3.0

package/dist/index.d.cts

@@ -242,7 +242,7 @@ declare class WorkspaceClient<TUserEvents extends Record<string, unknown> = Reco
     openPanel(...args: Parameters<WindowActions['openPanel']>): void;
     closePanel(id: string): void;
     minimizePanel(id: string): void;
-    restorePanel(id: string): void;
+    restorePanel(...args: Parameters<WindowActions['restorePanel']>): void;
     floatPanel(...args: Parameters<WindowActions['floatPanel']>): void;
     dockPanel(...args: Parameters<WindowActions['dockPanel']>): void;
     maximizePanel(id: string): void;
@@ -724,8 +724,11 @@ interface WindowActions {
     /**
      * Restores a minimized panel back to its last docked or floating position.
      * @param id - Panel instance ID.
+     * @param options.focus - Set `state.activePanelId` to the restored panel. @default true
      */
-    restorePanel: (id: string) => void;
+    restorePanel: (id: string, options?: {
+        focus?: boolean;
+    }) => void;
     /**
      * Detaches a docked panel, converting it to a resizable floating window.
      * @param id - Panel instance ID.
@@ -2080,8 +2083,14 @@ interface PanelFloatPlacement {
  * @see usePanelFloatingWindowManager
  */
 interface ManagedWindowConfig {
-    /** Text shown in the window's header bar. */
-    title: string;
+    /**
+     * Text shown in the window's header bar. Accepts a plain string or an i18n message descriptor.
+     *
+     * A descriptor is re-resolved on every render, so the header follows a language change without
+     * the window being closed and reopened — which a plain string cannot do here, because this
+     * config is stored by the overlay rather than re-read from your own render.
+     */
+    title: PanelTitle;
     /** Optional icon shown to the left of the title in the header. */
     icon?: React$1.ReactNode;
     /** Window body content. */
@@ -2232,8 +2241,8 @@ declare function ToolbarSearchInput({ placeholder, onSearch, onSelect }: Toolbar
 interface PanelFloatingWindowProps {
     /** Unique identifier within the panel overlay. Used for z-order and stack tracking. */
     id: string;
-    /** Text shown in the window's header bar. */
-    title: string;
+    /** Text shown in the window's header bar. Accepts a plain string or an i18n message descriptor. */
+    title: PanelTitle;
     /** Optional icon shown to the left of the title in the header. */
     icon?: React$1.ReactNode;
     /** Whether the window is mounted and visible. Set to `false` to close/unmount it. */

package/dist/index.d.ts

@@ -242,7 +242,7 @@ declare class WorkspaceClient<TUserEvents extends Record<string, unknown> = Reco
     openPanel(...args: Parameters<WindowActions['openPanel']>): void;
     closePanel(id: string): void;
     minimizePanel(id: string): void;
-    restorePanel(id: string): void;
+    restorePanel(...args: Parameters<WindowActions['restorePanel']>): void;
     floatPanel(...args: Parameters<WindowActions['floatPanel']>): void;
     dockPanel(...args: Parameters<WindowActions['dockPanel']>): void;
     maximizePanel(id: string): void;
@@ -724,8 +724,11 @@ interface WindowActions {
     /**
      * Restores a minimized panel back to its last docked or floating position.
      * @param id - Panel instance ID.
+     * @param options.focus - Set `state.activePanelId` to the restored panel. @default true
      */
-    restorePanel: (id: string) => void;
+    restorePanel: (id: string, options?: {
+        focus?: boolean;
+    }) => void;
     /**
      * Detaches a docked panel, converting it to a resizable floating window.
      * @param id - Panel instance ID.
@@ -2080,8 +2083,14 @@ interface PanelFloatPlacement {
  * @see usePanelFloatingWindowManager
  */
 interface ManagedWindowConfig {
-    /** Text shown in the window's header bar. */
-    title: string;
+    /**
+     * Text shown in the window's header bar. Accepts a plain string or an i18n message descriptor.
+     *
+     * A descriptor is re-resolved on every render, so the header follows a language change without
+     * the window being closed and reopened — which a plain string cannot do here, because this
+     * config is stored by the overlay rather than re-read from your own render.
+     */
+    title: PanelTitle;
     /** Optional icon shown to the left of the title in the header. */
     icon?: React$1.ReactNode;
     /** Window body content. */
@@ -2232,8 +2241,8 @@ declare function ToolbarSearchInput({ placeholder, onSearch, onSelect }: Toolbar
 interface PanelFloatingWindowProps {
     /** Unique identifier within the panel overlay. Used for z-order and stack tracking. */
     id: string;
-    /** Text shown in the window's header bar. */
-    title: string;
+    /** Text shown in the window's header bar. Accepts a plain string or an i18n message descriptor. */
+    title: PanelTitle;
     /** Optional icon shown to the left of the title in the header. */
     icon?: React$1.ReactNode;
     /** Whether the window is mounted and visible. Set to `false` to close/unmount it. */