@cesdk/engine 1.10.0-preview.1 → 1.11.0-preview.0

package/index.d.ts

@@ -1,5 +1,9 @@
 /// <reference types="offscreencanvas" />
 
+declare type ArbitraryString = string & {
+    arbitrary?: any;
+};
+
 /**
  * Generic asset information
  * @public
@@ -104,7 +108,6 @@ export declare class AssetAPI {
      * @param assetId - The id of the asset to be removed.
      */
     removeAssetFromSource(sourceId: string, assetId: string): void;
-
     /**
      * Apply an asset result to the active scene.
      * The default behavior will instantiate a block and configure it according to the asset's properties.
@@ -132,6 +135,18 @@ export declare class AssetAPI {
      * @param block - The block to apply the asset result to.
      */
     defaultApplyAssetToBlock(assetResult: AssetResult, block: DesignBlockId): Promise<void>;
+    /**
+     * Register a callback to be called every time an asset source is added.
+     * @param callback - The function that is called whenever an asset source is added.
+     * @returns A method to unsubscribe.
+     */
+    onAssetSourceAdded: (callback: (sourceID: string) => void) => (() => void);
+    /**
+     * Register a callback to be called every time an asset source is removed.
+     * @param callback - The function that is called whenever an asset source is added.
+     * @returns A method to unsubscribe.
+     */
+    onAssetSourceRemoved: (callback: (sourceID: string) => void) => (() => void);
 
 }
 
@@ -274,14 +289,6 @@ export declare interface AssetSource {
         name: string;
         url?: string;
     };
-    /**
-     * Indicates if the asset shall be downloaded to handle the raw data instead
-     * of an URL reference. Do this if you do not want to depend on
-     * a service after adding the asset to the scene. If this is your own API
-     * with your own service, you do not need to set this and avoid downloading /
-     * re-uploading the assets.
-     */
-    downloadAssets?: (asset: AssetResult) => Promise<Blob>;
     /**
      * @returns the asset or undefined if no asset with the given id could be found
      */
@@ -290,6 +297,8 @@ export declare interface AssetSource {
      * Can the source add and remove assets dynamically? If `false`
      * methods like `addAsset` and `removeAsset` will throw an
      * error.
+     *
+     * @deprecated Will be removed in v1.11. Use `canAdd` and `canRemove` in the asset library configuration
      */
     canManageAssets?: boolean;
     /**
@@ -304,9 +313,8 @@ export declare interface AssetSource {
      */
     applyAssetToBlock?: (asset: AssetResult, block: DesignBlockId) => Promise<void>;
     /**
-     * Adds the given asset to this source. Throws an error if `canManageAssets`
-     * is `false`.
-     *
+     * Adds the given asset to this source. Throws an error if the asset source
+     * does not support adding assets.
      */
     addAsset?(asset: AssetDefinition): void;
     /**
@@ -341,14 +349,6 @@ declare interface AssetSource_2 {
 
     /** Return every available group */
     getGroups?: () => Promise<string[]>;
-    /**
-     * Indicates if the asset shall be downloaded to handle the raw data instead
-     * of an URL reference. Do this if you do not want to depend on
-     * a service after adding the asset to the scene. If this is your own API
-     * with your own service, you do not need to set this and avoid downloading /
-     * re-uploading the assets.
-     */
-    downloadAssets?: (asset: AssetResult_2) => Promise<Blob>;
     /** Credits for the source/api */
     credits?: {
         name: string;
@@ -408,64 +408,6 @@ declare interface AssetsQueryResult_2 {
  */
 export declare type BlendMode = 'PassThrough' | 'Normal' | 'Darken' | 'Multiply' | 'ColorBurn' | 'Lighten' | 'Screen' | 'ColorDodge' | 'Overlay' | 'SoftLight' | 'HardLight' | 'Difference' | 'Exclusion' | 'Hue' | 'Saturation' | 'Color' | 'Luminosity';
 
-/**
- * Holds Channels for the different properties of a block.
- * Ensures that for each property, only one channel exists.
- * @public
- */
-export declare class Block extends Entity {
-    #private;
-    get type(): DesignBlockType;
-    effects: ReadWriteChannelSync<number[]>;
-    blur: ReadWriteChannelSync<number>;
-    isBlurEnabled: ReadWriteChannelSync<boolean>;
-    soloPlaybackEnabled: ReadWriteChannelSync<boolean>;
-    trimOffset: ReadWriteChannelSync<number>;
-    trimLength: ReadWriteChannelSync<number>;
-    playing: ReadWriteChannelSync<boolean>;
-    playbackTime: ReadWriteChannelSync<number>;
-    selection: ReadWriteChannelSync<boolean>;
-    duration: ReadWriteChannelSync<number>;
-    name: ReadWriteChannelSync<string>;
-    avResourceTotalDuration: ReadWriteChannelSync<number>;
-    timeOffset: ReadWriteChannelSync<number>;
-    cropTranslationX: ReadWriteChannelSync<number>;
-    cropTranslationY: ReadWriteChannelSync<number>;
-    cropTranslation: ReadWriteChannelSync<Vec2>;
-    cropScaleRatio: ReadWriteChannelSync<number>;
-    cropRotation: ReadWriteChannelSync<number>;
-    cropScaleX: ReadWriteChannelSync<number>;
-    cropScaleY: ReadWriteChannelSync<number>;
-    width: ReadWriteChannelSync<number>;
-    height: ReadWriteChannelSync<number>;
-    dimensions: ReadWriteChannelSync<Vec2>;
-    contentFillMode: ReadWriteChannelSync<ContentFillMode>;
-    blendMode: ReadWriteChannelSync<BlendMode>;
-    designStyleScope: ReadWriteChannelSync<boolean>;
-    designArrangeScope: ReadWriteChannelSync<boolean>;
-    designArrangeScopeMove: ReadWriteChannelSync<boolean>;
-    designArrangeScopeResize: ReadWriteChannelSync<boolean>;
-    designArrangeScopeRotate: ReadWriteChannelSync<boolean>;
-    designArrangeScopeFlip: ReadWriteChannelSync<boolean>;
-    contentReplaceScope: ReadWriteChannelSync<boolean>;
-    lifecycleDestroyScope: ReadWriteChannelSync<boolean>;
-    lifecycleDuplicateScope: ReadWriteChannelSync<boolean>;
-    editorAddScope: ReadWriteChannelSync<boolean>;
-    editorInspectScope: ReadWriteChannelSync<boolean>;
-    editorPresentScope: ReadWriteChannelSync<boolean>;
-    editorManagePagesScope: ReadWriteChannelSync<boolean>;
-    editorSelectScope: ReadWriteChannelSync<boolean>;
-    editorZoomScope: ReadWriteChannelSync<boolean>;
-    boundingBox: ReadOnlyChannelSync<{
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    }>;
-
-
-}
-
 /**
  * @public
  */
@@ -496,17 +438,13 @@ export declare class BlockAPI {
     /**
      * Exports a design block as a video file of the given mime type.
      * Note: The export will run across multiple iterations of the update loop. In each iteration a frame is scheduled for encoding.
-     * @param block - The design block to export.
-     * @param timeOffset - The time offset in seconds of the scene's timeline from which the video will start.
-     * @param duration - The duration in seconds of the final video.
+     * @param handle - The design block element to export. Currently, only the scene block is supported.
      * @param mimeType - The mime type of the output video file.
-     * @param resolutionWidth - The target video width in pixel.
-     * @param resolutionHeight - The target video height in pixel.
-     * @param framerate - The target framerate in Hz.
      * @param progressCallback - A callback which reports on the progress of the export. It informs the receiver of the current frame index, which currently gets exported and the total frame count.
+     * @param options - The options for exporting the video
      * @returns A promise that resolves with video blob or is rejected with an error.
      */
-    exportVideo(handle: DesignBlockId, timeOffset: number, duration: number, mimeType: MimeType_2 | undefined, resolutionWidth: number, resolutionHeight: number, framerate: number, progressCallback: (numberOfRenderedFrames: number, numberOfEncodedFrames: number, totalNumberOfFrames: number) => void): Promise<Blob>;
+    exportVideo(handle: DesignBlockId, mimeType: MimeType_2 | undefined, progressCallback: (numberOfRenderedFrames: number, numberOfEncodedFrames: number, totalNumberOfFrames: number) => void, options: VideoExportOptions): Promise<Blob>;
     /**
      * Loads existing blocks from the given string.
      * The blocks are not attached by default and won't be visible until attached to a page or the scene.
@@ -606,9 +544,14 @@ export declare class BlockAPI {
     setName(id: DesignBlockId, name: string): void;
     /**
      * Get a block's name.
-     * @param id - The block to update.
+     * @param id - The block to query.
      */
     getName(id: DesignBlockId): string;
+    /**
+     * Get a block's UUID.
+     * @param id - The block to query.
+     */
+    getUUID(id: DesignBlockId): string;
     /**
      * Finds all blocks with the given name.
      * @param name - The name to search for.
@@ -821,7 +764,7 @@ export declare class BlockAPI {
     /**
      * Set a block's mode for its width.
      * @param id - The block to update.
-     * @param mode - The width mode: absolute, percent or auto.
+     * @param mode - The width mode: Absolute, Percent or Auto.
      */
     setWidthMode(id: DesignBlockId, mode: SizeMode): void;
     /**
@@ -833,7 +776,7 @@ export declare class BlockAPI {
     /**
      * Set a block's mode for its height.
      * @param id - The block to update.
-     * @param mode - The height mode: absolute, percent or auto.
+     * @param mode - The height mode: Absolute, Percent or Auto.
      */
     setHeightMode(id: DesignBlockId, mode: SizeMode): void;
     /**
@@ -1121,14 +1064,14 @@ export declare class BlockAPI {
      * @param property - The name of the property to set.
      * @param value - The enum value as string.
      */
-    setEnum(id: DesignBlockId, property: string, value: string): void;
+    setEnum<T extends string = string>(id: DesignBlockId, property: string, value: T): void;
     /**
      * Get the value of an enum property of the given design block.
      * @param id - The block whose property should be queried.
      * @param property - The name of the property to query.
      * @returns The value as string.
      */
-    getEnum(id: DesignBlockId, property: string): string;
+    getEnum<T extends string = string>(id: DesignBlockId, property: string): T;
     /**
      * Query if the given block has crop properties.
      * @param id - The block to query.
@@ -1270,6 +1213,7 @@ export declare class BlockAPI {
      * Query if the given block has fill color properties.
      * @param id - The block to query.
      * @returns true, if the block has fill color properties.
+     * @deprecated Query the fills type using getFill() and getType() instead.
      */
     hasFillColor(id: DesignBlockId): boolean;
     /**
@@ -1280,24 +1224,28 @@ export declare class BlockAPI {
      * @param g - The green color component in the range of 0 to 1.
      * @param b - The blue color component in the range of 0 to 1.
      * @param a - The alpha color component in the range of 0 to 1.
+     * @deprecated Use setFillSolidColor() instead.
      */
     setFillColorRGBA(id: DesignBlockId, r: number, g: number, b: number, a?: number): void;
     /**
      * Get the fill color of the given design block.
      * @param id - The block whose fill color should be queried.
      * @returns The fill color.
+     * @deprecated Use getFillSolidColor() instead.
      */
     getFillColorRGBA(id: DesignBlockId): RGBA;
     /**
      * Enable or disable the fill of the given design block.
      * @param id - The block whose fill should be enabled or disabled.
      * @param enabled - If true, the fill will be enabled.
+     * @deprecated Use setFillEnabled() instead.
      */
     setFillColorEnabled(id: DesignBlockId, enabled: boolean): void;
     /**
      * Query if the fill of the given design block is enabled.
      * @param id - The block whose fill state should be queried.
      * @returns True, if fill is enabled.
+     * @deprecated Use isFillEnabled() instead."
      */
     isFillColorEnabled(id: DesignBlockId): boolean;
     /**
@@ -1655,6 +1603,69 @@ export declare class BlockAPI {
      * @returns The drop shadow's clipping.
      */
     getDropShadowClip(id: DesignBlockId): boolean;
+    /**
+     * Inserts the given text into the selected range of the text block.
+     * @param block - The text block into which to insert the given text.
+     * @param text - The text which should replace the selected range in the block.
+     * @param from - The start index of the UTF-16 range that should be replaced.
+     * If the value is negative, this will fall back to the start of the entire text range.
+     * @param to - The UTF-16 index after the last grapheme that should be replaced by the inserted text.
+     *   If `from` and `to` are negative, a this will fall back to the end of the entire text range, so the entire text will be replaced.
+     *   If `to` is negative but `from` is greater than or equal to 0, the text will be inserted at the index defined by `from`.
+     */
+    replaceText(id: DesignBlockId, text: string, from?: number, to?: number): void;
+    /**
+     * Removes selected range of text of the given text block.
+     * @param block - The text block from which the selected text should be removed.
+     * @param from - The start index of the UTF-16 range that should be removed.
+     * If the value is negative, this will fall back to the start of the entire text range.
+     * @param to - The UTF-16 index after the last grapheme that should be removed.
+     * If the value is negative, this will fall back to the end of the entire text range.
+     */
+    removeText(id: DesignBlockId, from?: number, to?: number): void;
+    /**
+     * Changes the color of the text in the selected range to the given color.
+     * @param block - The text block whose color should be changed.
+     * @param color - The new color of the selected text range.
+     * @param from - The start index of the UTF-16 range whose color should be changed.
+     *   If the value is negative and the block is currently being edited, this will fall back to the start of the current cursor index / selected grapheme range.
+     *   If the value is negative and the block is not being edited, this will fall back to the start of the entire text range.
+     * @param to - The UTF-16 index after the last grapheme whose color should be changed.
+     *   If the value is negative and the block is currently being edited, this will fall back to the end of the current cursor index / selected grapheme range.
+     *   If the value is negative and the block is not being edited, this will fall back to the end of the entire text range.
+     */
+    setTextColor(id: DesignBlockId, color: RGBAColor | SpotColor, from?: number, to?: number): void;
+    /**
+     * Returns the ordered unique list of colors of the text in the selected range.
+     * @param block - The text block whose colors should be returned.
+     * @param from - The start index of the UTF-16 range whose colors should be returned.
+     * If the value is negative, this will fall back to the start of the entire text range.
+     * @param to - The UTF-16 index after the last grapheme whose colors should be returned.
+     * If the value is negative, this will fall back to the end of the entire text range.
+     */
+    getTextColors(id: DesignBlockId, from?: number, to?: number): Array<RGBAColor | SpotColor>;
+    /**
+     * Returns the ordered unique list of font weights of the text in the selected range.
+     * @param block - The text block whose font weights should be returned.
+     * @param from - The start index of the UTF-16 range whose font weights should be returned.
+     *   If the value is negative and the block is currently being edited, this will fall back to the start of the current cursor index / selected grapheme range.
+     *   If the value is negative and the block is not being edited, this will fall back to the start of the entire text range.
+     * @param to - The UTF-16 index after the last grapheme whose font weights should be returned.
+     *   If the value is negative and the block is currently being edited, this will fall back to the end of the current cursor index / selected grapheme range.
+     *   If the value is negative and the block is not being edited, this will fall back to the end of the entire text range.
+     */
+    getTextFontWeights(id: DesignBlockId, from?: number, to?: number): FontWeight[];
+    /**
+     * Returns the ordered unique list of font styles of the text in the selected range.
+     * @param block - The text block whose font styles should be returned.
+     * @param from - The start index of the UTF-16 range whose font weights should be returned.
+     *   If the value is negative and the block is currently being edited, this will fall back to the start of the current cursor index / selected grapheme range.
+     *   If the value is negative and the block is not being edited, this will fall back to the start of the entire text range.
+     * @param to - The UTF-16 index after the last grapheme whose font styles should be returned.
+     *   If the value is negative and the block is currently being edited, this will fall back to the end of the current cursor index / selected grapheme range.
+     *   If the value is negative and the block is not being edited, this will fall back to the end of the entire text range.
+     */
+    getTextFontStyles(id: DesignBlockId, from?: number, to?: number): FontStyle[];
     /**
      * Query if the given block has fill color properties.
      * @param id - The block to query.
@@ -1692,12 +1703,14 @@ export declare class BlockAPI {
      * @param id - The block whose fill type should be set.
      * @param type - The fill type to set.
      * @returns An empty result on success, an error otherwise.
+     * @deprecated Use `createFill`, e.g., with type 'color' and then apply the fill block with `setFill` to the block instead.  If the block has a fill, it should be removed with `getFill` and `destroy`.
      */
     setFillType(id: DesignBlockId, fillType: FillType): void;
     /**
      * Get the fill type of the given design block.
      * @param id - The block whose fill type should be queried.
      * @returns The block's fill type or an error.
+     * @deprecated Use `getEnum(id, 'fill/type')` instead.
      */
     getFillType(id: DesignBlockId): FillType;
     /**
@@ -1721,12 +1734,14 @@ export declare class BlockAPI {
      * @param id - The block whose gradient type should be set.
      * @param type - The gradient type.
      * @returns An empty result on success, an error otherwise.
+     * @deprecated Use `createFill`, e.g., with '//ly.img.ubq/fill/gradient/linear' and then apply the fill block with `setFill` to the block instead. If the block has a fill, it should be removed with `getFill` and `destroy`.
      */
     setFillGradientType(id: DesignBlockId, gradientType: GradientType): void;
     /**
      * Get the gradient type of the given design block.
      * @param id - The block whose gradient type should be queried.
      * @returns The gradient type.
+     * @deprecated Use `getEnum(id, 'fill/gradient/type')` instead.
      */
     getFillGradientType(id: DesignBlockId): GradientType;
     /**
@@ -1738,6 +1753,7 @@ export declare class BlockAPI {
      * @param b - The blue color component in the range of 0 to 1.
      * @param a - The alpha color component in the range of 0 to 1.
      * @returns An empty result on success, an error otherwise.
+     * @deprecated Removed without a direct replacement. Use `block.setFloat(fill, keypath, value)` with key paths 'fill/gradient/linear/startPointX/Y', 'fill/gradient/radial/centerPointX/Y', and 'fill/gradient/conical/centerPointX/Y' to move the control points.
      */
     addFillGradientColorStop(id: DesignBlockId, stop: number, r: number, g: number, b: number, a?: number): void;
     /**
@@ -1745,12 +1761,14 @@ export declare class BlockAPI {
      * @param id - The block from which to remove the gradient color stop.
      * @param stop - The stop's position.
      * @returns An empty result on success, an error otherwise.
+     * @deprecated Removed without a direct replacement. Use `block.setFloat(fill, keypath, value)` with key paths 'fill/gradient/linear/startPointX/Y', 'fill/gradient/radial/centerPointX/Y', and 'fill/gradient/conical/centerPointX/Y' to move the control points.
      */
     removeFillGradientColorStop(id: DesignBlockId, stop: number): void;
     /**
      * Get the gradient fill color stops of the given design block.
      * @param id - The block whose gradient color stop should be queried.
      * @returns All of the design block's gradient color stops.
+     * @deprecated Removed without a direct replacement. Use `block.getFloat(fill, keypath)` with key paths 'fill/gradient/linear/startPointX/Y', 'fill/gradient/radial/centerPointX/Y', and 'fill/gradient/conical/centerPointX/Y' instead.
      */
     getFillGradientColorStops(id: DesignBlockId): GradientstopRGBA[];
     /**
@@ -1758,6 +1776,7 @@ export declare class BlockAPI {
      * @param id - The block whose gradient color stop should be set.
      * @param stops - The gradient color stops to set.
      * @returns An empty result on success, an error otherwise.
+     * @deprecated Removed without a direct replacement. Use `block.setFloat(fill, keypath, value)` with key paths 'fill/gradient/linear/startPointX/Y', 'fill/gradient/radial/centerPointX/Y', and 'fill/gradient/conical/centerPointX/Y' to move the control points.
      */
     setFillGradientColorStops(id: DesignBlockId, stops: GradientstopRGBA[]): void;
     /**
@@ -1768,6 +1787,7 @@ export declare class BlockAPI {
      * @param x - The horizontal component of the control point.
      * @param y - The vertical component of the control point.
      * @returns true if the control point was set, an error otherwise.
+     * @deprecated Use, e.g., `block.setFloat(fill, 'fill/gradient/linear/startPointX', value)` and `startPointY` instead.
      */
     setFillGradientControlPoint(id: DesignBlockId, gradientControlPointType: GradientControlPointType, x: number, y: number): boolean;
     /**
@@ -1775,6 +1795,7 @@ export declare class BlockAPI {
      * @param id - The block whose gradient control point should be queried.
      * @param gradientControlPointType - The type of control point.
      * @returns The horizontal component of the control point, an error otherwise.
+     * @deprecated Use `block.getFloat(fill, keypath)` with key paths 'fill/gradient/linear/startPointX', 'fill/gradient/radial/centerPointX', and 'fill/gradient/conical/centerPointX' instead.
      */
     getFillGradientControlPointX(id: DesignBlockId, gradientControlPointType: GradientControlPointType): number;
     /**
@@ -1782,6 +1803,7 @@ export declare class BlockAPI {
      * @param id - The block whose gradient control point should be queried.
      * @param gradientControlPointType - The type of control point.
      * @returns The vertical component of the control point, an error otherwise.
+     * @deprecated Use `block.setFloat(fill, keypath, value)` with key paths 'fill/gradient/linear/startPointY', 'fill/gradient/radial/centerPointY', and 'fill/gradient/conical/centerPointY' instead.
      */
     getFillGradientControlPointY(id: DesignBlockId, gradientControlPointType: GradientControlPointType): number;
     /**
@@ -1790,6 +1812,7 @@ export declare class BlockAPI {
      * @param id - The block whose gradient radius should be set.
      * @param radius - The gradient's radius.
      * @returns true if the control point was set, an error otherwise.
+     * @deprecated Use, e.g., `block.setFloat(fill, 'fill/gradient/radial/radius', value)` instead.
      */
     setFillGradientRadius(id: DesignBlockId, radius: number): boolean;
     /**
@@ -1797,6 +1820,7 @@ export declare class BlockAPI {
      * Note that Not all gradients have a radius.
      * @param id - The block whose gradient radius should be queried.
      * @returns the gradient's radius, an error otherwise.
+     * @deprecated Use, e.g., `block.getFloat(fill, 'fill/gradient/radial/radius')` instead.
      */
     getFillGradientRadius(id: DesignBlockId): number;
     /**
@@ -1815,8 +1839,39 @@ export declare class BlockAPI {
      * Query if the given block shows placeholder content.
      * @param id - The block to query.
      * @returns true, if the block shows placeholder content.
+     * @deprecated Use placeholder controls functions.
      */
     showsPlaceholderContent(id: DesignBlockId): boolean;
+    /**
+     * Checks whether the block supports placeholder controls.
+     * @param block - The block to query.
+     * @returns True, if the block supports placeholder controls.
+     */
+    hasPlaceholderControls(id: DesignBlockId): boolean;
+    /**
+     * Enable or disable the visibility of the placeholder overlay pattern for a block.
+     * @param block - The block whose placeholder overlay should be enabled or disabled.
+     * @param enabled - Whether the placeholder overlay should be shown or not.
+     * @returns An empty result on success, an error otherwise.
+     */
+    setPlaceholderControlsOverlayEnabled(id: DesignBlockId, enabled: boolean): void;
+    /**
+     * Query whether the placeholder overlay pattern for a block is shown.
+     * @param block - The block whose placeholder overlay visibility state should be queried.
+     * @returns An error if the block was invalid, otherwise the visibility state of the block's placeholder overlay pattern.
+     */
+    isPlaceholderControlsOverlayEnabled(id: DesignBlockId): boolean;
+    /** Enable or disable the visibility of the placeholder button for a block.
+     * @param block - The block whose placeholder button should be shown or not.
+     * @param enabled - Whether the placeholder button should be shown or not.
+     * @returns An empty result on success, an error otherwise.
+     */
+    setPlaceholderControlsButtonEnabled(id: DesignBlockId, enabled: boolean): void;
+    /** Query whether the placeholder button for a block is shown.
+     * @param block - The block whose placeholder button visibility state should be queried.
+     * @returns An error if the block was invalid, otherwise
+     */
+    isPlaceholderControlsButtonEnabled(id: DesignBlockId): boolean;
     /**
      * Set a metadata value of a block identified by a key.
      * If the key does not exist, yet, it will be added.
@@ -1959,15 +2014,15 @@ export declare class BlockAPI {
      */
     getTotalSceneDuration(scene: DesignBlockId): number;
     /**
-     * Set whether the block should be during active playback.
+     * Set whether the block should be playing during active playback.
      * @param id - The block that should be updated.
      * @param enabled - Whether the block should be playing its contents.
      */
     setPlaying(id: DesignBlockId, enabled: boolean): void;
     /**
-     * Returns whether the block is currently during active playback.
+     * Returns whether the block is playing during active playback.
      * @param id - The block to query.
-     * @returns whether the block is during playback.
+     * @returns whether the block is playing during playback.
      */
     isPlaying(id: DesignBlockId): boolean;
     /**
@@ -2011,7 +2066,7 @@ export declare class BlockAPI {
      */
     hasPlaybackControl(id: DesignBlockId): boolean;
     /**
-     * Set whether the block should start from the beginning again or stop.
+     * Set whether the block should restart from the beginning again or stop.
      * @param block - The block or video fill to update.
      * @param looping - Whether the block should loop to the beginning or stop.
      */
@@ -2085,15 +2140,6 @@ export declare class BlockAPI {
     getPageThumbnailAtlas(id: DesignBlockId, numberOfColumns: number, numberOfRows: number, thumbnailHeight: number): Promise<Blob>;
 }
 
-/**
- * This maintains a list of Blocks, ensuring that only one Block instance
- * exists per id.
- * @public
- */
-export declare class BlockChannels extends EntityChannels<Block> {
-    getBlock(id: number): Block;
-}
-
 /** @public */
 export declare interface BlockEvent {
     block: DesignBlockId;
@@ -2137,7 +2183,7 @@ declare type CameraSettings = {
  *   the current value.
  * @public
  */
-export declare interface Channel<Out, In = Out> {
+declare interface Channel<Out, In = Out> {
     subscribe: Source<Out>;
     update?: (v: In) => void;
     value?: () => Out;
@@ -2147,7 +2193,7 @@ export declare interface Channel<Out, In = Out> {
  * A {@link Channel} that is guaranteed to have a `value` method
  * @public
  */
-export declare interface ChannelSync<Out, In = Out> extends Channel<Out, In> {
+declare interface ChannelSync<Out, In = Out> extends Channel<Out, In> {
     subscribe: Source<Out>;
     update?: (v: In) => void;
     value: () => Out;
@@ -2197,12 +2243,11 @@ declare namespace ConfigTypes {
         PageFormatDefinition,
         TemplateDefinition,
         TypefaceDefinition,
-        ImageDefinition,
         Presets,
         Variables,
         Core,
         Extensions,
-        Scene_2 as Scene,
+        Scene,
         Page,
         Callbacks
     }
@@ -2213,12 +2258,15 @@ export { ConfigTypes }
 export declare interface Configuration {
     baseURL: string;
     license?: string;
-    role: RoleString;
-    featureFlags?: Record<string, string | boolean>;
+    featureFlags?: {
+        [flag: string]: boolean | string;
+    };
+    /**
+     * @deprecated Extensions have been superseded by AssetSources and should no longer be used.
+     */
     extensions: ConfigTypes.Extensions;
     core: ConfigTypes.Core;
     scene: ConfigTypes.Scene;
-    page: ConfigTypes.Page;
     assetSources: ConfigTypes.AssetSources;
     presets: ConfigTypes.Presets;
     variables: ConfigTypes.Variables;
@@ -2287,13 +2335,56 @@ declare class CreativeEngine {
      * @param config - An optional configuration object.
      * @returns An engine instance.
      */
-    static init<C extends Partial<Configuration>>(config?: C): Promise<CreativeEngine & (C extends {
+    static init<C extends Partial<Configuration> & OldConfiguration>(config?: C): Promise<CreativeEngine & (C extends {
         readonly canvas: any;
     } ? {
         readonly element: undefined;
     } : {
         readonly element: HTMLCreativeEngineCanvasElement;
     })>;
+    /**
+     * 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.
+     *
+     * @param baseURL - The source of the asset definitions, must be absolute. Defaults to `'https://cdn.img.ly/assets/v1'`.
+     * @param excludeAssetSourceIds - A list of IDs, that will be ignored during load.
+     */
+    addDefaultAssetSources({ baseURL, excludeAssetSourceIds }?: {
+        baseURL?: string;
+        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
+     *
+     * @param excludeAssetSourceIds - A list of IDs, that will be ignored during load.
+     * @param sceneMode - if 'Video' video specific demo asset sources will be loaded as well (default 'Design')
+     * @param withUploadAssetSources - if 'true' asset sources for uploads are added (default false)
+     */
+    addDemoAssetSources({ excludeAssetSourceIds, sceneMode, withUploadAssetSources }?: {
+        excludeAssetSourceIds?: DemoAssetSourceId[];
+        sceneMode?: SceneMode;
+        withUploadAssetSources?: boolean;
+    }): Promise<void>;
 
 
 }
@@ -2312,6 +2403,16 @@ export declare interface CursorEvent extends CustomEvent<string> {
     preventDefault(): void;
 }
 
+/**
+ * @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
@@ -2341,8 +2442,11 @@ export declare enum DesignBlockType {
     Group = "//ly.img.ubq/group"
 }
 
-/** @public */
-export declare type DesignUnit = 'mm' | 'px' | 'in';
+/**
+ * The scene layout determines how the layout stack should layout its pages.
+ * @public
+ */
+export declare type DesignUnit = 'Pixel' | 'Millimeter' | 'Inch';
 
 /**
  * @public
@@ -2355,7 +2459,7 @@ export declare class EditorAPI {
      * @param callback - This function is called at the end of the engine update, if the editor state has changed.
      * @returns A method to unsubscribe.
      */
-    onStateChanged(callback: () => void): () => void;
+    onStateChanged: (callback: () => void) => (() => void);
     /**
      * Set the edit mode of the editor.
      * An edit mode defines what type of content can currently be edited by the user.
@@ -2441,26 +2545,26 @@ export declare class EditorAPI {
      * @param callback - This function is called at the end of the engine update, if the undo/redo history has been changed.
      * @returns A method to unsubscribe
      */
-    onHistoryUpdated(callback: () => void): () => void;
+    onHistoryUpdated: (callback: () => void) => (() => void);
     /**
      * Subscribe to changes to the editor settings.
      * @param callback - This function is called at the end of the engine update, if the editor settings have changed.
      * @returns A method to unsubscribe.
      */
-    onSettingsChanged(callback: () => void): () => void;
+    onSettingsChanged: (callback: () => void) => (() => void);
     /**
      * Set a boolean setting.
      * @param keypath - The settings keypath, e.g. `doubleClickToCropEnabled`
      * @param value - The value to set.
      * @throws An error, if the keypath is invalid.
      */
-    setSettingBool(keypath: string, value: boolean): void;
+    setSettingBool(keypath: SettingsBool, value: boolean): void;
     /**
      * Get a boolean setting.
      * @param keypath - The settings keypath, e.g. `doubleClickToCropEnabled`
      * @throws An error, if the keypath is invalid.
      */
-    getSettingBool(keypath: string): boolean;
+    getSettingBool(keypath: SettingsBool): boolean;
     /**
      * Set an integer setting.
      * @param keypath - The settings keypath.
@@ -2480,26 +2584,26 @@ export declare class EditorAPI {
      * @param value - The value to set.
      * @throws An error, if the keypath is invalid.
      */
-    setSettingFloat(keypath: string, value: number): void;
+    setSettingFloat(keypath: 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: string): number;
+    getSettingFloat(keypath: SettingsFloat): number;
     /**
      * Set a string setting.
      * @param keypath - The settings keypath, e.g. `license`
      * @param value - The value to set.
      * @throws An error, if the keypath is invalid.
      */
-    setSettingString(keypath: string, value: string): void;
+    setSettingString(keypath: 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: string): string;
+    getSettingString(keypath: SettingsString): string;
     /**
      * Set a color setting.
      * @param keypath - The settings keypath, e.g. `highlightColor`.
@@ -2508,25 +2612,25 @@ export declare class EditorAPI {
      * @param b - The blue color component in the range of 0 to 1.
      * @param a - The alpha color component in the range of 0 to 1.
      */
-    setSettingColorRGBA(keypath: string, r: number, g: number, b: number, a?: number): void;
+    setSettingColorRGBA(keypath: 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.
      */
-    getSettingColorRGBA(keypath: string): RGBA;
+    getSettingColorRGBA(keypath: SettingsColorRGBA): RGBA;
     /**
      * Set an enum setting.
      * @param keypath - The settings keypath, e.g. `role`.
      * @param value - The enum value as string.
      */
-    setSettingEnum(keypath: string, value: string): void;
+    setSettingEnum<T extends keyof SettingsEnum>(keypath: T, value: SettingsEnum[T]): void;
     /**
      * Get an enum setting.
      * @param keypath - The settings keypath, e.g. `role`.
      * @returns The value as string.
      */
-    getSettingEnum(keypath: string): string;
+    getSettingEnum<T extends keyof SettingsEnum>(keypath: T): SettingsEnum[T];
     /**
      * Get the currently available memory in bytes.
      * @returns The currently available memory in bytes.
@@ -2603,48 +2707,6 @@ export declare class EditorAPI {
     removeSpotColor(name: string): void;
 }
 
-/**
- * Holds Channels for the different properties of an effect.
- * Ensures that for each property, only one channel exists.
- * @public
- */
-export declare class Effect extends Entity {
-    enabled: ReadWriteChannelSync<boolean>;
-
-}
-
-/**
- * This maintains a list of Effects, ensuring that only one Block instance
- * exists per id.
- * @public
- */
-export declare class EffectChannels extends EntityChannels<Effect> {
-    getEffect(id: number): Effect;
-}
-
-/**
- * @public
- */
-export declare class Entity {
-    #private;
-
-
-
-    get id(): number;
-    Int(property: string): ReadWriteChannelSync<number>;
-    Float(property: string): ReadWriteChannelSync<number>;
-    Bool(property: string): ReadWriteChannelSync<boolean>;
-}
-
-/** @public */
-export declare class EntityChannels<T extends Entity> {
-    #private;
-
-
-
-    dispose(): void;
-}
-
 /**
  * @public
  */
@@ -2657,7 +2719,7 @@ export declare class EventAPI {
      * @param callback - The event callback. Events are bundled and sent at the end of each engine update.
      * @returns A method to unsubscribe.
      */
-    subscribe(blocks: DesignBlockId[], callback: (events: BlockEvent[]) => void): () => void;
+    subscribe: (blocks: DesignBlockId[], callback: (events: BlockEvent[]) => void) => (() => void);
 }
 
 /**
@@ -2807,6 +2869,9 @@ declare type HexColorString = string;
  */
 export declare type HistoryId = number;
 
+/** @public */
+export declare type HorizontalTextAlignment = 'Left' | 'Right' | 'Center';
+
 /**
  * A wrapper around a plain canvas
  *
@@ -2819,19 +2884,21 @@ export declare type HistoryId = number;
 export declare interface HTMLCreativeEngineCanvasElement extends HTMLElement {
 
 
+    /**
+     * Clear the canvas
+     *
+     * This is useful when mounting the canvas into a new position in the DOM.
+     * If the canvas is not cleared, it will appear in the new DOM position, with
+     * its contents stretched to the new size. It will re-render correctly during
+     * the next animation frame, but for a brief moment the canvas contents can
+     * flash distorted.
+     *
+     * Call `clear()` before mounting into the DOM to avoid this. This will cause
+     * the canvas to be cleared until rendering the next frame.
+     */
+    clear(): void;
 }
 
-/** @public */
-declare type ImageDefinition = Preset & {
-    imageURL: string;
-    thumbnailURL?: string;
-    width: number;
-    height: number;
-    levelOfDetail?: {
-        [lod: number]: string;
-    };
-};
-
 /**
  * e.g. `en`, `de`, etc.
  * @public
@@ -2860,7 +2927,38 @@ declare enum MimeType_2 {
 }
 export { MimeType_2 as MimeType }
 
-/** @public */
+/**
+ * Contains configuration keys that have been removed from the actual
+ * configuration, but are still supported publicly
+ * @public
+ */
+export declare interface OldConfiguration {
+    /**
+     * @deprecated This config key has been removed.
+     * You can configure a role via `setSettingEnum('role', role)` in the
+     * EditorAPI.
+     */
+    role?: RoleString;
+    /**
+     * @deprecated This config key has been removed completely.
+     * The settings that were configured here can be set via the
+     * following EditorAPI settings:
+     * - `setSettingBool('page/title/show', show)`
+     * - `setSettingString('page/title/fontFileUri', uri)`
+     * - `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
+ * following EditorAPI settings:
+ * - `setSettingBool('page/title/show', show)`
+ * - `setSettingString('page/title/fontFileUri', uri)`
+ * - `setSettingBool('page/title/dimOutOfPageAreas', dim)`
+ * @public
+ */
 declare type Page = {
     title: {
         /**
@@ -2891,9 +2989,7 @@ export declare interface PageDuration {
 declare type PageFormatDefinition = Preset & {
     width: number;
     height: number;
-    unit: DesignUnit;
-    dpi?: number;
-    bleedMargin?: number;
+    unit: 'px' | 'mm' | 'in';
     fixedOrientation?: boolean;
 };
 
@@ -2923,9 +3019,6 @@ declare type Presets = {
     typefaces?: {
         [id: string]: TypefaceDefinition;
     };
-    images?: {
-        [id: string]: ImageDefinition;
-    };
     pageFormats?: {
         [id: string]: PageFormatDefinition;
     };
@@ -2959,7 +3052,7 @@ declare interface QueryData {
  * A Read only {@link Channel}
  * @public
  */
-export declare interface ReadOnlyChannel<Out> extends Omit<Channel<Out>, 'update'> {
+declare interface ReadOnlyChannel<Out> extends Omit<Channel<Out>, 'update'> {
     subscribe: Source<Out>;
     value?: () => Out;
 }
@@ -2968,7 +3061,7 @@ export declare interface ReadOnlyChannel<Out> extends Omit<Channel<Out>, 'update
  * A {@link ReadOnlyChannel} that is guaranteed to have a `value`
  * @public
  */
-export declare interface ReadOnlyChannelSync<Out> extends Omit<ChannelSync<Out>, 'update'>, ReadOnlyChannel<Out> {
+declare interface ReadOnlyChannelSync<Out> extends Omit<ChannelSync<Out>, 'update'>, ReadOnlyChannel<Out> {
     subscribe: Source<Out>;
     value: () => Out;
 }
@@ -2977,7 +3070,7 @@ export declare interface ReadOnlyChannelSync<Out> extends Omit<ChannelSync<Out>,
  * A {@link Channel} that is guaranteed to have an `update` method.
  * @public
  */
-export declare interface ReadWriteChannel<Out, In = Out> extends Channel<Out, In> {
+declare interface ReadWriteChannel<Out, In = Out> extends Channel<Out, In> {
     subscribe: Source<Out>;
     update: (v: In) => void;
     value?: () => Out;
@@ -2987,7 +3080,7 @@ export declare interface ReadWriteChannel<Out, In = Out> extends Channel<Out, In
  * A {@link ReadWriteChannel} that is guaranteed to have a `value` and an `update` method
  * @public
  */
-export declare interface ReadWriteChannelSync<Out, In = Out> extends ChannelSync<Out, In>, ReadWriteChannel<Out, In> {
+declare interface ReadWriteChannelSync<Out, In = Out> extends ChannelSync<Out, In>, ReadWriteChannel<Out, In> {
     subscribe: Source<Out>;
     update: (v: In) => void;
     value: () => Out;
@@ -3035,31 +3128,11 @@ export declare interface RGBColor {
 /** @public */
 export declare type RoleString = 'Creator' | 'Adopter' | 'Viewer' | 'Presenter';
 
-/**
- * Contains channels for scene-specific information that are valid through
- * scene changes.
- * @public
- */
-export declare class Scene {
-
-    /**
-     * A channel containing the latest Block.
-     * Will emit an event when the scene changes
-     */
-    block: ChannelSync<Block | undefined>;
-    mode: ChannelSync<SceneMode | undefined>;
-    totalDuration: ChannelSync<number>;
-    pages: ChannelSync<DesignBlockId[]>;
-    playing: ReadWriteChannelSync<boolean>;
-    playbackTime: ReadWriteChannelSync<number>;
-    pageDurations: ChannelSync<PageDuration[]>;
-}
-
 /**
  * Export Settings
  * @public
  */
-declare type Scene_2 = {
+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).
@@ -3126,11 +3199,19 @@ export declare class SceneAPI {
      * Fetching the image may take an arbitrary amount of time, so the scene isn't immediately
      * available.
      * @param url - The image URL.
-     * @param dpi - The scenes DPI.
-     * @param pixelScaleFactor - The displays pixel scale factor.
+     * @param dpi - The scene's DPI.
+     * @param pixelScaleFactor - The display's pixel scale factor.
      * @returns A promise that resolves with the scene ID on success or rejected with an error otherwise.
      */
     createFromImage(url: string, dpi?: number, pixelScaleFactor?: number, sceneLayout?: SceneLayout, spacing?: number, spacingInScreenSpace?: boolean): Promise<DesignBlockId>;
+    /**
+     * Loads the given video and creates a scene with a single page showing the video.
+     * Fetching the video may take an arbitrary amount of time, so the scene isn't immediately
+     * available.
+     * @param url - The video URL.
+     * @returns A promise that resolves with the scene ID on success or rejected with an error otherwise.
+     */
+    createFromVideo(url: string): Promise<DesignBlockId>;
     /**
      * Return the currently active scene.
      * @returns The scene or null, if none was created yet.
@@ -3159,6 +3240,16 @@ export declare class SceneAPI {
      * @returns The current mode of the scene.
      */
     getMode(): SceneMode;
+    /**
+     * Converts all values of the current scene into the given design unit.
+     * @param designUnit - The new design unit of the scene
+     */
+    setDesignUnit(designUnit: DesignUnit): void;
+    /**
+     * Returns the design unit of the current scene.
+     * @returns The current design unit.
+     */
+    getDesignUnit(): DesignUnit;
     /**
      * Get the sorted list of pages in the scene.
      * @returns The sorted list of pages in the scene.
@@ -3236,23 +3327,13 @@ export declare class SceneAPI {
      * @returns A method to unsubscribe.
      * @privateRemarks This will currently fire on _all_ changes to camera properties
      */
-    onZoomLevelChanged(callback: () => void): () => void;
+    onZoomLevelChanged: (callback: () => void) => (() => void);
     /**
      * Subscribe to changes to the active scene rendered by the engine.
      * @param callback - This function is called at the end of the engine update, if the active scene has changed.
      * @returns A method to unsubscribe.
      */
-    onActiveChanged(callback: () => void): () => void;
-    /**
-     * Converts all values of the current scene into the given design unit.
-     * @param designUnit - The new design unit of the scene
-     */
-    unstable_setDesignUnit(designUnit: DesignUnit): void;
-    /**
-     * Returns the design unit of the current scene.
-     * @returns The current design unit.
-     */
-    unstable_getDesignUnit(): DesignUnit;
+    onActiveChanged: (callback: () => void) => (() => void);
 }
 
 /**
@@ -3267,20 +3348,24 @@ export declare type SceneLayout = 'Free' | 'VerticalStack' | 'HorizontalStack' |
  */
 export declare type SceneMode = 'Design' | 'Video';
 
-/**
- * This channel allows to subscribe/update the selected design blocks.
- * @public
- */
-export declare class SelectionChannel implements ReadWriteChannelSync<number[]> {
-    #private;
-    subscribe: Source<number[]>;
-    update: (selectedDesignElements: number[]) => void;
-    value: () => number[];
-    blocks: ChannelSync<Block[]>;
+/** @public */
+export declare type SettingsBool = 'doubleClickToCropEnabled' | 'features/aiImageMattingEnabled' | 'features/aiImageMattingStagingEnabled' | 'features/aiInpaintingEnabled' | 'features/aiSmartCropEnabled' | 'features/aiSuperResolutionEnabled' | 'features/effectsEnabled' | 'features/hspSelectiveAdjustmentsEnabled' | 'features/layerListEnabled' | 'features/singlePageModeEnabled' | 'features/templatingEnabled' | 'page/dimOutOfPageAreas' | 'page/title/show' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'showBuildVersion' | 'touch/dragStartCanSelect' | 'touch/singlePointPanning' | 'trackActivePage' | ArbitraryString;
 
-    private deselectAll;
-    private selectAll;
-}
+/** @public */
+export declare type SettingsColorRGBA = 'clearColor' | 'errorStateColor' | 'highlightColor' | 'page/title/color' | 'placeholderHighlightColor' | 'progressColor' | ArbitraryString;
+
+/** @public */
+export declare type SettingsEnum = {
+    role: RoleString;
+    doubleClickSelectionMode: 'Direct' | 'Hierarchical';
+    [key: ArbitraryString]: string;
+};
+
+/** @public */
+export declare type SettingsFloat = 'positionSnappingThreshold';
+
+/** @public */
+export declare type SettingsString = 'ai/apiStagingUrl' | 'ai/apiUrl' | 'ai/backendUrl' | 'basePath' | 'license' | 'page/title/fontFileUri' | ArbitraryString;
 
 /** @public */
 export declare interface Size2 {
@@ -3311,8 +3396,6 @@ declare type Source<T> = (handler: Handler<T>) => UnsubscribeFn;
 /** @public */
 export declare interface SpotColor {
     name: string;
-    rgbApproximation: RGBAColor;
-    cmykApproximation: CMYKColor;
 }
 
 declare interface SpotColorLookup {
@@ -3433,6 +3516,59 @@ export declare interface Vec4 {
     w: number;
 }
 
+/** @public */
+export declare type VerticalTextAlignment = 'Top' | 'Bottom' | 'Center';
+
+/**
+ * @public
+ */
+export declare type VideoExportOptions = {
+    /**
+     * Determines the encoder feature set and in turn the quality, size and speed of the encoding process.
+     *
+     * @defaultValue 77 (Main)
+     */
+    h264Profile?: number;
+    /**
+     * Controls the H.264 encoding level. This relates to parameters used by the encoder such as bit rate,
+     * timings and motion vectors. Defined by the spec are levels 1.0 up to 6.2. To arrive at an integer value,
+     * the level is multiplied by ten. E.g. to get level 5.2, pass a value of 52.
+     *
+     * @defaultValue 52
+     */
+    h264Level?: number;
+    /**
+     * The time offset in seconds of the scene's timeline from which the video will start.
+     *
+     * @defaultValue 0
+     */
+    timeOffset?: number;
+    /**
+     * The duration in seconds of the final video.
+     *
+     * @defaultValue The duration of the scene.
+     */
+    duration?: number;
+    /**
+     * The target framerate of the exported video in Hz.
+     *
+     * @defaultValue 30
+     */
+    framerate?: number;
+    /**
+     * An optional target width used in conjunction with target height.
+     * If used, the block will be rendered large enough, that it fills the target
+     * size entirely while maintaining its aspect ratio.
+     */
+    targetWidth?: number;
+    /**
+     * An optional target height used in conjunction with target width.
+     * If used, the block will be rendered large enough, that it fills the target
+     * size entirely while maintaining its aspect ratio.
+     */
+    targetHeight?: number;
+};
+
 /**
  * Describes a rectangle on the screen
  * - `x` and `y` indicate the position