@cesdk/engine 1.40.0 → 1.41.0-rc.0

package/index.d.ts

@@ -1037,12 +1037,13 @@ export declare class BlockAPI {
      */
     getHeightMode(id: DesignBlockId): SizeMode;
     /**
-     * Update a block's width.
+     * Update a block's width and optionally maintain the crop.
      * Required scope: 'layer/resize'
      * @param id - The block to update.
      * @param value - The new width of the block.
+     * @param maintainCrop - Whether or not the crop values, if available, should be automatically adjusted.
      */
-    setWidth(id: DesignBlockId, value: number): void;
+    setWidth(id: DesignBlockId, value: number, maintainCrop?: boolean): void;
     /**
      * Set a block's mode for its width.
      * Required scope: 'layer/resize'
@@ -1051,12 +1052,13 @@ export declare class BlockAPI {
      */
     setWidthMode(id: DesignBlockId, mode: SizeMode): void;
     /**
-     * Update a block's height.
+     * Update a block's height and optionally maintain the crop.
      * Required scope: 'layer/resize'
      * @param id - The block to update.
      * @param value - The new height of the block.
+     * @param maintainCrop - Whether or not the crop values, if available, should be automatically adjusted.
      */
-    setHeight(id: DesignBlockId, value: number): void;
+    setHeight(id: DesignBlockId, value: number, maintainCrop?: boolean): void;
     /**
      * Set a block's mode for its height.
      * Required scope: 'layer/resize'
@@ -1537,7 +1539,8 @@ export declare class BlockAPI {
     setCropTranslationY(id: DesignBlockId, translationY: number): void;
     /**
      * Resets the manually set crop of the given design block.
-     * The block's content fill mode is set to 'cover'.
+     * The block's content fill mode is set to 'Crop'.
+     * If the block has a fill, the crop values are updated so that it covers the block.
      * Required scope: 'layer/crop'
      * @param id - The block whose crop should be reset.
      */
@@ -4587,7 +4590,7 @@ export declare type SceneMode = 'Design' | 'Video';
 export declare type Scope = 'text/edit' | 'text/character' | 'fill/change' | 'fill/changeType' | 'stroke/change' | 'shape/change' | 'layer/move' | 'layer/resize' | 'layer/rotate' | 'layer/flip' | 'layer/crop' | 'layer/opacity' | 'layer/blendMode' | 'layer/visibility' | 'layer/clipping' | 'appearance/adjustments' | 'appearance/filter' | 'appearance/effect' | 'appearance/blur' | 'appearance/shadow' | 'appearance/animation' | 'lifecycle/destroy' | 'lifecycle/duplicate' | 'editor/add' | 'editor/select';
 
 /** @public */
-export declare type SettingsBool = 'controlGizmo/showCropHandles' | 'controlGizmo/showCropScaleHandles' | 'controlGizmo/showMoveHandles' | 'controlGizmo/showResizeHandles' | 'controlGizmo/showRotateHandles' | 'controlGizmo/showScaleHandles' | 'doubleClickToCropEnabled' | 'features/singlePageModeEnabled' | 'features/pageCarouselEnabled' | 'features/transformEditsRetainCoverMode' | 'mouse/enableScroll' | 'mouse/enableZoom' | 'page/allowCropInteraction' | 'page/allowMoveInteraction' | 'page/allowResizeInteraction' | 'page/allowRotateInteraction' | 'page/dimOutOfPageAreas' | 'page/restrictResizeInteractionToFixedAspectRatio' | 'page/title/appendPageName' | 'page/title/show' | 'page/title/showOnSinglePage' | 'page/title/showPageTitleTemplate' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'blockAnimations/enabled' | 'showBuildVersion' | 'touch/dragStartCanSelect' | 'touch/singlePointPanning';
+export declare type SettingsBool = 'controlGizmo/showCropHandles' | 'controlGizmo/showCropScaleHandles' | 'controlGizmo/showMoveHandles' | 'controlGizmo/showResizeHandles' | 'controlGizmo/showRotateHandles' | 'controlGizmo/showScaleHandles' | 'doubleClickToCropEnabled' | 'features/singlePageModeEnabled' | 'features/pageCarouselEnabled' | 'features/transformEditsRetainCoverMode' | 'mouse/enableScroll' | 'mouse/enableZoom' | 'page/allowCropInteraction' | 'page/allowMoveInteraction' | 'page/allowResizeInteraction' | 'page/allowRotateInteraction' | 'page/dimOutOfPageAreas' | 'page/restrictResizeInteractionToFixedAspectRatio' | 'page/moveChildrenWhenCroppingFill' | 'page/title/appendPageName' | 'page/title/show' | 'page/title/showOnSinglePage' | 'page/title/showPageTitleTemplate' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'blockAnimations/enabled' | 'showBuildVersion' | 'touch/dragStartCanSelect' | 'touch/singlePointPanning';
 
 /** @public
  */