@imgly/plugin-ai-generation-web 0.2.6 → 0.2.7

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 ## [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

package/README.md

@@ -210,6 +210,9 @@ interface CommonProviderConfiguration<I, O extends Output> {
     supportedQuickActions?: {
         [quickActionId: string]: Partial<QuickActionSupport<I>> | false | null;
     };
+
+    // Configure default property values
+    properties?: PropertiesConfiguration;
 }
 ```
 
@@ -283,6 +286,53 @@ const provider = createMyImageProvider({
 - Object with `mapInput`: Override the quick action with custom input mapping
 - Object with other properties: Override with custom configuration
 
+#### Property Configuration
+
+The `properties` field allows you to define default values for any provider property. These defaults can be static values or dynamic functions that receive context:
+
+```typescript
+const provider = createMyImageProvider({
+    proxyUrl: 'https://proxy.example.com',
+
+    // Configure default property values
+    properties: {
+        // Static default value
+        image_size: 'square_hd',
+
+        // Dynamic default based on context
+        style: (context) => {
+            // Context includes: engine, cesdk, locale
+            const locale = context.locale;
+
+            // Return different defaults for different locales
+            if (locale === 'de') {
+                return 'realistic';
+            }
+            return 'digital_illustration';
+        },
+
+        // Dynamic default based on design state
+        resolution: (context) => {
+            const engine = context.engine;
+            const scene = engine.scene.get();
+            const width = engine.block.getFloat(scene, 'scene/frame/width');
+
+            // Choose resolution based on canvas size
+            if (width > 1920) {
+                return '1080p';
+            }
+            return '720p';
+        }
+    }
+});
+```
+
+**Property Configuration Features:**
+- **Static Defaults**: Simple values that apply to all users
+- **Dynamic Defaults**: Functions that return values based on context (engine state, locale, etc.)
+- **Context Available**: `engine`, `cesdk`, `locale` for making informed decisions
+- **Fallback Chain**: Properties use configured value → schema default → undefined
+
 ### Headers Configuration
 
 The `headers` property allows you to include custom HTTP headers in all API requests made by your provider. This is useful for:

package/dist/__tests__/propertyResolver.test.d.ts

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

package/dist/core/propertyConfiguration.d.ts

@@ -0,0 +1,58 @@
+import type { CreativeEngine } from '@cesdk/cesdk-js';
+import type CreativeEditorSDK from '@cesdk/cesdk-js';
+/**
+ * Base context provided to all property default functions
+ */
+export interface PropertyContext {
+    /**
+     * Creative Engine instance
+     * Always available for engine-level operations
+     */
+    engine: CreativeEngine;
+    /**
+     * Creative Editor SDK instance
+     * May be undefined if running headless or without UI
+     */
+    cesdk?: CreativeEditorSDK;
+    /**
+     * Current locale for internationalization
+     * Format: ISO 639-1 language code (e.g., 'en', 'de', 'ja')
+     * Defaults to 'en' if not available
+     */
+    locale: string;
+}
+/**
+ * Configuration for a single property
+ * @template T - The type of the property value
+ * @template C - The context type (defaults to PropertyContext)
+ */
+export interface PropertyConfig<T, C extends PropertyContext = PropertyContext> {
+    /**
+     * Default value for the property
+     * Can be a static value or a function that returns the value
+     */
+    default?: T | ((context: C) => T);
+}
+/**
+ * Properties configuration for a provider
+ * @template I - The input type of the provider
+ */
+export type PropertiesConfiguration<I> = {
+    [K in keyof Partial<I>]?: PropertyConfig<I[K]>;
+};
+/**
+ * Utility type for extending property contexts selectively
+ * @template I - The input type of the provider
+ * @template ContextMap - Map of property names to their extended context types
+ *
+ * @example
+ * ```typescript
+ * type MyConfig = ExtendPropertyContexts<MyInput, {
+ *   style: StyleContext;  // style property gets StyleContext
+ *   // other properties get PropertyContext
+ * }>;
+ * ```
+ */
+export type ExtendPropertyContexts<I, ContextMap extends Partial<Record<keyof I, PropertyContext>>> = {
+    [K in keyof Partial<I>]: K extends keyof ContextMap ? ContextMap[K] extends PropertyContext ? PropertyConfig<I[K], ContextMap[K]> : PropertyConfig<I[K]> : PropertyConfig<I[K]>;
+};

package/dist/core/provider.d.ts

@@ -18,6 +18,11 @@ interface Provider<K extends OutputKind, I, O extends Output, C = O> {
      * The human-readable name of the provider.
      */
     name?: string;
+    /**
+     * Provider-specific configuration passed during initialization
+     * @internal
+     */
+    configuration?: any;
     /**
      * Initialize the provider when the plugin is loaded.
      * Can be used to initialize libraries, and register additional UI components.

package/dist/index.d.ts

@@ -8,6 +8,9 @@ export { CommonProperties };
 export { type default as Provider, type ImageOutput, type VideoOutput, type TextOutput, type AudioOutput, type StickerOutput, type Output, type OutputKind, type PanelInputSchema, type RenderCustomProperty, type GetBlockInput, type GetBlockInputResult, type GetInput } from './core/provider';
 export { type GetPropertyInput, type Property } from './openapi/types';
 export { type GetProvider, type CommonProviderConfiguration, type CommonPluginConfiguration, type CommonConfiguration, type InternalPluginConfiguration } from './types';
+export type { PropertyContext, PropertyConfig, PropertiesConfiguration, ExtendPropertyContexts } from './core/propertyConfiguration';
+export { buildPropertyContext, PropertyContextCache } from './utils/propertyContext';
+export { resolvePropertyDefault, resolvePropertyDefaults } from './utils/propertyResolver';
 export { default as integrateIntoDefaultAssetLibraryEntry } from './assets/integrateIntoDefaultAssetLibraryEntry';
 export { ActionRegistry, type PluginActionDefinition, type QuickActionDefinition, type ActionDefinition, type ActionRegistryEventType, type ActionRegistrySubscriberCallback, type ActionRegistryFilters } from './core/ActionRegistry';
 export { ProviderRegistry } from './core/ProviderRegistry';