@imgly/codesign-mcp 0.1.5 → 0.1.6

package/assets/docs/guide/open-the-editor/load-scene.md

@@ -1,4 +1,4 @@
-> 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:** [Guides](./guides.md) > [Open the Editor](./open-the-editor.md) > [Load a Scene](./open-the-editor/load-scene.md)
 
@@ -6,83 +6,84 @@
 
 Load previously saved scenes to resume editing or modify existing designs.
 
-![Load a Scene example showing a postcard design loaded in the editor](https://img.ly/docs/cesdk/./assets/browser.hero.webp)
-
 > **Reading time:** 5 minutes
 >
 > **Resources:**
 >
 > - [Download examples](https://github.com/imgly/cesdk-web-examples/archive/refs/tags/release-$UBQ_VERSION$.zip)
-> - [View source on GitHub](https://github.com/imgly/cesdk-web-examples/tree/release-$UBQ_VERSION$/guides-open-the-editor-load-scene-browser)
-> - [Open in StackBlitz](https://stackblitz.com/github/imgly/cesdk-web-examples/tree/v$UBQ_VERSION$/guides-open-the-editor-load-scene-browser)
-> - [Live demo](https://img.ly/docs/cesdk/examples/guides-open-the-editor-load-scene-browser/)
+>
+> - [View source on GitHub](https://github.com/imgly/cesdk-web-examples/tree/release-$UBQ_VERSION$/guides-open-the-editor-load-scene-server-js)
+>
+> - [Open in StackBlitz](https://stackblitz.com/github/imgly/cesdk-web-examples/tree/v$UBQ_VERSION$/guides-open-the-editor-load-scene-server-js)
 
 Scene files contain layout, properties, and asset references but not the assets themselves. When loading a scene, ensure referenced asset URLs remain accessible. For self-contained packages with bundled assets, use archives instead.
 
-```typescript file=@cesdk_web_examples/guides-open-the-editor-load-scene-browser/browser.ts reference-only
-import type { EditorPlugin, EditorPluginContext } from '@cesdk/cesdk-js';
-
-import {
-  BlurAssetSource,
-  ColorPaletteAssetSource,
-  CropPresetsAssetSource,
-  DemoAssetSources,
-  EffectsAssetSource,
-  FiltersAssetSource,
-  PagePresetsAssetSource,
-  StickerAssetSource,
-  TextAssetSource,
-  TextComponentAssetSource,
-  TypefaceAssetSource,
-  VectorShapeAssetSource
-} from '@cesdk/cesdk-js/plugins';
-import { DesignEditorConfig } from './design-editor/plugin';
-import packageJson from './package.json';
-
-class Example implements EditorPlugin {
-  name = packageJson.name;
-  version = packageJson.version;
-
-  async initialize({ cesdk }: EditorPluginContext): Promise<void> {
-    if (cesdk == null) {
-      throw new Error('CE.SDK instance is required for this plugin');
-    }
+```typescript file=@cesdk_web_examples/guides-open-the-editor-load-scene-server-js/server-js.ts reference-only
+import CreativeEngine from '@cesdk/node';
+import { writeFileSync, mkdirSync, existsSync } from 'fs';
+import { createInterface } from 'readline';
+import { config } from 'dotenv';
+
+// Load environment variables
+config();
+
+async function promptUser(question: string): Promise<boolean> {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+    });
+  });
+}
 
-    cesdk.addPlugin(new DesignEditorConfig());
-
-    cesdk.addPlugin(new ColorPaletteAssetSource());
-    cesdk.addPlugin(new CropPresetsAssetSource());
-    cesdk.addPlugin(new DemoAssetSources());
-    cesdk.addPlugin(new EffectsAssetSource());
-    cesdk.addPlugin(new FiltersAssetSource());
-    cesdk.addPlugin(new PagePresetsAssetSource());
-    cesdk.addPlugin(new StickerAssetSource());
-    cesdk.addPlugin(new TextAssetSource());
-    cesdk.addPlugin(new TextComponentAssetSource());
-    cesdk.addPlugin(new TypefaceAssetSource());
-    cesdk.addPlugin(new VectorShapeAssetSource());
-    cesdk.addPlugin(new BlurAssetSource());
-    cesdk.addPlugin(new DemoAssetSources());
-
-    const engine = cesdk.engine;
+async function main() {
+  const engine = await CreativeEngine.init({
+    baseURL: process.env.IMGLY_LOCAL_ASSETS_URL
+    // license: process.env.CESDK_LICENSE
+  });
+
+  try {
     const sceneUrl =
       'https://cdn.img.ly/assets/demo/v3/ly.img.template/templates/cesdk_postcard_1.scene';
     await engine.scene.loadFromURL(sceneUrl);
 
+    console.log('Scene loaded successfully from URL.');
+
     const textBlocks = engine.block.findByType('text');
     if (textBlocks.length > 0) {
       engine.block.setDropShadowEnabled(textBlocks[0], true);
+      console.log('Drop shadow added to text block.');
     }
 
-    // Zoom to fit the page in view
-    const pages = engine.block.findByType('page');
-    if (pages.length > 0) {
-      engine.scene.zoomToBlock(pages[0]);
+    const shouldExport = await promptUser('Export the scene to PNG? (y/n): ');
+    if (shouldExport) {
+      const outputDir = './output';
+      if (!existsSync(outputDir)) {
+        mkdirSync(outputDir, { recursive: true });
+      }
+
+      const pages = engine.block.findByType('page');
+      if (pages.length > 0) {
+        const blob = await engine.block.export(pages[0], {
+          mimeType: 'image/png'
+        });
+        const buffer = Buffer.from(await blob.arrayBuffer());
+        writeFileSync(`${outputDir}/scene-result.png`, buffer);
+        console.log('Exported scene to output/scene-result.png');
+      }
+    } else {
+      console.log('Export skipped.');
     }
+  } finally {
+    engine.dispose();
   }
 }
 
-export default Example;
+main().catch(console.error);
 ```
 
 This guide covers how to load scenes from URLs, strings, and blobs, and how to modify loaded scenes.
@@ -128,6 +129,7 @@ After loading, the scene is immediately editable. Use `engine.block.findByType()
 const textBlocks = engine.block.findByType('text');
 if (textBlocks.length > 0) {
   engine.block.setDropShadowEnabled(textBlocks[0], true);
+  console.log('Drop shadow added to text block.');
 }
 ```
 
@@ -158,21 +160,23 @@ Scene files (`.scene`) are lightweight and store only references to assets. If a
 
 ## API Reference
 
-| Method                                | Description                                |
-| ------------------------------------- | ------------------------------------------ |
-| `engine.scene.loadFromURL()`          | Load a scene from a remote URL             |
-| `engine.scene.loadFromString()`       | Load a scene from a string                 |
-| `engine.scene.loadFromArchiveURL()`   | Load an archived scene with bundled assets |
-| `engine.scene.saveToString()`         | Save scene to string for storage           |
-| `engine.block.findByType()`           | Find blocks by type                        |
-| `engine.block.findByKind()`           | Find blocks by kind                        |
-| `engine.block.setDropShadowEnabled()` | Enable or disable drop shadow on a block   |
+| Method | Description |
+| ------ | ----------- |
+| `engine.scene.loadFromURL()` | Load a scene from a remote URL |
+| `engine.scene.loadFromString()` | Load a scene from a string |
+| `engine.scene.loadFromArchiveURL()` | Load an archived scene with bundled assets |
+| `engine.scene.saveToString()` | Save scene to string for storage |
+| `engine.block.findByType()` | Find blocks by type |
+| `engine.block.findByKind()` | Find blocks by kind |
+| `engine.block.setDropShadowEnabled()` | Enable or disable drop shadow on a block |
+
+
 
 ---
 
 ## 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/open-the-editor/overview.md

@@ -1,4 +1,4 @@
-> 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:** [Guides](./guides.md) > [Open the Editor](./open-the-editor.md) > [Overview](./open-the-editor/overview.md)
 
@@ -10,11 +10,13 @@ CreativeEditor SDK (CE.SDK) offers multiple ways to open the editor. Whether you
 
 [Get Started](./get-started/overview.md)
 
+
+
 ---
 
 ## 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