@akcelik/strct 1.18.0 → 1.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akcelik/strct",
-  "version": "1.18.0",
+  "version": "1.20.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 {
@@ -2291,6 +2312,8 @@ declare class StrctInputMask implements ControlValueAccessor {
 interface StrctOption {
     value: unknown;
     label: string;
+    /** Grayed out and skipped by keyboard navigation (select). */
+    disabled?: boolean;
 }
 /**
  * Filterable single-select (autocomplete). CVA-compatible, fully keyboard
@@ -2334,6 +2357,74 @@ declare class StrctCombobox implements ControlValueAccessor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctCombobox, "strct-combobox", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Select-only combobox (APG pattern): a real button trigger wearing the shared
+ * `.strct-control` look, opening a token-styled listbox — so the option list
+ * matches the theme instead of the OS popup a native `<select>` shows.
+ * CVA-compatible; options are non-filterable (reach for `strct-combobox` when
+ * the list needs typing to narrow).
+ *
+ *   <strct-field label="Region">
+ *     <strct-select [options]="regions" [(ngModel)]="region" placeholder="Pick a region" />
+ *   </strct-field>
+ *
+ * Keyboard follows the native select: ArrowDown/Up and Enter/Space open,
+ * arrows move (skipping disabled options), Home/End jump, typing jumps to the
+ * matching label (typeahead), Enter/Space commit, Escape/Tab close without
+ * committing. The selected option carries a leading ✓ and gets the highlight
+ * when reopening — the same select ergonomics as `strct-dropdown-item
+ * [selected]`.
+ */
+declare class StrctSelect implements ControlValueAccessor {
+    private readonly host;
+    protected readonly listId: string;
+    /** Available options (set `disabled: true` on an option to gray it out). */
+    readonly options: _angular_core.InputSignal<StrctOption[]>;
+    /** Muted text shown while no value is selected (localizable). */
+    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Accessible name of the listbox (localizable). */
+    readonly listLabel: _angular_core.InputSignal<string>;
+    /** Text shown when `options` is empty (localizable). */
+    readonly emptyText: _angular_core.InputSignal<string>;
+    /** Static disable flag (forms also drive it via setDisabledState). */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly value: _angular_core.WritableSignal<unknown>;
+    readonly open: _angular_core.WritableSignal<boolean>;
+    readonly activeIndex: _angular_core.WritableSignal<number>;
+    readonly isDisabled: _angular_core.WritableSignal<boolean>;
+    protected readonly selectedOption: _angular_core.Signal<StrctOption | undefined>;
+    /** Typeahead buffer — clears half a second after the last keystroke. */
+    private typed;
+    private typedTimer;
+    private onChange;
+    private onTouched;
+    toggle(): void;
+    openList(): void;
+    close(): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    /**
+     * Native-select typeahead: letters accumulate into a prefix that jumps to
+     * the matching label; repeating one letter cycles its matches instead.
+     */
+    private typeahead;
+    private move;
+    /** Jump to `index`, walking `dir` past disabled options. */
+    private moveTo;
+    protected pick(opt: StrctOption, event: Event): void;
+    private commit;
+    protected onBlur(): void;
+    /** Highlight starts on the selected option — or the first enabled one. */
+    private initialIndex;
+    private scrollActiveIntoView;
+    protected onDocClick(event: MouseEvent): void;
+    writeValue(value: unknown): void;
+    registerOnChange(fn: (value: unknown) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctSelect, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctSelect, "strct-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "listLabel": { "alias": "listLabel"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 interface DayCell {
     day: number;
     iso: string;
@@ -4424,5 +4515,5 @@ declare class StrctReorderItem {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctReorderItem, "[strctReorderItem]", never, {}, {}, never, never, true, never>;
 }
 
-export { STRCT_ICONS, STRCT_ICON_GROUPS, STRCT_ICON_NAMES, STRCT_MASKS, STRCT_PALETTES, STRCT_RAW_ICONS, STRCT_TIME_RANGE_PRESETS, STRCT_WIZARD_DEFAULTS, StrctAccordion, StrctAccordionPanel, StrctAlert, StrctAnnouncer, StrctAvatar, StrctBadge, StrctBreadcrumb, StrctBreadcrumbItem, StrctButton, StrctButtonGroup, StrctBytesPipe, StrctCard, StrctCardBlock, StrctCardFooter, StrctCardHeader, StrctCascadeHost, StrctCascadeNode, StrctCascadeSelect, StrctCellDef, StrctCellStatus, StrctChart, StrctCheckbox, StrctChips, StrctCode, StrctColorPicker, StrctCombobox, StrctCommandPalette, StrctContextMenu, StrctContextMenuTrigger, StrctCopy, StrctDatagrid, StrctDatagridActionBar, StrctDatepicker, StrctDesc, StrctDescriptionList, StrctDiff, StrctDivider, StrctDonut, StrctDrawer, StrctDrawerFooter, StrctDropdown, StrctDropdownDivider, StrctDropdownItem, StrctDropdownTrigger, StrctDurationPipe, StrctEmptyState, StrctField, StrctFile, StrctFilterBar, StrctFlow, StrctFooter, StrctGauge, StrctHeader, StrctHero, StrctHotkeysHelp, StrctHotkeysService, StrctIcon, StrctInput, StrctInputMask, StrctInputOtp, StrctKbd, StrctKnob, StrctLogViewer, StrctLogin, StrctMenuPanel, StrctMenuService, StrctMenubar, StrctMetricTile, StrctModal, StrctNav, StrctNavItem, StrctOverlay, StrctPageHeader, StrctPageHeaderActions, StrctPageHeaderCrumbs, StrctPagination, StrctPassword, StrctProgress, StrctRadio, StrctRadioGroup, StrctRail, StrctRange, StrctRatePipe, StrctRating, StrctReorder, StrctReorderItem, StrctRowDetailDef, StrctSearchbox, StrctSectionMenu, StrctSegmented, StrctShell, StrctShellService, StrctSiPipe, StrctSignpost, StrctSkeleton, StrctSparkline, StrctSpeedDial, StrctSpinner, StrctSplitButton, StrctSplitter, StrctStack, StrctStackItem, StrctStep, StrctSubmenu, StrctTab, StrctTable, StrctTabs, StrctTag, StrctThemeService, StrctThemeSwitcher, StrctTimeRangePicker, StrctTimeline, StrctTimelineItem, StrctToastOutlet, StrctToastService, StrctToggle, StrctTooltip, StrctTour, StrctTransfer, StrctTree, StrctTreeNode, StrctVerticalNav, StrctWatermark, StrctWizard, StrctWizardAside, parseAnsi, provideStrctWizardDefaults, registerStrctIcon, strctComputeDiff, strctFormatBytes, strctFormatDuration, strctFormatRate, strctFormatSi, strctValidationIcon, strctValidationTone };
+export { STRCT_ICONS, STRCT_ICON_GROUPS, STRCT_ICON_NAMES, STRCT_MASKS, STRCT_PALETTES, STRCT_RAW_ICONS, STRCT_TIME_RANGE_PRESETS, STRCT_WIZARD_DEFAULTS, StrctAccordion, StrctAccordionPanel, StrctAlert, StrctAnnouncer, StrctAvatar, StrctBadge, StrctBreadcrumb, StrctBreadcrumbItem, StrctButton, StrctButtonGroup, StrctBytesPipe, StrctCard, StrctCardBlock, StrctCardFooter, StrctCardHeader, StrctCascadeHost, StrctCascadeNode, StrctCascadeSelect, StrctCellDef, StrctCellStatus, StrctChart, StrctCheckbox, StrctChips, StrctCode, StrctColorPicker, StrctCombobox, StrctCommandPalette, StrctContextMenu, StrctContextMenuTrigger, StrctCopy, StrctDatagrid, StrctDatagridActionBar, StrctDatepicker, StrctDesc, StrctDescriptionList, StrctDiff, StrctDivider, StrctDonut, StrctDrawer, StrctDrawerFooter, StrctDropdown, StrctDropdownDivider, StrctDropdownItem, StrctDropdownTrigger, StrctDurationPipe, StrctEmptyState, StrctField, StrctFile, StrctFilterBar, StrctFlow, StrctFooter, StrctGauge, StrctHeader, StrctHero, StrctHotkeysHelp, StrctHotkeysService, StrctIcon, StrctInput, StrctInputMask, StrctInputOtp, StrctKbd, StrctKnob, StrctLogViewer, StrctLogin, StrctMenuPanel, StrctMenuService, StrctMenubar, StrctMetricTile, StrctModal, StrctNav, StrctNavItem, StrctOverlay, StrctPageHeader, StrctPageHeaderActions, StrctPageHeaderCrumbs, StrctPagination, StrctPassword, StrctProgress, StrctRadio, StrctRadioGroup, StrctRail, StrctRange, StrctRatePipe, StrctRating, StrctReorder, StrctReorderItem, StrctRowDetailDef, StrctSearchbox, StrctSectionMenu, StrctSegmented, StrctSelect, StrctShell, StrctShellService, StrctSiPipe, StrctSignpost, StrctSkeleton, StrctSparkline, StrctSpeedDial, StrctSpinner, StrctSplitButton, StrctSplitter, StrctStack, StrctStackItem, StrctStep, StrctSubmenu, StrctTab, StrctTable, StrctTabs, StrctTag, StrctThemeService, StrctThemeSwitcher, StrctTimeRangePicker, StrctTimeline, StrctTimelineItem, StrctToastOutlet, StrctToastService, StrctToggle, StrctTooltip, StrctTour, StrctTransfer, StrctTree, StrctTreeNode, StrctVerticalNav, StrctWatermark, StrctWizard, StrctWizardAside, parseAnsi, provideStrctWizardDefaults, registerStrctIcon, strctComputeDiff, strctFormatBytes, strctFormatDuration, strctFormatRate, strctFormatSi, strctValidationIcon, strctValidationTone };
 export type { StrctAlertType, StrctAvatarSize, StrctAvatarStatus, StrctBadgeStatus, StrctButtonSize, StrctButtonVariant, StrctCascadeOption, StrctCellContext, StrctChartAnnotation, StrctChartColor, StrctChartCurve, StrctChartSeries, StrctChartSlot, StrctChartStatus, StrctChartThreshold, StrctChartType, StrctColumn, StrctCommandItem, StrctDatagridColumn, StrctDatagridColumnState, StrctDatagridFilters, StrctDatagridLabels, StrctDatagridLazyState, StrctDescAlign, StrctDescItem, StrctDiffRow, StrctDonutSegment, StrctDrawerSide, StrctDrawerSize, StrctEmptyVariant, StrctFilterChip, StrctFlowDirection, StrctFlowNode, StrctFlowOrientation, StrctHotkey, StrctIconBadge, StrctIconName, StrctKnobStatus, StrctLogLine, StrctMenuItem, StrctMenuLink, StrctMenuOpenOptions, StrctMenuSection, StrctMenubarItem, StrctMetricStatus, StrctModalSize, StrctMode, StrctOption, StrctOverlayPlacement, StrctPalette, StrctPaletteInfo, StrctProgressStatus, StrctRailItem, StrctRailStatus, StrctReorderEvent, StrctRow, StrctRowId, StrctSegmentedOption, StrctSegmentedSize, StrctSignpostPosition, StrctSpeedDialDirection, StrctSpinnerSize, StrctStatus, StrctTagStatus, StrctThresholds, StrctTimeRange, StrctTimeRangePreset, StrctTimelineState, StrctToast, StrctToastOptions, StrctToastType, StrctTooltipPosition, StrctTourStep, StrctTransferItem, StrctTreeMenuEvent, StrctTreeNodeData, StrctTreeNodeMenuFn, StrctValidationState, StrctValidationStatus, StrctWizardDefaults };