@imgly/plugin-ai-video-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

@@ -145,6 +145,16 @@ Key features:
 -   5-second video duration
 -   Custom headers support for API requests
 
+**Custom Translations:**
+
+```typescript
+cesdk.i18n.setTranslations({
+  en: {
+    'ly.img.plugin-ai-video-generation-web.fal-ai/minimax/video-01-live.property.prompt': 'Describe your Minimax video'
+  }
+});
+```
+
 #### 2. MinimaxVideo01LiveImageToVideo (Image-to-Video)
 
 A model that transforms still images into videos:
@@ -202,6 +212,18 @@ Key features:
 -   Selectable durations (5 s or 10 s)
 -   Adaptive resolution (height fixed at 720 px, width is calculated)
 
+**Custom Translations:**
+
+```typescript
+cesdk.i18n.setTranslations({
+  en: {
+    'ly.img.plugin-ai-video-generation-web.fal-ai/kling-video/v2.1/master/text-to-video.property.prompt': 'Describe your KlingVideo',
+    'ly.img.plugin-ai-video-generation-web.fal-ai/kling-video/v2.1/master/text-to-video.property.aspect_ratio': 'Video Format',
+    'ly.img.plugin-ai-video-generation-web.fal-ai/kling-video/v2.1/master/text-to-video.property.duration': 'Video Length (seconds)'
+  }
+});
+```
+
 #### 5. KlingVideoV21MasterImageToVideo (Image-to-Video)
 
 A model that converts still images into videos using KlingVideo V2.1:
@@ -236,6 +258,68 @@ Key features:
 -   Fixed duration of 8 seconds
 -   Optional audio generation via `generate_audio`
 
+### Customizing Labels and Translations
+
+You can customize all labels and text in the AI video 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-video-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 video 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.duration': 'Video Duration',
+
+    // Provider-specific for MinimaxVideo01Live
+    'ly.img.plugin-ai-video-generation-web.fal-ai/minimax/video-01-live.property.prompt': 'Describe your video',
+    'ly.img.plugin-ai-video-generation-web.fal-ai/minimax/video-01-live.property.duration': 'Video Length',
+
+    // Provider-specific for KlingVideoV21Master
+    'ly.img.plugin-ai-video-generation-web.fal-ai/kling-video/v2.1/master/text-to-video.property.aspect_ratio': 'Video Aspect Ratio',
+    'ly.img.plugin-ai-video-generation-web.fal-ai/kling-video/v2.1/master/text-to-video.property.duration': 'Video Duration (seconds)'
+  }
+});
+```
+
+#### QuickAction Translations
+
+Video QuickActions (like "Create Video from Image") use their own translation keys with provider-specific overrides:
+
+```typescript
+cesdk.i18n.setTranslations({
+  en: {
+    // Provider-specific translations (highest priority)
+    'ly.img.plugin-ai-video-generation-web.fal-ai/minimax/video-01-live.quickAction.createVideo': 'Generate Minimax Video...',
+    'ly.img.plugin-ai-video-generation-web.fal-ai/minimax/video-01-live.quickAction.createVideo.prompt': 'Minimax Video Prompt',
+    
+    // Generic plugin translations
+    'ly.img.plugin-ai-video-generation-web.quickAction.createVideo': 'Create Video...',
+    'ly.img.plugin-ai-video-generation-web.quickAction.createVideo.prompt': 'Video Prompt',
+    'ly.img.plugin-ai-video-generation-web.quickAction.createVideo.prompt.placeholder': 'e.g. "Make the image move slowly"',
+    'ly.img.plugin-ai-video-generation-web.quickAction.createVideo.apply': 'Generate'
+  }
+});
+```
+
+**QuickAction Translation Priority:**
+1. Provider-specific: `ly.img.plugin-ai-video-generation-web.${provider}.quickAction.${action}.${field}`
+2. Generic plugin: `ly.img.plugin-ai-video-generation-web.quickAction.${action}.${field}`
+
+**Translation Structure:**
+- Base key (e.g., `.quickAction.createVideo`): 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
+
 ### Configuration Options
 
 The plugin accepts the following configuration options:
@@ -466,6 +550,10 @@ currentOrder.splice(2, 0, 'ly.img.ai.video-generation.dock');
 cesdk.ui.setDockOrder(currentOrder);
 ```
 
+## Translations
+
+For customization and localization, see the [translations.json](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-video-generation-web/translations.json) file which contains provider-specific translation keys for video 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

package/dist/fal-ai/createFalClient.d.ts

@@ -0,0 +1,3 @@
+import { type FalClient as FalClientType } from '@fal-ai/client';
+export type FalClient = FalClientType;
+export declare function createFalClient(proxyUrl: string, headers?: Record<string, string>): FalClient;

package/dist/fal-ai/createVideoProvider.d.ts

@@ -10,6 +10,16 @@ type VideoProviderConfiguration = {
      * @deprecated Use `middlewares` instead.
      */
     middleware?: Middleware<any, any>[];
+    /**
+     * Override provider's default history asset source
+     */
+    history?: false | '@imgly/local' | '@imgly/indexedDB' | (string & {});
+    /**
+     * Configure supported quick actions
+     */
+    supportedQuickActions?: {
+        [quickActionId: string]: Partial<VideoQuickActionSupportMap<any>[string]> | false | null;
+    };
 };
 /**
  * Creates a base provider from schema. This should work out of the box