@cesdk/node 1.19.0 → 1.20.0-rc.1

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)`
      */
@@ -2979,6 +3025,7 @@ export declare class EditorAPI {
     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`.
@@ -2987,6 +3034,7 @@ export declare class EditorAPI {
     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`.
@@ -3398,7 +3446,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.
@@ -3720,11 +3768,11 @@ export declare type SceneLayout = 'Free' | 'VerticalStack' | 'HorizontalStack' |
 export declare type SceneMode = 'Design' | 'Video';
 
 /** @public */
-export declare type SettingsBool = 'doubleClickToCropEnabled' | 'features/singlePageModeEnabled' | 'mouse/enableZoom' | 'mouse/enableScroll' | 'page/dimOutOfPageAreas' | 'page/title/show' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'showBuildVersion' | 'touch/dragStartCanSelect' | 'touch/singlePointPanning';
+export declare type SettingsBool = 'controlGizmo/showCropHandles' | 'controlGizmo/showCropScaleHandles' | 'controlGizmo/showResizeHandles' | 'controlGizmo/showRotateHandles' | 'controlGizmo/showScaleHandles' | 'doubleClickToCropEnabled' | 'features/singlePageModeEnabled' | 'mouse/enableScroll' | 'mouse/enableZoom' | 'page/dimOutOfPageAreas' | 'page/title/appendPageName' | 'page/title/show' | 'page/title/showOnSinglePage' | 'page/title/showPageTitleTemplate' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'showBuildVersion' | 'touch/dragStartCanSelect' | 'touch/singlePointPanning';
 
 /** @public
  */
-declare type SettingsColor = 'clearColor' | 'errorStateColor' | 'highlightColor' | 'page/title/color' | 'placeholderHighlightColor' | 'progressColor';
+declare type SettingsColor = 'borderOutlineColor' | 'clearColor' | 'colorMaskingSettings/maskColor' | 'cropOverlayColor' | 'errorStateColor' | 'highlightColor' | 'page/innerBorderColor' | 'page/marginFillColor' | 'page/marginFrameColor' | 'page/outerBorderColor' | 'page/title/color' | 'placeholderHighlightColor' | 'progressColor' | 'rotationSnappingGuideColor' | 'snappingGuideColor' | 'textVariableHighlightColor';
 
 /** @public
  * @deprecated Use SettingsColor instead.
@@ -3740,10 +3788,10 @@ export declare type SettingsEnum = {
 };
 
 /** @public */
-export declare type SettingsFloat = 'positionSnappingThreshold';
+export declare type SettingsFloat = 'positionSnappingThreshold' | 'rotationSnappingThreshold';
 
 /** @public */
-export declare type SettingsString = 'basePath' | 'license' | 'page/title/fontFileUri' | 'defaultEmojiFontFileUri';
+export declare type SettingsString = 'basePath' | 'defaultEmojiFontFileUri' | 'license' | 'page/title/fontFileUri' | 'page/title/separator';
 
 /** @public */
 export declare type SettingType = 'Bool' | 'Int' | 'Float' | 'String' | 'Color' | 'Enum';
@@ -3784,6 +3832,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;