@siemens/element-ng 48.10.0 → 49.0.0-rc.2

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

@@ -1,230 +0,0 @@
-/**
- * Copyright (c) Siemens 2016 - 2025
- * SPDX-License-Identifier: MIT
- */
-import { chain } from '@angular-devkit/schematics';
-import { getDecoratorMetadata, getMetadataField } from '@schematics/angular/utility/ast-utils';
-import * as ts from 'typescript';
-import { getImportNodes, getSymbols, discoverSourceFiles } from '../utils/index.js';
-import { CHARTS_NG_MAPPINGS, DASHBOARDS_NG_MAPPINGS, ELEMENT_NG_MAPPINGS, ELEMENT_TRANSLATE_NG_MAPPINGS, MAPS_NG_MAPPINGS, NATIVE_CHARTS_NG_MAPPINGS, SIMPL_ELEMENT_NG_MODULES } from './mappings/index.js';
-export const tsImportMigration = (_options) => {
-    return (tree, context) => {
-        context.logger.info('🚀 Starting Simpl to Siemens migration...');
-        return tsImportMigrationRule(_options)(tree, context);
-    };
-};
-/**
- * Creates a migration rule that updates import statements in TypeScript files.
- *
- * This rule discovers source files, analyzes their import statements, and applies
- * necessary transformations to migrate imports according to the specified options.
- * It processes each file individually and chains all the resulting rules together.
- *
- * @param _options - Configuration options for the migration process
- * @returns A Rule function that can be executed by Angular Schematics
- *
- * @example
- * ```typescript
- * const migrationRule = tsImportMigrationRule({ path: 'some-path' });
- * ```
- */
-export const tsImportMigrationRule = (_options) => {
-    return async (tree, context) => {
-        const rules = [];
-        context.logger.info('📦 Migrating TypeScript imports...');
-        const sourceFiles = await discoverSourceFiles(tree, context, _options.path);
-        for (const filePath of sourceFiles) {
-            const migrations = collectMigrationImports(filePath, tree, context);
-            const { imports, toRemoveImports, hasSimplElementNgModuleImport } = migrations;
-            if (imports.size === 0 &&
-                toRemoveImports.length === 0 &&
-                hasSimplElementNgModuleImport === false) {
-                continue;
-            }
-            const rule = rewriteImportsInFile(filePath, migrations);
-            rules.push(rule);
-        }
-        return chain([...rules]);
-    };
-};
-/**
- * Adds a symbol to the imports map, avoiding duplicates
- */
-const addSymbolToImports = (imports, importPath, symbolName) => {
-    const existingSymbols = imports.get(importPath);
-    if (!existingSymbols) {
-        imports.set(importPath, [symbolName]);
-    }
-    else if (!existingSymbols.includes(symbolName)) {
-        existingSymbols.push(symbolName);
-    }
-};
-const collectMigrationImports = (filePath, tree, _context) => {
-    const content = tree.read(filePath);
-    const imports = new Map();
-    let hasSimplElementNgModuleImport = false;
-    if (!content) {
-        return {
-            imports,
-            toRemoveImports: [],
-            hasSimplElementNgModuleImport
-        };
-    }
-    const simplImports = getImportNodes(filePath, content.toString(), '@simpl/');
-    const toRemoveImports = [];
-    for (const node of simplImports) {
-        const symbols = getSymbols(node);
-        const importPath = node.moduleSpecifier.getText().replace(/['"]/g, '');
-        let shouldRemoveImport = false;
-        for (const symbol of symbols) {
-            const symbolName = symbol.name.getText();
-            if (symbolName === 'SimplElementNgModule') {
-                hasSimplElementNgModuleImport = true;
-                for (const moduleName of SIMPL_ELEMENT_NG_MODULES) {
-                    const newImportPath = findComponentImportPath(moduleName, '@simpl/element-ng');
-                    if (!newImportPath) {
-                        continue;
-                    }
-                    shouldRemoveImport = true;
-                    addSymbolToImports(imports, newImportPath, moduleName);
-                }
-            }
-            else {
-                const newImportPath = findComponentImportPath(symbolName, importPath);
-                if (!newImportPath) {
-                    continue;
-                }
-                shouldRemoveImport = true;
-                addSymbolToImports(imports, newImportPath, symbolName);
-            }
-        }
-        if (shouldRemoveImport) {
-            toRemoveImports.push(node);
-        }
-    }
-    return { imports, toRemoveImports, hasSimplElementNgModuleImport };
-};
-const rewriteImportsInFile = (filePath, migrations) => {
-    return (tree) => {
-        const recorder = tree.beginUpdate(filePath);
-        const insertPosition = migrations.toRemoveImports.at(0)?.getFullStart() ?? 0;
-        const content = tree.read(filePath);
-        if (!content) {
-            return tree;
-        }
-        const sourceFile = ts.createSourceFile(filePath, content.toString(), ts.ScriptTarget.Latest, true);
-        // Remove old imports
-        removeOldImports(recorder, migrations.toRemoveImports);
-        // Add new imports
-        addNewImports(recorder, migrations.imports, insertPosition, sourceFile);
-        // Update NgModule/Component imports array if needed
-        if (migrations.hasSimplElementNgModuleImport) {
-            updateDecoratorImports(recorder, sourceFile);
-        }
-        tree.commitUpdate(recorder);
-        return tree;
-    };
-};
-const updateDecoratorImports = (recorder, sourceFile) => {
-    const decoratorNames = ['NgModule', 'Component'];
-    let decoratorNode;
-    // Try to find NgModule or Component decorator
-    for (const decoratorName of decoratorNames) {
-        const nodes = getDecoratorMetadata(sourceFile, decoratorName, '@angular/core');
-        if (nodes.length > 0) {
-            decoratorNode = nodes[0];
-            break;
-        }
-    }
-    if (!decoratorNode || !ts.isObjectLiteralExpression(decoratorNode)) {
-        return;
-    }
-    for (const metaDataField of ['imports', 'exports']) {
-        const matchingProperties = getMetadataField(decoratorNode, metaDataField);
-        const propertyAssignment = matchingProperties[0];
-        if (!propertyAssignment ||
-            !ts.isPropertyAssignment(propertyAssignment) ||
-            !ts.isArrayLiteralExpression(propertyAssignment.initializer)) {
-            continue;
-        }
-        const elements = propertyAssignment.initializer.elements;
-        if (elements.find(e => e.getText() === 'SimplElementNgModule') === undefined) {
-            // No SimplElementNgModule found, nothing to do
-            continue;
-        }
-        // Filter out SimplElementNgModule and get existing modules
-        const existingModules = elements
-            .filter(e => e.getText() !== 'SimplElementNgModule')
-            .map(e => e.getText());
-        const existingModulesSet = new Set(existingModules);
-        // Only add modules that don't already exist
-        const newModulesToAdd = SIMPL_ELEMENT_NG_MODULES.filter(m => !existingModulesSet.has(m));
-        // Combine existing (without SimplElementNgModule) + new modules
-        const allModules = [...existingModules, ...newModulesToAdd];
-        // Remove existing imports array
-        recorder.remove(propertyAssignment.getFullStart(), propertyAssignment.getFullWidth());
-        // Create and insert the updated property assignment
-        const printer = ts.createPrinter();
-        const newNode = ts.factory.createArrayLiteralExpression(allModules.map(m => ts.factory.createIdentifier(m)), true);
-        const newProperty = ts.factory.updatePropertyAssignment(propertyAssignment, propertyAssignment.name, newNode);
-        const propertyText = printer.printNode(ts.EmitHint.Unspecified, newProperty, sourceFile);
-        // Had to add extra indentation to align properly
-        recorder.insertLeft(propertyAssignment.getStart(), `\n  ` + propertyText);
-    }
-};
-/**
- * Removes old import declarations from the file
- */
-const removeOldImports = (recorder, toRemoveImports) => {
-    for (const importDecl of toRemoveImports) {
-        recorder.remove(importDecl.getFullStart(), importDecl.getFullWidth());
-    }
-};
-/**
- * Adds new import declarations to the file
- */
-const addNewImports = (recorder, imports, insertPosition, sourceFile) => {
-    const sortedImportPaths = Array.from(imports.keys()).sort((a, b) => a.localeCompare(b));
-    const printer = ts.createPrinter();
-    let counter = 0;
-    for (const path of sortedImportPaths) {
-        const symbols = imports.get(path);
-        const sortedSymbols = symbols.sort((a, b) => a.localeCompare(b));
-        const importDeclaration = createImportDeclaration(path, sortedSymbols);
-        const importStatement = printer.printNode(ts.EmitHint.Unspecified, importDeclaration, sourceFile);
-        const prefix = insertPosition === 0 && counter === 0 ? '' : '\n';
-        recorder.insertLeft(insertPosition, `${prefix}${importStatement}`);
-        counter++;
-    }
-};
-/**
- * Creates import declarations using TypeScript AST
- */
-const createImportDeclaration = (importPath, symbols) => {
-    return ts.factory.createImportDeclaration(undefined, ts.factory.createImportClause(false, undefined, ts.factory.createNamedImports(symbols.map(symbol => ts.factory.createImportSpecifier(false, undefined, ts.factory.createIdentifier(symbol))))), ts.factory.createStringLiteral(importPath, true));
-};
-const findComponentImportPath = (symbolName, moduleSpecifier) => {
-    const [, project, subPath] = moduleSpecifier.split('/');
-    switch (project) {
-        case 'element-ng': {
-            // Special case for MenuItem from menu package as it has conflicting name with MenuItem from common package
-            if (symbolName === 'MenuItem' && subPath === 'menu') {
-                return '@siemens/element-ng/menu';
-            }
-            // Added the OR condition to check in ELEMENT_TRANSLATE_NG_MAPPINGS as well because translation are also part of `@simpl/element-ng` imports
-            return ELEMENT_NG_MAPPINGS[symbolName] || ELEMENT_TRANSLATE_NG_MAPPINGS[symbolName];
-        }
-        case 'maps-ng':
-            return MAPS_NG_MAPPINGS[symbolName];
-        case 'dashboards-ng':
-            return DASHBOARDS_NG_MAPPINGS[symbolName];
-        case 'charts-ng':
-            return CHARTS_NG_MAPPINGS[symbolName];
-        case 'native-charts-ng':
-            return NATIVE_CHARTS_NG_MAPPINGS[symbolName];
-        case 'element-translate-ng':
-            return ELEMENT_TRANSLATE_NG_MAPPINGS[symbolName];
-        default:
-            return undefined;
-    }
-};

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

@@ -1,71 +0,0 @@
-/**
- * Copyright (c) Siemens 2016 - 2025
- * SPDX-License-Identifier: MIT
- */
-export const CHARTS_NG_MAPPINGS = {
-    'AxisData': '@siemens/charts-ng',
-    'AxisPointerEvent': '@siemens/charts-ng',
-    'AxisType': '@siemens/charts-ng',
-    'BarSeriesData': '@siemens/charts-ng',
-    'CandlestickSeriesData': '@siemens/charts-ng',
-    'CartesianChartData': '@siemens/charts-ng',
-    'CartesianChartSeries': '@siemens/charts-ng',
-    'CartesianDataNullable': '@siemens/charts-ng',
-    'ChartXAxis': '@siemens/charts-ng',
-    'ChartYAxis': '@siemens/charts-ng',
-    'CircleChartData': '@siemens/charts-ng',
-    'CircleChartSeries': '@siemens/charts-ng',
-    'CircleValueUpdate': '@siemens/charts-ng',
-    'CustomLegend': '@siemens/charts-ng',
-    'CustomLegendItem': '@siemens/charts-ng',
-    'CustomLegendMultiLineInfo': '@siemens/charts-ng',
-    'CustomLegendProps': '@siemens/charts-ng',
-    'DataZoomEvent': '@siemens/charts-ng',
-    'DataZoomRange': '@siemens/charts-ng',
-    'EChartOption': '@siemens/charts-ng',
-    'echarts': '@siemens/charts-ng',
-    'EChartSeries': '@siemens/charts-ng',
-    'EChartSeriesOption': '@siemens/charts-ng',
-    'FilterMode': '@siemens/charts-ng',
-    'GaugeChartSeries': '@siemens/charts-ng',
-    'GridRectCoordinate': '@siemens/charts-ng',
-    'HeatmapSeriesData': '@siemens/charts-ng',
-    'LegendItem': '@siemens/charts-ng',
-    'LineColor': '@siemens/charts-ng',
-    'LineSeriesData': '@siemens/charts-ng',
-    'LineStepType': '@siemens/charts-ng',
-    'LineType': '@siemens/charts-ng',
-    'MarkAreaData': '@siemens/charts-ng',
-    'MarkLineData': '@siemens/charts-ng',
-    'MarkPointData': '@siemens/charts-ng',
-    'ProgressBarChartSeries': '@siemens/charts-ng',
-    'ProgressBarValueUpdate': '@siemens/charts-ng',
-    'ProgressChartSeries': '@siemens/charts-ng',
-    'ProgressValueUpdate': '@siemens/charts-ng',
-    'ScatterSeriesData': '@siemens/charts-ng',
-    'SelectedLegendItem': '@siemens/charts-ng',
-    'SeriesSelectionState': '@siemens/charts-ng',
-    'SeriesUpdate': '@siemens/charts-ng',
-    'SiBarSeriesOption': '@siemens/charts-ng',
-    'SiCandlestickSeriesOption': '@siemens/charts-ng',
-    'SiChartCartesianComponent': '@siemens/charts-ng',
-    'SiChartCircleComponent': '@siemens/charts-ng',
-    'SiChartComponent': '@siemens/charts-ng',
-    'SiChartGaugeComponent': '@siemens/charts-ng',
-    'SiChartProgressBarComponent': '@siemens/charts-ng',
-    'SiChartProgressComponent': '@siemens/charts-ng',
-    'SiChartSankeyComponent': '@siemens/charts-ng',
-    'SiChartsNgModule': '@siemens/charts-ng',
-    'SiChartSunburstComponent': '@siemens/charts-ng',
-    'SiCustomLegendComponent': '@siemens/charts-ng',
-    'SiHeatmapSeriesOption': '@siemens/charts-ng',
-    'SiLineSeriesOption': '@siemens/charts-ng',
-    'SiScatterSeriesOption': '@siemens/charts-ng',
-    'SiSeriesOption': '@siemens/charts-ng',
-    'SubchartGrid': '@siemens/charts-ng',
-    'themeElement': '@siemens/charts-ng',
-    'themeSupport': '@siemens/charts-ng',
-    'XAxisPosition': '@siemens/charts-ng',
-    'YAxisPosition': '@siemens/charts-ng',
-    'SimplChartsNgModule': '@siemens/charts-ng'
-};

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

@@ -1,54 +0,0 @@
-/**
- * Copyright (c) Siemens 2016 - 2025
- * SPDX-License-Identifier: MIT
- */
-export const DASHBOARDS_NG_MAPPINGS = {
-    'CONFIG_TOKEN': '@siemens/dashboards-ng',
-    'Config': '@siemens/dashboards-ng',
-    'createWidgetConfig': '@siemens/dashboards-ng',
-    'DashboardToolbarItem': '@siemens/dashboards-ng',
-    'DashboardToolbarItemAction': '@siemens/dashboards-ng',
-    'DashboardToolbarItemLink': '@siemens/dashboards-ng',
-    'DashboardToolbarItemRouterLink': '@siemens/dashboards-ng',
-    'DEFAULT_GRIDSTACK_OPTIONS': '@siemens/dashboards-ng',
-    'DEFAULT_WIDGET_STORAGE_TOKEN': '@siemens/dashboards-ng',
-    'FederatedModule': '@siemens/dashboards-ng',
-    'GridConfig': '@siemens/dashboards-ng',
-    'LoadRemoteModuleEsmOptions': '@siemens/dashboards-ng',
-    'LoadRemoteModuleManifestOptions': '@siemens/dashboards-ng',
-    'LoadRemoteModuleOptions': '@siemens/dashboards-ng',
-    'LoadRemoteModuleScriptOptions': '@siemens/dashboards-ng',
-    'NEW_WIDGET_PREFIX': '@siemens/dashboards-ng',
-    'ObjectFit': '@siemens/dashboards-ng',
-    'provideSiDashboardsTranslatableOverrides': '@siemens/dashboards-ng/translate',
-    'registerModuleFederatedWidgetLoader': '@siemens/dashboards-ng/module-federation',
-    'SetupComponentFn': '@siemens/dashboards-ng',
-    'setupWidgetEditor': '@siemens/dashboards-ng',
-    'setupWidgetInstance': '@siemens/dashboards-ng',
-    'SI_DASHBOARD_CONFIGURATION': '@siemens/dashboards-ng',
-    'SI_WIDGET_STORE': '@siemens/dashboards-ng',
-    'SiD': '@siemens/dashboards-ng',
-    'SiDashboardsNgModule': '@siemens/dashboards-ng',
-    'SiDefaultWidgetStorage': '@siemens/dashboards-ng',
-    'SiFlexibleDashboardComponent': '@siemens/dashboards-ng',
-    'SiGridComponent': '@siemens/dashboards-ng',
-    'SiWidgetCatalogComponent': '@siemens/dashboards-ng',
-    'SiWidgetInstanceEditorDialogComponent': '@siemens/dashboards-ng',
-    'STORAGE_KEY': '@siemens/dashboards-ng',
-    'WebComponent': '@siemens/dashboards-ng',
-    'Widget': '@siemens/dashboards-ng',
-    'WidgetComponentFactory': '@siemens/dashboards-ng',
-    'WidgetComponentTypeFactory': '@siemens/dashboards-ng',
-    'WidgetConfig': '@siemens/dashboards-ng',
-    'WidgetConfigEvent': '@siemens/dashboards-ng',
-    'WidgetConfigStatus': '@siemens/dashboards-ng',
-    'widgetFactoryRegistry': '@siemens/dashboards-ng',
-    'WidgetImage': '@siemens/dashboards-ng',
-    'WidgetInstance': '@siemens/dashboards-ng',
-    'WidgetInstanceEditor': '@siemens/dashboards-ng',
-    'WidgetInstanceEditorWizard': '@siemens/dashboards-ng',
-    'WidgetInstanceEditorWizardState': '@siemens/dashboards-ng',
-    'WidgetPositionConfig': '@siemens/dashboards-ng',
-    'SimplDashboardsNgModule': '@siemens/dashboards-ng',
-    'SiWidgetStorage': '@siemens/dashboards-ng'
-};