@meframe/core 0.0.31 → 0.0.33

package/dist/stages/load/ResourceLoader.d.ts

@@ -1,4 +1,4 @@
-import { CompositionModel } from '../../model';
+import { Resource, CompositionModel } from '../../model';
 import { ResourceLoadOptions, LoadTask, ResourceLoaderOptions } from './types';
 
 export declare class ResourceConflictError extends Error {
@@ -13,20 +13,44 @@ export declare class ResourceLoader {
     private eventBus?;
     private onStateChange?;
     private blobCache;
-    private pendingTransfers;
     private parsingIndexes;
     private isPreloadingEnabled;
     private preloadQueue;
-    private activePreloads;
-    private readonly IDLE_PRELOAD_CONCURRENCY;
     constructor(options: ResourceLoaderOptions);
     setModel(model: CompositionModel): Promise<void>;
     setPreloadingEnabled(enabled: boolean): void;
     startPreloading(): void;
     private processPreloadQueue;
     private enqueueLoad;
-    private registerPendingTransfer;
     private processQueue;
+    /**
+     * Check if resource is cached and ready (without loading)
+     */
+    private isResourceCached;
+    /**
+     * Transfer video stream to worker
+     */
+    private transferVideoToWorker;
+    /**
+     * Transfer image to worker
+     */
+    private transferImageToWorker;
+    /**
+     * Load video resource (download + cache or read from cache)
+     */
+    private loadVideoResource;
+    /**
+     * Load audio resource (download + parse or reuse cache)
+     */
+    private loadAudioResource;
+    /**
+     * Load image resource (download + cache or read from cache) and transfer to worker
+     */
+    private loadImageResource;
+    /**
+     * Load text resource (json/text)
+     */
+    private loadTextResource;
     /**
      * Start loading a resource
      * Handles state management (loading → ready/error) for all resource types
@@ -55,43 +79,38 @@ export declare class ResourceLoader {
      */
     private writeToOPFS;
     /**
-     * Parse moov from stream and cache index + audio samples + decode first frame
+     * Load and parse audio file (MP3/WAV) in main thread
+     * Extract EncodedAudioChunk and cache to AudioSampleCache
+     * Aligned with video audio track extraction (unified architecture)
      */
-    private parseIndexFromStream;
-    /**
-     * Load text-based resources (json, text)
-     * Just download the content - state management is handled by startLoad()
-     */
-    private loadTextResource;
+    private loadAndParseAudioFile;
     /**
-     * Load image resource: fetch blob → create ImageBitmap → cache in CacheManager
-     * Note: Images don't need streaming (typically < 5MB)
-     *
-     * Strategy for window cache architecture:
-     * - Store ImageBitmap in CacheManager.imageBitmapCache (main thread accessible)
-     * - OnDemandComposeSession retrieves from cache for composition
-     * - No longer transfer to Worker (composition is in main thread)
+     * Parse moov from stream and cache index + audio samples + decode first frame
      */
-    private loadImageBitmap;
+    private parseIndexFromStream;
+    loadImage(resource: Resource): Promise<ImageBitmap>;
     /**
      * Fetch resource as blob (for images, json, etc.)
      */
     private fetchBlob;
-    /**
-     * Transfer ImageBitmap to VideoComposeWorker
-     * Legacy: Not used in window cache architecture (images accessed via CacheManager)
-     */
-    /**
-     * Transfer cached image to a session
-     * Creates new ImageBitmap from cached Blob and transfers to worker
-     */
-    private transferCachedImage;
     /**
      * Transfer stream to demux worker (for audio files)
      */
     private transferToDemuxWorker;
     private updateResourceState;
-    fetch(resourceId?: string, options?: ResourceLoadOptions): Promise<void>;
+    /**
+     * Fetch a resource and wait for loading + parsing to complete
+     *
+     * Returns a Promise that resolves when:
+     * - Resource is fully loaded, parsed, and cached (state='ready')
+     * - Or rejects if loading/parsing fails
+     *
+     * Promise lifecycle:
+     * 1. enqueueLoad() creates LoadTask with promise/resolve/reject (or reuses existing)
+     * 2. processQueue() → startLoad() executes async in background
+     * 3. startLoad() completes → finally → completeTask() → task.resolve()/reject()
+     */
+    load(resourceId?: string, options?: ResourceLoadOptions): Promise<void>;
     cancel(resourceId: string): void;
     /**
      * Check if a resource is currently being loaded

package/dist/stages/load/ResourceLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceLoader.d.ts","sourceRoot":"","sources":["../../../src/stages/load/ResourceLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,gBAAgB,EAAiB,MAAM,aAAa,CAAC;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAUpF,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,KAAK,CAAC,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,CAA4B;IAC7C,OAAO,CAAC,aAAa,CAAC,CAAyD;IAC/E,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,cAAc,CAAqB;IAG3C,OAAO,CAAC,mBAAmB,CAAQ;IACnC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,cAAc,CAAqB;IAE3C,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAK;gBAElC,OAAO,EAAE,qBAAqB;IAUpC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAatD,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAU5C,eAAe,IAAI,IAAI;IAmCvB,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,WAAW;IAqCnB,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,YAAY;IAQpB;;;OAGG;YACW,SAAS;IAqDvB;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC1D;;;OAGG;YACW,oBAAoB;IAclC;;;;;;;OAOG;YACW,iBAAiB;IA6C/B;;OAEG;YACW,WAAW;IAIzB;;OAEG;YACW,oBAAoB;IA8DlC;;;OAGG;YACW,gBAAgB;IAM9B;;;;;;;;OAQG;YACW,eAAe;IA+B7B;;OAEG;YACW,SAAS;IAUvB;;;OAGG;IAuBH;;;OAGG;YACW,mBAAmB;IAqBjC;;OAEG;YACW,qBAAqB;IAyBnC,OAAO,CAAC,mBAAmB;IAgBrB,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoF9E,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKhC;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI9C,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOzB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9E,IAAI,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAEvC;IAED,IAAI,SAAS,IAAI,QAAQ,EAAE,CAE1B;IAED,OAAO,IAAI,IAAI;CAKhB"}
+{"version":3,"file":"ResourceLoader.d.ts","sourceRoot":"","sources":["../../../src/stages/load/ResourceLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAiB,MAAM,aAAa,CAAC;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAWpF,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,KAAK,CAAC,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,CAA4B;IAC7C,OAAO,CAAC,aAAa,CAAC,CAAyD;IAC/E,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,cAAc,CAAqB;IAG3C,OAAO,CAAC,mBAAmB,CAAQ;IACnC,OAAO,CAAC,YAAY,CAAgB;gBAExB,OAAO,EAAE,qBAAqB;IAYpC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAatD,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAO5C,eAAe,IAAI,IAAI;IA0BvB,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,YAAY;IAQpB;;OAEG;YACW,gBAAgB;IAuB9B;;OAEG;YACW,qBAAqB;IAcnC;;OAEG;YACW,qBAAqB;IAcnC;;OAEG;YACW,iBAAiB;IAiB/B;;OAEG;YACW,iBAAiB;IAQ/B;;OAEG;YACW,iBAAiB;IA0B/B;;OAEG;YACW,gBAAgB;IAM9B;;;OAGG;YACW,SAAS;IA4CvB;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC1D;;;OAGG;YACW,oBAAoB;IAclC;;;;;;;OAOG;YACW,iBAAiB;IA6C/B;;OAEG;YACW,WAAW;IAIzB;;;;OAIG;YACW,qBAAqB;IA8CnC;;OAEG;YACW,oBAAoB;IA8D5B,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC;IAoBzD;;OAEG;YACW,SAAS;IAUvB;;OAEG;YACW,qBAAqB;IAyBnC,OAAO,CAAC,mBAAmB;IAgB3B;;;;;;;;;;;OAWG;IACG,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuG7E,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKhC;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI9C,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOzB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9E,IAAI,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAEvC;IAED,IAAI,SAAS,IAAI,QAAQ,EAAE,CAE1B;IAED,OAAO,IAAI,IAAI;CAIhB"}