@unisphere/nx 3.2.3 → 3.3.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;AAElG,OAAO,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAC;AAkHzD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,6BAA6B,uBAoIvC;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

@@ -60,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,7 +81,9 @@ async function addApplicationGenerator(tree, options) {
     const isPlayground = options.servingType === 'local-dev-playground';
     // Validate and read .unisphere configuration
     const unisphereConfig = (0, utils_1.validateUnisphereConfig)(tree);
-    const { runtimeName, visualName } = await promptForRuntimeName(unisphereConfig.runtimes, options.runtimeName || '', options.visualName || '', options.skipDynamicRuntimeVisualPrompt || false);
+    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();
     }
@@ -103,7 +105,6 @@ async function addApplicationGenerator(tree, options) {
         applicationName += '-dev';
     }
     const applicationNameAsLowerDashCase = (0, devkit_1.names)(applicationName).fileName;
-    // Find types package (or fallback to core)
     const typesPackageInfo = (0, utils_1.findTypesOrCorePackageInfo)(tree);
     // Determine subdirectory based on serving type
     // local-dev-playground -> local/, other types -> server/

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/internal-dev-runner/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/generators/internal-dev-runner/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAalC,wBAA8B,sBAAsB,CAAC,IAAI,EAAE,IAAI,iBAsC9D"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/generators/internal-dev-runner/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAclC,wBAA8B,sBAAsB,CAAC,IAAI,EAAE,IAAI,iBAuC9D"}

package/dist/generators/internal-dev-runner/generator.js

@@ -11,7 +11,8 @@ const tslib_1 = require("tslib");
 // import reorganizeApplicationsByDistributionChannel from '../../migrations/3-0-0/reorganize-applications-by-distribution-channel';
 // import upgradeSchemaTo2 from '../../migrations/3-0-0/upgrade-schema-to-2-0-0';
 // import postCleanupEmptyDirectories from '../../migrations/3-0-0/post-cleanup-empty-directories';
-const remove_private_from_applications_and_runtimes_1 = tslib_1.__importDefault(require("../../migrations/3-0-0/remove-private-from-applications-and-runtimes"));
+// import removePrivateFromApplicationsAndRuntimes from '../../migrations/3-0-0/remove-private-from-applications-and-runtimes';
+const fix_workspaces_pattern_1 = tslib_1.__importDefault(require("../../migrations/3-1-0/fix-workspaces-pattern"));
 async function testMigrationGenerator(tree) {
     // Collect all callbacks to run after all migrations complete
     // const callbacks: (() => void)[] = [];
@@ -29,7 +30,8 @@ async function testMigrationGenerator(tree) {
     // Upgrade schema to 2.0.0 and remove distributionChannel from packages
     // await upgradeSchemaTo2(tree);
     // Remove private field from applications, runtimes, and packages
-    await (0, remove_private_from_applications_and_runtimes_1.default)(tree);
+    // await removePrivateFromApplicationsAndRuntimes(tree);
+    await (0, fix_workspaces_pattern_1.default)(tree);
     // Post-cleanup: Remove empty directories after reorganization
     // const postCleanupCallback = await postCleanupEmptyDirectories(tree);
     // if (postCleanupCallback) {

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-1-0/fix-workspaces-pattern.d.ts

@@ -0,0 +1,23 @@
+import { Tree } from '@nx/devkit';
+/**
+ * Migration: Fix npm workspaces pattern to use explicit includes
+ *
+ * This migration updates the root package.json workspaces array to use
+ * explicit include patterns instead of a catch-all pattern with exclusions.
+ *
+ * The problem with "unisphere/**" + "!unisphere/applications/documentation/**"
+ * is that npm's negation patterns don't work reliably. This caused documentation
+ * apps (like Docusaurus) to be unable to have their own node_modules.
+ *
+ * The fix is to use explicit patterns that only include what should be workspaces:
+ * - unisphere/packages/**
+ * - unisphere/runtimes/**
+ * - unisphere/visuals/**
+ * - unisphere/applications/local/**
+ * - unisphere/applications/server/**
+ *
+ * This automatically excludes unisphere/applications/documentation/** without
+ * needing a negation pattern.
+ */
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=fix-workspaces-pattern.d.ts.map

package/dist/migrations/3-1-0/fix-workspaces-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-workspaces-pattern.d.ts","sourceRoot":"","sources":["../../../src/migrations/3-1-0/fix-workspaces-pattern.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAA+B,MAAM,YAAY,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA8D9D"}

package/dist/migrations/3-1-0/fix-workspaces-pattern.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+/**
+ * Migration: Fix npm workspaces pattern to use explicit includes
+ *
+ * This migration updates the root package.json workspaces array to use
+ * explicit include patterns instead of a catch-all pattern with exclusions.
+ *
+ * The problem with "unisphere/**" + "!unisphere/applications/documentation/**"
+ * is that npm's negation patterns don't work reliably. This caused documentation
+ * apps (like Docusaurus) to be unable to have their own node_modules.
+ *
+ * The fix is to use explicit patterns that only include what should be workspaces:
+ * - unisphere/packages/**
+ * - unisphere/runtimes/**
+ * - unisphere/visuals/**
+ * - unisphere/applications/local/**
+ * - unisphere/applications/server/**
+ *
+ * This automatically excludes unisphere/applications/documentation/** without
+ * needing a negation pattern.
+ */
+async function update(tree) {
+    devkit_1.logger.info('🔄 Fixing npm workspaces pattern to use explicit includes');
+    const packageJsonPath = 'package.json';
+    if (!tree.exists(packageJsonPath)) {
+        devkit_1.logger.warn('No package.json found, skipping migration');
+        return;
+    }
+    const packageJson = (0, devkit_1.readJson)(tree, packageJsonPath);
+    if (!packageJson.workspaces || !Array.isArray(packageJson.workspaces)) {
+        devkit_1.logger.warn('No workspaces array found in package.json, skipping migration');
+        return;
+    }
+    const oldWorkspaces = packageJson.workspaces;
+    // Check if using the old catch-all pattern
+    const hasCatchAllPattern = oldWorkspaces.includes('unisphere/**');
+    const hasNegationPattern = oldWorkspaces.some((pattern) => pattern.startsWith('!'));
+    if (!hasCatchAllPattern && !hasNegationPattern) {
+        // Check if already using explicit patterns
+        const expectedPatterns = [
+            'unisphere/packages/**',
+            'unisphere/runtimes/**',
+            'unisphere/visuals/**',
+            'unisphere/applications/local/**',
+            'unisphere/applications/server/**',
+        ];
+        const hasAllExpectedPatterns = expectedPatterns.every(pattern => oldWorkspaces.includes(pattern));
+        if (hasAllExpectedPatterns) {
+            devkit_1.logger.info('Workspaces already using explicit patterns, skipping migration');
+            return;
+        }
+    }
+    // Replace with explicit patterns
+    const newWorkspaces = [
+        'unisphere/packages/**',
+        'unisphere/runtimes/**',
+        'unisphere/visuals/**',
+        'unisphere/applications/local/**',
+        'unisphere/applications/server/**',
+    ];
+    packageJson.workspaces = newWorkspaces;
+    (0, devkit_1.writeJson)(tree, packageJsonPath, packageJson);
+    devkit_1.logger.info('✅ Updated workspaces from:');
+    devkit_1.logger.info(`   ${JSON.stringify(oldWorkspaces)}`);
+    devkit_1.logger.info('   to:');
+    devkit_1.logger.info(`   ${JSON.stringify(newWorkspaces)}`);
+    devkit_1.logger.info('');
+    devkit_1.logger.info('This allows documentation apps (like Docusaurus) to have their own node_modules.');
+}

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

@@ -273,7 +273,15 @@
     "3-0-0-remove-pre-install": {
       "version": "3.0.0",
       "description": "Removes kaltura-tools preinstall script from package.json",
-      "factory": "./dist/migrations/3-0-0/remove-kaltura-tools-to-pre-install.js",
+      "factory": "./dist/migrations/3-0-0/remove-kaltura-tools-to-pre-install.js"
+    },
+    "3-1-0-fix-workspaces-pattern": {
+      "version": "3.1.0",
+      "description": "Fixes npm workspaces pattern to use explicit includes instead of catch-all with exclusions",
+      "factory": "./dist/migrations/3-1-0/fix-workspaces-pattern.js",
+      "cli": {
+        "postUpdateMessage": "✅ npm workspaces pattern updated to use explicit includes. Documentation apps can now have their own node_modules."
+      }
     }
   },
   "packageJsonUpdates": {

package/package.json

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