react-dockable-desktop 4.2.0 → 4.2.1

package/dist/index.d.cts

@@ -59,6 +59,11 @@ interface ContextMenuAdapter {
 }
 declare const ContextMenu: React$1.ForwardRefExoticComponent<ContextMenuProps & React$1.RefAttributes<ContextMenuHandle>>;
 declare const DefaultContextMenuAdapter: ContextMenuAdapter;
+declare const ContextMenuProvider: React$1.FC<{
+    adapter?: ContextMenuAdapter;
+    children: React$1.ReactNode;
+} & ContextMenuProps>;
+declare function useShowContextMenu(): (options: ShowContextMenuOptions) => void;
 
 /**
  * @file WindowManager.tsx
@@ -424,7 +429,16 @@ interface LayoutLeafNode {
 }
 /** Union type representing either a branch or a leaf node in the layout grid. */
 type LayoutNode = LayoutGridNode | LayoutLeafNode;
-/** Corner of the workspace a floating window is pinned to. */
+/**
+ * Corner of the workspace a floating window can be pinned to.
+ *
+ * When `anchor` is set on a `FloatingWindow`, the window is positioned
+ * relative to that corner using CSS `right`/`left` + `top`/`bottom` and
+ * stacks with other windows sharing the same anchor (8 px gap, uncapped).
+ * Dragging a window away from its corner clears the anchor and returns it
+ * to free-float mode. The value is RTL-aware — `'top-left'` always means the
+ * logical start corner regardless of document direction.
+ */
 type FloatAnchor = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 /**
  * Bounds and depth metadata for floated panel windows.
@@ -527,10 +541,13 @@ interface WindowActions {
      * If the panel ID is already open, the panel is focused instead of duplicated.
      * @param id - Unique instance identifier for this panel.
      * @param component - Component key registered in the panel catalog.
-     * @param options - Optional display and placement overrides.
+     * @param options.title - Override the panel tab/window title. Accepts a plain string or an i18n message descriptor.
+     * @param options.initialTarget - Initial placement: `'floating'`, `'docked'` (default when a grid exists), or `'tabbed'`.
+     * @param options.anchor - Pin the new floating window to a workspace corner on creation. Has no effect when `initialTarget` is `'docked'` or `'tabbed'`.
      * @example
      * ```ts
-     * actions.openPanel('map-1', 'map', { title: 'Satellite View', initialTarget: 'floating' });
+     * // Open floating and pin to the top-right corner:
+     * actions.openPanel('layers', 'layertree', { initialTarget: 'floating', anchor: 'top-right' });
      * ```
      */
     openPanel: (id: string, component: string, options?: {
@@ -557,7 +574,8 @@ interface WindowActions {
     /**
      * Detaches a docked panel, converting it to a resizable floating window.
      * @param id - Panel instance ID.
-     * @param rect - Optional initial position and size for the floating window.
+     * @param rect - Optional initial position and size. Omit to use the last known position or a cascaded default.
+     * @param anchor - Optional corner to pin the new floating window to. Omit (or pass `null`) for free-float.
      */
     floatPanel: (id: string, rect?: {
         x: number;
@@ -722,6 +740,12 @@ interface WindowActions {
      * @param dir - `'ltr'` or `'rtl'`.
      */
     setDirection: (dir: 'ltr' | 'rtl') => void;
+    /**
+     * Imperatively shows the workspace context menu at the given position.
+     * Delegates to the active {@link ContextMenuProvider}, so custom adapters
+     * and externally-placed providers are respected automatically.
+     */
+    showContextMenu: (options: ShowContextMenuOptions) => void;
 }
 /** Represents custom CSS classes injected into layout parts. */
 interface StyleClasses {
@@ -926,13 +950,25 @@ declare class PanelRegistryClass {
 declare const PanelRegistry: PanelRegistryClass;
 
 /**
- * Props for `<DockableDesktopProvider>`. Alias of `WindowManagerProviderProps`.
- * @see WindowManagerProviderProps
+ * Props for `<DockableDesktopProvider>`.
+ * Extends `WindowManagerProviderProps` with workspace-level context menu configuration.
  */
-type DockableDesktopProviderProps = WindowManagerProviderProps;
+interface DockableDesktopProviderProps extends WindowManagerProviderProps {
+    /**
+     * Context menu adapter for the workspace-level `ContextMenuProvider`.
+     * Defaults to `DefaultContextMenuAdapter`. Ignored if a `<ContextMenuProvider>`
+     * already exists above `<DockableDesktopProvider>` in the tree.
+     */
+    contextMenuAdapter?: ContextMenuAdapter;
+}
 /**
- * Composite provider that wraps both `WindowManagerProvider` and `PanelProvider`
- * in the correct order. Drop-in replacement for manually nesting both providers.
+ * Composite provider that wraps `WindowManagerProvider`, `PanelProvider`, and `ToolbarProvider`
+ * in the correct order, and mounts the workspace-level `ContextMenuProvider` so that
+ * `showContextMenu()` and `useShowContextMenu()` work from any component in the tree —
+ * including siblings of `<WindowManager>` such as `<Sidebar>`, `<SidePanelRenderer>`,
+ * and `<ModalStackRenderer>`.
+ *
+ * Drop-in replacement for manually nesting both providers.
  *
  * `WindowManagerProvider` and `PanelProvider` remain independently exported
  * for cases that require custom nesting or separate configuration.
@@ -940,12 +976,15 @@ type DockableDesktopProviderProps = WindowManagerProviderProps;
  * @example
  * ```tsx
  * <DockableDesktopProvider client={workspace}>
- *   <WindowManager />
+ *   <Sidebar>
+ *     <WindowManager />
+ *   </Sidebar>
+ *   <SidePanelRenderer />
  *   <ModalStackRenderer />
  * </DockableDesktopProvider>
  * ```
  */
-declare const DockableDesktopProvider: React$1.FC<WindowManagerProviderProps>;
+declare const DockableDesktopProvider: React$1.FC<DockableDesktopProviderProps>;
 
 /**
  * Options used when requesting to close a container.
@@ -955,7 +994,7 @@ interface CloseOptions {
     force?: boolean;
 }
 /** Represents the type of container context a panel/form is currently rendered inside. */
-type ContainerType = 'left-panel' | 'right-panel' | 'modal' | 'dockable-panel' | 'standalone';
+type ContainerType = 'left-panel' | 'right-panel' | 'modal' | 'dockable-panel' | 'floating-window' | 'standalone';
 /**
  * Contract interface exposed by a container (like a tab, window, modal, or side-panel)
  * to its children forms, enabling them to control or listen to container events.
@@ -975,7 +1014,7 @@ interface FormContainerContract {
     }) => void;
     /** Change the tab or window icon dynamically. */
     setIcon?: (icon: React.ReactNode) => void;
-    /** The type of container the panel is mounted in. */
+    /** The type of container the panel is mounted in. Reflects the state at mount time; subscribe to {@link onContainerTypeChange} for live updates. */
     containerType?: ContainerType;
     /** Unique identifier of the panel or window instance. */
     instanceId: string;
@@ -985,8 +1024,34 @@ interface FormContainerContract {
     onMinimize?: (handler: () => void) => () => void;
     /** Subscribe to the container's restore event. Returns an unsubscribe function. */
     onRestore?: (handler: () => void) => () => void;
-    /** Subscribe to the container's window resize event, returning width and height. */
+    /** Subscribe to the container's window resize event, returning width and height. Returns an unsubscribe function. */
     onResize?: (handler: (width: number, height: number) => void) => () => void;
+    /** Request the container to minimize itself to the taskbar. No-op if the container type does not support minimize. */
+    requestMinimize?: () => void;
+    /** Returns the current rendered dimensions of this panel, or `null` if the panel has not been laid out yet. */
+    getDimensions?: () => {
+        width: number;
+        height: number;
+    } | null;
+    /**
+     * Subscribe to this panel becoming the globally active panel.
+     * Fires when `activePanelId` transitions to this panel's id.
+     * Returns an unsubscribe function.
+     */
+    onActivate?: (handler: () => void) => () => void;
+    /**
+     * Subscribe to this panel losing active status.
+     * Fires when `activePanelId` transitions away from this panel's id,
+     * and also fires if the panel is destroyed while it is active.
+     * Returns an unsubscribe function.
+     */
+    onDeactivate?: (handler: () => void) => () => void;
+    /**
+     * Subscribe to changes in the panel's container type (e.g. docked ↔ floating).
+     * Does not fire for minimize/restore cycles — use {@link onMinimize} / {@link onRestore} for those.
+     * Returns an unsubscribe function.
+     */
+    onContainerTypeChange?: (handler: (type: ContainerType) => void) => () => void;
 }
 /**
  * Context that supplies the {@link FormContainerContract} to panels inside the Window Manager.
@@ -995,7 +1060,9 @@ declare const FormContainerContext: Context<FormContainerContract>;
 declare const FormContainerProvider: Provider<FormContainerContract>;
 /**
  * React hook to retrieve the current {@link FormContainerContract} from context.
- * Enables sub-forms to trigger close requests, mark themselves dirty, rename their tabs, or listen to resize events.
+ * Enables sub-forms to trigger close/minimize requests, mark themselves dirty,
+ * rename their tabs, query dimensions, or subscribe to lifecycle events
+ * (resize, close, minimize, restore, activate, deactivate, container-type changes).
  */
 declare const useFormContainer: () => FormContainerContract;
 
@@ -1798,4 +1865,4 @@ interface PanelFloatingWindowManagerHandle {
  */
 declare function usePanelFloatingWindowManager(): PanelFloatingWindowManagerHandle;
 
-export { type BuiltInPanelEvents, type ButtonVariant, type CloseOptions, ConfirmationForm, type ConfirmationFormProps, ContextMenu, type ContextMenuAdapter, type ContextMenuCheckbox, type ContextMenuHandle, type ContextMenuItem, type ContextMenuLabel, type ContextMenuPredefinedMessage, type ContextMenuProps, type ContextMenuSeparator, type ContextMenuSimpleItem, type ContextMenuSubMenu, DefaultContextMenuAdapter, DockableDesktopProvider, type DockableDesktopProviderProps, type DropPosition, type DropTarget, type FloatAnchor, type FloatingWindow, FormContainerContext, type FormContainerContract, FormContainerProvider, type LayoutGridNode, type LayoutLeafNode, type LayoutNode, LeftPanelRenderer, type ManagedWindowConfig, type MenuItemAction, type MessageFormatter, type ModalOptions, ModalStackRenderer, type PanelActions, type PanelDefinition, PanelFloatingWindow, type PanelFloatingWindowManagerHandle, type PanelFloatingWindowProps, type PanelInfo, type PanelInstance, type PanelInstanceId, PanelOverlayRoot, type PanelOverlayRootProps, PanelProvider, PanelRegistry, PanelRegistryClass, type PanelRegistryEntry, type PanelState, type PanelTitle, PanelToolbar, ToolbarItem as PanelToolbarItem, type PanelToolbarProps, ToolbarSeparator as PanelToolbarSeparator, type PredefinedMessageKey, type ResolvedToastOptions, RightPanelRenderer, type SearchResult, type ShowContextMenuOptions, type SidePanelOptions, SidePanelRenderer, type SidePanelRendererProps, Sidebar, type SidebarContextValue, type SidebarHandle, type SidebarProps, type SidebarTab, type SidebarTabContextValue, type SplitDirection, type SplitOrientation, type StyleClasses, type TaskbarVisibility, type ToastAdapter, ToastContainer, type ToastContainerProps, type ToastFunction, type ToastOptions, type ToastPosition, type ToastPromiseMessages, type ToastType, Toolbar, type ToolbarActionItem, ToolbarButton, type ToolbarButtonProps, ToolbarCenter, type ToolbarContextValue, type ToolbarGroupEntry, type ToolbarGroupItem, type ToolbarGroupSubItem, type ToolbarHandle, type ToolbarItem$1 as ToolbarItem, type ToolbarPosition, type ToolbarProps, ToolbarProvider, type ToolbarRadioItem, ToolbarSearchInput, type ToolbarSearchInputProps, type ToolbarSeparator$1 as ToolbarSeparator, ToolbarSpacer, ToolbarToggle, type ToolbarToggleItem, type ToolbarToggleProps, type ToolbarVariant, type UsePanelFloatingWindowReturn, type WindowActions, WindowManager, type WindowManagerProps, WindowManagerProvider, type WindowManagerProviderProps, type WindowState, WorkspaceClient, type WorkspaceClientConfig, defaultPredefinedMessages, formatLabel, toast, useFormContainer, useFormatMessage, usePanelActions, usePanelContext, usePanelContextMenu, usePanelFloatingWindow, usePanelFloatingWindowManager, usePanelId, usePanelState, usePredefinedMessages, useRegistry, useSidebar, useSidebarTab, useStyleClasses, useToolbar, useWindowManagerActions, useWindowManagerState };
+export { type BuiltInPanelEvents, type ButtonVariant, type CloseOptions, ConfirmationForm, type ConfirmationFormProps, ContextMenu, type ContextMenuAdapter, type ContextMenuCheckbox, type ContextMenuHandle, type ContextMenuItem, type ContextMenuLabel, type ContextMenuPredefinedMessage, type ContextMenuProps, ContextMenuProvider, type ContextMenuSeparator, type ContextMenuSimpleItem, type ContextMenuSubMenu, DefaultContextMenuAdapter, DockableDesktopProvider, type DockableDesktopProviderProps, type DropPosition, type DropTarget, type FloatAnchor, type FloatingWindow, FormContainerContext, type FormContainerContract, FormContainerProvider, type LayoutGridNode, type LayoutLeafNode, type LayoutNode, LeftPanelRenderer, type ManagedWindowConfig, type MenuItemAction, type MessageFormatter, type ModalOptions, ModalStackRenderer, type PanelActions, type PanelDefinition, PanelFloatingWindow, type PanelFloatingWindowManagerHandle, type PanelFloatingWindowProps, type PanelInfo, type PanelInstance, type PanelInstanceId, PanelOverlayRoot, type PanelOverlayRootProps, PanelProvider, PanelRegistry, PanelRegistryClass, type PanelRegistryEntry, type PanelState, type PanelTitle, PanelToolbar, ToolbarItem as PanelToolbarItem, type PanelToolbarProps, ToolbarSeparator as PanelToolbarSeparator, type PredefinedMessageKey, type ResolvedToastOptions, RightPanelRenderer, type SearchResult, type ShowContextMenuOptions, type SidePanelOptions, SidePanelRenderer, type SidePanelRendererProps, Sidebar, type SidebarContextValue, type SidebarHandle, type SidebarProps, type SidebarTab, type SidebarTabContextValue, type SplitDirection, type SplitOrientation, type StyleClasses, type TaskbarVisibility, type ToastAdapter, ToastContainer, type ToastContainerProps, type ToastFunction, type ToastOptions, type ToastPosition, type ToastPromiseMessages, type ToastType, Toolbar, type ToolbarActionItem, ToolbarButton, type ToolbarButtonProps, ToolbarCenter, type ToolbarContextValue, type ToolbarGroupEntry, type ToolbarGroupItem, type ToolbarGroupSubItem, type ToolbarHandle, type ToolbarItem$1 as ToolbarItem, type ToolbarPosition, type ToolbarProps, ToolbarProvider, type ToolbarRadioItem, ToolbarSearchInput, type ToolbarSearchInputProps, type ToolbarSeparator$1 as ToolbarSeparator, ToolbarSpacer, ToolbarToggle, type ToolbarToggleItem, type ToolbarToggleProps, type ToolbarVariant, type UsePanelFloatingWindowReturn, type WindowActions, WindowManager, type WindowManagerProps, WindowManagerProvider, type WindowManagerProviderProps, type WindowState, WorkspaceClient, type WorkspaceClientConfig, defaultPredefinedMessages, formatLabel, toast, useFormContainer, useFormatMessage, usePanelActions, usePanelContext, usePanelContextMenu, usePanelFloatingWindow, usePanelFloatingWindowManager, usePanelId, usePanelState, usePredefinedMessages, useRegistry, useShowContextMenu, useSidebar, useSidebarTab, useStyleClasses, useToolbar, useWindowManagerActions, useWindowManagerState };

package/dist/index.d.ts

@@ -59,6 +59,11 @@ interface ContextMenuAdapter {
 }
 declare const ContextMenu: React$1.ForwardRefExoticComponent<ContextMenuProps & React$1.RefAttributes<ContextMenuHandle>>;
 declare const DefaultContextMenuAdapter: ContextMenuAdapter;
+declare const ContextMenuProvider: React$1.FC<{
+    adapter?: ContextMenuAdapter;
+    children: React$1.ReactNode;
+} & ContextMenuProps>;
+declare function useShowContextMenu(): (options: ShowContextMenuOptions) => void;
 
 /**
  * @file WindowManager.tsx
@@ -424,7 +429,16 @@ interface LayoutLeafNode {
 }
 /** Union type representing either a branch or a leaf node in the layout grid. */
 type LayoutNode = LayoutGridNode | LayoutLeafNode;
-/** Corner of the workspace a floating window is pinned to. */
+/**
+ * Corner of the workspace a floating window can be pinned to.
+ *
+ * When `anchor` is set on a `FloatingWindow`, the window is positioned
+ * relative to that corner using CSS `right`/`left` + `top`/`bottom` and
+ * stacks with other windows sharing the same anchor (8 px gap, uncapped).
+ * Dragging a window away from its corner clears the anchor and returns it
+ * to free-float mode. The value is RTL-aware — `'top-left'` always means the
+ * logical start corner regardless of document direction.
+ */
 type FloatAnchor = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 /**
  * Bounds and depth metadata for floated panel windows.
@@ -527,10 +541,13 @@ interface WindowActions {
      * If the panel ID is already open, the panel is focused instead of duplicated.
      * @param id - Unique instance identifier for this panel.
      * @param component - Component key registered in the panel catalog.
-     * @param options - Optional display and placement overrides.
+     * @param options.title - Override the panel tab/window title. Accepts a plain string or an i18n message descriptor.
+     * @param options.initialTarget - Initial placement: `'floating'`, `'docked'` (default when a grid exists), or `'tabbed'`.
+     * @param options.anchor - Pin the new floating window to a workspace corner on creation. Has no effect when `initialTarget` is `'docked'` or `'tabbed'`.
      * @example
      * ```ts
-     * actions.openPanel('map-1', 'map', { title: 'Satellite View', initialTarget: 'floating' });
+     * // Open floating and pin to the top-right corner:
+     * actions.openPanel('layers', 'layertree', { initialTarget: 'floating', anchor: 'top-right' });
      * ```
      */
     openPanel: (id: string, component: string, options?: {
@@ -557,7 +574,8 @@ interface WindowActions {
     /**
      * Detaches a docked panel, converting it to a resizable floating window.
      * @param id - Panel instance ID.
-     * @param rect - Optional initial position and size for the floating window.
+     * @param rect - Optional initial position and size. Omit to use the last known position or a cascaded default.
+     * @param anchor - Optional corner to pin the new floating window to. Omit (or pass `null`) for free-float.
      */
     floatPanel: (id: string, rect?: {
         x: number;
@@ -722,6 +740,12 @@ interface WindowActions {
      * @param dir - `'ltr'` or `'rtl'`.
      */
     setDirection: (dir: 'ltr' | 'rtl') => void;
+    /**
+     * Imperatively shows the workspace context menu at the given position.
+     * Delegates to the active {@link ContextMenuProvider}, so custom adapters
+     * and externally-placed providers are respected automatically.
+     */
+    showContextMenu: (options: ShowContextMenuOptions) => void;
 }
 /** Represents custom CSS classes injected into layout parts. */
 interface StyleClasses {
@@ -926,13 +950,25 @@ declare class PanelRegistryClass {
 declare const PanelRegistry: PanelRegistryClass;
 
 /**
- * Props for `<DockableDesktopProvider>`. Alias of `WindowManagerProviderProps`.
- * @see WindowManagerProviderProps
+ * Props for `<DockableDesktopProvider>`.
+ * Extends `WindowManagerProviderProps` with workspace-level context menu configuration.
  */
-type DockableDesktopProviderProps = WindowManagerProviderProps;
+interface DockableDesktopProviderProps extends WindowManagerProviderProps {
+    /**
+     * Context menu adapter for the workspace-level `ContextMenuProvider`.
+     * Defaults to `DefaultContextMenuAdapter`. Ignored if a `<ContextMenuProvider>`
+     * already exists above `<DockableDesktopProvider>` in the tree.
+     */
+    contextMenuAdapter?: ContextMenuAdapter;
+}
 /**
- * Composite provider that wraps both `WindowManagerProvider` and `PanelProvider`
- * in the correct order. Drop-in replacement for manually nesting both providers.
+ * Composite provider that wraps `WindowManagerProvider`, `PanelProvider`, and `ToolbarProvider`
+ * in the correct order, and mounts the workspace-level `ContextMenuProvider` so that
+ * `showContextMenu()` and `useShowContextMenu()` work from any component in the tree —
+ * including siblings of `<WindowManager>` such as `<Sidebar>`, `<SidePanelRenderer>`,
+ * and `<ModalStackRenderer>`.
+ *
+ * Drop-in replacement for manually nesting both providers.
  *
  * `WindowManagerProvider` and `PanelProvider` remain independently exported
  * for cases that require custom nesting or separate configuration.
@@ -940,12 +976,15 @@ type DockableDesktopProviderProps = WindowManagerProviderProps;
  * @example
  * ```tsx
  * <DockableDesktopProvider client={workspace}>
- *   <WindowManager />
+ *   <Sidebar>
+ *     <WindowManager />
+ *   </Sidebar>
+ *   <SidePanelRenderer />
  *   <ModalStackRenderer />
  * </DockableDesktopProvider>
  * ```
  */
-declare const DockableDesktopProvider: React$1.FC<WindowManagerProviderProps>;
+declare const DockableDesktopProvider: React$1.FC<DockableDesktopProviderProps>;
 
 /**
  * Options used when requesting to close a container.
@@ -955,7 +994,7 @@ interface CloseOptions {
     force?: boolean;
 }
 /** Represents the type of container context a panel/form is currently rendered inside. */
-type ContainerType = 'left-panel' | 'right-panel' | 'modal' | 'dockable-panel' | 'standalone';
+type ContainerType = 'left-panel' | 'right-panel' | 'modal' | 'dockable-panel' | 'floating-window' | 'standalone';
 /**
  * Contract interface exposed by a container (like a tab, window, modal, or side-panel)
  * to its children forms, enabling them to control or listen to container events.
@@ -975,7 +1014,7 @@ interface FormContainerContract {
     }) => void;
     /** Change the tab or window icon dynamically. */
     setIcon?: (icon: React.ReactNode) => void;
-    /** The type of container the panel is mounted in. */
+    /** The type of container the panel is mounted in. Reflects the state at mount time; subscribe to {@link onContainerTypeChange} for live updates. */
     containerType?: ContainerType;
     /** Unique identifier of the panel or window instance. */
     instanceId: string;
@@ -985,8 +1024,34 @@ interface FormContainerContract {
     onMinimize?: (handler: () => void) => () => void;
     /** Subscribe to the container's restore event. Returns an unsubscribe function. */
     onRestore?: (handler: () => void) => () => void;
-    /** Subscribe to the container's window resize event, returning width and height. */
+    /** Subscribe to the container's window resize event, returning width and height. Returns an unsubscribe function. */
     onResize?: (handler: (width: number, height: number) => void) => () => void;
+    /** Request the container to minimize itself to the taskbar. No-op if the container type does not support minimize. */
+    requestMinimize?: () => void;
+    /** Returns the current rendered dimensions of this panel, or `null` if the panel has not been laid out yet. */
+    getDimensions?: () => {
+        width: number;
+        height: number;
+    } | null;
+    /**
+     * Subscribe to this panel becoming the globally active panel.
+     * Fires when `activePanelId` transitions to this panel's id.
+     * Returns an unsubscribe function.
+     */
+    onActivate?: (handler: () => void) => () => void;
+    /**
+     * Subscribe to this panel losing active status.
+     * Fires when `activePanelId` transitions away from this panel's id,
+     * and also fires if the panel is destroyed while it is active.
+     * Returns an unsubscribe function.
+     */
+    onDeactivate?: (handler: () => void) => () => void;
+    /**
+     * Subscribe to changes in the panel's container type (e.g. docked ↔ floating).
+     * Does not fire for minimize/restore cycles — use {@link onMinimize} / {@link onRestore} for those.
+     * Returns an unsubscribe function.
+     */
+    onContainerTypeChange?: (handler: (type: ContainerType) => void) => () => void;
 }
 /**
  * Context that supplies the {@link FormContainerContract} to panels inside the Window Manager.
@@ -995,7 +1060,9 @@ declare const FormContainerContext: Context<FormContainerContract>;
 declare const FormContainerProvider: Provider<FormContainerContract>;
 /**
  * React hook to retrieve the current {@link FormContainerContract} from context.
- * Enables sub-forms to trigger close requests, mark themselves dirty, rename their tabs, or listen to resize events.
+ * Enables sub-forms to trigger close/minimize requests, mark themselves dirty,
+ * rename their tabs, query dimensions, or subscribe to lifecycle events
+ * (resize, close, minimize, restore, activate, deactivate, container-type changes).
  */
 declare const useFormContainer: () => FormContainerContract;
 
@@ -1798,4 +1865,4 @@ interface PanelFloatingWindowManagerHandle {
  */
 declare function usePanelFloatingWindowManager(): PanelFloatingWindowManagerHandle;
 
-export { type BuiltInPanelEvents, type ButtonVariant, type CloseOptions, ConfirmationForm, type ConfirmationFormProps, ContextMenu, type ContextMenuAdapter, type ContextMenuCheckbox, type ContextMenuHandle, type ContextMenuItem, type ContextMenuLabel, type ContextMenuPredefinedMessage, type ContextMenuProps, type ContextMenuSeparator, type ContextMenuSimpleItem, type ContextMenuSubMenu, DefaultContextMenuAdapter, DockableDesktopProvider, type DockableDesktopProviderProps, type DropPosition, type DropTarget, type FloatAnchor, type FloatingWindow, FormContainerContext, type FormContainerContract, FormContainerProvider, type LayoutGridNode, type LayoutLeafNode, type LayoutNode, LeftPanelRenderer, type ManagedWindowConfig, type MenuItemAction, type MessageFormatter, type ModalOptions, ModalStackRenderer, type PanelActions, type PanelDefinition, PanelFloatingWindow, type PanelFloatingWindowManagerHandle, type PanelFloatingWindowProps, type PanelInfo, type PanelInstance, type PanelInstanceId, PanelOverlayRoot, type PanelOverlayRootProps, PanelProvider, PanelRegistry, PanelRegistryClass, type PanelRegistryEntry, type PanelState, type PanelTitle, PanelToolbar, ToolbarItem as PanelToolbarItem, type PanelToolbarProps, ToolbarSeparator as PanelToolbarSeparator, type PredefinedMessageKey, type ResolvedToastOptions, RightPanelRenderer, type SearchResult, type ShowContextMenuOptions, type SidePanelOptions, SidePanelRenderer, type SidePanelRendererProps, Sidebar, type SidebarContextValue, type SidebarHandle, type SidebarProps, type SidebarTab, type SidebarTabContextValue, type SplitDirection, type SplitOrientation, type StyleClasses, type TaskbarVisibility, type ToastAdapter, ToastContainer, type ToastContainerProps, type ToastFunction, type ToastOptions, type ToastPosition, type ToastPromiseMessages, type ToastType, Toolbar, type ToolbarActionItem, ToolbarButton, type ToolbarButtonProps, ToolbarCenter, type ToolbarContextValue, type ToolbarGroupEntry, type ToolbarGroupItem, type ToolbarGroupSubItem, type ToolbarHandle, type ToolbarItem$1 as ToolbarItem, type ToolbarPosition, type ToolbarProps, ToolbarProvider, type ToolbarRadioItem, ToolbarSearchInput, type ToolbarSearchInputProps, type ToolbarSeparator$1 as ToolbarSeparator, ToolbarSpacer, ToolbarToggle, type ToolbarToggleItem, type ToolbarToggleProps, type ToolbarVariant, type UsePanelFloatingWindowReturn, type WindowActions, WindowManager, type WindowManagerProps, WindowManagerProvider, type WindowManagerProviderProps, type WindowState, WorkspaceClient, type WorkspaceClientConfig, defaultPredefinedMessages, formatLabel, toast, useFormContainer, useFormatMessage, usePanelActions, usePanelContext, usePanelContextMenu, usePanelFloatingWindow, usePanelFloatingWindowManager, usePanelId, usePanelState, usePredefinedMessages, useRegistry, useSidebar, useSidebarTab, useStyleClasses, useToolbar, useWindowManagerActions, useWindowManagerState };
+export { type BuiltInPanelEvents, type ButtonVariant, type CloseOptions, ConfirmationForm, type ConfirmationFormProps, ContextMenu, type ContextMenuAdapter, type ContextMenuCheckbox, type ContextMenuHandle, type ContextMenuItem, type ContextMenuLabel, type ContextMenuPredefinedMessage, type ContextMenuProps, ContextMenuProvider, type ContextMenuSeparator, type ContextMenuSimpleItem, type ContextMenuSubMenu, DefaultContextMenuAdapter, DockableDesktopProvider, type DockableDesktopProviderProps, type DropPosition, type DropTarget, type FloatAnchor, type FloatingWindow, FormContainerContext, type FormContainerContract, FormContainerProvider, type LayoutGridNode, type LayoutLeafNode, type LayoutNode, LeftPanelRenderer, type ManagedWindowConfig, type MenuItemAction, type MessageFormatter, type ModalOptions, ModalStackRenderer, type PanelActions, type PanelDefinition, PanelFloatingWindow, type PanelFloatingWindowManagerHandle, type PanelFloatingWindowProps, type PanelInfo, type PanelInstance, type PanelInstanceId, PanelOverlayRoot, type PanelOverlayRootProps, PanelProvider, PanelRegistry, PanelRegistryClass, type PanelRegistryEntry, type PanelState, type PanelTitle, PanelToolbar, ToolbarItem as PanelToolbarItem, type PanelToolbarProps, ToolbarSeparator as PanelToolbarSeparator, type PredefinedMessageKey, type ResolvedToastOptions, RightPanelRenderer, type SearchResult, type ShowContextMenuOptions, type SidePanelOptions, SidePanelRenderer, type SidePanelRendererProps, Sidebar, type SidebarContextValue, type SidebarHandle, type SidebarProps, type SidebarTab, type SidebarTabContextValue, type SplitDirection, type SplitOrientation, type StyleClasses, type TaskbarVisibility, type ToastAdapter, ToastContainer, type ToastContainerProps, type ToastFunction, type ToastOptions, type ToastPosition, type ToastPromiseMessages, type ToastType, Toolbar, type ToolbarActionItem, ToolbarButton, type ToolbarButtonProps, ToolbarCenter, type ToolbarContextValue, type ToolbarGroupEntry, type ToolbarGroupItem, type ToolbarGroupSubItem, type ToolbarHandle, type ToolbarItem$1 as ToolbarItem, type ToolbarPosition, type ToolbarProps, ToolbarProvider, type ToolbarRadioItem, ToolbarSearchInput, type ToolbarSearchInputProps, type ToolbarSeparator$1 as ToolbarSeparator, ToolbarSpacer, ToolbarToggle, type ToolbarToggleItem, type ToolbarToggleProps, type ToolbarVariant, type UsePanelFloatingWindowReturn, type WindowActions, WindowManager, type WindowManagerProps, WindowManagerProvider, type WindowManagerProviderProps, type WindowState, WorkspaceClient, type WorkspaceClientConfig, defaultPredefinedMessages, formatLabel, toast, useFormContainer, useFormatMessage, usePanelActions, usePanelContext, usePanelContextMenu, usePanelFloatingWindow, usePanelFloatingWindowManager, usePanelId, usePanelState, usePredefinedMessages, useRegistry, useShowContextMenu, useSidebar, useSidebarTab, useStyleClasses, useToolbar, useWindowManagerActions, useWindowManagerState };