@imgly/plugin-ai-generation-web 0.2.14 → 0.2.16

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 ## [Unreleased]
 
+## [0.2.16] - 2026-01-16
+
+### New Features
+
+-   [all] **Translatable Action Labels**: AI plugin action labels now support full i18n through `labelKey` property, enabling dynamic translation resolution based on the current locale.
+-   [generation-web] **setDefaultTranslations Utility**: Added `setDefaultTranslations()` function that only sets translation keys that don't already exist, allowing integrators to customize translations before plugins load without being overwritten.
+-   [all] **External Translation Files**: Plugin translations are now loaded from external `translations.json` files, making it easier to review and customize available translation keys.
+
+### Improvements
+
+-   [all] **Translation Override Pattern**: All AI plugins now use `setDefaultTranslations()` instead of `setTranslations()`, ensuring integrator-provided translations take priority over plugin defaults.
+-   [apps-web] **Dynamic Card Labels**: AI Apps panel now resolves card labels dynamically using `labelKey` from action metadata, enabling proper i18n for app cards.
+
+### Documentation
+
+-   [all] Added comprehensive i18n documentation to README files explaining how to customize translations before plugin initialization.
+
+## [0.2.15] - 2026-01-12
+
+### New Features
+
+-   [all] **EachLabs Partner Integration**: Added EachLabs as a new AI provider service with unified API access to multiple image and video generation models.
+    - **Image Generation**: Flux 2 Pro, Flux 2, Flux 2 Flex, Nano Banana Pro, OpenAI GPT Image, Seedream v4.5, Gemini 3 Pro (all with text-to-image and image-to-image variants)
+    - **Video Generation**: Kling v2.6 Pro, Kling O1, Veo 3.1 (text-to-video and image-to-video variants)
+
 ## [0.2.14] - 2025-12-15
 
 ## [0.2.13] - 2025-12-15

package/README.md

@@ -1505,6 +1505,116 @@ interface QuickActionDefinition<Q extends Record<string, any>> {
 }
 ```
 
-## Translations
+## Internationalization (i18n)
 
-For customization and localization, see the [translations.json](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-generation-web/translations.json) file which contains base translation keys that can be overridden for all AI plugins.
+The AI plugins support full internationalization, allowing integrators to customize all user-facing text. The translation system is designed to let integrators override default translations **before** plugins are loaded.
+
+### Custom Translations
+
+To customize translations, call `cesdk.i18n.setTranslations()` **before** adding the AI plugins:
+
+```typescript
+import CreativeEditorSDK from '@cesdk/cesdk-js';
+import AiApps from '@imgly/plugin-ai-apps-web';
+
+CreativeEditorSDK.create(domElement, {
+  license: 'your-license-key',
+  locale: 'de' // Set your desired locale
+}).then(async (cesdk) => {
+  // Set custom translations BEFORE adding plugins
+  cesdk.i18n.setTranslations({
+    en: {
+      // Override AI Apps labels
+      '@imgly/plugin-ai-image-generation-web.action.label': 'Create Image',
+      '@imgly/plugin-ai-video-generation-web.action.label': 'Create Video',
+
+      // Override provider-specific labels
+      'ly.img.plugin-ai-image-generation-web.fal-ai/recraft-v3.property.style': 'Art Style',
+      'ly.img.plugin-ai-image-generation-web.fal-ai/recraft-v3.property.style.realistic_image': 'Photo Realistic'
+    },
+    de: {
+      // German translations
+      '@imgly/plugin-ai-image-generation-web.action.label': 'Bild erstellen',
+      '@imgly/plugin-ai-video-generation-web.action.label': 'Video erstellen',
+      'common.generate': 'Generieren',
+      'panel.ly.img.ai.apps': 'KI'
+    }
+  });
+
+  // Now add the plugins - they won't override your custom translations
+  await cesdk.addPlugin(AiApps({ providers: { /* ... */ } }));
+});
+```
+
+### How It Works
+
+The AI plugins use `setDefaultTranslations()` internally, which only sets translation keys that don't already exist. This means:
+
+1. **Your translations take priority**: Any translations you set before loading plugins are preserved
+2. **Fallback to defaults**: Keys you don't customize will use the plugin's default English translations
+3. **Locale support**: Set translations for any locale supported by CE.SDK
+
+### Translation Key Structure
+
+Translation keys follow a consistent naming pattern:
+
+```
+ly.img.plugin-ai-{type}-generation-web.{provider-id}.property.{property-name}.{value}
+```
+
+For example:
+- `ly.img.plugin-ai-image-generation-web.fal-ai/recraft-v3.property.style.realistic_image`
+- `ly.img.plugin-ai-video-generation-web.fal-ai/veo-3.property.duration.5s`
+
+### Action Labels
+
+Each AI plugin registers an action with a translatable label. The action uses both a static `label` (for backwards compatibility) and a `labelKey` for dynamic i18n resolution:
+
+| Plugin | Label Key |
+|--------|-----------|
+| Image Generation | `@imgly/plugin-ai-image-generation-web.action.label` |
+| Video Generation | `@imgly/plugin-ai-video-generation-web.action.label` |
+| Audio Generation (Sound) | `@imgly/plugin-ai-audio-generation-web.sound.action.label` |
+| Audio Generation (Speech) | `@imgly/plugin-ai-audio-generation-web.speech.action.label` |
+| Sticker Generation | `@imgly/plugin-ai-sticker-generation-web.action.label` |
+
+### Translation Files
+
+Each AI plugin includes a `translations.json` file with all available translation keys:
+
+- [Base translations](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-generation-web/translations.json) - Core translation keys
+- [AI Apps translations](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-apps-web/translations.json) - AI Apps panel labels
+- [Image generation translations](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-image-generation-web/translations.json) - Image generation interfaces
+- [Video generation translations](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-video-generation-web/translations.json) - Video generation interfaces
+- [Text generation translations](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-text-generation-web/translations.json) - Text generation interfaces
+- [Audio generation translations](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-audio-generation-web/translations.json) - Audio generation interfaces
+- [Sticker generation translations](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-sticker-generation-web/translations.json) - Sticker generation interfaces
+
+### Exported Utilities
+
+The package exports translation utilities for use in custom providers:
+
+```typescript
+import {
+  setDefaultTranslations,
+  createTranslationCallback,
+  buildTranslationKeys
+} from '@imgly/plugin-ai-generation-web';
+
+// Set translations that won't override existing keys
+setDefaultTranslations(cesdk, {
+  en: { 'my.key': 'My Value' }
+});
+
+// Create a translation callback for asset sources
+const translateLabel = createTranslationCallback(cesdk, 'my-provider', 'style', 'image');
+
+// Build translation keys with fallback order
+const keys = buildTranslationKeys('my-provider', 'style', 'realistic', 'image');
+// Returns: [
+//   'ly.img.plugin-ai-image-generation-web.my-provider.property.style.realistic',
+//   'ly.img.plugin-ai-generation-web.property.style.realistic',
+//   'ly.img.plugin-ai-image-generation-web.my-provider.defaults.property.style.realistic',
+//   'ly.img.plugin-ai-generation-web.defaults.property.style.realistic'
+// ]
+```