nexus-shell 0.2.14 → 0.2.16

package/dist/components/widgets/MenuBar.d.ts

@@ -36,7 +36,7 @@ export interface MenuBarProps {
     className?: string;
 }
 /**
- * The application menu bar: a row of hover-activated dropdowns with optional
+ * The application menu bar: a row of menu buttons with dropdowns and optional
  * one-level submenus, plus slots for branding, a centre widget and right-hand
  * actions.
  *
@@ -44,6 +44,21 @@ export interface MenuBarProps {
  * out through `onSelect`. It reads no registry. For the variant wired to the
  * {@link menuRegistry} and {@link commandRegistry}, see `ConnectedMenuBar`.
  *
+ * # Open and closed are state, not hover
+ *
+ * The menus used to be CSS hover: shown while the pointer was over them. So a
+ * menu stayed open after an item was chosen (the pointer was still there),
+ * Escape could not close it, and a keyboard could not open one at all. Now a
+ * menu opens on a click or a key and closes when an item is chosen, on
+ * Escape, on Tab, or on a click elsewhere. While one is open, pointing at
+ * another switches to it, as desktop menu bars do.
+ *
+ * Keys, following the WAI-ARIA menu button pattern: Enter, Space or ↓ on a
+ * menu name opens it at its first item, ↑ at its last; ↑ ↓ Home End move
+ * through items; ← → move to the neighbouring menu; → or Enter on an item with
+ * a submenu opens it and ← closes it; Escape closes and returns focus to the
+ * menu's name.
+ *
  * @example
  * ```tsx
  * <MenuBar

package/dist/core/services/LayoutService.d.ts

@@ -41,5 +41,16 @@ export declare const dialogueMapperMenus: {
         commandId: string;
     }[];
 };
+/**
+ * A model from JSON, with empty borders hidden.
+ *
+ * The default layout has a left border for tabs to be docked into, and with
+ * nothing docked it still drew a 30px blank strip down the edge of every app.
+ * Auto-hide removes it while it is empty; a tab dragged to the edge docks as
+ * before. Applied to stored layouts too, since those carry the border and
+ * not the setting — an app that wants the strip says so with
+ * `borderEnableAutoHide: false`.
+ */
+export declare const layoutFromJson: (json: IJsonModel) => Model;
 export declare const useLayoutStore: import('zustand').UseBoundStore<import('zustand').StoreApi<LayoutState>>;
 export {};