@siemens/element-ng 47.8.0 → 48.0.0-next.1

package/select/index.d.ts

@@ -1,18 +1,609 @@
+import * as _angular_core from '@angular/core';
+import { Signal, OnChanges, AfterContentInit, TemplateRef, SimpleChanges, OnDestroy, InputSignal, OnInit, ElementRef } from '@angular/core';
+import { SiFormItemControl } from '@siemens/element-ng/form';
+import { TranslatableString } from '@siemens/element-translate-ng/translate';
+import { ControlValueAccessor } from '@angular/forms';
+import { Observable } from 'rxjs';
+import * as _siemens_element_ng_select from '@siemens/element-ng/select';
+import { ConfigurableFocusTrapFactory, ConfigurableFocusTrap } from '@angular/cdk/a11y';
+
+/**
+ * Selection strategy base class.
+ */
+declare abstract class SiSelectSelectionStrategy<T, IV = T | T[]> implements ControlValueAccessor {
+    /**
+     * Whether the select input is disabled.
+     *
+     * @defaultValue false
+     */
+    readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * The selected value(s).
+     */
+    set value(value: IV | undefined);
+    /** Emitted when the selection is changed */
+    readonly valueChange: _angular_core.OutputEmitterRef<IV>;
+    /**
+     * Whether the select control allows to select multiple values.
+     * @internal
+     */
+    abstract readonly allowMultiple: boolean;
+    /**
+     * Provides the internal value always as an array
+     * @internal
+     */
+    readonly arrayValue: Signal<readonly T[]>;
+    /**
+     * Registered form callback which shall be called on blur.
+     * @internal
+     */
+    onTouched: () => void;
+    /** @internal */
+    readonly disabled: Signal<boolean>;
+    protected onChange: (_: any) => void;
+    private readonly disabledNgControl;
+    private readonly selectOptions;
+    registerOnTouched(fn: any): void;
+    registerOnChange(fn: any): void;
+    /**
+     * CDK Listbox value changed handler.
+     * @internal
+     */
+    updateFromUser(values: T[]): void;
+    setDisabledState(isDisabled: boolean): void;
+    writeValue(obj: any): void;
+    protected abstract toArrayValue(value: IV | undefined): readonly T[];
+    protected abstract fromArrayValue(value: readonly T[]): IV;
+    private updateFromInput;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiSelectSelectionStrategy<any, any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SiSelectSelectionStrategy<any, any>, never, never, { "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+}
+
 /**
  * Copyright (c) Siemens 2016 - 2025
  * SPDX-License-Identifier: MIT
+ *
+ * @deprecated Use {@link SelectOption} instead.
+ */
+interface SelectOptionLegacy {
+    /** Defines this to be the deprecated option. */
+    type?: undefined;
+    /** Identifies the option, will be used as `value` for the component */
+    id: string;
+    /** Title to display */
+    title: string;
+    /** Optional icon to display */
+    icon?: string;
+    /** Optional color class for the icon */
+    color?: string;
+    /** Is the option disabled? */
+    disabled?: boolean;
+}
+/** A select option group */
+interface SelectGroup<T> {
+    /** Defines this to be a group. */
+    type: 'group';
+    /** An optional key to identify this group in a custom template. */
+    key?: string;
+    /** A label to be shown as header for this group. Is optional if a custom template is provided. */
+    label?: string;
+    /** All options that are part of this group. */
+    options: SelectOption<T>[];
+}
+/** A select option */
+interface SelectOption<T> {
+    /** Defines this to be an option. */
+    type: 'option';
+    /**
+     * The value if this option.
+     * It will be used for formControls and the value property of this `si-select`.
+     * The value will internally be checked on equality by using `===`.
+     * So an app should either use `string` or ensure that same values are referentially equal.
+     */
+    value: T;
+    /** Whether this option is disabled. */
+    disabled?: boolean;
+    /** An optional icon. */
+    icon?: string;
+    /** The color of an icon. */
+    iconColor?: string;
+    /** An optional stacked icon. */
+    stackedIcon?: string;
+    /** The color of a stacked icon. */
+    stackedIconColor?: string;
+    /**
+     * A label to be shown for this option.
+     * Is optional if a custom template is provided or if the value should directly be rendered.
+     */
+    label?: string;
+    /**
+     * Used for typeahead functionality when filtering is disabled.
+     * If provided, this will be used, otherwise the innerText of the rendered element.
+     */
+    typeaheadLabel?: string;
+}
+/** Alias for {@link SelectOption} or {@link SelectGroup} */
+type SelectItem<T> = SelectGroup<T> | SelectOption<T>;
+
+declare class SiSelectComponent<T> implements OnChanges, AfterContentInit, SiFormItemControl {
+    private static idCounter;
+    /**
+     * Unique identifier.
+     *
+     * @defaultValue
+     * ```
+     * `__si-select-${SiSelectComponent.idCounter++}`
+     * ```
+     */
+    readonly id: _angular_core.InputSignal<string>;
+    /**
+     * Aria label of the select.
+     *
+     * @defaultValue null
+     */
+    readonly ariaLabel: _angular_core.InputSignal<string | null>;
+    /**
+     * Aria labelledby of the select.
+     * @defaultValue undefined
+     */
+    readonly labelledbyInput: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Placeholder for search input field.
+     *
+     * @defaultValue
+     * ```
+     * t(() => $localize`:@@SI_SELECT.SEARCH-PLACEHOLDER:Search...`)
+     * ```
+     */
+    readonly filterPlaceholder: _angular_core.InputSignal<TranslatableString>;
+    /**
+     * Label if no item can be found.
+     *
+     * @defaultValue
+     * ```
+     * t(() => $localize`:@@SI_SELECT.NO-RESULTS-FOUND:No results found`)
+     * ```
+     */
+    readonly noResultsFoundLabel: _angular_core.InputSignal<TranslatableString>;
+    /** Placeholder text to display when no options are selected. */
+    readonly placeholder: _angular_core.InputSignal<TranslatableString | undefined>;
+    /**
+     * Readonly state. Similar to disabled but with higher contrast *
+     *
+     * @defaultValue false
+     */
+    readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Emits on selection dropdown close.
+     * @deprecated Use {@link openChange} instead.
+     */
+    readonly dropdownClose: _angular_core.OutputEmitterRef<void>;
+    /** Emits when the dropdown open state changes. */
+    readonly openChange: _angular_core.OutputEmitterRef<boolean>;
+    protected readonly isOpen: _angular_core.WritableSignal<boolean>;
+    protected readonly optionTemplate: _angular_core.Signal<TemplateRef<{
+        $implicit: SelectOption<T>;
+    }> | undefined>;
+    protected readonly groupTemplate: _angular_core.Signal<TemplateRef<{
+        $implicit: SelectGroup<T>;
+    }> | undefined>;
+    protected readonly actionsTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
+    private readonly trigger;
+    /** @internal */
+    readonly labelledby: _angular_core.Signal<string>;
+    /** @internal */
+    readonly errormessageId: string;
+    protected rows: readonly SelectItem<T>[];
+    protected overlayWidth: number;
+    protected readonly selectionStrategy: SiSelectSelectionStrategy<any, any>;
+    private backdropClicked;
+    private readonly selectOptions;
+    /**
+     * Enables the filter input
+     * @defaultValue false
+     * @defaultref {@link SiSelectComponent#_hasFilter}
+     */
+    readonly hasFilter: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngAfterContentInit(): void;
+    /** Opens the `si-select`. */
+    open(): void;
+    /** Closes the `si-select`. */
+    close(): void;
+    protected backdropClick(): void;
+    private verifyValueProvider;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiSelectComponent<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SiSelectComponent<any>, "si-select", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "labelledbyInput": { "alias": "labelledby"; "required": false; "isSignal": true; }; "filterPlaceholder": { "alias": "filterPlaceholder"; "required": false; "isSignal": true; }; "noResultsFoundLabel": { "alias": "noResultsFoundLabel"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "hasFilter": { "alias": "hasFilter"; "required": false; "isSignal": true; }; }, { "dropdownClose": "dropdownClose"; "openChange": "openChange"; }, ["optionTemplate", "groupTemplate", "actionsTemplate"], never, true, never>;
+}
+
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+
+/**
+ * An interface to define a lazy option source for the {@link SiSelectComponent}.
+ *
+ * @typeParam TValue - is the type of the value in {@link SiSelectComponent}, so the value of the associated formControl, ngModel or value input.
+ */
+interface SelectOptionSource<TValue> {
+    /**
+     * Get options for the provided values.
+     * This is basically a resolver function, that resolves values to options.
+     *
+     * @param values - values that should be resolved to an option.
+     */
+    getOptionsForValues(values: TValue[]): Observable<SelectOption<TValue>[]>;
+    /**
+     * Get all available options.
+     * If provided, this will be called when no filter value is provided.
+     * Otherwise, si-select will only show the selected values.
+  
+     * This function must be implemented if this source is used on a select without a filter.
+     */
+    getAllOptions?(): Observable<SelectItem<TValue>[]>;
+    /**
+     * Find options for a search value. It will never be called with an empty search value.
+     *
+     * This function must be implemented if this source is used on a si-select with a filter.
+     *
+     * @param search - value typed by the user in the search field.
+     */
+    getOptionsForSearch?(search: string): Observable<SelectItem<TValue>[]>;
+    /**
+     * This function is used to sort options.
+     *
+     * It is only called if the si-select was able to find all options without querying the option source.
+     */
+    compareOptions?(a: SelectOption<TValue>, b: SelectOption<TValue>): number;
+    /**
+     * Function to check if two values are equal.
+     *
+     * This function must be implemented if the check on reference equality is not enough.
+     * For instance, when using objects as value.
+     */
+    valuesEqual?(optionA: TValue, optionB: TValue): boolean;
+}
+
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+
+interface SiSelectOptionsStrategy<T> {
+    /**
+     * List of all rows that should be rendered in a selection list.
+     */
+    readonly rows: Signal<readonly SelectItem<T>[]>;
+    /**
+     * List of all options that are currently selected.
+     * Must be updated when {@link onValueChange} is called.
+     */
+    readonly selectedRows: Signal<readonly SelectOption<T>[]>;
+    /**
+     * Indicate loading state of the options.
+     */
+    readonly loading?: Signal<boolean>;
+    /**
+     * Is always called when the value changes.
+     * The implementation must update {@link selectedRows} when called.
+     *
+     * @param value - currently selected value of the related si-select.
+     */
+    onValueChange(value: readonly T[]): void;
+    /**
+     * This function is called when a user enters a filter query.
+     * It is expected that an implementation will update the `rows`
+     * based on the query.
+     *
+     * @param filterInput - Unprocessed input by user in the filterInput field
+     */
+    onFilter?(filterInput?: string): void;
+}
+
+declare class SiSelectLazyOptionsDirective<T> implements SiSelectOptionsStrategy<T>, OnDestroy {
+    /**
+     * {@inheritDoc SiSelectOptionsStrategy#loading}
+     * @defaultValue false
+     */
+    readonly loading: _angular_core.WritableSignal<boolean>;
+    /**
+     * {@inheritDoc SiSelectOptionsStrategy#rows}
+     * @defaultValue []
+     */
+    readonly rows: _angular_core.WritableSignal<SelectItem<T>[]>;
+    /**
+     * {@inheritDoc SiSelectOptionsStrategy#selectedRows}
+     * @defaultValue []
+     */
+    readonly selectedRows: _angular_core.WritableSignal<SelectOption<T>[]>;
+    readonly optionSource: _angular_core.InputSignal<SelectOptionSource<T>>;
+    private valueChange;
+    private filterChange;
+    constructor();
+    ngOnDestroy(): void;
+    /** {@inheritDoc SiSelectOptionsStrategy.onValueChange} */
+    onValueChange(value: T[]): void;
+    /** {@inheritDoc SiSelectOptionsStrategy.onFilter} */
+    onFilter(filterInput?: string): void;
+    private valueEqual;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiSelectLazyOptionsDirective<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SiSelectLazyOptionsDirective<any>, "si-select[optionSource]", never, { "optionSource": { "alias": "optionSource"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Input options strategy base class, for eagerly fetched options.
+ */
+declare abstract class SiSelectOptionsStrategyBase<T> implements SiSelectOptionsStrategy<T> {
+    /**
+     * Function to compare two values on equality which is used to match/filter options.
+     */
+    abstract optionsEqual: InputSignal<(a: T, b: T) => boolean>;
+    /**
+     * Rows that should be shown.
+     *
+     * @defaultValue []
+     */
+    readonly rows: _angular_core.WritableSignal<SelectItem<T>[]>;
+    /**
+     * All group and option items in the dropdown.
+     *
+     * @defaultValue []
+     */
+    abstract readonly allRows: Signal<(SelectItem<T> | SelectOption<T>)[]>;
+    private readonly value;
+    readonly selectedRows: Signal<SelectOption<T>[]>;
+    onValueChange(value: T[]): void;
+    onFilter(filterValue?: string): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiSelectOptionsStrategyBase<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SiSelectOptionsStrategyBase<any>, never, never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * This directive allows passing {@link SelectItem} to the {@link SiSelectComponent}.
+ *
+ * @example
+ * ```html
+ * <si-select [options]="[{ type: 'option', value: 'one', label: 'One' }, { type: 'option', value: 'two', label: 'Two' }]"></si-select>
+ * <si-select [options]="[{ type: 'group', label: 'Group', options [{ type: 'option', value: 1, label: 'One' }, { type: 'option', value: 2, label: 'Two' }] }]"></si-select>
+ * ```
+ */
+declare class SiSelectSimpleOptionsDirective<T = string> extends SiSelectOptionsStrategyBase<T> implements OnChanges {
+    /** Options to be shown in select dropdown */
+    readonly options: _angular_core.InputSignal<(SelectOptionLegacy | SelectItem<T>)[] | null | undefined>;
+    /**
+     * By default, values are check on referential equality. Provide a function to customize the behavior.
+     *
+     * @defaultValue
+     * ```
+     * (a: T, b: T): boolean => a === b
+     * ```
+     */
+    readonly optionsEqual: _angular_core.InputSignal<(a: T, b: T) => boolean>;
+    readonly allRows: _angular_core.Signal<SelectItem<T>[]>;
+    ngOnChanges(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiSelectSimpleOptionsDirective<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SiSelectSimpleOptionsDirective<any>, "si-select[options]", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionsEqual": { "alias": "optionEqualCheckFn"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * The directive allows passing custom options.
+ * Otherwise, use the {@link SiSelectSimpleOptionsDirective} directive.
+ *
+ * @deprecated Use {@link SiSelectSimpleOptionsDirective} instead.
+ *
+ * @example
+ * ```html
+ * <si-select [complexOptions]="['v1', 'v2', 'v3']"></si-select>
+ * <si-select [complexOptions]="{ g1: ['g1.i1', 'g1.i2'], g2: ['g2.i1']}"></si-select>
+ * ```
+ */
+declare class SiSelectComplexOptionsDirective<T> extends SiSelectOptionsStrategyBase<T> implements OnChanges {
+    /** Options to be shown in select dropdown. */
+    readonly complexOptions: _angular_core.InputSignal<T[] | Record<string, T[]> | null | undefined>;
+    /**
+     * @deprecated Property has no effect and can be removed.
+     *
+     * @defaultValue
+     * ```
+     * buildTrackByIdentity<T>()
+     * ```
+     */
+    readonly trackBy: _angular_core.InputSignal<_angular_core.TrackByFunction<T>>;
+    /**
+     * By default, values are check on equality by reference. Override to customize the behavior.
+     *
+     * @defaultValue
+     * ```
+     * (a: T, b: T): boolean => a === b
+     * ```
+     */
+    readonly optionsEqual: _angular_core.InputSignal<(a: T, b: T) => boolean>;
+    /**
+     * The valueProvider is used to extract the display text of a value.
+     */
+    readonly valueProvider: _angular_core.InputSignal<((dropdownOption: T) => string | undefined) | undefined>;
+    /**
+     * Provides Value for the display text of the dropdown group
+     *
+     * @defaultValue
+     * ```
+     * () => undefined
+     * ```
+     */
+    readonly groupProvider: _angular_core.InputSignal<(groupKey: string) => string | undefined>;
+    /**
+     * The disabledProvider is used to display menu items as disabled.
+     *
+     * @defaultValue
+     * ```
+     * () => false
+     * ```
+     */
+    readonly disabledProvider: _angular_core.InputSignal<(dropdownOption: T) => boolean>;
+    readonly allRows: _angular_core.Signal<SelectOption<T>[] | SelectGroup<T>[]>;
+    ngOnChanges(): void;
+    private convertOptionsArray;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiSelectComplexOptionsDirective<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SiSelectComplexOptionsDirective<any>, "si-select[complexOptions]", never, { "complexOptions": { "alias": "complexOptions"; "required": false; "isSignal": true; }; "trackBy": { "alias": "trackBy"; "required": false; "isSignal": true; }; "optionsEqual": { "alias": "optionEqualCheckFn"; "required": false; "isSignal": true; }; "valueProvider": { "alias": "valueProvider"; "required": false; "isSignal": true; }; "groupProvider": { "alias": "groupProvider"; "required": false; "isSignal": true; }; "disabledProvider": { "alias": "disabledProvider"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * The directive enables the single-select behavior.
+ * Otherwise, use the {@link SiSelectMultiValueDirective} directive.
+ *
+ * @example
+ * ```html
+ * <si-select [(value)]="selectedValue" [options]="[
+ *  { id: 'good', title: 'Good' },
+ *  { id: 'average', title: 'Average' },
+ *  { id: 'poor', title: 'Poor' }
+ * ]"></si-select>
+ * ```
+ */
+declare class SiSelectSingleValueDirective<T> extends SiSelectSelectionStrategy<T, T> {
+    /**
+     * {@inheritDoc SiSelectSelectionStrategy#allowMultiple}
+     * @defaultValue false
+     */
+    allowMultiple: boolean;
+    protected toArrayValue(value: T | undefined): readonly T[];
+    protected fromArrayValue([value]: readonly T[]): T;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiSelectSingleValueDirective<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SiSelectSingleValueDirective<any>, "si-select:not([multi])", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * The directive enables the multi-select behavior.
+ * Otherwise, use the {@link SiSelectSingleValueDirective} directive.
+ *
+ * @example
+ * ```html
+ * <si-select multi [(value)]="multiValue" [options]="[
+ *  { id: 'good', title: 'Good' },
+ *  { id: 'average', title: 'Average' },
+ *  { id: 'poor', title: 'Poor' }
+ * ]"></si-select>
+ * ```
+ */
+declare class SiSelectMultiValueDirective<T> extends SiSelectSelectionStrategy<T, T[]> {
+    /**
+     * {@inheritDoc SiSelectSelectionStrategy#allowMultiple}
+     * @defaultValue true
+     */
+    readonly allowMultiple = true;
+    protected fromArrayValue(value: T[]): T[];
+    protected toArrayValue(value: T[] | undefined): T[];
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiSelectMultiValueDirective<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SiSelectMultiValueDirective<any>, "si-select[multi]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * The directive allows to template/customize the value option rendering.
+ * This requires using the {@link SiSelectComplexOptionsDirective} to specify complex options as input.
+ *
+ * @example
+ * ```html
+ * <si-select [options]="[{ id: 'good', title: 'Good' }, { id: 'fair', title: 'Fair' }, { id: 'bad', title: 'Bad' }]" >
+ *   <ng-template siSelectOptionTemplate let-option>{{ option.value | uppercase }}</ng-template>
+ * </si-select>
+ * ```
+ */
+declare class SiSelectOptionTemplateDirective {
+    /** @internal */
+    static ngTemplateContextGuard<T = any>(directive: SiSelectOptionTemplateDirective, context: unknown): context is {
+        $implicit: SelectOption<T>;
+    };
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiSelectOptionTemplateDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SiSelectOptionTemplateDirective, "[siSelectOptionTemplate]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * The directive allows to template/customize the group option rendering.
+ * This requires using the {@link SiSelectComplexOptionsDirective} to specify complex options as input.
+ *
+ * @example
+ * ```html
+ * <si-select [complexOptions]="{ g1: ['g1.i1', 'g1.i2'], g2: ['g2.i1'] }" >
+ *   <ng-template siSelectGroupTemplate let-group>{{ group.key | uppercase }}</ng-template>
+ * </si-select>
+ * ```
  */
-export * from './si-select.component';
-export * from './options/si-select-lazy-options.directive';
-export * from './options/si-select-simple-options.directive';
-export * from './options/si-select-complex-options.directive';
-export * from './options/si-select-option.source';
-export * from './selection/si-select-single-value.directive';
-export * from './selection/si-select-multi-value.directive';
-export * from './si-select-option-template.directive';
-export * from './si-select-group-template.directive';
-export * from './si-select.module';
-export * from './select-list/si-select-list-has-filter.component';
-export * from './si-select-action.directive';
-export * from './si-select-actions.directive';
-export * from './si-select.types';
+declare class SiSelectGroupTemplateDirective {
+    static ngTemplateContextGuard<T = any>(directive: SiSelectGroupTemplateDirective, context: unknown): context is {
+        $implicit: SelectGroup<T>;
+    };
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiSelectGroupTemplateDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SiSelectGroupTemplateDirective, "[siSelectGroupTemplate]", never, {}, {}, never, never, true, never>;
+}
+
+declare class SiSelectActionDirective {
+    private readonly select;
+    /**
+     * Close the select drop down on click.
+     * @defaultValue false
+     */
+    readonly selectActionAutoClose: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected close(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiSelectActionDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SiSelectActionDirective, "[siSelectAction]", ["si-select-action"], { "selectActionAutoClose": { "alias": "selectActionAutoClose"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+declare class SiSelectActionsDirective {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiSelectActionsDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SiSelectActionsDirective, "[siSelectActions]", ["si-select-actions"], {}, {}, never, never, true, never>;
+}
+
+declare class SiSelectModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiSelectModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<SiSelectModule, never, [typeof SiSelectActionDirective, typeof SiSelectActionsDirective, typeof SiSelectComplexOptionsDirective, typeof SiSelectComponent, typeof SiSelectGroupTemplateDirective, typeof SiSelectMultiValueDirective, typeof SiSelectOptionTemplateDirective, typeof SiSelectSimpleOptionsDirective, typeof SiSelectSingleValueDirective], [typeof SiSelectActionDirective, typeof SiSelectActionsDirective, typeof SiSelectComplexOptionsDirective, typeof SiSelectComponent, typeof SiSelectGroupTemplateDirective, typeof SiSelectMultiValueDirective, typeof SiSelectOptionTemplateDirective, typeof SiSelectSimpleOptionsDirective, typeof SiSelectSingleValueDirective]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<SiSelectModule>;
+}
+
+declare abstract class SiSelectListBase<T> implements OnInit, OnDestroy {
+    readonly baseId: _angular_core.InputSignal<string>;
+    readonly optionTemplate: _angular_core.InputSignal<TemplateRef<{
+        $implicit: SelectOption<T>;
+    }> | undefined>;
+    readonly groupTemplate: _angular_core.InputSignal<TemplateRef<{
+        $implicit: SelectGroup<T>;
+    }> | undefined>;
+    /** @defaultValue null */
+    readonly labelledby: _angular_core.InputSignal<string | null>;
+    readonly actionsTemplate: _angular_core.InputSignal<TemplateRef<any> | undefined>;
+    readonly closeOverlay: _angular_core.OutputEmitterRef<void>;
+    protected readonly selectionStrategy: SiSelectSelectionStrategy<T, T | T[]>;
+    protected readonly selectOptions: SiSelectOptionsStrategy<T>;
+    protected readonly focusTrapFactory: ConfigurableFocusTrapFactory;
+    protected readonly elementRef: ElementRef<any>;
+    protected rows: _angular_core.Signal<readonly _siemens_element_ng_select.SelectItem<T>[]>;
+    protected focusTrap: ConfigurableFocusTrap;
+    protected multiSelect: boolean;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    protected keydownTab(): void;
+    protected closeOverlayAlways(): void;
+    protected closeOverlayIfSingle(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiSelectListBase<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SiSelectListBase<any>, never, never, { "baseId": { "alias": "baseId"; "required": true; "isSignal": true; }; "optionTemplate": { "alias": "optionTemplate"; "required": false; "isSignal": true; }; "groupTemplate": { "alias": "groupTemplate"; "required": false; "isSignal": true; }; "labelledby": { "alias": "labelledby"; "required": false; "isSignal": true; }; "actionsTemplate": { "alias": "actionsTemplate"; "required": false; "isSignal": true; }; }, { "closeOverlay": "closeOverlay"; }, never, never, true, never>;
+}
+
+declare class SiSelectListHasFilterComponent<T> extends SiSelectListBase<T> implements OnInit {
+    /** Placeholder for search input field. */
+    readonly filterPlaceholder: _angular_core.InputSignal<TranslatableString>;
+    /** Label if no item can be found. */
+    readonly noResultsFoundLabel: _angular_core.InputSignal<TranslatableString>;
+    protected readonly filterInput: Signal<ElementRef<HTMLInputElement>>;
+    protected readonly initIndex: Signal<number>;
+    protected readonly id: Signal<string>;
+    protected readonly icons: Record<"elementSearch", string>;
+    constructor();
+    ngOnInit(): void;
+    protected input(): void;
+    protected select(newValue: T): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiSelectListHasFilterComponent<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SiSelectListHasFilterComponent<any>, "si-select-list-has-filter", never, { "filterPlaceholder": { "alias": "filterPlaceholder"; "required": true; "isSignal": true; }; "noResultsFoundLabel": { "alias": "noResultsFoundLabel"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { SiSelectActionDirective, SiSelectActionsDirective, SiSelectComplexOptionsDirective, SiSelectComponent, SiSelectGroupTemplateDirective, SiSelectLazyOptionsDirective, SiSelectListHasFilterComponent, SiSelectModule, SiSelectMultiValueDirective, SiSelectOptionTemplateDirective, SiSelectSimpleOptionsDirective, SiSelectSingleValueDirective };
+export type { SelectGroup, SelectItem, SelectOption, SelectOptionLegacy, SelectOptionSource };

package/shadow-root/index.d.ts

@@ -1,5 +1,43 @@
+import { OverlayContainer } from '@angular/cdk/overlay';
+import * as i0 from '@angular/core';
+
 /**
  * Copyright (c) Siemens 2016 - 2025
  * SPDX-License-Identifier: MIT
  */
-export * from './si-shadow-root.directive';
+
+/**
+ * This directive is intended to be used in applications that do NOT load element styles in the root HTML element.
+ * So typically module federation, single SPA apps or apps that bootstrap element manually in a shadow root.
+ *
+ * This directive will ensure that overlays created within this shadow root will have the correct styles applied.
+ * It does this by creating a new shadow root in the document body
+ * and copying the styles from this shadow root to new one.
+ *
+ * With that approach, we can ensure that overlay can span the entire screen without being limited to the current shadow root.
+ *
+ * To use this directive, add it to the component / element which creates the shadow root which holds the element styles.
+ *
+ * @example
+ * ```ts
+ * @Component({
+ *   selector: 'app-root',
+ *   encapsulation: ViewEncapsulation.ShadowDom,
+ *   hostDirectives: [SiShadowRootDirective],
+ *   stylesUrls: ['element-styles.scss'],
+ *   template: `<si-element-component />`
+ * })
+ * export class AppComponent { }
+ *
+ * ```
+ *
+ */
+declare class SiShadowRootDirective extends OverlayContainer {
+    private elementRef;
+    private document;
+    protected _createContainer(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SiShadowRootDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SiShadowRootDirective, "[siShadowRoot]", never, {}, {}, never, never, true, never>;
+}
+
+export { SiShadowRootDirective };