@cesdk/node 1.11.0-preview.0 → 1.11.0-preview.2

package/example.js

@@ -5,7 +5,8 @@ const CreativeEngine = require('./index.js');
 
 const { DesignBlockType, MimeType } = CreativeEngine;
 
-CreativeEngine.init().then((engine) => {
+CreativeEngine.init().then(async (engine) => {
+  await engine.addDefaultAssetSources();
   console.log('Loading scene');
   engine.scene
     .loadFromURL(`file://${__dirname}/demo.scene`)

package/index.d.ts

@@ -901,6 +901,24 @@ export declare class BlockAPI {
      * @returns The position and size of the bounding box.
      */
     getScreenSpaceBoundingBoxXYWH(ids: DesignBlockId[]): XYWH;
+    /**
+     * Align multiple blocks horizontally within their bounding box (or group) or a single block to its parent.
+     * @param ids - A non-empty array of block ids.
+     * @param alignment - How they should be aligned: left, right, or center
+     */
+    alignHorizontally(ids: DesignBlockId[], horizontalBlockAlignment: HorizontalBlockAlignment): void;
+    /**
+     * Align multiple blocks vertically within their bounding box (or group) or a single block to its parent.
+     * @param ids - A non-empty array of block ids.
+     * @param alignment - How they should be aligned: top, bottom, or center
+     */
+    alignVertically(ids: DesignBlockId[], verticalBlockAlignment: VerticalBlockAlignment): void;
+    /**
+     * Confirms that a given set of blocks can be aligned.
+     * @param ids - A non-empty array of block ids.
+     * @returns Whether the blocks can be aligned.
+     */
+    isAlignable(ids: DesignBlockId[]): boolean;
     /**
      * Scales the block and all of its children proportionally around the specified
      * relative anchor point.
@@ -2216,7 +2234,6 @@ export declare interface Configuration {
      */
     extensions: ConfigTypes.Extensions;
     core: ConfigTypes.Core;
-    scene: ConfigTypes.Scene;
     assetSources: ConfigTypes.AssetSources;
     presets: ConfigTypes.Presets;
     variables: ConfigTypes.Variables;
@@ -2289,9 +2306,60 @@ declare class CreativeEngine {
      * @returns An engine instance.
      */
     static init(config?: Partial<Configuration> & OldConfiguration): Promise<CreativeEngine>;
+    /**
+     * Convenience function that registers a set of asset sources containing our
+     * default assets. These are
+     *
+     * - `'ly.img.sticker'` - Various stickers
+     * - `'ly.img.vectorpath'` - Shapes and arrows
+     * - `'ly.img.filter.lut'` - LUT effects of various kinds.
+     * - `'ly.img.filter.duotone'` - LUT effects of various kinds.
+     *
+     * These assets are parsed from the IMG.LY CDN at \{\{base_url\}\}/<id>/content.json, where
+     * `base_url` defaults to 'https://cdn.img.ly/assets/v1'.
+     * Each source is created via `addLocalSource` and populated with the parsed assets. To modify the available
+     * assets, you may either exclude certain IDs via `excludeAssetSourceIds` or alter the sources after creation.
+     */
+    addDefaultAssetSources({ baseURL, excludeAssetSourceIds }?: {
+        /** The source of the asset definitions, must be absolute. Defaults to `'https://cdn.img.ly/assets/v1'`. */
+        baseURL?: string;
+        /** A list of IDs, that will be ignored during load. */
+        excludeAssetSourceIds?: DefaultAssetSourceId[];
+    }): Promise<void>;
+    /**
+     * Convenience function that registers a set of demo asset sources containing our
+     * example assets. These are not to meant to be used in your production code.
+     *
+     * These are
+     *
+     * - `'ly.img.image'` - Sample images
+     * - `'ly.img.image.upload'` - Demo source to upload image assets
+     * - `'ly.img.audio'` - Sample audios
+     * - `'ly.img.audio.upload'` - Demo source to upload audio assets
+     * - `'ly.img.video'` - Sample videos
+     * - `'ly.img.video.upload'` - Demo source to upload video assets
+     */
+    addDemoAssetSources({ excludeAssetSourceIds, sceneMode, withUploadAssetSources }?: {
+        /** A list of IDs, that will be ignored during load */
+        excludeAssetSourceIds?: DemoAssetSourceId[];
+        /** If 'Video' video specific demo asset sources will be loaded as well (default 'Design') */
+        sceneMode?: SceneMode;
+        /** If 'true' asset sources for uploads are added (default false) */
+        withUploadAssetSources?: boolean;
+    }): Promise<void>;
 }
 export default CreativeEngine;
 
+/**
+ * @public
+ */
+export declare type DefaultAssetSourceId = 'ly.img.sticker' | 'ly.img.vectorpath' | 'ly.img.filter.lut' | 'ly.img.filter.duotone';
+
+/**
+ * @public
+ */
+export declare type DemoAssetSourceId = 'ly.img.image.upload' | 'ly.img.video.upload' | 'ly.img.audio.upload' | 'ly.img.image' | 'ly.img.video' | 'ly.img.audio';
+
 /**
  * A numerical identifier for a design block
  * @public
@@ -2672,7 +2740,7 @@ declare type Extensions = {
 /**
  * @public
  */
-export declare type FillType = 'Solid' | 'Gradient' | 'Video';
+export declare type FillType = 'Solid' | 'Gradient' | 'Video' | 'Image';
 
 /** @public */
 declare interface FindAssetsQuery {
@@ -2742,6 +2810,15 @@ declare type HexColorString = string;
  */
 export declare type HistoryId = number;
 
+/**
+ * - Left: The blocks get left aligned.
+ * - Right: The blocks get right aligned.
+ * - Center: The blocks get center aligned.
+ *
+ * @public
+ */
+export declare type HorizontalBlockAlignment = 'Left' | 'Right' | 'Center';
+
 /**
  * e.g. `en`, `de`, etc.
  * @public
@@ -2764,6 +2841,7 @@ declare enum MimeType_2 {
     Jpeg = "image/jpeg",
     Tga = "image/x-tga",
     Mp4 = "video/mp4",
+    QuickTime = "video/quicktime",
     Binary = "application/octet-stream",
     Pdf = "application/pdf",
     Zip = "application/zip"
@@ -2791,6 +2869,13 @@ export declare interface OldConfiguration {
      * - `setSettingBool('page/title/dimOutOfPageAreas', dim)`
      */
     page?: Page;
+    /**
+     * @deprecated This type definition has been removed
+     * The settings that were configured here can be set via the
+     * BlockApi on the scene block
+     * @public
+     */
+    scene?: Scene;
 }
 
 /**
@@ -2921,23 +3006,26 @@ export declare interface RGBColor {
 export declare type RoleString = 'Creator' | 'Adopter' | 'Viewer' | 'Presenter';
 
 /**
- * Export Settings
+ * @deprecated This type definition is not used anymore and will be removed
+ * in the future. The settings that were configured here can be set via the
+ * BlockApi on the scene block:
+ *
+ * ```ts
+ * engine.block.setInt(sceneId, 'scene/dpi', dpi);
+ * engine.block.setInt(sceneId, 'scene/pixelScaleFactor', factor);
+ * ```
+ *
  * @public
  */
 declare type Scene = {
     /**
-     * The DPI value to use when exporting and when converting between pixels and inches or millimeter units.
-     * (In the CESDK, this value is synonymous with PPI).
-     *
-     * This is only relevant for new scenes that are created in the editor. Loaded scenes will use the
-     * value stored in their serialization file.
+     * @deprecated Setting this value has no effect. You can change the dpi of the
+     * current scene via `engine.block.setInt(sceneId, 'scene/dpi', dpi)`
      */
     dpi: number;
     /**
-     * A scale factor that is applied to the final export resolution.
-     *
-     * This is only relevant for new scenes that are created in the editor. Loaded scenes will use the
-     * value stored in their serialization file.
+     * @deprecated Setting this value has no effect. You can change the dpi of the
+     * current scene via `engine.block.setInt(sceneId, 'scene/pixelScaleFactor', * factor)`
      */
     pixelScaleFactor: number;
 };
@@ -3273,6 +3361,15 @@ export declare interface Vec4 {
     w: number;
 }
 
+/**
+ * - Top: The blocks get top aligned.
+ * - Bottom: The blocks get bottom aligned.
+ * - Center: The blocks get center aligned.
+ *
+ * @public
+ */
+export declare type VerticalBlockAlignment = 'Top' | 'Bottom' | 'Center';
+
 /**
  * @public
  */