@unisphere/nx 3.24.0 → 4.0.0

package/README.md

@@ -1,4 +1,199 @@
 # Unisphere Workspace NX Plugin
 
+Official Nx plugin for Unisphere workspace development. This plugin provides generators and executors for creating and managing Unisphere runtimes, visuals, applications, and packages.
 
+## Features
 
+- Create and manage Unisphere runtimes
+- Add visuals to existing runtimes
+- Generate development applications
+- Create shared packages
+- Documentation site generation
+- Package management utilities
+
+## Installation
+
+This plugin is typically installed as part of a Unisphere workspace. If you need to install it manually:
+
+```bash
+npm install @unisphere/nx --save-dev
+```
+
+## Generators
+
+All generators are non-interactive and require explicit flags. Run any generator without flags to see available options and examples.
+
+### add-runtime
+
+Creates a new Unisphere runtime package.
+
+**Required flags:**
+- `--name`: The name of the runtime to create
+- `--consumer`: Runtime consumer type (`external` or `internal`)
+
+**Optional flags:**
+- `--dependencies`: Packages to install (comma-separated: `react`, `ds`, `mui`)
+- `--analyticsAppId`: Analytics app ID (number)
+
+**Example:**
+```bash
+nx g @unisphere/nx:add-runtime \
+  --name=my-runtime \
+  --consumer=external \
+  --dependencies=react,ds
+```
+
+### add-visual
+
+Adds a visual component to an existing runtime.
+
+**Required flags:**
+- `--runtimeName`: The name of the runtime to add the visual to
+- `--visualName`: The name of the visual to create
+
+**Optional flags:**
+- `--isSingleOccurrence`: Whether this visual is limited to single occurrence (default: `false`)
+
+**Example:**
+```bash
+nx g @unisphere/nx:add-visual \
+  --runtimeName=my-runtime \
+  --visualName=my-visual
+```
+
+### add-application
+
+Creates a development application for testing runtimes.
+
+**Required flags:**
+- `--name`: The name of the application to create
+- `--servingType`: How the app should be served
+  - `local-dev-playground`: Local development playground (default)
+  - `self-hosted`: Self-hosted application
+  - `iframe-with-post-messages`: iframe with post messages
+  - `assets-only`: Assets only
+
+**Optional flags:**
+- `--runtimeName`: Which runtime should the playground load
+- `--htmlPageTitle`: The HTML page title for your app
+- `--dependencies`: Packages to install (comma-separated: `ds`, `mui`, `react-hook-form`)
+
+**Example:**
+```bash
+nx g @unisphere/nx:add-application \
+  --name=my-dev-app \
+  --servingType=local-dev-playground \
+  --runtimeName=my-runtime
+```
+
+### add-package
+
+Creates a new shared package in the workspace.
+
+**Required flags:**
+- `--name`: The name of the package to create
+- `--type`: Package type
+  - `library`: Shared library
+  - `types`: TypeScript types package
+  - `configuration`: Configuration package
+
+**Optional flags:**
+- `--dependencies`: Packages to install (comma-separated: `react`, `ds`, `mui`)
+
+**Example:**
+```bash
+nx g @unisphere/nx:add-package \
+  --name=shared-utils \
+  --type=library \
+  --dependencies=react
+```
+
+### add-documentation
+
+Generates a documentation site for your workspace.
+
+**Required flags:**
+- `--title`: The title for the documentation site
+
+**Example:**
+```bash
+nx g @unisphere/nx:add-documentation \
+  --title="My Project Documentation"
+```
+
+### remove
+
+Removes a package from the workspace and cleans up all references.
+
+**Required flags:**
+- `--name`: The name of the package to remove
+
+**Example:**
+```bash
+nx g @unisphere/nx:remove --name=my-package
+```
+
+### rename-package
+
+Renames an existing package and updates all references.
+
+**Required flags:**
+- `--currentName`: Current package name
+- `--newName`: New package name
+
+**Example:**
+```bash
+nx g @unisphere/nx:rename-package \
+  --currentName=old-name \
+  --newName=new-name
+```
+
+### change-package-scope
+
+Changes the scope of a package (e.g., from `@company` to `@newcompany`).
+
+**Required flags:**
+- `--name`: Package name to update
+- `--newScope`: New scope (without `@` prefix)
+
+**Example:**
+```bash
+nx g @unisphere/nx:change-package-scope \
+  --name=my-package \
+  --newScope=newcompany
+```
+
+## Getting Help
+
+Forgot what flags are required? Just run any generator without flags and you'll get a helpful error message with examples:
+
+```bash
+$ nx g @unisphere/nx:add-runtime
+
+Error: Missing required option: 'name'
+  Description: The name of the runtime to create
+  Example: nx g @unisphere/nx:add-runtime --name=my-runtime --consumer=external
+```
+
+## Migration from Interactive Generators
+
+If you're upgrading from an older version that had interactive prompts, see the [Migration Guide](../../docs/migration/non-interactive-generators.md) for details on the changes and how to update your workflows.
+
+## Development
+
+### Testing Generators
+
+Run all generator tests:
+```bash
+npm test -- packages/nx/src/generators/
+```
+
+### Building the Plugin
+
+```bash
+nx build @unisphere/nx
+```
+
+## License
+
+See the root [LICENSE](../../LICENSE) file for details.

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,EAAgD,MAAM,YAAY,CAAC;AAE5G,OAAO,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAC;AAkHzD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,6BAA6B,uBAoLvC;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,EAAgD,MAAM,YAAY,CAAC;AAE5G,OAAO,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAC;AAyJzD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,6BAA6B,uBAuLvC;AAED,eAAe,uBAAuB,CAAC"}

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

@@ -6,6 +6,33 @@ const devkit_1 = require("@nx/devkit");
 const path = tslib_1.__importStar(require("path"));
 const utils_1 = require("../utils");
 const dependency_config_1 = require("../dependency-config");
+function validateOptions(options) {
+    if (!options.name || options.name.trim() === '') {
+        throw new Error(`Missing required option: 'name'\n` +
+            `  Description: The name of the application to create\n` +
+            `  Type: string\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Example: nx g @unisphere/nx:add-application --name=my-app --servingType=self-hosted`);
+    }
+    const namePattern = /^[a-zA-Z][a-zA-Z0-9\-\s]*$/;
+    if (!namePattern.test(options.name)) {
+        throw new Error(`Invalid value '${options.name}' for option 'name'\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Received: ${options.name}`);
+    }
+    if (!options.servingType) {
+        throw new Error(`Missing required option: 'servingType'\n` +
+            `  Description: How should this app be served?\n` +
+            `  Allowed values: local-dev-playground, self-hosted, iframe-with-post-messages, assets-only\n` +
+            `  Example: nx g @unisphere/nx:add-application --name=my-app --servingType=self-hosted`);
+    }
+    const allowedServingTypes = ['local-dev-playground', 'self-hosted', 'iframe-with-post-messages', 'assets-only'];
+    if (!allowedServingTypes.includes(options.servingType)) {
+        throw new Error(`Invalid value '${options.servingType}' for option 'servingType'\n` +
+            `  Allowed values: local-dev-playground, self-hosted, iframe-with-post-messages, assets-only\n` +
+            `  Received: ${options.servingType}`);
+    }
+}
 async function getEnquirerPrompt() {
     const enquirer = await import('enquirer');
     // Handle both CommonJS and ESM exports
@@ -74,6 +101,8 @@ async function promptForDependencies(_isPlayground) {
     return response.dependencies;
 }
 async function addApplicationGenerator(tree, options) {
+    // Validate options
+    validateOptions(options);
     // Validate iframe-with-post-messages is not supported
     if (options.servingType === 'iframe-with-post-messages') {
         throw new Error('iframe-with-post-messages serving type is not currently supported. Please choose a different serving type.');

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

@@ -11,35 +11,18 @@
       "$default": {
         "$source": "argv",
         "index": 0
-      },
-      "x-prompt": "What is the application name? (letters, numbers, dashes and spaces allowed)"
+      }
     },
     "servingType": {
       "type": "string",
       "description": "How should this app be served?",
       "default": "local-dev-playground",
-      "x-prompt": {
-        "message": "Which serving type do you want?",
-        "type": "list",
-        "items": [
-          {
-            "value": "local-dev-playground",
-            "label": "Runtime Dev Playground (for development purposes)"
-          },
-          {
-            "value": "self-hosted",
-            "label": "Standalone Application"
-          },
-          {
-            "value": "iframe-with-post-messages",
-            "label": "Iframe + Post Messages (suitible to applications that gets required configuration from post messages)"
-          },
-          {
-            "value": "assets-only",
-            "label": "Assets Only (static assets served via CDN, no application logic)"
-          }
-        ]
-      }
+      "enum": [
+        "local-dev-playground",
+        "self-hosted",
+        "iframe-with-post-messages",
+        "assets-only"
+      ]
     },
     "runtimeName": {
       "type": "string",

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

@@ -1 +1 @@
-{"version":3,"file":"add-documentation.d.ts","sourceRoot":"","sources":["../../../src/generators/add-documentation/add-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAiB,MAAM,YAAY,CAAC;AAG7E,OAAO,EAAE,+BAA+B,EAAE,MAAM,UAAU,CAAC;AAa3D,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,+BAA+B,qCA+JzC;AAED,eAAe,yBAAyB,CAAC"}
+{"version":3,"file":"add-documentation.d.ts","sourceRoot":"","sources":["../../../src/generators/add-documentation/add-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAiB,MAAM,YAAY,CAAC;AAG7E,OAAO,EAAE,+BAA+B,EAAE,MAAM,UAAU,CAAC;AA0C3D,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,+BAA+B,qCA6IzC;AAED,eAAe,yBAAyB,CAAC"}

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

@@ -7,11 +7,34 @@ const child_process_1 = require("child_process");
 const path = tslib_1.__importStar(require("path"));
 const utils_1 = require("../utils");
 const discover_typedoc_plugins_1 = require("./discover-typedoc-plugins");
-async function getEnquirerPrompt() {
-    const enquirer = await import('enquirer');
-    return enquirer.prompt || enquirer.default?.prompt || enquirer;
+function validateOptions(options) {
+    if (options.name) {
+        const namePattern = /^[a-zA-Z][a-zA-Z0-9\-\s]*$/;
+        if (!namePattern.test(options.name)) {
+            throw new Error(`Invalid value '${options.name}' for option 'name'\n` +
+                `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+                `  Received: ${options.name}`);
+        }
+    }
+    if (!options.isExperienceLevel && options.subName) {
+        const subNamePattern = /^[a-zA-Z][a-zA-Z0-9\-\s]*$/;
+        if (!subNamePattern.test(options.subName)) {
+            throw new Error(`Invalid value '${options.subName}' for option 'subName'\n` +
+                `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+                `  Received: ${options.subName}`);
+        }
+    }
+    if (!options.isExperienceLevel && !options.subName) {
+        throw new Error(`Missing required option: 'subName'\n` +
+            `  Description: Sub-name for the documentation site (used when not experience-level)\n` +
+            `  Type: string\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Example: nx g @unisphere/nx:add-documentation --subName=api-docs`);
+    }
 }
 async function addDocumentationGenerator(tree, options) {
+    // Validate options
+    validateOptions(options);
     // Validate .unisphere configuration exists
     const unisphereConfig = (0, utils_1.validateUnisphereConfig)(tree);
     // Check workspace pattern for documentation apps
@@ -35,28 +58,8 @@ async function addDocumentationGenerator(tree, options) {
     const documentationName = options.name || unisphereConfig.name;
     const documentationNameAsLowerDashCase = (0, devkit_1.names)(documentationName).fileName;
     devkit_1.logger.info(`Using experience name: ${documentationNameAsLowerDashCase}`);
-    // If not experience-level, prompt for sub-name
-    let subName = options.subName;
-    if (!options.isExperienceLevel && !subName) {
-        const prompt = await getEnquirerPrompt();
-        const response = await prompt({
-            type: 'input',
-            name: 'subName',
-            message: 'What is the documentation sub-name? (letters, numbers, dashes and spaces allowed)',
-            validate: (value) => {
-                if (!value || !value.trim()) {
-                    return 'Sub-name is required for non-experience-level documentation sites';
-                }
-                if (!/^[a-zA-Z][a-zA-Z0-9\-\s]*$/.test(value)) {
-                    return 'Sub-name must start with a letter and contain only letters, numbers, dashes and spaces';
-                }
-                return true;
-            },
-        });
-        subName = response.subName;
-    }
     // Build the full documentation name
-    const subNameAsLowerDashCase = subName ? (0, devkit_1.names)(subName).fileName : null;
+    const subNameAsLowerDashCase = options.subName ? (0, devkit_1.names)(options.subName).fileName : null;
     const fullDocumentationName = subNameAsLowerDashCase
         ? `${documentationNameAsLowerDashCase}-${subNameAsLowerDashCase}`
         : documentationNameAsLowerDashCase;

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,EAAgD,MAAM,YAAY,CAAC;AAE5G,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AA4DrD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,yBAAyB,uBAqHnC;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,EAAgD,MAAM,YAAY,CAAC;AAE5G,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AA8GrD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,yBAAyB,uBAwHnC;AAED,eAAe,mBAAmB,CAAC"}

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

@@ -6,6 +6,41 @@ const devkit_1 = require("@nx/devkit");
 const path = tslib_1.__importStar(require("path"));
 const utils_1 = require("../utils");
 const dependency_config_1 = require("../dependency-config");
+function validateOptions(options) {
+    if (!options.packageName || options.packageName.trim() === '') {
+        throw new Error(`Missing required option: 'packageName'\n` +
+            `  Description: The name of the package to create\n` +
+            `  Type: string\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Example: nx g @unisphere/nx:add-package --packageName=my-package --scope=local`);
+    }
+    const namePattern = /^[a-zA-Z][a-zA-Z0-9\-\s]*$/;
+    if (!namePattern.test(options.packageName)) {
+        throw new Error(`Invalid value '${options.packageName}' for option 'packageName'\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Received: ${options.packageName}`);
+    }
+    if (!options.scope) {
+        throw new Error(`Missing required option: 'scope'\n` +
+            `  Description: The distribution scope of the package\n` +
+            `  Allowed values: local, kaltura-corp, unisphere, kaltura-ui, kaltura-apps, kaltura-sdk\n` +
+            `  Example: nx g @unisphere/nx:add-package --packageName=my-package --scope=local`);
+    }
+    const allowedScopes = ['local', 'kaltura-corp', 'unisphere', 'kaltura-ui', 'kaltura-apps', 'kaltura-sdk'];
+    if (!allowedScopes.includes(options.scope)) {
+        throw new Error(`Invalid value '${options.scope}' for option 'scope'\n` +
+            `  Allowed values: ${allowedScopes.join(', ')}\n` +
+            `  Received: ${options.scope}`);
+    }
+    if (options.dependencies) {
+        const allowedDeps = ['react', 'ds', 'mui'];
+        const invalidDeps = options.dependencies.filter(dep => !allowedDeps.includes(dep));
+        if (invalidDeps.length > 0) {
+            throw new Error(`Invalid dependencies: ${invalidDeps.join(', ')}\n` +
+                `  Allowed values: ${allowedDeps.join(', ')}`);
+        }
+    }
+}
 /**
  * Resolves the @unisphere/runtime version from the workspace's root package.json
  * Falls back to a default version if not found
@@ -37,6 +72,8 @@ function resolveUnisphereRuntimeVersion(tree) {
     }
 }
 async function addPackageGenerator(tree, options) {
+    // Validate options
+    validateOptions(options);
     // Validate and read .unisphere configuration
     const unisphereConfig = (0, utils_1.validateUnisphereConfig)(tree);
     // Validate dependencies

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

@@ -7,43 +7,13 @@
     "packageName": {
       "type": "string",
       "description": "The name of the package to create",
-      "pattern": "^[a-zA-Z][a-zA-Z0-9\\-\\s]*$",
-      "x-prompt": "What is the package name? (alphanumeric with dashes and spaces allowed)"
+      "pattern": "^[a-zA-Z][a-zA-Z0-9\\-\\s]*$"
     },
     "scope": {
       "type": "string",
       "description": "The distribution scope of the package",
-      "default": "local",
-      "x-prompt": {
-        "message": "What scope should this package have? If you're unsure, choose Local.",
-        "type": "list",
-        "items": [
-          {
-            "value": "local",
-            "label": "Local – This repository only (not published to npm)"
-          },
-          {
-            "value": "kaltura-corp",
-            "label": "Kaltura Corp – For Kaltura repositories only (jfrog scope: @kaltura-corp/...)"
-          },
-          {
-            "value": "unisphere",
-            "label": "Unisphere – For all Unisphere workspace consumers (npm scope: @unisphere/...)"
-          },
-          {
-            "value": "kaltura-ui",
-            "label": "Kaltura UI – UI components for standalone use (npm scope: @kaltura-ui/...)"
-          },
-          {
-            "value": "kaltura-apps",
-            "label": "Kaltura Apps – Application packages for standalone use (npm scope: @kaltura-apps/...)"
-          },
-          {
-            "value": "kaltura-sdk",
-            "label": "Kaltura SDK – SDK packages for standalone use (npm scope: @kaltura-sdk/...)"
-          }
-        ]
-      }
+      "enum": ["local", "kaltura-corp", "unisphere", "kaltura-ui", "kaltura-apps", "kaltura-sdk"],
+      "default": "local"
     },
     "dependencies": {
       "type": "array",
@@ -56,26 +26,7 @@
           "mui"
         ]
       },
-      "default": [],
-      "x-prompt": {
-        "message": "Select dependencies to install (use space to select, enter to confirm):",
-        "type": "list",
-        "multiselect": true,
-        "items": [
-          {
-            "value": "react",
-            "label": "React - UI library for building components"
-          },
-          {
-            "value": "ds",
-            "label": "Kaltura DS - Design System (requires GIT_TOKEN)"
-          },
-          {
-            "value": "mui",
-            "label": "Material UI - Component library"
-          }
-        ]
-      }
+      "default": []
     }
   },
   "required": [

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

@@ -1 +1 @@
-{"version":3,"file":"add-runtime.d.ts","sourceRoot":"","sources":["../../../src/generators/add-runtime/add-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAsC,MAAM,YAAY,CAAC;AAElG,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAqFrD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,yBAAyB,uBA6InC;AAED,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"add-runtime.d.ts","sourceRoot":"","sources":["../../../src/generators/add-runtime/add-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAsC,MAAM,YAAY,CAAC;AAElG,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAgFrD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,yBAAyB,uBA+GnC;AAED,eAAe,mBAAmB,CAAC"}

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

@@ -6,41 +6,31 @@ const devkit_1 = require("@nx/devkit");
 const path = tslib_1.__importStar(require("path"));
 const utils_1 = require("../utils");
 const dependency_config_1 = require("../dependency-config");
-const add_application_1 = require("../add-application/add-application");
-const add_visual_1 = require("../add-visual/add-visual");
-async function getEnquirerPrompt() {
-    const enquirer = await import('enquirer');
-    // Handle both CommonJS and ESM exports
-    return enquirer.prompt || enquirer.default?.prompt || enquirer;
-}
-async function promptForAddVisual() {
-    const prompt = await getEnquirerPrompt();
-    const response = await prompt({
-        type: 'confirm',
-        name: 'addVisual',
-        message: 'Would you like to add a visual to this runtime?',
-        initial: true,
-    });
-    return response.addVisual;
-}
-async function promptForAnalyticsAppId(existingValue) {
-    if (existingValue !== undefined) {
-        return existingValue;
+function validateOptions(options) {
+    if (!options.name || options.name.trim() === '') {
+        throw new Error(`Missing required option: 'name'\n` +
+            `  Description: The name of the runtime to create\n` +
+            `  Type: string\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Example: nx g @unisphere/nx:add-runtime --name=my-runtime --consumer=external`);
+    }
+    const namePattern = /^[a-zA-Z][a-zA-Z0-9\-\s]*$/;
+    if (!namePattern.test(options.name)) {
+        throw new Error(`Invalid value '${options.name}' for option 'name'\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Received: ${options.name}`);
+    }
+    if (!options.consumer) {
+        throw new Error(`Missing required option: 'consumer'\n` +
+            `  Description: Is this runtime loaded from within the same experience or by an external consumer?\n` +
+            `  Allowed values: external, internal\n` +
+            `  Example: nx g @unisphere/nx:add-runtime --name=my-runtime --consumer=external`);
+    }
+    if (!['external', 'internal'].includes(options.consumer)) {
+        throw new Error(`Invalid value '${options.consumer}' for option 'consumer'\n` +
+            `  Allowed values: external, internal\n` +
+            `  Received: ${options.consumer}`);
     }
-    const prompt = await getEnquirerPrompt();
-    const response = await prompt({
-        type: 'input',
-        name: 'analyticsAppId',
-        message: 'Provide the analytics app id (number). If you are not certain, leave it empty and later update the runtime constructor.',
-        validate: (input) => {
-            if (input === '')
-                return true; // Allow empty
-            const num = Number(input);
-            return !isNaN(num) && Number.isInteger(num) ? true : 'Please enter a valid integer or leave empty';
-        },
-    });
-    const value = response.analyticsAppId;
-    return value === '' ? undefined : Number(value);
 }
 function updateTypesIndexExport(tree, runtimeName, basePath) {
     const indexPath = `${basePath}/src/index.ts`;
@@ -61,6 +51,7 @@ function updateTypesIndexExport(tree, runtimeName, basePath) {
     tree.write(indexPath, updatedContent);
 }
 async function addRuntimeGenerator(tree, options) {
+    validateOptions(options);
     // Normalize consumer option - Nx list prompts may return string labels instead of boolean values
     let isExternal = options?.consumer === 'external' ? true : false;
     // Validate and read .unisphere configuration
@@ -74,10 +65,7 @@ async function addRuntimeGenerator(tree, options) {
     let userInputRuntimeName = (0, devkit_1.names)(options.name).fileName;
     // Find types package (or fallback to core)
     const typesPackageInfo = (0, utils_1.findTypesOrCorePackageInfo)(tree);
-    // Prompt for analyticsAppId only if isExternal is true
-    const analyticsAppId = isExternal
-        ? await promptForAnalyticsAppId(options.analyticsAppId)
-        : options.analyticsAppId;
+    const analyticsAppId = options.analyticsAppId;
     // Prepare template variables
     const templateVariables = {
         companyName,
@@ -116,31 +104,6 @@ async function addRuntimeGenerator(tree, options) {
     const runtimePathKey = `unisphere-runtime-${userInputRuntimeName}`;
     const runtimePathValue = `unisphere/runtimes/${userInputRuntimeName}/src/index.ts`;
     (0, utils_1.updateTsConfigPaths)(tree, runtimePathKey, runtimePathValue);
-    // Prompt to add a visual to the new runtime
-    const shouldAddVisual = await promptForAddVisual();
-    let visualName = '';
-    if (shouldAddVisual) {
-        const visualTask = await (0, add_visual_1.addVisualGenerator)(tree, {
-            runtimeName: userInputRuntimeName,
-        });
-        const visualResponse = await visualTask();
-        visualName = visualResponse.visualName;
-    }
-    let applicationScriptName = '';
-    // Handle internal usage - create dev application
-    if (!!isExternal) {
-        // Create a dev application without prompts
-        const appTask = await (0, add_application_1.addApplicationGenerator)(tree, {
-            name: `${userInputRuntimeName}-dev`,
-            servingType: 'local-dev-playground',
-            runtimeName: userInputRuntimeName,
-            visualName,
-            skipDynamicRuntimeVisualPrompt: true, // Skip the runtime/visual selection prompts since we already have the info
-            dependencies: selectedDependencies, // Pass same dependencies as runtime
-        });
-        applicationScriptName = `serve:${userInputRuntimeName}-dev`;
-        await appTask();
-    }
     // Install selected dependencies
     (0, dependency_config_1.installSelectedDependencies)(tree, selectedDependencies);
     await (0, devkit_1.formatFiles)(tree);
@@ -152,14 +115,14 @@ async function addRuntimeGenerator(tree, options) {
         devkit_1.logger.info('');
         devkit_1.logger.info(`🚀 Runtime Name: ${userInputRuntimeName}`);
         devkit_1.logger.info(`📁 Location: ${projectRoot}`);
-        devkit_1.logger.info(`Analytics App ID: ${analyticsAppId}`);
-        devkit_1.logger.info(`🔧 Consumer: ${isExternal ? 'External' : 'Internal'}`);
-        if (applicationScriptName) {
-            devkit_1.logger.info('');
-            devkit_1.logger.info('📦 Additional components created:');
-            devkit_1.logger.info(`   • Dev Application: ${userInputRuntimeName}-dev`);
-            devkit_1.logger.info(`.    📜 To run the dev application locally: npm run ${applicationScriptName}`);
+        if (analyticsAppId) {
+            devkit_1.logger.info(`📊 Analytics App ID: ${analyticsAppId}`);
         }
+        devkit_1.logger.info(`🔧 Consumer: ${isExternal ? 'External' : 'Internal'}`);
+        devkit_1.logger.info('');
+        devkit_1.logger.info('📝 Next steps:');
+        devkit_1.logger.info(`   1. Add a visual: nx g @unisphere/nx:add-visual --runtimeName=${userInputRuntimeName}`);
+        devkit_1.logger.info(`   2. Add a dev app: nx g @unisphere/nx:add-application --name=${userInputRuntimeName}-dev --runtimeName=${userInputRuntimeName}`);
         devkit_1.logger.info('');
     };
 }

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

@@ -1,6 +1,6 @@
 export interface AddRuntimeGeneratorSchema {
   name: string;
-  consumer: string;
+  consumer: 'external' | 'internal';
   dependencies?: string[];
   analyticsAppId?: number;
 }