@cesdk/node 1.19.0-rc.0 → 1.20.0-rc.0

package/index.d.ts

@@ -187,7 +187,7 @@ export declare interface AssetDefinition extends Asset {
 export declare type AssetGroups = string[];
 
 /**
- * AssetColor Meta information
+ * Generic asset information
  * @public
  */
 export declare type AssetMetaData = {
@@ -201,6 +201,7 @@ export declare type AssetMetaData = {
     uri?: string;
     thumbUri?: string;
     previewUri?: string;
+    sourceSet?: Source[];
     filename?: string;
     vectorPath?: string;
     width?: number;
@@ -216,6 +217,7 @@ export declare type AssetMetaData = {
  */
 export declare interface AssetPayload {
     color?: AssetColor;
+    sourceSet?: Source[];
 }
 
 /**
@@ -540,6 +542,25 @@ export declare class BlockAPI {
      * @param id - A block id.
      */
     exitGroup(id: DesignBlockId): void;
+    /**
+     * Checks whether blocks could be combined.
+     * Only graphics blocks and text blocks can be combined.
+     * All blocks must have the "lifecycle/duplicate" scope enabled.
+     * @param ids - An array of block ids.
+     * @returns Whether the blocks can be combined.
+     */
+    isCombinable(ids: DesignBlockId[]): boolean;
+    /**
+     * Perform a boolean operation on the given blocks.
+     * All blocks must be combinable. See `isCombinable`.
+     * The parent, fill and  sort order of the new block is that of the prioritized block.
+     * When performing a `Union`, `Intersection` or `XOR`, the operation is performed pair-wise starting with the element with the highest sort order.
+     * When performing a `Difference`, the operation is performed pair-wise starting with the element with the lowest sort order.
+     * @param ids - The blocks to combine. They will be destroyed if "lifecycle/destroy" scope is enabled.
+     * @param op - The boolean operation to perform.
+     * @returns The newly created block or an error.
+     */
+    combine(ids: DesignBlockId[], op: BooleanOperation): DesignBlockId;
     /**
      * Update a block's name.
      * @param id - The block to update.
@@ -1201,6 +1222,20 @@ export declare class BlockAPI {
      * @returns The gradient colors.
      */
     getGradientColorStops(id: DesignBlockId, property: string): GradientColorStop[];
+    /**
+     * Get the source set value of the given property.
+     * @param id - The block that should be queried.
+     * @param property - The name of the property to query.
+     * @returns The block's source set.
+     */
+    getSourceSet(id: DesignBlockId, property: string): Source[];
+    /**
+     * Set the property of the given block.
+     * @param id - The block whose property should be set.
+     * @param property - The name of the property to set.
+     * @param sourceSet - The block's new source set.
+     */
+    setSourceSet(id: DesignBlockId, property: string, sourceSet: Source[]): void;
     /**
      * Set an enum property of the given design block to the given value.
      * @param id - The block whose property should be set.
@@ -2295,6 +2330,13 @@ export declare type BlurTypeLonghand = `//ly.img.ubq/blur/${BlurTypeShorthand}`;
  */
 export declare type BlurTypeShorthand = 'uniform' | 'linear' | 'mirrored' | 'radial';
 
+/**
+ * Names of boolean operations.
+ *
+ * @public
+ */
+export declare type BooleanOperation = 'Difference' | 'Intersection' | 'Union' | 'XOR';
+
 /**
  * @public
  */
@@ -2599,6 +2641,10 @@ export declare interface Configuration {
      * The settings that were configured here can be set via the
      * following EditorAPI settings:
      * - `setSettingBool('page/title/show', show)`
+     * - `setSettingBool('page/title/showPageTitleTemplate', show)`
+     * - `setSettingBool('page/title/appendPageName', append)`
+     * - `setSettingBool('page/title/showOnSinglePage', hide)`
+     * - `setSettingString('page/title/separator', separator)`
      * - `setSettingString('page/title/fontFileUri', uri)`
      * - `setSettingBool('page/dimOutOfPageAreas', dim)`
      */
@@ -2879,6 +2925,8 @@ export declare class EditorAPI {
      * @throws An error, if the keypath is invalid.
      */
     setSettingBool(keypath: SettingsBool, value: boolean): void;
+    /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
+    setSettingBool(keypath: `ubq://${SettingsBool}`, value: boolean): void;
 
     /**
      * Get a boolean setting.
@@ -2886,6 +2934,8 @@ export declare class EditorAPI {
      * @throws An error, if the keypath is invalid.
      */
     getSettingBool(keypath: SettingsBool): boolean;
+    /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
+    getSettingBool(keypath: `ubq://${SettingsBool}`): boolean;
 
     /**
      * Set an integer setting.
@@ -2907,12 +2957,16 @@ export declare class EditorAPI {
      * @throws An error, if the keypath is invalid.
      */
     setSettingFloat(keypath: SettingsFloat, value: number): void;
+    /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
+    setSettingFloat(keypath: `ubq://${SettingsFloat}`, value: number): void;
     /**
      * Get a float setting.
      * @param keypath - The settings keypath, e.g. `positionSnappingThreshold`
      * @throws An error, if the keypath is invalid.
      */
     getSettingFloat(keypath: SettingsFloat): number;
+    /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
+    getSettingFloat(keypath: `ubq://${SettingsFloat}`): number;
     /**
      * Set a string setting.
      * @param keypath - The settings keypath, e.g. `license`
@@ -2920,24 +2974,32 @@ export declare class EditorAPI {
      * @throws An error, if the keypath is invalid.
      */
     setSettingString(keypath: SettingsString, value: string): void;
+    /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
+    setSettingString(keypath: `ubq://${SettingsString}`, value: string): void;
     /**
      * Get a string setting.
      * @param keypath - The settings keypath, e.g. `license`
      * @throws An error, if the keypath is invalid.
      */
     getSettingString(keypath: SettingsString): string;
+    /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
+    getSettingString(keypath: `ubq://${SettingsString}`): string;
     /**
      * Set a color setting.
      * @param keypath - The settings keypath, e.g. `highlightColor`.
      * @param value - The The value to set.
      */
     setSettingColor(keypath: SettingsColor, value: Color): void;
+    /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
+    setSettingColor(keypath: `ubq://${SettingsColor}`, value: Color): void;
     /**
      * Get a color setting.
      * @param keypath - The settings keypath, e.g. `highlightColor`.
      * @throws An error, if the keypath is invalid.
      */
     getSettingColor(keypath: SettingsColor): Color;
+    /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
+    getSettingColor(keypath: `ubq://${SettingsColor}`): Color;
     /**
      * Set a color setting.
      * @param keypath - The settings keypath, e.g. `highlightColor`.
@@ -2947,32 +3009,38 @@ export declare class EditorAPI {
      * @param a - The alpha color component in the range of 0 to 1.
      * @deprecated Use setSettingColor() instead.
      */
-    setSettingColorRGBA(keypath: SettingsColorRGBA, r: number, g: number, b: number, a?: number): void;
+    setSettingColorRGBA(keypath: SettingsColorRGBA | `ubq://${SettingsColorRGBA}`, r: number, g: number, b: number, a?: number): void;
     /**
      * Get a color setting.
      * @param keypath - The settings keypath, e.g. `highlightColor`.
      * @returns A tuple of channels red, green, blue and alpha in the range of 0 to 1.
      * @deprecated Use getSettingColor() instead.
      */
-    getSettingColorRGBA(keypath: SettingsColorRGBA): RGBA;
+    getSettingColorRGBA(keypath: SettingsColorRGBA | `ubq://${SettingsColorRGBA}`): RGBA;
     /**
      * Set an enum setting.
      * @param keypath - The settings keypath, e.g. `role`.
      * @param value - The enum value as string.
      */
     setSettingEnum<T extends keyof SettingsEnum>(keypath: T, value: SettingsEnum[T]): void;
+    /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
+    setSettingEnum<T extends keyof SettingsEnum>(keypath: `ubq://${T}`, value: SettingsEnum[T]): void;
     /**
      * Get an enum setting.
      * @param keypath - The settings keypath, e.g. `role`.
      * @returns The value as string.
      */
     getSettingEnum<T extends keyof SettingsEnum>(keypath: T): SettingsEnum[T];
+    /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
+    getSettingEnum<T extends keyof SettingsEnum>(keypath: `ubq://${T}`): SettingsEnum[T];
     /**
      * Get the possible enum options for a given enum setting.
      * @param keypath - The settings keypath, e.g. `role`.
      * @returns The possible enum options as strings.
      */
     getSettingEnumOptions<T extends keyof SettingsEnum>(keypath: T): string[];
+    /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
+    getSettingEnumOptions<T extends keyof SettingsEnum>(keypath: `ubq://${T}`): string[];
     /**
      * Returns a list of all the settings available.
      * @returns A list of settings keypaths.
@@ -3376,7 +3444,7 @@ export declare type PaletteColor = HexColorString | RGBColor | RGBAColor | SpotC
 export declare type PositionMode = 'Absolute' | 'Percent' | 'Auto';
 
 /** @public */
-export declare type PropertyType = 'Bool' | 'Int' | 'Float' | 'String' | 'Color' | 'Enum' | 'Struct' | 'Double';
+export declare type PropertyType = 'Bool' | 'Int' | 'Float' | 'String' | 'Color' | 'Enum' | 'Struct' | 'Double' | 'SourceSet';
 
 /**
  * An open range.
@@ -3698,7 +3766,7 @@ export declare type SceneLayout = 'Free' | 'VerticalStack' | 'HorizontalStack' |
 export declare type SceneMode = 'Design' | 'Video';
 
 /** @public */
-export declare type SettingsBool = 'doubleClickToCropEnabled' | 'features/effectsEnabled' | 'features/hspSelectiveAdjustmentsEnabled' | 'features/layerListEnabled' | 'features/singlePageModeEnabled' | 'features/templatingEnabled' | 'mouse/enableZoom' | 'mouse/enableScroll' | 'page/dimOutOfPageAreas' | 'page/title/show' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'showBuildVersion' | 'touch/dragStartCanSelect' | 'touch/singlePointPanning';
+export declare type SettingsBool = 'doubleClickToCropEnabled' | 'features/singlePageModeEnabled' | 'mouse/enableZoom' | 'mouse/enableScroll' | 'page/dimOutOfPageAreas' | 'page/title/show' | 'page/title/showPageTitleTemplate' | 'page/title/appendPageName' | 'page/title/showOnSinglePage' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'showBuildVersion' | 'touch/dragStartCanSelect' | 'touch/singlePointPanning';
 
 /** @public
  */
@@ -3721,7 +3789,7 @@ export declare type SettingsEnum = {
 export declare type SettingsFloat = 'positionSnappingThreshold';
 
 /** @public */
-export declare type SettingsString = 'basePath' | 'license' | 'page/title/fontFileUri' | 'defaultEmojiFontFileUri';
+export declare type SettingsString = 'basePath' | 'license' | 'page/title/separator' | 'page/title/fontFileUri' | 'defaultEmojiFontFileUri';
 
 /** @public */
 export declare type SettingType = 'Bool' | 'Int' | 'Float' | 'String' | 'Color' | 'Enum';
@@ -3762,6 +3830,16 @@ export declare interface Size2 {
  */
 export declare type SizeMode = 'Absolute' | 'Percent' | 'Auto';
 
+/**
+ * A single source width an intrinsic width & height.
+ * @public
+ */
+export declare interface Source {
+    uri: string;
+    width: number;
+    height: number;
+}
+
 /** @public */
 export declare interface SpotColor {
     name: string;