@imgly/plugin-ai-sticker-generation-web 0.2.17 → 1.69.0-nightly.20260130

package/CHANGELOG.md

@@ -1,232 +1,3 @@
-# Changelog - AI Plugins
+# Changelog
 
-## [Unreleased]
-
-## [0.2.17] - 2026-01-26
-
-### Fixed
-
--   [image-generation] **Runware NanoBanana2Pro Dimensions**: Fixed API errors when using non-square aspect ratios (16:9, 9:16, 4:3, 3:4) with Nano Banana 2 Pro provider. The model requires specific dimension combinations (e.g., 1376×768 for 16:9) that differ from the generic aspect ratio map.
--   [image-generation] **Runware Seedream 4.0 Dimensions**: Fixed API errors when using non-square aspect ratios with Seedream 4.0 provider. At 1K resolution, only 1:1 is supported; now using 2K dimensions for all aspect ratios to ensure compatibility.
-
-### Improvements
-
--   [image-generation] **Runware Async Delivery**: Switched from synchronous requests to async delivery with polling to avoid timeouts on slower image generation models.
--   [image-generation] **Runware NanoBanana2Pro I2I**: Added `resolution: '2k'` parameter to image-to-image generation for automatic aspect ratio detection from reference images.
-
-## [0.2.16] - 2026-01-16
-
-### New Features
-
--   [all] **Translatable Action Labels**: AI plugin action labels now support full i18n through `labelKey` property, enabling dynamic translation resolution based on the current locale.
--   [generation-web] **setDefaultTranslations Utility**: Added `setDefaultTranslations()` function that only sets translation keys that don't already exist, allowing integrators to customize translations before plugins load without being overwritten.
--   [all] **External Translation Files**: Plugin translations are now loaded from external `translations.json` files, making it easier to review and customize available translation keys.
-
-### Improvements
-
--   [all] **Translation Override Pattern**: All AI plugins now use `setDefaultTranslations()` instead of `setTranslations()`, ensuring integrator-provided translations take priority over plugin defaults.
--   [apps-web] **Dynamic Card Labels**: AI Apps panel now resolves card labels dynamically using `labelKey` from action metadata, enabling proper i18n for app cards.
-
-### Documentation
-
--   [all] Added comprehensive i18n documentation to README files explaining how to customize translations before plugin initialization.
-
-## [0.2.15] - 2026-01-12
-
-### New Features
-
--   [all] **EachLabs Partner Integration**: Added EachLabs as a new AI provider service with unified API access to multiple image and video generation models.
-    - **Image Generation**: Flux 2 Pro, Flux 2, Flux 2 Flex, Nano Banana Pro, OpenAI GPT Image, Seedream v4.5, Gemini 3 Pro (all with text-to-image and image-to-image variants)
-    - **Video Generation**: Kling v2.6 Pro, Kling O1, Veo 3.1 (text-to-video and image-to-video variants)
-
-## [0.2.14] - 2025-12-15
-
-## [0.2.13] - 2025-12-15
-
-### New Features
-
--   [all] **Runware Partner Integration**: Added Runware as a new AI provider service, offering access to multiple image and video generation models through a unified API. Runware provides a single endpoint for accessing various AI models with consistent configuration.
-    - **Image Generation**: FLUX.2 [dev], FLUX.2 [pro], FLUX.2 [flex], Seedream 4.0, Seedream 4.5, Nano Banana 2 Pro, GPT Image 1, GPT Image 1 Mini (all with text-to-image and image-to-image variants)
-    - **Video Generation**: Google Veo 3.1, Veo 3.1 Fast, OpenAI Sora 2, Sora 2 Pro (all with text-to-video and image-to-video variants)
-
-## [0.2.12] - 2025-11-21
-
-## [0.2.11] - 2025-11-21
-
-### New Features
-
--   [generation-web] **Input Placeholder Customization**: Added support for customizing placeholder text in input fields (e.g., prompt textarea) through the i18n translation system. Placeholders follow the same priority chain as labels:
-    1. Provider-specific: `ly.img.plugin-ai-{kind}-generation-web.{provider.id}.property.{field}.placeholder`
-    2. Global: `ly.img.plugin-ai-generation-web.property.{field}.placeholder`
-    3. Provider defaults: `ly.img.plugin-ai-{kind}-generation-web.{provider.id}.defaults.property.{field}.placeholder`
-    4. Global defaults: `ly.img.plugin-ai-generation-web.defaults.property.{field}.placeholder`
--   [image-generation] **Gemini Provider Placeholders**: Added example placeholder text to Gemini providers (GeminiFlash25 and Gemini25FlashImageEdit) demonstrating provider-specific placeholder customization
--   [image-generation] **NanoBananaPro Provider**: Added NanoBananaPro text-to-image provider via fal.ai, an enhanced version of NanoBanana with advanced configuration options including 10 aspect ratio presets (1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, 9:21, 2.4:1), resolution multipliers (1K, 2K, 4K for standard/high/ultra quality), dynamic dimension calculation based on aspect ratio and resolution, and remixPageWithPrompt quick action support
--   [image-generation] **NanoBananaProEdit Provider**: Added NanoBananaProEdit image-to-image provider via fal.ai for professional-grade image editing with text prompts, supporting resolution control (1K/2K/4K), all standard quick actions (editImage, swapBackground, styleTransfer, artistTransfer, createVariant, combineImages with up to 10 images, remixPage, remixPageWithPrompt), and automatic dimension preservation from source images
-
-## [0.2.10] - 2025-10-22
-
-### New Features
-
--   [video-generation] **Google Veo 3.1 Provider Suite**: Added comprehensive Google Veo 3.1 video generation providers via fal.ai, offering multiple models optimized for different use cases:
-    - **Text-to-Video Providers**:
-        - `Veo31TextToVideo`: Standard quality text-to-video with configurable aspect ratios (16:9, 9:16, 1:1), variable duration (4s, 6s, 8s), resolution options (720p, 1080p), and optional audio generation
-        - `Veo31FastTextToVideo`: Faster and more cost-effective text-to-video variant with same capabilities as standard version
-    - **Image-to-Video Providers**:
-        - `Veo31ImageToVideo`: Standard quality image-to-video with auto aspect ratio detection, multiple preset options (16:9, 9:16, 1:1), resolution options (720p, 1080p), fixed 8-second duration, and optional audio generation
-        - `Veo31FastImageToVideo`: Faster and more cost-effective image-to-video variant with same capabilities
-    - **First-Last Frame Providers** (experimental dual-image transformation):
-        - `Veo31FirstLastFrameToVideo`: Standard quality interpolation between two images (first and last frame)
-        - `Veo31FastFirstLastFrameToVideo`: Faster variant with dual image input UI, multiple aspect ratios (16:9, 9:16, 1:1, 4:3, 3:4), resolution options (480p, 720p, 1080p), adjustable duration (2-8 seconds), optional prompt guidance, and optional audio generation
-    - **Quick Action Support**: Added "Animate Between Images" quick action for creating smooth transitions between two selected images using the first-last-frame providers
-
-## [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
-
--   [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
-
--   [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
-
--   [ai-apps] Fix issue with undefined `cesdk` instance
-
-## [0.2.1] - 2025-07-15
-
--   [ai-apps] Fix issue where AI apps panel displayed empty content when no provider app was available
--   [ai-apps] Maintain backwards compatibility by registering legacy AI apps ID, alongside new `ly.img.ai.apps` panel ID
-
-## [0.2.0] - 2025-07-15
-
-### Breaking Changes
-
--   [all] **Provider Initialization**: `initProvider` is replaced with `initializeProviders` and `initializeProvider` with a different signature
--   [all] **Quick Actions Structure**: `provider.input.quickctions.actions` replaced with `provider.input.quickActions.supported`
--   [all] **History Asset Sources**: Combined history asset source is now not added to the default asset libraries anymore. Add the following sources to any library entry (default or not):
-    -   Image Generation History: `ly.img.ai.image-generation.history`
-    -   Video Generation History: `ly.img.ai.video-generation.history`
-    -   Audio Generation History: `ly.img.ai.audio-generation.history`
-    -   Sticker Generation History: `ly.img.ai.sticker-generation.history`
--   [all] **ID Format Standardization**: All `ly.img.ai/` prefixed IDs changed to use dot notation `ly.img.ai.` for consistency
-    -   Panel IDs: `ly.img.ai/apps` → `ly.img.ai.apps`, `ly.img.ai/image-generation` → `ly.img.ai.image-generation`
-    -   Dock IDs: `ly.img.ai/apps.dock` → `ly.img.ai.apps.dock`
-
-### New Features
-
--   [all] **Multiple Providers Support**: All plugin packages now support arrays of providers with automatic selection UI
--   [image-generation] **Recraft20b Provider**: Added new Recraft20b (v2) provider via fal.ai with support for icon styles including `broken_line`, `colored_outline`, `colored_shapes`, and more
--   [sticker-generation] **New Sticker Generation Plugin**: Added `@imgly/plugin-ai-sticker-generation-web` plugin for AI-powered sticker generation with support for text-to-sticker generation using Recraft20b provider with icon styles
--   [image-generation] **Flux Pro Kontext Provider**: Added Flux Pro Kontext provider for image editing with style transfer and artist style options
--   [image-generation] **Flux Pro Kontext Max Provider**: Added Flux Pro Kontext Max provider for enhanced image editing capabilities
--   [video-generation] **Veo3 Provider**: Added Veo3 text-to-video provider via fal.ai with support for 16:9, 9:16, and 1:1 aspect ratios and 8-second duration
--   [video-generation] **Kling Video V2.1 Master Providers**: Added Kling Video V2.1 Master providers for both text-to-video and image-to-video generation with configurable duration (5s/10s) and aspect ratios
--   [text-generation] **Model Selection**: OpenAI and Anthropic providers now support configurable model selection through the `model` parameter
-
-### Deprecated Features
-
--   [all] **Middleware Configuration**: The `middleware` property in provider configurations is deprecated. Use `middlewares` instead. The old property will continue to work for now.
-
-## [0.1.10] - 2025-06-20
-
--   [all] Fix issue with GPT provider when using text provider
-
-## [0.1.9] - 2025-06-05
-
--   [all] Add support for custom headers
-
-## [0.1.8] - 2025-05-26
-
--   [ai-apps] Handle `sceneMode` change in upcoming CE.SDK version 1.52.0
-
-## [0.1.0] - 2025-04-17
-
--   [all] Initial release
+See the main [CE.SDK CHANGELOG](https://img.ly/docs/cesdk/changelog/) for all plugin changes.

package/README.md

@@ -1,360 +1,9 @@
-# IMG.LY AI Sticker Generation for Web
+# @imgly/plugin-ai-sticker-generation-web
 
-A plugin for integrating AI sticker generation capabilities into CreativeEditor SDK.
+AI sticker generation plugin for the CE.SDK editor
 
-## Overview
-
-The `@imgly/plugin-ai-sticker-generation-web` package enables users to generate stickers using AI directly within CreativeEditor SDK. This plugin leverages the [fal.ai](https://fal.ai) platform to provide high-quality sticker generation from text prompts using optimized icon styles.
-
-Features include:
-- Text-to-sticker generation
-- Icon-style sticker generation optimized for transparency
-- Various icon styles (broken line, colored outline, colored shapes, etc.)
-- Custom dimensions support
-- Automatic history tracking
-- Seamless integration with CreativeEditor SDK
-
-## Installation
-
-```bash
-npm install @imgly/plugin-ai-sticker-generation-web
-```
-
-## Usage
-
-### Basic Configuration
-
-To use the plugin, import it and configure it with your preferred providers:
-
-#### Single Provider Configuration
-
-```typescript
-import CreativeEditorSDK from '@cesdk/cesdk-js';
-import StickerGeneration from '@imgly/plugin-ai-sticker-generation-web';
-import FalAiSticker from '@imgly/plugin-ai-sticker-generation-web/fal-ai';
-
-// Initialize CreativeEditor SDK
-CreativeEditorSDK.create(domElement, {
-  license: 'your-license-key',
-  // Other configuration options...
-}).then(async (cesdk) => {
-  // Add the sticker generation plugin with fal.ai provider
-  cesdk.addPlugin(
-    StickerGeneration({
-      // Text-to-sticker provider
-      text2sticker: FalAiSticker.Recraft20b({
-        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: {
-          style: { default: 'broken_line' },  // Default icon style for stickers
-          image_size: { default: 'square' },  // Default size
-          n_colors: { default: 2 }  // Default color count
-        }
-      }),
-      
-      // Optional configuration
-      debug: false,
-      dryRun: false
-    })
-  );
-});
-```
-
-#### Multiple Providers Configuration
-
-You can configure multiple providers for text-to-sticker generation, and users will see a selection box to choose between them:
-
-```typescript
-import CreativeEditorSDK from '@cesdk/cesdk-js';
-import StickerGeneration from '@imgly/plugin-ai-sticker-generation-web';
-import FalAiSticker from '@imgly/plugin-ai-sticker-generation-web/fal-ai';
-
-// Initialize CreativeEditor SDK
-CreativeEditorSDK.create(domElement, {
-  license: 'your-license-key',
-  // Other configuration options...
-}).then(async (cesdk) => {
-  // Add the sticker generation plugin with multiple providers
-  cesdk.addPlugin(
-    StickerGeneration({
-      // Multiple text-to-sticker providers
-      text2sticker: [
-        FalAiSticker.Recraft20b({
-          proxyUrl: 'http://your-proxy-server.com/api/proxy',
-          headers: {
-            'x-custom-header': 'value',
-            'x-client-version': '1.0.0'
-          }
-        })
-        // Add more providers as they become available
-      ],
-      
-      // Optional configuration
-      debug: false,
-      dryRun: false
-    })
-  );
-});
-```
-
-### Providers
-
-The plugin comes with pre-configured providers for fal.ai models:
-
-#### Recraft20b (Text-to-Sticker)
-
-A specialized text-to-sticker model from fal.ai with icon style support optimized for sticker generation:
-
-```typescript
-text2sticker: FalAiSticker.Recraft20b({
-  proxyUrl: 'http://your-proxy-server.com/api/proxy',
-  headers: {
-    'x-custom-header': 'value',
-    'x-client-version': '1.0.0'
-  }
-})
-```
-
-Key features:
-- **Icon styles optimized for stickers**: broken_line, colored_outline, colored_shapes, doodle_fill, and more
-- Various image size presets (square, landscape, portrait)
-- Custom dimensions support
-- Transparent background support
-- Cost-effective sticker generation
-- Custom headers support for API requests
-
-Available icon styles:
-- `broken_line`: Clean broken line style
-- `colored_outline`: Colored outline style
-- `colored_shapes`: Filled colored shapes
-- `colored_shapes_gradient`: Gradient filled shapes
-- `doodle_fill`: Doodle-style fill
-- `doodle_offset_fill`: Offset doodle fill
-- `offset_fill`: Offset fill style
-- `outline`: Simple outline style
-- `outline_gradient`: Gradient outline
-- `uneven_fill`: Uneven fill style
-
-### Configuration Options
-
-The plugin accepts the following configuration options:
-
-| Option | Type | Description | Default |
-|--------|------|-------------|---------|
-| `text2sticker` | Provider \| Provider[] | Provider(s) for text-to-sticker generation. When multiple providers are provided, users can select between them | undefined |
-| `debug` | boolean | Enable debug logging | false |
-| `dryRun` | boolean | Simulate generation without API calls | false |
-| `middleware` | Function[] | Array of middleware functions to extend the generation process | undefined |
-
-### Middleware Configuration
-
-The `middleware` option allows you to add pre-processing and post-processing capabilities to the generation process:
-
-```typescript
-import StickerGeneration from '@imgly/plugin-ai-sticker-generation-web';
-import FalAiSticker from '@imgly/plugin-ai-sticker-generation-web/fal-ai';
-import { loggingMiddleware, rateLimitMiddleware } from '@imgly/plugin-ai-generation-web';
-
-// Create middleware functions
-const logging = loggingMiddleware();
-const rateLimit = rateLimitMiddleware({
-  maxRequests: 10,
-  timeWindowMs: 60000, // 1 minute
-  onRateLimitExceeded: (input, options, info) => {
-    console.log(`Rate limit exceeded: ${info.currentCount}/${info.maxRequests}`);
-    return false; // Reject request
-  }
-});
-
-// Apply middleware to plugin
-cesdk.addPlugin(
-  StickerGeneration({
-    text2sticker: FalAiSticker.Recraft20b({
-      proxyUrl: 'http://your-proxy-server.com/api/proxy'
-    }),
-    middleware: [logging, rateLimit] // Apply middleware in order
-  })
-);
-```
-
-Built-in middleware options:
-
-- **loggingMiddleware**: Logs generation requests and responses
-- **rateLimitMiddleware**: Limits the number of generation requests in a time window
-
-#### 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: `Sticker 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:
-
-```typescript
-text2sticker: FalAiSticker.Recraft20b({
-  proxyUrl: 'http://your-proxy-server.com/api/proxy',
-  headers: {
-    'x-custom-header': 'value',
-    'x-client-version': '1.0.0'
-  }
-})
-```
-
-The `headers` option allows you to include custom HTTP headers in all API requests. This is useful for:
-- Adding custom client identification headers
-- Including version information
-- Passing through metadata required by your API
-- Adding correlation IDs for request tracing
-
-You'll need to implement a proxy server that forwards requests to fal.ai and handles authentication.
-
-## API Reference
-
-### Main Plugin
-
-```typescript
-StickerGeneration(options: PluginConfiguration): EditorPlugin
-```
-
-Creates and returns a plugin that can be added to CreativeEditor SDK.
-
-### Plugin Configuration
-
-```typescript
-interface PluginConfiguration {
-  // Provider(s) for text-to-sticker generation
-  text2sticker?: AiStickerProvider | AiStickerProvider[];
-  
-  // Enable debug logging
-  debug?: boolean;
-  
-  // Skip actual API calls for testing
-  dryRun?: boolean;
-  
-  // Extend the generation process
-  middleware?: GenerationMiddleware;
-}
-```
-
-### Fal.ai Providers
-
-#### Recraft20b
-
-```typescript
-FalAiSticker.Recraft20b(config: {
-  proxyUrl: string;
-  headers?: Record<string, string>;
-  debug?: boolean;
-})
-```
-
-## UI Integration
-
-The plugin automatically registers the following UI components:
-
-1. **Generation Panel**: A sidebar panel for text-to-sticker generation
-2. **History Library**: Displays previously generated stickers
-3. **Dock Component**: A button in the dock area to open the sticker generation panel
-
-### Panel IDs
-
-- Main panel: `ly.img.ai.sticker-generation`
-- Provider-specific panels:
-  - Recraft20b: `ly.img.ai.fal-ai/recraft/v2/text-to-sticker`
-
-### Asset History
-
-Generated stickers are automatically stored in asset sources with the following IDs:
-- Recraft20b: `fal-ai/recraft/v2/text-to-sticker.history`
-
-### Dock Integration
-
-The plugin automatically registers a dock component with a sparkle icon that opens the sticker generation panel. To customize the component's position in the dock, use the `setDockOrder` method:
-
-```typescript
-// Add the AI Sticker component to the beginning of the dock
-cesdk.ui.setDockOrder([
-  'ly.img.ai.sticker-generation.dock',
-  ...cesdk.ui.getDockOrder()
-]);
-
-// Or add it at a specific position
-const currentOrder = cesdk.ui.getDockOrder();
-currentOrder.splice(2, 0, 'ly.img.ai.sticker-generation.dock');
-cesdk.ui.setDockOrder(currentOrder);
-```
-
-## Integration with AI Apps Plugin
-
-The sticker generation plugin integrates seamlessly with the AI Apps plugin:
-
-```typescript
-import AIApps from '@imgly/plugin-ai-apps-web';
-import FalAiSticker from '@imgly/plugin-ai-sticker-generation-web/fal-ai';
-
-cesdk.addPlugin(
-  AIApps({
-    providers: {
-      // Other providers...
-      text2sticker: FalAiSticker.Recraft20b({
-        proxyUrl: 'http://your-proxy-server.com/api/proxy'
-      })
-    }
-  })
-);
-```
-
-When integrated with AI Apps, the sticker generation functionality appears in the main AI interface alongside other AI generation capabilities.
-
-## Translations
-
-For customization and localization, see the [translations.json](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-sticker-generation-web/translations.json) file which contains provider-specific translation keys for sticker 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
-- [@imgly/plugin-ai-apps-web](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-apps-web) - AI apps orchestration
-- [@imgly/plugin-ai-image-generation-web](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-image-generation-web) - AI image generation
-- [@imgly/plugin-ai-video-generation-web](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-video-generation-web) - AI video generation
-- [@imgly/plugin-ai-audio-generation-web](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-audio-generation-web) - AI audio generation
+For documentation, visit: https://img.ly/docs/cesdk
 
 ## License
 
-This plugin is part of the IMG.LY plugin ecosystem for CreativeEditor SDK. Please refer to the license terms in the package.
+This plugin is part of the IMG.LY plugin ecosystem for CreativeEditor SDK.