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

package/CHANGELOG.md

@@ -2,6 +2,35 @@
 
 ## [Unreleased]
 
+## [0.2.17] - 2026-01-26
+
+### Fixed
+
+-   [image-generation] **Runware NanoBanana2Pro Dimensions**: Fixed API errors when using non-square aspect ratios (16:9, 9:16, 4:3, 3:4) with Nano Banana 2 Pro provider. The model requires specific dimension combinations (e.g., 1376×768 for 16:9) that differ from the generic aspect ratio map.
+-   [image-generation] **Runware Seedream 4.0 Dimensions**: Fixed API errors when using non-square aspect ratios with Seedream 4.0 provider. At 1K resolution, only 1:1 is supported; now using 2K dimensions for all aspect ratios to ensure compatibility.
+
+### Improvements
+
+-   [image-generation] **Runware Async Delivery**: Switched from synchronous requests to async delivery with polling to avoid timeouts on slower image generation models.
+-   [image-generation] **Runware NanoBanana2Pro I2I**: Added `resolution: '2k'` parameter to image-to-image generation for automatic aspect ratio detection from reference images.
+
+## [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