@unisphere/nx 4.4.2 → 4.5.0

package/dist/generators/add-application/add-application.js

@@ -77,8 +77,8 @@ async function addApplicationGenerator(tree, options) {
     // Extract environment variables
     const widgetName = unisphereConfig.name;
     let applicationName = options.name;
-    if (isPlayground && !options.name.endsWith('-dev')) {
-        applicationName += '-dev';
+    if (isPlayground && !options.name.endsWith('-playground')) {
+        applicationName += '-playground';
     }
     const applicationNameAsLowerDashCase = (0, devkit_1.names)(applicationName).fileName;
     const typesPackageInfo = (0, utils_1.findTypesOrCorePackageInfo)(tree);

package/dist/generators/change-application-scope/change-application-scope.d.ts

@@ -0,0 +1,5 @@
+import { Tree } from '@nx/devkit';
+import { ChangeApplicationScopeGeneratorSchema } from './schema';
+export declare function changeApplicationScopeGenerator(tree: Tree, options: ChangeApplicationScopeGeneratorSchema): Promise<void>;
+export default changeApplicationScopeGenerator;
+//# sourceMappingURL=change-application-scope.d.ts.map

package/dist/generators/change-application-scope/change-application-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-application-scope.d.ts","sourceRoot":"","sources":["../../../src/generators/change-application-scope/change-application-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EAKL,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,qCAAqC,EAAE,MAAM,UAAU,CAAC;AAqRjE,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,qCAAqC,iBA6E/C;AAED,eAAe,+BAA+B,CAAC"}

package/dist/generators/change-application-scope/change-application-scope.js

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.changeApplicationScopeGenerator = changeApplicationScopeGenerator;
+const devkit_1 = require("@nx/devkit");
+const generators_1 = require("@nx/workspace/generators");
+const utils_1 = require("../utils");
+function validateOptions(options) {
+    if (!options.applicationName || options.applicationName.trim() === '') {
+        throw new Error(`Missing required option: 'applicationName'\n` +
+            `  Description: The name of the application to move\n` +
+            `  Type: string\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Example: nx g @unisphere/nx:change-application-scope --applicationName=my-app --newScope=local`);
+    }
+    const namePattern = /^[a-zA-Z][a-zA-Z0-9\-\s]*$/;
+    if (!namePattern.test(options.applicationName)) {
+        throw new Error(`Invalid value '${options.applicationName}' for option 'applicationName'\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Received: ${options.applicationName}`);
+    }
+    if (!options.newScope) {
+        throw new Error(`Missing required option: 'newScope'\n` +
+            `  Description: The target subdirectory for the application\n` +
+            `  Allowed values: local, server\n` +
+            `  Example: nx g @unisphere/nx:change-application-scope --applicationName=my-app --newScope=local`);
+    }
+    const allowedScopes = ['local', 'server'];
+    if (!allowedScopes.includes(options.newScope)) {
+        throw new Error(`Invalid value '${options.newScope}' for option 'newScope'\n` +
+            `  Allowed values: ${allowedScopes.join(', ')}\n` +
+            `  Received: ${options.newScope}`);
+    }
+}
+function findApplicationInUnisphere(tree, applicationName) {
+    const unisphereConfig = (0, devkit_1.readJson)(tree, '.unisphere');
+    const normalizedName = (0, devkit_1.names)(applicationName).fileName;
+    if (!unisphereConfig.elements?.applications) {
+        throw new Error('No applications found in .unisphere configuration.\n' +
+            'Cannot find application to change scope.');
+    }
+    const appConfig = unisphereConfig.elements.applications[normalizedName];
+    if (!appConfig) {
+        const available = Object.keys(unisphereConfig.elements.applications);
+        throw new Error(`Application "${normalizedName}" not found in .unisphere configuration.\n` +
+            'Available applications: ' + (available.length > 0 ? available.join(', ') : '(none)'));
+    }
+    const sourceRoot = appConfig.sourceRoot;
+    if (!sourceRoot) {
+        throw new Error(`Application "${normalizedName}" exists but has no sourceRoot configured in .unisphere`);
+    }
+    if (!tree.exists(sourceRoot)) {
+        throw new Error(`Application directory not found at ${sourceRoot}.\n` +
+            'The .unisphere configuration references an application that does not exist.');
+    }
+    const packageJsonPath = `${sourceRoot}/package.json`;
+    if (!tree.exists(packageJsonPath)) {
+        throw new Error(`package.json not found at ${packageJsonPath}.\n` +
+            'The application directory exists but is missing package.json.');
+    }
+    const packageJson = (0, devkit_1.readJson)(tree, packageJsonPath);
+    const subdirectory = (0, utils_1.extractApplicationSubdirectory)(sourceRoot);
+    if (!subdirectory) {
+        throw new Error(`Application "${normalizedName}" has an unexpected sourceRoot format: ${sourceRoot}\n` +
+            'Expected format: unisphere/applications/{local|server}/{name}');
+    }
+    return {
+        packageJsonName: packageJson.name,
+        sourceRoot,
+        subdirectory,
+    };
+}
+function validateDifferentScope(currentSubdirectory, newScope) {
+    if (currentSubdirectory === newScope) {
+        throw new Error(`Application is already in the "${newScope}" scope.\n` +
+            'No changes needed.');
+    }
+}
+function validateNoCollision(tree, applicationName, newSubdirectory) {
+    const normalizedName = (0, devkit_1.names)(applicationName).fileName;
+    const newPath = `unisphere/applications/${newSubdirectory}/${normalizedName}`;
+    if (tree.exists(newPath)) {
+        throw new Error(`Directory already exists at ${newPath}.\n` +
+            'Please choose a different scope or remove the existing directory first.');
+    }
+}
+function updateUnisphereConfiguration(tree, applicationName, newSourceRoot) {
+    const unisphereConfig = (0, devkit_1.readJson)(tree, '.unisphere');
+    const normalizedName = (0, devkit_1.names)(applicationName).fileName;
+    const oldAppConfig = unisphereConfig.elements.applications[normalizedName];
+    unisphereConfig.elements.applications[normalizedName] = {
+        ...oldAppConfig,
+        sourceRoot: newSourceRoot,
+    };
+    (0, devkit_1.writeJson)(tree, '.unisphere', unisphereConfig);
+    devkit_1.logger.info(`✅ Updated .unisphere configuration`);
+}
+function updatePackageLock(tree, oldPath, newPath) {
+    const packageLockPath = 'package-lock.json';
+    if (!tree.exists(packageLockPath)) {
+        return;
+    }
+    const packageLock = (0, devkit_1.readJson)(tree, packageLockPath);
+    let updated = false;
+    if (packageLock.packages) {
+        const packagesEntries = Object.entries(packageLock.packages);
+        const newPackages = {};
+        for (const [key, value] of packagesEntries) {
+            if (key === oldPath) {
+                newPackages[newPath] = value;
+                updated = true;
+            }
+            else {
+                newPackages[key] = value;
+            }
+        }
+        packageLock.packages = newPackages;
+    }
+    if (packageLock.packages) {
+        for (const [, value] of Object.entries(packageLock.packages)) {
+            if (value && typeof value === 'object' && 'resolved' in value) {
+                const pkg = value;
+                if (pkg.resolved === oldPath) {
+                    pkg.resolved = newPath;
+                    updated = true;
+                }
+            }
+        }
+    }
+    if (updated) {
+        (0, devkit_1.writeJson)(tree, packageLockPath, packageLock);
+        devkit_1.logger.info(`✅ Updated package-lock.json path keys`);
+    }
+}
+function updateProjectJson(tree, newPath, oldPath) {
+    const projectJsonPath = `${newPath}/project.json`;
+    if (!tree.exists(projectJsonPath)) {
+        return;
+    }
+    let content = tree.read(projectJsonPath, 'utf-8');
+    if (!content) {
+        return;
+    }
+    if (content.includes(oldPath)) {
+        content = content.replace(new RegExp(escapeRegExp(oldPath), 'g'), newPath);
+        tree.write(projectJsonPath, content);
+        devkit_1.logger.info(`✅ Updated project.json paths`);
+    }
+}
+function updateWebpackConfig(tree, newPath, oldPath) {
+    const webpackConfigPath = `${newPath}/webpack.config.js`;
+    if (!tree.exists(webpackConfigPath)) {
+        return;
+    }
+    let content = tree.read(webpackConfigPath, 'utf-8');
+    if (!content) {
+        return;
+    }
+    if (content.includes(oldPath)) {
+        content = content.replace(new RegExp(escapeRegExp(oldPath), 'g'), newPath);
+        tree.write(webpackConfigPath, content);
+        devkit_1.logger.info(`✅ Updated webpack.config.js references`);
+    }
+}
+function updateReadme(tree, newPath, oldPath) {
+    const readmePath = `${newPath}/README.md`;
+    if (!tree.exists(readmePath)) {
+        return;
+    }
+    let content = tree.read(readmePath, 'utf-8');
+    if (!content) {
+        return;
+    }
+    if (content.includes(oldPath)) {
+        content = content.replace(new RegExp(escapeRegExp(oldPath), 'g'), newPath);
+        tree.write(readmePath, content);
+        devkit_1.logger.info(`✅ Updated README.md`);
+    }
+}
+function escapeRegExp(string) {
+    return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+async function changeApplicationScopeGenerator(tree, options) {
+    validateOptions(options);
+    devkit_1.logger.info('');
+    devkit_1.logger.info('🔄 Starting application scope change...');
+    devkit_1.logger.info('');
+    (0, utils_1.validateUnisphereConfig)(tree);
+    const normalizedName = (0, devkit_1.names)(options.applicationName).fileName;
+    const appInfo = findApplicationInUnisphere(tree, normalizedName);
+    devkit_1.logger.info(`📦 Application: ${normalizedName}`);
+    devkit_1.logger.info(`📁 Current location: ${appInfo.sourceRoot} (${appInfo.subdirectory}/)`);
+    validateDifferentScope(appInfo.subdirectory, options.newScope);
+    const newPath = `unisphere/applications/${options.newScope}/${normalizedName}`;
+    validateNoCollision(tree, normalizedName, options.newScope);
+    const nxProjectName = `unisphere-application-${normalizedName}`;
+    devkit_1.logger.info(`📁 Target location: ${newPath} (${options.newScope}/)`);
+    devkit_1.logger.info('');
+    devkit_1.logger.info('🔧 Running Nx move generator...');
+    try {
+        await (0, generators_1.moveGenerator)(tree, {
+            projectName: nxProjectName,
+            destination: newPath,
+            newProjectName: nxProjectName,
+            importPath: appInfo.packageJsonName,
+            updateImportPath: true,
+            skipFormat: false,
+        });
+        devkit_1.logger.info(`✅ Nx moved project and updated imports`);
+    }
+    catch (error) {
+        devkit_1.logger.error(`❌ Failed to move project with Nx: ${error}`);
+        throw error;
+    }
+    devkit_1.logger.info('');
+    devkit_1.logger.info('🧹 Performing Unisphere-specific cleanup...');
+    updateUnisphereConfiguration(tree, normalizedName, newPath);
+    updatePackageLock(tree, appInfo.sourceRoot, newPath);
+    updateProjectJson(tree, newPath, appInfo.sourceRoot);
+    updateWebpackConfig(tree, newPath, appInfo.sourceRoot);
+    updateReadme(tree, newPath, appInfo.sourceRoot);
+    devkit_1.logger.info('');
+    devkit_1.logger.info('✅ Application scope changed successfully!');
+    devkit_1.logger.info('');
+    devkit_1.logger.info('📋 Summary:');
+    devkit_1.logger.info(`  • Application: ${normalizedName}`);
+    devkit_1.logger.info(`  • Old scope: ${appInfo.subdirectory}`);
+    devkit_1.logger.info(`  • New scope: ${options.newScope}`);
+    devkit_1.logger.info(`  • Old location: ${appInfo.sourceRoot}`);
+    devkit_1.logger.info(`  • New location: ${newPath}`);
+    devkit_1.logger.info('');
+    devkit_1.logger.info('📝 Next steps:');
+    devkit_1.logger.info('  1. Review the changes: git status');
+    devkit_1.logger.info('  2. Stage all changes: git add -A');
+    devkit_1.logger.info('     Git will detect the directory move as a rename (preserving history)');
+    devkit_1.logger.info('  3. Run: npm install (to update package-lock.json)');
+    devkit_1.logger.info('  4. Run: npm run build (to verify everything builds)');
+    devkit_1.logger.info('  5. Commit the changes: git commit -m "Change application scope..."');
+    devkit_1.logger.info('');
+}
+exports.default = changeApplicationScopeGenerator;

package/dist/generators/change-application-scope/schema.d.ts

@@ -0,0 +1,4 @@
+export interface ChangeApplicationScopeGeneratorSchema {
+  applicationName: string;
+  newScope: 'local' | 'server';
+}

package/dist/generators/change-application-scope/schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "ChangeApplicationScope",
+  "title": "Change Application Scope Generator",
+  "type": "object",
+  "properties": {
+    "applicationName": {
+      "type": "string",
+      "description": "The name of the application to move",
+      "pattern": "^[a-zA-Z][a-zA-Z0-9\\-\\s]*$"
+    },
+    "newScope": {
+      "type": "string",
+      "description": "The target subdirectory for the application",
+      "enum": ["local", "server"]
+    }
+  },
+  "required": [
+    "applicationName",
+    "newScope"
+  ]
+}

package/dist/generators/change-package-scope/change-package-scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"change-package-scope.d.ts","sourceRoot":"","sources":["../../../src/generators/change-package-scope/change-package-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,IAAI,EAIL,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iCAAiC,EAAE,MAAM,UAAU,CAAC;AAwY7D,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,iCAAiC,iBAuH3C;AAED,eAAe,2BAA2B,CAAC"}
+{"version":3,"file":"change-package-scope.d.ts","sourceRoot":"","sources":["../../../src/generators/change-package-scope/change-package-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,IAAI,EAIL,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iCAAiC,EAAE,MAAM,UAAU,CAAC;AAwY7D,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,iCAAiC,iBAuI3C;AAED,eAAe,2BAA2B,CAAC"}

package/dist/generators/change-package-scope/change-package-scope.js

@@ -310,7 +310,18 @@ async function changePackageScopeGenerator(tree, options) {
     const newPackageJsonName = (0, utils_2.calculateNewPackageJsonName)(packageInfo.packageIdentifier, experienceName, newScope);
     // Calculate new paths
     const newPath = `unisphere/packages/${newSubdirectory}/${packageInfo.packageIdentifier}`;
-    const nxProjectName = `unisphere-package-${packageInfo.packageIdentifier}`;
+    // Read the actual Nx project name from project.json
+    const projectJsonPath = `${packageInfo.sourceRoot}/project.json`;
+    if (!tree.exists(projectJsonPath)) {
+        throw new Error(`project.json not found at ${projectJsonPath}.\n` +
+            'Cannot determine the Nx project name for the move operation.');
+    }
+    const projectJson = (0, devkit_1.readJson)(tree, projectJsonPath);
+    const nxProjectName = projectJson.name;
+    if (!nxProjectName) {
+        throw new Error(`project.json at ${projectJsonPath} does not have a "name" field.\n` +
+            'Cannot determine the Nx project name for the move operation.');
+    }
     devkit_1.logger.info(`🏷️  Target: ${newPackageJsonName} (${newSubdirectory}/)`);
     devkit_1.logger.info(`📁 Moving: ${packageInfo.sourceRoot} → ${newPath}`);
     devkit_1.logger.info('');

package/dist/generators/rename-application/rename-application.d.ts

@@ -0,0 +1,5 @@
+import { Tree } from '@nx/devkit';
+import { RenameApplicationGeneratorSchema } from './schema';
+export declare function renameApplicationGenerator(tree: Tree, options: RenameApplicationGeneratorSchema): Promise<void>;
+export default renameApplicationGenerator;
+//# sourceMappingURL=rename-application.d.ts.map

package/dist/generators/rename-application/rename-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename-application.d.ts","sourceRoot":"","sources":["../../../src/generators/rename-application/rename-application.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EAKL,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gCAAgC,EAAE,MAAM,UAAU,CAAC;AAuW5D,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,gCAAgC,iBA+E1C;AAED,eAAe,0BAA0B,CAAC"}

package/dist/generators/rename-application/rename-application.js

@@ -0,0 +1,293 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renameApplicationGenerator = renameApplicationGenerator;
+const devkit_1 = require("@nx/devkit");
+const generators_1 = require("@nx/workspace/generators");
+const utils_1 = require("../utils");
+function validateOptions(options) {
+    if (!options.oldApplicationName || options.oldApplicationName.trim() === '') {
+        throw new Error(`Missing required option: 'oldApplicationName'\n` +
+            `  Description: The current name of the application to rename\n` +
+            `  Type: string\n` +
+            `  Example: nx g @unisphere/nx:rename-application --oldApplicationName=old-name --newApplicationName=new-name`);
+    }
+    if (!options.newApplicationName || options.newApplicationName.trim() === '') {
+        throw new Error(`Missing required option: 'newApplicationName'\n` +
+            `  Description: The new name for the application\n` +
+            `  Type: string\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Example: nx g @unisphere/nx:rename-application --oldApplicationName=old-name --newApplicationName=new-name`);
+    }
+    const namePattern = /^[a-zA-Z][a-zA-Z0-9\-\s]*$/;
+    if (!namePattern.test(options.newApplicationName)) {
+        throw new Error(`Invalid value '${options.newApplicationName}' for option 'newApplicationName'\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Received: ${options.newApplicationName}`);
+    }
+}
+function validateOldApplicationExists(tree, oldApplicationName) {
+    const unisphereConfig = (0, devkit_1.readJson)(tree, '.unisphere');
+    const normalizedOldName = (0, devkit_1.names)(oldApplicationName).fileName;
+    if (!unisphereConfig.elements?.applications?.[normalizedOldName]) {
+        const available = Object.keys(unisphereConfig.elements?.applications || {});
+        throw new Error(`Application "${normalizedOldName}" not found in .unisphere configuration.\n` +
+            'Available applications: ' + (available.length > 0 ? available.join(', ') : '(none)'));
+    }
+    const appConfig = unisphereConfig.elements.applications[normalizedOldName];
+    const sourceRoot = appConfig.sourceRoot;
+    if (!sourceRoot) {
+        throw new Error(`Application "${normalizedOldName}" exists but has no sourceRoot configured in .unisphere`);
+    }
+    const subdirectory = (0, utils_1.extractApplicationSubdirectory)(sourceRoot);
+    if (!subdirectory) {
+        throw new Error(`Application "${normalizedOldName}" has an unexpected sourceRoot format: ${sourceRoot}\n` +
+            'Expected format: unisphere/applications/{local|server}/{name}');
+    }
+    if (!tree.exists(sourceRoot)) {
+        throw new Error(`Application directory not found at ${sourceRoot}.\n` +
+            'The .unisphere configuration references an application that does not exist.');
+    }
+    const packageJsonPath = `${sourceRoot}/package.json`;
+    if (!tree.exists(packageJsonPath)) {
+        throw new Error(`package.json not found at ${packageJsonPath}.\n` +
+            'The application directory exists but is missing package.json.');
+    }
+    const packageJson = (0, devkit_1.readJson)(tree, packageJsonPath);
+    return {
+        packageJsonName: packageJson.name,
+        sourceRoot,
+        subdirectory,
+        oldPath: sourceRoot,
+    };
+}
+function validateNewApplicationDoesNotExist(tree, newApplicationName, subdirectory) {
+    const unisphereConfig = (0, devkit_1.readJson)(tree, '.unisphere');
+    const normalizedNewName = (0, devkit_1.names)(newApplicationName).fileName;
+    if (unisphereConfig.elements?.applications?.[normalizedNewName]) {
+        throw new Error(`Application "${normalizedNewName}" already exists in .unisphere configuration.\n` +
+            'Please choose a different application name.');
+    }
+    const newPath = `unisphere/applications/${subdirectory}/${normalizedNewName}`;
+    if (tree.exists(newPath)) {
+        throw new Error(`Application directory already exists at ${newPath}.\n` +
+            'Please choose a different application name or remove the existing directory.');
+    }
+}
+function updateUnisphereConfiguration(tree, oldApplicationName, newApplicationName, appInfo) {
+    const unisphereConfig = (0, devkit_1.readJson)(tree, '.unisphere');
+    const normalizedNewName = (0, devkit_1.names)(newApplicationName).fileName;
+    const normalizedOldName = (0, devkit_1.names)(oldApplicationName).fileName;
+    const newSourceRoot = `unisphere/applications/${appInfo.subdirectory}/${normalizedNewName}`;
+    const newApplications = {};
+    Object.keys(unisphereConfig.elements.applications).forEach((key) => {
+        if (key === normalizedOldName) {
+            newApplications[normalizedNewName] = {
+                ...unisphereConfig.elements.applications[normalizedOldName],
+                sourceRoot: newSourceRoot,
+            };
+        }
+        else {
+            newApplications[key] = unisphereConfig.elements.applications[key];
+        }
+    });
+    unisphereConfig.elements.applications = newApplications;
+    (0, devkit_1.writeJson)(tree, '.unisphere', unisphereConfig);
+    devkit_1.logger.info(`✅ Updated .unisphere configuration`);
+}
+function updatePackageJson(tree, packagePath, newPackageJsonName) {
+    const packageJsonPath = `${packagePath}/package.json`;
+    if (!tree.exists(packageJsonPath)) {
+        devkit_1.logger.warn(`⚠️  package.json not found at ${packageJsonPath}`);
+        return;
+    }
+    const packageJson = (0, devkit_1.readJson)(tree, packageJsonPath);
+    if (packageJson.name !== newPackageJsonName) {
+        packageJson.name = newPackageJsonName;
+        (0, devkit_1.writeJson)(tree, packageJsonPath, packageJson);
+        devkit_1.logger.info(`✅ Updated package.json name to "${newPackageJsonName}"`);
+    }
+}
+function updatePackageLock(tree, oldPath, newPath) {
+    const packageLockPath = 'package-lock.json';
+    if (!tree.exists(packageLockPath)) {
+        return;
+    }
+    const packageLock = (0, devkit_1.readJson)(tree, packageLockPath);
+    let updated = false;
+    if (packageLock.packages) {
+        const packagesEntries = Object.entries(packageLock.packages);
+        const newPackages = {};
+        for (const [key, value] of packagesEntries) {
+            if (key === oldPath) {
+                newPackages[newPath] = value;
+                updated = true;
+            }
+            else {
+                newPackages[key] = value;
+            }
+        }
+        packageLock.packages = newPackages;
+    }
+    if (packageLock.packages) {
+        for (const [, value] of Object.entries(packageLock.packages)) {
+            if (value && typeof value === 'object' && 'resolved' in value) {
+                const pkg = value;
+                if (pkg.resolved === oldPath) {
+                    pkg.resolved = newPath;
+                    updated = true;
+                }
+            }
+        }
+    }
+    if (updated) {
+        (0, devkit_1.writeJson)(tree, packageLockPath, packageLock);
+        devkit_1.logger.info(`✅ Updated package-lock.json path keys`);
+    }
+}
+function updateWebpackConfig(tree, newPath, oldNormalizedName, newNormalizedName) {
+    const webpackConfigPath = `${newPath}/webpack.config.js`;
+    if (!tree.exists(webpackConfigPath)) {
+        return;
+    }
+    let content = tree.read(webpackConfigPath, 'utf-8');
+    if (!content) {
+        return;
+    }
+    const oldPattern = `application-${oldNormalizedName}`;
+    const newPattern = `application-${newNormalizedName}`;
+    if (content.includes(oldPattern)) {
+        content = content.replace(new RegExp(escapeRegExp(oldPattern), 'g'), newPattern);
+        tree.write(webpackConfigPath, content);
+        devkit_1.logger.info(`✅ Updated webpack.config.js references`);
+    }
+}
+function updateProjectJson(tree, newPath, oldPath, oldNxProjectName, newNxProjectName) {
+    const projectJsonPath = `${newPath}/project.json`;
+    if (!tree.exists(projectJsonPath)) {
+        return;
+    }
+    let content = tree.read(projectJsonPath, 'utf-8');
+    if (!content) {
+        return;
+    }
+    let updated = false;
+    if (content.includes(oldPath)) {
+        content = content.replace(new RegExp(escapeRegExp(oldPath), 'g'), newPath);
+        updated = true;
+    }
+    if (content.includes(oldNxProjectName)) {
+        content = content.replace(new RegExp(escapeRegExp(oldNxProjectName), 'g'), newNxProjectName);
+        updated = true;
+    }
+    if (updated) {
+        tree.write(projectJsonPath, content);
+        devkit_1.logger.info(`✅ Updated project.json paths and comments`);
+    }
+}
+function updateReadme(tree, newPath, oldNormalizedName, newNormalizedName) {
+    const readmePath = `${newPath}/README.md`;
+    if (!tree.exists(readmePath)) {
+        return;
+    }
+    let content = tree.read(readmePath, 'utf-8');
+    if (!content) {
+        return;
+    }
+    let updated = false;
+    const toHumanReadable = (name) => name
+        .replace(/[-_]/g, ' ')
+        .replace(/\b\w/g, (l) => l.toUpperCase());
+    const oldHumanReadable = toHumanReadable(oldNormalizedName);
+    const newHumanReadable = toHumanReadable(newNormalizedName);
+    if (content.includes(oldHumanReadable)) {
+        content = content.replace(new RegExp(escapeRegExp(oldHumanReadable), 'g'), newHumanReadable);
+        updated = true;
+    }
+    if (content.includes(oldNormalizedName)) {
+        content = content.replace(new RegExp(escapeRegExp(oldNormalizedName), 'g'), newNormalizedName);
+        updated = true;
+    }
+    if (updated) {
+        tree.write(readmePath, content);
+        devkit_1.logger.info(`✅ Updated README.md`);
+    }
+}
+function updateRootServeScript(tree, oldNormalizedName, newNormalizedName) {
+    if (!tree.exists('package.json')) {
+        return;
+    }
+    const packageJson = (0, devkit_1.readJson)(tree, 'package.json');
+    const oldScriptName = `serve:${oldNormalizedName}`;
+    if (!packageJson.scripts?.[oldScriptName]) {
+        return;
+    }
+    const oldCommand = packageJson.scripts[oldScriptName];
+    const newCommand = oldCommand.replace(new RegExp(escapeRegExp(oldNormalizedName), 'g'), newNormalizedName);
+    const newScriptName = `serve:${newNormalizedName}`;
+    (0, utils_1.renameScriptInRootPackageJson)(tree, oldScriptName, newScriptName, newCommand);
+}
+function escapeRegExp(string) {
+    return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+async function renameApplicationGenerator(tree, options) {
+    validateOptions(options);
+    devkit_1.logger.info('');
+    devkit_1.logger.info('🔄 Starting application rename...');
+    devkit_1.logger.info('');
+    (0, utils_1.validateUnisphereConfig)(tree);
+    const normalizedOldName = (0, devkit_1.names)(options.oldApplicationName).fileName;
+    const normalizedNewName = (0, devkit_1.names)(options.newApplicationName).fileName;
+    const appInfo = validateOldApplicationExists(tree, normalizedOldName);
+    validateNewApplicationDoesNotExist(tree, normalizedNewName, appInfo.subdirectory);
+    const oldNxProjectName = `unisphere-application-${normalizedOldName}`;
+    const newNxProjectName = `unisphere-application-${normalizedNewName}`;
+    const newPackageJsonName = `unisphere-application-${normalizedNewName}`;
+    const newPath = `unisphere/applications/${appInfo.subdirectory}/${normalizedNewName}`;
+    devkit_1.logger.info(`📦 Old application name: ${normalizedOldName}`);
+    devkit_1.logger.info(`📦 New application name: ${normalizedNewName}`);
+    devkit_1.logger.info(`🏷️  Nx project name: ${oldNxProjectName} → ${newNxProjectName}`);
+    devkit_1.logger.info('');
+    devkit_1.logger.info('🔧 Running Nx move generator...');
+    try {
+        await (0, generators_1.moveGenerator)(tree, {
+            projectName: oldNxProjectName,
+            destination: newPath,
+            newProjectName: newNxProjectName,
+            importPath: newPackageJsonName,
+            updateImportPath: true,
+            skipFormat: false,
+        });
+        devkit_1.logger.info(`✅ Nx moved project from ${appInfo.oldPath} to ${newPath}`);
+    }
+    catch (error) {
+        devkit_1.logger.error(`❌ Failed to move project with Nx: ${error}`);
+        throw error;
+    }
+    devkit_1.logger.info('');
+    devkit_1.logger.info('🧹 Performing Unisphere-specific cleanup...');
+    updateUnisphereConfiguration(tree, normalizedOldName, normalizedNewName, appInfo);
+    updatePackageJson(tree, newPath, newPackageJsonName);
+    updatePackageLock(tree, appInfo.oldPath, newPath);
+    updateWebpackConfig(tree, newPath, normalizedOldName, normalizedNewName);
+    updateProjectJson(tree, newPath, appInfo.oldPath, oldNxProjectName, newNxProjectName);
+    updateReadme(tree, newPath, normalizedOldName, normalizedNewName);
+    updateRootServeScript(tree, normalizedOldName, normalizedNewName);
+    devkit_1.logger.info('');
+    devkit_1.logger.info('✅ Application renamed successfully!');
+    devkit_1.logger.info('');
+    devkit_1.logger.info('📋 Summary:');
+    devkit_1.logger.info(`  • Old name: ${normalizedOldName}`);
+    devkit_1.logger.info(`  • New name: ${normalizedNewName}`);
+    devkit_1.logger.info(`  • Old location: ${appInfo.sourceRoot}`);
+    devkit_1.logger.info(`  • New location: ${newPath}`);
+    devkit_1.logger.info('');
+    devkit_1.logger.info('📝 Next steps:');
+    devkit_1.logger.info('  1. Review the changes: git status');
+    devkit_1.logger.info('  2. Stage all changes: git add -A');
+    devkit_1.logger.info('     Git will detect the directory move as a rename (preserving history)');
+    devkit_1.logger.info('  3. Run: npm install (to update package-lock.json)');
+    devkit_1.logger.info('  4. Run: npm run build (to verify everything builds)');
+    devkit_1.logger.info('  5. Commit the changes: git commit -m "Rename application..."');
+    devkit_1.logger.info('');
+}
+exports.default = renameApplicationGenerator;

package/dist/generators/rename-application/schema.d.ts

@@ -0,0 +1,4 @@
+export interface RenameApplicationGeneratorSchema {
+  oldApplicationName: string;
+  newApplicationName: string;
+}

package/dist/generators/rename-application/schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "RenameApplication",
+  "title": "Rename Application Generator",
+  "type": "object",
+  "properties": {
+    "oldApplicationName": {
+      "type": "string",
+      "description": "The current name of the application to rename"
+    },
+    "newApplicationName": {
+      "type": "string",
+      "description": "The new name for the application",
+      "pattern": "^[a-zA-Z][a-zA-Z0-9\\-\\s]*$"
+    }
+  },
+  "required": [
+    "oldApplicationName",
+    "newApplicationName"
+  ]
+}

package/dist/generators/utils.d.ts

@@ -62,5 +62,7 @@ export declare function extractPackageNameFromSourceRoot(sourceRoot: string): st
  * @param scriptCommand - The command to run (e.g., "npx unisphere application serve my-app --port 4002")
  */
 export declare function addScriptToRootPackageJson(tree: Tree, scriptName: string, scriptCommand: string): void;
+export declare function extractApplicationSubdirectory(sourceRoot: string): string | null;
+export declare function renameScriptInRootPackageJson(tree: Tree, oldScriptName: string, newScriptName: string, newScriptCommand: string): void;
 export {};
 //# sourceMappingURL=utils.d.ts.map

package/dist/generators/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/generators/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EAKL,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC,CAAC;CACJ;AA+FD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,eAAe,CAkEnE;AAGD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QA2BjF;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,UAAU,GAAG,UAAU,GAAG,cAAc,GAAG,eAAe,GACrE,IAAI,CAyBN;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,UAAU,GAAG,UAAU,GAAG,cAAc,GAAG,eAAe,EACvE,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QA0BnC;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA4C7E;AA6BD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CA6BvD;AAwBD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAuB/D;AAED,MAAM,WAAW,gBAAgB;IAC/B,yFAAyF;IACzF,KAAK,EAAE,MAAM,CAAC;IACd,0GAA0G;IAC1G,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,eAAe,EAAE,OAAO,CAAC;CAC1B;AAgCD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,IAAI,GAAG,gBAAgB,CA8BvE;AAGD,KAAK,mBAAmB,CAAC,MAAM,SAAS,MAAM,IAAI;KAC/C,CAAC,IACA,GAAG,MAAM,EAAE,GACX,GAAG,MAAM,iBAAiB,GAC1B,GAAG,MAAM,aAAa,GACtB,GAAG,MAAM,cAAc,GACvB,GAAG,MAAM,gBAAgB,GACzB,GAAG,MAAM,iBAAiB,GAAG,MAAM;CACtC,CAAC;AAKF,wBAAgB,oBAAoB,CAAC,MAAM,SAAS,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAwBzH;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAwBlF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAgB7E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,GAAG,OAAO,GAAG,YAAY,GAAG,cAAc,GAAG,aAAa,GAAG,MAAM,CAE9I;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWnF;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAI3E;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,IAAI,CAyBN"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/generators/utils.ts"],"names":[],"mappings":"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"}

package/dist/generators/utils.js

@@ -15,6 +15,8 @@ exports.getSubdirectoryFromScope = getSubdirectoryFromScope;
 exports.extractSubdirectoryFromSourceRoot = extractSubdirectoryFromSourceRoot;
 exports.extractPackageNameFromSourceRoot = extractPackageNameFromSourceRoot;
 exports.addScriptToRootPackageJson = addScriptToRootPackageJson;
+exports.extractApplicationSubdirectory = extractApplicationSubdirectory;
+exports.renameScriptInRootPackageJson = renameScriptInRootPackageJson;
 const devkit_1 = require("@nx/devkit");
 /**
  * Extracts visual type names from a runtime.tsx file
@@ -516,3 +518,26 @@ function addScriptToRootPackageJson(tree, scriptName, scriptCommand) {
         devkit_1.logger.warn(`⚠️ Failed to add script to package.json: ${error instanceof Error ? error.message : 'Unknown error'}`);
     }
 }
+function extractApplicationSubdirectory(sourceRoot) {
+    const parts = sourceRoot.split('/');
+    if (parts.length === 4 && parts[0] === 'unisphere' && parts[1] === 'applications') {
+        const subdirectory = parts[2];
+        if (['local', 'server'].includes(subdirectory)) {
+            return subdirectory;
+        }
+    }
+    return null;
+}
+function renameScriptInRootPackageJson(tree, oldScriptName, newScriptName, newScriptCommand) {
+    if (!tree.exists('package.json')) {
+        return;
+    }
+    const packageJson = (0, devkit_1.readJson)(tree, 'package.json');
+    if (!packageJson.scripts?.[oldScriptName]) {
+        return;
+    }
+    delete packageJson.scripts[oldScriptName];
+    packageJson.scripts[newScriptName] = newScriptCommand;
+    (0, devkit_1.writeJson)(tree, 'package.json', packageJson);
+    devkit_1.logger.info(`✅ Renamed serve script: ${oldScriptName} → ${newScriptName}`);
+}

package/generators.json

@@ -35,6 +35,16 @@
       "schema": "./dist/generators/change-package-scope/schema.json",
       "description": "Change a package's npm scope by moving it between subdirectories"
     },
+    "rename-application": {
+      "factory": "./dist/generators/rename-application/rename-application",
+      "schema": "./dist/generators/rename-application/schema.json",
+      "description": "Rename a unisphere application and update all references"
+    },
+    "change-application-scope": {
+      "factory": "./dist/generators/change-application-scope/change-application-scope",
+      "schema": "./dist/generators/change-application-scope/schema.json",
+      "description": "Move an application between local and server subdirectories"
+    },
     "remove": {
       "factory": "./dist/generators/remove/remove",
       "schema": "./dist/generators/remove/schema.json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unisphere/nx",
-  "version": "4.4.2",
+  "version": "4.5.0",
   "private": false,
   "main": "./dist/index.js",
   "module": "./dist/index.js",