@bootkit/ng0 0.0.0-alpha.21 → 0.0.0-alpha.23

package/common/index.d.ts

@@ -79,13 +79,16 @@ declare function toObservable<T>(value: T | Observable<T> | Promise<T>): Observa
  * @returns An array of numbers within the specified range.
  */
 declare function numberArray(start: number, end: number): number[];
+/**
+ * Deletes multiple entries from an array based on the provided indices.
+ * @param array
+ * @param indices
+ * @private
+ */
+declare function deleteEntries(array: any[], indices: number[]): void;
 
 declare function getEnumValues(enumClass: Record<string, string | number>): Array<string | number>;
 
-declare abstract class _IdGenerator {
-    private static _idCounter;
-    static next(): number;
-}
 /**
  * Type definition for an ID generator function.
  */
@@ -108,7 +111,7 @@ type CssClass = string | string[] | Set<string> | {
  * @param item The item to get the CSS class for.
  * @returns The CSS class for the item.
  */
-type CssClassGetter = (item: any) => CssClass;
+type CssClassGetter = (obj: any) => CssClass;
 /**
  * A type that represents a CSS class or a function that returns a CSS class.
  */
@@ -120,5 +123,120 @@ type CssClassLike = CssClass | CssClassGetter | null | undefined;
  */
 declare function CssClassAttribute(v: CssClassLike): CssClassGetter;
 
-export { CssClassAttribute, RTL, _IdGenerator, flipPlacement, formatString, getEnumValues, numberArray, sequentialIdGenerator, toObservable };
-export type { Alignment, ClaimLike, ClaimObject, CssClass, CssClassGetter, CssClassLike, IdGenerator, MenuItem, Placement, SelectOption };
+/**
+ * Equality comparer function type.
+ * @param a First value to compare.
+ * @param b Second value to compare.
+ * @returns true if a is considered equal to b else returns false
+ */
+type EqualityComparer = (a: any, b: any) => boolean;
+/**
+ * Equality comparer like type.
+ * can be a function or a string representing the property name to compare.
+ */
+type EqualityComparerLike = EqualityComparer | string;
+/**
+ * Default equality comparer function.
+ * @param a First value to compare.
+ * @param b Second value to compare.
+ * @returns true if a === b else returns false
+ */
+declare function defaultEqualityComparer(a: any, b: any): boolean;
+/**
+ * Converts an EqualityComparerLike to an EqualityComparer function.
+ * @param e The EqualityComparerLike to convert.
+ * @returns The converted EqualityComparer.
+ */
+declare function equalityComparerAttribute(e: EqualityComparerLike): EqualityComparer;
+/**
+ * @private
+ * @param items
+ * @param value
+ * @param comparer
+ */
+declare function findValueByComparer(items: any[], value: any, comparer: EqualityComparer): any;
+/**
+ * @private
+ * @param items
+ * @param values
+ * @param comparer
+ */
+declare function findValuesByComparer(items: any[], values: any[], comparer: EqualityComparer): any[];
+
+/**
+ * Value writer function type.
+ * @param a The input value
+ * @returns The written value
+ */
+type ValueWriter = (a: any) => any;
+/**
+ * Value writer can be a function or a string representing the property name to extract the value from.
+ */
+type ValueWriterLike = ValueWriter | string;
+/**
+ * Default value writer function.
+ * @param a The input value
+ * @returns the input value (it does not transform it)
+ */
+declare function defaultValueWriter(a: any): any;
+/**
+ * Converts a ValueWriterLike to a ValueWriterFunction.
+ * @param v The value writer to convert.
+ * @returns A ValueWriter function.
+ */
+declare function valueWriterAttribute(v: ValueWriterLike): ValueWriter;
+
+/**
+ * A comparison function type that defines an ordering relation between two values.
+ * @param a The first value to compare.
+ * @param b The second value to compare.
+ * @returns
+ * - A negative number if `a` should come before `b`
+ * - A positive number if `a` should come after `b`
+ * - Zero if `a` and `b` are considered equal
+ */
+type Comparer = (a: any, b: any) => number;
+/**
+ * Value comparer can be a function or a string representing the property name to compare.
+ */
+type ComparerLike = Comparer | string;
+/**
+ * A simple comparer function.
+ * @param a The first value to compare.
+ * @param b The second value to compare.
+ * @returns -1 if a < b, 1 if a > b, 0 if a === b
+ */
+declare function defaultComparer(a: any, b: any): number;
+/**
+ * Converts a ComparerLike to a Comparer.
+ * @param v The comparer to convert.
+ * @returns A function that compares two values.
+ */
+declare function comparerAttribute(v: ComparerLike): Comparer;
+
+/**
+ * Filter predicate function type.
+ * @param item The item to test against the filter.
+ * @returns True if the item matches the filter, false otherwise.
+ */
+type FilterPredicate = (item: any) => boolean;
+/**
+ * Filter predicate can be a function or a string representing the property name to filter.
+ */
+type FilterPredicateLike = FilterPredicate | string;
+/**
+ *
+ * @param item
+ * @returns
+ */
+declare const noopFilter: FilterPredicate;
+/**
+ * Converts a FilterPredicateLike to a FilterPredicate function.
+ * If the input is a string, it creates a predicate that checks the property with that name.
+ * @param v The FilterPredicateLike to convert.
+ * @returns The corresponding FilterPredicate function.
+ */
+declare function filterPredicateAttribute(v: FilterPredicateLike): FilterPredicate;
+
+export { CssClassAttribute, RTL, comparerAttribute, defaultComparer, defaultEqualityComparer, defaultValueWriter, deleteEntries, equalityComparerAttribute, filterPredicateAttribute, findValueByComparer, findValuesByComparer, flipPlacement, formatString, getEnumValues, noopFilter, numberArray, sequentialIdGenerator, toObservable, valueWriterAttribute };
+export type { Alignment, ClaimLike, ClaimObject, Comparer, ComparerLike, CssClass, CssClassGetter, CssClassLike, EqualityComparer, EqualityComparerLike, FilterPredicate, FilterPredicateLike, IdGenerator, MenuItem, Placement, SelectOption, ValueWriter, ValueWriterLike };

package/components/dropdown/index.d.ts

@@ -1,7 +1,11 @@
 import * as i0 from '@angular/core';
-import { QueryList, ElementRef } from '@angular/core';
-import { Placement } from '@bootkit/ng0/common';
-import { ScrollStrategy } from '@angular/cdk/overlay';
+import { ElementRef } from '@angular/core';
+import { Placement, CssClass } from '@bootkit/ng0/common';
+
+declare class DropdownDividerComponent {
+    static ɵfac: i0.ɵɵFactoryDeclaration<DropdownDividerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownDividerComponent, "ng0-dropdown-divider", ["ng0DropdownDivider"], {}, {}, never, never, true, never>;
+}
 
 /**
  * Defines the possible values for the dropdown auto-close behavior.
@@ -17,62 +21,120 @@ type DropdownAutoCloseBehavior = 'default' | 'inside' | 'outside' | 'manual';
  */
 type DropdownSize = 'default' | 'small' | 'large';
 
-declare class DropdownItemComponent {
-    constructor();
-    static ɵfac: i0.ɵɵFactoryDeclaration<DropdownItemComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownItemComponent, "ng0-dropdown-item", ["ng0DropdownItem"], {}, {}, never, ["*"], true, never>;
-}
-
 declare class DropdownComponent {
-    protected _items: QueryList<DropdownItemComponent>;
-    protected _scrollStrategy: ScrollStrategy;
+    private _dropdownMenu;
+    private _mainButton;
+    private _splitButton?;
     protected _el: ElementRef<any>;
     private _renderer;
-    private _overlay;
     /**
      * The placement of the dropdown menu in relation to the dropdown toggle.
      */
     placement: i0.InputSignal<Placement>;
+    /**
+     * The CSS classes to apply to the dropdown toggle button.
+     * @default 'btn btn-primary'
+     */
+    cssClass: i0.InputSignal<CssClass>;
+    /**
+     * The CSS classes to apply to the dropdown split button.
+     * @default 'btn btn-primary'
+     */
+    splitCssClass: i0.InputSignal<CssClass>;
     /**
      * Indicates whether the dropdown is open or closed.
+     * @default false
      */
     readonly open: i0.ModelSignal<boolean>;
     /**
-     *
+     * Indicates whether the dropdown is a split button.
+     * A split button dropdown has a separate toggle button.
+     * @default false
+     */
+    readonly split: i0.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Indicates whether the dropdown has an automatic close behavior.
+     * @default 'default'
      */
     readonly autoClose: i0.InputSignal<DropdownAutoCloseBehavior>;
+    /**
+     * Dropdown size
+     * @default 'default'
+     */
+    readonly size: i0.InputSignal<DropdownSize>;
+    protected _directionCssClass: i0.Signal<"dropup" | "dropstart" | "dropend" | undefined>;
     constructor();
-    protected _onOverlayAttach(): void;
-    protected _onOverlayDetach(): void;
+    /**
+     * Toggle the dropdown open or closed.
+     */
+    toggle(): void;
+    private _onDocumentClick;
     static ɵfac: i0.ɵɵFactoryDeclaration<DropdownComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownComponent, "ng0-dropdown", ["ng0Dropdown"], { "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "autoClose": { "alias": "autoClose"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, ["_items"], ["*", "ng0-dropdown-menu"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownComponent, "ng0-dropdown", ["ng0Dropdown"], { "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "cssClass": { "alias": "cssClass"; "required": false; "isSignal": true; }; "splitCssClass": { "alias": "splitCssClass"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "split": { "alias": "split"; "required": false; "isSignal": true; }; "autoClose": { "alias": "autoClose"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, ["_dropdownMenu"], ["*", "ng0-dropdown-menu"], true, never>;
 }
 
 declare class DropdownMenuComponent {
-    private _el;
     private _renderer;
     private _dropdown;
+    elementRef: ElementRef<any>;
     constructor();
-    private _onClick;
     static ɵfac: i0.ɵɵFactoryDeclaration<DropdownMenuComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DropdownMenuComponent, "ng0-dropdown-menu", ["ng0Dropdownmenu"], {}, {}, never, ["*"], true, never>;
 }
 
+/**
+ * An item within a dropdown menu.
+ */
+declare class DropdownItemComponent {
+    /**
+     * The CSS classes to apply to the dropdown item.
+     * */
+    readonly cssClass: i0.InputSignal<CssClass>;
+    /**
+     * Whether the dropdown item is disabled.
+     */
+    readonly disabled: i0.InputSignalWithTransform<boolean, unknown>;
+    private _onClick;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DropdownItemComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownItemComponent, "ng0-dropdown-item", ["ng0DropdownItem"], { "cssClass": { "alias": "cssClass"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * A link item within a dropdown menu.
+ * This component is used to create a navigable link inside a dropdown.
+ */
+declare class DropdownLinkComponent {
+    /**
+     * The link or URL to navigate to when the dropdown item is clicked.
+     */
+    readonly link: i0.InputSignal<string | string[] | undefined>;
+    /**
+     * The router link active class to apply when the link is active.
+     */
+    readonly active: i0.InputSignal<string | string[]>;
+    /**
+     * Specifies where to open the linked document.
+     */
+    readonly target: i0.InputSignal<"_self" | "_blank" | "_parent" | "_top" | undefined>;
+    /**
+     * Whether the dropdown link is disabled.
+     */
+    readonly disabled: i0.InputSignalWithTransform<boolean, unknown>;
+    private _onClick;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DropdownLinkComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownLinkComponent, "ng0-dropdown-link", ["ng0DropdownLink"], { "link": { "alias": "link"; "required": true; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
 declare class DropdownHeaderComponent {
     static ɵfac: i0.ɵɵFactoryDeclaration<DropdownHeaderComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DropdownHeaderComponent, "ng0-dropdown-header", ["ng0DropdownItem"], {}, {}, never, ["*"], true, never>;
 }
 
-declare class DropdownDividerComponent {
-    static ɵfac: i0.ɵɵFactoryDeclaration<DropdownDividerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownDividerComponent, "ng0-dropdown-divider", ["ng0DropdownDivider"], {}, {}, never, never, true, never>;
-}
-
 declare class DropdownModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DropdownModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<DropdownModule, never, [typeof DropdownComponent, typeof DropdownMenuComponent, typeof DropdownItemComponent, typeof DropdownHeaderComponent, typeof DropdownDividerComponent], [typeof DropdownComponent, typeof DropdownMenuComponent, typeof DropdownItemComponent, typeof DropdownHeaderComponent, typeof DropdownDividerComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<DropdownModule, never, [typeof DropdownComponent, typeof DropdownMenuComponent, typeof DropdownItemComponent, typeof DropdownLinkComponent, typeof DropdownHeaderComponent, typeof DropdownDividerComponent], [typeof DropdownComponent, typeof DropdownMenuComponent, typeof DropdownItemComponent, typeof DropdownLinkComponent, typeof DropdownHeaderComponent, typeof DropdownDividerComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<DropdownModule>;
 }
 
-export { DropdownComponent, DropdownDividerComponent, DropdownHeaderComponent, DropdownItemComponent, DropdownMenuComponent, DropdownModule };
+export { DropdownComponent, DropdownDividerComponent, DropdownHeaderComponent, DropdownItemComponent, DropdownLinkComponent, DropdownMenuComponent, DropdownModule };
 export type { DropdownAutoCloseBehavior, DropdownSize };

package/components/list/index.d.ts

@@ -1,37 +1,33 @@
-import * as _bootkit_ng0_common from '@bootkit/ng0/common';
-import { CssClassLike, IdGenerator } from '@bootkit/ng0/common';
 import * as _bootkit_ng0_localization from '@bootkit/ng0/localization';
-import * as _bootkit_ng0_data from '@bootkit/ng0/data';
-import { DataSource, DataSourceLike, FilterPredicate } from '@bootkit/ng0/data';
+import * as _bootkit_ng0_common from '@bootkit/ng0/common';
+import { FilterPredicate, IdGenerator } from '@bootkit/ng0/common';
 import * as _angular_core from '@angular/core';
-import { OnInit, ElementRef, TemplateRef, Renderer2, DestroyRef } from '@angular/core';
+import { TemplateRef, ElementRef, EventEmitter } from '@angular/core';
+import { DataSource, DataSourceLike } from '@bootkit/ng0/data';
 import { ControlValueAccessor } from '@angular/forms';
 
-interface ListItem {
-    id: string;
-    value: any;
-    selected?: boolean;
-    disabled?: boolean;
-    filtered?: boolean;
-}
-
 /**
  * Select component that allows users to choose an option from a dropdown list.
  */
-declare class ListComponent implements OnInit, ControlValueAccessor {
-    protected _el: ElementRef<HTMLDivElement>;
-    private _renderer;
-    private _destroyRef;
+declare class ListComponent implements ControlValueAccessor {
     private _document;
     private _ls;
+    private _renderer;
+    private _destroyRef;
     private _changeDetector;
-    protected _value: _angular_core.WritableSignal<any>;
-    private _onChangeCallback;
-    private _onTouchedCallback;
+    private _value;
+    private _changeCallback?;
+    private _touchCallback?;
+    private _selectedIndices;
     protected readonly _items: _angular_core.WritableSignal<ListItem[]>;
     protected readonly _isDisabled: _angular_core.WritableSignal<boolean>;
     protected readonly _activeOptionIndex: _angular_core.WritableSignal<number>;
     protected _itemTemplate?: TemplateRef<any>;
+    private _ariaActiveDescendant;
+    /**
+     * Reference to the host element
+     */
+    elementRef: ElementRef<HTMLElement>;
     /**
      * The data source for the select component.
      * This can be an array of data, a function that returns an observable of data,
@@ -46,50 +42,108 @@ declare class ListComponent implements OnInit, ControlValueAccessor {
      * Indicates whether to show selection indicator (checkbox/radio) next to each item.
      * Default is false.
      */
-    readonly showIndicator: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly showSelectionIndicator: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
     * A custom comparer function or the name of a field for comparing two objects.
     */
-    readonly compareBy: _angular_core.InputSignalWithTransform<_bootkit_ng0_data.BooleanValueComparer, _bootkit_ng0_data.BooleanValueComparerLike>;
+    readonly compareBy: _angular_core.InputSignalWithTransform<_bootkit_ng0_common.EqualityComparer, _bootkit_ng0_common.EqualityComparerLike>;
     /**
      * Custom format function to convert an item to a string for display.
      * Default converts the item to a string using its toString method.
      */
-    readonly formatBy: _angular_core.InputSignalWithTransform<_bootkit_ng0_localization.ValueFormatterFunction, _bootkit_ng0_localization.ValueFormatterLike>;
+    readonly formatBy: _angular_core.InputSignalWithTransform<_bootkit_ng0_localization.ObjectFormatter, _bootkit_ng0_localization.ObjectFormatterLike>;
     /**
      * Custom value extractor function to extract the value of any object while writing values.
      */
-    readonly writeBy: _angular_core.InputSignalWithTransform<_bootkit_ng0_data.ValueExtractor, _bootkit_ng0_data.ValueExtractorLike>;
+    readonly writeBy: _angular_core.InputSignalWithTransform<_bootkit_ng0_common.ValueWriter, _bootkit_ng0_common.ValueWriterLike>;
     /**
      * A custom filter predicate function to filter items based on a search string.
      * Default checks if the item's string representation contains the filter string (case-insensitive).
      * The filter predicate can be a function or a string representing the property name to filter.
      */
-    readonly filterBy: _angular_core.InputSignalWithTransform<FilterPredicate, _bootkit_ng0_data.FilterPredicateLike>;
+    readonly filterBy: _angular_core.InputSignalWithTransform<FilterPredicate, _bootkit_ng0_common.FilterPredicateLike>;
     /**
      * CSS class or classes to apply to the list container.
      * Default is undefined.
      */
-    readonly itemClass: _angular_core.InputSignalWithTransform<_bootkit_ng0_common.CssClassGetter, CssClassLike>;
+    readonly itemClass: _angular_core.InputSignalWithTransform<_bootkit_ng0_common.CssClassGetter, _bootkit_ng0_common.CssClassLike>;
+    /**
+     * Defines the focus behavior of the list component.
+     * - 'none': No keyboard interaction is possible. The list cannot be focused.
+     * - 'roving': Roving tabindex is enabled. The list can be focused and the active item is tabbable.
+     * - 'activeDescendant': The list can be focused, but no item is tabbable. The active item is indicated using aria-activedescendant.
+     * @default 'activeDescendant'.
+     */
     readonly focus: _angular_core.InputSignal<"none" | "roving" | "activeDescendant">;
-    readonly idGenerator: _angular_core.InputSignal<IdGenerator | undefined>;
-    constructor(_el: ElementRef<HTMLDivElement>, _renderer: Renderer2, _destroyRef: DestroyRef);
-    ngOnInit(): void;
+    /**
+     * Custom id generator function to generate unique ids for each item.
+     * Default generates sequential ids with the prefix 'ng0-list-item-'.
+     * If set to undefined, no ids will be generated.
+     * @default sequentialIdGenerator('ng0-list-item-')
+     */
+    readonly idGenerator: _angular_core.InputSignal<IdGenerator>;
+    /**
+     * Event emitted when the selection state of an item changes by user interaction.
+     */
+    readonly selectionChange: EventEmitter<ListSelectionChangeEvent>;
+    constructor();
+    /**
+     * Gets the items of the list component.
+     * @returns A readonly array of the items in the list.
+     */
+    items(): ReadonlyArray<ListItem>;
     /**
      * Sets an option as active
+     * @param index The index of the option to set as active.
+     * @param scrollIntoView Whether to scroll the active option into view. Default is true.
+     * @returns void
      */
-    active(index: number): void;
+    active(index: number, scrollIntoView?: boolean): void;
     /**
-     * Filters the list items based on the provided criteria.
-     * @param params The filter parameters to apply.
+     * Selects an option by index
+     * @param index The index of the option to select.
      * @returns void
      */
-    filter(...params: any[]): void;
+    select(index: number): void;
     /**
-     * Clears any applied filters and shows all items in the list.
+     * Deselects an option by index
+     * @param index The index of the option to deselect.
      * @returns void
      */
-    clearFilter(): void;
+    deselect(index: number): void;
+    /**
+     * Toggles the selection state of an option by index
+     * @param index The index of the option to toggle.
+     * @returns void
+     */
+    toggle(index: number): void;
+    /**
+     * Checks if an option is selected.
+     * @param index The index of the option to check.
+     * @returns True if the option is selected, false otherwise.
+     */
+    isSelected(index: number): boolean;
+    /**
+     * Checks if an option is active.
+     * @param index The index of the option to check.
+     * @returns True if the option is active, false otherwise.
+     */
+    isActive(index: number): boolean;
+    /**
+     * Sets the value of the list component.
+     * @param value The value to set. Can be a single value or an array of values in multiple selection mode.
+     */
+    set(value: any): void;
+    /**
+     * Gets the currently selected indices.
+     * @returns An array of the currently selected indices.
+     * @description
+     * - In single selection mode, the array will contain at most one item.
+     * - In multiple selection mode, the array can contain multiple items.
+     * - Changing the selection should be done using select(), deselect(), or toggle() methods to ensure proper event emission and state management.
+     * - Direct manipulation of the returned array will not affect the component's state.
+     */
+    selectedIndices(): ReadonlyArray<number>;
     /**
      * Scrolls the item at the specified index into view within the dropdown list.
      * @param index The index of the item to scroll into view.
@@ -98,21 +152,59 @@ declare class ListComponent implements OnInit, ControlValueAccessor {
      *                 Default is 'nearest'.
      * @param behavior The scrolling behavior.
      */
-    scrollItemIntoView(index: number, position?: ScrollLogicalPosition, behavior?: ScrollBehavior): void;
-    /**
-     * Toggles the selection of an option by index
-     */
-    toggleSelection(index: number): void;
-    writeValue(v: any): void;
+    scrollIntoView(index: number, position?: ScrollLogicalPosition, behavior?: ScrollBehavior): void;
+    writeValue(value: any): void;
+    private _setValue;
     registerOnChange(fn: any): void;
     registerOnTouched(fn: any): void;
     setDisabledState?(isDisabled: boolean): void;
-    protected _onKeydown(e: KeyboardEvent, firedByFilter?: boolean): void;
+    protected _getItemTabIndex(index: number): -1 | 0 | undefined;
+    protected _handleUserSelection(index: number, item: ListItem): void;
     private _loadItems;
-    private _listenToDataSourceChanges;
-    private _insertItems;
+    private _createItems;
+    private _onHostClick;
+    private _onKeydown;
+    private _verifyIndexRange;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListComponent, "ng0-list", ["ng0List"], { "source": { "alias": "source"; "required": true; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showIndicator": { "alias": "showIndicator"; "required": false; "isSignal": true; }; "compareBy": { "alias": "compareBy"; "required": false; "isSignal": true; }; "formatBy": { "alias": "formatBy"; "required": false; "isSignal": true; }; "writeBy": { "alias": "writeBy"; "required": false; "isSignal": true; }; "filterBy": { "alias": "filterBy"; "required": false; "isSignal": true; }; "itemClass": { "alias": "itemClass"; "required": false; "isSignal": true; }; "focus": { "alias": "focus"; "required": false; "isSignal": true; }; "idGenerator": { "alias": "idGenerator"; "required": false; "isSignal": true; }; }, {}, ["_itemTemplate"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListComponent, "ng0-list", ["ng0List"], { "source": { "alias": "source"; "required": true; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showSelectionIndicator": { "alias": "showSelectionIndicator"; "required": false; "isSignal": true; }; "compareBy": { "alias": "compareBy"; "required": false; "isSignal": true; }; "formatBy": { "alias": "formatBy"; "required": false; "isSignal": true; }; "writeBy": { "alias": "writeBy"; "required": false; "isSignal": true; }; "filterBy": { "alias": "filterBy"; "required": false; "isSignal": true; }; "itemClass": { "alias": "itemClass"; "required": false; "isSignal": true; }; "focus": { "alias": "focus"; "required": false; "isSignal": true; }; "idGenerator": { "alias": "idGenerator"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; }, ["_itemTemplate"], never, true, never>;
+}
+/**
+ * Represents an item in the list.
+ */
+interface ListItem {
+    /**
+     * Id of the item (if idGenerator is provided, otherwise undefined).
+     */
+    id: string;
+    /**
+     * Value of the item.
+     */
+    value: any;
+}
+/**
+ * Event emitted when the selection state of the list changes by user interaction.
+ */
+interface ListSelectionChangeEvent {
+    /**
+     * Index of the item that was selected or deselected.
+     */
+    readonly index: number;
+    /**
+     * The value of the item that was selected or deselected.
+     */
+    readonly value: any;
+    /**
+     * Indicates whether the item was selected (true) or deselected (false).
+     */
+    readonly selected: boolean;
+    /**
+     * The indices of all currently selected items.
+     */
+    readonly selectedIndices: ReadonlyArray<number>;
+    /**
+     * The list component that emitted the event.
+     */
+    readonly list: ListComponent;
 }
 
 /**
@@ -125,3 +217,4 @@ declare class ListModule {
 }
 
 export { ListComponent, ListModule };
+export type { ListItem, ListSelectionChangeEvent };