@imgly/plugin-ai-video-generation-web 0.2.7 → 0.2.9

package/CHANGELOG.md

@@ -2,6 +2,44 @@
 
 ## [Unreleased]
 
+## [0.2.9] - 2025-10-16
+
+### New Features
+
+-   [image-generation] **GeminiFlash25 Provider**: Added Google Gemini Flash 2.5 text-to-image provider via fal.ai with fast generation times, multiple aspect ratios (1:1, 3:4, 4:3, 9:16, 16:9), custom dimensions support, and multiple output formats (JPEG, PNG, WEBP)
+-   [image-generation] **Gemini25FlashImageEdit Provider**: Added Google Gemini 2.5 Flash Image Edit provider via fal.ai for advanced image editing with multi-image support (1-10 images), comprehensive quick actions support (editImage, swapBackground, styleTransfer, artistTransfer, createVariant, combineImages, remixPage, remixPageWithPrompt), text-based editing instructions, and fast processing times
+
+### Improvements
+
+-   [generation-web] **Middleware preventDefault() API**: Added `options.preventDefault()` method to suppress default UI feedback (notifications, block states, console logging) when handling errors in custom middleware
+-   [all] **Internationalization Support**: All hardcoded strings across AI plugins have been removed and replaced with translation keys, enabling full localization support for plugin labels, actions, styles, and error messages
+-   [all] **Translation Keys Available**: Added comprehensive translation keys for:
+    -   Panel and dock labels (AI Image, AI Video, AI Sticker, AI Voice, Sound Generation)
+    -   Action labels (Generate Image, Generate Video, Generate Sticker)
+    -   Style transfer options (None, Anime, Cyberpunk, Kodak 400, Watercolor, Dark Fantasy, Vaporwave, Vector Flat, 3D Animation, Ukiyo-e, Surreal, Steampunk, Night Bokeh, Pop Art)
+    -   Error messages and UI elements
+-   [all] **Backwards Compatibility**: Translation system automatically detects CE.SDK version and gracefully falls back to English strings for CE.SDK versions < 1.59.0, ensuring no breaking changes for existing integrations
+
+### Fixed
+
+-   [generation-web] **Placeholder Block Error State**: Fixed placeholder blocks getting stuck in Pending state when generation fails or is aborted. Blocks are now properly destroyed when generation is aborted, or moved to Error state when generation fails, preventing perpetual loading spinners in the UI.
+-   [generation-web] **Middleware Block Targeting**: Fixed middleware to correctly receive block IDs for placeholder blocks and quick action targets. Previously, middleware would fall back to `findAllSelected()` which could target incorrect blocks if the selection changed during generation. Now placeholder blocks created during panel generation and target blocks from quick actions are explicitly passed to middleware, ensuring operations like pending state, locking, and highlighting affect the correct blocks.
+
+### Changed
+
+-   [generation-web] **BlockIds Type Refinement**: Removed unused `| null` type from `blockIds` parameter in `GenerationOptions` and `Generate` function signature. The `null` value was documented but never implemented or used. Use an empty array `[]` instead of `null` to explicitly target no blocks.
+
+## [0.2.8] - 2025-09-29
+
+### New Features
+
+-   [image-generation] **SeedreamV4 Provider**: Added ByteDance Seedream 4.0 text-to-image provider via fal.ai for high-quality image generation with multiple size presets (square HD 2048×2048, square 1024×1024, portrait/landscape variants), custom dimensions support (1024-4096 pixels), and safety checker enabled by default
+-   [image-generation] **SeedreamV4Edit Provider**: Added ByteDance Seedream 4.0 image-to-image provider via fal.ai for advanced image editing with unified generation/editing architecture, support for multiple input images (up to 10), and full canvas quick actions support (editImage, swapBackground, styleTransfer, artistTransfer, createVariant, combineImages, remixPage, remixPageWithPrompt)
+
+### Fixed
+
+-   [sticker-generation] **Fixed Input Types Not Enabled**: Fixed an issue where the sticker generation panel would show "No input types are enabled" error by properly enabling the `fromText` and `fromImage` feature flags during plugin initialization
+
 ## [0.2.7] - 2025-09-26
 
 ### New Features

package/README.md

@@ -51,8 +51,8 @@ CreativeEditorSDK.create(domElement, {
                 },
                 // Optional: Configure default property values
                 properties: {
-                    duration: 5,  // Default duration in seconds
-                    aspect_ratio: '16:9'  // Default aspect ratio
+                    duration: { default: 5 },  // Default duration in seconds
+                    aspect_ratio: { default: '16:9' }  // Default aspect ratio
                 }
             }),
 
@@ -142,7 +142,7 @@ text2video: FalAiVideo.MinimaxVideo01Live({
     },
     // Optional: Configure default property values
     properties: {
-        prompt_optimizer: true  // Enable automatic prompt enhancement
+        prompt_optimizer: { default: true }  // Enable automatic prompt enhancement
     }
 });
 ```
@@ -177,7 +177,7 @@ image2video: FalAiVideo.MinimaxVideo01LiveImageToVideo({
     },
     // Optional: Configure default property values
     properties: {
-        prompt_optimizer: true  // Enable automatic prompt enhancement
+        prompt_optimizer: { default: true }  // Enable automatic prompt enhancement
     }
 });
 ```
@@ -202,8 +202,8 @@ image2video: FalAiVideo.MinimaxHailuo02StandardImageToVideo({
     },
     // Optional: Configure default property values
     properties: {
-        resolution: '768P',  // Options: '512P' (912×512), '768P' (1280×720)
-        duration: 6          // Duration in seconds (6 or 10)
+        resolution: { default: '768P' },  // Options: '512P' (912×512), '768P' (1280×720)
+        duration: { default: 6 }          // Duration in seconds (6 or 10)
     }
 });
 ```
@@ -229,7 +229,7 @@ text2video: FalAiVideo.PixverseV35TextToVideo({
     },
     // Optional: Configure default property values
     properties: {
-        seed: 42  // Fixed seed for reproducible generation
+        seed: { default: 42 }  // Fixed seed for reproducible generation
     }
 });
 ```
@@ -248,8 +248,8 @@ text2video: FalAiVideo.KlingVideoV21MasterTextToVideo({
     proxyUrl: 'http://your-proxy-server.com/api/proxy',
     // Optional: Configure default property values
     properties: {
-        aspect_ratio: '16:9',  // Options: '16:9', '9:16', '1:1'
-        duration: '5s'         // Options: '5s', '10s'
+        aspect_ratio: { default: '16:9' },  // Options: '16:9', '9:16', '1:1'
+        duration: { default: '5s' }         // Options: '5s', '10s'
     }
 });
 ```
@@ -282,7 +282,7 @@ image2video: FalAiVideo.KlingVideoV21MasterImageToVideo({
     proxyUrl: 'http://your-proxy-server.com/api/proxy',
     // Optional: Configure default property values
     properties: {
-        duration: '5s'  // Options: '5s', '10s'
+        duration: { default: '5s' }  // Options: '5s', '10s'
     }
 });
 ```
@@ -303,9 +303,9 @@ image2video: FalAiVideo.ByteDanceSeedanceV1ProImageToVideo({
     proxyUrl: 'http://your-proxy-server.com/api/proxy',
     // Optional: Configure default property values
     properties: {
-        aspect_ratio: 'auto',     // Options: '21:9', '16:9', '4:3', '1:1', '3:4', '9:16', 'auto'
-        duration: 5,              // Duration in seconds (3-12)
-        resolution: '720p'        // Options: '480p', '720p', '1080p'
+        aspect_ratio: { default: 'auto' },     // Options: '21:9', '16:9', '4:3', '1:1', '3:4', '9:16', 'auto'
+        duration: { default: 5 },              // Duration in seconds (3-12)
+        resolution: { default: '720p' }        // Options: '480p', '720p', '1080p'
     }
 });
 ```
@@ -327,9 +327,9 @@ text2video: FalAiVideo.ByteDanceSeedanceV1ProTextToVideo({
     proxyUrl: 'http://your-proxy-server.com/api/proxy',
     // Optional: Configure default property values
     properties: {
-        aspect_ratio: '16:9',     // Options: '21:9', '16:9', '4:3', '1:1', '3:4', '9:16'
-        duration: 5,              // Duration in seconds (3-12)
-        resolution: '720p'        // Options: '480p', '720p', '1080p'
+        aspect_ratio: { default: '16:9' },     // Options: '21:9', '16:9', '4:3', '1:1', '3:4', '9:16'
+        duration: { default: 5 },              // Duration in seconds (3-12)
+        resolution: { default: '720p' }        // Options: '480p', '720p', '1080p'
     }
 });
 ```
@@ -351,8 +351,8 @@ text2video: FalAiVideo.Veo3TextToVideo({
     proxyUrl: 'http://your-proxy-server.com/api/proxy',
     // Optional: Configure default property values
     properties: {
-        aspect_ratio: '16:9',     // Options: '16:9', '9:16', '1:1'
-        duration: 8               // Fixed at 8 seconds for this provider
+        aspect_ratio: { default: '16:9' },     // Options: '16:9', '9:16', '1:1'
+        duration: { default: 8 }               // Fixed at 8 seconds for this provider
     }
 });
 ```
@@ -515,6 +515,43 @@ Built-in middleware options:
 
 You can also create custom middleware functions to meet your specific needs.
 
+#### Preventing Default Feedback
+
+Middleware can suppress default UI feedback behaviors using `options.preventDefault()`:
+
+```typescript
+const customErrorMiddleware = async (input, options, next) => {
+  try {
+    return await next(input, options);
+  } catch (error) {
+    // Prevent default error notification
+    options.preventDefault();
+
+    // Show custom error notification
+    options.cesdk?.ui.showNotification({
+      type: 'error',
+      message: `Video generation failed: ${error.message}`,
+      action: {
+        label: 'Try Again',
+        onClick: () => {/* retry logic */}
+      }
+    });
+
+    throw error;
+  }
+};
+```
+
+**What gets prevented:**
+- Error/success notifications
+- Block error state
+- Console error logging
+
+**What is NOT prevented:**
+- Pending → Ready transition (loading spinner always stops)
+
+For more details, see the [@imgly/plugin-ai-generation-web documentation](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-generation-web#preventing-default-feedback).
+
 ### Using a Proxy
 
 For security reasons, it's recommended to use a proxy server to handle API requests to fal.ai. The proxy URL is required when configuring providers: