@siemens/element-ng 49.14.0 → 51.0.0-rc.5

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@siemens/element-ng",
   "description": "Element Angular component library, implementing the Siemens Design Language",
-  "version": "49.14.0",
+  "version": "51.0.0-rc.5",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -14,7 +14,8 @@
   "homepage": "https://github.com/siemens/element",
   "bugs": "https://github.com/siemens/element/issues/new",
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "directory": "../../dist/@siemens/element-ng"
   },
   "type": "module",
   "schematics": "./schematics/collection.json",
@@ -35,23 +36,29 @@
     "migrations": "./schematics/migration.json"
   },
   "peerDependencies": {
-    "@angular/cdk": "21 - 22",
-    "@angular/common": "21 - 22",
-    "@angular/core": "21 - 22",
-    "@angular/forms": "21 - 22",
-    "@angular/router": "21 - 22",
-    "@ngx-formly/bootstrap": "^6.2.2",
-    "@ngx-formly/core": "^6.2.2",
+    "@angular/cdk": "22",
+    "@angular/common": "22",
+    "@angular/core": "22",
+    "@angular/forms": "22",
+    "@angular/router": "22",
+    "@ngx-formly/bootstrap": "^6.2.2 || ^7.0.1",
+    "@ngx-formly/core": "^6.2.2 || ^7.0.1",
+    "@maplibre/ngx-maplibre-gl": "21 - 22",
+    "maplibre-gl": "5 - 6",
     "@siemens/element-icons": "1",
-    "@siemens/element-translate-ng": "49.14.0",
-    "@siemens/element-theme": "49.14.0",
-    "@siemens/ngx-datatable": "22 - 26",
-    "ag-grid-community": "^34.3.1 || ^35.0.0",
+    "@siemens/ngx-datatable": "26 - 27",
+    "ag-grid-community": "^34.3.1 || ^35.0.0 || ^36.0.0",
     "flag-icons": "^7.3.2",
     "google-libphonenumber": "^3.2.40",
-    "ngx-image-cropper": "^9.0.0"
+    "ngx-image-cropper": "^9.0.0",
+    "@siemens/element-theme": "51.0.0-rc.5",
+    "@siemens/map-styles": "51.0.0-rc.5",
+    "@siemens/element-translate-ng": "51.0.0-rc.5"
   },
   "peerDependenciesMeta": {
+    "@maplibre/ngx-maplibre-gl": {
+      "optional": true
+    },
     "@ngx-formly/bootstrap": {
       "optional": true
     },
@@ -61,6 +68,9 @@
     "@siemens/ngx-datatable": {
       "optional": true
     },
+    "@siemens/map-styles": {
+      "optional": true
+    },
     "ngx-image-cropper": {
       "optional": true
     },
@@ -72,6 +82,9 @@
     },
     "ag-grid-community": {
       "optional": true
+    },
+    "maplibre-gl": {
+      "optional": true
     }
   },
   "module": "fesm2022/siemens-element-ng.mjs",
@@ -216,6 +229,10 @@
       "types": "./types/siemens-element-ng-formly.d.ts",
       "default": "./fesm2022/siemens-element-ng-formly.mjs"
     },
+    "./formly-legacy": {
+      "types": "./types/siemens-element-ng-formly-legacy.d.ts",
+      "default": "./fesm2022/siemens-element-ng-formly-legacy.mjs"
+    },
     "./header-dropdown": {
       "types": "./types/siemens-element-ng-header-dropdown.d.ts",
       "default": "./fesm2022/siemens-element-ng-header-dropdown.mjs"
@@ -228,10 +245,6 @@
       "types": "./types/siemens-element-ng-icon.d.ts",
       "default": "./fesm2022/siemens-element-ng-icon.mjs"
     },
-    "./icon-status": {
-      "types": "./types/siemens-element-ng-icon-status.d.ts",
-      "default": "./fesm2022/siemens-element-ng-icon-status.mjs"
-    },
     "./info-page": {
       "types": "./types/siemens-element-ng-info-page.d.ts",
       "default": "./fesm2022/siemens-element-ng-info-page.mjs"
@@ -272,6 +285,10 @@
       "types": "./types/siemens-element-ng-main-detail-container.d.ts",
       "default": "./fesm2022/siemens-element-ng-main-detail-container.mjs"
     },
+    "./maplibre": {
+      "types": "./types/siemens-element-ng-maplibre.d.ts",
+      "default": "./fesm2022/siemens-element-ng-maplibre.mjs"
+    },
     "./markdown-renderer": {
       "types": "./types/siemens-element-ng-markdown-renderer.d.ts",
       "default": "./fesm2022/siemens-element-ng-markdown-renderer.mjs"
@@ -372,10 +389,6 @@
       "types": "./types/siemens-element-ng-slider.d.ts",
       "default": "./fesm2022/siemens-element-ng-slider.mjs"
     },
-    "./sort-bar": {
-      "types": "./types/siemens-element-ng-sort-bar.d.ts",
-      "default": "./fesm2022/siemens-element-ng-sort-bar.mjs"
-    },
     "./split": {
       "types": "./types/siemens-element-ng-split.d.ts",
       "default": "./fesm2022/siemens-element-ng-split.mjs"
@@ -452,5 +465,6 @@
   "sideEffects": false,
   "dependencies": {
     "tslib": "^2.3.0"
-  }
+  },
+  "readme": "<p align=\"center\">\n  <a href=\"https://element.siemens.io\" target=\"_blank\">\n    <img src=\"https://raw.githubusercontent.com/siemens/element/refs/heads/main/element-logo.svg\" alt=\"Element Website\" height=\"132\" width=\"132\">\n  </a>\n</p>\n\n<h1 align=\"center\">Siemens Element</h1>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/@siemens/element-ng\">\n    <img src=\"https://img.shields.io/npm/v/@siemens/element-ng.svg?logo=npm&logoColor=fff&label=NPM+package&color=limegreen\" alt=\"Element on npm\" />\n  </a>\n  <a href=\"https://element.siemens.io/coverage/element-ng/index.html\">\n    <img src=\"https://img.shields.io/endpoint?url=https://element.siemens.io/coverage-summary.json\" alt=\"Code Coverage\">\n  </a>\n</p>\n\n<p></p>\n<p align=\"center\">\n  Siemens Element is a design system of the smart infrastructure domain\n  that implements the Siemens Design Language in Angular. It includes UI\n  components, design tools and resources, human interface guidelines, and a\n  vibrant community of contributors.\n</p>\n<p></p>\n\n<hr>\n\n## Contributing\n\nImprovements are always welcome! Feel free to log a bug,\nwrite a suggestion, or contribute code by creating a pull request.\nAll details are listed in our contribution guide.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\nThe following applies for code and documentation of the git repository,\nunless explicitly mentioned.\n\nCopyright (c) Siemens 2016 - 2026\n\nMIT, see [LICENSE](LICENSE).\n\n### Bootstrap\n\nThe source code in the folder [bootstrap](./projects/element-theme/src/styles/bootstrap/)\nis based on [Bootstrap (v5.1.3)](https://github.com/twbs/bootstrap). We changed and adapted\nthe SASS component files to our needs. At that point in time, it was under _MIT License_\nand _Copyright (c) 2011-2024 The Bootstrap Authors_.\n\n### API Goldens\n\nThe source code in the folder [tools/api-goldens](./tools/api-goldens/) is based on [dev-infra-private-build-tooling-builds](https://github.com/angular/dev-infra-private-build-tooling-builds/tree/main/bazel/api-golden).\nWe changed and adapted the code to our needs. At that point in time it was under _MIT License_ and _Copyright Google LLC_.\n"
 }

package/schematics/migration.json

@@ -1,10 +1,10 @@
 {
   "$schema": "../../../node_modules/@angular-devkit/schematics/collection-schema.json",
   "schematics": {
-    "migration-v49": {
-      "version": "49.0.0",
-      "description": "Updates Siemens element to v49",
-      "factory": "./ng-update/index#migrateToV49"
+    "migration-v51": {
+      "version": "51.0.0",
+      "description": "Updates Siemens element to v51",
+      "factory": "./ng-update/index#migrateToV51"
     }
   }
 }

package/schematics/migrations/data/class-member-replacement.js

@@ -2,22 +2,4 @@
  * Copyright (c) Siemens 2016 - 2026
  * SPDX-License-Identifier: MIT
  */
-export const CLASS_MEMBER_REPLACEMENTS_MIGRATION = [
-    {
-        module: /@(siemens|simpl)\/element-ng(\/resize-observer)?/,
-        typeNames: ['SiResponsiveContainerDirective'],
-        propertyReplacements: [
-            { property: 'isXs', replacement: '${expression}.xs()' },
-            { property: 'isSm', replacement: '${expression}.sm()' },
-            { property: 'isMd', replacement: '${expression}.md()' },
-            { property: 'isLg', replacement: '${expression}.lg()' },
-            { property: 'isXl', replacement: '${expression}.xl()' },
-            { property: 'isXxl', replacement: '${expression}.xxl()' }
-        ]
-    },
-    {
-        module: /@(siemens|simpl)\/element-ng(\/modal)?/,
-        typeNames: ['ModalOptions'],
-        propertyReplacements: [{ property: 'initialState', replacement: '${expression}.inputValues' }]
-    }
-];
+export const CLASS_MEMBER_REPLACEMENTS_MIGRATION = [];

package/schematics/migrations/data/component-property-names.js

@@ -1,25 +1 @@
-export const COMPONENT_PROPERTY_NAMES_MIGRATION = [
-    // Input name changes
-    // v48 to v49
-    {
-        module: /@(siemens|simpl)\/element-ng/,
-        elementSelector: 'si-filtered-search',
-        propertyMappings: [{ replace: 'readonly', replaceWith: 'disabled' }]
-    },
-    {
-        module: /@(siemens|simpl)\/charts-ng/,
-        elementSelector: 'si-chart-gauge',
-        propertyMappings: [
-            { replace: 'numberOfDecimals', replaceWith: ['minNumberOfDecimals', 'maxNumberOfDecimals'] }
-        ]
-    },
-    {
-        module: /@(siemens|simpl)\/element-ng(\/(info-page|unauthorized-page))?/,
-        elementSelector: 'si-unauthorized-page',
-        propertyMappings: [
-            { replace: 'heading', replaceWith: 'titleText' },
-            { replace: 'subHeading', replaceWith: 'copyText' },
-            { replace: 'description', replaceWith: 'instructions' }
-        ]
-    }
-];
+export const COMPONENT_PROPERTY_NAMES_MIGRATION = [];

package/schematics/migrations/data/element-class-changes.js

@@ -2,31 +2,4 @@
  * Copyright (c) Siemens 2016 - 2026
  * SPDX-License-Identifier: MIT
  */
-export const ELEMENT_CLASS_CHANGES_MIGRATION = [
-    // btn-circle with btn-sm should have btn-sm removed
-    {
-        requiredClasses: ['btn', 'btn-circle', 'btn-sm'],
-        removeClasses: ['btn-sm'],
-        addClasses: []
-    },
-    // btn-circle with btn-xs should migrate to btn-sm
-    {
-        requiredClasses: ['btn', 'btn-circle', 'btn-xs'],
-        removeClasses: ['btn-xs'],
-        addClasses: ['btn-sm']
-    },
-    // btn-circle without size modifier should get btn-lg
-    {
-        requiredClasses: ['btn', 'btn-circle'],
-        excludedClasses: ['btn-lg', 'btn-sm', 'btn-xs'],
-        removeClasses: [],
-        addClasses: ['btn-lg']
-    },
-    // Non-circle buttons with btn-xs should migrate to btn-sm
-    {
-        requiredClasses: ['btn', 'btn-xs'],
-        excludedClasses: ['btn-circle'],
-        removeClasses: ['btn-xs'],
-        addClasses: ['btn-sm']
-    }
-];
+export const ELEMENT_CLASS_CHANGES_MIGRATION = [];

package/schematics/migrations/data/element-migration-data.js

@@ -7,6 +7,7 @@ import { CLASS_MEMBER_REPLACEMENTS_MIGRATION } from './class-member-replacement.
 import { COMPONENT_PROPERTY_NAMES_MIGRATION } from './component-property-names.js';
 import { ELEMENT_CLASS_CHANGES_MIGRATION } from './element-class-changes.js';
 import { ELEMENT_SELECTORS_MIGRATION } from './element-selectors.js';
+import { PROVIDER_FUNCTION_REMOVALS_MIGRATION } from './provider-function-removals.js';
 import { SYMBOL_REMOVALS_MIGRATION } from './symbol-removals.js';
 import { SYMBOL_RENAMING_MIGRATION } from './symbol-renaming.js';
 export const getElementMigrationData = () => ({
@@ -15,6 +16,7 @@ export const getElementMigrationData = () => ({
     componentPropertyNameChanges: COMPONENT_PROPERTY_NAMES_MIGRATION,
     elementClassChanges: ELEMENT_CLASS_CHANGES_MIGRATION,
     elementSelectorChanges: ELEMENT_SELECTORS_MIGRATION,
+    providerFunctionRemovalChanges: PROVIDER_FUNCTION_REMOVALS_MIGRATION,
     symbolRemovalChanges: SYMBOL_REMOVALS_MIGRATION,
     symbolRenamingChanges: SYMBOL_RENAMING_MIGRATION
 });

package/schematics/migrations/data/element-selectors.js

@@ -1,11 +1 @@
-export const ELEMENT_SELECTORS_MIGRATION = [
-    // v48 to v49
-    {
-        replace: 'si-unauthorized-page',
-        replaceWith: 'si-info-page',
-        defaultAttributes: [
-            { name: 'icon', value: 'element-warning-filled' },
-            { name: 'iconColor', value: 'status-warning' }
-        ]
-    }
-];
+export const ELEMENT_SELECTORS_MIGRATION = [];

package/schematics/migrations/data/index.js

@@ -1,5 +1 @@
-/**
- * Copyright (c) Siemens 2016 - 2026
- * SPDX-License-Identifier: MIT
- */
 export { getElementMigrationData } from './element-migration-data.js';

package/schematics/migrations/data/migration-test-data.js

@@ -1,7 +1,3 @@
-/**
- * Copyright (c) Siemens 2016 - 2026
- * SPDX-License-Identifier: MIT
- */
 const SYMBOL_RENAMING_MIGRATION = [
     {
         module: /@(siemens|simpl)\/element-ng(\/icon)?/,
@@ -103,7 +99,7 @@ const ELEMENT_SELECTORS_MIGRATION = [
     { replace: 'si-icon-next', replaceWith: 'si-icon' },
     { replace: 'si-tabset-next', replaceWith: 'si-tabset' },
     { replace: 'si-tab-next', replaceWith: 'si-tab' },
-    // v48 to v49
+    // v49 to v51
     {
         replace: 'si-unauthorized-page',
         replaceWith: 'si-info-page',
@@ -175,7 +171,7 @@ const COMPONENT_PROPERTY_NAMES_MIGRATION = [
         propertyMappings: [{ replace: '(toggle)', replaceWith: '(panelToggle)' }]
     },
     // Input name changes
-    // v48 to v49
+    // v49 to v51
     {
         module: /@(siemens|simpl)\/element-ng/,
         elementSelector: 'si-filtered-search',
@@ -245,6 +241,12 @@ const ELEMENT_CLASS_CHANGES_MIGRATION = [
         addClasses: ['btn-sm']
     }
 ];
+const PROVIDER_FUNCTION_REMOVALS_MIGRATION = [
+    {
+        module: /@(siemens)\/element-ng(\/icon)?/,
+        names: ['provideIconConfig']
+    }
+];
 /**
  * Stable migration data for testing.
  * This data is frozen and used for testing to ensure test stability.
@@ -256,6 +258,7 @@ export const getElementMigrationTestData = () => ({
     componentPropertyNameChanges: COMPONENT_PROPERTY_NAMES_MIGRATION,
     elementClassChanges: ELEMENT_CLASS_CHANGES_MIGRATION,
     elementSelectorChanges: ELEMENT_SELECTORS_MIGRATION,
+    providerFunctionRemovalChanges: PROVIDER_FUNCTION_REMOVALS_MIGRATION,
     symbolRemovalChanges: SYMBOL_REMOVALS_MIGRATION,
     symbolRenamingChanges: SYMBOL_RENAMING_MIGRATION
 });

package/schematics/migrations/data/provider-function-removals.js

@@ -0,0 +1,7 @@
+export const PROVIDER_FUNCTION_REMOVALS_MIGRATION = [
+    // v49 to v51
+    {
+        module: /@(siemens|simpl)\/element-ng(\/icon)?/,
+        names: ['provideIconConfig']
+    }
+];

package/schematics/migrations/data/symbol-removals.js

@@ -1,13 +1,13 @@
 export const SYMBOL_REMOVALS_MIGRATION = [
-    // v48 to v49
+    // v49 to v51
     {
-        module: /@(siemens|simpl)\/maps-ng/,
-        elementSelector: 'si-map',
-        names: ['onResize']
+        module: /@siemens\/element-ng\/file-uploader/,
+        elementSelector: 'si-file-uploader',
+        names: ['uploadTextFileSelect']
     },
     {
-        module: /@(siemens|simpl)\/element-ng/,
-        elementSelector: 'si-landing-page',
-        names: ['registerNowIntroText']
+        module: /@siemens\/element-ng\/file-uploader/,
+        elementSelector: 'si-file-dropzone',
+        names: ['uploadTextFileSelect']
     }
 ];

package/schematics/migrations/data/symbol-renaming.js

@@ -1,48 +1 @@
-export const SYMBOL_RENAMING_MIGRATION = [
-    // v48 to v49
-    {
-        module: /@(siemens|simpl)\/dashboards-ng/,
-        symbolRenamings: [{ replace: 'CONFIG_TOKEN', replaceWith: 'SI_DASHBOARD_CONFIGURATION' }]
-    },
-    {
-        module: /@(siemens|simpl)\/element-ng(\/toast-notification)?/,
-        symbolRenamings: [{ replace: 'ToastStateName', replaceWith: 'StatusType' }],
-        toModule: '@siemens/element-ng/common'
-    },
-    {
-        module: /@(siemens|simpl)\/element-ng(\/(info-page|unauthorized-page))?/,
-        symbolRenamings: [
-            { replace: 'SiUnauthorizedPageComponent', replaceWith: 'SiInfoPageComponent' }
-        ],
-        toModule: '@siemens/element-ng/info-page'
-    },
-    {
-        module: /@siemens\/charts-ng/,
-        symbolRenamings: [
-            { replace: 'SimplChartsNgModule', replaceWith: 'SiChartsNgModule' },
-            { replace: 'SimplSeriesOption', replaceWith: 'SiSeriesOption' },
-            { replace: 'SimplLineSeriesOption', replaceWith: 'SiLineSeriesOption' },
-            { replace: 'SimplBarSeriesOption', replaceWith: 'SiBarSeriesOption' },
-            { replace: 'SimplHeatmapSeriesOption', replaceWith: 'SiHeatmapSeriesOption' },
-            { replace: 'SimplScatterSeriesOption', replaceWith: 'SiScatterSeriesOption' },
-            { replace: 'SimplCandlestickSeriesOption', replaceWith: 'SiCandlestickSeriesOption' }
-        ]
-    },
-    {
-        module: /@siemens\/live-preview/,
-        symbolRenamings: [
-            { replace: 'SimplLivePreviewRoutingModule', replaceWith: 'SiLivePreviewRoutingModule' },
-            { replace: 'SimplLivePreviewModule', replaceWith: 'SiLivePreviewModule' }
-        ]
-    },
-    {
-        module: /@siemens\/maps-ng/,
-        symbolRenamings: [{ replace: 'SimplMapsNgModule', replaceWith: 'SiMapsNgModule' }]
-    },
-    {
-        module: /@siemens\/native-charts-ng/,
-        symbolRenamings: [
-            { replace: 'SimplNativeChartsNgModule', replaceWith: 'SiNativeChartsNgModule' }
-        ]
-    }
-];
+export const SYMBOL_RENAMING_MIGRATION = [];

package/schematics/migrations/element-migration/element-migration.js

@@ -1,9 +1,5 @@
-/**
- * Copyright (c) Siemens 2016 - 2026
- * SPDX-License-Identifier: MIT
- */
 import { discoverSourceFiles } from '../../utils/index.js';
-import { applyAttributeSelectorMigration, applyElementClassMigration, applyClassMemberReplacementMigration, applyComponentPropertyNameMigration, applyElementSelectorMigration, applySymbolRemovalMigration, applySymbolRenamingMigration } from '../utilities/index.js';
+import { applyAttributeSelectorMigration, applyElementClassMigration, applyClassMemberReplacementMigration, applyComponentPropertyNameMigration, applyElementSelectorMigration, applyProviderFunctionRemovalMigration, applySymbolRemovalMigration, applySymbolRenamingMigration } from '../utilities/index.js';
 export const elementMigrationRule = (options, migrationData) => {
     return async (tree, context) => {
         for await (const discoveredSourceFile of discoverSourceFiles(tree, context, options.path)) {
@@ -16,7 +12,7 @@ export const elementMigrationRule = (options, migrationData) => {
                 discoveredSourceFile,
                 recorder
             };
-            const { componentPropertyNameChanges, symbolRenamingChanges, attributeSelectorChanges, elementSelectorChanges, symbolRemovalChanges, elementClassChanges, classMemberReplacementChanges } = migrationData;
+            const { componentPropertyNameChanges, symbolRenamingChanges, attributeSelectorChanges, elementSelectorChanges, symbolRemovalChanges, elementClassChanges, classMemberReplacementChanges, providerFunctionRemovalChanges } = migrationData;
             applyComponentPropertyNameMigration(migrationContext, componentPropertyNameChanges);
             applySymbolRenamingMigration(migrationContext, symbolRenamingChanges);
             applyAttributeSelectorMigration(migrationContext, attributeSelectorChanges);
@@ -24,6 +20,7 @@ export const elementMigrationRule = (options, migrationData) => {
             applySymbolRemovalMigration(migrationContext, symbolRemovalChanges);
             applyElementClassMigration(migrationContext, elementClassChanges);
             applyClassMemberReplacementMigration(migrationContext, classMemberReplacementChanges);
+            applyProviderFunctionRemovalMigration(migrationContext, providerFunctionRemovalChanges);
             tree.commitUpdate(recorder);
         }
         return tree;

package/schematics/migrations/utilities/import-removal.js

@@ -0,0 +1,39 @@
+/**
+ * Copyright (c) Siemens 2016 - 2026
+ * SPDX-License-Identifier: MIT
+ */
+import ts from 'typescript';
+/**
+ * Builds an edit that removes the given named import specifiers from an import
+ * declaration.
+ *
+ * If no specifiers remain after the removal, the whole import declaration is removed
+ * (including its trailing newline). Otherwise the import is rebuilt without the removed
+ * specifiers while preserving the remaining specifiers and their aliases.
+ */
+export const removeImportSpecifiers = (sourceFile, importDeclaration, specifiers) => {
+    const namedBindings = importDeclaration.importClause?.namedBindings;
+    const remainingElements = namedBindings && ts.isNamedImports(namedBindings)
+        ? namedBindings.elements.filter(element => !specifiers.includes(element))
+        : [];
+    if (remainingElements.length === 0) {
+        // No named binding remains: remove the whole import declaration including the
+        // trailing newline so no empty line is left behind.
+        const start = importDeclaration.getStart(sourceFile);
+        let end = importDeclaration.getEnd();
+        const fullText = sourceFile.getFullText();
+        if (fullText[end] === '\r') {
+            end++;
+        }
+        if (fullText[end] === '\n') {
+            end++;
+        }
+        return { start, width: end - start };
+    }
+    const updatedImport = ts.factory.createImportDeclaration(importDeclaration.modifiers, ts.factory.createImportClause(importDeclaration.importClause.isTypeOnly, importDeclaration.importClause.name, ts.factory.createNamedImports(remainingElements.map(element => ts.factory.createImportSpecifier(element.isTypeOnly, element.propertyName, element.name)))), importDeclaration.moduleSpecifier, importDeclaration.attributes);
+    return {
+        start: importDeclaration.getStart(sourceFile),
+        width: importDeclaration.getWidth(sourceFile),
+        newNode: updatedImport
+    };
+};

package/schematics/migrations/utilities/index.js

@@ -9,4 +9,6 @@ export * from './component-property-name.migration.js';
 export * from './element-selector.migration.js';
 export * from './symbol-renaming.migration.js';
 export * from './symbol-removal.migration.js';
+export * from './provider-function-removal.migration.js';
+export * from './import-removal.js';
 export * from './migration.interface.js';

package/schematics/migrations/utilities/provider-function-removal.migration.js

@@ -0,0 +1,116 @@
+/**
+ * Copyright (c) Siemens 2016 - 2026
+ * SPDX-License-Identifier: MIT
+ */
+import ts from 'typescript';
+import { getImportSpecifiers } from '../../utils/index.js';
+import { removeImportSpecifiers } from './import-removal.js';
+export const applyProviderFunctionRemovalMigration = (context, changes) => {
+    const { discoveredSourceFile, recorder } = context;
+    if (!changes?.length) {
+        return;
+    }
+    const { sourceFile } = discoveredSourceFile;
+    const edits = [];
+    for (const change of changes) {
+        const importSpecifiers = getImportSpecifiers(sourceFile, change.module, change.names);
+        if (!importSpecifiers.length) {
+            continue;
+        }
+        // Local names as they are used in the file (respecting import aliases).
+        const localNames = new Set(importSpecifiers.map(specifier => specifier.name.text));
+        const removedCall = collectArrayElementRemovals(sourceFile, localNames, edits);
+        // Only remove the import if at least one call was actually removed from a provider array.
+        if (removedCall) {
+            // Group the matched specifiers by their import declaration so a single edit is
+            // produced per declaration, even when multiple names are removed at once.
+            const specifiersByImport = new Map();
+            for (const specifier of importSpecifiers) {
+                const importDeclaration = specifier.parent.parent.parent;
+                if (!ts.isImportDeclaration(importDeclaration)) {
+                    continue;
+                }
+                const existing = specifiersByImport.get(importDeclaration) ?? [];
+                existing.push(specifier);
+                specifiersByImport.set(importDeclaration, existing);
+            }
+            for (const [importDeclaration, specifiers] of specifiersByImport) {
+                edits.push(removeImportSpecifiers(sourceFile, importDeclaration, specifiers));
+            }
+        }
+    }
+    if (!edits.length) {
+        return;
+    }
+    const printer = ts.createPrinter();
+    // Apply edits from bottom to top so earlier offsets stay valid.
+    edits.sort((a, b) => b.start - a.start);
+    for (const edit of edits) {
+        recorder.remove(edit.start, edit.width);
+        if (edit.newNode) {
+            recorder.insertLeft(edit.start, printer.printNode(ts.EmitHint.Unspecified, edit.newNode, sourceFile));
+        }
+    }
+};
+/**
+ * Finds all call expressions of the given local names that appear as direct elements of
+ * an array literal (e.g. a `providers: [...]` array) and records removal edits covering
+ * the call together with its adjacent comma and surrounding whitespace.
+ *
+ * @returns `true` if at least one call was scheduled for removal.
+ */
+const collectArrayElementRemovals = (sourceFile, localNames, edits) => {
+    let removed = false;
+    const visit = (node) => {
+        if (ts.isCallExpression(node) &&
+            ts.isIdentifier(node.expression) &&
+            localNames.has(node.expression.text) &&
+            ts.isArrayLiteralExpression(node.parent)) {
+            edits.push(getArrayElementRemovalRange(sourceFile, node.parent, node));
+            removed = true;
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return removed;
+};
+/**
+ * Computes the removal range for a single element of an array literal so that the
+ * remaining array stays syntactically valid (no dangling commas).
+ */
+const getArrayElementRemovalRange = (sourceFile, array, element) => {
+    const elements = array.elements;
+    const index = elements.indexOf(element);
+    const text = sourceFile.getFullText();
+    const elementStart = element.getStart(sourceFile);
+    const elementEnd = element.getEnd();
+    const isLast = index === elements.length - 1;
+    if (!isLast) {
+        // Remove up to (and including) the comma before the next element, plus the
+        // whitespace that follows it.
+        let end = elementEnd;
+        while (end < text.length && text[end] !== ',') {
+            end++;
+        }
+        // Skip the comma itself.
+        if (text[end] === ',') {
+            end++;
+        }
+        // Skip whitespace before the next element.
+        while (end < text.length && /\s/.test(text[end])) {
+            end++;
+        }
+        return { start: elementStart, width: end - elementStart };
+    }
+    // Last element: also remove the comma and whitespace that precede it, so the previous
+    // element does not end up with a trailing comma.
+    let start = elementStart;
+    let cursor = elementStart - 1;
+    while (cursor >= 0 && /\s/.test(text[cursor])) {
+        cursor--;
+    }
+    if (cursor >= 0 && text[cursor] === ',') {
+        start = cursor;
+    }
+    return { start, width: elementEnd - start };
+};

package/schematics/ng-update/index.js

@@ -2,4 +2,4 @@
  * Copyright (c) Siemens 2016 - 2026
  * SPDX-License-Identifier: MIT
  */
-export { migrateToV49 } from './migrate-to-v49.js';
+export { migrateToV51 } from './migrate-to-v51.js';