@cesdk/cesdk-js 1.18.1-rc.1 → 1.19.0-rc.0

package/index.d.ts

@@ -9,10 +9,6 @@ declare type A11y = {
     headingsHierarchyStart: 1 | 2 | 3 | 4 | 5 | 6;
 };
 
-declare type ArbitraryString = string & {
-    arbitrary?: any;
-};
-
 /**
  * Generic asset information
  * @public
@@ -205,8 +201,8 @@ export declare type AssetGroups = string[];
 declare type AssetLibraryEntries = AssetLibraryEntry[] | ((currentAssetLibraryEntries: AssetLibraryEntry[], context: {
     selectedBlocks: {
         id: DesignBlockId;
-        blockType: DesignBlockType;
-        fillType?: DesignBlockType;
+        blockType: DesignBlockTypeLonghand;
+        fillType?: FillTypeLonghand;
     }[];
 }) => AssetLibraryEntry[]);
 
@@ -367,6 +363,8 @@ export declare type AssetMetaData = {
     width?: number;
     height?: number;
     duration?: string;
+    effectType?: EffectType;
+    blurType?: BlurType;
 } & Record<string, unknown>;
 
 /**
@@ -437,11 +435,6 @@ export declare interface AssetResult extends Asset {
 
 declare type _AssetResult = AssetResult;
 
-/** @public */
-declare interface AssetResultContext {
-    sourceId: string;
-}
-
 /** @public */
 declare interface AssetResultCredits {
     name: string;
@@ -454,12 +447,6 @@ declare interface AssetResultLicense {
     url: string;
 }
 
-/** @public */
-declare interface AssetResultUtm {
-    source: string;
-    medium: string;
-}
-
 /**
  * Asset Color payload RGB representation
  * @public
@@ -636,19 +623,19 @@ export declare class BlockAPI {
      * @param type - The type of the block that shall be created.
      * @returns The created blocks handle.
      */
-    create(type: DesignBlockTypes): DesignBlockId;
+    create(type: DesignBlockType): DesignBlockId;
     /**
      * Create a new fill, fails if type is unknown.
      * @param type - The type of the fill object that shall be created.
      * @returns The created fill's handle.
      */
-    createFill(type: FillTypes): DesignBlockId;
+    createFill(type: FillType): DesignBlockId;
     /**
      * Get the type of the given block, fails if the block is invalid.
      * @param id - The block to query.
      * @returns The blocks type.
      */
-    getType(id: DesignBlockId): BlockTypesLonghand;
+    getType(id: DesignBlockId): ObjectTypeLonghand;
     /**
      * Get the kind of the given block, fails if the block is invalid.
      * @param id - The block to query.
@@ -753,7 +740,7 @@ export declare class BlockAPI {
      * @param type - The type to search for.
      * @returns A list of block ids.
      */
-    findByType(type: BlockTypes): DesignBlockId[];
+    findByType(type: ObjectType): DesignBlockId[];
     /**
      * Finds all blocks with the given kind.
      * @param kind - The kind to search for.
@@ -775,7 +762,7 @@ export declare class BlockAPI {
      * @param type - The type of the shape object that shall be created.
      * @returns The created shape's handle.
      */
-    createShape(type: ShapeTypes): DesignBlockId;
+    createShape(type: ShapeType): DesignBlockId;
     /**
      * Query if the given block has a shape property.
      * @param id - The block to query.
@@ -821,6 +808,18 @@ export declare class BlockAPI {
      * @param clipped - Whether the block should clips its contents to its frame.
      */
     setClipped(id: DesignBlockId, clipped: boolean): void;
+    /**
+     * Query a block's transform locked state. If true, the block's transform can't be changed.
+     * @param id - The block to query.
+     * @returns True if transform locked, false otherwise.
+     */
+    isTransformLocked(id: DesignBlockId): boolean;
+    /**
+     * Update a block's transform locked state.
+     * @param id - The block to update.
+     * @param locked - Whether the block's transform should be locked.
+     */
+    setTransformLocked(id: DesignBlockId, locked: boolean): void;
     /**
      * Query a block's x position.
      * @param id - The block to query.
@@ -1535,6 +1534,18 @@ export declare class BlockAPI {
      * @deprecated Query the fills type using getFill() and getType() instead.
      */
     hasFillColor(id: DesignBlockId): boolean;
+    /**
+     * Query if the given block is included on the exported result.
+     * @param id - The block to query.
+     * @returns true, if the block is included on the exported result, false otherwise
+     */
+    isIncludedInExport(id: DesignBlockId): boolean;
+    /**
+     * Set if you want the given design block to be included in exported result.
+     * @param id - The block whose exportable state should be set.
+     * @param enabled - If true, the block will be included on the exported result.
+     */
+    setIncludedInExport(id: DesignBlockId, enabled: boolean): void;
     /**
      * Set the fill color of the given design block.
      * @param id - The block whose fill color should be set.
@@ -1572,7 +1583,7 @@ export declare class BlockAPI {
      * @param type - The type id of the effect.
      * @returns The created effects handle.
      */
-    createEffect(type: EffectTypes): DesignBlockId;
+    createEffect(type: EffectType): DesignBlockId;
     /**
      * Queries whether the block supports effects.
      * @param id - The block to query.
@@ -1629,7 +1640,7 @@ export declare class BlockAPI {
      * @param type - The type id of the block.
      * @returns The handle of the newly created blur.
      */
-    createBlur(type: BlurTypes): DesignBlockId;
+    createBlur(type: BlurType): DesignBlockId;
     /**
      * Checks whether the block supports blur.
      * @param id - The block to query.
@@ -2436,47 +2447,26 @@ export declare interface BlockEvent {
     type: 'Created' | 'Updated' | 'Destroyed';
 }
 
-/**
- * The block type IDs for all blocks types in the Creative Engine. Those are the types that can be
- * passed to `cesdk.engine.block.findByType(type)` for example.
- * @public
- */
-export declare type BlockTypes = BlockTypesShorthand | BlockTypesLonghand;
-
-/**
- * The longhand block type IDs for all blocks types in the Creative Engine. Those are the Types returned by the
- * engine when calling `cesdk.engine.block.getType(blockId)` for example.
- * @public
- */
-export declare type BlockTypesLonghand = DesignBlockTypesLonghand | ShapeTypesLonghand | FillTypesLonghand | EffectTypesLonghand | BlurTypesLonghand;
-
-/**
- * The shorthand block type IDs for all blocks types in the Creative Engine. Those are the types that can be
- * passed to `cesdk.engine.block.findByType(type)` for example.
- * @public
- */
-export declare type BlockTypesShorthand = DesignBlockTypesShorthand | `shape/${ShapeTypesShorthand}` | `fill/${FillTypesShorthand}` | `effect/${EffectTypesShorthand}` | `blur/${BlurTypesShorthand}`;
-
 /**
  * The block type IDs for the blur blocks. These are the IDs used to create new blurs
  * using `cesdk.engine.editor.createBlur(id)`.
  * @public
  */
-export declare type BlurTypes = BlurTypesShorthand | BlurTypesLonghand;
+export declare type BlurType = BlurTypeShorthand | BlurTypeLonghand;
 
 /**
  * The longhand block type IDs for the blur blocks. These are the IDs used to create new blurs
  * using `cesdk.engine.editor.createBlur(id)`.
  * @public
  */
-export declare type BlurTypesLonghand = `//ly.img.ubq/blur/${BlurTypesShorthand}`;
+export declare type BlurTypeLonghand = `//ly.img.ubq/blur/${BlurTypeShorthand}`;
 
 /**
  * The shorthand block type IDs for the blur blocks. These are the IDs used to create new blurs
  * using `cesdk.engine.editor.createBlur(id)`.
  * @public
  */
-export declare type BlurTypesShorthand = 'uniform' | 'linear' | 'mirrored' | 'radial';
+export declare type BlurTypeShorthand = 'uniform' | 'linear' | 'mirrored' | 'radial';
 
 /** @public */
 declare type Callbacks = {
@@ -2591,7 +2581,7 @@ export declare interface CompleteAssetResult extends AssetResult {
 declare namespace ConfigTypes {
     export {
         _RequiredConfiguration as Configuration,
-        _RequiredCreateConfiguratioan as CreateConfiguration,
+        _RequiredCreateConfiguration as CreateConfiguration,
         Theme,
         Scale,
         I18n,
@@ -2632,7 +2622,7 @@ export declare type ContentFillMode = 'Crop' | 'Cover' | 'Contain';
 /**
  * @public
  */
-export declare type CreateConfiguration = Partial<_RequiredCreateConfiguratioan>;
+export declare type CreateConfiguration = Partial<_RequiredCreateConfiguration>;
 
 /**
  * @public
@@ -2651,11 +2641,11 @@ declare class CreativeEditorSDK {
      * - `'ly.img.filter.duotone'` - Color 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'.
+     * `base_url` defaults to 'https://cdn.img.ly/assets/v2'.
      * 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 baseURL - The source of the asset definitions, must be absolute. Defaults to `'https://cdn.img.ly/assets/v2'`.
      * @param excludeAssetSourceIds - A list of IDs, that will be ignored during load.
      */
     addDefaultAssetSources({ baseURL, excludeAssetSourceIds }?: {
@@ -2887,6 +2877,17 @@ export declare class CreativeEngine {
      */
     unstable_setVideoExportInactivityTimeout(timeout: number): void;
 
+    /**
+     * Install the mousewheel event handler for the CreativeEngine on a different
+     * element than the canvas.
+     *
+     * This can be useful if you are rendering HTML elements on top of the canvas
+     * and want to scroll the canvas when the mouse is over those elements.
+     *
+     * @returns A function that removes the event handler from the target again
+     *          and adds it back to the canvas.
+     */
+    setWheelEventTarget(target: HTMLElement): () => void;
     get element(): HTMLCreativeEngineCanvasElement | undefined;
     /**
      * Dispose the engine.
@@ -2914,12 +2915,12 @@ export declare class CreativeEngine {
      * - `'ly.img.filter.duotone'` - Color 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'.
+     * `base_url` defaults to 'https://cdn.img.ly/assets/v2'.
      * 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'`. */
+        /** The source of the asset definitions, must be absolute. Defaults to `'https://cdn.img.ly/assets/v2'`. */
         baseURL?: string;
         /** A list of IDs, that will be ignored during load. */
         excludeAssetSourceIds?: DefaultAssetSourceId[];
@@ -2938,7 +2939,7 @@ export declare class CreativeEngine {
      * - `'ly.img.video.upload'` - Demo source to upload video assets
      */
     addDemoAssetSources({ baseURL, excludeAssetSourceIds, sceneMode, withUploadAssetSources }?: {
-        /** The source of the demo asset definitions, must be absolute. Defaults to `'https://cdn.img.ly/assets/demo/v1'`. */
+        /** The source of the demo asset definitions, must be absolute. Defaults to `'https://cdn.img.ly/assets/demo/v2'`. */
         baseURL?: string;
         /** A list of IDs, that will be ignored during load */
         excludeAssetSourceIds?: DemoAssetSourceId[];
@@ -2952,6 +2953,8 @@ export declare class CreativeEngine {
 
 }
 
+declare type CustomPanelMountFunction = (domElement: HTMLDivElement) => PanelDisposer;
+
 /**
  * @public
  */
@@ -2976,7 +2979,7 @@ export declare type _DeepPartial<T> = {
 /**
  * @public
  */
-declare type DefaultAssetSourceId = 'ly.img.sticker' | 'ly.img.vectorpath' | 'ly.img.filter.lut' | 'ly.img.filter.duotone' | 'ly.img.colors.defaultPalette';
+declare type DefaultAssetSourceId = 'ly.img.sticker' | 'ly.img.vectorpath' | 'ly.img.colors.defaultPalette' | 'ly.img.filter.lut' | 'ly.img.filter.duotone' | 'ly.img.effect' | 'ly.img.blur';
 
 /**
  * @public
@@ -2989,57 +2992,26 @@ declare type DemoAssetSourceId = 'ly.img.template' | 'ly.img.image.upload' | 'ly
  */
 export declare type DesignBlockId = number;
 
-/**
- * @public
- * @deprecated The DesignBlockType enum is deprecated and replaced with string literals. See `BlockTypes`, `ShapeTypes`, and `FillTypes`.
- */
-export declare enum DesignBlockType {
-    Scene = "//ly.img.ubq/scene",
-    Stack = "//ly.img.ubq/stack",
-    Camera = "//ly.img.ubq/camera",
-    Page = "//ly.img.ubq/page",
-    Image = "//ly.img.ubq/image",
-    Graphic = "//ly.img.ubq/graphic",
-    Video = "//ly.img.ubq/video",
-    VideoFill = "//ly.img.ubq/fill/video",
-    ImageFill = "//ly.img.ubq/fill/image",
-    Audio = "//ly.img.ubq/audio",
-    Text = "//ly.img.ubq/text",
-    Sticker = "//ly.img.ubq/sticker",
-    VectorPath = "//ly.img.ubq/vector_path",
-    RectShape = "//ly.img.ubq/shapes/rect",
-    LineShape = "//ly.img.ubq/shapes/line",
-    StarShape = "//ly.img.ubq/shapes/star",
-    PolygonShape = "//ly.img.ubq/shapes/polygon",
-    EllipseShape = "//ly.img.ubq/shapes/ellipse",
-    Group = "//ly.img.ubq/group",
-    Cutout = "//ly.img.ubq/cutout",
-    ColorFill = "//ly.img.ubq/fill/color",
-    LinearGradientFill = "//ly.img.ubq/fill/gradient/linear",
-    RadialGradientFill = "//ly.img.ubq/fill/gradient/radial",
-    ConicalGradientFill = "//ly.img.ubq/fill/gradient/conical"
-}
-
 /**
  * The block type IDs for the top-level design blocks. These are the IDs used to create new blocks
  * using `cesdk.engine.editor.cerate(id)`.
  * @public
  */
-export declare type DesignBlockTypes = DesignBlockTypesShorthand | DesignBlockTypesLonghand;
+export declare type DesignBlockType = DesignBlockTypeShorthand | DesignBlockTypeLonghand;
 
 /**
  * The longhand block type IDs for the top-level design blocks. These are the IDs used to create new blocks
  * using `cesdk.engine.editor.cerate(id)`.
  * @public
  */
-export declare type DesignBlockTypesLonghand = `//ly.img.ubq/${DesignBlockTypesShorthand}`;
+export declare type DesignBlockTypeLonghand = `//ly.img.ubq/${DesignBlockTypeShorthand}`;
 
 /**
  * The shorthand block type IDs for the top-level design blocks. These are the IDs used to create new blocks
  * using `cesdk.engine.editor.cerate(id)`.
  * @public
  */
-export declare type DesignBlockTypesShorthand = 'scene' | 'stack' | 'camera' | 'page' | 'graphic' | 'audio' | 'text' | 'group' | 'cutout' | LegacyDesignBlockTypesShorthand;
+export declare type DesignBlockTypeShorthand = 'scene' | 'stack' | 'camera' | 'page' | 'graphic' | 'audio' | 'text' | 'group' | 'cutout';
 
 /**
  * The unit type in which the page values (size, distances, etc.) are defined.
@@ -3060,6 +3032,8 @@ declare interface DockGroup {
 export declare class EditorAPI {
     #private;
 
+
+
     /**
      * Subscribe to changes to the editor state.
      * @param callback - This function is called at the end of the engine update, if the editor state has changed.
@@ -3165,12 +3139,14 @@ export declare class EditorAPI {
      * @throws An error, if the keypath is invalid.
      */
     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: SettingsBool): boolean;
+
     /**
      * Set an integer setting.
      * @param keypath - The settings keypath.
@@ -3388,21 +3364,21 @@ export declare class EditorAPI {
  * using `cesdk.engine.editor.createEffect(id)`.
  * @public
  */
-export declare type EffectTypes = EffectTypesShorthand | EffectTypesLonghand;
+export declare type EffectType = EffectTypeShorthand | EffectTypeLonghand;
 
 /**
  * The longhand block type IDs for the effect blocks. These are the IDs used to create new effects
  * using `cesdk.engine.editor.createEffect(id)`.
  * @public
  */
-export declare type EffectTypesLonghand = `//ly.img.ubq/effect/${EffectTypesShorthand}`;
+export declare type EffectTypeLonghand = `//ly.img.ubq/effect/${EffectTypeShorthand}`;
 
 /**
  * The shorthand block type IDs for the effect blocks. These are the IDs used to create new effects
  * using `cesdk.engine.editor.createEffect(id)`.
  * @public
  */
-export declare type EffectTypesShorthand = 'pixelize' | 'radial_pixel' | 'cross_cut' | 'liquid' | 'outliner' | 'dot_pattern' | 'posterize' | 'tv_glitch' | 'half_tone' | 'linocut' | 'shifter' | 'mirror' | 'glow' | 'vignette' | 'tilt_shift' | 'extrude_blur' | 'sharpie' | 'lut_filter' | 'duotone_filter' | 'adjustments';
+export declare type EffectTypeShorthand = 'adjustments' | 'cross_cut' | 'dot_pattern' | 'duotone_filter' | 'extrude_blur' | 'glow' | 'half_tone' | 'linocut' | 'liquid' | 'lut_filter' | 'mirror' | 'outliner' | 'pixelize' | 'posterize' | 'radial_pixel' | 'sharpie' | 'shifter' | 'tilt_shift' | 'tv_glitch' | 'vignette';
 
 /**
  * @deprecated This namespace is not used anymore. Please refer to the
@@ -3621,7 +3597,8 @@ export declare namespace _EngineConfigTypes {
 /** @public */
 export declare interface _EngineConfiguration {
     baseURL: string;
-    license?: string;
+    license: string;
+    userId?: string;
     core: {
         baseURL: string;
     };
@@ -3790,21 +3767,21 @@ declare interface ExportVideoOptions {
  * using `cesdk.engine.editor.createFill(id)`.
  * @public
  */
-export declare type FillTypes = FillTypesShorthand | FillTypesLonghand;
+export declare type FillType = FillTypeShorthand | FillTypeLonghand;
 
 /**
  * The longhand block type IDs for the fill blocks. These are the IDs used to create new fills
  * using `cesdk.engine.editor.createFill(id)`.
  * @public
  */
-export declare type FillTypesLonghand = `//ly.img.ubq/fill/${FillTypesShorthand}`;
+export declare type FillTypeLonghand = `//ly.img.ubq/fill/${FillTypeShorthand}`;
 
 /**
  * The shorthand block type IDs for the fill blocks. These are the IDs used to create new fills
  * using `cesdk.engine.editor.createFill(id)`.
  * @public
  */
-export declare type FillTypesShorthand = 'video' | 'image' | 'color' | 'gradient/linear' | 'gradient/radial' | 'gradient/conical' | 'pixelStream';
+export declare type FillTypeShorthand = 'color' | 'gradient/linear' | 'gradient/radial' | 'gradient/conical' | 'image' | 'video' | 'pixelStream';
 
 /** @public */
 declare interface FindAssetsQuery {
@@ -3921,14 +3898,6 @@ export declare interface HTMLCreativeEngineCanvasElement extends HTMLElement {
  */
 declare type I18n = Record<string, Translations>;
 
-/**
- * The shorthand block type IDs for legacy design blocks.
- * @public
- * @deprecated These design block IDs are deprecated, you should migrate to using the new graphic design block
- * instead by setting `cesdk.engine.editor.setSettingBool('features/unifiedBlocksEnabled', true)`
- */
-export declare type LegacyDesignBlockTypesShorthand = 'image' | 'video' | 'sticker' | 'vector_path' | 'shapes/rect' | 'shapes/line' | 'shapes/star' | 'shapes/polygon' | 'shapes/ellipse';
-
 /**
  * e.g. `en`, `de`, etc.
  * @public
@@ -3974,6 +3943,27 @@ declare enum NavigationPosition {
     Bottom = "bottom"
 }
 
+/**
+ * The block type IDs for all blocks types in the Creative Engine. Those are the types that can be
+ * passed to `cesdk.engine.block.findByType(type)` for example.
+ * @public
+ */
+export declare type ObjectType = ObjectTypeShorthand | ObjectTypeLonghand;
+
+/**
+ * The longhand block type IDs for all blocks types in the Creative Engine. Those are the Types returned by the
+ * engine when calling `cesdk.engine.block.getType(blockId)` for example.
+ * @public
+ */
+export declare type ObjectTypeLonghand = DesignBlockTypeLonghand | ShapeTypeLonghand | FillTypeLonghand | EffectTypeLonghand | BlurTypeLonghand;
+
+/**
+ * The shorthand block type IDs for all blocks types in the Creative Engine. Those are the types that can be
+ * passed to `cesdk.engine.block.findByType(type)` for example.
+ * @public
+ */
+export declare type ObjectTypeShorthand = DesignBlockTypeShorthand | `shape/${ShapeTypeShorthand}` | `fill/${FillTypeShorthand}` | `effect/${EffectTypeShorthand}` | `blur/${BlurTypeShorthand}`;
+
 /**
  * A simplified placeholder type for `OffscreenCanvas`, to avoid a dependency on `@types/offscreencanvas`
  * @public
@@ -4014,6 +4004,8 @@ export declare type PageFormatDefinition = {
  */
 export declare type PaletteColor = HexColorString | RGBColor | RGBAColor | SpotColor;
 
+declare type PanelDisposer = () => void;
+
 /** @public */
 declare enum PanelPosition {
     Left = "left",
@@ -4153,7 +4145,7 @@ export declare interface _RequiredConfiguration extends Omit<_EngineConfiguratio
  * Once the Config migration has been live for long enough, we can remove the
  * deprecated options and merge the types back together into a single type.
  */
-export declare interface _RequiredCreateConfiguratioan extends Omit<_RequiredConfiguration, 'initialSceneMode' | 'initialSceneString' | 'initialSceneURL' | 'initialImageURL' | 'page' | 'scene' | 'assetSources' | 'variables' | 'presets' | 'callbacks'> {
+export declare interface _RequiredCreateConfiguration extends Omit<_RequiredConfiguration, 'initialSceneMode' | 'initialSceneString' | 'initialSceneURL' | 'initialImageURL' | 'page' | 'scene' | 'assetSources' | 'variables' | 'presets' | 'callbacks'> {
     callbacks: Callbacks;
     presets: Pick<_RequiredConfiguration['presets'], 'typefaces'>;
 }
@@ -4315,7 +4307,7 @@ export declare class SceneAPI {
      * @param type - The type to search for.
      * @returns A list of block ids sorted by distance to view port center.
      */
-    findNearestToViewPortCenterByType(type: DesignBlockTypes): DesignBlockId[];
+    findNearestToViewPortCenterByType(type: DesignBlockType): DesignBlockId[];
     /**
      * Find all blocks with the given kind sorted by the distance to view port center.
      * @param kind - The kind to search for.
@@ -4472,11 +4464,11 @@ 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' | 'page/dimOutOfPageAreas' | 'page/title/show' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'showBuildVersion' | 'touch/dragStartCanSelect' | 'touch/singlePointPanning' | ArbitraryString;
+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';
 
 /** @public
  */
-declare type SettingsColor = 'clearColor' | 'errorStateColor' | 'highlightColor' | 'page/title/color' | 'placeholderHighlightColor' | 'progressColor' | ArbitraryString;
+declare type SettingsColor = 'clearColor' | 'errorStateColor' | 'highlightColor' | 'page/title/color' | 'placeholderHighlightColor' | 'progressColor';
 
 /** @public
  * @deprecated Use SettingsColor instead.
@@ -4489,14 +4481,13 @@ export declare type SettingsEnum = {
     doubleClickSelectionMode: 'Direct' | 'Hierarchical';
     'touch/pinchAction': 'None' | 'Zoom' | 'Scale';
     'touch/rotateAction': 'None' | 'Rotate';
-    [key: ArbitraryString]: string;
 };
 
 /** @public */
-export declare type SettingsFloat = 'positionSnappingThreshold' | ArbitraryString;
+export declare type SettingsFloat = 'positionSnappingThreshold';
 
 /** @public */
-export declare type SettingsString = 'basePath' | 'license' | 'page/title/fontFileUri' | ArbitraryString;
+export declare type SettingsString = 'basePath' | 'license' | 'page/title/fontFileUri' | 'defaultEmojiFontFileUri';
 
 /** @public */
 export declare type SettingType = 'Bool' | 'Int' | 'Float' | 'String' | 'Color' | 'Enum';
@@ -4506,21 +4497,21 @@ export declare type SettingType = 'Bool' | 'Int' | 'Float' | 'String' | 'Color'
  * using `cesdk.engine.editor.createShape(id)`.
  * @public
  */
-export declare type ShapeTypes = ShapeTypesShorthand | ShapeTypesLonghand;
+export declare type ShapeType = ShapeTypeShorthand | ShapeTypeLonghand;
 
 /**
  * The longhand block type IDs for the blocks. These are the IDs used to create new shapes
  * using `cesdk.engine.editor.createShape(id)`.
  * @public
  */
-export declare type ShapeTypesLonghand = `//ly.img.ubq/shape/${ShapeTypesShorthand}`;
+export declare type ShapeTypeLonghand = `//ly.img.ubq/shape/${ShapeTypeShorthand}`;
 
 /**
  * The shorthand block type IDs for the shape blocks. These are the IDs used to create new shapes
  * using `cesdk.engine.editor.createShape(id)`.
  * @public
  */
-export declare type ShapeTypesShorthand = 'vector_path' | 'rect' | 'line' | 'star' | 'polygon' | 'ellipse';
+export declare type ShapeTypeShorthand = 'rect' | 'line' | 'ellipse' | 'polygon' | 'star' | 'vector_path';
 
 /**
  * - Absolute: Size in absolute design units.
@@ -4712,6 +4703,17 @@ declare class UserInterfaceAPI {
      * @param panelId - The id of a panel that might be open
      */
     isPanelOpen(panelId: string): boolean;
+    /**
+     * Registeres a custom panel to hook into a dom element and render any
+     * custom UI code.
+     *
+     * The `onMount` function will be called if the panel is opened (e.g. via the `openPanel` API).
+     * The returned function of the `onMount` call will be called once the panels closes.
+     *
+     * Please be aware that this is experimental right now. This API can change or
+     * be replaced or even removed completely in future versions.
+     */
+    unstable_registerCustomPanel(panelId: string, onMount: CustomPanelMountFunction): void;
 }
 
 /** @public */
@@ -4864,14 +4866,6 @@ declare interface UserInterfaceInspectorBlocks {
     opacity?: UserInterfaceElement | boolean;
     transform?: UserInterfaceElement | boolean;
     trim?: UserInterfaceElement | boolean;
-    '//ly.img.ubq/image'?: UserInterfaceInspectorBlockImage;
-    '//ly.img.ubq/fill/video'?: UserInterfaceInspectorBlockVideoFill;
-    '//ly.img.ubq/shapes/rect'?: UserInterfaceInspectorBlockRectShape;
-    '//ly.img.ubq/vector_path'?: UserInterfaceInspectorBlockShape;
-    '//ly.img.ubq/shapes/line'?: UserInterfaceInspectorBlockShape;
-    '//ly.img.ubq/shapes/star'?: UserInterfaceInspectorBlockShape;
-    '//ly.img.ubq/shapes/polygon'?: UserInterfaceInspectorBlockShape;
-    '//ly.img.ubq/shapes/ellipse'?: UserInterfaceInspectorBlockShape;
     '//ly.img.ubq/text'?: UserInterfaceInspectorBlockText;
     '//ly.img.ubq/page'?: UserInterfaceInspectorBlockPage;
     '//ly.img.ubq/graphic'?: UserInterfaceInspectorBlockGraphic;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cesdk/cesdk-js",
-  "version": "1.18.1-rc.1",
+  "version": "1.19.0-rc.0",
   "main": "./cesdk.umd.js",
   "types": "./index.d.ts",
   "homepage": "https://www.img.ly",