@imgly/codesign-mcp 0.1.5 → 0.1.6

package/assets/docs/guide/rules/silent-init-errors.md

@@ -10,6 +10,7 @@ During development, wrap sections of the `init` callback in `try/catch` with `co
 import { DesignEditorConfig } from './config/plugin';
 import {
   BlurAssetSource,
+  ImageColorsAssetSource,
   ColorPaletteAssetSource,
   CropPresetsAssetSource,
   DemoAssetSources,
@@ -32,6 +33,7 @@ import {
 
       // Add 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());
@@ -73,7 +75,7 @@ import {
       console.error('[CE.SDK init] Failed:', error);
     }
   }}
-/>;
+/>
 ```
 
 ## Symptoms of Silent Init Failure
@@ -96,6 +98,7 @@ init={async (cesdk) => {
 
     // 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());

package/assets/docs/guide/rules/verify-properties-before-use.md

@@ -23,12 +23,7 @@ if (props.includes('animationEasing')) {
 ## Pattern: Safe Property Access
 
 ```ts
-function safeSetEnum(
-  engine: CreativeEngine,
-  block: number,
-  prop: string,
-  value: string
-): boolean {
+function safeSetEnum(engine: CreativeEngine, block: number, prop: string, value: string): boolean {
   const props = engine.block.findAllProperties(block);
   if (props.includes(prop)) {
     engine.block.setEnum(block, prop, value);
@@ -37,11 +32,7 @@ function safeSetEnum(
   return false;
 }
 
-function safeGetFloat(
-  engine: CreativeEngine,
-  block: number,
-  prop: string
-): number | undefined {
+function safeGetFloat(engine: CreativeEngine, block: number, prop: string): number | undefined {
   const props = engine.block.findAllProperties(block);
   if (props.includes(prop)) {
     return engine.block.getFloat(block, prop);

package/assets/docs/guide/rules.md

@@ -1,9 +1,13 @@
-> 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) > [Rules](./rules.md)
 
 ---
 
+
+
+
+
 ---
 
 ## Related Pages
@@ -11,13 +15,14 @@
 - [Overview](./rules/overview.md) - Define and enforce layout, branding, and safety rules to ensure consistent and compliant designs.
 - [Enforce Brand Guidelines](./rules/enforce-brand-guidelines.md) - Learn how to restrict users to approved brand assets and prevent unauthorized modifications to brand elements
 - [Lock Content](./rules/lock-content.md) - Lock design elements to prevent unwanted modifications using CE.SDK's scope-based permission system.
-- [Moderate Content](./rules/moderate-content.md) - Extract images and text from CE.SDK designs using engine APIs and integrate with third-party moderation services to detect inappropriate content
+- [Moderate Content](./rules/moderate-content.md) - Extract images and text from CE.SDK designs using engine APIs in Node.js and integrate with third-party moderation services to detect inappropriate content
+
 
 ---
 
 ## 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/security.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:** [Compatibility & Security](./compatibility.md) > [Security](./security.md)
 
@@ -135,7 +135,7 @@ No. CE.SDK processes all content locally on the user's device. Your images, desi
 
 ### What data does IMG.LY collect through CE.SDK?
 
-CE.SDK only collects device identifiers (such as identifierForVendor on iOS or ANDROID_ID on Android) for licensing purposes and export counts. No user content or personal information is collected.
+CE.SDK only collects device identifiers (such as identifierForVendor on iOS or ANDROID\_ID on Android) for licensing purposes and export counts. No user content or personal information is collected.
 
 ### How does IMG.LY protect API keys?
 
@@ -189,11 +189,13 @@ The only PII that is potentially collected includes device-specific identifiers
 As mentioned above, user consent is not required when solely using the CE.SDK. However, this may change depending on the specific enterprise agreement or additional regulatory requirements.
 IMG.LY is committed to maintaining compliance with **GDPR** and other applicable data protection laws, ensuring your privacy is respected at all times. For details consult our [privacy policy](https://img.ly/privacy-policy).
 
+
+
 ---
 
 ## 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/serve-assets.md

@@ -1,332 +1,105 @@
-> 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) > [Serve Assets](./serve-assets.md)
 
 ---
 
-Configure CE.SDK to load engine and content assets from your own servers
-instead of the IMG.LY CDN for production deployments.
+Configure CE.SDK to load engine assets from your own servers or local filesystem for server-side deployments.
 
-Self-hosting assets is required for production use. The IMG.LY CDN is intended for development and prototyping only—you'll see a console warning when using the default CDN configuration. Hosting assets yourself gives you control over performance, availability, and compliance requirements.
+The `@cesdk/node` package bundles the core WASM engine files directly. No additional setup is required to initialize the engine and use its APIs.
 
-[Download Assets (v$UBQ\_VERSION$)](https://cdn.img.ly/packages/imgly/cesdk-js/$UBQ_VERSION$/imgly-assets.zip)
+For rendering-only workflows (loading existing scenes and exporting to PDF, PNG, or video), the engine loads scene-referenced assets directly from their embedded URLs. You only need to configure asset paths if you want to self-host font fallback files or emoji assets.
 
-This guide covers the asset categories CE.SDK uses, how to configure `baseURL` and asset source paths, and how to automate asset updates during SDK upgrades.
+[Download Assets (v$UBQ\_VERSION$)](https://cdn.img.ly/packages/imgly/cesdk-node/$UBQ_VERSION$/imgly-assets.zip)
 
-## Quick Start
+## Understanding Asset Categories
 
-Download and extract the essential assets for your SDK version:
+The `imgly-assets.zip` contains directories organized by function:
 
-```bash
-# Download assets for current SDK version
-curl -O https://cdn.img.ly/packages/imgly/cesdk-js/$UBQ_VERSION$/imgly-assets.zip
+| Directory                       | Contents                        | Bundled in npm? | When Needed                         |
+| ------------------------------- | ------------------------------- | --------------- | ----------------------------------- |
+| `core/`                         | WASM engine files               | **Yes**         | Always (bundled)                    |
+| `i18n/`                         | Translations                    | **Yes**         | Always (bundled)                    |
+| `emoji/`                        | Emoji assets                    | No              | If rendering emojis                 |
+| `fonts/`                        | System fonts                    | No              | If using system fonts               |
 
-# Create versioned directory and extract assets
-mkdir -p public/cesdk/$UBQ_VERSION$
-unzip imgly-assets.zip -d public/cesdk/$UBQ_VERSION$/
-rm imgly-assets.zip
-```
-
-Then configure CE.SDK to use your self-hosted assets:
-
-```javascript
-import CreativeEditorSDK from '@cesdk/cesdk-js';
-import {
-  BlurAssetSource,
-  ColorPaletteAssetSource,
-  CropPresetsAssetSource,
-  DemoAssetSources,
-  EffectsAssetSource,
-  FiltersAssetSource,
-  PagePresetsAssetSource,
-  StickerAssetSource,
-  TextAssetSource,
-  TextComponentAssetSource,
-  TypefaceAssetSource,
-  UploadAssetSources,
-  VectorShapeAssetSource
-} from '@cesdk/cesdk-js/plugins';
-
-const config = {
-  license: 'YOUR_CESDK_LICENSE_KEY',
-  baseURL: `https://cdn.yourdomain.com/cesdk/${CreativeEditorSDK.version}/`
-};
-
-CreativeEditorSDK.create(container, config).then(async (cesdk) => {
-  const assetBaseURL = `https://cdn.yourdomain.com/cesdk/${CreativeEditorSDK.version}/`;
-
-  // Add default asset source plugins
-  await cesdk.addPlugin(new BlurAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(new ColorPaletteAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(new CropPresetsAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(new EffectsAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(new FiltersAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(new PagePresetsAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(new StickerAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(new TextAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(
-    new TextComponentAssetSource({ baseURL: assetBaseURL })
-  );
-  await cesdk.addPlugin(new TypefaceAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(new VectorShapeAssetSource({ baseURL: assetBaseURL }));
-
-  // Add demo and upload sources
-  await cesdk.addPlugin(
-    new UploadAssetSources({ include: ['ly.img.image.upload'] })
-  );
-  await cesdk.addPlugin(
-    new DemoAssetSources({
-      include: [
-        'ly.img.templates.blank.*',
-        'ly.img.templates.presentation.*',
-        'ly.img.templates.print.*',
-        'ly.img.templates.social.*',
-        'ly.img.image.*'
-      ]
-    })
-  );
-});
-```
-
-> **Note:** **Versioned paths recommended**: Using version-specific paths like
-> `/cesdk/${CreativeEditorSDK.version}/` allows you to run multiple SDK versions in parallel,
-> simplifies rollbacks, and ensures clean cache invalidation during upgrades.
-
-## Understanding CE.SDK Assets
-
-CE.SDK assets are distributed in an `imgly-assets.zip` file available for download from the IMG.LY CDN. Understanding what's in this archive helps you decide which assets to host and how to keep them updated.
-
-### Asset Categories
-
-The ZIP file contains directories organized by function:
-
-| Directory                    | Contents                                               | Version-Locked? | Required?               |
-| ---------------------------- | ------------------------------------------------------ | --------------- | ----------------------- |
-| `core/`                      | WASM engine files (`.wasm`, `.data`, `worker-host.js`) | **Yes**         | **Yes**                 |
-| `ui/`                        | UI resources (audio waveform, fonts, stylesheets)      | **Yes**         | **Yes**                 |
-| `emoji/`                     | Emoji assets                                           | **Yes**         | **Yes**                 |
-| `fonts/`                     | System fonts                                           | **Yes**         | **Yes**                 |
-| `i18n/`                      | Translations                                           | **Yes**         | No (bundled in SDK)     |
-| `ly.img.sticker/`            | Stickers                                               | No              | If using default assets |
-| `ly.img.sticker.misc/`       | Additional stickers                                    | No              | If using default assets |
-| `ly.img.vector.shape/`       | Shapes and arrows                                      | No              | If using default assets |
-| `ly.img.typeface/`           | Font definitions                                       | No              | If using default assets |
-| `ly.img.filter/`             | Filter effects (LUT and duotone)                       | No              | If using default assets |
-| `ly.img.effect/`             | Visual effects                                         | No              | If using default assets |
-| `ly.img.blur/`               | Blur presets                                           | No              | If using default assets |
-| `ly.img.color.palette/`      | Color palettes                                         | No              | If using default assets |
-| `ly.img.crop.presets/`       | Crop aspect ratios                                     | No              | If using default assets |
-| `ly.img.page.presets/`       | Page format presets                                    | No              | If using default assets |
-| `ly.img.page.presets.video/` | Video page presets                                     | No              | If using default assets |
-| `ly.img.caption.presets/`    | Caption formatting presets                             | No              | If using default assets |
-| `ly.img.text.components/`    | Text components                                        | No              | If using default assets |
-| `ly.img.animation/`          | Animation presets                                      | No              | If using default assets |
-| `ly.img.animation.text/`     | Text animation presets                                 | No              | If using default assets |
-| `ly.img.image/`              | Sample images (demo content)                           | No              | No                      |
-| `ly.img.video/`              | Sample videos (demo content)                           | No              | No                      |
-| `ly.img.audio/`              | Sample audio (demo content)                            | No              | No                      |
-| `ly.img.template/`           | Design templates (demo content)                        | No              | No                      |
-| `ly.img.video.template/`     | Video templates (demo content)                         | No              | No                      |
-
-For most integrations, you need `core/`, `ui/`, `emoji/`, `fonts/`, and the `ly.img.*` asset sources you use.
-
-### Version-Locked vs. Independent Assets
-
-**Version-locked assets** (`core/`, `ui/`, `i18n/`) must match your SDK version. Mismatched versions cause load errors—the engine will fail to initialize if core files don't match.
-
-**Independent assets** (`ly.img.*` directories) can be updated separately. Configure these via asset source plugins (imported from `@cesdk/cesdk-js/plugins`), each of which accepts a `baseURL` option. Check the changelog when upgrading to see if asset versions have changed.
-
-### Default Asset Sources
-
-Adding the default asset source plugins registers these asset sources:
-
-- `ly.img.sticker` - Stickers
-- `ly.img.sticker.misc` - Additional stickers
-- `ly.img.vector.shape` - Shapes and arrows
-- `ly.img.typeface` - Font definitions
-- `ly.img.color.palette` - Color palettes
-- `ly.img.filter` - Filter effects
-- `ly.img.effect` - Visual effects
-- `ly.img.blur` - Blur presets
-- `ly.img.crop.presets` - Crop aspect ratios
-- `ly.img.page.presets` - Page format presets
-- `ly.img.page.presets.video` - Video page presets
-- `ly.img.caption.presets` - Caption formatting
-- `ly.img.text.components` - Text components
-- `ly.img.animation` - Animation presets
-- `ly.img.animation.text` - Text animation presets
-
-### Demo Asset Sources
+> **Note:** Asset source directories (`ly.img.sticker/`, `ly.img.filter/`, etc.) are only used in browser builds. The server package does not use asset source plugins.
 
-Adding the `DemoAssetSources` and `UploadAssetSources` plugins registers sample content sources for development:
+## Engine-Level Assets
 
-- `ly.img.image` - Sample images
-- `ly.img.video` - Sample videos
-- `ly.img.audio` - Sample audio
-- `ly.img.template` - Design templates
-- `ly.img.video.template` - Video templates
-- `ly.img.image.upload`, `ly.img.video.upload`, `ly.img.audio.upload` - Upload sources
+The engine uses additional assets for font fallback (Unicode character coverage) and emoji rendering. By default, these are loaded from `https://cdn.img.ly/assets/v7`. When you configure the `basePath` setting for your engine, font fallback files and the emoji font are automatically loaded from that location:
 
-These are intended for development and prototyping—replace them with your own content in production.
+- **Font fallback files** — Used when text contains characters not covered by the selected font. Located at `{basePath}/fonts/font-{index}.ttf`.
+- **Emoji font** — The default emoji font (NotoColorEmoji.ttf). Located at `{basePath}/emoji/NotoColorEmoji.ttf`.
 
-## Configuration Options
+The `fonts/` and `emoji/` directories are already included in the `imgly-assets.zip` download. When you set up self-hosted assets and configure `basePath`, ensure these directories are present at your `basePath` location.
 
-Browser configuration involves three settings: `baseURL`, `core.baseURL`, and the `baseURL` option for asset sources.
+## Self-Hosting Assets
 
-### Editor Configuration
+### Using Local Filesystem
 
-Pass configuration to `CreativeEditorSDK.create()`:
+Use Node.js `pathToFileURL()` to load assets directly from disk:
 
 ```javascript
-import CreativeEditorSDK from '@cesdk/cesdk-js';
+import CreativeEngine from '@cesdk/node';
+import path from 'path';
+import { pathToFileURL } from 'url';
 
-const config = {
-  baseURL: `https://cdn.yourdomain.com/cesdk/${CreativeEditorSDK.version}/`,
-  core: {
-    baseURL: 'core/'
-  }
-};
-
-CreativeEditorSDK.create(container, config).then((cesdk) => {
-  // Editor initialized with self-hosted assets
+const engine = await CreativeEngine.init({
+  license: 'YOUR_CESDK_LICENSE_KEY',
+  baseURL: pathToFileURL(path.resolve(`./cesdk-assets/${CreativeEngine.version}`)).href + '/'
 });
-```
-
-**`baseURL`** — Base path for all engine assets. Can be an absolute URL or a relative path. Relative paths resolve against `window.location.href`. Defaults to the IMG.LY CDN.
-
-**`core.baseURL`** — Path to WASM files. Defaults to `core/` relative to `baseURL`. Usually you don't need to change this unless hosting WASM files separately.
-
-### Asset Sources Configuration
 
-Configure asset sources after initializing the editor by adding individual asset source plugins:
+// Use the engine for processing
+// ...
 
-```javascript
-import {
-  BlurAssetSource,
-  ColorPaletteAssetSource,
-  CropPresetsAssetSource,
-  DemoAssetSources,
-  EffectsAssetSource,
-  FiltersAssetSource,
-  PagePresetsAssetSource,
-  StickerAssetSource,
-  TextAssetSource,
-  TextComponentAssetSource,
-  TypefaceAssetSource,
-  UploadAssetSources,
-  VectorShapeAssetSource
-} from '@cesdk/cesdk-js/plugins';
-
-CreativeEditorSDK.create(container, config).then(async (cesdk) => {
-  const assetBaseURL = `https://cdn.yourdomain.com/cesdk/${CreativeEditorSDK.version}/`;
-
-  // Point default assets to your server
-  await cesdk.addPlugin(new BlurAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(new ColorPaletteAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(new CropPresetsAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(new EffectsAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(new FiltersAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(new PagePresetsAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(new StickerAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(new TextAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(
-    new TextComponentAssetSource({ baseURL: assetBaseURL })
-  );
-  await cesdk.addPlugin(new TypefaceAssetSource({ baseURL: assetBaseURL }));
-  await cesdk.addPlugin(new VectorShapeAssetSource({ baseURL: assetBaseURL }));
-
-  // Optional: Add demo assets for development
-  await cesdk.addPlugin(
-    new UploadAssetSources({ include: ['ly.img.image.upload'] })
-  );
-  await cesdk.addPlugin(
-    new DemoAssetSources({
-      baseURL: assetBaseURL,
-      include: [
-        'ly.img.templates.blank.*',
-        'ly.img.templates.presentation.*',
-        'ly.img.templates.print.*',
-        'ly.img.templates.social.*',
-        'ly.img.image.*'
-      ]
-    })
-  );
-});
+// Clean up when done
+engine.dispose();
 ```
 
-The `baseURL` for asset sources must be an absolute URL. The engine looks up asset definitions at `{baseURL}/{sourceId}/content.json` and references files like `{baseURL}/{sourceId}/images/example.png`.
-
-### Engine-Level Assets
-
-The engine uses additional assets for font fallback (Unicode character coverage) and emoji rendering. When you configure `baseURL` for self-hosting, the engine automatically uses the same location for these assets:
-
-- **Font fallback files** — Used when text contains characters not covered by the selected font. Located at `{baseURL}/fonts/font-{index}.ttf`.
-- **Emoji font** — The default emoji font (NotoColorEmoji.ttf). Located at `{baseURL}/emoji/NotoColorEmoji.ttf`.
+The `file://` protocol loads assets directly from the filesystem without network overhead.
 
-The `fonts/` and `emoji/` directories are already included in the `imgly-assets.zip` download, so no additional configuration is needed when self-hosting—just ensure these directories are present at your `baseURL` location.
+### Using Your Own CDN
 
-> **Note:** **Troubleshooting**: If you see 404 errors for font files when self-hosting, verify that the
-> `fonts/` and `emoji/` directories from `imgly-assets.zip` are properly extracted at your
-> `baseURL` location.
-
-## Excluding Unused Asset Sources
-
-If you only need a subset of default assets, simply omit the plugins you don't need. For example, to skip stickers and video page presets, add all plugins except `StickerAssetSource` and the video page presets:
+If you prefer serving assets from your own CDN:
 
 ```javascript
-// Only add the plugins you need
-await cesdk.addPlugin(new BlurAssetSource());
-await cesdk.addPlugin(new ColorPaletteAssetSource());
-await cesdk.addPlugin(new CropPresetsAssetSource());
-await cesdk.addPlugin(new EffectsAssetSource());
-await cesdk.addPlugin(new FiltersAssetSource());
-await cesdk.addPlugin(new PagePresetsAssetSource());
-// StickerAssetSource omitted
-await cesdk.addPlugin(new TextAssetSource());
-await cesdk.addPlugin(new TextComponentAssetSource());
-await cesdk.addPlugin(new TypefaceAssetSource());
-await cesdk.addPlugin(new VectorShapeAssetSource());
-```
+import CreativeEngine from '@cesdk/node';
 
-This reduces initial load time by not fetching unused asset definitions.
+const engine = await CreativeEngine.init({
+  license: 'YOUR_CESDK_LICENSE_KEY',
+  baseURL: `https://cdn.yourdomain.com/cesdk/${CreativeEngine.version}/`
+});
+```
 
 ## Troubleshooting
 
-### WASM Load Errors
-
-If the engine fails to initialize with missing `.wasm` or `.data` errors, verify:
-
-1. The assets ZIP version matches your SDK version
-2. The `core.baseURL` points to the correct directory
-3. Your server returns correct MIME types for `.wasm` files (`application/wasm`)
+### File URL Formatting
 
-### 404 Errors for Assets
+When using `file://` URLs:
 
-If the console shows 404 errors for `content.json` files:
+- Use `path.resolve()` to get absolute paths
+- URLs must end with a trailing slash for directories
+- Always use `pathToFileURL()` from the `url` module instead of string concatenation
 
-1. Verify the `baseURL` passed to your asset source plugins is correct
-2. Check that asset directories exist at the expected paths
-3. Configure CORS headers if serving assets from a different domain
+> **Caution:** **License validation requires network access**: The engine validates your license key against `api.img.ly` during initialization. Ensure your server environment allows outbound HTTPS connections to this endpoint.
 
-### CDN Warning in Console
+## API Reference
 
-The warning "You're using the IMG.LY CDN" appears when using default configuration. Set `baseURL` in your config to use self-hosted assets and remove the warning.
+| Method/Config | Purpose |
+|--------------|---------|
+| `CreativeEngine.init(config)` | Initialize engine with configuration |
+| `engine.editor.setSettingString('basePath', url)` | Set base path for resolving relative paths and loading font/emoji assets |
+| `CreativeEngine.version` | Get current SDK version string |
+| `pathToFileURL(path)` | Convert filesystem path to `file://` URL (Node.js `url` module) |
 
-## API Reference
 
-| Method/Config                                 | Purpose                                                     |
-| --------------------------------------------- | ----------------------------------------------------------- |
-| `CreativeEditorSDK.create(container, config)` | Initialize editor with configuration                        |
-| `config.baseURL`                              | Base path for all engine assets (including fonts and emoji) |
-| `config.core.baseURL`                         | Path to WASM/core files (relative to baseURL)               |
-| `cesdk.addPlugin(new XyzAssetSource())`       | Add individual asset source plugins                         |
-| `CreativeEditorSDK.version`                   | Get current SDK version string                              |
 
 ---
 
 ## 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