react-dockable-desktop 7.4.1 → 7.6.0

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.cts CHANGED
@@ -251,6 +251,15 @@ interface ShowContextMenuOptions {
251
251
  * opened without an event. The menu is portaled to `<body>`, so it can't inherit either.
252
252
  */
253
253
  dir?: 'ltr' | 'rtl';
254
+ /**
255
+ * Where focus goes when the menu opens. `'menu'` (the default) focuses the menu itself, with no
256
+ * item highlighted: ArrowDown then reaches the first item and ArrowUp the last. `'first-item'`
257
+ * focuses the first enabled item, for a menu opened from the keyboard. When this is left out, a
258
+ * keyboard `contextmenu` event (the ContextMenu key or Shift+F10, which report no pointer
259
+ * position) opens on the first item and everything else, including a call with no event, on
260
+ * the menu: the same view every time, whatever the user did before.
261
+ */
262
+ initialFocus?: 'menu' | 'first-item';
254
263
  }
255
264
  interface ContextMenuHandle {
256
265
  show(options: ShowContextMenuOptions): void;
@@ -2223,7 +2232,7 @@ interface RddPanelToolbarProps {
2223
2232
  variant?: ToolbarVariant;
2224
2233
  /** Default button style inherited by `ToolbarButton` and `ToolbarToggle` children. @default 'ghost' */
2225
2234
  buttonVariant?: ButtonVariant;
2226
- /** Icon size in pixels for all buttons in this toolbar. Falls back to CSS default when unset. */
2235
+ /** Button size in pixels for all buttons in this toolbar (sets `--rdd-panel-toolbar-btn-size`). The icon inside follows `--rdd-panel-toolbar-icon-size`. Falls back to the stylesheet when unset. */
2227
2236
  buttonSize?: number;
2228
2237
  style?: React$1.CSSProperties;
2229
2238
  className?: string;
@@ -2242,7 +2251,7 @@ interface RddPanelToolbarProps {
2242
2251
  declare function PanelToolbar({ position, variant, buttonVariant, buttonSize, style, className, children }: RddPanelToolbarProps): React$1.ReactElement;
2243
2252
  /** Props for `<RddToolbarButton>`. */
2244
2253
  interface RddToolbarButtonProps {
2245
- /** Button icon — typically a small SVG component. */
2254
+ /** Button icon: an SVG, an icon component or an icon-font glyph. Pass no size: the library sizes it with `--rdd-panel-toolbar-icon-size`. */
2246
2255
  icon: React$1.ReactNode;
2247
2256
  /** Click handler. */
2248
2257
  onClick(): void;
@@ -2256,7 +2265,7 @@ interface RddToolbarButtonProps {
2256
2265
  declare function ToolbarButton({ icon, onClick, disabled, title, variant }: RddToolbarButtonProps): React$1.ReactElement;
2257
2266
  /** Props for `<RddToolbarToggle>`. */
2258
2267
  interface RddToolbarToggleProps {
2259
- /** Button icon — typically a small SVG component. */
2268
+ /** Button icon: an SVG, an icon component or an icon-font glyph. Pass no size: the library sizes it with `--rdd-panel-toolbar-icon-size`. */
2260
2269
  icon: React$1.ReactNode;
2261
2270
  /** Whether the toggle is in the active/pressed state. Sets `aria-pressed` automatically. */
2262
2271
  active: boolean;
package/dist/index.d.ts CHANGED
@@ -251,6 +251,15 @@ interface ShowContextMenuOptions {
251
251
  * opened without an event. The menu is portaled to `<body>`, so it can't inherit either.
252
252
  */
253
253
  dir?: 'ltr' | 'rtl';
254
+ /**
255
+ * Where focus goes when the menu opens. `'menu'` (the default) focuses the menu itself, with no
256
+ * item highlighted: ArrowDown then reaches the first item and ArrowUp the last. `'first-item'`
257
+ * focuses the first enabled item, for a menu opened from the keyboard. When this is left out, a
258
+ * keyboard `contextmenu` event (the ContextMenu key or Shift+F10, which report no pointer
259
+ * position) opens on the first item and everything else, including a call with no event, on
260
+ * the menu: the same view every time, whatever the user did before.
261
+ */
262
+ initialFocus?: 'menu' | 'first-item';
254
263
  }
255
264
  interface ContextMenuHandle {
256
265
  show(options: ShowContextMenuOptions): void;
@@ -2223,7 +2232,7 @@ interface RddPanelToolbarProps {
2223
2232
  variant?: ToolbarVariant;
2224
2233
  /** Default button style inherited by `ToolbarButton` and `ToolbarToggle` children. @default 'ghost' */
2225
2234
  buttonVariant?: ButtonVariant;
2226
- /** Icon size in pixels for all buttons in this toolbar. Falls back to CSS default when unset. */
2235
+ /** Button size in pixels for all buttons in this toolbar (sets `--rdd-panel-toolbar-btn-size`). The icon inside follows `--rdd-panel-toolbar-icon-size`. Falls back to the stylesheet when unset. */
2227
2236
  buttonSize?: number;
2228
2237
  style?: React$1.CSSProperties;
2229
2238
  className?: string;
@@ -2242,7 +2251,7 @@ interface RddPanelToolbarProps {
2242
2251
  declare function PanelToolbar({ position, variant, buttonVariant, buttonSize, style, className, children }: RddPanelToolbarProps): React$1.ReactElement;
2243
2252
  /** Props for `<RddToolbarButton>`. */
2244
2253
  interface RddToolbarButtonProps {
2245
- /** Button icon — typically a small SVG component. */
2254
+ /** Button icon: an SVG, an icon component or an icon-font glyph. Pass no size: the library sizes it with `--rdd-panel-toolbar-icon-size`. */
2246
2255
  icon: React$1.ReactNode;
2247
2256
  /** Click handler. */
2248
2257
  onClick(): void;
@@ -2256,7 +2265,7 @@ interface RddToolbarButtonProps {
2256
2265
  declare function ToolbarButton({ icon, onClick, disabled, title, variant }: RddToolbarButtonProps): React$1.ReactElement;
2257
2266
  /** Props for `<RddToolbarToggle>`. */
2258
2267
  interface RddToolbarToggleProps {
2259
- /** Button icon — typically a small SVG component. */
2268
+ /** Button icon: an SVG, an icon component or an icon-font glyph. Pass no size: the library sizes it with `--rdd-panel-toolbar-icon-size`. */
2260
2269
  icon: React$1.ReactNode;
2261
2270
  /** Whether the toggle is in the active/pressed state. Sets `aria-pressed` automatically. */
2262
2271
  active: boolean;