@cesdk/node 1.67.0-nightly.20260105 → 1.67.0-nightly.20260107

package/index.d.ts

@@ -434,13 +434,13 @@ export declare class AssetAPI {
      * ```javascript
      * // Load all audio assets from IMG.LY's CDN
      * const sourceId = await engine.asset.addLocalAssetSourceFromJSONURI(
-     *   'https://cdn.img.ly/assets/demo/v2/ly.img.audio/content.json'
+     *   'https://cdn.img.ly/assets/demo/v3/ly.img.audio/content.json'
      * );
      * console.log('Loaded asset source:', sourceId); // "ly.img.audio"
      *
      * // Load only assets matching one of the patterns
      * const sourceId2 = await engine.asset.addLocalAssetSourceFromJSONURI(
-     *   'https://cdn.img.ly/assets/demo/v2/ly.img.image/content.json',
+     *   'https://cdn.img.ly/assets/demo/v3/ly.img.image/content.json',
      *   { matcher: ['image-portrait-*', 'image-landscape-*'] }
      * );
      * ```
@@ -1598,6 +1598,25 @@ export declare class BlockAPI {
      * ```
      */
     loadFromArchiveURL(url: string): Promise<DesignBlockId[]>;
+    /**
+     * Loads blocks from a URL.
+     *
+     * The URL should point to a blocks file within an unzipped archive directory previously saved with `block.saveToArchive`.
+     * The blocks are not attached by default and won't be visible until attached to a page or the scene.
+     * The UUID of the loaded blocks is replaced with a new one.
+     *
+     * @category Block Lifecycle
+     * @param url - The URL to the blocks file
+     * @returns A promise that resolves with a list of block handles
+     * @example
+     * ```typescript
+     * // Load blocks from a URL
+     * const loadedBlocks = await engine.block.loadFromURL('https://example.com/blocks.blocks');
+     * // Attach the first loaded block to the scene
+     * engine.block.appendChild(sceneBlockId, loadedBlocks[0]);
+     * ```
+     */
+    loadFromURL(url: string): Promise<DesignBlockId[]>;
     /**
      * Saves the given blocks to a serialized string.
      *
@@ -1655,7 +1674,7 @@ export declare class BlockAPI {
      * const video = engine.block.create('graphic');
      * engine.block.setShape(video, engine.block.createShape('rect'));
      * const videoFill = engine.block.createFill('video');
-     * engine.block.setString(videoFill, 'fill/video/fileURI', 'https://cdn.img.ly/assets/demo/v2/ly.img.video/videos/pexels-drone-footage-of-a-surfer-barrelling-a-wave-12715991.mp4');
+     * engine.block.setString(videoFill, 'fill/video/fileURI', 'https://cdn.img.ly/assets/demo/v3/ly.img.video/videos/pexels-drone-footage-of-a-surfer-barrelling-a-wave-12715991.mp4');
      * engine.block.setFill(video, videoFill);
      * engine.block.appendChild(page, video);
      * ```
@@ -8282,6 +8301,8 @@ export declare interface Settings {
     doubleClickToCropEnabled: boolean;
     /** Enable single page mode where only one page is shown at a time. */
     'features/singlePageModeEnabled': boolean;
+    /** Enable file system usage, that allows the engine to use the file system to store files for local uploads. */
+    'features/fileSystemUsageEnabled': boolean;
     /** Enable the page carousel for navigating between pages. */
     'features/pageCarouselEnabled': boolean;
     /** Whether transform edits should retain the cover mode of the content. */