@imgly/codesign-mcp 0.1.5 → 0.1.6

package/assets/docs/guide/plugins.md

@@ -1,36 +1,30 @@
-> This is one page of the CE.SDK Vanilla JS/TS documentation. For a complete overview, see the [Vanilla JS/TS Documentation Index](https://img.ly/docs/cesdk/js.md). For all docs in one file, see [llms-full.txt](./llms-full.txt.md).
+> This is one page of the CE.SDK Node.js documentation. For a complete overview, see the [Node.js Documentation Index](https://img.ly/docs/cesdk/node.md). For all docs in one file, see [llms-full.txt](./llms-full.txt.md).
 
 **Navigation:** [Plugins](./plugins.md)
 
 ---
 
+
+
 Learn how to extend CE.SDK functionality with plugins to add custom features, effects, and integrations.
 
+
+
 ---
 
 ## Related Pages
 
-- [Asset Source Plugins](./plugins/asset-sources.md) - Reference documentation for CE.SDK asset source plugins - pre-built asset libraries for images, stickers, filters, effects, fonts, and more
-- [How to Export Print-Ready PDFs with CE.SDK](./plugins/print-ready-pdf.md) - Learn to convert CE.SDK's PDF exports into PDF/X-3 compliant, CMYK print-ready files for professional commercial printing
-- [AI Integration](./user-interface/ai-integration.md) - Integrate external AI services into CE.SDK to enhance creative workflows and power advanced features.
-- [IMG.LY AI Gateway](./user-interface/ai-integration/gateway-provider.md) - Connect CE.SDK to AI models for image, video, text, and audio generation through the IMG.LY AI Gateway, a managed service that handles authentication, model routing, and billing.
-- [AI Text Generation](./user-interface/ai-integration/text-generation.md) - Generate creative content for headlines, descriptions, captions, and marketing copy using Claude or GPT with both a built-in UI and programmatic control.
-- [AI Image Generation](./user-interface/ai-integration/image-generation.md) - Create visuals from text prompts or transform existing images using leading AI providers like fal.ai (RecraftV3, Recraft20b, IdeogramV3, GeminiFlash) and OpenAI (GPT Image) with support for both raster and vector outputs.
-- [AI Video Generation](./user-interface/ai-integration/video-generation.md) - Create dynamic videos from text descriptions or animate static images using leading AI providers like fal.ai with Minimax Video, Pixverse, Kling Video, and ByteDance Seedance models.
-- [Audio Generation](./user-interface/ai-integration/audio-generation.md) - Integrate AI-powered audio generation into CE.SDK with text-to-speech and sound effects using the Audio Generation plugin.
-- [Auto Captions](./user-interface/ai-integration/auto-captions.md) - Integrate automatic caption generation into your CE.SDK application using the Auto Caption plugin with pluggable speech-to-text providers.
-- [Export to HTML5](./export-save-publish/export/to-html5.md) - Export CE.SDK designs as HTML5 bundles with customizable output for display ads and interactive web content.
+- [How to Export Print-Ready PDFs in Node.js](./plugins/print-ready-pdf.md) - Learn to automate PDF/X conversion with CE.SDK Engine in Node.js for batch processing and server-side workflows
 - [Remove Background](./edit-image/remove-bg.md) - Remove image backgrounds to isolate subjects or prepare assets for compositing and reuse.
-- [Vectorize](./edit-image/vectorize.md) - Convert raster images into scalable vector graphics for flexible resizing and editing.
 - [Create Cutout](./stickers-and-shapes/create-cutout.md) - Create cutout paths for cutting printers to produce die-cut stickers, iron-on decals, and custom-shaped prints.
 - [Insert QR Code](./stickers-and-shapes/insert-qr-code.md) - Add scannable QR codes to designs using image fills.
-- [Integrate Soundstripe Audio Library](./import-media/from-remote-source/soundstripe.md) - Search and import royalty-free audio tracks from Soundstripe directly into CE.SDK.
+
 
 ---
 
 ## More Resources
 
-- **[Vanilla JS/TS Documentation Index](https://img.ly/docs/cesdk/js.md)** - Browse all Vanilla JS/TS documentation
+- **[Node.js Documentation Index](https://img.ly/docs/cesdk/node.md)** - Browse all Node.js documentation
 - **[Complete Documentation](./llms-full.txt.md)** - Full documentation in one file (for LLMs)
-- **[Web Documentation](./js.md)** - Interactive documentation with examples
-- **[Support](mailto:support@img.ly)** - Contact IMG.LY support
+- **[Web Documentation](./node.md)** - Interactive documentation with examples
+- **[Support](mailto:support@img.ly)** - Contact IMG.LY support

package/assets/docs/guide/rules/asset-handling.md

@@ -7,7 +7,6 @@ Patterns for working with images, URIs, and fills in CE.SDK.
 CE.SDK uses a **Skia-based rendering engine** with limited SVG support. Complex SVGs (gradients, filters, advanced paths) may render incorrectly or as blank.
 
 **Recommended formats:**
-
 - **PNG** — Best compatibility, supports alpha transparency
 - **WebP** — Smaller file size, good browser support
 - **JPEG** — For photos without transparency
@@ -35,7 +34,7 @@ console.log(meta.channels); // 4
 CE.SDK resolves **relative URIs** against `config.baseURL`, which defaults to the IMG.LY CDN:
 
 ```
-config.baseURL = 'https://cdn.img.ly/packages/imgly/cesdk-js/1.67.0/assets'
+config.baseURL = 'https://cdn.img.ly/packages/imgly/cesdk-js/<version>/assets'
 ```
 
 A URI like `/mockups/tshirt.png` becomes `https://cdn.img.ly/.../mockups/tshirt.png` — not `https://yourapp.com/mockups/tshirt.png`.
@@ -77,7 +76,6 @@ engine.block.setSourceSet(fill, 'fill/image/sourceSet', [
 ```
 
 The `Source` type from `@cesdk/engine`:
-
 ```typescript
 interface Source {
   uri: string;
@@ -91,11 +89,7 @@ interface Source {
 Sets only the URI — the engine must load the image to determine dimensions:
 
 ```typescript
-engine.block.setString(
-  fill,
-  'fill/image/imageFileURI',
-  'https://example.com/mockup.png'
-);
+engine.block.setString(fill, 'fill/image/imageFileURI', 'https://example.com/mockup.png');
 ```
 
 Use `setSourceSet` when you know the image dimensions (which you usually do for mockups and templates).
@@ -106,11 +100,11 @@ Use `setSourceSet` when you know the image dimensions (which you usually do for
 
 CE.SDK supports several fill types:
 
-| Fill Type | Created With                       | Use Case                                  |
-| --------- | ---------------------------------- | ----------------------------------------- |
+| Fill Type | Created With | Use Case |
+|-----------|-------------|----------|
 | `'image'` | `engine.block.createFill('image')` | Product mockups, user photos, backgrounds |
-| `'color'` | `engine.block.createFill('color')` | Solid color backgrounds, placeholders     |
-| `'video'` | `engine.block.createFill('video')` | Video backgrounds                         |
+| `'color'` | `engine.block.createFill('color')` | Solid color backgrounds, placeholders |
+| `'video'` | `engine.block.createFill('video')` | Video backgrounds |
 
 ### Setting Fills
 
@@ -122,12 +116,7 @@ engine.block.setSourceSet(imageFill, 'fill/image/sourceSet', sources);
 
 // Color fill (e.g. transparent page background)
 const colorFill = engine.block.getFill(page); // pages have a default fill
-engine.block.setColor(colorFill, 'fill/color/value', {
-  r: 0,
-  g: 0,
-  b: 0,
-  a: 0
-});
+engine.block.setColor(colorFill, 'fill/color/value', { r: 0, g: 0, b: 0, a: 0 });
 ```
 
 ---

package/assets/docs/guide/rules/common-pitfalls.md

@@ -20,7 +20,10 @@ See: `mockup-editor-architecture.md` (in the rules directory)
 
 ```javascript
 import sharp from 'sharp';
-await sharp('mockup.svg').resize(800, 940).png().toFile('mockup.png');
+await sharp('mockup.svg')
+  .resize(800, 940)
+  .png()
+  .toFile('mockup.png');
 ```
 
 Ensure PNGs preserve alpha transparency (`hasAlpha: true`).
@@ -54,6 +57,7 @@ Apply this before passing URIs to `setSourceSet` or `setString('fill/image/image
 
 ```typescript
 // Approach A: Action-based scene creation (recommended)
+// Scenes are unified by default — design and video capabilities both work.
 await cesdk.actions.run('scene.create', {
   page: {
     sourceId: 'ly.img.page.presets',
@@ -61,22 +65,13 @@ await cesdk.actions.run('scene.create', {
   }
 });
 
-// For video scenes, add mode: 'Video'
-await cesdk.actions.run('scene.create', {
-  mode: 'Video',
-  page: {
-    sourceId: 'ly.img.page.presets',
-    assetId: 'ly.img.page.presets.instagram.story'
-  }
-});
-
 // With custom dimensions
 await cesdk.actions.run('scene.create', {
   page: { width: 1080, height: 1920, unit: 'Pixel' }
 });
 
 // Approach B: Manual scene creation (preferred for mockup editors)
-engine.scene.create('Free');
+engine.scene.create();
 engine.editor.setSettingBool('page/dimOutOfPageAreas', false);
 ```
 
@@ -90,23 +85,16 @@ engine.editor.setSettingBool('page/dimOutOfPageAreas', false);
 
 ```typescript
 import {
-  BlurAssetSource,
-  ColorPaletteAssetSource,
-  CropPresetsAssetSource,
-  DemoAssetSources,
-  EffectsAssetSource,
-  FiltersAssetSource,
-  PagePresetsAssetSource,
-  StickerAssetSource,
-  TextAssetSource,
-  TextComponentAssetSource,
-  TypefaceAssetSource,
-  UploadAssetSources,
+  ImageColorsAssetSource, BlurAssetSource, ColorPaletteAssetSource, CropPresetsAssetSource,
+  DemoAssetSources, EffectsAssetSource, FiltersAssetSource,
+  PagePresetsAssetSource, StickerAssetSource, TextAssetSource,
+  TextComponentAssetSource, TypefaceAssetSource, UploadAssetSources,
   VectorShapeAssetSource
 } from '@cesdk/cesdk-js/plugins';
 
 // Default asset source plugins
 await cesdk.addPlugin(new BlurAssetSource());
+await cesdk.addPlugin(new ImageColorsAssetSource());
 await cesdk.addPlugin(new ColorPaletteAssetSource());
 await cesdk.addPlugin(new CropPresetsAssetSource());
 await cesdk.addPlugin(new EffectsAssetSource());
@@ -131,20 +119,20 @@ await cesdk.addPlugin(
 
 Asset source IDs:
 
-| Plugin Class                | Asset Source ID          |
-| --------------------------- | ------------------------ |
-| `BlurAssetSource`           | `ly.img.blur`            |
+| Plugin Class | Asset Source ID |
+|-------------|----------------|
+| `BlurAssetSource` | `ly.img.blur` |
 | `CaptionPresetsAssetSource` | `ly.img.caption.presets` |
-| `ColorPaletteAssetSource`   | `ly.img.color.palette`   |
-| `CropPresetsAssetSource`    | `ly.img.crop.presets`    |
-| `EffectsAssetSource`        | `ly.img.effect`          |
-| `FiltersAssetSource`        | `ly.img.filter`          |
-| `PagePresetsAssetSource`    | `ly.img.page.presets`    |
-| `StickerAssetSource`        | `ly.img.sticker`         |
-| `TextAssetSource`           | `ly.img.text`            |
-| `TextComponentAssetSource`  | `ly.img.text.components` |
-| `TypefaceAssetSource`       | `ly.img.typeface`        |
-| `VectorShapeAssetSource`    | `ly.img.vector.shape`    |
+| `ColorPaletteAssetSource` | `ly.img.color.palette` |
+| `CropPresetsAssetSource` | `ly.img.crop.presets` |
+| `EffectsAssetSource` | `ly.img.effect` |
+| `FiltersAssetSource` | `ly.img.filter` |
+| `PagePresetsAssetSource` | `ly.img.page.presets` |
+| `StickerAssetSource` | `ly.img.sticker` |
+| `TextAssetSource` | `ly.img.text` |
+| `TextComponentAssetSource` | `ly.img.text.components` |
+| `TypefaceAssetSource` | `ly.img.typeface` |
+| `VectorShapeAssetSource` | `ly.img.vector.shape` |
 
 ---
 
@@ -153,7 +141,6 @@ Asset source IDs:
 **Problem:** Setting a white product mockup as a page's image fill makes it invisible — white image on white canvas background.
 
 **Solution:** Don't use page image fills for mockups. The correct architecture uses:
-
 1. **Transparent** page fill (`{ r: 0, g: 0, b: 0, a: 0 }`)
 2. **Scene-level mockup block** behind the page
 3. CE.SDK's gray canvas background provides contrast
@@ -199,11 +186,7 @@ engine.block.setSourceSet(fill, 'fill/image/sourceSet', [
 ]);
 
 // Avoid for production use
-engine.block.setString(
-  fill,
-  'fill/image/imageFileURI',
-  'https://example.com/image.png'
-);
+engine.block.setString(fill, 'fill/image/imageFileURI', 'https://example.com/image.png');
 ```
 
 The `Source` type from `@cesdk/engine` defines the shape: `{ uri: string; width: number; height: number }`.

package/assets/docs/guide/rules/content-fill-mode.md

@@ -16,11 +16,11 @@ engine.block.setEnum(block, 'contentFill/mode', 'Cover');
 
 ## Common Values
 
-| Value       | Behavior                                               |
-| ----------- | ------------------------------------------------------ |
+| Value | Behavior |
+|-------|----------|
 | `'Contain'` | Scale to fit within the block, preserving aspect ratio |
-| `'Cover'`   | Scale to fill the block, cropping as needed            |
-| `'Crop'`    | Manual crop region                                     |
+| `'Cover'` | Scale to fill the block, cropping as needed |
+| `'Crop'` | Manual crop region |
 
 ## Why This Is Confusing