@cesdk/engine 1.18.1-rc.1 → 1.18.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/index.d.ts CHANGED
@@ -463,19 +463,19 @@ export declare class BlockAPI {
463
463
  * @param type - The type of the block that shall be created.
464
464
  * @returns The created blocks handle.
465
465
  */
466
- create(type: DesignBlockTypes): DesignBlockId;
466
+ create(type: DesignBlockType): DesignBlockId;
467
467
  /**
468
468
  * Create a new fill, fails if type is unknown.
469
469
  * @param type - The type of the fill object that shall be created.
470
470
  * @returns The created fill's handle.
471
471
  */
472
- createFill(type: FillTypes): DesignBlockId;
472
+ createFill(type: string): DesignBlockId;
473
473
  /**
474
474
  * Get the type of the given block, fails if the block is invalid.
475
475
  * @param id - The block to query.
476
476
  * @returns The blocks type.
477
477
  */
478
- getType(id: DesignBlockId): BlockTypesLonghand;
478
+ getType(id: DesignBlockId): DesignBlockType;
479
479
  /**
480
480
  * Get the kind of the given block, fails if the block is invalid.
481
481
  * @param id - The block to query.
@@ -580,7 +580,7 @@ export declare class BlockAPI {
580
580
  * @param type - The type to search for.
581
581
  * @returns A list of block ids.
582
582
  */
583
- findByType(type: BlockTypes): DesignBlockId[];
583
+ findByType(type: DesignBlockType): DesignBlockId[];
584
584
  /**
585
585
  * Finds all blocks with the given kind.
586
586
  * @param kind - The kind to search for.
@@ -602,7 +602,7 @@ export declare class BlockAPI {
602
602
  * @param type - The type of the shape object that shall be created.
603
603
  * @returns The created shape's handle.
604
604
  */
605
- createShape(type: ShapeTypes): DesignBlockId;
605
+ createShape(type: string): DesignBlockId;
606
606
  /**
607
607
  * Query if the given block has a shape property.
608
608
  * @param id - The block to query.
@@ -1399,7 +1399,7 @@ export declare class BlockAPI {
1399
1399
  * @param type - The type id of the effect.
1400
1400
  * @returns The created effects handle.
1401
1401
  */
1402
- createEffect(type: EffectTypes): DesignBlockId;
1402
+ createEffect(type: string): DesignBlockId;
1403
1403
  /**
1404
1404
  * Queries whether the block supports effects.
1405
1405
  * @param id - The block to query.
@@ -1456,7 +1456,7 @@ export declare class BlockAPI {
1456
1456
  * @param type - The type id of the block.
1457
1457
  * @returns The handle of the newly created blur.
1458
1458
  */
1459
- createBlur(type: BlurTypes): DesignBlockId;
1459
+ createBlur(type: string): DesignBlockId;
1460
1460
  /**
1461
1461
  * Checks whether the block supports blur.
1462
1462
  * @param id - The block to query.
@@ -2263,27 +2263,6 @@ export declare interface BlockEvent {
2263
2263
  type: 'Created' | 'Updated' | 'Destroyed';
2264
2264
  }
2265
2265
 
2266
- /**
2267
- * The block type IDs for all blocks types in the Creative Engine. Those are the types that can be
2268
- * passed to `cesdk.engine.block.findByType(type)` for example.
2269
- * @public
2270
- */
2271
- export declare type BlockTypes = BlockTypesShorthand | BlockTypesLonghand;
2272
-
2273
- /**
2274
- * The longhand block type IDs for all blocks types in the Creative Engine. Those are the Types returned by the
2275
- * engine when calling `cesdk.engine.block.getType(blockId)` for example.
2276
- * @public
2277
- */
2278
- export declare type BlockTypesLonghand = DesignBlockTypesLonghand | ShapeTypesLonghand | FillTypesLonghand | EffectTypesLonghand | BlurTypesLonghand;
2279
-
2280
- /**
2281
- * The shorthand block type IDs for all blocks types in the Creative Engine. Those are the types that can be
2282
- * passed to `cesdk.engine.block.findByType(type)` for example.
2283
- * @public
2284
- */
2285
- export declare type BlockTypesShorthand = DesignBlockTypesShorthand | `shape/${ShapeTypesShorthand}` | `fill/${FillTypesShorthand}` | `effect/${EffectTypesShorthand}` | `blur/${BlurTypesShorthand}`;
2286
-
2287
2266
  /**
2288
2267
  * Dispatched on the engine canvas when the text input has been blurred.
2289
2268
  * Call `preventDefault()` to disallow this and refocus the engine text input.
@@ -2297,27 +2276,6 @@ export declare interface BlurEvent extends CustomEvent<EventTarget | null> {
2297
2276
  preventDefault(): void;
2298
2277
  }
2299
2278
 
2300
- /**
2301
- * The block type IDs for the blur blocks. These are the IDs used to create new blurs
2302
- * using `cesdk.engine.editor.createBlur(id)`.
2303
- * @public
2304
- */
2305
- export declare type BlurTypes = BlurTypesShorthand | BlurTypesLonghand;
2306
-
2307
- /**
2308
- * The longhand block type IDs for the blur blocks. These are the IDs used to create new blurs
2309
- * using `cesdk.engine.editor.createBlur(id)`.
2310
- * @public
2311
- */
2312
- export declare type BlurTypesLonghand = `//ly.img.ubq/blur/${BlurTypesShorthand}`;
2313
-
2314
- /**
2315
- * The shorthand block type IDs for the blur blocks. These are the IDs used to create new blurs
2316
- * using `cesdk.engine.editor.createBlur(id)`.
2317
- * @public
2318
- */
2319
- export declare type BlurTypesShorthand = 'uniform' | 'linear' | 'mirrored' | 'radial';
2320
-
2321
2279
  declare type CameraSettings = {
2322
2280
  /** Horizontal resolution in physical pixels */
2323
2281
  width: number;
@@ -2861,7 +2819,6 @@ export declare type DesignBlockId = number;
2861
2819
 
2862
2820
  /**
2863
2821
  * @public
2864
- * @deprecated The DesignBlockType enum is deprecated and replaced with string literals. See `BlockTypes`, `ShapeTypes`, and `FillTypes`.
2865
2822
  */
2866
2823
  export declare enum DesignBlockType {
2867
2824
  Scene = "//ly.img.ubq/scene",
@@ -2890,27 +2847,6 @@ export declare enum DesignBlockType {
2890
2847
  ConicalGradientFill = "//ly.img.ubq/fill/gradient/conical"
2891
2848
  }
2892
2849
 
2893
- /**
2894
- * The block type IDs for the top-level design blocks. These are the IDs used to create new blocks
2895
- * using `cesdk.engine.editor.cerate(id)`.
2896
- * @public
2897
- */
2898
- export declare type DesignBlockTypes = DesignBlockTypesShorthand | DesignBlockTypesLonghand;
2899
-
2900
- /**
2901
- * The longhand block type IDs for the top-level design blocks. These are the IDs used to create new blocks
2902
- * using `cesdk.engine.editor.cerate(id)`.
2903
- * @public
2904
- */
2905
- export declare type DesignBlockTypesLonghand = `//ly.img.ubq/${DesignBlockTypesShorthand}`;
2906
-
2907
- /**
2908
- * The shorthand block type IDs for the top-level design blocks. These are the IDs used to create new blocks
2909
- * using `cesdk.engine.editor.cerate(id)`.
2910
- * @public
2911
- */
2912
- export declare type DesignBlockTypesShorthand = 'scene' | 'stack' | 'camera' | 'page' | 'graphic' | 'audio' | 'text' | 'group' | 'cutout' | LegacyDesignBlockTypesShorthand;
2913
-
2914
2850
  /**
2915
2851
  * The unit type in which the page values (size, distances, etc.) are defined.
2916
2852
  * @public
@@ -3246,27 +3182,6 @@ export declare class EditorAPI {
3246
3182
  convertColorToColorSpace(color: Color, colorSpace: ColorSpace): never;
3247
3183
  }
3248
3184
 
3249
- /**
3250
- * The block type IDs for the effect blocks. These are the IDs used to create new effects
3251
- * using `cesdk.engine.editor.createEffect(id)`.
3252
- * @public
3253
- */
3254
- export declare type EffectTypes = EffectTypesShorthand | EffectTypesLonghand;
3255
-
3256
- /**
3257
- * The longhand block type IDs for the effect blocks. These are the IDs used to create new effects
3258
- * using `cesdk.engine.editor.createEffect(id)`.
3259
- * @public
3260
- */
3261
- export declare type EffectTypesLonghand = `//ly.img.ubq/effect/${EffectTypesShorthand}`;
3262
-
3263
- /**
3264
- * The shorthand block type IDs for the effect blocks. These are the IDs used to create new effects
3265
- * using `cesdk.engine.editor.createEffect(id)`.
3266
- * @public
3267
- */
3268
- 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';
3269
-
3270
3185
  /**
3271
3186
  * @public
3272
3187
  */
@@ -3351,27 +3266,6 @@ declare interface ExportVideoOptions {
3351
3266
  targetHeight: number;
3352
3267
  }
3353
3268
 
3354
- /**
3355
- * The block type IDs for the fill blocks. These are the IDs used to create new fills
3356
- * using `cesdk.engine.editor.createFill(id)`.
3357
- * @public
3358
- */
3359
- export declare type FillTypes = FillTypesShorthand | FillTypesLonghand;
3360
-
3361
- /**
3362
- * The longhand block type IDs for the fill blocks. These are the IDs used to create new fills
3363
- * using `cesdk.engine.editor.createFill(id)`.
3364
- * @public
3365
- */
3366
- export declare type FillTypesLonghand = `//ly.img.ubq/fill/${FillTypesShorthand}`;
3367
-
3368
- /**
3369
- * The shorthand block type IDs for the fill blocks. These are the IDs used to create new fills
3370
- * using `cesdk.engine.editor.createFill(id)`.
3371
- * @public
3372
- */
3373
- export declare type FillTypesShorthand = 'video' | 'image' | 'color' | 'gradient/linear' | 'gradient/radial' | 'gradient/conical' | 'pixelStream';
3374
-
3375
3269
  /** @public */
3376
3270
  declare interface FindAssetsQuery {
3377
3271
  perPage: number;
@@ -3477,14 +3371,6 @@ export declare interface HTMLCreativeEngineCanvasElement extends HTMLElement {
3477
3371
  clear(): void;
3478
3372
  }
3479
3373
 
3480
- /**
3481
- * The shorthand block type IDs for legacy design blocks.
3482
- * @public
3483
- * @deprecated These design block IDs are deprecated, you should migrate to using the new graphic design block
3484
- * instead by setting `cesdk.engine.editor.setSettingBool('features/unifiedBlocksEnabled', true)`
3485
- */
3486
- export declare type LegacyDesignBlockTypesShorthand = 'image' | 'video' | 'sticker' | 'vector_path' | 'shapes/rect' | 'shapes/line' | 'shapes/star' | 'shapes/polygon' | 'shapes/ellipse';
3487
-
3488
3374
  /**
3489
3375
  * e.g. `en`, `de`, etc.
3490
3376
  * @public
@@ -3775,7 +3661,7 @@ export declare class SceneAPI {
3775
3661
  * @param type - The type to search for.
3776
3662
  * @returns A list of block ids sorted by distance to view port center.
3777
3663
  */
3778
- findNearestToViewPortCenterByType(type: DesignBlockTypes): DesignBlockId[];
3664
+ findNearestToViewPortCenterByType(type: DesignBlockType): DesignBlockId[];
3779
3665
  /**
3780
3666
  * Find all blocks with the given kind sorted by the distance to view port center.
3781
3667
  * @param kind - The kind to search for.
@@ -3961,27 +3847,6 @@ export declare type SettingsString = 'basePath' | 'license' | 'page/title/fontFi
3961
3847
  /** @public */
3962
3848
  export declare type SettingType = 'Bool' | 'Int' | 'Float' | 'String' | 'Color' | 'Enum';
3963
3849
 
3964
- /**
3965
- * The block type IDs for the shape blocks. These are the IDs used to create new shapes
3966
- * using `cesdk.engine.editor.createShape(id)`.
3967
- * @public
3968
- */
3969
- export declare type ShapeTypes = ShapeTypesShorthand | ShapeTypesLonghand;
3970
-
3971
- /**
3972
- * The longhand block type IDs for the blocks. These are the IDs used to create new shapes
3973
- * using `cesdk.engine.editor.createShape(id)`.
3974
- * @public
3975
- */
3976
- export declare type ShapeTypesLonghand = `//ly.img.ubq/shape/${ShapeTypesShorthand}`;
3977
-
3978
- /**
3979
- * The shorthand block type IDs for the shape blocks. These are the IDs used to create new shapes
3980
- * using `cesdk.engine.editor.createShape(id)`.
3981
- * @public
3982
- */
3983
- export declare type ShapeTypesShorthand = 'vector_path' | 'rect' | 'line' | 'star' | 'polygon' | 'ellipse';
3984
-
3985
3850
  /** @public */
3986
3851
  export declare interface Size2 {
3987
3852
  width: number;