@unisphere/nx 4.15.4 → 4.15.6

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

@@ -7,7 +7,7 @@ This folder contains the internationalization (i18n) setup for this package.
 ```
 languages/
 ├── en-US.json              # Default English translations (source of truth)
-├── supported-languges.ts   # List of supported language codes
+├── supported-languages.ts   # List of supported language codes
 ├── files/                  # Translated language files (e.g., de-DE.json, fr-FR.json)
 │   └── .gitkeep
 ├── _db/                    # Translation database for change tracking (git-ignored)
@@ -18,16 +18,32 @@ languages/
 ## How It Works
 
 - **`en-US.json`** — The master translation file. All keys are defined here in English.
-- **`supported-languges.ts`** — Exports the list of supported language codes. Add new languages here when translations are available.
+- **`supported-languages.ts`** — Exports the list of supported language codes. Add new languages here when translations are available.
 - **`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`
 2. Run `npx unisphere languages export` to generate CSV files for translators
 3. After receiving translations, run `npx unisphere languages import` to update the `files/` directory
-4. Add the new language code to `supported-languges.ts`
+4. Add the new language code to `supported-languages.ts`
 
 ## Usage
 

package/dist/generators/add-package/templates/new-package/src/lib/use-translation.tsx.template

@@ -1,6 +1,6 @@
 import en from '../languages/en-US.json';
 import { createUseTranslation } from '@unisphere/ui-i18n-react';
-import { supportedLanguages } from '../languages/supported-languges';
+import { supportedLanguages } from '../languages/supported-languages';
 
 export const useTranslation = createUseTranslation({
   packageName: '<%= packageJsonName %>',

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

@@ -7,7 +7,7 @@ This folder contains the internationalization (i18n) setup for this runtime.
 ```
 languages/
 ├── en-US.json              # Default English translations (source of truth)
-├── supported-languges.ts   # List of supported language codes
+├── supported-languages.ts   # List of supported language codes
 ├── files/                  # Translated language files (e.g., de-DE.json, fr-FR.json)
 │   └── .gitkeep
 ├── _db/                    # Translation database for change tracking (git-ignored)
@@ -18,10 +18,26 @@ languages/
 ## How It Works
 
 - **`en-US.json`** — The master translation file. All keys are defined here in English.
-- **`supported-languges.ts`** — Exports the list of supported language codes. Add new languages here when translations are available.
+- **`supported-languages.ts`** — Exports the list of supported language codes. Add new languages here when translations are available.
 - **`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/generators/add-runtime/templates/new-runtime/src/lib/use-translation.tsx.template

@@ -1,6 +1,6 @@
 import en from '../languages/en-US.json';
 import { createUseTranslation } from '@unisphere/ui-i18n-react';
-import { supportedLanguages } from '../languages/supported-languges';
+import { supportedLanguages } from '../languages/supported-languages';
 
 export const useTranslation = createUseTranslation({
   packageName: 'self',

package/dist/migrations/4-15-5/fix-supported-languages-typo.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Migration: Fix supported-languges.ts typo
+ *
+ * Renames supported-languges.ts to supported-languages.ts (fixes missing "a")
+ * and updates all imports that reference the old filename.
+ */
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=fix-supported-languages-typo.d.ts.map

package/dist/migrations/4-15-5/fix-supported-languages-typo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-supported-languages-typo.d.ts","sourceRoot":"","sources":["../../../src/migrations/4-15-5/fix-supported-languages-typo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAuD,MAAM,YAAY,CAAC;AAcvF,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA4E9D"}

package/dist/migrations/4-15-5/fix-supported-languages-typo.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Migration: Fix supported-languges.ts typo
+ *
+ * Renames supported-languges.ts to supported-languages.ts (fixes missing "a")
+ * and updates all imports that reference the old filename.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+const TYPO_FILENAME = 'supported-languges.ts';
+const FIXED_FILENAME = 'supported-languages.ts';
+const TYPO_IMPORT = 'supported-languges';
+const FIXED_IMPORT = 'supported-languages';
+async function update(tree) {
+    devkit_1.logger.info('🔄 Fixing supported-languges.ts typo...');
+    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 fixedCount = 0;
+    // Process all packages and runtimes
+    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 { name, sourceRoot } = element;
+        const typoPath = `${sourceRoot}/src/languages/${TYPO_FILENAME}`;
+        const fixedPath = `${sourceRoot}/src/languages/${FIXED_FILENAME}`;
+        // Step 1: Rename the file if it exists with the typo
+        if (tree.exists(typoPath)) {
+            const content = tree.read(typoPath, 'utf-8');
+            tree.write(fixedPath, content || '');
+            tree.delete(typoPath);
+            devkit_1.logger.info(`  ✅ Renamed ${TYPO_FILENAME} → ${FIXED_FILENAME} in ${name}`);
+            fixedCount++;
+        }
+        else if (!tree.exists(fixedPath)) {
+            // Neither exists, skip this element
+            continue;
+        }
+        // Step 2: Update imports in all .ts/.tsx files under this element
+        (0, devkit_1.visitNotIgnoredFiles)(tree, sourceRoot, (filePath) => {
+            if (!filePath.endsWith('.ts') && !filePath.endsWith('.tsx')) {
+                return;
+            }
+            const content = tree.read(filePath, 'utf-8');
+            if (!content || !content.includes(TYPO_IMPORT)) {
+                return;
+            }
+            const updatedContent = content.replace(new RegExp(TYPO_IMPORT, 'g'), FIXED_IMPORT);
+            tree.write(filePath, updatedContent);
+        });
+        // Step 3: Update README.md if it references the typo
+        const readmePath = `${sourceRoot}/src/languages/README.md`;
+        if (tree.exists(readmePath)) {
+            const readmeContent = tree.read(readmePath, 'utf-8');
+            if (readmeContent && readmeContent.includes(TYPO_IMPORT)) {
+                const updatedReadme = readmeContent.replace(new RegExp(TYPO_IMPORT, 'g'), FIXED_IMPORT);
+                tree.write(readmePath, updatedReadme);
+            }
+        }
+    }
+    await (0, devkit_1.formatFiles)(tree);
+    if (fixedCount > 0) {
+        devkit_1.logger.info(`✅ Fixed typo in ${fixedCount} element(s)`);
+    }
+    else {
+        devkit_1.logger.info('ℹ️ No elements with the typo found (already fixed or not applicable)');
+    }
+}

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

@@ -594,6 +594,30 @@
       "cli": {
         "postUpdateMessage": "✅ @unisphere/cli moved to devDependencies"
       }
+    },
+    "4.15.5-fix-supported-languages-typo": {
+      "version": "4.15.5",
+      "description": "Fixes typo in supported-languges.ts filename (renames to supported-languages.ts) and updates imports",
+      "factory": "./dist/migrations/4-15-5/fix-supported-languages-typo.js",
+      "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": {
@@ -1130,10 +1154,10 @@
         }
       }
     },
-    "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",

package/package.json

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