@imgly/plugin-ai-image-generation-web 0.2.5 → 0.2.7

package/CHANGELOG.md

@@ -2,12 +2,40 @@
 
 ## [Unreleased]
 
+## [0.2.7] - 2025-09-26
+
+### New Features
+
+-   [image-generation] **QwenImageEdit Provider**: Added Qwen image editing provider via fal.ai for advanced image-to-image transformation with text prompts, supporting all standard quick actions
+-   [video-generation] **MinimaxHailuo02StandardImageToVideo Provider**: Added Minimax Hailuo-02 Standard image-to-video provider via fal.ai for transforming still images into videos with selectable resolutions (512P: 912×512, 768P: 1280×720) and adjustable durations (6 or 10 seconds)
+-   [video-generation] **ByteDance Seedance v1 Pro Providers**: Added ByteDance Seedance v1 Pro text-to-video and image-to-video providers via fal.ai with:
+    - Text-to-video generation from text descriptions with customizable aspect ratios
+    - Image-to-video transformation with dynamic motion generation from still images
+    - Multiple aspect ratio options (21:9, 16:9, 4:3, 1:1, 3:4, 9:16, or auto from image for i2v)
+    - Adjustable duration (3-12 seconds, default 5)
+    - Resolution options (480p, 720p, 1080p)
+    - Proper aspect ratio handling in placeholder blocks based on user selection
+
+-   [all] **Property Configuration System**: Providers can now define default values for their properties. Defaults can be static values or dynamic based on context (language, design state, etc.)
+
+-   [image-generation] **Recraft Provider Defaults**: Recraft providers (V3 and 20b) now support configurable default values for all properties, including dynamic style defaults based on the selected style type
+
+## [0.2.6] - 2025-09-09
+
+### New Features
+
+-   [all] **Feature API Integration**: Added comprehensive Feature API support across all AI plugins to control visibility and availability of features through feature flags. Core features include `providerSelect`, `quickAction`, `quickAction.providerSelect`, `fromText`, and `fromImage` flags.
+-   [all] **Quick Action Feature Flags**: Each quick action now automatically registers and respects its own feature flag (e.g., `ly.img.plugin-ai-image-generation-web.quickAction.editImage`), allowing fine-grained control over which quick actions are available to users.
+-   [image-generation] **Provider Style Group Control**: Added Feature API support for Recraft providers to control style group visibility. RecraftV3 supports `style.image` and `style.vector` flags, while Recraft20b adds `style.icon` flag for controlling icon style availability.
+-   [all] **Provider Selection Feature Flags**: Added support for controlling provider selection UI in both panels (`providerSelect`) and quick actions (`quickAction.providerSelect`), with proper handling when multiple providers are configured.
+
 ## [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)
+-   [all] **AI Style Asset Library Translations**: AI style presets in asset libraries now automatically use localized names and descriptions from provider translation files, eliminating the need for manual translation configuration
 
 ### Bug Fixes
 

package/README.md

@@ -176,6 +176,11 @@ text2image: FalAiImage.RecraftV3({
   headers: {
     'x-custom-header': 'value',
     'x-client-version': '1.0.0'
+  },
+  // Optional: Configure default property values
+  properties: {
+    style: 'realistic_image',  // Default style
+    image_size: 'square_hd'     // Default size
   }
 })
 ```
@@ -187,6 +192,106 @@ Key features:
 - Adjustable quality settings
 - Custom headers support for API requests
 
+**Available Property Values:**
+
+```typescript
+// image_size options:
+'square_hd'      // 1024x1024 (default)
+'square'         // 512x512
+'portrait_4_3'   // 768x1024
+'portrait_16_9'  // 576x1024
+'landscape_4_3'  // 1024x768
+'landscape_16_9' // 1024x576
+
+// style options (grouped by category):
+// Base styles:
+'any'                  // Let model decide
+'realistic_image'      // Photorealistic (default)
+'digital_illustration' // Digital art
+'vector_illustration'  // Vector graphics
+
+// Realistic substyles:
+'realistic_image/b_and_w'           // Black and white
+'realistic_image/hard_flash'        // Hard flash photography
+'realistic_image/hdr'               // HDR photography
+'realistic_image/natural_light'     // Natural lighting
+'realistic_image/studio_portrait'   // Studio portrait
+'realistic_image/enterprise'        // Business/corporate
+'realistic_image/motion_blur'       // Motion blur effect
+'realistic_image/evening_light'     // Evening lighting
+'realistic_image/faded_nostalgia'   // Nostalgic/faded look
+'realistic_image/forest_life'       // Forest/nature
+'realistic_image/mystic_naturalism' // Mystic nature
+'realistic_image/natural_tones'     // Natural color tones
+'realistic_image/organic_calm'      // Organic/calm aesthetic
+'realistic_image/real_life_glow'    // Natural glow
+'realistic_image/retro_realism'     // Retro realistic
+'realistic_image/retro_snapshot'    // Retro photo
+'realistic_image/urban_drama'       // Urban/dramatic
+'realistic_image/village_realism'   // Village/rural
+'realistic_image/warm_folk'         // Warm/folk style
+
+// Digital illustration substyles:
+'digital_illustration/pixel_art'           // Pixel art
+'digital_illustration/hand_drawn'          // Hand-drawn
+'digital_illustration/grain'               // Grainy texture
+'digital_illustration/infantile_sketch'    // Child-like sketch
+'digital_illustration/2d_art_poster'       // 2D poster art
+'digital_illustration/handmade_3d'         // Handmade 3D look
+'digital_illustration/hand_drawn_outline'  // Hand-drawn outline
+'digital_illustration/engraving_color'     // Color engraving
+'digital_illustration/2d_art_poster_2'     // Alternative poster style
+'digital_illustration/antiquarian'         // Antique/vintage
+'digital_illustration/bold_fantasy'        // Bold fantasy art
+'digital_illustration/child_book'          // Children's book
+'digital_illustration/child_books'         // Children's book alt
+'digital_illustration/cover'               // Book/album cover
+'digital_illustration/crosshatch'          // Crosshatching
+'digital_illustration/digital_engraving'   // Digital engraving
+'digital_illustration/expressionism'       // Expressionist
+// ... and many more digital illustration styles
+
+// Vector illustration substyles:
+'vector_illustration/cartoon'              // Cartoon style
+'vector_illustration/kawaii'               // Kawaii/cute
+'vector_illustration/comic'                // Comic book
+'vector_illustration/line_art'             // Line art
+'vector_illustration/noir_silhouette'      // Noir silhouette
+```
+
+**Configuration Example with All Properties:**
+
+```typescript
+text2image: FalAiImage.RecraftV3({
+  proxyUrl: 'http://your-proxy-server.com/api/proxy',
+  properties: {
+    prompt: '',  // User will fill this
+    style: 'realistic_image/natural_light',
+    image_size: 'landscape_16_9',
+
+    // Dynamic style based on context
+    style: (context) => {
+      const hour = new Date().getHours();
+      if (hour < 6 || hour > 18) {
+        return 'realistic_image/evening_light';
+      }
+      return 'realistic_image/natural_light';
+    }
+  }
+})
+```
+
+**Style Group Control:**
+You can control which style groups (image/vector) are available using the Feature API:
+
+```typescript
+// Disable vector styles, only allow image styles
+cesdk.feature.enable('ly.img.plugin-ai-image-generation-web.fal-ai/recraft-v3.style.vector', false);
+
+// Or disable image styles, only allow vector styles
+cesdk.feature.enable('ly.img.plugin-ai-image-generation-web.fal-ai/recraft-v3.style.image', false);
+```
+
 **Custom Translations:**
 ```typescript
 cesdk.i18n.setTranslations({
@@ -210,6 +315,17 @@ text2image: FalAiImage.Recraft20b({
   headers: {
     'x-custom-header': 'value',
     'x-client-version': '1.0.0'
+  },
+  // Optional: Configure default property values
+  properties: {
+    // Dynamic style defaults based on style type
+    style: (context) => {
+      // Different defaults for different style categories
+      // This is handled internally by the provider
+      return 'broken_line';  // Default for icon styles
+    },
+    image_size: 'square_hd',
+    n_colors: 4  // Default color count for icon styles
   }
 })
 ```
@@ -221,6 +337,79 @@ Key features:
 - Same image size presets and custom dimensions support
 - Cost-effective alternative to RecraftV3
 
+**Available Property Values:**
+
+```typescript
+// image_size options (same as RecraftV3):
+'square_hd'      // 1024x1024 (default)
+'square'         // 512x512
+'portrait_4_3'   // 768x1024
+'portrait_16_9'  // 576x1024
+'landscape_4_3'  // 1024x768
+'landscape_16_9' // 1024x576
+
+// style options - includes all RecraftV3 styles PLUS icon styles:
+// All RecraftV3 styles are supported (see RecraftV3 above)
+
+// Additional Icon styles (unique to Recraft20b):
+'icon/broken_line'            // Broken line icon style
+'icon/colored_outline'        // Colored outline icons
+'icon/colored_shapes'         // Solid colored shapes
+'icon/colored_shapes_gradient' // Gradient colored shapes
+'icon/doodle_fill'           // Doodle-filled icons
+'icon/doodle_offset_fill'    // Offset doodle fill
+'icon/offset_fill'           // Offset fill style
+'icon/outline'               // Simple outline
+'icon/outline_gradient'      // Gradient outline
+'icon/uneven_fill'          // Uneven/artistic fill
+
+// Logo styles:
+'logo'                       // Logo design
+
+// n_colors options (for icon styles):
+1  // Monochrome
+2  // Two colors (default)
+3  // Three colors
+4  // Four colors
+// ... up to any reasonable number
+```
+
+**Configuration Example with All Properties:**
+
+```typescript
+text2image: FalAiImage.Recraft20b({
+  proxyUrl: 'http://your-proxy-server.com/api/proxy',
+  properties: {
+    prompt: '',  // User will fill this
+    style: 'icon/colored_outline',  // Default to icon style
+    image_size: 'square',
+    n_colors: 3,  // Number of colors for icon styles
+
+    // Dynamic style based on use case
+    style: (context) => {
+      // You could check block type or other context
+      const engine = context.engine;
+      // Return appropriate style
+      return 'icon/broken_line';
+    }
+  }
+})
+```
+
+**Style Group Control:**
+You can control which style groups (image/vector/icon) are available using the Feature API:
+
+```typescript
+// Only allow icon styles
+cesdk.feature.enable('ly.img.plugin-ai-image-generation-web.fal-ai/recraft/v2/text-to-image.style.image', false);
+cesdk.feature.enable('ly.img.plugin-ai-image-generation-web.fal-ai/recraft/v2/text-to-image.style.vector', false);
+
+// Only allow image and vector styles (disable icon)
+cesdk.feature.enable('ly.img.plugin-ai-image-generation-web.fal-ai/recraft/v2/text-to-image.style.icon', false);
+```
+
+Note: When all style groups are disabled, the provider automatically falls back to the 'any' style.
+
 **Custom Translations:**
 ```typescript
 cesdk.i18n.setTranslations({
@@ -245,6 +434,12 @@ text2image: OpenAiImage.GptImage1.Text2Image({
   headers: {
     'x-api-key': 'your-key',
     'x-request-source': 'cesdk-plugin'
+  },
+  // Optional: Configure default property values
+  properties: {
+    size: '1024x1024',  // Options: '1024x1024', '1792x1024', '1024x1792'
+    quality: 'standard', // Options: 'standard', 'hd'
+    style: 'vivid'      // Options: 'vivid', 'natural'
   }
 })
 ```
@@ -266,6 +461,12 @@ image2image: FalAiImage.GeminiFlashEdit({
   headers: {
     'x-custom-header': 'value',
     'x-client-version': '1.0.0'
+  },
+  // Optional: Configure default property values
+  properties: {
+    strength: 0.8,        // Transformation strength (0.0-1.0)
+    guidance_scale: 7.5,  // Guidance scale (0-20)
+    num_inference_steps: 50  // Number of inference steps
   }
 })
 ```
@@ -318,6 +519,12 @@ text2image: FalAiImage.IdeogramV3({
   headers: {
     'x-custom-header': 'value',
     'x-client-version': '1.0.0'
+  },
+  // Optional: Configure default property values
+  properties: {
+    style: 'GENERAL',    // Options: 'AUTO', 'GENERAL', 'REALISTIC', 'DESIGN'
+    image_size: 'square_hd', // Same options as Recraft
+    seed: 12345         // Fixed seed for reproducibility
   }
 })
 ```
@@ -337,6 +544,12 @@ image2image: FalAiImage.IdeogramV3Remix({
   headers: {
     'x-custom-header': 'value',
     'x-client-version': '1.0.0'
+  },
+  // Optional: Configure default property values
+  properties: {
+    style: 'AUTO',       // Options: 'AUTO', 'GENERAL', 'REALISTIC', 'DESIGN'
+    image_size: 'square_hd',
+    remix_strength: 0.7  // How much to transform (0.0-1.0)
   }
 })
 ```
@@ -347,7 +560,34 @@ Key features:
 - Multiple image size presets: square HD, square, portrait 4:3/16:9, landscape 4:3/16:9
 - Custom dimensions support (64x64 to 14142x14142 pixels)
 
-#### 7. FluxProKontextEdit (Image-to-Image)
+#### 7. QwenImageEdit (Image-to-Image)
+
+A powerful image editing model with superior text editing capabilities from fal.ai:
+
+```typescript
+image2image: FalAiImage.QwenImageEdit({
+  proxyUrl: 'http://your-proxy-server.com/api/proxy',
+  headers: {
+    'x-custom-header': 'value',
+    'x-client-version': '1.0.0'
+  },
+  // Optional: Configure default property values
+  properties: {
+    seed: 12345,         // Fixed seed for reproducibility
+    guidance_scale: 7.5  // Guidance strength (0-20)
+  }
+})
+```
+
+Key features:
+- **Superior text editing capabilities** for image transformation
+- Transform existing images with detailed text prompts
+- Available through all canvas quick actions (edit, background swap, style transfer, artist styles, variants)
+- Maintains original image dimensions
+- Custom headers support for API requests
+```
+
+#### 8. FluxProKontextEdit (Image-to-Image)
 
 A versatile image editing model that applies stylistic changes and transformations:
 
@@ -362,7 +602,7 @@ Key features:
 - Built-in quick actions for style transfer, artist styles, background swapping, and variants
 - Keeps original image dimensions
 
-#### 8. FluxProKontextMaxEdit (Image-to-Image)
+#### 9. FluxProKontextMaxEdit (Image-to-Image)
 
 A high-quality variant of FluxProKontext offering more detailed results:
 
@@ -388,6 +628,10 @@ text2image: FalAiImage.NanoBanana({
   headers: {
     'x-custom-header': 'value',
     'x-client-version': '1.0.0'
+  },
+  // Optional: Configure default property values
+  properties: {
+    output_format: 'PNG'  // Options: 'PNG', 'JPEG'
   }
 })
 ```
@@ -422,6 +666,11 @@ image2image: FalAiImage.NanoBananaEdit({
   headers: {
     'x-custom-header': 'value',
     'x-client-version': '1.0.0'
+  },
+  // Optional: Configure default property values
+  properties: {
+    strength: 0.7,        // Edit strength (0.0-1.0)
+    output_format: 'PNG'  // Options: 'PNG', 'JPEG'
   }
 })
 ```
@@ -770,6 +1019,16 @@ FalAiImage.GeminiFlashEdit(config: {
 })
 ```
 
+#### QwenImageEdit
+
+```typescript
+FalAiImage.QwenImageEdit(config: {
+  proxyUrl: string;
+  headers?: Record<string, string>;
+  debug?: boolean;
+})
+```
+
 ### OpenAI Providers
 
 #### GptImage1.Text2Image
@@ -918,6 +1177,7 @@ const myImageProvider = {
   - IdeogramV3: `ly.img.ai.fal-ai/ideogram/v3`
   - IdeogramV3Remix: `ly.img.ai.fal-ai/ideogram/v3/remix`
   - GeminiFlashEdit: `ly.img.ai.fal-ai/gemini-flash-edit`
+  - QwenImageEdit: `ly.img.ai.fal-ai/qwen-image-edit`
   - GptImage1.Text2Image: `ly.img.ai.open-ai/gpt-image-1/text2image`
   - GptImage1.Image2Image: `ly.img.ai.open-ai/gpt-image-1/image2image`
   - FluxProKontextEdit: `ly.img.ai.fal-ai/flux-pro/kontext`
@@ -933,6 +1193,7 @@ Generated images are automatically stored in asset sources with the following ID
 - IdeogramV3: `fal-ai/ideogram/v3.history`
 - IdeogramV3Remix: `fal-ai/ideogram/v3/remix.history`
 - GeminiFlashEdit: `fal-ai/gemini-flash-edit.history`
+- QwenImageEdit: `fal-ai/qwen-image-edit.history`
 - GptImage1.Text2Image: `open-ai/gpt-image-1/text2image.history`
 - GptImage1.Image2Image: `open-ai/gpt-image-1/image2image.history`
 - FluxProKontextEdit: `fal-ai/flux-pro/kontext.history`

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

@@ -0,0 +1,21 @@
+import { ImageOutput, type Provider, type CommonProviderConfiguration } from '@imgly/plugin-ai-generation-web';
+import CreativeEditorSDK from '@cesdk/cesdk-js';
+type QwenImageEditInput = {
+    prompt: string;
+    image_url: string;
+    num_images?: number;
+    image_size?: string;
+    acceleration?: 'none' | 'regular' | 'high';
+    output_format?: 'jpeg' | 'png';
+    guidance_scale?: number;
+    num_inference_steps?: number;
+    sync_mode?: boolean;
+    seed?: number;
+    negative_prompt?: string;
+    enable_safety_checker?: boolean;
+};
+export declare function QwenImageEdit(config: CommonProviderConfiguration<QwenImageEditInput, ImageOutput>): (context: {
+    cesdk: CreativeEditorSDK;
+}) => Promise<Provider<'image', QwenImageEditInput, ImageOutput>>;
+declare function getProvider(cesdk: CreativeEditorSDK, config: CommonProviderConfiguration<QwenImageEditInput, ImageOutput>): Provider<'image', QwenImageEditInput, ImageOutput>;
+export default getProvider;

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

@@ -1,6 +1,6 @@
-import { CommonProviderConfiguration, type Provider } from '@imgly/plugin-ai-generation-web';
+import { type Provider } from '@imgly/plugin-ai-generation-web';
 import CreativeEditorSDK from '@cesdk/cesdk-js';
-import { type StyleId } from './Recraft20b.constants';
+import type { Recraft20bConfiguration } from './recraftTypes';
 type Recraft20bOutput = {
     kind: 'image';
     url: string;
@@ -11,24 +11,15 @@ type Recraft20bInput = {
         width: number;
         height: number;
     };
-    style?: StyleId;
+    style?: string;
     colors?: Array<{
         r: number;
         g: number;
         b: number;
     }>;
 };
-interface ProviderConfiguration extends CommonProviderConfiguration<Recraft20bInput, Recraft20bOutput> {
-    /**
-     * Base URL used for the UI assets used in the plugin.
-     *
-     * By default, we load the assets from the IMG.LY CDN You can copy the assets.
-     * from the `/assets` folder to your own server and set the base URL to your server.
-     */
-    baseURL?: string;
-}
-export declare function Recraft20b(config: ProviderConfiguration): (context: {
+export declare function Recraft20b(config: Recraft20bConfiguration): (context: {
     cesdk: CreativeEditorSDK;
 }) => Promise<Provider<'image', Recraft20bInput, Recraft20bOutput>>;
-declare function getProvider(cesdk: CreativeEditorSDK, config: ProviderConfiguration): Provider<'image', Recraft20bInput, Recraft20bOutput>;
+declare function getProvider(cesdk: CreativeEditorSDK, config: Recraft20bConfiguration): Provider<'image', Recraft20bInput, Recraft20bOutput>;
 export default getProvider;

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

@@ -1,22 +1,14 @@
-import { CommonProviderConfiguration, type Provider } from '@imgly/plugin-ai-generation-web';
+import { type Provider } from '@imgly/plugin-ai-generation-web';
 import { type RecraftV3TextToImageInput } from '@fal-ai/client/endpoints';
 import CreativeEditorSDK from '@cesdk/cesdk-js';
+import type { RecraftV3Configuration } from './recraftTypes';
 type RecraftV3Output = {
     kind: 'image';
     url: string;
 };
 export type StyleId = Extract<RecraftV3TextToImageInput['style'], string>;
-interface ProviderConfiguration extends CommonProviderConfiguration<RecraftV3TextToImageInput, RecraftV3Output> {
-    /**
-     * Base URL used for the UI assets used in the plugin.
-     *
-     * By default, we load the assets from the IMG.LY CDN You can copy the assets.
-     * from the `/assets` folder to your own server and set the base URL to your server.
-     */
-    baseURL?: string;
-}
-export declare function RecraftV3(config: ProviderConfiguration): (context: {
+export declare function RecraftV3(config: RecraftV3Configuration): (context: {
     cesdk: CreativeEditorSDK;
 }) => Promise<Provider<'image', RecraftV3TextToImageInput, RecraftV3Output>>;
-declare function getProvider(cesdk: CreativeEditorSDK, config: ProviderConfiguration): Provider<'image', RecraftV3TextToImageInput, RecraftV3Output>;
+declare function getProvider(cesdk: CreativeEditorSDK, config: RecraftV3Configuration): Provider<'image', RecraftV3TextToImageInput, RecraftV3Output>;
 export default getProvider;

package/dist/fal-ai/__tests__/RecraftV3.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -5,6 +5,7 @@ import { FluxProKontextEdit } from './FluxProKontextEdit';
 import { FluxProKontextMaxEdit } from './FluxProKontextMaxEdit';
 import { IdeogramV3 } from './IdeogramV3';
 import { IdeogramV3Remix } from './IdeogramV3Remix';
+import { QwenImageEdit } from './QwenImageEdit';
 import { NanoBanana } from './NanoBanana';
 import { NanoBananaEdit } from './NanoBananaEdit';
 declare const FalAi: {
@@ -13,6 +14,7 @@ declare const FalAi: {
     GeminiFlashEdit: typeof GeminiFlashEdit;
     IdeogramV3: typeof IdeogramV3;
     IdeogramV3Remix: typeof IdeogramV3Remix;
+    QwenImageEdit: typeof QwenImageEdit;
     NanoBanana: typeof NanoBanana;
     NanoBananaEdit: typeof NanoBananaEdit;
     Recraft20b: typeof Recraft20b;