@cesdk/node 1.70.0-nightly.20260218 → 1.70.0-nightly.20260220

package/index.d.ts

@@ -5697,6 +5697,12 @@ export declare interface CMYKColor {
  */
 export declare type Color = RGBAColor | CMYKColor | SpotColor;
 
+/** @public */
+export declare type ColorPickerColorMode = (typeof ColorPickerColorModeValues)[number];
+
+/** @public */
+export declare const ColorPickerColorModeValues: readonly ["RGB", "CMYK", "Any"];
+
 /** @public */
 export declare type ColorPropertyName = 'dropShadow/color' | 'fill/solid/color' | 'stroke/color' | 'backgroundColor/color' | 'animation/block_swipe_text/blockColor' | 'effect/duotone_filter/darkColor' | 'effect/duotone_filter/lightColor' | 'effect/green_screen/fromColor' | 'effect/recolor/fromColor' | 'effect/recolor/toColor' | 'fill/color/value' | (string & {});
 
@@ -5731,6 +5737,25 @@ export declare interface CompleteAssetResult extends AssetResult {
     active: boolean;
 }
 
+/**
+ * Compression format for scene serialization.
+ * @public
+ */
+export declare enum CompressionFormat {
+    None = 0,
+    Zstd = 1
+}
+
+/**
+ * Compression level for scene serialization.
+ * @public
+ */
+export declare enum CompressionLevel {
+    Fastest = 0,
+    Default = 1,
+    Best = 2
+}
+
 /**
  * Specifies the configuration for the Creative Editor SDK.
  *
@@ -7630,6 +7655,34 @@ export declare interface RGBColor {
  */
 export declare type RoleString = 'Creator' | 'Adopter' | 'Viewer' | 'Presenter';
 
+/**
+ * Options for saveSceneToString operation.
+ * @public
+ */
+declare interface SaveToStringOptions {
+    /**
+     * List of resource URL schemes that are allowed in the serialized scene.
+     * Resources with other schemes will trigger the persistence callback.
+     */
+    resourceSchemesAllowed?: string[];
+    /**
+     * Optional callback for persisting resources with disallowed schemes.
+     */
+    persistenceCallback?: (url: string, dataHash: string, persistedCallback?: {
+        invoke(url: string, persistedUrl: string): void;
+    }) => void;
+    /**
+     * Compression options for the serialized scene.
+     * When compression is enabled, base64 encoding is skipped and raw binary data is returned.
+     */
+    compression?: {
+        /** Compression format (None = no compression, Zstd = zstd compression) */
+        format?: CompressionFormat;
+        /** Compression level (Fastest, Default, Best) */
+        level?: CompressionLevel;
+    };
+}
+
 /**
  * @public Create, load, save, and manipulate scenes.
  *
@@ -7718,14 +7771,38 @@ export declare class SceneAPI {
      * Serializes the current scene into a string. Selection is discarded.
      *
      * @category Scene Saving
-     * @param allowedResourceSchemes - The resource schemes to allow in the saved string. Defaults to ['blob', 'bundle', 'file', 'http', 'https', 'opfs'].
+     * @param allowedResourceSchemes - The resource schemes to allow in the saved string.
      * @param onDisallowedResourceScheme - An optional callback that is called for each resource URL that has a scheme absent from
      * `resourceSchemesAllowed`. The `url` parameter is the resource URL and the `dataHash` parameter is the hash of the
      * resource's data. The callback should return a new URL for the resource, which will be used in the serialized
      * scene. The callback is expected to return the original URL if no persistence is needed.
      * @returns A promise that resolves with a string on success or an error on failure.
+     * @deprecated Use saveToString(options) instead for better extensibility and to access compression features.
      */
-    saveToString(allowedResourceSchemes?: string[], onDisallowedResourceScheme?: (url: string, dataHash: string) => Promise<string>): Promise<string>;
+    saveToString(allowedResourceSchemes: string[], onDisallowedResourceScheme?: (url: string, dataHash: string) => Promise<string>): Promise<string>;
+    /**
+     * Serializes the current scene into a string. Selection is discarded.
+     *
+     * @category Scene Saving
+     * @param options - Save options containing:
+     *   - allowedResourceSchemes: The resource schemes to allow in the saved string. Defaults to ['blob', 'bundle', 'file', 'http', 'https', 'opfs'].
+     *   - onDisallowedResourceScheme: An optional callback that is called for each resource URL that has a scheme absent from
+     *     `resourceSchemesAllowed`. The `url` parameter is the resource URL and the `dataHash` parameter is the hash of the
+     *     resource's data. The callback should return a new URL for the resource, which will be used in the serialized
+     *     scene. The callback is expected to return the original URL if no persistence is needed.
+     *   - compression: Optional compression settings containing:
+     *     - format: Compression format (None or Zstd). Defaults to None.
+     *     - level: Compression level (Fastest, Default, or Best). Defaults to Default.
+     * @returns A promise that resolves with a string on success or an error on failure.
+     */
+    saveToString(options?: {
+        allowedResourceSchemes?: string[];
+        onDisallowedResourceScheme?: (url: string, dataHash: string) => Promise<string>;
+        compression?: {
+            format?: CompressionFormat;
+            level?: CompressionLevel;
+        };
+    }): Promise<string>;
     /**
      * Saves the current scene and all of its referenced assets into an archive.
      *
@@ -8271,7 +8348,7 @@ export declare type SettingBoolPropertyName = 'alwaysHighlightPlaceholders' | 'd
 export declare type SettingColorPropertyName = 'clearColor' | 'handleFillColor' | 'highlightColor' | 'pageHighlightColor' | 'placeholderHighlightColor' | 'snappingGuideColor' | 'rotationSnappingGuideColor' | 'cropOverlayColor' | 'textVariableHighlightColor' | 'borderOutlineColor' | 'progressColor' | 'errorStateColor' | 'page/title/color' | 'page/marginFillColor' | 'page/marginFrameColor' | 'page/innerBorderColor' | 'page/outerBorderColor' | 'colorMaskingSettings/maskColor' | (string & {});
 
 /** @public */
-export declare type SettingEnumPropertyName = 'touch/pinchAction' | 'touch/rotateAction' | 'camera/clamping/overshootMode' | 'doubleClickSelectionMode' | (string & {});
+export declare type SettingEnumPropertyName = 'touch/pinchAction' | 'touch/rotateAction' | 'camera/clamping/overshootMode' | 'doubleClickSelectionMode' | 'colorPicker/colorMode' | (string & {});
 
 /** @public */
 export declare type SettingEnumType = {
@@ -8279,10 +8356,11 @@ export declare type SettingEnumType = {
     'touch/rotateAction': TouchRotateAction;
     'camera/clamping/overshootMode': CameraClampingOvershootMode;
     doubleClickSelectionMode: DoubleClickSelectionMode;
+    'colorPicker/colorMode': ColorPickerColorMode;
 };
 
 /** @public */
-export declare type SettingEnumValues = TouchPinchAction | TouchRotateAction | CameraClampingOvershootMode | DoubleClickSelectionMode | (string & {});
+export declare type SettingEnumValues = TouchPinchAction | TouchRotateAction | CameraClampingOvershootMode | DoubleClickSelectionMode | ColorPickerColorMode | (string & {});
 
 /** @public */
 export declare type SettingFloatPropertyName = 'positionSnappingThreshold' | 'rotationSnappingThreshold' | 'controlGizmo/blockScaleDownLimit' | (string & {});
@@ -8333,6 +8411,8 @@ export declare interface Settings {
     'features/pageCarouselEnabled': boolean;
     /** Whether transform edits should retain the cover mode of the content. */
     'features/transformEditsRetainCoverMode': boolean;
+    /** Whether auto-sized text blocks should be clamped to page boundaries during editing. */
+    'features/clampTextBlockWidthToPageDimensionsDuringEditing': boolean;
     /** Whether the engine processes mouse scroll events. */
     'mouse/enableScroll': boolean;
     /** Whether the engine processes mouse zoom events. */
@@ -8465,6 +8545,8 @@ export declare interface Settings {
     'camera/clamping/overshootMode': 'Center' | 'Reverse';
     /** Controls the icon size of the dock components */
     'dock/iconSize': 'normal' | 'large';
+    /** Controls the color mode of the color picker. When set to 'RGB' or 'CMYK', only colors matching this mode are fully editable. Defaults to 'Any'. */
+    'colorPicker/colorMode': 'RGB' | 'CMYK' | 'Any';