@cesdk/cesdk-js 1.64.0-nightly.20251105 → 1.64.0-rc.1

package/index.d.ts

@@ -6873,13 +6873,21 @@ export declare class UtilsAPI {
      *   accept: 'image/*',
      *   returnType: 'blob'
      * });
+     *
+     * // Load a file as object URL (blob URL)
+     * const objectURL = await cesdk.utils.loadFile({
+     *   accept: '.zip',
+     *   returnType: 'objectURL'
+     * });
+     * // Remember to revoke the object URL when done
+     * URL.revokeObjectURL(objectURL);
      * ```
      * @public
      */
-    loadFile<T extends 'dataURL' | 'text' | 'blob' | 'arrayBuffer' | 'File'>({ accept, returnType }: {
+    loadFile<T extends 'dataURL' | 'text' | 'blob' | 'arrayBuffer' | 'File' | 'objectURL'>({ accept, returnType }: {
         accept: string;
         returnType?: T;
-    }): Promise<T extends 'dataURL' ? string : T extends 'text' ? string : T extends 'blob' ? Blob : T extends 'arrayBuffer' ? ArrayBuffer : File>;
+    }): Promise<T extends 'dataURL' ? string : T extends 'text' ? string : T extends 'blob' ? Blob : T extends 'arrayBuffer' ? ArrayBuffer : T extends 'objectURL' ? string : File>;
     /**
      * Downloads a blob or string as a file to the user's device
      *
@@ -6921,6 +6929,8 @@ export declare class UtilsAPI {
     /**
      * Calculates the recommended viewport padding based on current viewport size and settings.
      * This utility matches the internal padding used by the SDK for zoom operations.
+     * The calculation accounts for safe area insets to ensure content remains visible
+     * in UI-safe regions (avoiding notches, rounded corners, system overlays, etc.).
      *
      * @param width - Optional viewport width to use instead of current camera width
      * @param height - Optional viewport height to use instead of current camera height