@unisphere/nx 1.1.3 → 1.1.5

package/README.md

@@ -2,13 +2,16 @@
 
 > This is a temporary documentation to the @unisphere/nx plugin until the official documentation is available.
 
+> ⚠️ **This generator is currently available only to Kaltura developers.**
+> It depends on internal resources such as CI/CD templates, design systems, and private NPM packages. External support for Kaltura customers is on our roadmap.
+
 Unisphere is Kaltura’s frontend framework for building dynamic, composable experiences. A **Unisphere project** is a structured repository that allows developers to create and organize **applications**, **runtimes**, and **packages** under a single cohesive experience. This setup encourages healthy module separation, runtime decoupling, reusability, and clean ownership boundaries — all key ingredients for scaling product development in a multi-team environment.
 
 Whether you're building a full application like _Content Lab_ or a lightweight widget like _Chat_, Unisphere gives you the tooling and conventions to do it the right way from the start.
 
----
+## Step 1 - Create a New Unisphere Project
 
-## Create a New Unisphere Project
+Before creating a new Unisphere project, make sure you have a valid `GITHUB_TOKEN` exported in your environment. This is required for GitHub operations during setup.
 
 To scaffold a new project you can use [create-unisphere-project](https://www.npmjs.com/package/create-unisphere-project) npm package with all necessary tooling and structure, run:
 
@@ -16,13 +19,6 @@ To scaffold a new project you can use [create-unisphere-project](https://www.npm
 npm create unisphere-project@latest
 ```
 
-> ⚠️ **This generator is currently available only to Kaltura developers.**
-> It depends on internal resources such as CI/CD templates, design systems, and private NPM packages. External support for Kaltura customers is on our roadmap.
-
-**Before running the command**, make sure you have a valid `GITHUB_TOKEN` exported in your environment. This is required for GitHub operations during setup.
-
----
-
 ### Set Up the GitHub Repository
 
 Once the project is generated locally, you’ll need to create a new GitHub repository so that CI/CD can operate correctly and your team has proper access.
@@ -36,7 +32,7 @@ Please contact **Eran Sakal** or **Omri Ceisler** to provision the repository. T
    unisphere-{friendly-experience-name}
    ```
 
-   > The friendly name is derived from your declared experience name (e.g., `unisphere.widget.reactions` → `reactions` → `unisphere-reactions` as the repository name).
+   The friendly name is derived from your declared experience name (e.g., `unisphere.widget.reactions` → `reactions` → `unisphere-reactions` as the repository name).
 
 2. **Team Access Configuration**
    The appropriate GitHub teams will be granted access to the repository to match the experience's ownership and collaboration needs.
@@ -48,7 +44,7 @@ Once created, you can push your local project into the new repository and begin
 
 ---
 
-## Use the `@unisphere/nx` Plugin
+## Step 2 - Use the `@unisphere/nx` Plugin
 
 After your project is set up, you’ll use the `@unisphere/nx` plugin to generate and manage your project’s core elements. All generators are interactive and designed to enforce Unisphere best practices and conventions.
 
@@ -91,8 +87,6 @@ npx nx g @unisphere/nx:add-runtime
 
     - Assume it is developed using a playground expo application of another runtime in the project
 
----
-
 ### 🎨 `add-visual`
 
 Creates a **visual component** within a runtime — the building blocks of your UI.
@@ -108,8 +102,6 @@ npx nx g @unisphere/nx:add-visual
 - **Is this visual limited to a single occurrence?**
   Choose `Yes` for singleton visuals (e.g., when the visual represent a container that can only have one instance), otherwise `No`.
 
----
-
 ### 📱 `add-application`
 
 Creates an **application** that acts as a host for your runtime(s). These apps can be used for development, standalone deployments, or iframe integrations. The application can be used as a playground for developing and simulating a host environment without the need to deploy the experience to a customer, or it can be an additional entry point for the experience and use the Unisphere ci/cd to be publically available in multi region environments.
@@ -133,8 +125,6 @@ npx nx g @unisphere/nx:add-application
 
 - **HTML page title** (if not using Playground)
 
----
-
 ### 📦 `add-package`
 
 Creates a shared **package** for separating concerns within an experience. Most of the actual code in a Unisphere project lives in packages — not in runtimes — making it easier to reuse components, services, and logic across multiple entry points. These packages are usually not distributed externally but serve as internal modules consumed by runtimes.
@@ -161,8 +151,6 @@ npx nx g @unisphere/nx:add-package
   - **Internal** - Published to GitHub packages (`@kaltura/unisphere-<experience-name>-<package-name>`)
   - **Public** - Published to npm (`@unisphere/<experience-name>-<package-name>`)
 
----
-
 ## Best Practices
 
 🧠 Use descriptive names that reflect the purpose of the runtime or visual. For example, use `player-plugin` for a runtime that integrates into a video player, or `container` for visual that represent a container that can only have one instance, or `drawer` if it is a drawer runtime.
@@ -173,8 +161,6 @@ npx nx g @unisphere/nx:add-package
 
 🔍 Use the interactive CLI mode to generate all project elements. This ensures naming consistency, correct scaffolding, and alignment with Unisphere conventions.
 
----
-
 ## What’s Next?
 
 Stay tuned for full documentation on each concept and tool at

package/dist/generators/add-application/templates/default/.eslintrc.json

@@ -1,6 +1,10 @@
 {
   "extends": ["plugin:@nx/react", "../../../.eslintrc.json"],
-  "ignorePatterns": ["!**/*"],
+  "ignorePatterns": [
+    "!**/*",
+    "**/vite.config.*.timestamp*",
+    "**/vitest.config.*.timestamp*"
+  ],
   "overrides": [
     {
       "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],

package/dist/generators/add-application/templates/interactive-playground/.eslintrc.json

@@ -1,6 +1,10 @@
 {
   "extends": ["plugin:@nx/react", "../../../.eslintrc.json"],
-  "ignorePatterns": ["!**/*"],
+  "ignorePatterns": [
+    "!**/*",
+    "**/vite.config.*.timestamp*",
+    "**/vitest.config.*.timestamp*"
+  ],
   "overrides": [
     {
       "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],

package/dist/generators/add-application/templates/interactive-playground/src/app/app.tsx.template

@@ -5,7 +5,7 @@ import { ConfigurationContext } from './configuration-provider';
 import { isConfigurationValid } from './definitions';
 import { Header } from './components/header';
 import { ConfigurationProvider } from './configuration-provider';
-import { UnisphereProvider } from '@unisphere/runtime-react';
+import { UnisphereProvider, UnisphereRuntimeVisual } from '@unisphere/runtime-react';
 import { UnisphereWorkspaceConfig } from '@unisphere/runtime';
 import { UnisphereWorkspaceType } from '@unisphere/runtime';
 import { <%= runtimeName__pascalCase %>Runtime } from '<%= coreAlias %>';

package/dist/generators/add-application/templates/interactive-playground/src/app/components/settings-form.tsx

@@ -92,11 +92,15 @@ export const SettingsForm: React.FC = () => {
           name={'settings'}
           fullWidth
           inputProps={{
-            ...register('settings', { required: true }),
+            ...register('settings', {
+              required: `To pass empty settings, type "{}". Otherwise: (1) manually type valid JSON. (2) `,
+            }),
           }}
           label={'Unisphere Settings'}
-          helperText={`Easily copy settings from Unisphere by entering a workable host in NVQ2 and then do: Unisphere cmd+k > Manage Workspace Runtimes > show ... (actions) of desired runtime > copy settings`}
-          error={!!errors?.settings}
+          helperText={`${
+            errors?.settings?.message || ''
+          }Easily copy settings from Unisphere by entering a workable host in NVQ2 and then do: Unisphere cmd+k > Manage Workspace Runtimes > show ... (actions) of desired runtime > copy settings`}
+          error={!!errors?.settings?.message}
         />
       </FormCard>
     </Stack>

package/dist/generators/add-package/add-package.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-package.d.ts","sourceRoot":"","sources":["../../../src/generators/add-package/add-package.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAiB,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAuGrD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,yBAAyB,uBAyGnC;AAED,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"add-package.d.ts","sourceRoot":"","sources":["../../../src/generators/add-package/add-package.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAiB,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AA+GrD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,yBAAyB,uBAyGnC;AAED,eAAe,mBAAmB,CAAC"}

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

@@ -11,7 +11,9 @@ function generateDemoComponent(tree, projectRoot, vars) {
     // component and logger names
     const loggerName = `${vars['packageName__lowerDashCase']}-demo`;
     const demoName = `${vars['packageName__pascalCase']}Demo`;
-    const content = `import { useContext, useEffect } from 'react';
+    let content;
+    if (demoName.includes('react')) {
+        content = `import { useContext, useEffect } from 'react';
 import {
   ScopedUnisphereWorkspaceContext,
   useGetScopedWorkspaceLogger,
@@ -63,9 +65,9 @@ export const ${demoName} = () => {
 
   useEffect(() => {
     // example only - feel free to remove
-    logger.log('${loggerName} mounted');
+    logger?.log('${loggerName} mounted');
     return () => {
-      logger.log('${loggerName} unmounted');
+      logger?.log('${loggerName} unmounted');
     };
   }, []);
 
@@ -79,6 +81,10 @@ export const ${demoName} = () => {
   return <Hihi />;
 };
 `;
+    }
+    else {
+        content = `export const ${demoName} = () => {}`;
+    }
     tree.write(targetPath, content);
 }
 async function addPackageGenerator(tree, options) {

package/dist/generators/add-package/templates/new-package/.eslintrc.json

@@ -1,6 +1,10 @@
 {
   "extends": ["plugin:@nx/react", "../../../.eslintrc.json"],
-  "ignorePatterns": ["!**/*"],
+  "ignorePatterns": [
+    "!**/*",
+    "**/vite.config.*.timestamp*",
+    "**/vitest.config.*.timestamp*"
+  ],
   "overrides": [
     {
       "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],

package/dist/generators/add-runtime/templates/new-runtime/.eslintrc.json

@@ -1,6 +1,10 @@
 {
   "extends": ["plugin:@nx/react", "../../../.eslintrc.json"],
-  "ignorePatterns": ["!**/*"],
+  "ignorePatterns": [
+    "!**/*",
+    "**/vite.config.*.timestamp*",
+    "**/vitest.config.*.timestamp*"
+  ],
   "overrides": [
     {
       "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],

package/dist/generators/migrate-to-1-1-5/migrate-to-1-1-5.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+export default function migrateGenerator(tree: Tree): Promise<void>;
+//# sourceMappingURL=migrate-to-1-1-5.d.ts.map

package/dist/generators/migrate-to-1-1-5/migrate-to-1-1-5.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-to-1-1-5.d.ts","sourceRoot":"","sources":["../../../src/generators/migrate-to-1-1-5/migrate-to-1-1-5.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAU,MAAM,YAAY,CAAC;AAiB1C,wBAA8B,gBAAgB,CAAC,IAAI,EAAE,IAAI,iBA4CxD"}

package/dist/generators/migrate-to-1-1-5/migrate-to-1-1-5.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = migrateGenerator;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const update_packages_1 = tslib_1.__importDefault(require("./update-packages"));
+const rename_widgetname_to_widgetname_1 = tslib_1.__importDefault(require("../../migrations/update-1-1-5/rename-widgetname-to-widgetname"));
+const fix_playground_apps_1 = tslib_1.__importDefault(require("../../migrations/update-1-1-5/fix-playground-apps"));
+const sync_package_json_files_1 = tslib_1.__importDefault(require("../../migrations/update-1-1-5/sync-package-json-files"));
+const move_runtime_info_to_core_1 = tslib_1.__importDefault(require("../../migrations/update-1-1-5/move-runtime-info-to-core"));
+// import updateLanguagesMigration from '../../migrations/update-1-1-5/_update-languages';
+const update_npmrc_1 = tslib_1.__importDefault(require("../../migrations/update-1-1-5/update-npmrc"));
+const check_nx_version_1 = tslib_1.__importDefault(require("../../migrations/update-1-1-5/check-nx-version"));
+const update_nvmrc_1 = tslib_1.__importDefault(require("../../migrations/update-1-1-5/update-nvmrc"));
+const fix_dependency_versions_1 = tslib_1.__importDefault(require("../../migrations/update-1-1-5/fix-dependency-versions"));
+const update_github_workflow_1 = tslib_1.__importDefault(require("../../migrations/update-1-1-5/update-github-workflow"));
+async function migrateGenerator(tree) {
+    try {
+        (0, check_nx_version_1.default)(tree);
+        await (0, update_packages_1.default)(tree);
+        await (0, update_nvmrc_1.default)(tree);
+        await (0, fix_dependency_versions_1.default)(tree);
+        await (0, update_github_workflow_1.default)(tree);
+        await (0, rename_widgetname_to_widgetname_1.default)(tree);
+        await (0, fix_playground_apps_1.default)(tree);
+        await (0, move_runtime_info_to_core_1.default)(tree);
+        // await updateLanguagesMigration(tree);
+        await (0, update_npmrc_1.default)(tree);
+        await (0, sync_package_json_files_1.default)(tree);
+        devkit_1.logger.info('');
+        devkit_1.logger.warn('═══════════════════════════════════════════════════════════════');
+        devkit_1.logger.warn('✅ Migrations completed!');
+        devkit_1.logger.warn('═══════════════════════════════════════════════════════════════');
+        devkit_1.logger.warn('');
+        devkit_1.logger.warn('📋 Next steps:');
+        devkit_1.logger.warn('1. Review the changes made to package.json files');
+        devkit_1.logger.warn('2. Remove node_modules: rm -rf node_modules');
+        devkit_1.logger.warn('3. Install dependencies: npm install');
+        devkit_1.logger.warn('4. Update old react code manually or run the codemod:');
+        devkit_1.logger.warn('   npx codemod@latest react/19/migration-recipe --target ./src');
+        devkit_1.logger.warn('5. Run npm run check to see if there are any errors');
+        devkit_1.logger.warn('');
+        devkit_1.logger.warn('═══════════════════════════════════════════════════════════════');
+    }
+    catch (error) {
+        devkit_1.logger.error(`❌ Migration failed: ${error?.message || 'Unknown error'}`);
+        throw error;
+    }
+}

package/dist/generators/migrate-to-1-1-5/run-locally.md

@@ -0,0 +1,9 @@
+To run the migration locally 
+
+`
+  npx nx generate {path-to-repo}/unisphere-nx-workspace-plugin/packages/nx:migrate-to-1-1-5
+`
+
+
+npx nx generate /home/tokomeno/kaltura/unisphere/pl/unisphere-nx-workspace-plugin/packages/nx:migrate-to-1-1-5
+

package/dist/generators/migrate-to-1-1-5/schema.d.ts

@@ -0,0 +1 @@
+export interface MigrateTo115GeneratorSchema {}

package/dist/generators/migrate-to-1-1-5/schema.json

@@ -0,0 +1,10 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "cli": "nx",
+    "$id": "migrate-to-1-1-5",
+    "title": "Migrate to @unisphere/nx v1.1.5",
+    "description": "Migrates your project to @unisphere/nx v1.1.5 with package updates, WidgetName renaming, and React 19 preparation",
+    "type": "object",
+    "properties": {},
+    "additionalProperties": false
+}

package/dist/generators/migrate-to-1-1-5/update-packages.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+export default function updatePackages(tree: Tree): Promise<void>;
+//# sourceMappingURL=update-packages.d.ts.map

package/dist/generators/migrate-to-1-1-5/update-packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-packages.d.ts","sourceRoot":"","sources":["../../../src/generators/migrate-to-1-1-5/update-packages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,IAAI,EAAU,MAAM,YAAY,CAAC;AAqBvD,wBAA8B,cAAc,CAAC,IAAI,EAAE,IAAI,iBA2GtD"}

package/dist/generators/migrate-to-1-1-5/update-packages.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = updatePackages;
+const devkit_1 = require("@nx/devkit");
+const child_process_1 = require("child_process");
+/**
+ * Fetches the latest version of a package from npm registry
+ */
+async function getLatestVersion(packageName) {
+    try {
+        const result = (0, child_process_1.execSync)(`npm view ${packageName} version`, {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return result.trim();
+    }
+    catch (error) {
+        devkit_1.logger.warn(`Failed to fetch latest version for ${packageName}, keeping 'latest'`);
+        return 'latest';
+    }
+}
+async function updatePackages(tree) {
+    // Read the current package.json
+    const packageJsonContent = tree.read('package.json', 'utf-8');
+    if (!packageJsonContent) {
+        devkit_1.logger.error('No package.json found');
+        return;
+    }
+    const packageJson = JSON.parse(packageJsonContent);
+    // Get the 1.1.5 package updates
+    devkit_1.logger.info('Fetching latest versions from npm registry...');
+    // Resolve all 'latest' versions to actual version numbers
+    const resolvedPackageUpdates = { ...packageUpdates };
+    for (const [packageName, config] of Object.entries(packageUpdates.packages)) {
+        if (config.version === 'latest') {
+            const latestVersion = await getLatestVersion(packageName);
+            resolvedPackageUpdates.packages[packageName] = {
+                ...config,
+                version: `^${latestVersion}`, // Add ^ prefix to latest versions
+            };
+        }
+    }
+    devkit_1.logger.info('Updating packages based on migrations.json...');
+    let hasChanges = false;
+    // Process each package update
+    for (const [packageName, updateConfig] of Object.entries(resolvedPackageUpdates.packages)) {
+        const { version, alwaysAddToPackageJson, addToPackageJson } = updateConfig;
+        // Check if package exists in any dependency type
+        const existsInDependencies = packageJson.dependencies && packageJson.dependencies[packageName];
+        const existsInDevDependencies = packageJson.devDependencies && packageJson.devDependencies[packageName];
+        const existsInOptionalDependencies = packageJson.optionalDependencies &&
+            packageJson.optionalDependencies[packageName];
+        const existsInPeerDependencies = packageJson.peerDependencies && packageJson.peerDependencies[packageName];
+        const packageExists = existsInDependencies ||
+            existsInDevDependencies ||
+            existsInOptionalDependencies ||
+            existsInPeerDependencies;
+        // If alwaysAddToPackageJson is false, only update if package already exists
+        if (alwaysAddToPackageJson === false && !packageExists) {
+            devkit_1.logger.info(`Skipping ${packageName} (not installed, alwaysAddToPackageJson: false)`);
+            continue;
+        }
+        // Update existing packages in their current location
+        if (existsInDependencies) {
+            devkit_1.logger.info(`Updating ${packageName} to ${version} in dependencies`);
+            packageJson.dependencies[packageName] = version;
+            hasChanges = true;
+        }
+        else if (existsInDevDependencies) {
+            devkit_1.logger.info(`Updating ${packageName} to ${version} in devDependencies`);
+            packageJson.devDependencies[packageName] = version;
+            hasChanges = true;
+        }
+        else if (existsInOptionalDependencies) {
+            devkit_1.logger.info(`Updating ${packageName} to ${version} in optionalDependencies`);
+            packageJson.optionalDependencies[packageName] = version;
+            hasChanges = true;
+        }
+        else if (existsInPeerDependencies) {
+            devkit_1.logger.info(`Updating ${packageName} to ${version} in peerDependencies`);
+            packageJson.peerDependencies[packageName] = version;
+            hasChanges = true;
+        }
+        else if (alwaysAddToPackageJson !== false && addToPackageJson) {
+            // Add new package to specified location if alwaysAddToPackageJson is not false
+            const targetDeps = addToPackageJson;
+            if (!packageJson[targetDeps]) {
+                packageJson[targetDeps] = {};
+            }
+            devkit_1.logger.info(`Adding ${packageName} to ${version} in ${targetDeps}`);
+            packageJson[targetDeps][packageName] = version;
+            hasChanges = true;
+        }
+    }
+    if (hasChanges) {
+        // Write the updated package.json
+        tree.write('package.json', JSON.stringify(packageJson, null, 2) + '\n');
+        devkit_1.logger.info('✅ Package.json updated successfully!');
+        devkit_1.logger.info('');
+        devkit_1.logger.info('📦 Updated packages based on migrations.json packageJsonUpdates->1.1.5');
+        devkit_1.logger.info('');
+        devkit_1.logger.info('🔄 Run "npm install" to install the updated packages');
+    }
+    else {
+        devkit_1.logger.info('No packages needed to be updated');
+    }
+    await (0, devkit_1.formatFiles)(tree);
+}
+var packageUpdates = {
+    packages: {
+        '@kaltura/ds-react-bits': {
+            version: 'latest',
+            alwaysAddToPackageJson: false,
+        },
+        '@kaltura/ds-react-icons': {
+            version: 'latest',
+            alwaysAddToPackageJson: false,
+        },
+        '@kaltura/ds-react-theme': {
+            version: 'latest',
+            alwaysAddToPackageJson: false,
+        },
+        '@kaltura/ds-react-utils': {
+            version: 'latest',
+            alwaysAddToPackageJson: false,
+        },
+        '@unisphere/cli': {
+            version: 'latest',
+            alwaysAddToPackageJson: false,
+        },
+        '@unisphere/core': {
+            version: 'latest',
+            alwaysAddToPackageJson: false,
+        },
+        '@unisphere/notifications-core': {
+            version: 'latest',
+            alwaysAddToPackageJson: false,
+        },
+        '@unisphere/notifications-runtime-react': {
+            version: 'latest',
+            alwaysAddToPackageJson: false,
+        },
+        '@unisphere/nx': {
+            version: 'latest',
+            alwaysAddToPackageJson: false,
+        },
+        '@unisphere/runtime': {
+            version: 'latest',
+            alwaysAddToPackageJson: false,
+        },
+        '@unisphere/runtime-js': {
+            version: 'latest',
+            alwaysAddToPackageJson: false,
+        },
+        '@unisphere/runtime-react': {
+            version: 'latest',
+            alwaysAddToPackageJson: false,
+        },
+        '@unisphere/ui-i18n-react': {
+            version: 'latest',
+            alwaysAddToPackageJson: false,
+        },
+        react: {
+            version: '^19.0.0',
+            alwaysAddToPackageJson: false,
+        },
+        'react-dom': {
+            version: '^19.0.0',
+            alwaysAddToPackageJson: false,
+        },
+        '@types/node': {
+            version: '^20.19.1',
+            alwaysAddToPackageJson: false,
+        },
+        '@types/react': {
+            version: '^19.0.0',
+            alwaysAddToPackageJson: false,
+        },
+        '@types/react-dom': {
+            version: '^19.0.0',
+            alwaysAddToPackageJson: false,
+        },
+        '@swc/helpers': {
+            version: '~0.5.17',
+            alwaysAddToPackageJson: false,
+        },
+        'react-codemod': {
+            version: '^5.4.4',
+            alwaysAddToPackageJson: false,
+        },
+        '@nx/nx-linux-x64-gnu': {
+            version: '22.0.1',
+            addToPackageJson: 'optionalDependencies',
+            alwaysAddToPackageJson: false,
+        },
+        '@emotion/react': {
+            version: '11.14.0',
+            alwaysAddToPackageJson: false,
+        },
+        '@emotion/styled': {
+            version: '11.14.1',
+            alwaysAddToPackageJson: false,
+        },
+    },
+};

package/dist/generators/test-migration-locally/generator.d.ts

@@ -0,0 +1,16 @@
+import { Tree } from '@nx/devkit';
+/**
+ * Test Migration Locally Generator
+ *
+ * This generator mimics the full `nx migrate` flow for local testing.
+ * It reads migrations.json and executes everything in the correct order,
+ * including showing post-upgrade messages.
+ *
+ * Usage:
+ *   npx nx g @unisphere/nx:test-migration-locally
+ *
+ * Or with local path:
+ *   npx nx g ./packages/nx:test-migration-locally
+ */
+export default function testMigrationLocally(tree: Tree): Promise<void>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/generators/test-migration-locally/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/generators/test-migration-locally/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAuB,MAAM,YAAY,CAAC;AAIvD;;;;;;;;;;;;GAYG;AACH,wBAA8B,oBAAoB,CAAC,IAAI,EAAE,IAAI,iBA+G5D"}

package/dist/generators/test-migration-locally/generator.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = testMigrationLocally;
+const devkit_1 = require("@nx/devkit");
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Test Migration Locally Generator
+ *
+ * This generator mimics the full `nx migrate` flow for local testing.
+ * It reads migrations.json and executes everything in the correct order,
+ * including showing post-upgrade messages.
+ *
+ * Usage:
+ *   npx nx g @unisphere/nx:test-migration-locally
+ *
+ * Or with local path:
+ *   npx nx g ./packages/nx:test-migration-locally
+ */
+async function testMigrationLocally(tree) {
+    devkit_1.logger.info('');
+    devkit_1.logger.info('🧪 TESTING MIGRATIONS LOCALLY');
+    devkit_1.logger.info('='.repeat(70));
+    devkit_1.logger.info('This simulates the full `nx migrate` flow for testing purposes.');
+    devkit_1.logger.info('='.repeat(70));
+    devkit_1.logger.info('');
+    try {
+        // Read migrations.json
+        const migrationsJsonPath = (0, path_1.join)(__dirname, '../../../migrations.json');
+        const migrationsJson = JSON.parse((0, fs_1.readFileSync)(migrationsJsonPath, 'utf-8'));
+        const migrations = migrationsJson.migrations;
+        const packageUpdates = migrationsJson.packageJsonUpdates?.['1.1.5'];
+        // Show what will be run
+        devkit_1.logger.info(`📋 Migrations to run: ${Object.keys(migrations).length}`);
+        Object.entries(migrations).forEach(([name, config]) => {
+            devkit_1.logger.info(`   • ${name}: ${config.description}`);
+        });
+        devkit_1.logger.info('');
+        // Step 1: Run migrations in order
+        devkit_1.logger.info('🚀 Starting migrations...');
+        devkit_1.logger.info('');
+        let migrationCount = 0;
+        const totalMigrations = Object.keys(migrations).length;
+        for (const [migrationName, migrationConfig] of Object.entries(migrations)) {
+            migrationCount++;
+            devkit_1.logger.info('─'.repeat(70));
+            devkit_1.logger.info(`📦 [${migrationCount}/${totalMigrations}] ${migrationName}`);
+            devkit_1.logger.info(`   ${migrationConfig.description}`);
+            devkit_1.logger.info('─'.repeat(70));
+            try {
+                // Construct the migration path
+                const migrationPath = migrationConfig.implementation
+                    .replace('./dist/migrations/', '../../migrations/')
+                    .replace(/\.js$/, '');
+                // Import and run the migration
+                const migrationModule = await import(migrationPath);
+                const migrationFn = migrationModule.default;
+                if (typeof migrationFn !== 'function') {
+                    throw new Error(`Migration ${migrationName} does not export a default function`);
+                }
+                // Execute the migration
+                await migrationFn(tree);
+                // Show post-upgrade message if it exists
+                if (migrationConfig.cli?.postUpgradeMessage) {
+                    devkit_1.logger.info('');
+                    devkit_1.logger.info(migrationConfig.cli.postUpgradeMessage);
+                }
+                devkit_1.logger.info('');
+            }
+            catch (error) {
+                devkit_1.logger.error(`❌ Migration "${migrationName}" failed!`);
+                devkit_1.logger.error(`   Error: ${error.message}`);
+                devkit_1.logger.error('');
+                devkit_1.logger.error('Stack trace:');
+                devkit_1.logger.error(error.stack);
+                throw error;
+            }
+        }
+        // Step 2: Format files
+        await (0, devkit_1.formatFiles)(tree);
+        // Step 3: Show final summary message
+        devkit_1.logger.info('');
+        devkit_1.logger.info('='.repeat(70));
+        devkit_1.logger.info('✅ ALL MIGRATIONS COMPLETED');
+        devkit_1.logger.info('='.repeat(70));
+        if (packageUpdates?.postUpdateMessage) {
+            devkit_1.logger.info(packageUpdates.postUpdateMessage);
+        }
+        devkit_1.logger.info('');
+        devkit_1.logger.info('📊 Summary:');
+        devkit_1.logger.info(`   Total migrations run: ${totalMigrations}`);
+        devkit_1.logger.info(`   All migrations: ✅ Success`);
+        devkit_1.logger.info('');
+        devkit_1.logger.info('🔍 Review the changes:');
+        devkit_1.logger.info('   git status');
+        devkit_1.logger.info('   git diff');
+        devkit_1.logger.info('');
+        devkit_1.logger.info('♻️  To revert all changes:');
+        devkit_1.logger.info('   git checkout .');
+        devkit_1.logger.info('   git clean -fd');
+        devkit_1.logger.info('');
+    }
+    catch (error) {
+        devkit_1.logger.error('');
+        devkit_1.logger.error('='.repeat(70));
+        devkit_1.logger.error('❌ MIGRATION FLOW FAILED');
+        devkit_1.logger.error('='.repeat(70));
+        devkit_1.logger.error(`Error: ${error?.message || 'Unknown error'}`);
+        devkit_1.logger.error('');
+        throw error;
+    }
+}