@siemens/element-ng 48.1.0 → 48.2.0-rc.1

package/schematics/ts-import-to-siemens-migration/mappings/element-translate-ng-mappings.js

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+export const ELEMENT_TRANSLATE_NG_MAPPINGS = {
+    'getBrowserCultureLanguage': '@siemens/element-translate-ng/translate',
+    'getBrowserLanguage': '@siemens/element-translate-ng/translate',
+    'injectSiTranslateService': '@siemens/element-translate-ng/translate',
+    'provideMockTranslateServiceBuilder': '@siemens/element-translate-ng/translate',
+    'provideNgLocalizeForElement': '@siemens/element-translate-ng/angular-localize',
+    'provideNgxTranslateForElement': '@siemens/element-translate-ng/ngx-translate',
+    'SI_TRANSLATABLE_VALUES': '@siemens/element-translate-ng/translate',
+    'SiNoTranslateService': '@siemens/element-translate-ng/translate',
+    'SiTranslateModule': '@siemens/element-translate-ng/translate',
+    'SiTranslateNgLocalizeModule': '@siemens/element-translate-ng/angular-localize',
+    'SiTranslateNgxTModule': '@siemens/element-translate-ng/ngx-translate',
+    'SiTranslatePipe': '@siemens/element-translate-ng/translate',
+    't': '@siemens/element-translate-ng/translate',
+    'TranslatableString': '@siemens/element-translate-ng/translate-types',
+    'TranslationResult': '@siemens/element-translate-ng/translate'
+};

package/schematics/ts-import-to-siemens-migration/mappings/index.js

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+export * from './charts-ng-mappings.js';
+export * from './dashboards-ng-mappings.js';
+export * from './element-ng-mappings.js';
+export * from './element-translate-ng-mappings.js';
+export * from './maps-ng-mappings.js';

package/schematics/ts-import-to-siemens-migration/mappings/maps-ng-mappings.js

@@ -0,0 +1,46 @@
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+export const MAPS_NG_MAPPINGS = {
+    'ANIMATION_DURATION': '@siemens/maps-ng',
+    'CLUSTER_CHARTS_FRAGMENTS': '@siemens/maps-ng',
+    'CLUSTER_RADIUS_SIZE': '@siemens/maps-ng',
+    'ColorPalette': '@siemens/maps-ng',
+    'ColorPalettes': '@siemens/maps-ng',
+    'DEFAULT_CLUSTER_CLICK_ZOOM': '@siemens/maps-ng',
+    'DEFAULT_CLUSTER_DISTANCE': '@siemens/maps-ng',
+    'DEFAULT_CLUSTER_TYPE': '@siemens/maps-ng',
+    'DEFAULT_DONUT_RATIO': '@siemens/maps-ng',
+    'DEFAULT_FEATURE_CLICK_ZOOM': '@siemens/maps-ng',
+    'DEFAULT_FEATURE_SELECT_ZOOM': '@siemens/maps-ng',
+    'DEFAULT_FIT_PADDING': '@siemens/maps-ng',
+    'DEFAULT_GLOBAL_ZOOM': '@siemens/maps-ng',
+    'DEFAULT_ICON_SCALE': '@siemens/maps-ng',
+    'DEFAULT_ICON': '@siemens/maps-ng',
+    'DEFAULT_OFFSET': '@siemens/maps-ng',
+    'DEFAULT_STROKE_WEIGHT': '@siemens/maps-ng',
+    'GEOJSON_LAYER': '@siemens/maps-ng',
+    'Grouping': '@siemens/maps-ng',
+    'IconMarkerOptions': '@siemens/maps-ng',
+    'LabelOptions': '@siemens/maps-ng',
+    'LAYER_NAME': '@siemens/maps-ng',
+    'MapPoint': '@siemens/maps-ng',
+    'MapPointMetaData': '@siemens/maps-ng',
+    'MapService': '@siemens/maps-ng',
+    'MarkerOptions': '@siemens/maps-ng',
+    'MarkerStatusType': '@siemens/maps-ng',
+    'MAX_CLUSTER_BUILDINGS': '@siemens/maps-ng',
+    'OverlayNativeProperties': '@siemens/maps-ng',
+    'POINTS_LAYER': '@siemens/maps-ng',
+    'provideSiMapsTranslatableOverrides': '@siemens/maps-ng/translate',
+    'RenderOptions': '@siemens/maps-ng',
+    'SIEMENS_FONT_LABELS': '@siemens/maps-ng',
+    'SIEMENS_FONT': '@siemens/maps-ng',
+    'SiMapComponent': '@siemens/maps-ng',
+    'SiMapModule': '@siemens/maps-ng',
+    'SiMapPopoverComponent': '@siemens/maps-ng',
+    'SiMapsNgModule': '@siemens/maps-ng',
+    'SiMapTooltipComponent': '@siemens/maps-ng',
+    'TOOLTIP_FEATURES_TO_DISPLAY': '@siemens/maps-ng'
+};

package/schematics/ts-import-to-siemens-migration/model.js

@@ -0,0 +1,4 @@
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */

package/schematics/ts-import-to-siemens-migration/schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "TsImportToSiemensMigrationSchema",
+  "title": "TypeScript import to Siemens Migration Schema",
+  "type": "object",
+  "properties": {
+    "path": {
+      "type": "string",
+      "description": "Path to the directory where all simpl imports should be migrated.",
+      "x-prompt": "Which directory do you want to migrate?",
+      "format": "path",
+      "default": "/"
+    }
+  },
+  "required": []
+}

package/schematics/utils/index.js

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+export * from './project-utils.js';
+export * from './ts-utils.js';
+export * from './testing.js';
+export * from './schematics-file-system.js';

package/schematics/utils/project-utils.js

@@ -0,0 +1,75 @@
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+import { normalize } from '@angular-devkit/core';
+import { SchematicsException } from '@angular-devkit/schematics';
+import { dirname, isAbsolute, resolve } from 'path';
+import { parseTsconfigFile } from './ts-utils.js';
+export const getGlobalStyles = (tree) => {
+    const globalStyles = new Set();
+    for (const target of getTargets(getWorkspace(tree))) {
+        if (target.options?.styles && Array.isArray(target.options.styles)) {
+            target.options.styles.forEach((style) => {
+                if (typeof style === 'string') {
+                    globalStyles.add(normalize(style));
+                }
+            });
+        }
+    }
+    return [...globalStyles];
+};
+export const getWorkspace = (tree) => {
+    const workspace = tree.read('/angular.json');
+    if (!workspace) {
+        throw new SchematicsException('Could not find angular.json');
+    }
+    return JSON.parse(workspace.toString());
+};
+export const getTsConfigPaths = (tree) => {
+    const buildPaths = new Set();
+    for (const target of getTargets(getWorkspace(tree))) {
+        if (target.options?.tsConfig && typeof target.options.tsConfig === 'string') {
+            const tsConfig = target.options.tsConfig;
+            if (tree.exists(tsConfig)) {
+                buildPaths.add(normalize(tsConfig));
+            }
+        }
+    }
+    return [...buildPaths];
+};
+export const discoverSourceFiles = (tree, context, projectPath, extension = '.ts') => {
+    const basePath = normalize(process.cwd());
+    // Wrap the tree to force full paths since parsing the typescript config requires full paths.
+    const tsConfigs = getTsConfigPaths(tree);
+    if (!tsConfigs.length) {
+        throw new SchematicsException('Could not find any tsconfig file. Cannot run the migration.');
+    }
+    context.logger.debug(`Found tsconfig files: ${tsConfigs.join(', ')}`);
+    let sourceFiles = [];
+    for (const configPath of tsConfigs) {
+        const tsConfigPath = resolve(basePath, configPath);
+        const config = parseTsconfigFile(tsConfigPath, dirname(tsConfigPath), tree);
+        sourceFiles.push(...config.fileNames.filter(f => f.endsWith(extension)));
+    }
+    // Filter all files which are in the path
+    if (projectPath) {
+        sourceFiles = isAbsolute(projectPath)
+            ? sourceFiles.filter(f => f.startsWith(projectPath))
+            : sourceFiles.filter(f => f.startsWith(resolve(basePath, projectPath)));
+    }
+    return Array.from(new Set(sourceFiles)).map(p => p.substring(basePath.length + 1));
+};
+function* getTargets(workspace, targetNames = ['build', 'test']) {
+    for (const [, projectRaw] of Object.entries(workspace.projects)) {
+        const project = projectRaw;
+        if (!project.architect) {
+            continue;
+        }
+        for (const [name, target] of Object.entries(project.architect)) {
+            if (targetNames.includes(name) && target) {
+                yield target;
+            }
+        }
+    }
+}

package/schematics/utils/schematics-file-system.js

@@ -0,0 +1,22 @@
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+import { normalize } from '@angular-devkit/core';
+import { relative } from 'path';
+export class SchematicsFileSystem {
+    tree;
+    basePath = normalize(process.cwd());
+    constructor(tree) {
+        this.tree = tree;
+    }
+    readText = (path) => {
+        return this.tree.readText(normalize(relative(this.basePath, path)));
+    };
+    exists = (path) => {
+        return this.tree.exists(normalize(relative(this.basePath, path)));
+    };
+    getDir = (path) => {
+        return this.tree.getDir(normalize(relative(this.basePath, path)));
+    };
+}

package/schematics/utils/testing.js

@@ -0,0 +1,41 @@
+/**
+ * Creates a sample workspace with two applications: 'app' (default) and 'second-app'
+ */
+export const createTestApp = async (runner, appOptions = {}, files) => {
+    let tree = await createWorkspace(runner);
+    if (files) {
+        addTestFiles(tree, files);
+    }
+    tree = await runner.runExternalSchematic('@schematics/angular', 'application', { name: 'app', ...appOptions }, tree);
+    return runner.runExternalSchematic('@schematics/angular', 'application', { name: 'second-app', ...appOptions }, tree);
+};
+const createWorkspace = (runner) => {
+    return runner.runExternalSchematic('@schematics/angular', 'workspace', {
+        name: 'workspace',
+        version: '1.0.0',
+        newProjectRoot: 'projects'
+    });
+};
+export const addTestFiles = (tree, files) => {
+    Object.entries(files).forEach(([path, content]) => {
+        if (tree.exists(path)) {
+            tree.overwrite(path, content);
+        }
+        else {
+            tree.create(path, content);
+        }
+    });
+    return tree;
+};
+export const readLines = (tree, path) => tree
+    .readContent(path)
+    .split('\n')
+    .filter(l => l.length > 0);
+export const removeTestFiles = (tree, files) => {
+    files.forEach(path => {
+        if (tree.exists(path)) {
+            tree.delete(path);
+        }
+    });
+    return tree;
+};

package/schematics/utils/ts-utils.js

@@ -0,0 +1,99 @@
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+import { normalize } from '@angular-devkit/core';
+import { SchematicsException } from '@angular-devkit/schematics';
+import { isAbsolute } from 'path';
+import ts from 'typescript';
+import { SchematicsFileSystem } from './schematics-file-system.js';
+/**
+ * Reads and parses a tsconfig file from the given path.
+ */
+export const parseTsconfigFile = (tsconfigPath, basePath, tree) => {
+    // Parse the tsconfig file content
+    const fs = new SchematicsFileSystem(tree);
+    const { config, error } = ts.readConfigFile(tsconfigPath, fs.readText);
+    if (error) {
+        throw new SchematicsException(`Error parsing ${tsconfigPath}: ${error.messageText}`);
+    }
+    // Create a ts.ParseConfigHost that uses the schematics Tree
+    const parseConfigHost = {
+        fileExists: fs.exists,
+        readFile: fs.readText,
+        readDirectory: (path, _extensions, _excludes, _includes, _depth) => visitDirectory(fs, path),
+        useCaseSensitiveFileNames: true
+    };
+    // Throw if incorrect arguments are passed to this function. Passing relative base paths
+    // results in root directories not being resolved and in later type checking runtime errors.
+    // More details can be found here: https://github.com/microsoft/TypeScript/issues/37731.
+    if (!isAbsolute(basePath)) {
+        throw Error('Unexpected relative base path has been specified.');
+    }
+    return ts.parseJsonConfigFileContent(config, parseConfigHost, basePath, {});
+};
+/**
+ * Finds all nodes which match the given kind.
+ */
+export const findNodes = (node, kindOrGuard, max = Infinity, recursive = false) => {
+    if (!node || max == 0) {
+        return [];
+    }
+    const test = typeof kindOrGuard === 'function'
+        ? kindOrGuard
+        : // eslint-disable-next-line @typescript-eslint/no-shadow
+            (node) => node.kind === kindOrGuard;
+    const arr = [];
+    if (test(node)) {
+        arr.push(node);
+        max--;
+    }
+    if (max > 0 && (recursive || !test(node))) {
+        for (const child of node.getChildren()) {
+            // eslint-disable-next-line @typescript-eslint/no-loop-func, @typescript-eslint/no-shadow
+            findNodes(child, test, max, recursive).forEach(node => {
+                if (max > 0) {
+                    arr.push(node);
+                }
+                max--;
+            });
+            if (max <= 0) {
+                break;
+            }
+        }
+    }
+    return arr;
+};
+/**
+ * Gets the import nodes from a TypeScript file which start the given import path.
+ */
+export const getImportNodes = (filePath, content, specifier) => {
+    const sourceFile = ts.createSourceFile(filePath, content.toString(), ts.ScriptTarget.Latest, true);
+    // Find all import declarations in the source file
+    const allImports = findNodes(sourceFile, ts.SyntaxKind.ImportDeclaration);
+    return allImports.filter(node => node.moduleSpecifier &&
+        ts.isStringLiteral(node.moduleSpecifier) &&
+        node.moduleSpecifier.text.startsWith(specifier));
+};
+/**
+ * Gets the imported symbols from an import declaration.
+ */
+export const getSymbols = (node) => {
+    // Extract all imported component names or module names from @simpl/ imports
+    return node.importClause?.namedBindings && ts.isNamedImports(node.importClause.namedBindings)
+        ? node.importClause.namedBindings.elements
+        : [];
+};
+const visitDirectory = (fs, dirPath) => {
+    const entries = fs.getDir(dirPath);
+    const files = [];
+    entries.subfiles.forEach(filename => {
+        const fullPath = normalize(`${dirPath}/${filename}`);
+        files.push(fullPath);
+    });
+    entries.subdirs.forEach(subdirname => {
+        const newFiles = visitDirectory(fs, `${dirPath}/${subdirname}`);
+        files.push(...newFiles);
+    });
+    return files;
+};

package/search-bar/index.d.ts

@@ -1,3 +1,4 @@
+import * as _siemens_element_translate_ng_translate_types from '@siemens/element-translate-ng/translate-types';
 import * as _angular_core from '@angular/core';
 import { OnInit, OnDestroy, OnChanges, SimpleChanges } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
@@ -49,6 +50,15 @@ declare class SiSearchBarComponent implements OnInit, OnDestroy, ControlValueAcc
     readonly colorVariant: _angular_core.InputSignal<BackgroundColorVariant>;
     /** @defaultValue false */
     readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Aria label for the clear button.
+     *
+     * @defaultValue
+     * ```
+     * t(() => $localize`:@@SI_SEARCH_BAR.CLEAR_BUTTON:clear`)
+     * ```
+     */
+    readonly clearButtonAriaLabel: _angular_core.InputSignal<_siemens_element_translate_ng_translate_types.TranslatableString>;
     /**
      * Output callback event will provide you with search term if search input changes.
      */
@@ -81,7 +91,7 @@ declare class SiSearchBarComponent implements OnInit, OnDestroy, ControlValueAcc
     protected resetForm(): void;
     protected writeSearchValue(value: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiSearchBarComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SiSearchBarComponent, "si-search-bar", never, { "debounceTime": { "alias": "debounceTime"; "required": false; "isSignal": true; }; "prohibitedCharacters": { "alias": "prohibitedCharacters"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "showIcon": { "alias": "showIcon"; "required": false; "isSignal": true; }; "tabbable": { "alias": "tabbable"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "colorVariant": { "alias": "colorVariant"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "searchChange": "searchChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SiSearchBarComponent, "si-search-bar", never, { "debounceTime": { "alias": "debounceTime"; "required": false; "isSignal": true; }; "prohibitedCharacters": { "alias": "prohibitedCharacters"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "showIcon": { "alias": "showIcon"; "required": false; "isSignal": true; }; "tabbable": { "alias": "tabbable"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "colorVariant": { "alias": "colorVariant"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "clearButtonAriaLabel": { "alias": "clearButtonAriaLabel"; "required": false; "isSignal": true; }; }, { "searchChange": "searchChange"; }, never, never, true, never>;
 }
 
 declare class SiSearchBarModule {

package/template-i18n.json

@@ -102,18 +102,24 @@
   "SI_FILTER_BAR.RESET_FILTERS": "Reset filters",
   "SI_FORM_CONTAINER.ERROR.DATE_FORMAT": "Invalid date format.",
   "SI_FORM_CONTAINER.ERROR.EMAIL": "The email is not valid.",
+  "SI_FORM_CONTAINER.ERROR.HOURS": "The hours are not valid.",
   "SI_FORM_CONTAINER.ERROR.IPV4": "Invalid IPv4 address.",
   "SI_FORM_CONTAINER.ERROR.IPV6": "Invalid IPv6 address.",
   "SI_FORM_CONTAINER.ERROR.MAX": "The value is too large.",
   "SI_FORM_CONTAINER.ERROR.MAX_DATE": "The date is too far in the future.",
   "SI_FORM_CONTAINER.ERROR.MAX_LENGTH": "A maximum number of characters is exceeded.",
+  "SI_FORM_CONTAINER.ERROR.MAX_TIME": "The time is too far in the future.",
+  "SI_FORM_CONTAINER.ERROR.MILLISECONDS": "The milliseconds are not valid.",
   "SI_FORM_CONTAINER.ERROR.MIN": "The value is too small",
+  "SI_FORM_CONTAINER.ERROR.MINUTES": "The minutes are not valid.",
   "SI_FORM_CONTAINER.ERROR.MIN_DATE": "The date is too far in the past.",
   "SI_FORM_CONTAINER.ERROR.MIN_LENGTH": "The minimum number of characters is not met.",
+  "SI_FORM_CONTAINER.ERROR.MIN_TIME": "The time is too far in the past.",
   "SI_FORM_CONTAINER.ERROR.NUMBER_FORMAT": "The value is not a valid number.",
   "SI_FORM_CONTAINER.ERROR.PATTERN": "The value does not match the predefined pattern.",
   "SI_FORM_CONTAINER.ERROR.REQUIRED": "A value is required.",
   "SI_FORM_CONTAINER.ERROR.REQUIRED_TRUE": "The value should be true.",
+  "SI_FORM_CONTAINER.ERROR.SECONDS": "The seconds are not valid.",
   "SI_ICON_STATUS.CAUTION": "Caution",
   "SI_ICON_STATUS.CRITICAL": "Critical",
   "SI_ICON_STATUS.DANGER": "Danger",
@@ -172,6 +178,7 @@
   "SI_PHOTO_UPLOAD.UPLOAD_PHOTO": "Upload photo",
   "SI_PILLS_INPUT.INPUT_ELEMENT_ARIA_LABEL": "Create item",
   "SI_PROGRESSBAR.LABEL": "Progress",
+  "SI_SEARCH_BAR.CLEAR_BUTTON": "clear",
   "SI_SELECT.NO-RESULTS-FOUND": "No results found",
   "SI_SELECT.SEARCH-PLACEHOLDER": "Search...",
   "SI_SIDE_PANEL.CLOSE": "Close",

package/tooltip/index.d.ts

@@ -36,7 +36,6 @@ declare class SiTooltipDirective implements OnDestroy {
     private tooltipRef?;
     private tooltipService;
     private elementRef;
-    private destroyer;
     ngOnDestroy(): void;
     private showTooltip;
     protected focusIn(): void;
@@ -70,6 +69,7 @@ declare class TooltipRef {
     private describedBy;
     private injector?;
     constructor(overlayRef: OverlayRef, element: ElementRef, describedBy: string, injector?: Injector | undefined);
+    private subscription?;
     show(content: TranslatableString | TemplateRef<any> | Type<any>, tooltipContext?: unknown): void;
     hide(): void;
     destroy(): void;

package/translate/index.d.ts

@@ -105,18 +105,24 @@ interface SiTranslatableKeys {
     'SI_FILTER_BAR.RESET_FILTERS'?: string;
     'SI_FORM_CONTAINER.ERROR.DATE_FORMAT'?: string;
     'SI_FORM_CONTAINER.ERROR.EMAIL'?: string;
+    'SI_FORM_CONTAINER.ERROR.HOURS'?: string;
     'SI_FORM_CONTAINER.ERROR.IPV4'?: string;
     'SI_FORM_CONTAINER.ERROR.IPV6'?: string;
     'SI_FORM_CONTAINER.ERROR.MAX'?: string;
     'SI_FORM_CONTAINER.ERROR.MAX_DATE'?: string;
     'SI_FORM_CONTAINER.ERROR.MAX_LENGTH'?: string;
+    'SI_FORM_CONTAINER.ERROR.MAX_TIME'?: string;
+    'SI_FORM_CONTAINER.ERROR.MILLISECONDS'?: string;
     'SI_FORM_CONTAINER.ERROR.MIN'?: string;
+    'SI_FORM_CONTAINER.ERROR.MINUTES'?: string;
     'SI_FORM_CONTAINER.ERROR.MIN_DATE'?: string;
     'SI_FORM_CONTAINER.ERROR.MIN_LENGTH'?: string;
+    'SI_FORM_CONTAINER.ERROR.MIN_TIME'?: string;
     'SI_FORM_CONTAINER.ERROR.NUMBER_FORMAT'?: string;
     'SI_FORM_CONTAINER.ERROR.PATTERN'?: string;
     'SI_FORM_CONTAINER.ERROR.REQUIRED'?: string;
     'SI_FORM_CONTAINER.ERROR.REQUIRED_TRUE'?: string;
+    'SI_FORM_CONTAINER.ERROR.SECONDS'?: string;
     'SI_ICON_STATUS.CAUTION'?: string;
     'SI_ICON_STATUS.CRITICAL'?: string;
     'SI_ICON_STATUS.DANGER'?: string;
@@ -175,6 +181,7 @@ interface SiTranslatableKeys {
     'SI_PHOTO_UPLOAD.UPLOAD_PHOTO'?: string;
     'SI_PILLS_INPUT.INPUT_ELEMENT_ARIA_LABEL'?: string;
     'SI_PROGRESSBAR.LABEL'?: string;
+    'SI_SEARCH_BAR.CLEAR_BUTTON'?: string;
     'SI_SELECT.NO-RESULTS-FOUND'?: string;
     'SI_SELECT.SEARCH-PLACEHOLDER'?: string;
     'SI_SIDE_PANEL.CLOSE'?: string;

package/typeahead/index.d.ts

@@ -5,6 +5,18 @@ import { ConnectionPositionPair } from '@angular/cdk/overlay';
 import { Observable } from 'rxjs';
 import * as i1 from '@siemens/element-ng/autocomplete';
 
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+
+interface MatchSegment$1 {
+    text: string;
+    isMatching: boolean;
+    matches: number;
+    uniqueMatches: number;
+}
+
 /**
  * Copyright (c) Siemens 2016 - 2025
  * SPDX-License-Identifier: MIT
@@ -213,7 +225,44 @@ declare class SiTypeaheadDirective implements OnChanges, OnDestroy {
     /** Emits whenever the typeahead overlay is opened or closed. */
     readonly typeaheadOpenChange: _angular_core.OutputEmitterRef<boolean>;
     /** @internal */
-    readonly foundMatches: _angular_core.WritableSignal<TypeaheadMatch[]>;
+    readonly foundMatches: _angular_core.Signal<{
+        itemSelected: any;
+        iconClass: string | undefined;
+        option: TypeaheadOption;
+        text: string;
+        result: MatchSegment$1[];
+        stringMatch: boolean;
+        atBeginning: boolean;
+        matches: number;
+        uniqueMatches: number;
+        uniqueSeparateMatches: number;
+        matchesEntireQuery: boolean;
+        matchesAllParts: boolean;
+        matchesAllPartsSeparately: boolean;
+    }[] | TypeaheadMatch[] | {
+        option: {
+            text: string;
+            option: TypeaheadOption;
+        };
+        text: string;
+        result: {
+            text: string;
+            isMatching: boolean;
+            matches: number;
+            uniqueMatches: number;
+        }[];
+        itemSelected: any;
+        iconClass: string | undefined;
+        stringMatch: boolean;
+        atBeginning: boolean;
+        matches: number;
+        uniqueMatches: number;
+        uniqueSeparateMatches: number;
+        matchesEntireQuery: boolean;
+        matchesAllParts: boolean;
+        matchesAllPartsSeparately: boolean;
+        active: boolean;
+    }[]>;
     /** @internal */
     readonly query: _angular_core.WritableSignal<string>;
     /**
@@ -226,12 +275,23 @@ declare class SiTypeaheadDirective implements OnChanges, OnDestroy {
     private autoComplete;
     private $typeahead;
     private componentRef?;
-    private component?;
     private inputTimer;
     private sourceSubscription?;
-    private subscription?;
     private matchSorter;
     private overlayRef?;
+    /**
+     * Indicates that the typeahead can be potentially open.
+     * This signal is typically `true` when the input is focussed.
+     * It may be overridden and set to `false` when escape is pressed
+     * or when an option was selected.
+     */
+    private readonly canBeOpen;
+    private readonly selectionCounter;
+    private readonly typeaheadOptions;
+    private readonly typeaheadSearch;
+    private readonly processedSearch;
+    private readonly unprocessedSearch;
+    constructor();
     ngOnChanges(changes: SimpleChanges): void;
     protected onBlur(): void;
     protected onInput(event: Event): void;
@@ -239,8 +299,29 @@ declare class SiTypeaheadDirective implements OnChanges, OnDestroy {
     protected onKeydownSpace(event: Event): void;
     ngOnDestroy(): void;
     private loadComponent;
+    /**
+     * Extracts the display value from a typeahead option.
+     *
+     * For string options, returns the string value directly.
+     * For object options, returns the value of the field specified by {@link typeaheadOptionField}
+     * (defaults to 'name'), or an empty string if the field doesn't exist.
+     *
+     * @param option - The typeahead option to extract the value from
+     * @returns The string representation of the option for display purposes
+     */
     private getOptionValue;
-    private getMatches;
+    /**
+     * Extracts a specific field value from a typeahead option.
+     *
+     * This method is used to access additional properties of object-type options,
+     * such as 'selected' for multi-select functionality or 'iconClass' for displaying icons.
+     *
+     * @param option - The typeahead option to extract the field from
+     * @param field - The name of the field to extract
+     * @returns The field value as a string if the option is an object and the field exists,
+     *          otherwise undefined
+     */
+    private getOptionField;
     /** @internal */
     selectMatch(match: TypeaheadMatch): void;
     private removeComponent;