@akcelik/strct 4.1.0 → 4.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akcelik/strct",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "description": "UIStruct — a standalone Angular component library with a tokenised, multi-palette theme system, built for datacenter / infrastructure management UIs.",
   "author": "Serkan Akcelik <serkan.akcelik@gmail.com>",
   "license": "MIT",

package/types/akcelik-strct.d.ts

@@ -878,7 +878,16 @@ interface StrctMenuItem {
     icon?: string;
     /** Destructive styling. */
     critical?: boolean;
+    /** Unavailable: shown dimmed and cannot be activated. Pair with `hint` to say why. */
     disabled?: boolean;
+    /**
+     * A short explanation — typically why a disabled entry is unavailable
+     * ("VM must be powered off to clone."). Shown as the entry's tooltip and
+     * given to assistive technology as its description; never rendered inline,
+     * so it never widens the menu. A disabled entry WITH a hint stays reachable
+     * by keyboard so its reason can be read; without one it is skipped, as before.
+     */
+    hint?: string;
     /** Render a separator instead of an entry (label is ignored). */
     divider?: boolean;
     /** Nested submenu. */
@@ -919,7 +928,13 @@ declare class StrctMenuPanel {
     protected readonly flipLeft: _angular_core.WritableSignal<boolean>;
     protected readonly activeIndex: _angular_core.WritableSignal<number>;
     protected readonly openSubIndex: _angular_core.WritableSignal<number | null>;
+    /** Entries the keyboard visits: not dividers, and not a disabled entry that
+     *  has nothing to say — a disabled entry WITH a hint is reachable so its
+     *  reason can be read. (Before, disabled entries were "visited" but a
+     *  natively disabled button refused focus, stranding the keyboard.) */
     private readonly navIndices;
+    private readonly uid;
+    protected hintId(i: number): string;
     constructor();
     private clampToViewport;
     protected focusItem(i: number): void;
@@ -1379,6 +1394,9 @@ declare class StrctDropdown {
     /** APG menu keyboarding: arrows rove, Home/End jump, Enter/Space activate. */
     protected onMenuKeydown(event: KeyboardEvent): void;
     private enabledItems;
+    /** What the arrow keys visit: enabled items, plus disabled ones that carry a
+     *  hint (so the reason can be read). The menu still opens on an enabled one. */
+    private navItems;
     /** Focus the selected item if there is one, else the first — after render. */
     private focusInitialItem;
     protected onDocClick(event: MouseEvent): void;
@@ -1410,8 +1428,17 @@ declare class StrctDropdownItem {
     readonly critical: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Static disable flag. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * A short explanation — typically why a disabled item is unavailable. Shown
+     * as the tooltip and given to assistive technology as the description; never
+     * rendered inline. A disabled item with a hint stays keyboard-reachable so
+     * its reason can be read; activation stays blocked.
+     */
+    readonly hint: _angular_core.InputSignal<string | null | undefined>;
+    protected readonly hintId: string;
+    constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctDropdownItem, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctDropdownItem, "strct-dropdown-item", never, { "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "critical": { "alias": "critical"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctDropdownItem, "strct-dropdown-item", never, { "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "critical": { "alias": "critical"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 /** Thin separator between groups of menu items. */
 declare class StrctDropdownDivider {
@@ -1449,7 +1476,8 @@ declare class StrctContextMenu {
     private restoreTo;
     onContextMenu(event: MouseEvent): void;
     close(): void;
-    /** Enabled `strct-dropdown-item` elements in DOM order. */
+    /** Keyboard-reachable `strct-dropdown-item` elements in DOM order: enabled
+     *  ones, plus disabled ones that carry a hint (so the reason can be read). */
     private navItems;
     /**
      * Focus-based roving: items keep the `tabindex="-1"` their host binding
@@ -1508,7 +1536,8 @@ declare class StrctSubmenu {
      * the panel so a host menu's own roving/Escape does not also run.
      */
     protected onPanelKeydown(event: KeyboardEvent): void;
-    /** Rovable rows of the open fly-out (dropdown items, skipping disabled). */
+    /** Rovable rows of the open fly-out: enabled dropdown items, plus disabled
+     *  ones that carry a hint (so the reason can be read). */
     private panelItems;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctSubmenu, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctSubmenu, "strct-submenu", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; }, {}, never, ["[strctSubmenuLabel]", "*"], true, never>;
@@ -4861,7 +4890,7 @@ declare class StrctTransfer {
 declare class StrctSplitButton {
     /** Main action label. */
     readonly label: _angular_core.InputSignal<string>;
-    /** Menu entries (StrctMenuItem: id, label, icon?, critical?, disabled?). */
+    /** Menu entries (StrctMenuItem: id, label, icon?, critical?, disabled?, hint?). */
     readonly items: _angular_core.InputSignal<StrctMenuItem[]>;
     /** Optional leading icon of the main segment. */
     readonly icon: _angular_core.InputSignal<string>;
@@ -5023,8 +5052,12 @@ declare class StrctMenubar {
     /** Switch the open menu to the next/previous top-level entry; focus follows. */
     private switchTop;
     private closeMenu;
+    private readonly uid;
+    protected hintId(menuId: string, i: number, j?: number): string;
     private topButtons;
-    /** Enabled item buttons of the open menu — either its items or the open submenu's. */
+    /** Keyboard-reachable item buttons of the open menu — either its items or the
+     *  open submenu's: enabled ones, plus disabled ones that carry a hint (so the
+     *  reason can be read). A disabled entry with nothing to say is skipped. */
     private navButtons;
     protected onDocClick(event: MouseEvent): void;
     protected onEscape(event: Event): void;