@unisphere/nx 4.15.5 → 4.15.7

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;AAwEzD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,6BAA6B,uBA6KvC;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;AAwEzD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,6BAA6B,uBA4KvC;AAED,eAAe,uBAAuB,CAAC"}

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

@@ -115,16 +115,17 @@ async function addApplicationGenerator(tree, options) {
     (0, devkit_1.generateFiles)(tree, path.join(__dirname, templatePath), projectRoot, templateVariables);
     // For local-dev-playground apps, generate setup-local-runtimes.ts
     if (isPlayground) {
-        const rawConfig = (0, devkit_1.readJson)(tree, '.unisphere');
-        const experienceName = `unisphere.${rawConfig.type}.${rawConfig.name}`;
         const setupLocalRuntimesContent = `export function setupLocalRuntimes() {
   if (!process.env.LOCAL_RUNTIMES) return;
 
-  const runtimes: Record<string, { token: string; baseEnvName: string }> = {};
+  const runtimes: Record<string, Record<string, { token: string; baseEnvName: string }>> = {};
   process.env.LOCAL_RUNTIMES.split(',').forEach((entry) => {
-    const [name, port] = entry.split('@');
-    if (name && port) {
-      runtimes[name] = { token: port, baseEnvName: '' };
+    const [experience, name, port] = entry.split('@');
+    if (experience && name && port) {
+      if (!runtimes[experience]) {
+        runtimes[experience] = {};
+      }
+      runtimes[experience][name] = { token: port, baseEnvName: '' };
     }
   });
 
@@ -133,9 +134,7 @@ async function addApplicationGenerator(tree, options) {
     mode: 'integration',
     options: { verbose: 'inherit' },
     baseEnvScope: { core: 'inherit', presets: 'inherit' },
-    runtimes: {
-      '${experienceName}': runtimes,
-    },
+    runtimes,
   };
 
   (window as any).unisphereRuntimeOverrides = btoa(JSON.stringify(overrides));

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

@@ -66,7 +66,7 @@ export function App() {
           visuals: [
             <% if (!visualName) { %>/*<% } %>{
                 type: '<%= visualName ? visualName__camelCase : "~~provide-the-visual-name-to-mount-here~~" %>',
-                target: 'mainContainer',
+                target: { type: 'element', elementId: 'mainContainer' },
                 settings: {}<% if (visualName) { %> as <%= runtimeName__pascalCase %>Runtime<%= visualName__pascalCase %>VisualSettings<% } %>
               }<% if (!visualName) { %>*/<% } %>
           ],

package/dist/generators/add-documentation/templates/src/components/introductions/hello-world-experience.tsx

@@ -18,7 +18,10 @@ export const HelloWorldExperience = ({ preload }: { preload?: boolean }) => {
             if (runtime) {
                 const { unsubscribe } = runtime.mountVisual({
                     type: 'docs',
-                    target: 'hello-world-experience-container',
+                    target: {
+                        type: 'element',
+                        elementId: 'hello-world-experience-container',
+                    },
                     settings: {}
                 });
 

package/dist/generators/add-package/templates/new-package/src/languages/README.md

@@ -22,6 +22,22 @@ languages/
 - **`files/`** — Contains translated JSON files for each supported language (excluding en-US). These are generated via the Unisphere CLI export/import workflow.
 - **`_db/`** — Used internally by the CLI to track translation changes between exports. Do not commit.
 
+## Adding a New Language
+
+To add support for a new language, run:
+
+```bash
+npx unisphere language add <language-COUNTRY>
+```
+
+For example, to add Hebrew:
+
+```bash
+npx unisphere language add he-IL
+```
+
+This will set up the language files and update `supported-languages.ts` automatically.
+
 ## Adding Translations
 
 1. Add your translation keys to `en-US.json`

package/dist/generators/add-runtime/templates/new-runtime/src/languages/README.md

@@ -22,6 +22,22 @@ languages/
 - **`files/`** — Contains translated JSON files for each supported language (excluding en-US). These are generated via the Unisphere CLI export/import workflow.
 - **`_db/`** — Used internally by the CLI to track translation changes between exports. Do not commit.
 
+## Adding a New Language
+
+To add support for a new language, run:
+
+```bash
+npx unisphere language add <language-COUNTRY>
+```
+
+For example, to add Hebrew:
+
+```bash
+npx unisphere language add he-IL
+```
+
+This will set up the language files and update `supported-languages.ts` automatically.
+
 ## CLI Commands
 
 ```bash

package/dist/migrations/4-15-6/move-nx-to-dev-dependencies.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Migration: Move @unisphere/nx to devDependencies
+ *
+ * @unisphere/nx is a build/development tool (Nx plugin with generators and
+ * migrations) and should not be in production dependencies. This migration
+ * moves it from dependencies to devDependencies, preserving the existing version.
+ */
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=move-nx-to-dev-dependencies.d.ts.map

package/dist/migrations/4-15-6/move-nx-to-dev-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-nx-to-dev-dependencies.d.ts","sourceRoot":"","sources":["../../../src/migrations/4-15-6/move-nx-to-dev-dependencies.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAsB,MAAM,YAAY,CAAC;AAItD,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC9D"}

package/dist/migrations/4-15-6/move-nx-to-dev-dependencies.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Migration: Move @unisphere/nx to devDependencies
+ *
+ * @unisphere/nx is a build/development tool (Nx plugin with generators and
+ * migrations) and should not be in production dependencies. This migration
+ * moves it from dependencies to devDependencies, preserving the existing version.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+const TARGET_PACKAGE = '@unisphere/nx';
+async function update(tree) {
+    devkit_1.logger.info('🔄 Moving @unisphere/nx to devDependencies...');
+    const packageJsonPath = 'package.json';
+    if (!tree.exists(packageJsonPath)) {
+        devkit_1.logger.warn('⚠️ No package.json found, skipping');
+        return;
+    }
+    let moved = false;
+    (0, devkit_1.updateJson)(tree, packageJsonPath, (packageJson) => {
+        // If it's in dependencies, move it to devDependencies
+        if (packageJson.dependencies?.[TARGET_PACKAGE]) {
+            const version = packageJson.dependencies[TARGET_PACKAGE];
+            // Ensure devDependencies exists
+            if (!packageJson.devDependencies) {
+                packageJson.devDependencies = {};
+            }
+            // Move to devDependencies (preserve version)
+            packageJson.devDependencies[TARGET_PACKAGE] = version;
+            delete packageJson.dependencies[TARGET_PACKAGE];
+            moved = true;
+            devkit_1.logger.info(`📦 Moved ${TARGET_PACKAGE}@${version} from dependencies to devDependencies`);
+        }
+        return packageJson;
+    });
+    if (!moved) {
+        devkit_1.logger.info(`ℹ️ ${TARGET_PACKAGE} is not in dependencies (already in devDependencies or not present)`);
+    }
+    devkit_1.logger.info('✅ @unisphere/nx placement verified');
+}

package/dist/migrations/4-15-6/update-languages-readme.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Migration: Update languages README with "Adding a New Language" section
+ *
+ * Adds instructions for `npx unisphere language add <language-COUNTRY>`
+ * to all existing languages/README.md files.
+ */
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=update-languages-readme.d.ts.map

package/dist/migrations/4-15-6/update-languages-readme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-languages-readme.d.ts","sourceRoot":"","sources":["../../../src/migrations/4-15-6/update-languages-readme.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAoB,MAAM,YAAY,CAAC;AA2BpD,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAwD9D"}

package/dist/migrations/4-15-6/update-languages-readme.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * Migration: Update languages README with "Adding a New Language" section
+ *
+ * Adds instructions for `npx unisphere language add <language-COUNTRY>`
+ * to all existing languages/README.md files.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+const NEW_SECTION = `## Adding a New Language
+
+To add support for a new language, run:
+
+\`\`\`bash
+npx unisphere language add <language-COUNTRY>
+\`\`\`
+
+For example, to add Hebrew:
+
+\`\`\`bash
+npx unisphere language add he-IL
+\`\`\`
+
+This will set up the language files and update \`supported-languages.ts\` automatically.
+
+`;
+async function update(tree) {
+    devkit_1.logger.info('🔄 Updating languages README files...');
+    if (!tree.exists('.unisphere')) {
+        devkit_1.logger.info('ℹ️ No .unisphere config found, skipping');
+        return;
+    }
+    const config = (0, devkit_1.readJson)(tree, '.unisphere');
+    const packages = config.elements?.packages || {};
+    const runtimes = config.elements?.runtimes || {};
+    let updatedCount = 0;
+    const allElements = [
+        ...Object.entries(packages).map(([name, cfg]) => ({ name, sourceRoot: cfg.sourceRoot })),
+        ...Object.entries(runtimes).map(([name, cfg]) => ({ name, sourceRoot: cfg.sourceRoot })),
+    ];
+    for (const element of allElements) {
+        const readmePath = `${element.sourceRoot}/src/languages/README.md`;
+        if (!tree.exists(readmePath)) {
+            continue;
+        }
+        const content = tree.read(readmePath, 'utf-8');
+        if (!content) {
+            continue;
+        }
+        // Skip if already has the section
+        if (content.includes('npx unisphere language add')) {
+            continue;
+        }
+        // Insert before "## CLI Commands" or "## Adding Translations"
+        let updatedContent;
+        if (content.includes('## Adding Translations')) {
+            updatedContent = content.replace('## Adding Translations', NEW_SECTION + '## Adding Translations');
+        }
+        else if (content.includes('## CLI Commands')) {
+            updatedContent = content.replace('## CLI Commands', NEW_SECTION + '## CLI Commands');
+        }
+        else {
+            // Append at the end
+            updatedContent = content + '\n' + NEW_SECTION;
+        }
+        tree.write(readmePath, updatedContent);
+        updatedCount++;
+    }
+    if (updatedCount > 0) {
+        devkit_1.logger.info(`✅ Updated ${updatedCount} languages README file(s)`);
+    }
+    else {
+        devkit_1.logger.info('ℹ️ No README files needed updating');
+    }
+}

package/migrations.json

@@ -602,6 +602,22 @@
       "cli": {
         "postUpdateMessage": "✅ Fixed supported-languges.ts typo (renamed to supported-languages.ts)"
       }
+    },
+    "4.15.6-move-nx-to-dev-dependencies": {
+      "version": "4.15.6",
+      "description": "Moves @unisphere/nx from dependencies to devDependencies (build tool, not production dependency)",
+      "factory": "./dist/migrations/4-15-6/move-nx-to-dev-dependencies.js",
+      "cli": {
+        "postUpdateMessage": "✅ @unisphere/nx moved to devDependencies"
+      }
+    },
+    "4.15.6-update-languages-readme": {
+      "version": "4.15.6",
+      "description": "Adds 'Adding a New Language' instructions to languages README files",
+      "factory": "./dist/migrations/4-15-6/update-languages-readme.js",
+      "cli": {
+        "postUpdateMessage": "✅ Languages README files updated with 'npx unisphere language add' instructions"
+      }
     }
   },
   "packageJsonUpdates": {
@@ -1138,16 +1154,27 @@
         }
       }
     },
-    "4.15.4": {
-      "version": "4.15.4",
+    "4.15.6": {
+      "version": "4.15.6",
       "cli": "nx",
-      "postUpdateMessage": "🎉 Migration to @unisphere/nx 4.15.4 completed successfully!",
+      "postUpdateMessage": "🎉 Migration to @unisphere/nx 4.15.6 completed successfully!",
       "packages": {
         "@unisphere/cli": {
           "version": "6.1.1",
           "alwaysAddToPackageJson": false
         }
       }
+    },
+    "4.15.7": {
+      "version": "4.15.7",
+      "cli": "nx",
+      "postUpdateMessage": "🎉 Migration to @unisphere/nx 4.15.7 completed successfully!",
+      "packages": {
+        "@unisphere/cli": {
+          "version": "6.1.2",
+          "alwaysAddToPackageJson": false
+        }
+      }
     }
   }
 }

package/package.json

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