@stackline/angular-multiselect-dropdown 21.0.3 → 21.1.1

package/package.json

@@ -1,10 +1,10 @@
 {
   "$schema": "../../../node_modules/ng-packagr/package.schema.json",
   "name": "@stackline/angular-multiselect-dropdown",
-  "version": "21.0.3",
+  "version": "21.1.1",
   "license": "MIT",
   "author": "Pradeep Terli (Original), Alexandro Paixao Marques (Maintainer)",
-  "description": "Angular multiselect dropdown for maintained release lines from Angular 2 through Angular 21, with search, grouping, custom templates, checkbox selection, reactive and template-driven forms support, and Material-inspired theming from Angular 14 onward.",
+  "description": "Angular multiselect dropdown for maintained release lines from Angular 2 through Angular 21, with search, grouping, custom templates, checkbox selection, reactive and template-driven forms support, Material-inspired theming, and ADA-compliant keyboard/ARIA accessibility support.",
   "keywords": [
     "angular",
     "angular-library",
@@ -35,6 +35,11 @@
     "ngmodel",
     "formcontrolname",
     "forms",
+    "accessibility",
+    "a11y",
+    "aria",
+    "keyboard-navigation",
+    "ada-compliant",
     "ui-component",
     "material-inspired",
     "material-like",

package/types/stackline-angular-multiselect-dropdown.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { PipeTransform, TemplateRef, OnInit, OnDestroy, ViewContainerRef, EmbeddedViewRef, ElementRef, EventEmitter, OnChanges, Renderer2, NgZone, ChangeDetectorRef, AfterViewChecked, SimpleChanges } from '@angular/core';
+import { PipeTransform, TemplateRef, OnInit, OnDestroy, ViewContainerRef, EmbeddedViewRef, OnChanges, ElementRef, Renderer2, NgZone, ChangeDetectorRef, EventEmitter, AfterViewChecked, SimpleChanges } from '@angular/core';
 import * as i5 from '@angular/forms';
 import { ControlValueAccessor, Validator, UntypedFormControl } from '@angular/forms';
 import { Observable, Subject, Subscription } from 'rxjs';
@@ -29,6 +29,7 @@ interface DropdownSettings {
     lazyLoading?: boolean;
     labelKey?: string;
     primaryKey?: string;
+    /** @deprecated Use `skin` instead. Kept as a compatibility alias. */
     theme?: string;
     skin?: string;
     position?: string;
@@ -40,6 +41,16 @@ interface DropdownSettings {
     autoPosition?: boolean;
     clearAll?: boolean;
     tagToBody?: boolean;
+    ariaLabel?: string;
+    ariaLabelledBy?: string;
+    listboxAriaLabel?: string;
+    searchAriaLabel?: string;
+    clearSearchAriaLabel?: string;
+    clearAllAriaLabel?: string;
+    removeItemAriaLabel?: string;
+    openDropdownAriaLabel?: string;
+    closeDropdownAriaLabel?: string;
+    loadingText?: string;
 }
 
 declare class DataService {
@@ -97,41 +108,6 @@ declare class CIcon {
     static ɵcmp: i0.ɵɵComponentDeclaration<CIcon, "c-icon", never, { "name": { "alias": "name"; "required": false; }; }, {}, never, never, false, never>;
 }
 
-declare class ClickOutsideDirective {
-    private _elementRef;
-    constructor(_elementRef: ElementRef);
-    clickOutside: EventEmitter<Event>;
-    onClick(event: Event, targetElement: EventTarget | null): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ClickOutsideDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<ClickOutsideDirective, "[clickOutside]", never, {}, { "clickOutside": "clickOutside"; }, never, never, false, never>;
-}
-declare class ScrollDirective {
-    private _elementRef;
-    constructor(_elementRef: ElementRef);
-    scroll: EventEmitter<Event>;
-    onClick(event: Event): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ScrollDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<ScrollDirective, "[scroll]", never, {}, { "scroll": "scroll"; }, never, never, false, never>;
-}
-declare class styleDirective {
-    private el;
-    constructor(el: ElementRef);
-    styleVal: number;
-    ngOnInit(): void;
-    ngOnChanges(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<styleDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<styleDirective, "[styleProp]", never, { "styleVal": { "alias": "styleProp"; "required": false; }; }, {}, never, never, false, never>;
-}
-declare class setPosition implements OnInit, OnChanges {
-    el: ElementRef;
-    height: number;
-    constructor(el: ElementRef);
-    ngOnInit(): void;
-    ngOnChanges(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<setPosition, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<setPosition, "[setPosition]", never, { "height": { "alias": "setPosition"; "required": false; }; }, {}, never, never, false, never>;
-}
-
 interface VirtualScrollerDefaultOptions {
     scrollThrottlingTime: number;
     scrollDebounceTime: number;
@@ -311,6 +287,41 @@ declare class VirtualScrollerModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<VirtualScrollerModule>;
 }
 
+declare class ClickOutsideDirective {
+    private _elementRef;
+    constructor(_elementRef: ElementRef);
+    clickOutside: EventEmitter<Event>;
+    onClick(event: Event, targetElement: EventTarget | null): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClickOutsideDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<ClickOutsideDirective, "[clickOutside]", never, {}, { "clickOutside": "clickOutside"; }, never, never, false, never>;
+}
+declare class ScrollDirective {
+    private _elementRef;
+    constructor(_elementRef: ElementRef);
+    scroll: EventEmitter<Event>;
+    onClick(event: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ScrollDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<ScrollDirective, "[scroll]", never, {}, { "scroll": "scroll"; }, never, never, false, never>;
+}
+declare class styleDirective {
+    private el;
+    constructor(el: ElementRef);
+    styleVal: number;
+    ngOnInit(): void;
+    ngOnChanges(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<styleDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<styleDirective, "[styleProp]", never, { "styleVal": { "alias": "styleProp"; "required": false; }; }, {}, never, never, false, never>;
+}
+declare class setPosition implements OnInit, OnChanges {
+    el: ElementRef;
+    height: number;
+    constructor(el: ElementRef);
+    ngOnInit(): void;
+    ngOnChanges(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<setPosition, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<setPosition, "[setPosition]", never, { "height": { "alias": "setPosition"; "required": false; }; }, {}, never, never, false, never>;
+}
+
 declare class AngularMultiSelect implements OnInit, ControlValueAccessor, OnChanges, Validator, AfterViewChecked, OnDestroy {
     _elementRef: ElementRef;
     private cdr;
@@ -337,6 +348,7 @@ declare class AngularMultiSelect implements OnInit, ControlValueAccessor, OnChan
     selectedListElem: ElementRef;
     dropdownListElem: ElementRef;
     stacklineDropdown: ElementRef;
+    triggerButton: ElementRef;
     onEscapeDown(event: Event): void;
     onScroll(event: any): void;
     virtualdata: any;
@@ -369,11 +381,13 @@ declare class AngularMultiSelect implements OnInit, ControlValueAccessor, OnChan
     item: any;
     dropdownListYOffset: number;
     subscription: Subscription;
-    dropDownWidth: number;
+    dropDownWidth: number | null;
     dropDownTop: string | null;
     dropDownBottom: string | null;
-    dropDownLeft: number;
+    dropDownLeft: number | null;
     id: any;
+    listboxId: string;
+    activeDescendantId: string | null;
     defaultSettings: DropdownSettings;
     randomSize: boolean;
     parseError: boolean;
@@ -383,8 +397,43 @@ declare class AngularMultiSelect implements OnInit, ControlValueAccessor, OnChan
     isDisabledItemPresent: boolean;
     constructor(_elementRef: ElementRef, cdr: ChangeDetectorRef, filterPipe: ListFilterPipe);
     ngOnInit(): void;
-    getThemeName(): string;
+    getSkinName(): string;
     getDropdownClasses(): string;
+    getAriaLabel(): string;
+    getListboxAriaLabel(): string;
+    getSearchAriaLabel(): string;
+    getClearSearchAriaLabel(): string;
+    getClearAllAriaLabel(): string;
+    getOpenDropdownAriaLabel(): string;
+    getCloseDropdownAriaLabel(): string;
+    getItemLabel(item: any): string;
+    getRemoveItemAriaLabel(item: any): string;
+    getOptionId(item: any, index: number, prefix?: string): string;
+    isOptionDisabled(item: any): boolean;
+    setActiveDescendant(item: any, index: number, prefix?: string): void;
+    getVisibleBadgeLimit(): number;
+    shouldShowSelectedBadge(index: number): boolean;
+    getHiddenSelectedCount(): number;
+    getVirtualItemIndex(item: any, fallbackIndex: number, scroller?: VirtualScrollerComponent): number;
+    private isTriggerChildAction;
+    onTriggerKeydown(evt: KeyboardEvent): void;
+    onOptionKeydown(item: any, index: number, evt: KeyboardEvent, prefix?: string, scroller?: VirtualScrollerComponent): void;
+    onGroupKeydown(item: any, index: number, evt: KeyboardEvent, prefix?: string): void;
+    onInlineActionKeydown(evt: KeyboardEvent): void;
+    onArrowButtonKeydown(evt: KeyboardEvent): void;
+    onSearchKeydown(evt: KeyboardEvent): void;
+    onSelectAllKeydown(evt: KeyboardEvent, action: 'filter' | 'infinite-filter'): void;
+    focusTrigger(): void;
+    private getOptionElements;
+    private focusOptionByIndex;
+    focusFirstOption(): void;
+    focusLastOption(): void;
+    focusNextOption(): void;
+    focusPreviousOption(): void;
+    private focusVirtualOptionByDirection;
+    private getNextFocusableVirtualIndex;
+    private scheduleFocusVirtualOptionByIndex;
+    private focusVirtualOptionByIndex;
     onKeyUp(evt: any): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngDoCheck(): void;