@cesdk/cesdk-js 1.65.0-rc.0 → 1.66.0-nightly.20251126

package/index.d.ts

@@ -6920,7 +6920,9 @@ export declare class UtilsAPI {
      * Opens a file picker dialog for the user to select a file
      *
      * @param options - Options for the file load operation
-     * @returns The loaded file content in the requested format
+     * @returns The loaded file content in the requested format. For dataURL return type,
+     * if the file is eligible for OPFS storage and the feature is enabled, returns the
+     * OPFS URL (opfs://...) instead of a data URL.
      *
      * @example
      * ```typescript
@@ -6936,6 +6938,13 @@ export declare class UtilsAPI {
      *   returnType: 'blob'
      * });
      *
+     * // Load a file with OPFS support (returns opfs:// URL for eligible files)
+     * const url = await cesdk.utils.loadFile({
+     *   accept: 'video/*',
+     *   returnType: 'dataURL'
+     * });
+     * // For eligible files: "opfs://cesdk-1234567890-video.mp4"
+     * // For non-eligible files: "data:video/mp4;base64,..."
      * // Load a file as object URL (blob URL)
      * const objectURL = await cesdk.utils.loadFile({
      *   accept: '.zip',