@imgly/plugin-ai-text-generation-web 0.2.3 → 0.2.5

package/CHANGELOG.md

@@ -2,11 +2,35 @@
 
 ## [Unreleased]
 
+## [0.2.5] - 2025-09-03
+
+### New Features
+
+-   [image-generation] **NanoBanana Provider**: Added NanoBanana text-to-image provider via fal.ai with fast generation times, 1024×1024 resolution, support for multiple output formats (JPEG, PNG), configurable number of images (1-4), and remixPageWithPrompt quick action
+-   [image-generation] **NanoBananaEdit Provider**: Added NanoBananaEdit image-to-image provider via fal.ai for editing existing images with text prompts, supporting all standard quick actions (editImage, swapBackground, styleTransfer, artistTransfer, createVariant, combineImages with up to 10 images, remixPage, remixPageWithPrompt)
+
+### Bug Fixes
+
+-   [all] **fal.ai Provider Configuration**: Fixed singleton configuration conflict when using multiple fal.ai providers with different proxy URLs. Each provider now maintains its own client instance instead of overwriting a global configuration
+-   [video-generation] **Missing Dependency**: Added missing `@fal-ai/client` dependency to plugin-ai-video-generation-web package.json to ensure the package works correctly when installed independently
+
+## [0.2.4] - 2025-08-07
+
+### New Features
+
+-   [all] **Provider Label Translations**: Added support for provider label translations
+-   [all] **Extended Provider Configuration**: Added support for `history` and `supportedQuickActions` configuration fields in `CommonProviderConfiguration`, allowing customers to:
+    -   Override provider's default history asset source (`history` field) - can be set to `false` to disable history, `'@imgly/local'` for temporary storage, `'@imgly/indexedDB'` for persistent browser storage, or any custom asset source ID
+    -   Configure supported quick actions (`supportedQuickActions` field) - can disable quick actions by setting to `false`/`null`, keep defaults with `true`, or override with custom mappings and configurations
+    -   Both fields are optional and maintain backward compatibility with existing provider configurations
+-   [generation-web] **Utility Function**: Added `mergeQuickActionsConfig` utility function for merging provider defaults with user configuration overrides, exported from `@imgly/plugin-ai-generation-web` with comprehensive Jest test coverage
+
 ## [0.2.3] - 2025-07-23
 
 -   [all] **Automatic History Asset Library Entries**: Composite history asset sources now automatically have corresponding asset library entries created with the same IDs (e.g., `ly.img.ai.image-generation.history`)
 -   [all] **Provider Selection in Expanded Quick Actions**: When a quick action is expanded, users can now switch between all providers that support that specific quick action, enhancing flexibility in provider selection
 -   [all] **Quick Action Can Disable Lock**: Some quick actions can now decide to not lock the block when operating on a block. Examples are `CreateVariant` and `CombineImages`.
+-   [image-generation] **Ideogram V3**: Added support for Ideogram V3 provider for image generation, which supports text-to-image and image-to-image generation
 
 ## [0.2.2] - 2025-07-16
 

package/README.md

@@ -156,6 +156,18 @@ Key features:
 -   Configurable model selection (Claude 3.5 Sonnet, Claude 3.7 Sonnet, etc.)
 -   Default model: Claude 3.7 Sonnet (2025-02-19)
 
+**Custom Translations:**
+
+```typescript
+cesdk.i18n.setTranslations({
+  en: {
+    'ly.img.plugin-ai-text-generation-web.anthropic.property.prompt': 'Enter your text transformation request',
+    'ly.img.plugin-ai-text-generation-web.anthropic.property.temperature': 'Claude Creativity Level',
+    'ly.img.plugin-ai-text-generation-web.anthropic.property.maxTokens': 'Claude Response Length'
+  }
+});
+```
+
 #### OpenAI GPT
 
 A powerful text generation model that handles various text transformations:
@@ -191,6 +203,95 @@ Key features:
 -   Configurable model selection (GPT-4o, GPT-4o-mini, GPT-3.5-turbo, etc.)
 -   Default model: GPT-4o-mini
 
+**Custom Translations:**
+
+```typescript
+cesdk.i18n.setTranslations({
+  en: {
+    'ly.img.plugin-ai-text-generation-web.openai.property.prompt': 'Enter your text transformation request',
+    'ly.img.plugin-ai-text-generation-web.openai.property.temperature': 'GPT Creativity Level',
+    'ly.img.plugin-ai-text-generation-web.openai.property.maxTokens': 'GPT Response Length'
+  }
+});
+```
+
+### Customizing Labels and Translations
+
+You can customize all labels and text in the AI text generation interface using the translation system. This allows you to provide better labels for your users in any language.
+
+#### Translation Key Structure
+
+The system checks for translations in this order (highest to lowest priority):
+
+1. **Provider-specific**: `ly.img.plugin-ai-text-generation-web.${provider}.property.${field}` - Override labels for a specific AI provider
+2. **Generic**: `ly.img.plugin-ai-generation-web.property.${field}` - Override labels for all AI plugins
+
+#### Basic Example
+
+```typescript
+// Customize labels for your AI text generation interface
+cesdk.i18n.setTranslations({
+  en: {
+    // Generic labels (applies to ALL AI plugins)
+    'ly.img.plugin-ai-generation-web.property.prompt': 'Describe what you want to create',
+    'ly.img.plugin-ai-generation-web.property.temperature': 'Creativity Level',
+    'ly.img.plugin-ai-generation-web.property.maxTokens': 'Maximum Response Length',
+
+    // Provider-specific for Anthropic
+    'ly.img.plugin-ai-text-generation-web.anthropic.property.prompt': 'Enter your text transformation prompt',
+    'ly.img.plugin-ai-text-generation-web.anthropic.property.temperature': 'Response Creativity',
+    'ly.img.plugin-ai-text-generation-web.anthropic.property.maxTokens': 'Max Response Length',
+
+    // Provider-specific for OpenAI
+    'ly.img.plugin-ai-text-generation-web.openai.property.prompt': 'Describe your text transformation',
+    'ly.img.plugin-ai-text-generation-web.openai.property.temperature': 'Creativity Setting',
+    'ly.img.plugin-ai-text-generation-web.openai.property.maxTokens': 'Response Limit'
+  }
+});
+```
+
+#### QuickAction Translations
+
+Text QuickActions (like "Improve Writing", "Fix Grammar", etc.) use their own translation keys with provider-specific overrides:
+
+```typescript
+cesdk.i18n.setTranslations({
+  en: {
+    // Provider-specific translations (highest priority)
+    'ly.img.plugin-ai-text-generation-web.anthropic.quickAction.improve': 'Improve with Claude',
+    'ly.img.plugin-ai-text-generation-web.anthropic.quickAction.fix': 'Fix with Claude',
+    'ly.img.plugin-ai-text-generation-web.openai.quickAction.translate': 'Translate with GPT',
+    
+    // Generic plugin translations
+    'ly.img.plugin-ai-text-generation-web.quickAction.improve': 'Improve Writing',
+    'ly.img.plugin-ai-text-generation-web.quickAction.fix': 'Fix Grammar',
+    'ly.img.plugin-ai-text-generation-web.quickAction.shorter': 'Make Shorter',
+    'ly.img.plugin-ai-text-generation-web.quickAction.longer': 'Make Longer',
+    'ly.img.plugin-ai-text-generation-web.quickAction.changeTone': 'Change Tone',
+    'ly.img.plugin-ai-text-generation-web.quickAction.translate': 'Translate',
+    'ly.img.plugin-ai-text-generation-web.quickAction.changeTextTo': 'Transform Text...',
+    
+    // QuickAction input fields and buttons
+    'ly.img.plugin-ai-text-generation-web.quickAction.changeTextTo.prompt': 'Transform Text...',
+    'ly.img.plugin-ai-text-generation-web.quickAction.changeTextTo.prompt.placeholder': 'e.g. "Convert to bullet points"',
+    'ly.img.plugin-ai-text-generation-web.quickAction.changeTextTo.apply': 'Transform',
+    'ly.img.plugin-ai-text-generation-web.quickAction.translate.language': 'Target Language',
+    'ly.img.plugin-ai-text-generation-web.quickAction.translate.apply': 'Translate'
+  }
+});
+```
+
+**QuickAction Translation Priority:**
+1. Provider-specific: `ly.img.plugin-ai-text-generation-web.${provider}.quickAction.${action}.${field}`
+2. Generic plugin: `ly.img.plugin-ai-text-generation-web.quickAction.${action}.${field}`
+
+**Translation Structure:**
+- Base key (e.g., `.quickAction.improve`): Button text when QuickAction is collapsed
+- `.prompt`: Label for input field when expanded
+- `.prompt.placeholder`: Placeholder text for input field
+- `.apply`: Text for action/submit button
+- Additional fields like `.language`: Custom field labels
+
 ### Configuration Options
 
 The plugin accepts the following configuration options:
@@ -410,6 +511,10 @@ cesdk.ui.setCanvasMenuOrder([
 ]);
 ```
 
+## Translations
+
+For customization and localization, see the [translations.json](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-text-generation-web/translations.json) file which contains provider-specific translation keys for text generation interfaces.
+
 ## Related Packages
 
 -   [@imgly/plugin-ai-generation-web](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-generation-web) - Core utilities for AI generation