@fundamental-ngx/btp 0.58.0-rc.6 → 0.58.0-rc.61

package/navigation/index.d.ts

@@ -1,12 +1,12 @@
 import * as _angular_core from '@angular/core';
 import { ElementRef, Signal, TemplateRef, OnDestroy, OnChanges, AfterViewInit, EventEmitter, SimpleChanges, QueryList, WritableSignal, DestroyRef, AfterContentInit, OnInit } from '@angular/core';
+import { Nullable as Nullable$1 } from '@fundamental-ngx/cdk';
 import { FocusableOption, FocusOrigin } from '@angular/cdk/a11y';
 import { HasElementRef, Nullable, CssClassBuilder } from '@fundamental-ngx/cdk/utils';
 import { PopoverComponent } from '@fundamental-ngx/core/popover';
 import { Placement } from '@fundamental-ngx/core/shared';
 import * as i1 from '@angular/router';
 import { RouterLink } from '@angular/router';
-import { Nullable as Nullable$1 } from '@fundamental-ngx/cdk';
 import { IconFont } from '@fundamental-ngx/core/icon';
 import { Subject, Observable } from 'rxjs';
 import * as i1$1 from '@fundamental-ngx/core/scrollbar';
@@ -37,8 +37,6 @@ declare class NavigationLinkComponent extends FdbNavigationItemLink implements O
     external: boolean;
     /** Whether it's a quick create button. */
     quickCreate: boolean;
-    /** @hidden */
-    private get _tabIndex();
     /** Whether the link is inside popover. */
     get inPopover(): boolean;
     /** Element reference. */
@@ -56,13 +54,21 @@ declare class NavigationLinkComponent extends FdbNavigationItemLink implements O
     /** @hidden */
     private readonly _navigation;
     /** @hidden */
+    private _renderer;
+    /** @hidden */
+    private _tabIndexEffect;
+    /** @hidden */
     constructor();
     /** @hidden */
-    private _clickHandler;
+    protected _clickHandler(event: Event): void;
     /** @hidden */
-    private _keyDownHandler;
+    protected _keyDownHandler(event: Event): void;
     /** @hidden */
     ngOnDestroy(): void;
+    /** @hidden */
+    private _updateTabIndex;
+    /** @hidden */
+    private _canItemBeSelected;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationLinkComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationLinkComponent, "a[fdb-navigation-link], button[fdb-navigation-link]", never, { "class": { "alias": "class"; "required": false; }; "glyph": { "alias": "glyph"; "required": false; }; "glyphFont": { "alias": "glyphFont"; "required": false; }; "external": { "alias": "external"; "required": false; }; "quickCreate": { "alias": "quickCreate"; "required": false; }; }, {}, never, ["*"], true, [{ directive: typeof i1.RouterLinkActive; inputs: {}; outputs: {}; }]>;
     static ngAcceptInputType_quickCreate: unknown;
@@ -73,7 +79,16 @@ declare class NavigationListComponent implements OnChanges, AfterViewInit, OnDes
     set _listItems(value: Nullable$1<FdbNavigationListItem>[]);
     get _listItems(): Nullable$1<FdbNavigationListItem>[];
     /** List Role. */
-    role: 'tree' | 'menubar';
+    get _role(): 'tree' | 'menubar' | 'group' | 'menu';
+    role: 'tree' | 'menubar' | 'group' | 'menu';
+    /**
+     * aria-label for the navigation list.
+     */
+    ariaLabel: Nullable$1<string>;
+    /**
+     * aria-roledescription for the navigation list.
+     */
+    ariaRoleDescription: Nullable$1<string>;
     /** Whether the list is for parent items. */
     parentItems: boolean;
     /** Whether the list is for child items. */
@@ -82,10 +97,16 @@ declare class NavigationListComponent implements OnChanges, AfterViewInit, OnDes
     noGrow: boolean;
     /** Whether the list should handle keyboard navigation. */
     withKeyboardNavigation: boolean;
+    /** Reference to the More button component if this list is inside a More button popover. */
+    moreButtonRef: any;
     /** Event emitted when user tries to navigate to the item before the list itself. */
     focusBefore: EventEmitter<void>;
     /** Event emitted when user tries to navigate to the item after the list itself. */
     focusAfter: EventEmitter<void>;
+    /** Computed role based on navigation state and input role. */
+    readonly computedRole: _angular_core.Signal<"menu" | "tree" | "menubar" | "group">;
+    /** Computed aria-label for group lists based on parent item's text content. */
+    readonly computedAriaLabel: _angular_core.Signal<Nullable$1<string>>;
     /** List items. */
     readonly listItems$: _angular_core.WritableSignal<Nullable$1<FdbNavigationListItem>[]>;
     /** @hidden */
@@ -94,6 +115,11 @@ declare class NavigationListComponent implements OnChanges, AfterViewInit, OnDes
     private _keyManager;
     /** @hidden */
     private readonly _navigationService;
+    /**
+     * @hidden
+     * Parent navigation component.
+     */
+    private readonly _navigation;
     /**
      * @hidden
      * Parent list item.
@@ -106,6 +132,12 @@ declare class NavigationListComponent implements OnChanges, AfterViewInit, OnDes
     /** @hidden */
     private get _activeItemIndex();
     /** @hidden */
+    private _renderer;
+    /** @hidden */
+    private _elementRef;
+    /** @hidden */
+    private _ariaLabelEffect;
+    /** @hidden */
     constructor();
     /**
      * @hidden
@@ -120,10 +152,14 @@ declare class NavigationListComponent implements OnChanges, AfterViewInit, OnDes
     ngOnChanges(changes: SimpleChanges): void;
     /** @hidden */
     ngOnDestroy(): void;
+    /**
+     * Updates aria-label attribute manually to avoid expression changed errors
+     */
+    private _updateAriaLabel;
     /** @hidden */
     private _setupKeyManager;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationListComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationListComponent, "ul[fdb-navigation-list]", never, { "_listItems": { "alias": "listItems"; "required": false; }; "role": { "alias": "role"; "required": false; }; "parentItems": { "alias": "parentItems"; "required": false; }; "childItems": { "alias": "childItems"; "required": false; }; "noGrow": { "alias": "noGrow"; "required": false; }; "withKeyboardNavigation": { "alias": "withKeyboardNavigation"; "required": false; }; }, { "focusBefore": "focusBefore"; "focusAfter": "focusAfter"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationListComponent, "ul[fdb-navigation-list]", never, { "_listItems": { "alias": "listItems"; "required": false; }; "role": { "alias": "role"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "ariaRoleDescription": { "alias": "ariaRoleDescription"; "required": false; }; "parentItems": { "alias": "parentItems"; "required": false; }; "childItems": { "alias": "childItems"; "required": false; }; "noGrow": { "alias": "noGrow"; "required": false; }; "withKeyboardNavigation": { "alias": "withKeyboardNavigation"; "required": false; }; "moreButtonRef": { "alias": "moreButtonRef"; "required": false; }; }, { "focusBefore": "focusBefore"; "focusAfter": "focusAfter"; }, never, ["*"], true, never>;
     static ngAcceptInputType_parentItems: unknown;
     static ngAcceptInputType_childItems: unknown;
     static ngAcceptInputType_noGrow: unknown;
@@ -163,6 +199,9 @@ declare class NavigationListItemComponent extends FdbNavigationListItem implemen
     /** Whether the item should be marked as selected. */
     set selected(selected: boolean);
     get selected(): boolean;
+    /** Whether the item is disabled. */
+    set disabled(disabled: boolean);
+    get disabled(): boolean;
     /** @hidden */
     listItems: QueryList<FdbNavigationListItem>;
     /** Link reference. */
@@ -173,6 +212,8 @@ declare class NavigationListItemComponent extends FdbNavigationListItem implemen
     linkRef: Nullable<NavigationLinkRefDirective>;
     /** Renderer template reference. */
     set renderer(renderer: TemplateRef<any> | undefined);
+    /** ID for the navigation list item. Default one is assigned if not provided. */
+    id: _angular_core.InputSignal<string>;
     /** Type of the list item. Whether its a standard item or a "show more" button container. */
     readonly type: 'item' | 'showMore';
     /** @hidden */
@@ -183,16 +224,47 @@ declare class NavigationListItemComponent extends FdbNavigationListItem implemen
      * Whether the list item is visible in the main navigation list container.
      */
     readonly isVisible$: _angular_core.Signal<boolean>;
+    /** Whether the item is disabled. Cached to avoid repeated signal calls. */
+    readonly _isDisabledCached$: _angular_core.Signal<boolean>;
     /**
      * Whether the item is navigatable via the keyboard.
      */
     get skipNavigation(): boolean;
     /** aria-expanded attribute value. */
     readonly expandedAttr$: _angular_core.Signal<boolean>;
+    /** Role attribute value based on navigation state. */
+    readonly roleAttr$: _angular_core.Signal<"treeitem" | "menuitem" | "menuitemradio">;
+    /** aria-checked attribute value for menuitemradio role. */
+    readonly ariaCheckedAttr$: _angular_core.Signal<any>;
+    /** aria-selected attribute value - kept in both expanded and snapped modes. */
+    readonly ariaSelectedAttr$: _angular_core.Signal<any>;
+    /** aria-level attribute value - only for treeitem role. */
+    readonly ariaLevelAttr$: _angular_core.Signal<any>;
+    /** aria-owns attribute value for items with children. */
+    readonly ariaOwnsAttr$: _angular_core.Signal<string | undefined>;
+    /** ID attribute for child lists. */
+    readonly childListIdAttr$: _angular_core.Signal<string | undefined>;
+    /** aria-label attribute value for snapped mode menuitemradio. */
+    readonly ariaLabelAttr$: _angular_core.Signal<string | undefined>;
+    /** Expander aria-label attribute value. */
+    readonly expanderAriaLabelAttr$: _angular_core.Signal<string>;
+    /** aria-haspopup attribute value for snapped mode items with children. */
+    readonly ariaHasPopupAttr$: _angular_core.Signal<"menu" | "dialog" | undefined>;
+    /** aria-current attribute value for snapped mode items with children. */
+    readonly ariaCurrentAttr$: _angular_core.Signal<"page" | undefined>;
+    /** Wrapper role attribute for snapped mode popovers. */
+    readonly wrapperRoleAttr$: _angular_core.Signal<"tree" | undefined>;
+    /** Wrapper aria-roledescription for snapped mode popovers. */
+    readonly wrapperAriaRoleDescriptionAttr$: _angular_core.Signal<string | undefined>;
+    /** Title item role for snapped mode - should be treeitem in popovers. */
+    readonly titleItemRoleAttr$: _angular_core.Signal<"treeitem" | "menuitem" | "menuitemradio">;
+    /** Title item aria-selected for snapped mode - should not be selected if children are selected. */
+    readonly titleItemAriaSelectedAttr$: _angular_core.Signal<any>;
+    readonly titleItemFocusable$: _angular_core.Signal<any>;
     /** CSS Class signal. */
     readonly class$: _angular_core.Signal<string>;
-    /** Selected Signal. */
-    readonly selected$: _angular_core.WritableSignal<boolean>;
+    /** Combined selected state - considers both manual selection and service selection. */
+    readonly selected$: any;
     /** @hidden */
     readonly quickCreate$: _angular_core.WritableSignal<boolean>;
     /**
@@ -200,12 +272,16 @@ declare class NavigationListItemComponent extends FdbNavigationListItem implemen
      * Popover position. Changes based on rtl value.
      */
     readonly _popoverPlacement$: _angular_core.Signal<Placement>;
+    /** @hidden */
+    readonly _moreButtonRef$: _angular_core.Signal<any>;
     /** Optional parent list component. */
     readonly parentListItemComponent: FdbNavigationListItemCmp | null;
     /** @hidden */
     get parentListItem(): FdbNavigationListItem | null;
     /** @hidden */
     private readonly _home$;
+    /** Manual selection state signal (for router-based selection mode). */
+    private readonly _manuallySelected$;
     /** @hidden */
     private readonly _class$;
     /** @hidden */
@@ -220,6 +296,14 @@ declare class NavigationListItemComponent extends FdbNavigationListItem implemen
     private _keyManager;
     /** @hidden */
     private readonly _zone;
+    /** @hidden */
+    private readonly _lang$;
+    /** @hidden */
+    private _translationResolver;
+    /** Translation signal for snapped popover role description. */
+    private readonly _snappedPopoverRoleDescription$;
+    /** Translation signal for expander aria-label. */
+    private readonly _expanderAriaLabel$;
     private readonly _rtlService;
     /** @hidden */
     private readonly _rtl$;
@@ -231,6 +315,8 @@ declare class NavigationListItemComponent extends FdbNavigationListItem implemen
     /** @hidden */
     private readonly _parentNavigationService;
     /** @hidden */
+    private readonly _parentNavigationList;
+    /** @hidden */
     private readonly _destroyRef;
     /** @hidden */
     constructor();
@@ -263,6 +349,10 @@ declare class NavigationListItemComponent extends FdbNavigationListItem implemen
     _innerListKeydown(event: KeyboardEvent): void;
     /** Toggles expanded state of the item. */
     toggleExpanded(): void;
+    /** Handles item click for both selection and expansion based on item type and navigation mode. */
+    handleItemClick(): void;
+    /** Handles keydown events for navigation item actions. */
+    handleItemKeydown(event: KeyboardEvent): void;
     /** Callback method when user used keyboard arrows to expand/collapse list item. */
     keyboardExpanded(shouldExpand: boolean): void;
     /**
@@ -278,8 +368,15 @@ declare class NavigationListItemComponent extends FdbNavigationListItem implemen
     focusLink(closePopover?: boolean): void;
     /** @hidden */
     _onPopoverOpen(isOpen: boolean, popover: PopoverComponent): void;
+    /**
+     * Determines if this item can be selected based on its type and structure.
+     * @returns true if the item can be selected, false otherwise
+     */
+    canItemBeSelected(): boolean;
     private _focusPopoverLink;
     /** @hidden */
+    private _ensureChildTabindexUpdated;
+    /** @hidden */
     private _visibleItemKeyboardExpandedHandler;
     /** @hidden */
     private _snappedItemKeyboardExpandedHandler;
@@ -291,7 +388,7 @@ declare class NavigationListItemComponent extends FdbNavigationListItem implemen
     /** @hidden */
     private _onZoneStable;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationListItemComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationListItemComponent, "fdb-navigation-list-item", never, { "class": { "alias": "class"; "required": false; }; "home": { "alias": "home"; "required": false; }; "quickCreate": { "alias": "quickCreate"; "required": false; }; "separator": { "alias": "separator"; "required": false; }; "spacer": { "alias": "spacer"; "required": false; }; "group": { "alias": "group"; "required": false; }; "expanded": { "alias": "expanded"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; }, {}, ["link", "linkRef", "listItems"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationListItemComponent, "fdb-navigation-list-item", never, { "class": { "alias": "class"; "required": false; }; "home": { "alias": "home"; "required": false; }; "quickCreate": { "alias": "quickCreate"; "required": false; }; "separator": { "alias": "separator"; "required": false; }; "spacer": { "alias": "spacer"; "required": false; }; "group": { "alias": "group"; "required": false; }; "expanded": { "alias": "expanded"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; }, {}, ["link", "linkRef", "listItems"], never, true, never>;
     static ngAcceptInputType_home: unknown;
     static ngAcceptInputType_quickCreate: unknown;
     static ngAcceptInputType_separator: unknown;
@@ -299,6 +396,30 @@ declare class NavigationListItemComponent extends FdbNavigationListItem implemen
     static ngAcceptInputType_group: unknown;
     static ngAcceptInputType_expanded: unknown;
     static ngAcceptInputType_selected: unknown;
+    static ngAcceptInputType_disabled: unknown;
+}
+
+declare class NavigationService {
+    /** Currently active list item. */
+    currentItem$: Subject<FdbNavigationListItem>;
+    /** Currently selected item (for click-based selection mode). */
+    selectedItem$: _angular_core.WritableSignal<FdbNavigationListItem | null>;
+    /** Subject to notify when an overflow item is selected and should be promoted. */
+    overflowItemSelected$: Subject<FdbNavigationListItem>;
+    /** Subject to notify when selection changes to clear manual selections */
+    selectionChanged$: Subject<FdbNavigationListItem | null>;
+    /**
+     * Set the selected item.
+     * @param item The item to select, or null to clear selection.
+     */
+    setSelectedItem(item: FdbNavigationListItem | null): void;
+    /**
+     * Get the currently selected item.
+     * @returns The currently selected item, or null if none is selected.
+     */
+    getSelectedItem(): FdbNavigationListItem | null;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<NavigationService>;
 }
 
 declare abstract class FdbNavigation {
@@ -307,6 +428,8 @@ declare abstract class FdbNavigation {
     abstract showMoreButton$: WritableSignal<Nullable<FdbNavigationListItem>>;
     abstract _navigationItemRenderer: Signal<any>;
     abstract closeAllPopups: Subject<void>;
+    abstract selectionMode: 'router' | 'click';
+    abstract service: NavigationService;
     abstract setActiveItem(value: FdbNavigationListItem | null): void;
     abstract getActiveItem(): FdbNavigationListItem | null;
     abstract closePopups(): void;
@@ -325,6 +448,7 @@ declare abstract class FdbNavigationListItem implements FocusableOption {
     abstract parentListItem: FdbNavigationListItem | null;
     abstract class$: Signal<string>;
     abstract selected$: Signal<boolean>;
+    abstract id: Signal<string>;
     abstract focus(origin?: FocusOrigin | undefined): void;
     abstract toggleExpanded(): void;
     abstract keyboardExpanded(shouldExpand: boolean): void;
@@ -335,6 +459,7 @@ declare abstract class FdbNavigationListItem implements FocusableOption {
     abstract unregisterChildList(list: NavigationListComponent): void;
     abstract handleHorizontalNavigation(isExpand: boolean): void;
     abstract focusLink(closePopover?: boolean): void;
+    abstract canItemBeSelected(): boolean;
     /** Marker directive that is attached to the rendered list item. */
     marker: Nullable<NavigationListItemMarkerDirective>;
     /** @hidden */
@@ -381,6 +506,8 @@ declare abstract class FdbNavigationListItem implements FocusableOption {
     readonly expanded$: _angular_core.WritableSignal<boolean>;
     /** @hidden */
     readonly isGroup$: _angular_core.WritableSignal<boolean>;
+    /** @hidden */
+    readonly disabled$: _angular_core.WritableSignal<boolean>;
     /** Navigation container reference. */
     readonly navigation: FdbNavigation;
 }
@@ -421,6 +548,14 @@ declare abstract class FdbNavigationContentContainer {
 declare class NavigationContentEndComponent extends FdbNavigationContentContainer implements AfterContentInit {
     /** Whether the list items are content-projected. Used only with data-driven navigation. */
     contentProjected: boolean;
+    /**
+     * aria-label for the navigation list.
+     */
+    ariaLabel: Nullable$1<string>;
+    /**
+     * aria-roledescription for the navigation list.
+     */
+    ariaRoleDescription: Nullable$1<string>;
     /** @hidden */
     private readonly _listItems;
     /** @hidden */
@@ -430,12 +565,20 @@ declare class NavigationContentEndComponent extends FdbNavigationContentContaine
     /** @hidden */
     ngAfterContentInit(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationContentEndComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationContentEndComponent, "fdb-navigation-content-end", never, { "contentProjected": { "alias": "contentProjected"; "required": false; }; }, {}, ["_listItems"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationContentEndComponent, "fdb-navigation-content-end", never, { "contentProjected": { "alias": "contentProjected"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "ariaRoleDescription": { "alias": "ariaRoleDescription"; "required": false; }; }, {}, ["_listItems"], never, true, never>;
 }
 
 declare class NavigationContentStartComponent extends FdbNavigationContentContainer implements AfterContentInit {
     /** Whether the list items are content-projected. Used only with data-driven navigation. */
     contentProjected: boolean;
+    /**
+     * aria-label for the navigation list.
+     */
+    ariaLabel: Nullable$1<string>;
+    /**
+     * aria-roledescription for the navigation list.
+     */
+    ariaRoleDescription: Nullable$1<string>;
     /** @hidden */
     private readonly _listItems;
     /** @hidden */
@@ -474,15 +617,17 @@ declare class NavigationContentStartComponent extends FdbNavigationContentContai
      * Determines whether to show the "More" button if available space is not enough to fit all list items.
      */
     private _calculateVisibleItems;
+    /**
+     * @hidden
+     * Promotes an overflow item to be the last visible item.
+     * Moves the current last visible item to overflow while preserving overflow order.
+     */
+    private _promoteOverflowItem;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationContentStartComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationContentStartComponent, "fdb-navigation-content-start", never, { "contentProjected": { "alias": "contentProjected"; "required": false; }; }, {}, ["_listItems"], never, true, [{ directive: typeof i1$1.ScrollbarDirective; inputs: {}; outputs: {}; }]>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationContentStartComponent, "fdb-navigation-content-start", never, { "contentProjected": { "alias": "contentProjected"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "ariaRoleDescription": { "alias": "ariaRoleDescription"; "required": false; }; }, {}, ["_listItems"], never, true, [{ directive: typeof i1$1.ScrollbarDirective; inputs: {}; outputs: {}; }]>;
 }
 
 declare class NavigationListItemDirective implements OnDestroy {
-    /**
-     * Item definition.
-     */
-    item: any;
     /**
      * Injector used for rendering child list item component.
      * Allows list item component to inject parent list container and register itself as a child item.
@@ -520,7 +665,7 @@ declare class NavigationListItemDirective implements OnDestroy {
     /** @hidden */
     ngOnDestroy(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationListItemDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NavigationListItemDirective, "[fdbNavigationListItem]", ["fdbListItem"], { "item": { "alias": "item"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NavigationListItemDirective, "[fdbNavigationListItem]", ["fdbListItem"], {}, {}, never, never, true, never>;
 }
 declare class NavigationListItemRefDirective<T = any> {
     /** Type alias. */
@@ -535,51 +680,28 @@ declare class NavigationListItemRefDirective<T = any> {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NavigationListItemRefDirective<any>, "[fdbNavigationListItemRef]", never, { "fdbNavigationListItemRefAs": { "alias": "fdbNavigationListItemRefAs"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-type NavigationDataSourceItem<T extends Record<string, any> = Record<string, any>> = {
-    placement: 'start' | 'end';
-    children?: NavigationDataSourceItem<T>[];
-} & T;
-declare class FdbNavigationDataSource<T extends NavigationDataSourceItem> extends BaseDataSource<T> {
-    dataProvider: AbstractDataProvider<T>;
-    /** @hidden */
-    limitless: boolean;
-    /** @hidden */
-    constructor(dataProvider: AbstractDataProvider<T>);
-}
-declare class ArrayNavigationDataSource<T extends NavigationDataSourceItem> extends FdbNavigationDataSource<T> {
-    /** @hidden */
-    constructor(data: T[]);
-}
-declare class ObservableNavigationDataSDataSource<T extends NavigationDataSourceItem> extends FdbNavigationDataSource<T> {
-    /** @hidden */
-    constructor(data: Observable<T[]>);
-}
-/**
- * Type of acceptable objects as a datasource for the Navigation component.
- */
-type FdbNavigationDataSAcceptableDataSource<T extends NavigationDataSourceItem> = FdbNavigationDataSource<T> | Observable<T[]> | T[];
-declare class NavigationDataSourceParser<T extends NavigationDataSourceItem> implements DataSourceParser<T, FdbNavigationDataSource<T>> {
-    /**
-     * Transforms plain array or observable into DataSource class.
-     * @param source
-     */
-    parse(source: FdbNavigationDataSAcceptableDataSource<T>): FdbNavigationDataSource<T> | undefined;
-}
-
 type FdbNavigationType = 'horizontal' | 'vertical';
 type FdbNavigationState = 'expanded' | 'snapped' | 'popup';
 
-interface GroupedDataSourceItems {
-    start: NavigationDataSourceItem[];
-    end: NavigationDataSourceItem[];
-}
 declare class NavigationComponent extends FdbNavigation implements CssClassBuilder, OnChanges, OnInit, AfterViewInit, OnDestroy {
     /** @hidden */
     class: string;
+    /**
+     * aria-label for the navigation.
+     */
+    ariaLabel: Nullable<string>;
+    /**
+     * aria-roledescription for the navigation.
+     */
+    ariaRoleDescription: Nullable<string>;
     /**
      * Navigation mode.
      */
     mode: FdbViewMode;
+    /**
+     * Whether the navigation is rendered as an overlay.
+     */
+    isOverlay: boolean;
     /**
      * Navigation state.
      */
@@ -589,6 +711,12 @@ declare class NavigationComponent extends FdbNavigation implements CssClassBuild
      * Navigation type.
      */
     type: FdbNavigationType;
+    /**
+     * Selection mode for navigation items.
+     * - 'router': Selection is handled by router link activation (default)
+     * - 'click': Selection is handled by click events
+     */
+    selectionMode: 'router' | 'click';
     /** @hidden */
     set _navigationItemRef(value: Nullable<NavigationListItemRefDirective>);
     /** @hidden */
@@ -600,7 +728,7 @@ declare class NavigationComponent extends FdbNavigation implements CssClassBuild
     /**
      * Whether the navigation is in snapped mode.
      */
-    readonly isSnapped$: Signal<boolean>;
+    readonly isSnapped$: _angular_core.Signal<boolean>;
     /**
      * Whether to show "More" button. Applicable for `snapped` state only.
      */
@@ -612,19 +740,14 @@ declare class NavigationComponent extends FdbNavigation implements CssClassBuild
     readonly classList$: _angular_core.WritableSignal<string[]>;
     /** @hidden */
     readonly elementRef: ElementRef<any>;
-    /** @hidden */
-    readonly dataSourceItems: Signal<GroupedDataSourceItems | undefined>;
+    /** Navigation service for managing selection state. */
+    readonly service: NavigationService;
     /** @hidden */
     readonly _navigationItemRenderer: _angular_core.WritableSignal<NavigationListItemRefDirective<any> | null>;
     /** Stream notifies to close all popups in child list items. */
     readonly closeAllPopups: Subject<void>;
     /** @hidden */
     private readonly _viewInitiated$;
-    /**
-     * @hidden
-     * Data source directive.
-     */
-    private readonly _dataSourceDirective;
     /** @hidden */
     private _keyManager;
     /** @hidden */
@@ -635,7 +758,7 @@ declare class NavigationComponent extends FdbNavigation implements CssClassBuild
      * @hidden
      * Main keyboard navigation handler.
      */
-    private _keyDownHandler;
+    _keyDownHandler(event: KeyboardEvent): void;
     /** @hidden */
     ngOnInit(): void;
     /** @hidden */
@@ -654,6 +777,39 @@ declare class NavigationComponent extends FdbNavigation implements CssClassBuild
     setActiveItem(item: FdbNavigationListItem): void;
     /** Notifies child list items that all popups should be closed. */
     closePopups(): void;
+    /**
+     * Get the currently selected item when in click selection mode.
+     * @returns The currently selected item, or null if none is selected.
+     */
+    getSelectedItem(): FdbNavigationListItem | null;
+    /**
+     * Set the selected item when in click selection mode.
+     * @param item The item to select, or null to clear selection.
+     */
+    setSelectedItem(item: FdbNavigationListItem | null): void;
+    /**
+     * Clear the current selection when in click selection mode.
+     */
+    clearSelection(): void;
+    /**
+     * Get a navigation item by its ID.
+     * @param id The ID of the navigation item to find.
+     * @returns The navigation item with the specified ID, or null if not found.
+     */
+    getNavigationItemById(id: string): FdbNavigationListItem | null;
+    /**
+     * Set the selected item by its ID when in click selection mode.
+     * @param id The ID of the navigation item to select.
+     * @returns True if the item was found and selected, false otherwise.
+     */
+    setSelectedItemById(id: string): boolean;
+    /**
+     * Helper method to find an item by ID recursively through the navigation tree.
+     * @param items Array of navigation items to search through.
+     * @param id The ID to search for.
+     * @returns The found item or null.
+     */
+    private _findItemById;
     /**
      * Updates the list of items.
      * Optionally inserts "More" button if overflow menu should be rendered.
@@ -661,7 +817,39 @@ declare class NavigationComponent extends FdbNavigation implements CssClassBuild
      */
     private _resetItemsList;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationComponent, "fdb-navigation", never, { "class": { "alias": "class"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "state": { "alias": "state"; "required": false; }; "type": { "alias": "type"; "required": false; }; }, {}, ["_navigationItemRef", "_navigationItems"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationComponent, "fdb-navigation", never, { "class": { "alias": "class"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "ariaRoleDescription": { "alias": "ariaRoleDescription"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "isOverlay": { "alias": "isOverlay"; "required": false; }; "state": { "alias": "state"; "required": false; }; "type": { "alias": "type"; "required": false; }; "selectionMode": { "alias": "selectionMode"; "required": false; }; }, {}, ["_navigationItemRef", "_navigationItems"], ["*"], true, never>;
+    static ngAcceptInputType_isOverlay: unknown;
+}
+
+type NavigationDataSourceItem<T extends Record<string, any> = Record<string, any>> = {
+    placement: 'start' | 'end';
+    children?: NavigationDataSourceItem<T>[];
+} & T;
+declare class FdbNavigationDataSource<T extends NavigationDataSourceItem> extends BaseDataSource<T> {
+    dataProvider: AbstractDataProvider<T>;
+    /** @hidden */
+    limitless: boolean;
+    /** @hidden */
+    constructor(dataProvider: AbstractDataProvider<T>);
+}
+declare class ArrayNavigationDataSource<T extends NavigationDataSourceItem> extends FdbNavigationDataSource<T> {
+    /** @hidden */
+    constructor(data: T[]);
+}
+declare class ObservableNavigationDataSDataSource<T extends NavigationDataSourceItem> extends FdbNavigationDataSource<T> {
+    /** @hidden */
+    constructor(data: Observable<T[]>);
+}
+/**
+ * Type of acceptable objects as a datasource for the Navigation component.
+ */
+type FdbNavigationDataSAcceptableDataSource<T extends NavigationDataSourceItem> = FdbNavigationDataSource<T> | Observable<T[]> | T[];
+declare class NavigationDataSourceParser<T extends NavigationDataSourceItem> implements DataSourceParser<T, FdbNavigationDataSource<T>> {
+    /**
+     * Transforms plain array or observable into DataSource class.
+     * @param source
+     */
+    parse(source: FdbNavigationDataSAcceptableDataSource<T>): FdbNavigationDataSource<T> | undefined;
 }
 
 declare class NavigationListDataSourceDirective<T extends Record<string, any>> extends DataSourceDirective<NavigationDataSourceItem<T>, FdbNavigationDataSource<NavigationDataSourceItem<T>>> {
@@ -678,11 +866,17 @@ declare class NavigationMoreButtonComponent {
     /** @hidden */
     private readonly _link;
     /** @hidden */
+    private readonly _popover;
+    /** @hidden */
+    private readonly _navigationList;
+    /** @hidden */
     customMoreRenderer: Nullable$1<TemplateRef<any>>;
     /** Whether the show more is visible. */
     isVisible$: _angular_core.WritableSignal<boolean>;
     /** Whether popover is open. Applicable for snapped navigation state. */
     readonly popoverOpen$: _angular_core.WritableSignal<boolean>;
+    /** ID for the more button. */
+    readonly id: _angular_core.WritableSignal<string>;
     /** @hidden */
     readonly type = "showMore";
     /** @hidden */
@@ -699,6 +893,10 @@ declare class NavigationMoreButtonComponent {
      * Link reference.
      */
     readonly link$: _angular_core.WritableSignal<Nullable$1<FdbNavigationItemLink>>;
+    /** More button aria-label attribute value. */
+    readonly moreButtonAriaLabelAttr$: _angular_core.Signal<string>;
+    /** Overflow menu aria-label attribute value. */
+    readonly overflowMenuAriaLabelAttr$: _angular_core.Signal<string>;
     /**
      * @hidden
      * Popover position. Changes based on rtl value.
@@ -709,10 +907,22 @@ declare class NavigationMoreButtonComponent {
     /** @hidden */
     private readonly _rtlService;
     /** @hidden */
+    private readonly elementRef;
+    /** @hidden */
     private readonly _rtl$;
     /** @hidden */
+    private readonly _lang$;
+    /** @hidden */
+    private _translationResolver;
+    /** Translation signal for more button aria-label. */
+    private readonly _moreButtonAriaLabel$;
+    /** Translation signal for overflow menu aria-label. */
+    private readonly _overflowMenuAriaLabel$;
+    /** @hidden */
     constructor();
     /** @hidden */
+    _onPopoverOpenChange(isOpen: boolean): void;
+    /** @hidden */
     togglePopover(withClick?: boolean): void;
     /** @hidden */
     registerLink(): void;
@@ -732,9 +942,11 @@ declare class NavigationMoreButtonComponent {
     /** @hidden */
     toggleExpanded(): void;
     /** @hidden */
-    keyboardExpanded(): void;
+    keyboardExpanded(shouldExpand: boolean): void;
     /** @hidden */
     _keydownPopoverToggle(event: KeyboardEvent): void;
+    /** @hidden */
+    canItemBeSelected(): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NavigationMoreButtonComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavigationMoreButtonComponent, "li[fdb-navigation-more-button]", never, { "listItems": { "alias": "listItems"; "required": false; }; }, {}, never, never, true, never>;
 }