react-dockable-desktop 7.6.0 → 7.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1,179 +1,5 @@
1
1
  import React$1, { ComponentType, ReactNode } from 'react';
2
2
 
3
- /**
4
- * @file predefinedMessages.ts
5
- * @description Provides the default localizable message catalogs and translation keys
6
- * utilized by Dockable Desktop's context menus, headers, and tooltips.
7
- *
8
- * Each value's `id` is the react-intl message ID that the consumer should
9
- * define in their IntlProvider messages table. The `defaultMessage` is used
10
- * as a fallback when no external formatter is provided.
11
- *
12
- * Pass a partial or full override as `createWorkspace({ messages })` or
13
- * `<DockableDesktopProvider messages={…}>` to customise labels without replacing the whole table.
14
- */
15
- declare const defaultPredefinedMessages: {
16
- readonly floatWindow: {
17
- readonly id: "dockable-desktop-floatWindow";
18
- readonly defaultMessage: "Float Window";
19
- };
20
- readonly minimizePanel: {
21
- readonly id: "dockable-desktop-minimizePanel";
22
- readonly defaultMessage: "Minimize Panel";
23
- };
24
- readonly closeTab: {
25
- readonly id: "dockable-desktop-closeTab";
26
- readonly defaultMessage: "Close Tab";
27
- };
28
- readonly restorePanel: {
29
- readonly id: "dockable-desktop-restorePanel";
30
- readonly defaultMessage: "Restore Panel";
31
- };
32
- readonly maximizePanel: {
33
- readonly id: "dockable-desktop-maximizePanel";
34
- readonly defaultMessage: "Maximize Panel";
35
- };
36
- readonly closePanel: {
37
- readonly id: "dockable-desktop-closePanel";
38
- readonly defaultMessage: "Close Panel";
39
- };
40
- readonly dockWindow: {
41
- readonly id: "dockable-desktop-dockWindow";
42
- readonly defaultMessage: "Dock Window";
43
- };
44
- readonly minimize: {
45
- readonly id: "dockable-desktop-minimize";
46
- readonly defaultMessage: "Minimize";
47
- };
48
- readonly maximize: {
49
- readonly id: "dockable-desktop-maximize";
50
- readonly defaultMessage: "Maximize";
51
- };
52
- readonly restoreSize: {
53
- readonly id: "dockable-desktop-restoreSize";
54
- readonly defaultMessage: "Restore Size";
55
- };
56
- readonly close: {
57
- readonly id: "dockable-desktop-close";
58
- readonly defaultMessage: "Close";
59
- };
60
- readonly closeEmptyGroup: {
61
- readonly id: "dockable-desktop-closeEmptyGroup";
62
- readonly defaultMessage: "Close empty split group";
63
- };
64
- readonly unsavedChangesTitle: {
65
- readonly id: "dockable-desktop-unsavedChangesTitle";
66
- readonly defaultMessage: "Unsaved Changes";
67
- };
68
- readonly unsavedChangesMessage: {
69
- readonly id: "dockable-desktop-unsavedChangesMessage";
70
- readonly defaultMessage: "\"{title}\" has unsaved changes. Do you want to discard your changes and close?";
71
- };
72
- readonly discardChanges: {
73
- readonly id: "dockable-desktop-discardChanges";
74
- readonly defaultMessage: "Discard Changes";
75
- };
76
- readonly cancel: {
77
- readonly id: "dockable-desktop-cancel";
78
- readonly defaultMessage: "Cancel";
79
- };
80
- readonly yes: {
81
- readonly id: "dockable-desktop-yes";
82
- readonly defaultMessage: "Yes";
83
- };
84
- readonly no: {
85
- readonly id: "dockable-desktop-no";
86
- readonly defaultMessage: "No";
87
- };
88
- readonly ok: {
89
- readonly id: "dockable-desktop-ok";
90
- readonly defaultMessage: "OK";
91
- };
92
- readonly closePanelTooltip: {
93
- readonly id: "dockable-desktop-closePanelTooltip";
94
- readonly defaultMessage: "Close panel";
95
- };
96
- readonly closeTooltip: {
97
- readonly id: "dockable-desktop-closeTooltip";
98
- readonly defaultMessage: "Close";
99
- };
100
- readonly notifications: {
101
- readonly id: "dockable-desktop-notifications";
102
- readonly defaultMessage: "Notifications";
103
- };
104
- readonly closeNotification: {
105
- readonly id: "dockable-desktop-closeNotification";
106
- readonly defaultMessage: "Close notification";
107
- };
108
- readonly scrollTabsLeft: {
109
- readonly id: "dockable-desktop-scrollTabsLeft";
110
- readonly defaultMessage: "Scroll tabs left";
111
- };
112
- readonly scrollTabsRight: {
113
- readonly id: "dockable-desktop-scrollTabsRight";
114
- readonly defaultMessage: "Scroll tabs right";
115
- };
116
- readonly scrollTaskbarLeft: {
117
- readonly id: "dockable-desktop-scrollTaskbarLeft";
118
- readonly defaultMessage: "Scroll taskbar left";
119
- };
120
- readonly scrollTaskbarRight: {
121
- readonly id: "dockable-desktop-scrollTaskbarRight";
122
- readonly defaultMessage: "Scroll taskbar right";
123
- };
124
- readonly moreActions: {
125
- readonly id: "dockable-desktop-moreActions";
126
- readonly defaultMessage: "More actions";
127
- };
128
- readonly search: {
129
- readonly id: "dockable-desktop-search";
130
- readonly defaultMessage: "Search";
131
- };
132
- readonly closeSearch: {
133
- readonly id: "dockable-desktop-closeSearch";
134
- readonly defaultMessage: "Close search";
135
- };
136
- readonly searchPlaceholder: {
137
- readonly id: "dockable-desktop-searchPlaceholder";
138
- readonly defaultMessage: "Search…";
139
- };
140
- readonly modalTitle: {
141
- readonly id: "dockable-desktop-modalTitle";
142
- readonly defaultMessage: "Confirmation";
143
- };
144
- readonly emptyGroup: {
145
- readonly id: "dockable-desktop-emptyGroup";
146
- readonly defaultMessage: "Empty Workspace Section";
147
- };
148
- readonly emptyGrid: {
149
- readonly id: "dockable-desktop-emptyGrid";
150
- readonly defaultMessage: "Grid Empty";
151
- };
152
- readonly componentUnregistered: {
153
- readonly id: "dockable-desktop-componentUnregistered";
154
- readonly defaultMessage: "Component Unregistered";
155
- };
156
- readonly componentKey: {
157
- readonly id: "dockable-desktop-componentKey";
158
- readonly defaultMessage: "Key: {key}";
159
- };
160
- readonly untitledPanel: {
161
- readonly id: "dockable-desktop-untitledPanel";
162
- readonly defaultMessage: "Panel";
163
- };
164
- };
165
- /**
166
- * Union of every key in `defaultMessages`.
167
- *
168
- * Import this type in your i18n message tables to get a compile-time
169
- * guarantee that all keys are present and no typos exist:
170
- *
171
- * import type { MessageKey } from 'react-dockable-desktop';
172
- *
173
- * const myMessages: Record<MessageKey, string> = { ... };
174
- */
175
- type MessageKey = keyof typeof defaultPredefinedMessages;
176
-
177
3
  /**
178
4
  * @file dirtyOptions.ts
179
5
  * @description Type definitions for customizing automatic close warning overlays.
@@ -279,6 +105,12 @@ interface ContextMenuAdapter {
279
105
  }
280
106
  declare function useShowContextMenu(): (options: ShowContextMenuOptions) => void;
281
107
 
108
+ /**
109
+ * @file types.ts
110
+ * @description The workspace's data types: messages, the layout tree, floating windows, panels,
111
+ * the state snapshot, the actions, the serialized layout and the store's configuration.
112
+ */
113
+
282
114
  /**
283
115
  * Structure representing localizable message descriptors used in context menus.
284
116
  */
@@ -795,8 +627,6 @@ interface HostClasses {
795
627
  windowClass?: string;
796
628
  windowBodyClass?: string;
797
629
  }
798
- /** Custom hook to read configured style class contexts. */
799
- declare const useStyleClasses: () => HostClasses;
800
630
  /** The on-disk shape produced by `saveLayout()` and accepted by `loadLayout()`/`initialState`. */
801
631
  interface SerializedLayout {
802
632
  /** Schema version — absent on layouts saved before this field was introduced (treated as 0). */
@@ -833,64 +663,6 @@ interface WorkspaceCore {
833
663
  zIndexBase?: number;
834
664
  }) => void;
835
665
  }
836
- /**
837
- * The live workspace state. The component re-renders whenever it changes — or, given a selector,
838
- * only when the selected value changes.
839
- *
840
- * For reads without a subscription, call the workspace's `isOpen()` or `getOpenPanelIds()`.
841
- *
842
- * The selector must return a value that stays the same while the state does — a primitive, or a
843
- * part of the state as it is (`s => s.panels[id]`). A selector that builds a new object or array
844
- * on each call (`s => ({ n: s.floating.length })`, `s => s.floating.map(...)`) is a new value
845
- * every time React asks, and React stops with "Maximum update depth exceeded". Select the parts
846
- * separately, or
847
- * derive the object with `useMemo` from what you selected.
848
- *
849
- * @returns The current workspace state, or the selector's result.
850
- * @throws Error if used outside `<DockableDesktopProvider>`.
851
- * @example
852
- * ```tsx
853
- * function PanelCount() {
854
- * const count = useWorkspaceState(s => Object.keys(s.panels).length);
855
- * return <span>{count} open</span>;
856
- * }
857
- * ```
858
- */
859
- declare function useWindowManagerState(): WorkspaceState;
860
- declare function useWindowManagerState<T>(selector: (state: WorkspaceState) => T): T;
861
- /**
862
- * React hook to retrieve the active i18n formatter.
863
- */
864
- declare const useFormatMessage: () => MessageFormatter;
865
- /**
866
- * Helper to resolve dynamic label strings or localizable descriptor objects into text.
867
- */
868
- declare const formatLabel: (label: string | MessageDescriptor | (() => string) | undefined, formatter: MessageFormatter) => string;
869
- /**
870
- * React hook to fetch the localizable predefined message map catalog.
871
- */
872
- declare const usePredefinedMessages: () => Record<MessageKey, MessageDescriptor>;
873
- /**
874
- * React hook for injecting custom context menu items into a panel's context menu from inside the panel component.
875
- * Items are dynamic — the array is re-read each time the menu opens, so state-driven changes (enable/disable, add/remove) work automatically.
876
- * The hook knows which panel it is in — no id needed.
877
- *
878
- * @param items - Array of `ContextMenuItem` entries (simple items, separators, submenus).
879
- * @example
880
- * ```tsx
881
- * import { usePanelContextMenu } from 'dockable-windows';
882
- *
883
- * function MyPanel() {
884
- * const [dirty, setDirty] = useState(false);
885
- * usePanelContextMenu([
886
- * { label: 'Save', action: () => save() },
887
- * { label: 'Revert', action: () => revert() },
888
- * ]);
889
- * return <Editor onChange={() => setDirty(true)} />;
890
- * }
891
- * ```
892
- */
893
- declare function usePanelContextMenu(items: ContextMenuItem[]): void;
894
666
 
895
667
  /**
896
668
  * Represents a registered component configuration template inside the panel catalog registry.
@@ -955,6 +727,247 @@ declare class PanelRegistry {
955
727
  getRegisteredIds(): string[];
956
728
  }
957
729
 
730
+ /**
731
+ * @file predefinedMessages.ts
732
+ * @description Provides the default localizable message catalogs and translation keys
733
+ * utilized by Dockable Desktop's context menus, headers, and tooltips.
734
+ *
735
+ * Each value's `id` is the react-intl message ID that the consumer should
736
+ * define in their IntlProvider messages table. The `defaultMessage` is used
737
+ * as a fallback when no external formatter is provided.
738
+ *
739
+ * Pass a partial or full override as `createWorkspace({ messages })` or
740
+ * `<DockableDesktopProvider messages={…}>` to customise labels without replacing the whole table.
741
+ */
742
+ declare const defaultPredefinedMessages: {
743
+ readonly floatWindow: {
744
+ readonly id: "dockable-desktop-floatWindow";
745
+ readonly defaultMessage: "Float Window";
746
+ };
747
+ readonly minimizePanel: {
748
+ readonly id: "dockable-desktop-minimizePanel";
749
+ readonly defaultMessage: "Minimize Panel";
750
+ };
751
+ readonly closeTab: {
752
+ readonly id: "dockable-desktop-closeTab";
753
+ readonly defaultMessage: "Close Tab";
754
+ };
755
+ readonly restorePanel: {
756
+ readonly id: "dockable-desktop-restorePanel";
757
+ readonly defaultMessage: "Restore Panel";
758
+ };
759
+ readonly maximizePanel: {
760
+ readonly id: "dockable-desktop-maximizePanel";
761
+ readonly defaultMessage: "Maximize Panel";
762
+ };
763
+ readonly closePanel: {
764
+ readonly id: "dockable-desktop-closePanel";
765
+ readonly defaultMessage: "Close Panel";
766
+ };
767
+ readonly dockWindow: {
768
+ readonly id: "dockable-desktop-dockWindow";
769
+ readonly defaultMessage: "Dock Window";
770
+ };
771
+ readonly minimize: {
772
+ readonly id: "dockable-desktop-minimize";
773
+ readonly defaultMessage: "Minimize";
774
+ };
775
+ readonly maximize: {
776
+ readonly id: "dockable-desktop-maximize";
777
+ readonly defaultMessage: "Maximize";
778
+ };
779
+ readonly restoreSize: {
780
+ readonly id: "dockable-desktop-restoreSize";
781
+ readonly defaultMessage: "Restore Size";
782
+ };
783
+ readonly close: {
784
+ readonly id: "dockable-desktop-close";
785
+ readonly defaultMessage: "Close";
786
+ };
787
+ readonly closeEmptyGroup: {
788
+ readonly id: "dockable-desktop-closeEmptyGroup";
789
+ readonly defaultMessage: "Close empty split group";
790
+ };
791
+ readonly unsavedChangesTitle: {
792
+ readonly id: "dockable-desktop-unsavedChangesTitle";
793
+ readonly defaultMessage: "Unsaved Changes";
794
+ };
795
+ readonly unsavedChangesMessage: {
796
+ readonly id: "dockable-desktop-unsavedChangesMessage";
797
+ readonly defaultMessage: "\"{title}\" has unsaved changes. Do you want to discard your changes and close?";
798
+ };
799
+ readonly discardChanges: {
800
+ readonly id: "dockable-desktop-discardChanges";
801
+ readonly defaultMessage: "Discard Changes";
802
+ };
803
+ readonly cancel: {
804
+ readonly id: "dockable-desktop-cancel";
805
+ readonly defaultMessage: "Cancel";
806
+ };
807
+ readonly yes: {
808
+ readonly id: "dockable-desktop-yes";
809
+ readonly defaultMessage: "Yes";
810
+ };
811
+ readonly no: {
812
+ readonly id: "dockable-desktop-no";
813
+ readonly defaultMessage: "No";
814
+ };
815
+ readonly ok: {
816
+ readonly id: "dockable-desktop-ok";
817
+ readonly defaultMessage: "OK";
818
+ };
819
+ readonly closePanelTooltip: {
820
+ readonly id: "dockable-desktop-closePanelTooltip";
821
+ readonly defaultMessage: "Close panel";
822
+ };
823
+ readonly closeTooltip: {
824
+ readonly id: "dockable-desktop-closeTooltip";
825
+ readonly defaultMessage: "Close";
826
+ };
827
+ readonly notifications: {
828
+ readonly id: "dockable-desktop-notifications";
829
+ readonly defaultMessage: "Notifications";
830
+ };
831
+ readonly closeNotification: {
832
+ readonly id: "dockable-desktop-closeNotification";
833
+ readonly defaultMessage: "Close notification";
834
+ };
835
+ readonly scrollTabsLeft: {
836
+ readonly id: "dockable-desktop-scrollTabsLeft";
837
+ readonly defaultMessage: "Scroll tabs left";
838
+ };
839
+ readonly scrollTabsRight: {
840
+ readonly id: "dockable-desktop-scrollTabsRight";
841
+ readonly defaultMessage: "Scroll tabs right";
842
+ };
843
+ readonly scrollTaskbarLeft: {
844
+ readonly id: "dockable-desktop-scrollTaskbarLeft";
845
+ readonly defaultMessage: "Scroll taskbar left";
846
+ };
847
+ readonly scrollTaskbarRight: {
848
+ readonly id: "dockable-desktop-scrollTaskbarRight";
849
+ readonly defaultMessage: "Scroll taskbar right";
850
+ };
851
+ readonly moreActions: {
852
+ readonly id: "dockable-desktop-moreActions";
853
+ readonly defaultMessage: "More actions";
854
+ };
855
+ readonly search: {
856
+ readonly id: "dockable-desktop-search";
857
+ readonly defaultMessage: "Search";
858
+ };
859
+ readonly closeSearch: {
860
+ readonly id: "dockable-desktop-closeSearch";
861
+ readonly defaultMessage: "Close search";
862
+ };
863
+ readonly searchPlaceholder: {
864
+ readonly id: "dockable-desktop-searchPlaceholder";
865
+ readonly defaultMessage: "Search…";
866
+ };
867
+ readonly modalTitle: {
868
+ readonly id: "dockable-desktop-modalTitle";
869
+ readonly defaultMessage: "Confirmation";
870
+ };
871
+ readonly emptyGroup: {
872
+ readonly id: "dockable-desktop-emptyGroup";
873
+ readonly defaultMessage: "Empty Workspace Section";
874
+ };
875
+ readonly emptyGrid: {
876
+ readonly id: "dockable-desktop-emptyGrid";
877
+ readonly defaultMessage: "Grid Empty";
878
+ };
879
+ readonly componentUnregistered: {
880
+ readonly id: "dockable-desktop-componentUnregistered";
881
+ readonly defaultMessage: "Component Unregistered";
882
+ };
883
+ readonly componentKey: {
884
+ readonly id: "dockable-desktop-componentKey";
885
+ readonly defaultMessage: "Key: {key}";
886
+ };
887
+ readonly untitledPanel: {
888
+ readonly id: "dockable-desktop-untitledPanel";
889
+ readonly defaultMessage: "Panel";
890
+ };
891
+ };
892
+ /**
893
+ * Union of every key in `defaultMessages`.
894
+ *
895
+ * Import this type in your i18n message tables to get a compile-time
896
+ * guarantee that all keys are present and no typos exist:
897
+ *
898
+ * import type { MessageKey } from 'react-dockable-desktop';
899
+ *
900
+ * const myMessages: Record<MessageKey, string> = { ... };
901
+ */
902
+ type MessageKey = keyof typeof defaultPredefinedMessages;
903
+
904
+ /**
905
+ * @file messages.ts
906
+ * @description Resolving a label — a string, a message descriptor or a thunk — to text.
907
+ */
908
+
909
+ /**
910
+ * Helper to resolve dynamic label strings or localizable descriptor objects into text.
911
+ */
912
+ declare const formatLabel: (label: string | MessageDescriptor | (() => string) | undefined, formatter: MessageFormatter) => string;
913
+
914
+ /** Custom hook to read configured style class contexts. */
915
+ declare const useStyleClasses: () => HostClasses;
916
+ /**
917
+ * The live workspace state. The component re-renders whenever it changes — or, given a selector,
918
+ * only when the selected value changes.
919
+ *
920
+ * For reads without a subscription, call the workspace's `isOpen()` or `getOpenPanelIds()`.
921
+ *
922
+ * The selector must return a value that stays the same while the state does — a primitive, or a
923
+ * part of the state as it is (`s => s.panels[id]`). A selector that builds a new object or array
924
+ * on each call (`s => ({ n: s.floating.length })`, `s => s.floating.map(...)`) is a new value
925
+ * every time React asks, and React stops with "Maximum update depth exceeded". Select the parts
926
+ * separately, or
927
+ * derive the object with `useMemo` from what you selected.
928
+ *
929
+ * @returns The current workspace state, or the selector's result.
930
+ * @throws Error if used outside `<DockableDesktopProvider>`.
931
+ * @example
932
+ * ```tsx
933
+ * function PanelCount() {
934
+ * const count = useWorkspaceState(s => Object.keys(s.panels).length);
935
+ * return <span>{count} open</span>;
936
+ * }
937
+ * ```
938
+ */
939
+ declare function useWindowManagerState(): WorkspaceState;
940
+ declare function useWindowManagerState<T>(selector: (state: WorkspaceState) => T): T;
941
+ /**
942
+ * React hook to retrieve the active i18n formatter.
943
+ */
944
+ declare const useFormatMessage: () => MessageFormatter;
945
+ /**
946
+ * React hook to fetch the localizable predefined message map catalog.
947
+ */
948
+ declare const usePredefinedMessages: () => Record<MessageKey, MessageDescriptor>;
949
+ /**
950
+ * React hook for injecting custom context menu items into a panel's context menu from inside the panel component.
951
+ * Items are dynamic — the array is re-read each time the menu opens, so state-driven changes (enable/disable, add/remove) work automatically.
952
+ * The hook knows which panel it is in — no id needed.
953
+ *
954
+ * @param items - Array of `ContextMenuItem` entries (simple items, separators, submenus).
955
+ * @example
956
+ * ```tsx
957
+ * import { usePanelContextMenu } from 'dockable-windows';
958
+ *
959
+ * function MyPanel() {
960
+ * const [dirty, setDirty] = useState(false);
961
+ * usePanelContextMenu([
962
+ * { label: 'Save', action: () => save() },
963
+ * { label: 'Revert', action: () => revert() },
964
+ * ]);
965
+ * return <Editor onChange={() => setDirty(true)} />;
966
+ * }
967
+ * ```
968
+ */
969
+ declare function usePanelContextMenu(items: ContextMenuItem[]): void;
970
+
958
971
  /** Built-in lifecycle events always available on the workspace event bus. */
959
972
  interface BuiltInEvents {
960
973
  'panel:opened': {
@@ -2147,6 +2160,12 @@ declare const toast: ToastFunction;
2147
2160
  */
2148
2161
  declare function ToastContainer({ position, maxVisible, defaultDuration, defaultClosable, pauseOnHover, animation, newestOnTop, progressBar, width, adapter, }: RddToastsProps): React$1.ReactElement | null;
2149
2162
 
2163
+ /**
2164
+ * @file types.ts
2165
+ * @description Public types of the Panel Overlay system: toolbar edges, widget stretch and
2166
+ * placement, and the config of an imperatively opened widget.
2167
+ */
2168
+
2150
2169
  /** Edge of a panel to which a `PanelToolbar` attaches. */
2151
2170
  type ToolbarPosition = 'top' | 'bottom' | 'left' | 'right';
2152
2171
  /**
@@ -2200,6 +2219,12 @@ interface ManagedWidget {
2200
2219
  */
2201
2220
  stretch?: Stretch;
2202
2221
  }
2222
+
2223
+ /**
2224
+ * @file PanelOverlayRoot.tsx
2225
+ * @description The Panel Overlay root: provides the overlay contexts and draws the corner drop zones.
2226
+ */
2227
+
2203
2228
  /** Props for `<RddPanelOverlay>`. */
2204
2229
  interface RddPanelOverlayProps {
2205
2230
  children: React$1.ReactNode;
@@ -2220,6 +2245,12 @@ interface RddPanelOverlayProps {
2220
2245
  * }
2221
2246
  */
2222
2247
  declare function PanelOverlayRoot({ children, className, style }: RddPanelOverlayProps): React$1.ReactElement;
2248
+
2249
+ /**
2250
+ * @file PanelToolbar.tsx
2251
+ * @description A toolbar on a panel edge, and its buttons, toggles and layout primitives.
2252
+ */
2253
+
2223
2254
  /** Background style of a `PanelToolbar`. */
2224
2255
  type ToolbarVariant = 'transparent' | 'frosted' | 'solid';
2225
2256
  /** Visual style applied to `ToolbarButton` and `ToolbarToggle` components. */
@@ -2291,6 +2322,12 @@ declare function ToolbarItem({ children }: {
2291
2322
  declare function ToolbarCenter({ children }: {
2292
2323
  children: React$1.ReactNode;
2293
2324
  }): React$1.ReactElement;
2325
+
2326
+ /**
2327
+ * @file ToolbarSearch.tsx
2328
+ * @description The search field of a panel toolbar, with its results dropdown.
2329
+ */
2330
+
2294
2331
  /** A single result item returned by `RddToolbarSearchProps.onSearch`. */
2295
2332
  interface SearchResult {
2296
2333
  /** Unique identifier for this result — passed to `onSelect`. */
@@ -2329,6 +2366,12 @@ interface RddToolbarSearchProps {
2329
2366
  * />
2330
2367
  */
2331
2368
  declare function ToolbarSearchInput({ placeholder, onSearch, onSelect }: RddToolbarSearchProps): React$1.ReactElement;
2369
+
2370
+ /**
2371
+ * @file FloatingWidget.tsx
2372
+ * @description A floating widget inside a panel: docked to a corner or free, stretchable, resizable.
2373
+ */
2374
+
2332
2375
  /** Props for `<RddFloatingWidget>`. */
2333
2376
  interface RddFloatingWidgetProps {
2334
2377
  /** Unique identifier within the panel overlay. Used for z-order and stack tracking. */
@@ -2413,6 +2456,7 @@ interface RddFloatingWidgetProps {
2413
2456
  * </RddFloatingWidget>
2414
2457
  */
2415
2458
  declare function PanelFloatingWindow(props: RddFloatingWidgetProps): React$1.ReactElement | null;
2459
+
2416
2460
  /**
2417
2461
  * What `useFloatingWidgets()` returns.
2418
2462
  */
@@ -2589,9 +2633,9 @@ interface ResizeConstraints {
2589
2633
  * rather than one "container bound" — a resize toward the fixed edge (e/s) is
2590
2634
  * naturally bounded by a maximum dimension, while a resize toward the moving edge
2591
2635
  * (w/n) is naturally bounded by a minimum position, and the two calling sites this
2592
- * was extracted from need different subsets of these (see WindowManager.tsx's
2636
+ * was extracted from need different subsets of these (see workspace/floatingWindowDrag.ts's
2593
2637
  * `startResize`, which omits all four and lets a window grow unbounded and be
2594
- * dragged fully off-screen, vs. PanelOverlay.tsx's `handleResizePointerDown`, which
2638
+ * dragged fully off-screen, vs. panelOverlay/FloatingWidget.tsx's `handleResizePointerDown`, which
2595
2639
  * supplies all four to keep windows within their container).
2596
2640
  */
2597
2641
  declare function computeResizedRect(dir: ResizeDir, dx: number, dy: number, start: ResizeRect, constraints: ResizeConstraints): ResizeRect;