react-dockable-desktop 1.3.0 → 2.1.0

package/dist/index.d.ts

@@ -1,5 +1,4 @@
-import * as React$1 from 'react';
-import React__default, { ComponentType, ReactNode } from 'react';
+import React$1, { ComponentType, Context, Provider, ReactNode } from 'react';
 
 /**
  * @file WindowManager.tsx
@@ -10,9 +9,9 @@ import React__default, { ComponentType, ReactNode } from 'react';
 
 interface WindowManagerProps {
     skin?: string;
-    defaultPanelIcon?: React__default.ReactNode;
+    defaultPanelIcon?: React$1.ReactNode;
 }
-declare const WindowManager: React__default.FC<WindowManagerProps>;
+declare const WindowManager: React$1.FC<WindowManagerProps>;
 
 /**
  * Represents a registered component configuration template inside the panel catalog registry.
@@ -90,7 +89,7 @@ declare const PanelRegistry: PanelRegistryClass;
  * define in their IntlProvider messages table. The `defaultMessage` is used
  * as a fallback when no external formatter is provided.
  *
- * Pass a partial or full override to <WindowManagerProvider predefinedMessages={…} />
+ * Pass a partial or full override to `<WindowManagerProvider predefinedMessages={…} />`
  * to customise labels without replacing the whole table.
  */
 declare const defaultPredefinedMessages: {
@@ -249,6 +248,15 @@ interface ContextMenuPredefinedMessage {
 type MessageFormatter = (msg: ContextMenuPredefinedMessage) => string;
 /** Orientation modifier indicating split directions. */
 type SplitOrientation = 'horizontal' | 'vertical';
+/** The four cardinal directions a panel can be docked relative to another. */
+type SplitDirection = 'left' | 'right' | 'top' | 'bottom';
+/** All possible drop positions — cardinal directions plus center (same group). */
+type DropPosition = SplitDirection | 'center';
+/** The target leaf and position for a drag-and-drop dock operation. */
+interface DropTarget {
+    leafId: string;
+    position: DropPosition;
+}
 /**
  * Grid layout branch node containing nested splits and relative flex sizes.
  */
@@ -358,73 +366,222 @@ interface WindowState {
     isRtl: boolean;
 }
 /**
- * Interface mapping layout actions, event bus handles, and serialization methods.
+ * All layout mutation methods, event bus handles, and serialization methods
+ * exposed by the `WindowManagerProvider`.
+ *
+ * Obtain this object via {@link useWindowManagerActions} inside a component,
+ * or via {@link WorkspaceClient} methods from outside the React tree.
+ *
+ * @group Hooks
+ * @example
+ * ```tsx
+ * function MyToolbar() {
+ *   const actions = useWindowManagerActions();
+ *   return <button onClick={() => actions.openPanel('map-1', 'map')}>Open Map</button>;
+ * }
+ * ```
  */
 interface WindowActions {
-    /** Instantiates a registered panel into the workspace. */
+    /**
+     * Opens a registered panel into the workspace.
+     * 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.
+     * @example
+     * ```ts
+     * actions.openPanel('map-1', 'map', { title: 'Satellite View', initialTarget: 'floating' });
+     * ```
+     */
     openPanel: (id: string, component: string, options?: {
         title?: string | ContextMenuPredefinedMessage;
         initialTarget?: 'floating' | 'docked' | 'tabbed';
         stickyRight?: boolean;
         stickyBottom?: boolean;
     }) => void;
-    /** Directly closes a panel by ID, bypassing close confirmation dialogs. */
+    /**
+     * Closes a panel immediately, bypassing dirty-state close guards.
+     * For guarded close, use {@link requestClosePanel}.
+     * @param id - Panel instance ID.
+     */
     closePanel: (id: string) => void;
-    /** Minimizes a panel to the bottom taskbar, saving its current layout positioning. */
+    /**
+     * Minimizes a panel to the bottom taskbar dock, preserving its layout position.
+     * @param id - Panel instance ID.
+     */
     minimizePanel: (id: string) => void;
-    /** Restores a minimized panel back to its previous position in the grid or as a float. */
+    /**
+     * Restores a minimized panel back to its last docked or floating position.
+     * @param id - Panel instance ID.
+     */
     restorePanel: (id: string) => void;
-    /** Detaches a docked panel, turning it into a floating resizable window. */
+    /**
+     * 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.
+     */
     floatPanel: (id: string, rect?: {
         x: number;
         y: number;
         width: number;
         height: number;
     }) => void;
-    /** Returns a floating window back to a docked grid tab group. */
+    /**
+     * Returns a floating window to a docked grid tab group.
+     * @param id - Panel instance ID.
+     * @param targetLeafId - Target leaf group ID. Defaults to the panel's last leaf.
+     */
     dockPanel: (id: string, targetLeafId?: string) => void;
-    /** Maximizes a floating window to cover the entire layout screen boundaries. */
+    /**
+     * Maximizes a floating window to cover the entire workspace viewport.
+     * @param id - Panel instance ID.
+     */
     maximizePanel: (id: string) => void;
-    /** Resizes flex dimensions of children inside split layout rows/columns. */
+    /**
+     * Resizes the flex split proportions of a branch node's children.
+     * @param path - Index path from root to the branch node.
+     * @param sizes - New proportional sizes (must sum to 1.0).
+     */
     updateSplitSizes: (path: number[], sizes: number[]) => void;
-    /** Updates bounds or positioning attributes on a floating window. */
+    /**
+     * Updates the position or size of a floating window.
+     * @param id - Panel instance ID.
+     * @param updates - Partial update to `x`, `y`, `width`, `height`, `stickyRight`, or `stickyBottom`.
+     */
     updateFloatingPosition: (id: string, updates: Partial<Pick<FloatingWindow, 'x' | 'y' | 'width' | 'height' | 'stickyRight' | 'stickyBottom'>>) => void;
-    /** Pushes a floating window z-index layer to render on top of others. */
-    bringToFront: (id: string) => void;
-    /** Serializes the active grid node structures and panel targets to JSON. */
+    /**
+     * Activates the given panel regardless of its current state.
+     * - Floating panel: raises z-index so the window appears on top of others.
+     * - Docked panel: selects the tab within its leaf group.
+     * @param id - Panel instance ID.
+     * @example
+     * ```ts
+     * // Ensure a panel is visible before updating its content:
+     * if (actions.isOpen('map-1')) actions.focusPanel('map-1');
+     * ```
+     */
+    focusPanel: (id: string) => void;
+    /**
+     * Returns `true` if a panel with the given ID is currently open (docked, floating, or minimized).
+     * Uses a synchronous `stateRef` read — safe to call outside of render.
+     * @param id - Panel instance ID.
+     * @returns `true` if the panel is open.
+     * @example
+     * ```ts
+     * if (!actions.isOpen('map-1')) {
+     *   actions.openPanel('map-1', 'map');
+     * } else {
+     *   actions.focusPanel('map-1');
+     * }
+     * ```
+     */
+    isOpen: (id: string) => boolean;
+    /**
+     * Returns the IDs of all currently open panels (docked, floating, and minimized).
+     * Uses a synchronous `stateRef` read — safe to call outside of render.
+     * @returns Array of panel instance IDs.
+     */
+    getOpenPanelIds: () => string[];
+    /**
+     * Serializes the entire workspace state to a JSON string.
+     * Includes grid layout, floating window positions, minimized panels, and panel metadata.
+     * @returns JSON string suitable for storage and later restoration via {@link loadLayout}.
+     * @example
+     * ```ts
+     * localStorage.setItem('layout', actions.saveLayout());
+     * ```
+     */
     saveLayout: () => string;
-    /** Rebuilds the grid layouts and floating window placements from a JSON string. */
-    loadLayout: (layoutJson: string) => void;
-    /** Publishes an event to the global inter-panel message bus. */
+    /**
+     * Restores a previously serialized workspace from a JSON string.
+     * Replaces the entire current layout — all panels not in the snapshot are closed.
+     * @param layoutJson - JSON string produced by {@link saveLayout}.
+     * @returns `true` if the layout was successfully parsed and applied, `false` otherwise.
+     */
+    loadLayout: (layoutJson: string) => boolean;
+    /**
+     * Publishes an event to the inter-panel pub/sub event bus.
+     * @param event - Event name string.
+     * @param data - Arbitrary payload passed to all subscribers.
+     */
     publish: (event: string, data: any) => void;
-    /** Subscribes callback listeners to inter-panel event messages. */
+    /**
+     * Subscribes a callback to the inter-panel pub/sub event bus.
+     * @param event - Event name string.
+     * @param callback - Function called with the event payload.
+     * @returns Unsubscribe function — call it to remove the listener.
+     * @example
+     * ```ts
+     * useEffect(() => actions.subscribe('map:zoom', ({ level }) => setZoom(level)), []);
+     * ```
+     */
     subscribe: (event: string, callback: (data: any) => void) => () => void;
-    /** Stores reference to the active tab ID being dragged. */
+    /** @internal Stores reference to the active tab ID being dragged. */
     setDraggedPanelId: (id: string | null) => void;
-    /** Splits an existing tab group to dock a dragged panel next to it. */
-    dockPanelToGroup: (id: string, targetLeafId: string, position: 'left' | 'right' | 'top' | 'bottom' | 'center') => void;
-    /** Reorders tab indices inside a docked leaf group. */
+    /**
+     * Splits an existing leaf group and docks a panel to the given side.
+     * @param id - Panel instance ID to dock.
+     * @param targetLeafId - Leaf group ID to split.
+     * @param position - Which side of the target to split and dock into.
+     */
+    dockPanelToGroup: (id: string, targetLeafId: string, position: DropPosition) => void;
+    /**
+     * Reorders a panel's tab index within a docked leaf group.
+     * @param panelId - Panel instance ID to move.
+     * @param targetLeafId - Destination leaf group ID.
+     * @param targetIndex - New tab index within the target group.
+     */
     movePanelOrder: (panelId: string, targetLeafId: string, targetIndex: number) => void;
-    /** Closes an empty split group. */
+    /**
+     * Closes an empty leaf group (removes it from the grid tree).
+     * @param leafId - Leaf node ID to remove.
+     */
     closeLeafGroup: (leafId: string) => void;
-    /** Binds a close intercept confirmation guard. */
+    /**
+     * Registers a close guard that can intercept and cancel panel close requests.
+     * @param id - Panel instance ID to guard.
+     * @param guard - Function returning `true` (allow close) or `false` / `Promise<false>` (block).
+     */
     registerCloseGuard: (id: string, guard: () => boolean | Promise<boolean>) => void;
-    /** Removes close confirmation guards. */
+    /**
+     * Removes a previously registered close guard.
+     * @param id - Panel instance ID.
+     */
     unregisterCloseGuard: (id: string) => void;
-    /** Set panel dirty state flag. */
+    /**
+     * Marks a panel as dirty (has unsaved changes). Dirty panels show a visual indicator
+     * and the built-in close guard prompts the user before closing.
+     * @param id - Panel instance ID.
+     * @param dirty - `true` to mark dirty, `false` to clear.
+     * @param options - Custom confirmation dialog options.
+     */
     setPanelDirty: (id: string, dirty: boolean, options?: DirtyStateOptions) => void;
-    /** Change title header. */
+    /**
+     * Updates the display title of an open panel.
+     * @param id - Panel instance ID.
+     * @param title - New title string or localizable message descriptor.
+     */
     updatePanelTitle: (id: string, title: string | ContextMenuPredefinedMessage) => void;
-    /** Intercepts close panel requests, prompting warning dialogs if dirty. */
+    /**
+     * Closes a panel, first running any registered close guards.
+     * If the panel is dirty, shows the built-in unsaved-changes confirmation dialog.
+     * @param id - Panel instance ID.
+     * @param options - `force: true` bypasses guards; `onConfirm` provides a custom dialog.
+     */
     requestClosePanel: (id: string, options?: {
         force?: boolean;
         onConfirm?: (opts?: DirtyStateOptions) => Promise<boolean>;
     }) => Promise<void>;
-    /** Docks a panel directly to workspace edges. */
-    dockPanelToWorkspaceEdge: (id: string, position: 'left' | 'right' | 'top' | 'bottom') => void;
-    /** Update active focused tab reference. */
-    setActivePanel: (id: string | null) => void;
-    /** Explicitly set or override layout direction */
+    /**
+     * Docks a floating panel to a workspace edge, creating a full-width or full-height column/row.
+     * @param id - Panel instance ID.
+     * @param position - Edge to dock to.
+     */
+    dockPanelToWorkspaceEdge: (id: string, position: SplitDirection) => void;
+    /**
+     * Overrides the workspace layout direction.
+     * @param dir - `'ltr'` or `'rtl'`.
+     */
     setDirection: (dir: 'ltr' | 'rtl') => void;
 }
 /** Represents custom CSS classes injected into layout parts. */
@@ -438,8 +595,25 @@ interface StyleClasses {
 }
 /** Custom hook to read configured style class contexts. */
 declare const useStyleClasses: () => StyleClasses;
+/**
+ * React hook to read the scoped {@link PanelRegistryClass} for the current provider.
+ * When the provider was created with a {@link WorkspaceClient}, this returns the client's
+ * private registry. Otherwise it returns the global `PanelRegistry` singleton.
+ *
+ * @group Hooks
+ * @returns The panel registry instance in scope.
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const registry = useRegistry();
+ *   const entry = registry.get('map');
+ *   return entry ? <entry.Component panelId="preview" /> : null;
+ * }
+ * ```
+ */
+declare const useRegistry: () => PanelRegistryClass;
 interface WindowManagerProviderProps {
-    children: React__default.ReactNode;
+    children: React$1.ReactNode;
     /** WorkspaceClient instance created outside the React tree. When provided, its registry
      *  and config take precedence over the individual props below. */
     client?: WorkspaceClient;
@@ -453,15 +627,42 @@ interface WindowManagerProviderProps {
     windowClass?: string;
     windowBodyClass?: string;
 }
-declare const WindowManagerProvider: React__default.FC<WindowManagerProviderProps>;
+declare const WindowManagerProvider: React$1.FC<WindowManagerProviderProps>;
 /**
- * React hook to retrieve the active Window Manager layout state.
+ * React hook to subscribe to the live {@link WindowState} inside a component.
+ * The component re-renders whenever the state changes.
+ *
+ * For imperative reads without a subscription, use {@link WorkspaceClient} methods
+ * like `isOpen()` and `getOpenPanelIds()` instead.
+ *
+ * @group Hooks
+ * @returns The current workspace state tree.
  * @throws Error if used outside of a {@link WindowManagerProvider}.
+ * @example
+ * ```tsx
+ * function PanelList() {
+ *   const { panels } = useWindowManagerState();
+ *   return <ul>{Object.keys(panels).map(id => <li key={id}>{id}</li>)}</ul>;
+ * }
+ * ```
  */
 declare const useWindowManagerState: () => WindowState;
 /**
- * React hook to retrieve layouts mutation actions (dock, float, minimize, save/load).
+ * React hook to retrieve all layout mutation actions.
+ * Returns the public {@link WindowActions} interface.
+ *
+ * @group Hooks
+ * @returns The full set of workspace mutation methods.
  * @throws Error if used outside of a {@link WindowManagerProvider}.
+ * @example
+ * ```tsx
+ * function Toolbar() {
+ *   const actions = useWindowManagerActions();
+ *   return (
+ *     <button onClick={() => actions.openPanel('map-1', 'map')}>Open Map</button>
+ *   );
+ * }
+ * ```
  */
 declare const useWindowManagerActions: () => WindowActions;
 /**
@@ -475,14 +676,11 @@ declare const formatLabel: (label: string | ContextMenuPredefinedMessage | undef
 /**
  * React hook providing pub-sub helper methods for inter-panel event messaging.
  */
-declare const usePanelContext: () => {
-    publish: (event: string, data: any) => void;
-    subscribe: (event: string, callback: (data: any) => void) => () => void;
-};
+declare const usePanelContext: () => Pick<WindowActions, "publish" | "subscribe">;
 /**
  * React hook to fetch the localizable predefined message map catalog.
  */
-declare const usePredefinedMessages: () => Record<"floatWindow" | "minimizePanel" | "closeTab" | "restorePanel" | "maximizePanel" | "closePanel" | "dockWindow" | "minimize" | "maximize" | "restoreSize" | "close" | "closeEmptyGroup" | "anchorToRightEdge" | "anchorToBottomEdge" | "windowAnchoringOptions" | "unsavedChangesTitle" | "unsavedChangesMessage" | "discardChanges" | "cancel" | "yes" | "no" | "ok" | "closePanelTooltip" | "closeTooltip", ContextMenuPredefinedMessage>;
+declare const usePredefinedMessages: () => Record<PredefinedMessageKey, ContextMenuPredefinedMessage>;
 
 /** Per-panel definition supplied to WorkspaceClient constructor. */
 interface PanelDefinition {
@@ -511,11 +709,20 @@ interface WorkspaceClientConfig {
 /**
  * WorkspaceClient is the central configuration and imperative API object for
  * react-dockable-desktop. Create one instance outside the React tree and pass
- * it to <WindowManagerProvider client={client}>.
+ * it to `<WindowManagerProvider client={client}>`.
  *
  * Pattern: TanStack QueryClient / Redux store — configuration and imperative
  * access live on the client; rendering is delegated to the thin React provider.
  *
+ * @remarks
+ * Calls made before the provider mounts are queued and replayed automatically
+ * in order once `_connect()` fires. If the client is never connected to a
+ * provider (e.g. `client={workspace}` was forgotten), a console warning is
+ * emitted in development after 1 second.
+ *
+ * `subscribe()` and `saveLayout()` return values immediately and cannot be
+ * queued — they return safe defaults (`() => {}` and `''`) when disconnected.
+ *
  * @example
  * const workspace = new WorkspaceClient({
  *   panels: {
@@ -531,7 +738,8 @@ interface WorkspaceClientConfig {
  *
  * // Imperative access from anywhere:
  * workspace.saveLayout();
- * workspace.openPanel('map', 'map');
+ * workspace.openPanel('map-1', 'map');
+ * workspace.focusPanel('map-1');
  */
 declare class WorkspaceClient {
     /** Scoped panel registry — fully independent from the global singleton. */
@@ -541,6 +749,10 @@ declare class WorkspaceClient {
     /** Non-rendering configuration forwarded to the provider. */
     readonly config: Pick<WorkspaceClientConfig, 'formatMessage' | 'predefinedMessages' | 'dir'>;
     private _actions;
+    /** Calls queued before _connect() fires — replayed in order on first connect. */
+    private _pendingCalls;
+    /** DEV-only timer that warns if _connect() is never called within 1 second. */
+    private _disconnectedWarnTimer;
     constructor(config?: WorkspaceClientConfig);
     /** @internal Called by WindowManagerProvider after mount. */
     _connect(actions: WindowActions): void;
@@ -548,8 +760,11 @@ declare class WorkspaceClient {
     _disconnect(): void;
     /** True while the provider is mounted and React state is accessible. */
     get isConnected(): boolean;
-    saveLayout(): string;
-    loadLayout(json: string): void;
+    /**
+     * Dispatches a void action immediately if connected, or queues it for replay.
+     * In development, warns if the client is still not connected after 1 second.
+     */
+    private _dispatch;
     openPanel(...args: Parameters<WindowActions['openPanel']>): void;
     closePanel(id: string): void;
     minimizePanel(id: string): void;
@@ -557,7 +772,18 @@ declare class WorkspaceClient {
     floatPanel(...args: Parameters<WindowActions['floatPanel']>): void;
     dockPanel(...args: Parameters<WindowActions['dockPanel']>): void;
     maximizePanel(id: string): void;
-    bringToFront(id: string): void;
+    /**
+     * Activates the given panel regardless of its current state.
+     * For floating panels: raises z-index so the window appears on top.
+     * For docked panels: selects the tab within its leaf group.
+     */
+    focusPanel(id: string): void;
+    /** Returns `true` if a panel with this ID is currently open. */
+    isOpen(id: string): boolean;
+    /** Returns the IDs of all currently open panels. */
+    getOpenPanelIds(): string[];
+    saveLayout(): string;
+    loadLayout(json: string): boolean;
     setDirection(dir: 'ltr' | 'rtl'): void;
     publish(event: string, data: unknown): void;
     subscribe(event: string, callback: (data: unknown) => void): () => void;
@@ -607,8 +833,8 @@ interface FormContainerContract {
 /**
  * Context that supplies the {@link FormContainerContract} to panels inside the Window Manager.
  */
-declare const FormContainerContext: React$1.Context<FormContainerContract>;
-declare const FormContainerProvider: React$1.Provider<FormContainerContract>;
+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.
@@ -635,7 +861,7 @@ interface SidePanelOptions {
     /** Display title for the side-panel header. */
     title?: PanelTitle;
     /** Icon displayed next to the panel title. */
-    icon?: React__default.ReactNode;
+    icon?: React$1.ReactNode;
     /** Specific CSS width (e.g. 300, '40%') for the panel container. */
     width?: number | string;
 }
@@ -644,7 +870,7 @@ interface ModalOptions {
     /** Display title for the modal header. */
     title?: PanelTitle;
     /** Icon displayed in the modal title bar. */
-    icon?: React__default.ReactNode;
+    icon?: React$1.ReactNode;
     /** Size modifier affecting CSS max-width rules. */
     size?: 'small' | 'medium' | 'large' | 'fullscreen' | 'auto';
     /** If false, hides the modal backdrop exit click and header close button. */
@@ -707,7 +933,7 @@ interface PanelActions {
  * PanelProvider component manages the state and action handlers
  * for drawers (left/right) and active stacked modal overlays.
  */
-declare const PanelProvider: React__default.FC<{
+declare const PanelProvider: React$1.FC<{
     children: ReactNode;
 }>;
 /**
@@ -725,7 +951,7 @@ declare const usePanelActions: () => PanelActions;
  * ModalStackRenderer component acts as the global container rendering
  * all active stacked modal windows in the workspace.
  */
-declare const ModalStackRenderer: React__default.FC;
+declare const ModalStackRenderer: React$1.FC;
 
 interface SidePanelRendererProps {
     /**
@@ -739,15 +965,15 @@ interface SidePanelRendererProps {
  * SidePanelRenderer component acts as the global container rendering both
  * left and right side drawers if they are currently active.
  */
-declare const SidePanelRenderer: React__default.FC<SidePanelRendererProps>;
+declare const SidePanelRenderer: React$1.FC<SidePanelRendererProps>;
 /**
  * LeftPanelRenderer component renders ONLY the left side drawer if it is currently active.
  */
-declare const LeftPanelRenderer: React__default.FC<SidePanelRendererProps>;
+declare const LeftPanelRenderer: React$1.FC<SidePanelRendererProps>;
 /**
  * RightPanelRenderer component renders ONLY the right side drawer if it is currently active.
  */
-declare const RightPanelRenderer: React__default.FC<SidePanelRendererProps>;
+declare const RightPanelRenderer: React$1.FC<SidePanelRendererProps>;
 
 /**
  * Props for the {@link ConfirmationForm} component.
@@ -780,7 +1006,7 @@ interface ConfirmationFormProps {
  * ConfirmationForm component renders a standard dialog content layout,
  * allowing users to confirm actions or abort them. Exposes action callbacks.
  */
-declare const ConfirmationForm: React__default.FC<ConfirmationFormProps>;
+declare const ConfirmationForm: React$1.FC<ConfirmationFormProps>;
 
 /**
  * @file Sidebar.tsx
@@ -794,7 +1020,7 @@ declare const ConfirmationForm: React__default.FC<ConfirmationFormProps>;
 interface SidebarTab {
     id: string;
     label: string;
-    icon: React__default.ReactNode;
+    icon: React$1.ReactNode;
     /**
      * Mount immediately when the Sidebar first renders, not on first user click.
      * Implies `preserveState: true`.
@@ -818,7 +1044,7 @@ interface SidebarTab {
      * @param onOpen  - call to expand the drawer and select this tab programmatically
      *                  (useful when the panel itself detects it has new data to show)
      */
-    renderContent: (tabId: string, onClose: () => void, onOpen: () => void) => React__default.ReactNode;
+    renderContent: (tabId: string, onClose: () => void, onOpen: () => void) => React$1.ReactNode;
 }
 interface SidebarProps {
     /** Which side the tab strip and drawer appear on. Default: 'right' */
@@ -831,10 +1057,10 @@ interface SidebarProps {
     /** Called when the active tab changes in uncontrolled mode. */
     onActiveTabChange?: (tabId: string | null) => void;
     /** Main workspace content, rendered between the strip and drawer (or around them). */
-    children?: React__default.ReactNode;
+    children?: React$1.ReactNode;
 }
 /**
- * Imperative handle exposed by <Sidebar ref={...}> via forwardRef.
+ * Imperative handle exposed by `<Sidebar ref={...}>` via forwardRef.
  * Allows external components (outside the sidebar tree) to control
  * which tab is open without prop drilling.
  */
@@ -850,6 +1076,6 @@ interface SidebarHandle {
  * Sidebar component rendering a tab strip and a collapsible content drawer.
  * Supports imperative method bindings like openTab and closeDrawer via forwardRef.
  */
-declare const Sidebar: React__default.ForwardRefExoticComponent<SidebarProps & React__default.RefAttributes<SidebarHandle>>;
+declare const Sidebar: React$1.ForwardRefExoticComponent<SidebarProps & React$1.RefAttributes<SidebarHandle>>;
 
-export { type CloseOptions, ConfirmationForm, type ConfirmationFormProps, type ContextMenuPredefinedMessage, type FloatingWindow, FormContainerContext, type FormContainerContract, FormContainerProvider, type LayoutGridNode, type LayoutLeafNode, type LayoutNode, LeftPanelRenderer, type MessageFormatter, type ModalOptions, ModalStackRenderer, type PanelActions, type PanelDefinition, type PanelInfo, type PanelInstance, type PanelInstanceId, PanelProvider, PanelRegistry, type PanelRegistryEntry, type PanelState, type PanelTitle, type PredefinedMessageKey, RightPanelRenderer, type SidePanelOptions, SidePanelRenderer, type SidePanelRendererProps, Sidebar, type SidebarHandle, type SidebarProps, type SidebarTab, type SplitOrientation, type StyleClasses, type WindowActions, WindowManager, WindowManagerProvider, type WindowState, WorkspaceClient, type WorkspaceClientConfig, defaultPredefinedMessages, formatLabel, useFormContainer, useFormatMessage, usePanelActions, usePanelContext, usePanelState, usePredefinedMessages, useStyleClasses, useWindowManagerActions, useWindowManagerState };
+export { type CloseOptions, ConfirmationForm, type ConfirmationFormProps, type ContextMenuPredefinedMessage, type DropPosition, type DropTarget, type FloatingWindow, FormContainerContext, type FormContainerContract, FormContainerProvider, type LayoutGridNode, type LayoutLeafNode, type LayoutNode, LeftPanelRenderer, type MessageFormatter, type ModalOptions, ModalStackRenderer, type PanelActions, type PanelDefinition, type PanelInfo, type PanelInstance, type PanelInstanceId, PanelProvider, PanelRegistry, PanelRegistryClass, type PanelRegistryEntry, type PanelState, type PanelTitle, type PredefinedMessageKey, RightPanelRenderer, type SidePanelOptions, SidePanelRenderer, type SidePanelRendererProps, Sidebar, type SidebarHandle, type SidebarProps, type SidebarTab, type SplitDirection, type SplitOrientation, type StyleClasses, type WindowActions, WindowManager, WindowManagerProvider, type WindowState, WorkspaceClient, type WorkspaceClientConfig, defaultPredefinedMessages, formatLabel, useFormContainer, useFormatMessage, usePanelActions, usePanelContext, usePanelState, usePredefinedMessages, useRegistry, useStyleClasses, useWindowManagerActions, useWindowManagerState };