@cesdk/node 1.19.0-rc.0 → 1.19.0

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/README.md CHANGED
@@ -12,7 +12,7 @@ Visit our [documentation](https://img.ly/docs/cesdk) for more tutorials on how t
12
12
  customize the engine for your specific use case.
13
13
 
14
14
  ## License
15
- The CreativeEditor SDK is a commercial product. To use it as such and get access to its white-label version - without the watermark in the export - you need to unlock the SDK with a license file. You can purchase a license at https://img.ly/pricing.
15
+ The CreativeEditor SDK is a commercial product. To use it and get access you need to unlock the SDK with a license file. You can purchase a license at https://img.ly/pricing.
16
16
 
17
17
  ## Usage
18
18
 
@@ -50,8 +50,7 @@ and description of all API methods.
50
50
 
51
51
  ## License
52
52
 
53
- The CreativeEditor SDK is a commercial product. To use it as such and get
54
- access to its white label version - without the watermark in the export - you
53
+ The CreativeEditor SDK is a commercial product. To use it you
55
54
  need to unlock the SDK with a license file. You can purchase a license at
56
55
  https://img.ly/pricing.
57
56
 
package/index.d.ts CHANGED
@@ -2879,6 +2879,8 @@ export declare class EditorAPI {
2879
2879
  * @throws An error, if the keypath is invalid.
2880
2880
  */
2881
2881
  setSettingBool(keypath: SettingsBool, value: boolean): void;
2882
+ /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
2883
+ setSettingBool(keypath: `ubq://${SettingsBool}`, value: boolean): void;
2882
2884
 
2883
2885
  /**
2884
2886
  * Get a boolean setting.
@@ -2886,6 +2888,8 @@ export declare class EditorAPI {
2886
2888
  * @throws An error, if the keypath is invalid.
2887
2889
  */
2888
2890
  getSettingBool(keypath: SettingsBool): boolean;
2891
+ /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
2892
+ getSettingBool(keypath: `ubq://${SettingsBool}`): boolean;
2889
2893
 
2890
2894
  /**
2891
2895
  * Set an integer setting.
@@ -2907,12 +2911,16 @@ export declare class EditorAPI {
2907
2911
  * @throws An error, if the keypath is invalid.
2908
2912
  */
2909
2913
  setSettingFloat(keypath: SettingsFloat, value: number): void;
2914
+ /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
2915
+ setSettingFloat(keypath: `ubq://${SettingsFloat}`, value: number): void;
2910
2916
  /**
2911
2917
  * Get a float setting.
2912
2918
  * @param keypath - The settings keypath, e.g. `positionSnappingThreshold`
2913
2919
  * @throws An error, if the keypath is invalid.
2914
2920
  */
2915
2921
  getSettingFloat(keypath: SettingsFloat): number;
2922
+ /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
2923
+ getSettingFloat(keypath: `ubq://${SettingsFloat}`): number;
2916
2924
  /**
2917
2925
  * Set a string setting.
2918
2926
  * @param keypath - The settings keypath, e.g. `license`
@@ -2920,24 +2928,32 @@ export declare class EditorAPI {
2920
2928
  * @throws An error, if the keypath is invalid.
2921
2929
  */
2922
2930
  setSettingString(keypath: SettingsString, value: string): void;
2931
+ /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
2932
+ setSettingString(keypath: `ubq://${SettingsString}`, value: string): void;
2923
2933
  /**
2924
2934
  * Get a string setting.
2925
2935
  * @param keypath - The settings keypath, e.g. `license`
2926
2936
  * @throws An error, if the keypath is invalid.
2927
2937
  */
2928
2938
  getSettingString(keypath: SettingsString): string;
2939
+ /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
2940
+ getSettingString(keypath: `ubq://${SettingsString}`): string;
2929
2941
  /**
2930
2942
  * Set a color setting.
2931
2943
  * @param keypath - The settings keypath, e.g. `highlightColor`.
2932
2944
  * @param value - The The value to set.
2933
2945
  */
2934
2946
  setSettingColor(keypath: SettingsColor, value: Color): void;
2947
+ /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
2948
+ setSettingColor(keypath: `ubq://${SettingsColor}`, value: Color): void;
2935
2949
  /**
2936
2950
  * Get a color setting.
2937
2951
  * @param keypath - The settings keypath, e.g. `highlightColor`.
2938
2952
  * @throws An error, if the keypath is invalid.
2939
2953
  */
2940
2954
  getSettingColor(keypath: SettingsColor): Color;
2955
+ /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
2956
+ getSettingColor(keypath: `ubq://${SettingsColor}`): Color;
2941
2957
  /**
2942
2958
  * Set a color setting.
2943
2959
  * @param keypath - The settings keypath, e.g. `highlightColor`.
@@ -2947,32 +2963,38 @@ export declare class EditorAPI {
2947
2963
  * @param a - The alpha color component in the range of 0 to 1.
2948
2964
  * @deprecated Use setSettingColor() instead.
2949
2965
  */
2950
- setSettingColorRGBA(keypath: SettingsColorRGBA, r: number, g: number, b: number, a?: number): void;
2966
+ setSettingColorRGBA(keypath: SettingsColorRGBA | `ubq://${SettingsColorRGBA}`, r: number, g: number, b: number, a?: number): void;
2951
2967
  /**
2952
2968
  * Get a color setting.
2953
2969
  * @param keypath - The settings keypath, e.g. `highlightColor`.
2954
2970
  * @returns A tuple of channels red, green, blue and alpha in the range of 0 to 1.
2955
2971
  * @deprecated Use getSettingColor() instead.
2956
2972
  */
2957
- getSettingColorRGBA(keypath: SettingsColorRGBA): RGBA;
2973
+ getSettingColorRGBA(keypath: SettingsColorRGBA | `ubq://${SettingsColorRGBA}`): RGBA;
2958
2974
  /**
2959
2975
  * Set an enum setting.
2960
2976
  * @param keypath - The settings keypath, e.g. `role`.
2961
2977
  * @param value - The enum value as string.
2962
2978
  */
2963
2979
  setSettingEnum<T extends keyof SettingsEnum>(keypath: T, value: SettingsEnum[T]): void;
2980
+ /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
2981
+ setSettingEnum<T extends keyof SettingsEnum>(keypath: `ubq://${T}`, value: SettingsEnum[T]): void;
2964
2982
  /**
2965
2983
  * Get an enum setting.
2966
2984
  * @param keypath - The settings keypath, e.g. `role`.
2967
2985
  * @returns The value as string.
2968
2986
  */
2969
2987
  getSettingEnum<T extends keyof SettingsEnum>(keypath: T): SettingsEnum[T];
2988
+ /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
2989
+ getSettingEnum<T extends keyof SettingsEnum>(keypath: `ubq://${T}`): SettingsEnum[T];
2970
2990
  /**
2971
2991
  * Get the possible enum options for a given enum setting.
2972
2992
  * @param keypath - The settings keypath, e.g. `role`.
2973
2993
  * @returns The possible enum options as strings.
2974
2994
  */
2975
2995
  getSettingEnumOptions<T extends keyof SettingsEnum>(keypath: T): string[];
2996
+ /** @deprecated Support for `ubq://` prefixed keypaths will be removed in a future release. */
2997
+ getSettingEnumOptions<T extends keyof SettingsEnum>(keypath: `ubq://${T}`): string[];
2976
2998
  /**
2977
2999
  * Returns a list of all the settings available.
2978
3000
  * @returns A list of settings keypaths.
@@ -3698,7 +3720,7 @@ export declare type SceneLayout = 'Free' | 'VerticalStack' | 'HorizontalStack' |
3698
3720
  export declare type SceneMode = 'Design' | 'Video';
3699
3721
 
3700
3722
  /** @public */
3701
- 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';
3723
+ export declare type SettingsBool = 'doubleClickToCropEnabled' | 'features/singlePageModeEnabled' | 'mouse/enableZoom' | 'mouse/enableScroll' | 'page/dimOutOfPageAreas' | 'page/title/show' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'showBuildVersion' | 'touch/dragStartCanSelect' | 'touch/singlePointPanning';
3702
3724
 
3703
3725
  /** @public
3704
3726
  */