@akcelik/strct 1.18.0 → 1.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akcelik/strct",
-  "version": "1.18.0",
+  "version": "1.19.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

@@ -1231,10 +1231,23 @@ declare class StrctDropdown {
     readonly popoverLabel: _angular_core.InputSignal<string>;
     readonly open: _angular_core.WritableSignal<boolean>;
     constructor();
+    /** Where focus was when the menu opened — restored on Escape/selection. */
+    private lastFocused;
     toggle(): void;
-    close(): void;
-    /** Menu items close on activation; popover form controls never do. */
-    protected onInnerActivate(): void;
+    /** Open (if closed) and move focus into the menu — ArrowDown on the trigger. */
+    openMenu(): void;
+    close(restoreFocus?: boolean): void;
+    /**
+     * Menu mode closes ONLY on a real item activation — a click that lands on
+     * the menu's padding or a divider (a 2px miss) keeps it open instead of
+     * throwing the whole interaction away. Popover form controls never close.
+     */
+    protected onInnerActivate(event: Event): void;
+    /** APG menu keyboarding: arrows rove, Home/End jump, Enter/Space activate. */
+    protected onMenuKeydown(event: KeyboardEvent): void;
+    private enabledItems;
+    /** Focus the selected item if there is one, else the first — after render. */
+    private focusInitialItem;
     protected onDocClick(event: MouseEvent): void;
     protected onEscape(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctDropdown, never>;
@@ -1247,17 +1260,25 @@ declare class StrctDropdown {
  */
 declare class StrctDropdownTrigger {
     protected readonly dd: StrctDropdown | null;
+    protected onArrowDown(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctDropdownTrigger, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctDropdownTrigger, "[strctDropdownTrigger]", never, {}, {}, never, never, true, never>;
 }
 /** A selectable row inside a `<strct-dropdown>`. */
 declare class StrctDropdownItem {
+    /**
+     * Select-like usage: bind `selected` and the item becomes a
+     * `menuitemradio` with `aria-checked`, a leading ✓ on the current choice
+     * and an aligned lead slot — so reopening the menu shows what is chosen.
+     * Leave unbound for plain action items.
+     */
+    readonly selected: _angular_core.InputSignal<boolean | null>;
     /** Danger. */
     readonly critical: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Static disable flag. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctDropdownItem, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctDropdownItem, "strct-dropdown-item", never, { "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; }; }, {}, never, ["*"], true, never>;
 }
 /** Thin separator between groups of menu items. */
 declare class StrctDropdownDivider {