@siemens/element-ng 51.2.0 → 51.4.0

package/schematics/migrations/utilities/symbol-renaming.migration.js

@@ -4,16 +4,18 @@
  */
 import * as ts from 'typescript';
 import { EmitHint } from 'typescript';
-import { findImportSpecifier } from '../../utils/index.js';
+import { findImportSpecifier, getImportSpecifiers } from '../../utils/index.js';
+import { removeImportSpecifiers } from './import-removal.js';
 export const applySymbolRenamingMigration = (context, changes) => {
     const { discoveredSourceFile, recorder } = context;
     if (!changes?.length) {
         return;
     }
-    const { sourceFile } = discoveredSourceFile;
+    const { sourceFile, typeChecker } = discoveredSourceFile;
     const changeInstructions = [
         ...renameIdentifier({
             sourceFile,
+            typeChecker,
             renamingInstructions: changes
         })
     ];
@@ -26,7 +28,7 @@ export const applySymbolRenamingMigration = (context, changes) => {
         recorder.insertLeft(changeInstruction.start, printer.printNode(EmitHint.Unspecified, changeInstruction.newNode, sourceFile));
     }
 };
-function* renameIdentifier({ sourceFile, renamingInstructions }) {
+function* renameIdentifier({ sourceFile, typeChecker, renamingInstructions }) {
     for (const node of sourceFile.statements) {
         if (!ts.isImportDeclaration(node) || !ts.isStringLiteral(node.moduleSpecifier)) {
             continue;
@@ -38,6 +40,10 @@ function* renameIdentifier({ sourceFile, renamingInstructions }) {
             if (!(node.importClause?.namedBindings && ts.isNamedImports(node.importClause.namedBindings))) {
                 continue;
             }
+            if (!renamingInstruction.toModule) {
+                yield* renameSymbolsInPlace(sourceFile, typeChecker, node, renamingInstruction);
+                continue;
+            }
             // Find all symbols from this import that need to be renamed/moved
             const symbolsToProcess = [];
             for (const { replace, replaceWith } of renamingInstruction.symbolRenamings) {
@@ -126,3 +132,84 @@ function* renameIdentifier({ sourceFile, renamingInstructions }) {
         }
     }
 }
+function* renameSymbolsInPlace(sourceFile, typeChecker, declaration, instruction) {
+    const importClause = declaration.importClause;
+    const bindings = importClause.namedBindings;
+    const replacements = new Map();
+    const references = new Map();
+    const redundantImports = [];
+    for (const specifier of bindings.elements) {
+        const importedName = specifier.propertyName ?? specifier.name;
+        const rename = instruction.symbolRenamings.find(change => change.replace === importedName.text);
+        if (!rename) {
+            continue;
+        }
+        // Aliases keep their local name and only change the imported symbol.
+        if (specifier.propertyName) {
+            replacements.set(specifier, rename.replaceWith);
+            continue;
+        }
+        const existingImport = getImportSpecifiers(sourceFile, declaration.moduleSpecifier.text, rename.replaceWith).find(candidate => {
+            const isTypeOnly = candidate.isTypeOnly || candidate.parent.parent.isTypeOnly;
+            return !isTypeOnly || specifier.isTypeOnly || importClause.isTypeOnly;
+        });
+        if (existingImport) {
+            redundantImports.push(specifier);
+        }
+        else {
+            replacements.set(specifier, rename.replaceWith);
+        }
+        const symbol = typeChecker.getSymbolAtLocation(specifier.name);
+        if (symbol) {
+            references.set(symbol, existingImport?.name.text ?? rename.replaceWith);
+        }
+    }
+    if (redundantImports.length) {
+        const edit = removeImportSpecifiers(sourceFile, declaration, redundantImports);
+        const remaining = bindings.elements.filter(specifier => !redundantImports.includes(specifier));
+        const updatedBindings = ts.factory.updateNamedImports(bindings, remaining.map(specifier => {
+            const replacement = replacements.get(specifier);
+            if (!replacement) {
+                return specifier;
+            }
+            return ts.factory.updateImportSpecifier(specifier, specifier.isTypeOnly, specifier.propertyName ? ts.factory.createIdentifier(replacement) : undefined, specifier.propertyName ? specifier.name : ts.factory.createIdentifier(replacement));
+        }));
+        yield {
+            start: edit.start,
+            width: edit.width,
+            newNode: edit.newNode
+                ? ts.factory.updateImportDeclaration(declaration, declaration.modifiers, ts.factory.updateImportClause(importClause, importClause.isTypeOnly, importClause.name, updatedBindings), declaration.moduleSpecifier, declaration.attributes)
+                : ts.factory.createIdentifier('')
+        };
+    }
+    else {
+        for (const [specifier, replacement] of replacements) {
+            const importedName = specifier.propertyName ?? specifier.name;
+            yield {
+                start: importedName.getStart(),
+                width: importedName.getWidth(),
+                newNode: ts.factory.createIdentifier(replacement)
+            };
+        }
+    }
+    const visit = function* (node) {
+        if (ts.isImportDeclaration(node)) {
+            return;
+        }
+        if (ts.isIdentifier(node)) {
+            const symbol = typeChecker.getSymbolAtLocation(node);
+            const replacement = symbol && references.get(symbol);
+            if (replacement) {
+                yield {
+                    start: node.getStart(),
+                    width: node.getWidth(),
+                    newNode: ts.factory.createIdentifier(replacement)
+                };
+            }
+        }
+        for (const child of node.getChildren()) {
+            yield* visit(child);
+        }
+    };
+    yield* visit(sourceFile);
+}

package/schematics/utils/template-edit-utils.js

@@ -33,3 +33,12 @@ export const removeAttribute = (template, attribute, offset, recorder) => {
     const removeStart = start > 0 && /\s/.test(template[start - 1] ?? '') ? start - 1 : start;
     recorder.remove(removeStart + offset, end - removeStart);
 };
+/** Removes static attributes and property/attribute bindings with the given names. */
+export const removeAttributesFromElement = (template, element, names, offset, recorder) => {
+    for (const attribute of element.attrs) {
+        const matches = names.some(name => [name, `[${name}]`, `attr.${name}`, `[attr.${name}]`].includes(attribute.name));
+        if (matches) {
+            removeAttribute(template, attribute, offset, recorder);
+        }
+    }
+};

package/template-i18n.json

@@ -205,7 +205,13 @@
   "SI_MAP.WINDOWS_HELP": "Use Ctrl + scroll to zoom the map",
   "SI_MAP.ZOOM_IN": "Zoom in",
   "SI_MAP.ZOOM_OUT": "Zoom out",
+  "SI_MAP_CLUSTER.CLOSE": "Close",
+  "SI_MAP_CLUSTER.ERROR": "Could not load locations.",
   "SI_MAP_CLUSTER.LABEL": "Cluster with {{count}} locations",
+  "SI_MAP_CLUSTER.LOAD_MORE": "Load more",
+  "SI_MAP_CLUSTER.LOCATIONS": "Cluster locations",
+  "SI_MAP_CLUSTER.POPOVER_TITLE": "Cluster with {{count}} locations",
+  "SI_MAP_CLUSTER.RETRY": "Retry",
   "SI_MARKDOWN.COPIED_CODE": "Copied",
   "SI_MARKDOWN.COPY_CODE": "Copy code",
   "SI_MARKDOWN.COPY_TABLE_AS_CSV": "Copy table as CSV",

package/types/siemens-element-ng-breadcrumb.d.ts

@@ -66,7 +66,6 @@ declare class SiBreadcrumbComponent implements OnChanges, OnDestroy {
     protected breadcrumbShortened: boolean;
     protected ellipsesLevel: number;
     protected breadcrumbDropdownOpen: number | undefined;
-    protected addExpandDropdown: boolean;
     protected controlId: string;
     protected readonly icons: Record<"elementBreadcrumbRoot" | "elementRight2", string>;
     private readonly breadcrumbElement;
@@ -76,6 +75,7 @@ declare class SiBreadcrumbComponent implements OnChanges, OnDestroy {
     ngOnChanges(): void;
     ngOnDestroy(): void;
     private processItems;
+    /** Toggle the ellipses dropdown to show the hidden breadcrumb levels. */
     protected toggleBreadcrumbDropdown(itemLevel: number): void;
     protected documentClick(targetElement: any): void;
     protected resetBreadcrumb(): void;

package/types/siemens-element-ng-common.d.ts

@@ -130,6 +130,11 @@ declare class TextMeasureService {
 /**
  * Gets the width of the scrollbar.  Nesc for windows
  * http://stackoverflow.com/a/13382873/888165
+ *
+ * @deprecated This service uses a legacy DOM-measurement hack to determine scrollbar width.
+ * Use `element.offsetWidth - element.clientWidth` on the scrollable element directly,
+ * which is more accurate, SSR-safe, and accounts for OS-level theming and CSS overrides.
+ * Will be removed in v52.
  */
 declare class ScrollbarHelper {
     private document;

package/types/siemens-element-ng-dashboard.d.ts

@@ -129,7 +129,6 @@ declare class SiDashboardComponent implements OnChanges, AfterViewInit {
     private scroller;
     private dashboardService;
     private resizeObserver;
-    private scrollbarHelper;
     private cdRef;
     private document;
     private injector;

package/types/siemens-element-ng-datepicker.d.ts

@@ -217,7 +217,7 @@ declare class SiDateInputDirective implements ControlValueAccessor, OnChanges, V
     registerOnTouched(fn: () => void): void;
     registerOnValidatorChange(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
-    writeValue(value?: Date | string): void;
+    writeValue(value?: Date | string | null): void;
     private updateNativeValue;
     /**
      * Handles `input` events on the input element.
@@ -920,6 +920,11 @@ declare class SiTimepickerComponent implements ControlValueAccessor, Validator,
      * Holds the time as date object that is presented by this control.
      */
     private time?;
+    /**
+     * Whether `null` was emitted due to an incomplete or invalid input.
+     * The next valid time must be emitted, even if it equals the previous `time`.
+     */
+    private invalidTimeEmitted;
     private periodDefaults;
     constructor();
     writeValue(obj?: Date | string): void;

package/types/siemens-element-ng-filtered-search.d.ts

@@ -140,12 +140,23 @@ interface DisplayedCriteriaEventArgs {
     allow(criteriaNamesToDisplay: string[], freeText?: boolean): void;
 }
 
+/** Criterion definition normalized for internal rendering and input handling. */
 interface InternalCriterionDefinition extends CriterionDefinition {
     label: string;
     translatedLabel: string;
+    /**
+     * Identifies free-text pills, displayed without a criterion label using a plain-text editor.
+     * Omitted for regular criteria. Internal only; not included in the search model.
+     */
     type?: 'free-text';
 }
 
+interface InternalCriterion {
+    config: InternalCriterionDefinition;
+    value: CriterionValue;
+    editOnCreation: boolean;
+    initialValueText?: string;
+}
 declare class SiFilteredSearchComponent implements OnInit, OnChanges {
     /**
      * Factory for CDK scroll strategies used by filtered-search overlays.
@@ -375,11 +386,8 @@ declare class SiFilteredSearchComponent implements OnInit, OnChanges {
     private readonly scrollContainer;
     private readonly valueComponents;
     protected dataSource: Observable<InternalCriterionDefinition[]>;
-    protected autoEditCriteria: boolean;
-    protected readonly values: _angular_core.WritableSignal<{
-        config: InternalCriterionDefinition;
-        value: CriterionValue;
-    }[]>;
+    protected readonly values: _angular_core.WritableSignal<InternalCriterion[]>;
+    protected readonly maxCriteriaReached: _angular_core.Signal<boolean>;
     protected readonly searchValue: _angular_core.WritableSignal<string>;
     /** Internal criteria model */
     protected internalCriterionDefinitions: InternalCriterionDefinition[];
@@ -423,6 +431,11 @@ declare class SiFilteredSearchComponent implements OnInit, OnChanges {
      */
     private convertToExternalModel;
     private addCriterion;
+    private resolveValue;
+    private isDateCriterion;
+    private parseModelDate;
+    private parseInputDate;
+    private getAllowedCriteria;
     /**
      * Get criteria list to be shown in typeahead.
      * @returns list of criteria to be shown in typeahead.
@@ -434,22 +447,25 @@ declare class SiFilteredSearchComponent implements OnInit, OnChanges {
     protected onCreateCriterion(event: {
         criterion: InternalCriterionDefinition;
         value?: string;
+        accept: () => void;
     }): void;
     protected onCreateCriterionByName(event: {
         criterionName: string;
         value?: string;
+        editOnCreation?: boolean;
+        accept: () => void;
     }): void;
     protected onSearchValueChange(): void;
-    protected valueChange(value: CriterionValue, criterion: {
-        config: InternalCriterionDefinition;
-        value: CriterionValue;
-    }): void;
+    protected valueChange(value: CriterionValue, criterion: InternalCriterion): void;
     protected focusNext(index: number, event: {
         freeText: string;
     } | void): void;
     private updateAndEmitSearchCriteria;
     private emitChangeEvent;
-    protected createFreeTextPill(query: string): void;
+    protected createFreeTextPill(event: {
+        query: string;
+        accept: () => void;
+    }): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiFilteredSearchComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SiFilteredSearchComponent, "si-filtered-search", never, { "scrollStrategy": { "alias": "scrollStrategy"; "required": false; "isSignal": true; }; "doSearchOnInputChange": { "alias": "doSearchOnInputChange"; "required": false; "isSignal": true; }; "lazyCriterionProvider": { "alias": "lazyCriterionProvider"; "required": false; "isSignal": true; }; "lazyValueProvider": { "alias": "lazyValueProvider"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "strictCriterion": { "alias": "strictCriterion"; "required": false; "isSignal": true; }; "strictValue": { "alias": "strictValue"; "required": false; "isSignal": true; }; "onlySelectValue": { "alias": "onlySelectValue"; "required": false; "isSignal": true; }; "lazyLoadingDebounceTime": { "alias": "lazyLoadingDebounceTime"; "required": false; "isSignal": true; }; "searchDebounceTime": { "alias": "searchDebounceTime"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "optionsInScrollableView": { "alias": "optionsInScrollableView"; "required": false; "isSignal": true; }; "searchCriteria": { "alias": "searchCriteria"; "required": false; "isSignal": true; }; "criteria": { "alias": "criteria"; "required": false; "isSignal": true; }; "exclusiveCriteria": { "alias": "exclusiveCriteria"; "required": false; "isSignal": true; }; "maxCriteria": { "alias": "maxCriteria"; "required": false; "isSignal": true; }; "maxCriteriaOptions": { "alias": "maxCriteriaOptions"; "required": false; "isSignal": true; }; "searchLabel": { "alias": "searchLabel"; "required": false; "isSignal": true; }; "clearButtonLabel": { "alias": "clearButtonLabel"; "required": false; "isSignal": true; }; "submitButtonLabel": { "alias": "submitButtonLabel"; "required": false; "isSignal": true; }; "itemCountText": { "alias": "itemCountText"; "required": false; "isSignal": true; }; "colorVariant": { "alias": "colorVariant"; "required": false; "isSignal": true; }; "disableFreeTextSearch": { "alias": "disableFreeTextSearch"; "required": false; "isSignal": true; }; "typeaheadOptionsLimit": { "alias": "typeaheadOptionsLimit"; "required": false; "isSignal": true; }; "disableSelectionByColonAndSemicolon": { "alias": "disableSelectionByColonAndSemicolon"; "required": false; "isSignal": true; }; "freeTextCriterion": { "alias": "freeTextCriterion"; "required": false; "isSignal": true; }; "searchForFreeTextLabel": { "alias": "searchForFreeTextLabel"; "required": false; "isSignal": true; }; }, { "doSearch": "doSearch"; "searchCriteria": "searchCriteriaChange"; "interceptDisplayedCriteria": "interceptDisplayedCriteria"; }, never, never, true, never>;
 }

package/types/siemens-element-ng-form.d.ts

@@ -388,7 +388,7 @@ declare class SiFormFieldsetComponent {
     /** @internal */
     readonly hasOnlyRadios: _angular_core.Signal<boolean>;
     protected readonly errors: _angular_core.Signal<readonly _siemens_element_ng_form.SiFormError[]>;
-    protected readonly touched: _angular_core.Signal<boolean>;
+    protected readonly showErrors: _angular_core.Signal<boolean>;
     protected readonly isRequired: _angular_core.Signal<boolean>;
     protected readonly labelId: string;
     /** @internal */

package/types/siemens-element-ng-maplibre.d.ts

@@ -1,8 +1,9 @@
 import { ExtendedStatusType } from '@siemens/element-ng/common';
 import * as _angular_core from '@angular/core';
-import { Signal } from '@angular/core';
+import { Signal, TemplateRef } from '@angular/core';
 import { StyleSpecification } from 'maplibre-gl';
 import * as geojson from 'geojson';
+import * as _siemens_element_translate_ng_translate from '@siemens/element-translate-ng/translate';
 
 /**
  * Copyright (c) Siemens 2016 - 2026
@@ -20,6 +21,27 @@ interface ClusterSegment {
     color: string;
     property: string;
 }
+/**
+ * Context supplied to custom cluster popover templates, including all locations loaded so far.
+ *
+ * @experimental
+ */
+interface ClusterPopoverContext {
+    /** All loaded original point features, exposed by an unqualified `let-features` binding. */
+    $implicit: readonly ClusterPoint[];
+    /** The same accumulated features as `$implicit`, exposed by `let-features="features"`. */
+    features: readonly ClusterPoint[];
+    /** Total number of locations in the selected cluster, including locations not yet loaded. */
+    total: number;
+    /** Whether the initial batch, an additional batch, or a retry is being loaded. */
+    loading: boolean;
+    /** Error from a failed batch request, or `undefined` when no error is available. */
+    error: unknown;
+    /** Selected cluster feature, including its `cluster_id` and `point_count` properties. */
+    cluster: ClusterPoint;
+    /** Closes the popover using the same behavior as its Close button. */
+    close: () => void;
+}
 
 /**
  * Copyright (c) Siemens 2016 - 2026
@@ -144,9 +166,94 @@ declare class SiClusterSourceComponent {
     protected readonly clusterConfiguration: _angular_core.Signal<ClusterConfiguration>;
     /** Stores selection for the projected cluster-popover integration. */
     protected readonly selectedCluster: _angular_core.WritableSignal<ClusterPoint | undefined>;
-    protected selectCluster(feature: ClusterPoint): Promise<void>;
+    private readonly source;
+    /**
+     * Returns a page of original points belonging to a cluster.
+     * @see https://maplibre.org/maplibre-gl-js/docs/API/classes/GeoJSONSource/#getclusterleaves
+     */
+    getClusterLeaves(clusterId: number, limit: number, offset: number): Promise<ClusterPoint[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiClusterSourceComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SiClusterSourceComponent, "si-cluster-source", never, { "sourceId": { "alias": "sourceId"; "required": true; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "groupProperty": { "alias": "groupProperty"; "required": false; "isSignal": true; }; "groupColors": { "alias": "groupColors"; "required": false; "isSignal": true; }; "statusProperty": { "alias": "statusProperty"; "required": false; "isSignal": true; }; "clusterRadius": { "alias": "clusterRadius"; "required": false; "isSignal": true; }; "clusterMaxZoom": { "alias": "clusterMaxZoom"; "required": false; "isSignal": true; }; "clusterMinPoints": { "alias": "clusterMinPoints"; "required": false; "isSignal": true; }; }, { "clusterClick": "clusterClick"; }, never, ["si-cluster-popover,[siClusterPopoverOutlet]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SiClusterSourceComponent, "si-cluster-source", never, { "sourceId": { "alias": "sourceId"; "required": true; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "groupProperty": { "alias": "groupProperty"; "required": false; "isSignal": true; }; "groupColors": { "alias": "groupColors"; "required": false; "isSignal": true; }; "statusProperty": { "alias": "statusProperty"; "required": false; "isSignal": true; }; "clusterRadius": { "alias": "clusterRadius"; "required": false; "isSignal": true; }; "clusterMaxZoom": { "alias": "clusterMaxZoom"; "required": false; "isSignal": true; }; "clusterMinPoints": { "alias": "clusterMinPoints"; "required": false; "isSignal": true; }; }, { "clusterClick": "clusterClick"; }, never, ["*"], true, never>;
+}
+
+/**
+ * Optional popup with incrementally loaded locations projected into a `si-cluster-source`.
+ *
+ * @experimental
+ */
+declare class SiClusterPopoverComponent {
+    private static idCounter;
+    private readonly destroyRef;
+    private readonly focusTrapFactory;
+    private readonly document;
+    private readonly source;
+    private readonly mapService;
+    private readonly resizeObserver;
+    /**
+     * Maximum width passed to the MapLibre popup.
+     * @defaultValue '320px'
+     */
+    readonly maxWidth: _angular_core.InputSignal<string>;
+    /**
+     * Whether the popup closes when the map moves.
+     * @defaultValue true
+     */
+    readonly closeOnMove: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Number of locations loaded initially and with each "Load more" action.
+     * @defaultValue 8
+     */
+    readonly pageSize: _angular_core.InputSignalWithTransform<number, unknown>;
+    /**
+     * Feature property displayed in the default list.
+     * @defaultValue 'name'
+     */
+    readonly labelProperty: _angular_core.InputSignal<string>;
+    /**
+     * Feature property displayed as the description in the default list.
+     * @defaultValue 'description'
+     */
+    readonly descriptionProperty: _angular_core.InputSignal<string>;
+    private readonly dialog;
+    private readonly scrollRegion;
+    private readonly batchButton;
+    private readonly selectedCluster;
+    private readonly batchFocusRequested;
+    private readonly offset;
+    private readonly displayedFeatures;
+    protected readonly titleId: string;
+    protected readonly popupCoordinates: _angular_core.WritableSignal<geojson.Position | undefined>;
+    protected readonly availableBlockSize: _angular_core.WritableSignal<number | undefined>;
+    protected readonly leaves: _angular_core.ResourceRef<ClusterPoint[] | undefined>;
+    protected readonly context: _angular_core.Signal<ClusterPopoverContext | undefined>;
+    protected readonly template: _angular_core.Signal<TemplateRef<ClusterPopoverContext> | undefined>;
+    protected readonly clusterPopoverTitle: _siemens_element_translate_ng_translate.TranslatableString;
+    protected readonly locationsLabel: _siemens_element_translate_ng_translate.TranslatableString;
+    protected readonly errorText: _siemens_element_translate_ng_translate.TranslatableString;
+    protected readonly loadMoreText: _siemens_element_translate_ng_translate.TranslatableString;
+    protected readonly retryText: _siemens_element_translate_ng_translate.TranslatableString;
+    protected readonly closeText: _siemens_element_translate_ng_translate.TranslatableString;
+    protected readonly icons: Record<"elementCancel", string>;
+    protected readonly close: () => void;
+    protected readonly loadBatch: () => void;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiClusterPopoverComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SiClusterPopoverComponent, "si-cluster-popover", never, { "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "closeOnMove": { "alias": "closeOnMove"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "labelProperty": { "alias": "labelProperty"; "required": false; "isSignal": true; }; "descriptionProperty": { "alias": "descriptionProperty"; "required": false; "isSignal": true; }; }, {}, ["template"], never, true, never>;
+}
+
+/**
+ * Template for custom location content inside `si-cluster-popover`.
+ *
+ * Receives a {@link ClusterPopoverContext} with all locations loaded so far. Loading feedback,
+ * error recovery, and the "Load more" button are handled by the popover.
+ *
+ * @experimental
+ */
+declare class SiClusterPopoverTemplateDirective {
+    /** @internal */
+    static ngTemplateContextGuard(directive: SiClusterPopoverTemplateDirective, context: unknown): context is ClusterPopoverContext;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SiClusterPopoverTemplateDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SiClusterPopoverTemplateDirective, "[siClusterPopoverTemplate]", never, {}, {}, never, never, true, never>;
 }
 
 /**
@@ -186,5 +293,5 @@ declare class SiStatusMarkerComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SiStatusMarkerComponent, "si-status-marker", never, { "status": { "alias": "status"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { SiClusterSourceComponent, SiStatusMarkerComponent, injectSiMapStyle, injectSiMapTranslations };
-export type { ClusterColors, ClusterPoint, ClusterSegment, MarkerStatus };
+export { SiClusterPopoverComponent, SiClusterPopoverTemplateDirective, SiClusterSourceComponent, SiStatusMarkerComponent, injectSiMapStyle, injectSiMapTranslations };
+export type { ClusterColors, ClusterPoint, ClusterPopoverContext, ClusterSegment, MarkerStatus };

package/types/siemens-element-ng-number-input.d.ts

@@ -26,7 +26,7 @@ declare class SiNumberInputComponent implements OnChanges, ControlValueAccessor,
      */
     readonly step: _angular_core.InputSignal<number | "any">;
     /** The value */
-    readonly value: _angular_core.InputSignal<number | undefined>;
+    readonly value: _angular_core.InputSignal<number | null | undefined>;
     /** Optional unit label */
     readonly unit: _angular_core.InputSignal<string | undefined>;
     /**
@@ -104,7 +104,7 @@ declare class SiNumberInputComponent implements OnChanges, ControlValueAccessor,
     /** @internal */
     setDisabledState(isDisabled: boolean): void;
     /** @internal */
-    writeValue(value: number | undefined): void;
+    writeValue(value: number | null | undefined): void;
     /** @internal */
     validate(control: AbstractControl): ValidationErrors | null;
     /** @internal */

package/types/siemens-element-ng-popover.d.ts

@@ -13,7 +13,7 @@ declare class SiPopoverDirective implements OnDestroy {
      */
     readonly siPopover: _angular_core.InputSignal<TranslatableString | TemplateRef<unknown> | undefined>;
     /**
-     * The placement of the popover. One of 'top', 'start', end', 'bottom'
+     * The placement of the popover. One of 'top', 'start', 'end', 'bottom'
      *
      * @defaultValue 'auto'
      */
@@ -99,6 +99,7 @@ declare class PopoverComponent implements OnInit, OnDestroy {
     private elementRef;
     private focusTrapFactory;
     private focusTrap?;
+    private focusTimeoutId?;
     private readonly previouslyActiveElement;
     ngOnInit(): void;
     ngOnDestroy(): void;

package/types/siemens-element-ng-shadow-root.d.ts

@@ -1,5 +1,6 @@
 import { OverlayContainer } from '@angular/cdk/overlay';
 import * as i0 from '@angular/core';
+import { Provider } from '@angular/core';
 
 /**
  * Copyright (c) Siemens 2016 - 2026
@@ -36,9 +37,23 @@ declare class SiShadowRootDirective extends OverlayContainer {
     private elementRef;
     private document;
     private destroyRef;
+    private themeTarget;
     protected _createContainer(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SiShadowRootDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<SiShadowRootDirective, "[siShadowRoot]", never, {}, {}, never, never, true, never>;
 }
 
-export { SiShadowRootDirective };
+/**
+ * Copyright (c) Siemens 2016 - 2026
+ * SPDX-License-Identifier: MIT
+ */
+
+/**
+ * Provides the shadow root specific theme service with a dedicated theme target
+ * for components using Shadow DOM encapsulation.
+ * Use this when the component defines and loads the Element theme in its own shadow root instead
+ * of reusing the theme defined on `:root`.
+ */
+declare const provideShadowRootThemeTarget: () => Provider;
+
+export { SiShadowRootDirective, provideShadowRootThemeTarget };

package/types/siemens-element-ng-theme.d.ts

@@ -1,6 +1,6 @@
 import { Observable } from 'rxjs';
 import * as i0 from '@angular/core';
-import { EventEmitter, Signal } from '@angular/core';
+import { InjectionToken, EventEmitter, Signal } from '@angular/core';
 
 /**
  * Copyright (c) Siemens 2016 - 2026
@@ -48,7 +48,8 @@ interface ThemeColorSchemes {
 type ThemeColorScheme = {
     [key: string]: string;
 };
-type ThemeType = 'dark' | 'light' | 'auto';
+type ColorScheme = 'light' | 'dark';
+type ThemeType = ColorScheme | 'auto';
 declare const ELEMENT_THEME_NAME = "element";
 declare const elementTheme: ThemeDescription;
 
@@ -134,6 +135,32 @@ declare class SiDefaultThemeStore extends SiThemeStore {
     private saveStore;
 }
 
+/**
+ * Copyright (c) Siemens 2016 - 2026
+ * SPDX-License-Identifier: MIT
+ */
+
+/**
+ * DOM boundary controlled by {@link SiThemeService}.
+ */
+interface SiThemeDomTarget {
+    /** Element that receives theme and color-scheme classes. */
+    readonly element: HTMLElement;
+    /** CSS selector used for runtime theme variables. */
+    readonly rootSelector: string;
+    /** Event target for the legacy `theme-switch` event. */
+    readonly eventTarget?: EventTarget;
+    forEachElement(callback: (element: HTMLElement) => void): void;
+    registerElement?(element: HTMLElement): () => void;
+    getStyleElement(id: string): HTMLStyleElement | null;
+    appendStyleElement(style: HTMLStyleElement): void;
+    updateColorScheme(colorScheme: ColorScheme): void;
+}
+/**
+ * Theme DOM target. The default implementation targets the current document.
+ */
+declare const SI_THEME_DOM_TARGET: InjectionToken<SiThemeDomTarget>;
+
 declare class SiThemeService {
     /**
      * The current color scheme. (e.g. light or dark).
@@ -190,8 +217,8 @@ declare class SiThemeService {
     private isBrowser;
     private previewTheme?;
     private themeStore;
-    private meta;
     private document;
+    private themeTarget;
     constructor();
     /**
      * Returns `true` if a theme with the given name is available.
@@ -228,11 +255,11 @@ declare class SiThemeService {
      */
     setActiveTheme(name?: string, type?: ThemeType): Observable<boolean>;
     /**
-     * Apply `light` or `dark` theme to the document.
+     * Apply `light` or `dark` theme to the configured theme target.
      */
     applyThemeType(type: ThemeType): void;
     /**
-     * Applies the given theme to the document. If no theme is given, the active theme is applied.
+     * Applies the given theme to the configured theme target. If no theme is given, the active theme is applied.
      */
     applyTheme(theme?: Theme, type?: ThemeType, overwrite?: boolean): void;
     /**
@@ -248,6 +275,7 @@ declare class SiThemeService {
     private activateTheme;
     private hasThemeCSS;
     private createThemeCSS;
+    private createThemeSelector;
     private createThemeVariantCSS;
     private removeThemeCSS;
     private toggleDark;
@@ -267,5 +295,5 @@ declare class SiThemeService {
  */
 declare const injectIsDarkTheme: () => Signal<boolean>;
 
-export { ELEMENT_THEME_NAME, SI_THEME_LOCAL_STORAGE_KEY, SiDefaultThemeStore, SiThemeService, SiThemeStore, elementTheme, injectIsDarkTheme };
-export type { Theme, ThemeColorScheme, ThemeColorSchemes, ThemeDescription, ThemeProperty, ThemePropertyGroup, ThemePropertyType, ThemeStorage, ThemeType };
+export { ELEMENT_THEME_NAME, SI_THEME_DOM_TARGET, SI_THEME_LOCAL_STORAGE_KEY, SiDefaultThemeStore, SiThemeService, SiThemeStore, elementTheme, injectIsDarkTheme };
+export type { ColorScheme, SiThemeDomTarget, Theme, ThemeColorScheme, ThemeColorSchemes, ThemeDescription, ThemeProperty, ThemePropertyGroup, ThemePropertyType, ThemeStorage, ThemeType };

package/types/siemens-element-ng-tooltip.d.ts

@@ -50,6 +50,19 @@ declare class SiTooltipModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<SiTooltipModule>;
 }
 
+/**
+ * Adds a tooltip containing the host element's text when that text is truncated.
+ */
+declare class SiTooltipOverflowDirective {
+    private readonly elementRef;
+    private readonly tooltipService;
+    private readonly element;
+    constructor();
+    private canShow;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SiTooltipOverflowDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SiTooltipOverflowDirective, "[siTooltipOverflow]", never, {}, {}, never, never, true, never>;
+}
+
 /**
  * Copyright (c) Siemens 2016 - 2026
  * SPDX-License-Identifier: MIT
@@ -90,5 +103,5 @@ declare class SiTooltipService {
     static ɵprov: i0.ɵɵInjectableDeclaration<SiTooltipService>;
 }
 
-export { SiTooltipDirective, SiTooltipModule, SiTooltipService };
+export { SiTooltipDirective, SiTooltipModule, SiTooltipOverflowDirective, SiTooltipService };
 export type { TooltipRef };

package/types/siemens-element-ng-translate.d.ts

@@ -207,7 +207,13 @@ interface SiTranslatableKeys {
     'SI_MAP.WINDOWS_HELP'?: string;
     'SI_MAP.ZOOM_IN'?: string;
     'SI_MAP.ZOOM_OUT'?: string;
+    'SI_MAP_CLUSTER.CLOSE'?: string;
+    'SI_MAP_CLUSTER.ERROR'?: string;
     'SI_MAP_CLUSTER.LABEL'?: string;
+    'SI_MAP_CLUSTER.LOAD_MORE'?: string;
+    'SI_MAP_CLUSTER.LOCATIONS'?: string;
+    'SI_MAP_CLUSTER.POPOVER_TITLE'?: string;
+    'SI_MAP_CLUSTER.RETRY'?: string;
     'SI_MARKDOWN.COPIED_CODE'?: string;
     'SI_MARKDOWN.COPY_CODE'?: string;
     'SI_MARKDOWN.COPY_TABLE_AS_CSV'?: string;