@cesdk/node 1.61.0-nightly.20250918 → 1.61.0-nightly.20250921

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
@@ -943,7 +943,6 @@ export declare interface AssetResult extends Asset {
943
943
  * The `AssetResultCredits` interface provides a set of properties that describe the credits
944
944
  * for an asset result, including the name and URL of the credits.
945
945
  *
946
- * @categoryDescription AssetResultCredits
947
946
  * Methods for working with the credits of asset results.
948
947
  *
949
948
  * @public
@@ -959,7 +958,6 @@ declare interface AssetResultCredits {
959
958
  * The `AssetResultLicense` interface provides a set of properties that describe the license
960
959
  * for an asset result, including the name and URL of the license.
961
960
  *
962
- * @categoryDescription AssetResultLicense
963
961
  * Methods for working with the license of asset results.
964
962
  *
965
963
  * @public
@@ -4742,7 +4740,7 @@ export declare class BlockAPI {
4742
4740
  *
4743
4741
  * @category Block Video
4744
4742
  * @param id - The block whose trim should be updated.
4745
- * @param offset - The new trim offset in seconds.
4743
+ * @param offset - The new trim offset, measured in timeline seconds (scaled by playback rate).
4746
4744
  */
4747
4745
  setTrimOffset(id: DesignBlockId, offset: number): void;
4748
4746
  /**
@@ -4945,6 +4943,23 @@ export declare class BlockAPI {
4945
4943
  * @returns The volume, ranging from 0.0 to 1.0.
4946
4944
  */
4947
4945
  getVolume(id: DesignBlockId): number;
4946
+ /**
4947
+ * Sets the playback speed multiplier of a block that supports playback control.
4948
+ * Note: This also adjusts the trim and duration of the block.
4949
+ *
4950
+ * @category Block Video
4951
+ * @param id - The block or video fill to update.
4952
+ * @param speed - The desired playback speed multiplier with a range of [0.25, 3.0].
4953
+ */
4954
+ setPlaybackSpeed(id: DesignBlockId, speed: number): void;
4955
+ /**
4956
+ * Gets the playback speed multiplier of a block that supports playback control.
4957
+ *
4958
+ * @category Block Video
4959
+ * @param id - The block to query.
4960
+ * @returns The playback speed multiplier.
4961
+ */
4962
+ getPlaybackSpeed(id: DesignBlockId): number;
4948
4963
  /**
4949
4964
  * Forces the loading of a block's audio/video resource.
4950
4965
  *
@@ -6671,23 +6686,6 @@ export declare class EventAPI {
6671
6686
  subscribe: (blocks: DesignBlockId[], callback: (events: BlockEvent[]) => void) => (() => void);
6672
6687
  }
6673
6688
 
6674
- /**
6675
- * Specifies options for exporting audio design blocks to various formats.
6676
- *
6677
- * The `ExportAudioOptions` interface provides a set of properties that control the
6678
- * behavior and quality of the exported audio content. These options include settings
6679
- * for sample rate and number of channels.
6680
- *
6681
- * @categoryDescription Export Audio Options
6682
- * Methods for configuring export settings for audio design blocks.
6683
- *
6684
- * @public
6685
- */
6686
- declare interface ExportAudioOptions {
6687
- sampleRate: number;
6688
- numberOfChannels: number;
6689
- }
6690
-
6691
6689
  /**
6692
6690
  * Represents the options for exporting a design block.
6693
6691
  *
@@ -6776,52 +6774,6 @@ export declare type ExportOptions = {
6776
6774
  abortSignal?: AbortSignal;
6777
6775
  };
6778
6776
 
6779
- /**
6780
- * Specifies options for exporting design blocks to various formats.
6781
- *
6782
- * The `ExportOptions` interface provides a set of properties that control the
6783
- * behavior and quality of the exported content. These options include settings
6784
- * for JPEG, WebP, PNG, and PDF exports, as well as options for resizing and
6785
- * adding underlayers.
6786
- *
6787
- * @public
6788
- */
6789
- declare interface ExportOptions_2 {
6790
- jpegQuality: number;
6791
- webpQuality: number;
6792
- pngCompressionLevel: number;
6793
- useTargetSize: boolean;
6794
- targetWidth: number;
6795
- targetHeight: number;
6796
- exportPdfWithHighCompatibility: boolean;
6797
- exportPdfWithUnderlayer: boolean;
6798
- underlayerSpotColorName: string;
6799
- underlayerOffset: number;
6800
- }
6801
-
6802
- /**
6803
- * Specifies options for exporting video design blocks to various formats.
6804
- *
6805
- * The `ExportVideoOptions` interface provides a set of properties that control the
6806
- * behavior and quality of the exported video content. These options include settings
6807
- * for H.264 profile, level, framerate, video bitrate, audio bitrate, and resizing.
6808
- *
6809
- * @categoryDescription Export Video Options
6810
- * Methods for configuring export settings for video design blocks.
6811
- *
6812
- * @public
6813
- */
6814
- declare interface ExportVideoOptions {
6815
- h264Profile: number;
6816
- h264Level: number;
6817
- framerate: number;
6818
- videoBitrate: number;
6819
- audioBitrate: number;
6820
- useTargetSize: boolean;
6821
- targetWidth: number;
6822
- targetHeight: number;
6823
- }
6824
-
6825
6777
  /**
6826
6778
  * The block type IDs for the fill blocks. These are the IDs used to create new fills
6827
6779
  * using `cesdk.engine.block.createFill(id)`.
@@ -6852,7 +6804,6 @@ export declare type FillTypeShorthand = 'color' | 'gradient/linear' | 'gradient/
6852
6804
  * the groups, the excluded groups, the locale, the sorting order, the sort key, and whether to
6853
6805
  * sort active assets first.
6854
6806
  *
6855
- * @categoryDescription FindAssetsQuery
6856
6807
  * Methods for working with queries for finding assets.
6857
6808
  *
6858
6809
  * @public
@@ -6876,7 +6827,6 @@ declare interface FindAssetsQuery {
6876
6827
  * The `Flip` interface provides a set of properties that indicate whether the design block
6877
6828
  * is flipped horizontally or vertically.
6878
6829
  *
6879
- * @categoryDescription Flip
6880
6830
  * Methods for configuring the flip states of a design block.
6881
6831
  *
6882
6832
  * @public
@@ -7049,7 +6999,7 @@ export declare function isSpotColor(color: Color): color is SpotColor;
7049
6999
  * e.g. `en`, `de`, etc.
7050
7000
  * @public
7051
7001
  */
7052
- declare type Locale = string;
7002
+ export declare type Locale = string;
7053
7003
 
7054
7004
  /**
7055
7005
  * Represents a logger function.
@@ -8070,7 +8020,6 @@ export declare interface Settings {
8070
8020
  *
8071
8021
  * @deprecated Use keyof Settings or extract the boolean keys from Settings instead.
8072
8022
  * @public
8073
- * @category Boolean Settings
8074
8023
  */
8075
8024
  export declare type SettingsBool = {
8076
8025
  [K in keyof Settings]: Settings[K] extends boolean ? K : never;
@@ -8081,7 +8030,6 @@ export declare type SettingsBool = {
8081
8030
  *
8082
8031
  * @deprecated Use keyof Settings or extract the color keys from Settings instead.
8083
8032
  * @public
8084
- * @category Color Settings
8085
8033
  */
8086
8034
  export declare type SettingsColor = {
8087
8035
  [K in keyof Settings]: Settings[K] extends Color ? K : never;
@@ -8092,7 +8040,6 @@ export declare type SettingsColor = {
8092
8040
  *
8093
8041
  * @public
8094
8042
  * @deprecated Use SettingsColor instead.
8095
- * @category Color Settings
8096
8043
  */
8097
8044
  export declare type SettingsColorRGBA = SettingsColor;
8098
8045
 
@@ -8101,7 +8048,6 @@ export declare type SettingsColorRGBA = SettingsColor;
8101
8048
  *
8102
8049
  * @deprecated Use keyof Settings or extract the enum keys from Settings instead.
8103
8050
  * @public
8104
- * @category Enum Settings
8105
8051
  */
8106
8052
  export declare type SettingsEnum = Pick<Settings, 'doubleClickSelectionMode' | 'touch/pinchAction' | 'touch/rotateAction' | 'camera/clamping/overshootMode'>;
8107
8053
 
@@ -8110,7 +8056,6 @@ export declare type SettingsEnum = Pick<Settings, 'doubleClickSelectionMode' | '
8110
8056
  *
8111
8057
  * @deprecated Use keyof Settings or extract the float keys from Settings instead.
8112
8058
  * @public
8113
- * @category Float Settings
8114
8059
  */
8115
8060
  export declare type SettingsFloat = Exclude<{
8116
8061
  [K in keyof Settings]: Settings[K] extends number ? K : never;
@@ -8120,7 +8065,6 @@ export declare type SettingsFloat = Exclude<{
8120
8065
  * Represents the integer settings available in the editor.
8121
8066
  *
8122
8067
  * @public
8123
- * @category Integer Settings
8124
8068
  */
8125
8069
  export declare type SettingsInt = 'maxImageSize';
8126
8070
 
@@ -8129,7 +8073,6 @@ export declare type SettingsInt = 'maxImageSize';
8129
8073
  *
8130
8074
  * @deprecated Use keyof Settings or extract the string keys from Settings instead.
8131
8075
  * @public
8132
- * @category String Settings
8133
8076
  */
8134
8077
  export declare type SettingsString = Exclude<{
8135
8078
  [K in keyof Settings]: Settings[K] extends string ? K : never;
@@ -8238,23 +8181,6 @@ export declare type SplitOptions = {
8238
8181
  selectNewBlock?: boolean;
8239
8182
  };
8240
8183
 
8241
- /**
8242
- * Specifies options for configuring block split operations.
8243
- *
8244
- * The `SplitOptions` interface provides a set of properties that control the
8245
- * behavior of the block splitting operation.
8246
- *
8247
- * @categoryDescription Split Options
8248
- * Methods for configuring block split operations.
8249
- *
8250
- * @public
8251
- */
8252
- declare interface SplitOptions_2 {
8253
- attachToParent: boolean;
8254
- createParentTrackIfNeeded: boolean;
8255
- selectNewBlock: boolean;
8256
- }
8257
-
8258
8184
  /**
8259
8185
  * Represents a spot color value.
8260
8186
  *
@@ -8407,6 +8333,83 @@ export declare type TypefaceDefinition = {
8407
8333
  }[];
8408
8334
  };
8409
8335
 
8336
+ /**
8337
+ * Specifies options for exporting audio design blocks to various formats.
8338
+ *
8339
+ * The `UBQExportAudioOptions` interface provides a set of properties that control the
8340
+ * behavior and quality of the exported audio content. These options include settings
8341
+ * for sample rate and number of channels.
8342
+ *
8343
+ * Methods for configuring export settings for audio design blocks.
8344
+ *
8345
+ * @public
8346
+ */
8347
+ declare interface UBQExportAudioOptions {
8348
+ sampleRate: number;
8349
+ numberOfChannels: number;
8350
+ }
8351
+
8352
+ /**
8353
+ * Specifies options for exporting design blocks to various formats.
8354
+ *
8355
+ * The `UBQExportOptions` interface provides a set of properties that control the
8356
+ * behavior and quality of the exported content. These options include settings
8357
+ * for JPEG, WebP, PNG, and PDF exports, as well as options for resizing and
8358
+ * adding underlayers.
8359
+ *
8360
+ * @public
8361
+ */
8362
+ declare interface UBQExportOptions {
8363
+ jpegQuality: number;
8364
+ webpQuality: number;
8365
+ pngCompressionLevel: number;
8366
+ useTargetSize: boolean;
8367
+ targetWidth: number;
8368
+ targetHeight: number;
8369
+ exportPdfWithHighCompatibility: boolean;
8370
+ exportPdfWithUnderlayer: boolean;
8371
+ underlayerSpotColorName: string;
8372
+ underlayerOffset: number;
8373
+ }
8374
+
8375
+ /**
8376
+ * Specifies options for exporting video design blocks to various formats.
8377
+ *
8378
+ * The `UBQExportVideoOptions` interface provides a set of properties that control the
8379
+ * behavior and quality of the exported video content. These options include settings
8380
+ * for H.264 profile, level, framerate, video bitrate, audio bitrate, and resizing.
8381
+ *
8382
+ * Methods for configuring export settings for video design blocks.
8383
+ *
8384
+ * @public
8385
+ */
8386
+ declare interface UBQExportVideoOptions {
8387
+ h264Profile: number;
8388
+ h264Level: number;
8389
+ framerate: number;
8390
+ videoBitrate: number;
8391
+ audioBitrate: number;
8392
+ useTargetSize: boolean;
8393
+ targetWidth: number;
8394
+ targetHeight: number;
8395
+ }
8396
+
8397
+ /**
8398
+ * Specifies options for configuring block split operations.
8399
+ *
8400
+ * The `UBQSplitOptions` interface provides a set of properties that control the
8401
+ * behavior of the block splitting operation.
8402
+ *
8403
+ * Methods for configuring block split operations.
8404
+ *
8405
+ * @public
8406
+ */
8407
+ declare interface UBQSplitOptions {
8408
+ attachToParent: boolean;
8409
+ createParentTrackIfNeeded: boolean;
8410
+ selectNewBlock: boolean;
8411
+ }
8412
+
8410
8413
  /**
8411
8414
  * @public Manage text variables within design templates.
8412
8415
  *