@imgly/plugin-ai-image-generation-web 0.2.15 → 0.2.16

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## [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

package/README.md

@@ -2110,9 +2110,29 @@ currentOrder.splice(2, 0, 'ly.img.ai.image-generation.dock');
 cesdk.ui.setDockOrder(currentOrder);
 ```
 
-## Translations
+## Internationalization (i18n)
 
-For customization and localization, see the [translations.json](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-image-generation-web/translations.json) file which contains provider-specific translation keys for image generation interfaces.
+The Image Generation plugin supports full internationalization. To customize translations, set them **before** adding the plugin:
+
+```typescript
+cesdk.i18n.setTranslations({
+  en: {
+    '@imgly/plugin-ai-image-generation-web.action.label': 'Create Image',
+    'ly.img.plugin-ai-image-generation-web.fal-ai/recraft-v3.property.style': 'Art Style'
+  },
+  de: {
+    '@imgly/plugin-ai-image-generation-web.action.label': 'Bild erstellen',
+    'ly.img.plugin-ai-image-generation-web.fal-ai/recraft-v3.property.style': 'Kunststil'
+  }
+});
+
+// Then add the plugins - they won't override your custom translations
+await cesdk.addPlugin(AiApps({ providers: { /* ... */ } }));
+```
+
+For detailed documentation on the translation system, see the [Internationalization section](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-generation-web#internationalization-i18n) in the core AI generation package.
+
+For all available translation keys, see the [translations.json](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-image-generation-web/translations.json) file.
 
 ## Related Packages