@unisphere/nx 3.2.4 → 3.4.0

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

@@ -1 +1 @@
-{"version":3,"file":"add-application.d.ts","sourceRoot":"","sources":["../../../src/generators/add-application/add-application.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAsC,MAAM,YAAY,CAAC;AAIlG,OAAO,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAC;AAkHzD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,6BAA6B,uBAgQvC;AAED,eAAe,uBAAuB,CAAC"}
+{"version":3,"file":"add-application.d.ts","sourceRoot":"","sources":["../../../src/generators/add-application/add-application.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAsC,MAAM,YAAY,CAAC;AAElG,OAAO,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAC;AAkHzD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,6BAA6B,uBAiIvC;AAED,eAAe,uBAAuB,CAAC"}

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

@@ -4,8 +4,6 @@ exports.addApplicationGenerator = addApplicationGenerator;
 const tslib_1 = require("tslib");
 const devkit_1 = require("@nx/devkit");
 const path = tslib_1.__importStar(require("path"));
-const child_process_1 = require("child_process");
-const fs = tslib_1.__importStar(require("fs"));
 const utils_1 = require("../utils");
 const dependency_config_1 = require("../dependency-config");
 async function getEnquirerPrompt() {
@@ -62,7 +60,7 @@ async function promptForHtmlPageTitle() {
     });
     return response.htmlPageTitle;
 }
-async function promptForDependencies(isPlayground) {
+async function promptForDependencies(_isPlayground) {
     const prompt = await getEnquirerPrompt();
     const choices = [
         { value: 'ds', label: 'Kaltura DS - Design System (requires GIT_TOKEN)' },
@@ -81,50 +79,19 @@ async function addApplicationGenerator(tree, options) {
         throw new Error('iframe-with-post-messages serving type is not currently supported. Please choose a different serving type.');
     }
     const isPlayground = options.servingType === 'local-dev-playground';
-    const isDocumentation = options.servingType === 'documentation';
-    // Check workspace pattern for documentation apps
-    if (isDocumentation) {
-        const rootPackageJsonPath = 'package.json';
-        if (tree.exists(rootPackageJsonPath)) {
-            const packageJson = JSON.parse(tree.read(rootPackageJsonPath, 'utf-8') || '{}');
-            const workspaces = packageJson.workspaces || [];
-            // Check if using the old catch-all pattern that doesn't work with documentation apps
-            const hasCatchAllPattern = workspaces.includes('unisphere/**');
-            const hasNegationPattern = workspaces.some((pattern) => pattern.startsWith('!'));
-            if (hasCatchAllPattern || hasNegationPattern) {
-                throw new Error('Documentation applications require @unisphere/nx version 3.1.0 or higher.\n\n' +
-                    'Your workspace is using an old npm workspaces pattern that prevents documentation apps ' +
-                    'from having their own node_modules.\n\n' +
-                    'Please upgrade by running:\n' +
-                    '  npx nx migrate @unisphere/nx@latest\n' +
-                    '  npx nx migrate --run-migrations\n\n' +
-                    'This will update your workspace pattern to support documentation apps.');
-            }
-        }
-    }
     // Validate and read .unisphere configuration
     const unisphereConfig = (0, utils_1.validateUnisphereConfig)(tree);
-    // Skip runtime/visual prompts for documentation sites
-    let runtimeName = '';
-    let visualName = '';
-    if (!isDocumentation) {
-        const promptResult = await promptForRuntimeName(unisphereConfig.runtimes, options.runtimeName || '', options.visualName || '', options.skipDynamicRuntimeVisualPrompt || false);
-        runtimeName = promptResult.runtimeName;
-        visualName = promptResult.visualName;
-    }
-    // Skip HTML page title prompt for documentation (Docusaurus has its own config)
-    if (!isPlayground && !isDocumentation && !options.htmlPageTitle) {
+    const promptResult = await promptForRuntimeName(unisphereConfig.runtimes, options.runtimeName || '', options.visualName || '', options.skipDynamicRuntimeVisualPrompt || false);
+    const runtimeName = promptResult.runtimeName;
+    const visualName = promptResult.visualName;
+    if (!isPlayground && !options.htmlPageTitle) {
         options.htmlPageTitle = options.htmlPageTitle || await promptForHtmlPageTitle();
     }
-    // Skip dependencies prompt for documentation (Docusaurus has its own)
-    let selectedDependencies = [];
-    if (!isDocumentation) {
-        if (options.dependencies === undefined) {
-            options.dependencies = await promptForDependencies(isPlayground);
-        }
-        const baseDependencies = ['react'];
-        selectedDependencies = [...baseDependencies, ...(options.dependencies || [])];
+    if (options.dependencies === undefined) {
+        options.dependencies = await promptForDependencies(isPlayground);
     }
+    const baseDependencies = ['react'];
+    const selectedDependencies = [...baseDependencies, ...(options.dependencies || [])];
     // Validate runtime exists if runtimeName is provided
     if (runtimeName) {
         if (!(0, utils_1.checkIfRuntimeExists)(tree, runtimeName)) {
@@ -138,83 +105,11 @@ async function addApplicationGenerator(tree, options) {
         applicationName += '-dev';
     }
     const applicationNameAsLowerDashCase = (0, devkit_1.names)(applicationName).fileName;
-    // Find types package (or fallback to core) - skip for documentation
-    const typesPackageInfo = isDocumentation ? null : (0, utils_1.findTypesOrCorePackageInfo)(tree);
+    const typesPackageInfo = (0, utils_1.findTypesOrCorePackageInfo)(tree);
     // Determine subdirectory based on serving type
-    // local-dev-playground -> local/, documentation -> documentation/, other types -> server/
-    const subdirectory = isPlayground ? 'local' : isDocumentation ? 'documentation' : 'server';
+    // local-dev-playground -> local/, other types -> server/
+    const subdirectory = isPlayground ? 'local' : 'server';
     const projectRoot = `unisphere/applications/${subdirectory}/${applicationNameAsLowerDashCase}`;
-    // Handle documentation type separately
-    if (isDocumentation) {
-        // Check if the application already exists
-        if (tree.exists(projectRoot)) {
-            throw new Error(`Application "${applicationNameAsLowerDashCase}" already exists at ${projectRoot}.\n` +
-                'Please choose a different application name or remove the existing application first.');
-        }
-        // Update .unisphere configuration (applicationType is derived from folder path)
-        (0, utils_1.updateUnisphereConfig)(tree, 'applications', applicationNameAsLowerDashCase, {
-            sourceRoot: projectRoot,
-        });
-        // Add documentation folder to .nxignore to prevent NX from scanning it
-        // Docusaurus has its own node_modules which can slow down NX
-        const nxIgnorePath = '.nxignore';
-        const ignoreEntry = `${projectRoot}/node_modules`;
-        let nxIgnoreContent = '';
-        if (tree.exists(nxIgnorePath)) {
-            nxIgnoreContent = tree.read(nxIgnorePath, 'utf-8') || '';
-        }
-        if (!nxIgnoreContent.includes(ignoreEntry)) {
-            const newContent = nxIgnoreContent
-                ? `${nxIgnoreContent.trimEnd()}\n\n# Documentation site (Docusaurus) - has its own node_modules\n${ignoreEntry}\n`
-                : `# Documentation site (Docusaurus) - has its own node_modules\n${ignoreEntry}\n`;
-            tree.write(nxIgnorePath, newContent);
-        }
-        // Documentation folders are automatically excluded from npm workspaces
-        // because the root package.json uses explicit workspace patterns that don't include
-        // unisphere/applications/documentation/**
-        // This allows documentation sites (like Docusaurus) to have their own node_modules
-        await (0, devkit_1.formatFiles)(tree);
-        // Return a function that will be executed after all file operations are complete
-        return () => {
-            const workspaceRoot = process.cwd();
-            const fullProjectPath = path.join(workspaceRoot, projectRoot);
-            devkit_1.logger.info('');
-            devkit_1.logger.info('📚 Setting up Docusaurus documentation site...');
-            devkit_1.logger.info('');
-            try {
-                // Create the parent directory if it doesn't exist
-                const parentDir = path.dirname(fullProjectPath);
-                if (!fs.existsSync(parentDir)) {
-                    fs.mkdirSync(parentDir, { recursive: true });
-                }
-                // Run Docusaurus CLI to scaffold the project
-                // Docusaurus creates a self-contained project with its own package.json
-                // No NX integration needed - we just delegate to Docusaurus CLI for serve/build
-                // Use public npm registry explicitly (workspaces may have private registry configured)
-                devkit_1.logger.info('Running Docusaurus CLI...');
-                (0, child_process_1.execSync)(`npx --yes --registry https://registry.npmjs.org create-docusaurus@3 "${fullProjectPath}" classic --typescript`, {
-                    stdio: 'inherit',
-                    cwd: workspaceRoot,
-                });
-                devkit_1.logger.info('');
-                devkit_1.logger.info('✅ Documentation site generated successfully!');
-                devkit_1.logger.info('');
-                devkit_1.logger.info(`📚 Application Name: ${applicationNameAsLowerDashCase}`);
-                devkit_1.logger.info(`🔧 Type: Documentation Site (Docusaurus)`);
-                devkit_1.logger.info(`📁 Location: ${projectRoot}`);
-                devkit_1.logger.info('');
-                devkit_1.logger.info(`📜 To serve: npx unisphere application serve ${applicationNameAsLowerDashCase}`);
-                devkit_1.logger.info(`📦 To build: npx unisphere application build ${applicationNameAsLowerDashCase}`);
-                devkit_1.logger.info('');
-            }
-            catch (error) {
-                devkit_1.logger.error('Failed to create Docusaurus project:');
-                devkit_1.logger.error(error instanceof Error ? error.message : String(error));
-                throw error;
-            }
-        };
-    }
-    // Standard application flow (non-documentation)
     const hasDs = selectedDependencies.includes('ds');
     const templateVariables = {
         htmlPageTitle: options.servingType === 'local-dev-playground'

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

@@ -1,7 +1,7 @@
 export interface AddApplicationGeneratorSchema {
   name: string;
   htmlPageTitle?: string;
-  servingType: 'local-dev-playground' | 'self-hosted' | 'iframe-with-post-messages' | 'documentation';
+  servingType: 'local-dev-playground' | 'self-hosted' | 'iframe-with-post-messages';
   runtimeName?: string;
   visualName?: string;
   skipDynamicRuntimeVisualPrompt?: boolean; // Internal option to skip the dynamic prompt for visual when runtime is selected

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

@@ -33,10 +33,6 @@
           {
             "value": "iframe-with-post-messages",
             "label": "Iframe + Post Messages (suitible to applications that gets required configuration from post messages)"
-          },
-          {
-            "value": "documentation",
-            "label": "Documentation Site (Docusaurus)"
           }
         ]
       }

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"add-documentation.d.ts","sourceRoot":"","sources":["../../../src/generators/add-documentation/add-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,IAAI,EAAiB,MAAM,YAAY,CAAC;AAI9D,OAAO,EAAE,+BAA+B,EAAE,MAAM,UAAU,CAAC;AAM3D,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,+BAA+B,uBA4GzC;AAED,eAAe,yBAAyB,CAAC"}

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

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addDocumentationGenerator = addDocumentationGenerator;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const path = tslib_1.__importStar(require("path"));
+const child_process_1 = require("child_process");
+const fs = tslib_1.__importStar(require("fs"));
+const utils_1 = require("../utils");
+async function addDocumentationGenerator(tree, options) {
+    // Validate .unisphere configuration exists
+    (0, utils_1.validateUnisphereConfig)(tree);
+    // Check workspace pattern for documentation apps
+    const rootPackageJsonPath = 'package.json';
+    if (tree.exists(rootPackageJsonPath)) {
+        const packageJson = JSON.parse(tree.read(rootPackageJsonPath, 'utf-8') || '{}');
+        const workspaces = packageJson.workspaces || [];
+        // Check if using the old catch-all pattern that doesn't work with documentation apps
+        const hasCatchAllPattern = workspaces.includes('unisphere/**');
+        if (hasCatchAllPattern) {
+            throw new Error('Documentation sites require @unisphere/nx version 3.1.0 or higher.\n\n' +
+                'Your workspace is using an old npm workspaces pattern that prevents documentation sites ' +
+                'from having their own node_modules.\n\n' +
+                'Please upgrade by running:\n' +
+                '  npx nx migrate @unisphere/nx@latest\n' +
+                '  npx nx migrate --run-migrations\n\n' +
+                'This will update your workspace pattern to support documentation sites.');
+        }
+    }
+    const documentationName = options.name;
+    const documentationNameAsLowerDashCase = (0, devkit_1.names)(documentationName).fileName;
+    const projectRoot = `unisphere/documentation/${documentationNameAsLowerDashCase}`;
+    // Check if the documentation site already exists
+    if (tree.exists(projectRoot)) {
+        throw new Error(`Documentation site "${documentationNameAsLowerDashCase}" already exists at ${projectRoot}.\n` +
+            'Please choose a different name or remove the existing documentation site first.');
+    }
+    // Update .unisphere configuration
+    (0, utils_1.updateUnisphereConfig)(tree, 'documentation', documentationNameAsLowerDashCase, {
+        sourceRoot: projectRoot,
+    });
+    // Add documentation folder to .nxignore to prevent NX from scanning it
+    // Docusaurus has its own node_modules which can slow down NX
+    const nxIgnorePath = '.nxignore';
+    const ignoreEntry = `${projectRoot}/node_modules`;
+    let nxIgnoreContent = '';
+    if (tree.exists(nxIgnorePath)) {
+        nxIgnoreContent = tree.read(nxIgnorePath, 'utf-8') || '';
+    }
+    if (!nxIgnoreContent.includes(ignoreEntry)) {
+        const newContent = nxIgnoreContent
+            ? `${nxIgnoreContent.trimEnd()}\n\n# Documentation site (Docusaurus) - has its own node_modules\n${ignoreEntry}\n`
+            : `# Documentation site (Docusaurus) - has its own node_modules\n${ignoreEntry}\n`;
+        tree.write(nxIgnorePath, newContent);
+    }
+    await (0, devkit_1.formatFiles)(tree);
+    // Return a function that will be executed after all file operations are complete
+    return () => {
+        const workspaceRoot = process.cwd();
+        const fullProjectPath = path.join(workspaceRoot, projectRoot);
+        devkit_1.logger.info('');
+        devkit_1.logger.info('Setting up Docusaurus documentation site...');
+        devkit_1.logger.info('');
+        try {
+            // Create the parent directory if it doesn't exist
+            const parentDir = path.dirname(fullProjectPath);
+            if (!fs.existsSync(parentDir)) {
+                fs.mkdirSync(parentDir, { recursive: true });
+            }
+            // Run Docusaurus CLI to scaffold the project
+            // Docusaurus creates a self-contained project with its own package.json
+            // No NX integration needed - we just delegate to Docusaurus CLI for serve/build
+            // Use public npm registry explicitly (workspaces may have private registry configured)
+            devkit_1.logger.info('Running Docusaurus CLI...');
+            (0, child_process_1.execSync)(`npx --yes --registry https://registry.npmjs.org create-docusaurus@3 "${fullProjectPath}" classic --typescript`, {
+                stdio: 'inherit',
+                cwd: workspaceRoot,
+            });
+            devkit_1.logger.info('');
+            devkit_1.logger.info('Documentation site generated successfully!');
+            devkit_1.logger.info('');
+            devkit_1.logger.info(`Name: ${documentationNameAsLowerDashCase}`);
+            devkit_1.logger.info(`Type: Documentation Site (Docusaurus)`);
+            devkit_1.logger.info(`Location: ${projectRoot}`);
+            devkit_1.logger.info('');
+            devkit_1.logger.info(`To serve: npx unisphere documentation serve ${documentationNameAsLowerDashCase}`);
+            devkit_1.logger.info(`To build: npx unisphere documentation build ${documentationNameAsLowerDashCase}`);
+            devkit_1.logger.info('');
+        }
+        catch (error) {
+            devkit_1.logger.error('Failed to create Docusaurus project:');
+            devkit_1.logger.error(error instanceof Error ? error.message : String(error));
+            throw error;
+        }
+    };
+}
+exports.default = addDocumentationGenerator;

package/dist/generators/add-documentation/schema.d.ts

@@ -0,0 +1,3 @@
+export interface AddDocumentationGeneratorSchema {
+  name: string;
+}

package/dist/generators/add-documentation/schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "AddDocumentation",
+  "title": "Add Documentation Generator",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of the documentation site to create",
+      "pattern": "^[a-zA-Z][a-zA-Z0-9\\-\\s]*$",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What is the documentation site name? (letters, numbers, dashes and spaces allowed)"
+    }
+  },
+  "required": [
+    "name"
+  ]
+}

package/dist/generators/utils.d.ts

@@ -9,7 +9,7 @@ export interface UnisphereConfig {
 }
 export declare function validateUnisphereConfig(tree: Tree): UnisphereConfig;
 export declare function updateTsConfigPaths(tree: Tree, pathKey: string, pathValue: string): void;
-export declare function updateUnisphereConfig(tree: Tree, elementType: 'packages' | 'runtimes' | 'applications', elementName: string, elementConfig: Record<string, any>): void;
+export declare function updateUnisphereConfig(tree: Tree, elementType: 'packages' | 'runtimes' | 'applications' | 'documentation', elementName: string, elementConfig: Record<string, any>): void;
 export declare function validateRuntimeExists(tree: Tree, runtimeName: string): string;
 export declare function findCorePackageAlias(tree: Tree): string;
 /**

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,qBAAqB,CACnC,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,UAAU,GAAG,UAAU,GAAG,cAAc,EACrD,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;AA0BD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CA6BvD;AAsBD;;;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,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,CAQrG;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":"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,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;AA0BD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CA6BvD;AAsBD;;;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,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,CAQrG;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"}

package/dist/migrations/3-0-0/reorganize-applications-by-distribution-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reorganize-applications-by-distribution-channel.d.ts","sourceRoot":"","sources":["../../../src/migrations/3-0-0/reorganize-applications-by-distribution-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;EAQE;AAEF,OAAO,EACL,IAAI,EAOL,MAAM,YAAY,CAAC;AA8oBpB;;GAEG;AACH,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAyE9D"}
+{"version":3,"file":"reorganize-applications-by-distribution-channel.d.ts","sourceRoot":"","sources":["../../../src/migrations/3-0-0/reorganize-applications-by-distribution-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;EAQE;AAEF,OAAO,EACL,IAAI,EAML,MAAM,YAAY,CAAC;AAsmBpB;;GAEG;AACH,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAyE9D"}

package/dist/migrations/3-0-0/reorganize-applications-by-distribution-channel.js

@@ -11,49 +11,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = update;
 const devkit_1 = require("@nx/devkit");
+const generators_1 = require("@nx/workspace/generators");
 const child_process_1 = require("child_process");
-/**
- * Manually move all files from source to destination directory.
- * This avoids using moveGenerator which relies on the Nx project graph cache.
- * The project graph is read from disk, but during migrations the Tree (virtual FS)
- * may have changes that aren't flushed to disk yet, causing stale data issues.
- * Using manual move with Tree APIs ensures we always work with the correct state.
- */
-function moveProjectFiles(tree, sourcePath, destPath) {
-    const filesToMove = [];
-    // Collect all files to move
-    (0, devkit_1.visitNotIgnoredFiles)(tree, sourcePath, (filePath) => {
-        const relativePath = filePath.substring(sourcePath.length);
-        const newPath = `${destPath}${relativePath}`;
-        filesToMove.push({ source: filePath, dest: newPath });
-    });
-    // Move files (create at dest, delete at source)
-    for (const { source, dest } of filesToMove) {
-        const content = tree.read(source);
-        if (content !== null) {
-            tree.write(dest, content);
-            tree.delete(source);
-        }
-    }
-    devkit_1.logger.info(`  Moved ${filesToMove.length} files from ${sourcePath} to ${destPath}`);
-}
-/**
- * Update project.json after moving to new location
- */
-function updateProjectJsonAfterMove(tree, newPath, newProjectName) {
-    const projectJsonPath = `${newPath}/project.json`;
-    if (!tree.exists(projectJsonPath)) {
-        return;
-    }
-    const projectJson = (0, devkit_1.readJson)(tree, projectJsonPath);
-    // Update name if different
-    if (projectJson.name !== newProjectName) {
-        projectJson.name = newProjectName;
-    }
-    // Update sourceRoot to match new location
-    projectJson.sourceRoot = `${newPath}/src`;
-    (0, devkit_1.writeJson)(tree, projectJsonPath, projectJson);
-}
+const fs_1 = require("fs");
+const path_1 = require("path");
 /**
  * Reset Nx cache to ensure fresh project graph
  * This is important before moving projects, as Nx caches project locations
@@ -454,22 +415,33 @@ async function migrateApplication(tree, target) {
         devkit_1.logger.warn(`  Source project.json not found at ${sourceProjectJson}, skipping`);
         return;
     }
-    // Step 1: Manually move files using Tree APIs
-    // We avoid moveGenerator because it relies on the Nx project graph cache,
-    // which reads from disk. During migrations, the packages migration may have
-    // already moved packages in the Tree but those changes aren't flushed to disk
-    // yet, causing moveGenerator to use stale project locations.
-    // Since applications don't need import path updates (they're entry points),
-    // manual move is safe and reliable.
+    // Step 0: Clean node_modules from destination on disk if present.
+    // npm install may create node_modules/ at the target path (e.g. for workspace
+    // dependency resolution). tree.delete() only records a virtual deletion and
+    // doesn't remove on-disk children, so moveGenerator's checkDestination
+    // (which uses tree.children() -> readdirSync) would see node_modules and
+    // throw "Path is not empty". We must remove it from the real filesystem.
+    const destNodeModules = (0, path_1.join)(newPath, 'node_modules');
+    if ((0, fs_1.existsSync)(destNodeModules)) {
+        devkit_1.logger.info(`  Removing leftover node_modules at destination: ${destNodeModules}`);
+        (0, fs_1.rmSync)(destNodeModules, { recursive: true, force: true });
+    }
+    // Step 1: Use Nx moveGenerator for the heavy lifting
     try {
-        moveProjectFiles(tree, app.currentPath, newPath);
-        updateProjectJsonAfterMove(tree, newPath, newNxProjectName);
-        devkit_1.logger.info(`  Project moved successfully`);
+        await (0, generators_1.moveGenerator)(tree, {
+            projectName: app.currentNxProjectName,
+            destination: newPath,
+            newProjectName: newNxProjectName,
+            updateImportPath: false, // Applications are entry points, not libraries
+            skipFormat: true,
+        });
+        devkit_1.logger.info(`  Nx moved project successfully`);
         // Reset Nx cache after move to ensure fresh project graph for next operations
+        // This is important because moveGenerator uses the project graph, and it can become stale
         resetNxCache();
     }
     catch (error) {
-        devkit_1.logger.error(`  Failed to move project: ${error}`);
+        devkit_1.logger.error(`  Failed to move project with Nx: ${error}`);
         devkit_1.logger.error(`  Source path: ${app.currentPath}`);
         devkit_1.logger.error(`  Destination path: ${newPath}`);
         devkit_1.logger.error(`  Project name: ${app.currentNxProjectName}`);

package/dist/migrations/3-4-0/update-gitignore.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Migration: Update .gitignore to exclude Claude Code local settings
+ *
+ * Adds .claude/settings.local.json to .gitignore to prevent local Claude Code
+ * settings from being committed to the repository.
+ */
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=update-gitignore.d.ts.map

package/dist/migrations/3-4-0/update-gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-gitignore.d.ts","sourceRoot":"","sources":["../../../src/migrations/3-4-0/update-gitignore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAU,MAAM,YAAY,CAAC;AAE1C,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C9D"}

package/dist/migrations/3-4-0/update-gitignore.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Migration: Update .gitignore to exclude Claude Code local settings
+ *
+ * Adds .claude/settings.local.json to .gitignore to prevent local Claude Code
+ * settings from being committed to the repository.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+async function update(tree) {
+    devkit_1.logger.info('🔄 Updating .gitignore to exclude Claude Code local settings...');
+    const gitignorePath = '.gitignore';
+    if (!tree.exists(gitignorePath)) {
+        devkit_1.logger.warn('⚠️ .gitignore file not found, creating one');
+        tree.write(gitignorePath, '');
+    }
+    try {
+        const currentContent = tree.read(gitignorePath, 'utf-8') || '';
+        let updatedContent = currentContent;
+        // Check if .claude/settings.local.json is already in .gitignore
+        const claudeSettingsRegex = /^\.claude\/settings\.local\.json\s*$/gm;
+        if (!claudeSettingsRegex.test(updatedContent)) {
+            // Add Claude Code local settings section and entry
+            if (!updatedContent.includes('# Claude Code local settings')) {
+                updatedContent =
+                    updatedContent.trim() + '\n\n# Claude Code local settings\n';
+            }
+            if (!updatedContent.includes('.claude/settings.local.json')) {
+                updatedContent += '.claude/settings.local.json\n';
+                devkit_1.logger.info('📝 Added .claude/settings.local.json to .gitignore');
+            }
+            tree.write(gitignorePath, updatedContent);
+            devkit_1.logger.info('✅ Successfully updated .gitignore');
+        }
+        else {
+            devkit_1.logger.info('ℹ️ .claude/settings.local.json already exists in .gitignore');
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        devkit_1.logger.error(`❌ Failed to update .gitignore: ${errorMessage}`);
+        throw new Error(`Failed to update .gitignore: ${errorMessage}`);
+    }
+}

package/generators.json

@@ -15,6 +15,11 @@
       "schema": "./dist/generators/add-application/schema.json",
       "description": "add-application generator"
     },
+    "add-documentation": {
+      "factory": "./dist/generators/add-documentation/add-documentation",
+      "schema": "./dist/generators/add-documentation/schema.json",
+      "description": "Add a documentation site (Docusaurus)"
+    },
     "add-visual": {
       "factory": "./dist/generators/add-visual/add-visual",
       "schema": "./dist/generators/add-visual/schema.json",

package/migrations.json

@@ -282,6 +282,14 @@
       "cli": {
         "postUpdateMessage": "✅ npm workspaces pattern updated to use explicit includes. Documentation apps can now have their own node_modules."
       }
+    },
+    "3-4-0-update-gitignore": {
+      "version": "3.4.0",
+      "description": "Updates .gitignore to exclude Claude Code local settings",
+      "factory": "./dist/migrations/3-4-0/update-gitignore.js",
+      "cli": {
+        "postUpdateMessage": "✅ .gitignore updated to exclude .claude/settings.local.json"
+      }
     }
   },
   "packageJsonUpdates": {
@@ -439,4 +447,4 @@
       }
     }
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unisphere/nx",
-  "version": "3.2.4",
+  "version": "3.4.0",
   "private": false,
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -91,4 +91,4 @@
   "nx-migrations": {
     "migrations": "./migrations.json"
   }
-}
+}