@ascentgl/ads-ui 22.0.3 → 22.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ascentgl/ads-ui",
-  "version": "22.0.3",
+  "version": "22.1.0",
   "peerDependencies": {
     "@angular/animations": ">=22.0.0",
     "date-fns": ">=4.1.0",

package/types/ascentgl-ads-ui.d.ts

@@ -168,7 +168,7 @@ declare class AdsButtonComponent {
 
 declare class AdsButtonContainerComponent {
     /** How buttons in the container should be placed */
-    justify: i0.InputSignal<"center" | "flex-start" | "flex-end">;
+    justify: i0.InputSignal<"flex-start" | "flex-end" | "center">;
     /** The gap between elements */
     gap: i0.InputSignal<number>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AdsButtonContainerComponent, never>;
@@ -2237,6 +2237,112 @@ declare class AdsChipComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<AdsChipComponent, "ads-chip", never, { "id": { "alias": "id"; "required": true; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "showCheckedIcon": { "alias": "showCheckedIcon"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "deletable": { "alias": "deletable"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "dropdown": { "alias": "dropdown"; "required": false; "isSignal": true; }; "dropdownOptions": { "alias": "dropdownOptions"; "required": false; "isSignal": true; }; }, { "deleted": "deleted"; "selected": "selected"; "optionSelected": "optionSelected"; }, never, ["*"], true, never>;
 }
 
+/**
+ * A single selectable entry inside an {@link AdsMenuDropDownComponent}.
+ */
+interface AdsMenuDropDownItem {
+    /** Unique identifier for the item, used for tracking and emitted on selection */
+    id: string;
+    /** The visible text label of the item */
+    label: string;
+    /** Optional leading icon name from the ADS icon set */
+    icon?: adsIcon;
+    /** Whether the item is disabled (skipped during keyboard navigation and not selectable) */
+    disabled?: boolean;
+}
+
+declare class AdsMenuDropDownComponent implements AfterViewInit {
+    private registry;
+    constructor(registry: AdsIconRegistry);
+    /** The list of menu items to display */
+    items: i0.InputSignal<AdsMenuDropDownItem[]>;
+    /** Accessible label describing the menu, exposed via `aria-label` */
+    ariaLabel: i0.InputSignal<string>;
+    /** Move keyboard focus to the first item once the menu is rendered */
+    autoFocus: i0.InputSignal<boolean>;
+    /** Emitted when an enabled item is selected (via click, Enter or Space) */
+    itemSelect: i0.OutputEmitterRef<AdsMenuDropDownItem>;
+    /** Emitted when the menu requests to close (Escape key or Tab out) */
+    closed: i0.OutputEmitterRef<void>;
+    /** @ignore Index of the item that currently owns the roving tabindex */
+    readonly activeIndex: i0.WritableSignal<number>;
+    /** @ignore References to the rendered menu item buttons */
+    private readonly itemButtons;
+    /** @ignore */
+    ngAfterViewInit(): void;
+    /** @ignore Handles all keyboard interaction for the menu */
+    onKeydown(event: KeyboardEvent): void;
+    /** @ignore */
+    selectItem(item: AdsMenuDropDownItem): void;
+    /** @ignore */
+    private selectActive;
+    /** @ignore Moves focus to the next enabled item in the given direction, wrapping around */
+    private moveFocus;
+    /** @ignore */
+    private focusIndex;
+    /** @ignore */
+    private firstEnabledIndex;
+    /** @ignore */
+    private lastEnabledIndex;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AdsMenuDropDownComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AdsMenuDropDownComponent, "ads-menu-drop-down", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "autoFocus": { "alias": "autoFocus"; "required": false; "isSignal": true; }; }, { "itemSelect": "itemSelect"; "closed": "closed"; }, never, never, true, never>;
+}
+
+/** Preferred side/alignment the menu opens towards before auto-flipping. */
+type AdsMenuDropDownPosition = 'below-start' | 'below-end' | 'above-start' | 'above-end';
+/**
+ * Opens an {@link AdsMenuDropDownComponent} in a CDK overlay anchored to the host element.
+ *
+ * The overlay is rendered at the document root (so it is never clipped by an ag-grid cell or
+ * any `overflow: hidden` ancestor) and auto-positions itself: it opens towards `menuPosition`
+ * when there is room, otherwise it flips to whichever side fits, and is pushed fully into the
+ * viewport as a last resort so it is always visible.
+ *
+ * @example
+ * ```html
+ * <ads-icon-button
+ *   [adsMenuDropDownTriggerFor]="actionItems"
+ *   menuPosition="below-start"
+ *   (itemSelect)="onAction($event, row)">
+ *   <ads-icon name="more_vertical" />
+ * </ads-icon-button>
+ * ```
+ */
+declare class AdsMenuDropDownTriggerDirective implements OnDestroy {
+    private readonly overlay;
+    private readonly elementRef;
+    /** The items to render inside the menu */
+    items: i0.InputSignal<AdsMenuDropDownItem[]>;
+    /** Preferred side/alignment the menu opens towards before auto-flipping */
+    menuPosition: i0.InputSignal<AdsMenuDropDownPosition>;
+    /** Accessible label applied to the menu panel */
+    menuAriaLabel: i0.InputSignal<string>;
+    /** Disable the trigger so the menu cannot be opened */
+    disabled: i0.InputSignalWithTransform<boolean, unknown>;
+    /** Emitted when an enabled item is selected */
+    itemSelect: i0.OutputEmitterRef<AdsMenuDropDownItem>;
+    /** Emitted when the menu opens */
+    menuOpened: i0.OutputEmitterRef<void>;
+    /** Emitted when the menu closes */
+    menuClosed: i0.OutputEmitterRef<void>;
+    /** @ignore Whether the menu is currently open */
+    readonly isOpen: i0.WritableSignal<boolean>;
+    /** @ignore */
+    private overlayRef;
+    /** @ignore */
+    private menuRef;
+    /** @ignore */
+    toggle(): void;
+    /** Open the menu (no-op if disabled or already open). */
+    open(): void;
+    /** Close the menu and restore focus to the trigger. */
+    close(): void;
+    /** @ignore */
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AdsMenuDropDownTriggerDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<AdsMenuDropDownTriggerDirective, "[adsMenuDropDownTriggerFor]", never, { "items": { "alias": "adsMenuDropDownTriggerFor"; "required": true; "isSignal": true; }; "menuPosition": { "alias": "menuPosition"; "required": false; "isSignal": true; }; "menuAriaLabel": { "alias": "menuAriaLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "itemSelect": "itemSelect"; "menuOpened": "menuOpened"; "menuClosed": "menuClosed"; }, never, never, true, never>;
+}
+
 declare class AdsExpansionPanelComponent implements AfterContentInit {
     private registry;
     private elementRef;
@@ -2261,7 +2367,7 @@ declare class AdsExpansionPanelComponent implements AfterContentInit {
     /** Component width. Must include units of measure: px, %, em, rem, etc. */
     width: i0.InputSignal<string>;
     /** The Chevron Icon size () */
-    chevronSize: i0.InputSignal<"xs" | "base">;
+    chevronSize: i0.InputSignal<"base" | "xs">;
     /** Header padding size () */
     headerPadding: i0.InputSignal<string>;
     /** Content padding size () */
@@ -2520,7 +2626,7 @@ declare class AdsSortMenuComponent implements OnChanges, OnDestroy {
     /** All column sort/filter configs (all possible columns) */
     columnSortFilterConfigs: ColumnSortFilterConfig[];
     /** Current column sort states from the table */
-    columnSortStates: Map<string, "asc" | "desc" | null>;
+    columnSortStates: Map<string, "desc" | "asc" | null>;
     /** Emits when sort configuration changes (order or direction) */
     sortChanged: EventEmitter<SortMenuChangeEvent>;
     /** Emits when sorts are removed for columns */
@@ -2637,7 +2743,7 @@ declare class AdsTableComponent implements AfterViewInit, AfterViewChecked, OnCh
         values: string[];
     }>;
     /** Event emitted when view mode changes between grid and list */
-    viewChanged: EventEmitter<"grid" | "list">;
+    viewChanged: EventEmitter<"list" | "grid">;
     /** @ignore - Current view mode: grid or list */
     isListView: i0.WritableSignal<boolean>;
     /** @ignore - Cached filtered row data for list view */
@@ -2677,7 +2783,7 @@ declare class AdsTableComponent implements AfterViewInit, AfterViewChecked, OnCh
     /** @ignore */
     activeColumnMenu: i0.WritableSignal<string | null>;
     /** @ignore */
-    columnSortStates: i0.WritableSignal<Map<string, "asc" | "desc" | null>>;
+    columnSortStates: i0.WritableSignal<Map<string, "desc" | "asc" | null>>;
     /** @ignore */
     columnFilterStates: i0.WritableSignal<Map<string, string[]>>;
     /** @ignore */
@@ -3441,7 +3547,7 @@ declare class AdsHorizontalStepperComponent {
     /**
      * Stepper size
      */
-    size: i0.InputSignal<"xs" | "base">;
+    size: i0.InputSignal<"base" | "xs">;
     /** @ignore */
     protected isBaseSize: i0.Signal<boolean>;
     /** Event emitted when a step is clicked */
@@ -3937,5 +4043,5 @@ declare function provideAdsUi(config: AdsUiConfig): {
     useValue: AdsUiConfig;
 }[];
 
-export { AdsArchitectureLogoComponent, AdsAscentLogoComponent, AdsAvatarComponent, AdsBaselineWidgetComponent, AdsBreadcrumbComponent, AdsBubbleComponent, AdsButtonComponent, AdsButtonContainerComponent, AdsCardComponent, AdsCheckboxComponent, AdsChipComponent, AdsColumnSortFilterMenuComponent, AdsCreateTagComponent, AdsCurrencyFieldComponent, AdsCustomHeaderComponent, AdsCustomerPortalLogoComponent, AdsCxaLogoComponent, AdsDatepickerComponent, AdsDatetimepickerComponent, AdsDragAndDropListComponent, AdsDropdownComponent, AdsErrorPageCodeComponent, AdsErrorPageComponent, AdsExpansionPanelComponent, AdsFilterMenuComponent, AdsFooterComponent, AdsFooterContainerComponent, AdsGenericLogoComponent, AdsHeaderComponent, AdsHeaderContainerComponent, AdsHistoryStepperComponent, AdsHorizontalNavBarComponent, AdsHorizontalStepperComponent, AdsIconButtonComponent, AdsIconHoverComponent, AdsInputComponent, AdsInputDropdownComponent, AdsInternationalPhoneFieldComponent, AdsLinkButtonComponent, AdsMainMenuComponent, AdsModalComponent, AdsMultiSelectDropdownComponent, AdsNavMenuComponent, AdsNavigationCollapseHandleComponent, AdsNavigationComponent, AdsNavigationHeaderComponent, AdsNavigationItemComponent, AdsNavigationItemsContainerComponent, AdsNumericBadgeComponent, AdsNumericStepperComponent, AdsOrgDisplayTextComponent, AdsPeakEssentialsLogoComponent, AdsPeakMarketplaceLogoComponent, AdsPeakOrderManagementLogoComponent, AdsPhoneFieldComponent, AdsPilotPayLogoComponent, AdsPrimaryLogoComponent, AdsProgressBarComponent, AdsProgressIndicatorSpinnerComponent, AdsProgressSpinnerComponent, AdsProgressStepperComponent, AdsRadioButtonComponent, AdsScmsLogoComponent, AdsScmsSideNavBarComponent, AdsSearchDropdownComponent, AdsSearchInputComponent, AdsShipmentHorizontalStepperComponent, AdsSideNavBarComponent, AdsSideNavBarV2Component, AdsSlideToggleComponent, AdsSliderComponent, AdsSnackbarComponent, AdsSortMenuComponent, AdsSplashPageComponent, AdsStepperComponent, AdsSubNavigationButtonComponent, AdsTableComponent, AdsTabsComponent, AdsTagComponent, AdsTagContainerComponent, AdsTextareaComponent, AdsTimeFieldComponent, AdsTimepickerComponent, AdsVerticalSideNavigationStepperComponent, AdsWizardStepperComponent, AscentCardComponent, BadgeColor, Colors, CountryCode, CustomDatetimeAdapter, DividerComponent, ErrorPageDefault, HistoryAction, HorizontalStepStatus, MainMenuService, ModalActionType, ModalPanelClass, PanelClass, ShellLayoutComponent, SpinnerSize, StepStatus, TableBreakpoint, ViewportService, WindowService, WizardStepStatus, provideAdsUi };
-export type { ActiveFilter, ActiveSort, AdsModalData, AdsNavItemV2, AdsNavSubItemV2, AdsUiConfig, Breadcrumb, ColumnFilterOption, ColumnSortFilterConfig, ColumnSortOption, ColumnVisibilityControl, Copyright, CustomHeaderParams, DROP_CALLBACK_INDEXES, DividerStyle, ErrorPageConfig, ErrorPageInfoColumn, FilterOptionsSortComparator, FilterValueFormatter, HistoryContextTag, HistoryEvent, HistoryGroup, HorizontalNavLink, HorizontalStep, IconButtonSize, Link, MainMenuItem, NavItem, NavMenuItem, NumericStep, ProgressStep, ScmsNavItem, ScmsNavSubItem, SearchDropdownComponentOptions, SearchDropdownDisplayControlValue, SearchDropdownStaticOption, SearchDropdownStaticOptionTemplateContext, ShipmentStep, Size, SnackBarData, SortComparator, SortMenuChangeEvent, SortType, Step, Tab, Tag, UNSUBSCRIBE_FUNCTIONS_COLLECTION, Variant, VerticalSideNavigationStep, WizardStep };
+export { AdsArchitectureLogoComponent, AdsAscentLogoComponent, AdsAvatarComponent, AdsBaselineWidgetComponent, AdsBreadcrumbComponent, AdsBubbleComponent, AdsButtonComponent, AdsButtonContainerComponent, AdsCardComponent, AdsCheckboxComponent, AdsChipComponent, AdsColumnSortFilterMenuComponent, AdsCreateTagComponent, AdsCurrencyFieldComponent, AdsCustomHeaderComponent, AdsCustomerPortalLogoComponent, AdsCxaLogoComponent, AdsDatepickerComponent, AdsDatetimepickerComponent, AdsDragAndDropListComponent, AdsDropdownComponent, AdsErrorPageCodeComponent, AdsErrorPageComponent, AdsExpansionPanelComponent, AdsFilterMenuComponent, AdsFooterComponent, AdsFooterContainerComponent, AdsGenericLogoComponent, AdsHeaderComponent, AdsHeaderContainerComponent, AdsHistoryStepperComponent, AdsHorizontalNavBarComponent, AdsHorizontalStepperComponent, AdsIconButtonComponent, AdsIconHoverComponent, AdsInputComponent, AdsInputDropdownComponent, AdsInternationalPhoneFieldComponent, AdsLinkButtonComponent, AdsMainMenuComponent, AdsMenuDropDownComponent, AdsMenuDropDownTriggerDirective, AdsModalComponent, AdsMultiSelectDropdownComponent, AdsNavMenuComponent, AdsNavigationCollapseHandleComponent, AdsNavigationComponent, AdsNavigationHeaderComponent, AdsNavigationItemComponent, AdsNavigationItemsContainerComponent, AdsNumericBadgeComponent, AdsNumericStepperComponent, AdsOrgDisplayTextComponent, AdsPeakEssentialsLogoComponent, AdsPeakMarketplaceLogoComponent, AdsPeakOrderManagementLogoComponent, AdsPhoneFieldComponent, AdsPilotPayLogoComponent, AdsPrimaryLogoComponent, AdsProgressBarComponent, AdsProgressIndicatorSpinnerComponent, AdsProgressSpinnerComponent, AdsProgressStepperComponent, AdsRadioButtonComponent, AdsScmsLogoComponent, AdsScmsSideNavBarComponent, AdsSearchDropdownComponent, AdsSearchInputComponent, AdsShipmentHorizontalStepperComponent, AdsSideNavBarComponent, AdsSideNavBarV2Component, AdsSlideToggleComponent, AdsSliderComponent, AdsSnackbarComponent, AdsSortMenuComponent, AdsSplashPageComponent, AdsStepperComponent, AdsSubNavigationButtonComponent, AdsTableComponent, AdsTabsComponent, AdsTagComponent, AdsTagContainerComponent, AdsTextareaComponent, AdsTimeFieldComponent, AdsTimepickerComponent, AdsVerticalSideNavigationStepperComponent, AdsWizardStepperComponent, AscentCardComponent, BadgeColor, Colors, CountryCode, CustomDatetimeAdapter, DividerComponent, ErrorPageDefault, HistoryAction, HorizontalStepStatus, MainMenuService, ModalActionType, ModalPanelClass, PanelClass, ShellLayoutComponent, SpinnerSize, StepStatus, TableBreakpoint, ViewportService, WindowService, WizardStepStatus, provideAdsUi };
+export type { ActiveFilter, ActiveSort, AdsMenuDropDownItem, AdsMenuDropDownPosition, AdsModalData, AdsNavItemV2, AdsNavSubItemV2, AdsUiConfig, Breadcrumb, ColumnFilterOption, ColumnSortFilterConfig, ColumnSortOption, ColumnVisibilityControl, Copyright, CustomHeaderParams, DROP_CALLBACK_INDEXES, DividerStyle, ErrorPageConfig, ErrorPageInfoColumn, FilterOptionsSortComparator, FilterValueFormatter, HistoryContextTag, HistoryEvent, HistoryGroup, HorizontalNavLink, HorizontalStep, IconButtonSize, Link, MainMenuItem, NavItem, NavMenuItem, NumericStep, ProgressStep, ScmsNavItem, ScmsNavSubItem, SearchDropdownComponentOptions, SearchDropdownDisplayControlValue, SearchDropdownStaticOption, SearchDropdownStaticOptionTemplateContext, ShipmentStep, Size, SnackBarData, SortComparator, SortMenuChangeEvent, SortType, Step, Tab, Tag, UNSUBSCRIBE_FUNCTIONS_COLLECTION, Variant, VerticalSideNavigationStep, WizardStep };