@unisphere/nx 4.14.4 → 4.15.1

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

@@ -0,0 +1,52 @@
+# Languages
+
+This folder contains the internationalization (i18n) setup for this package.
+
+## Structure
+
+```
+languages/
+├── en-US.json              # Default English translations (source of truth)
+├── supported-languges.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)
+│   └── .gitignore
+└── README.md               # This file
+```
+
+## 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.
+- **`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 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`
+
+## Usage
+
+Components in this package use translations via the `useTranslation` hook:
+
+```typescript
+import { useTranslation } from './use-translation';
+
+const MyComponent = () => {
+  const { t } = useTranslation();
+  return <span>{t('myKey')}</span>;
+};
+```
+
+## CLI Commands
+
+```bash
+npx unisphere languages export    # Export translations to CSV for translation services
+npx unisphere languages import    # Import translated CSV files back to JSON
+npx unisphere languages serve     # Serve language files during local development
+npx unisphere languages bundle    # Bundle language files for distribution
+```

package/dist/generators/add-package/templates/new-package/src/languages/en-US.json

@@ -0,0 +1 @@
+{}

package/dist/generators/add-package/templates/new-package/src/languages/supported-languges.ts

@@ -0,0 +1 @@
+export const supportedLanguages: string[] = ['en-US'];

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

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

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

@@ -0,0 +1,32 @@
+# Languages
+
+This folder contains the internationalization (i18n) setup for this runtime.
+
+## Structure
+
+```
+languages/
+├── en-US.json              # Default English translations (source of truth)
+├── supported-languges.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)
+│   └── .gitignore
+└── README.md               # This file
+```
+
+## 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.
+- **`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.
+
+## CLI Commands
+
+```bash
+npx unisphere languages export    # Export translations to CSV for translation services
+npx unisphere languages import    # Import translated CSV files back to JSON
+npx unisphere languages serve     # Serve language files during local development
+npx unisphere languages bundle    # Bundle language files for distribution
+```

package/dist/generators/add-runtime/templates/new-runtime/src/languages/en-US.json

@@ -0,0 +1 @@
+{}

package/dist/generators/add-runtime/templates/new-runtime/src/languages/supported-languges.ts

@@ -0,0 +1 @@
+export const supportedLanguages: string[] = ['en-US'];

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

@@ -12,6 +12,7 @@ import {
   widgetName,
 } from '<%= typesAlias %>';
 import { HtmlDomRuntimeVisual, KalturaAnalyticsServiceType } from '@unisphere/runtime';
+import { UnisphereI18NRuntimeProxy } from '@unisphere/ui-i18n-react';
 
 export class Runtime
   extends UnisphereRuntimeBase<<%= runtimeName__pascalCase %>RuntimeSettings, Root>

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

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

package/dist/generators/add-visual/templates/new-visual/render-method.template

@@ -10,6 +10,7 @@
 
   visual.htmlContainer?.render(
     <ScopedUnisphereWorkspaceProvider unisphereWorkspace={this._workspace} runtimeLogger={this._logger}>
+      <UnisphereI18NRuntimeProxy runtimeUri={this._options.runtimeDeployedPath} />
       <ThemeProvider
         cssPrefix={'<%= widgetName__lowerDashCase %>-<%= runtimeName__lowerDashCase %>-<%= visualName__lowerDashCase %>'}
         mode={typeof this._theme === 'string' ? this._theme : this._theme.mode}

package/dist/migrations/4-15-0/add-languages-support.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Migration: Add Unisphere Languages Support
+ *
+ * Migrates packages from raw i18next/react-i18next to the Unisphere
+ * @unisphere/ui-i18n-react framework with createUseTranslation pattern.
+ * Adds UnisphereI18NRuntimeProxy to all runtimes.
+ *
+ * Steps:
+ * 1. For packages with existing en-US.json: move translations, create
+ *    use-translation.tsx, update imports, remove LanguagesProvider
+ * 2. For all runtimes: add UnisphereI18NRuntimeProxy, remove LanguagesProvider usage
+ * 3. Update root package.json dependencies
+ */
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=add-languages-support.d.ts.map

package/dist/migrations/4-15-0/add-languages-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-languages-support.d.ts","sourceRoot":"","sources":["../../../src/migrations/4-15-0/add-languages-support.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,IAAI,EAML,MAAM,YAAY,CAAC;AAiBpB,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB9D"}