@meframe/core 0.0.29 → 0.0.30

package/dist/cache/l1/VideoL1Cache.js

@@ -1,24 +1,76 @@
+import { binarySearchNearest, binarySearchFirst } from "../../utils/binary-search.js";
 import { RcFrame } from "../../model/RcFrame.js";
 const BYTES_PER_MB = 1024 * 1024;
 class VideoL1Cache {
   framesByClip = /* @__PURE__ */ new Map();
   maxMemoryBytes;
   currentBytes = 0;
+  windowCenter = 0;
+  windowSize = 35e5;
+  // ±3.5s
+  lastEvictTime = 0;
+  EVICT_THROTTLE_MS = 500;
   constructor(config) {
     this.maxMemoryBytes = config.maxMemoryMB * BYTES_PER_MB;
   }
+  /**
+   * Set window center and trigger eviction
+   * Window management helps limit memory usage for long clips
+   */
+  setWindow(centerTimeUs) {
+    this.windowCenter = centerTimeUs;
+    const now = Date.now();
+    if (now - this.lastEvictTime > this.EVICT_THROTTLE_MS) {
+      this.evictOutOfWindow();
+      this.lastEvictTime = now;
+    }
+  }
+  /**
+   * Evict frames outside the window
+   * Essential for long clips to limit memory usage to window size (±3s)
+   */
+  evictOutOfWindow() {
+    const minTime = Math.max(0, this.windowCenter - this.windowSize);
+    const maxTime = this.windowCenter + this.windowSize;
+    for (const [clipId, frames] of this.framesByClip) {
+      const toEvict = [];
+      const toKeep = [];
+      for (const frame of frames) {
+        const globalTime = frame.globalTimeUs;
+        if (globalTime === void 0) {
+          toKeep.push(frame);
+          continue;
+        }
+        if (globalTime < minTime || globalTime > maxTime) {
+          toEvict.push(frame);
+        } else {
+          toKeep.push(frame);
+        }
+      }
+      if (toEvict.length > 0) {
+        for (const frame of toEvict) {
+          this.currentBytes -= frame.sizeEstimate;
+          frame.close();
+        }
+        this.framesByClip.set(clipId, toKeep);
+      }
+    }
+  }
   get(timeUs, clipId) {
     const frames = this.framesByClip.get(clipId);
-    if (!frames || frames.length === 0) return null;
-    const index = this.binarySearchFrame(frames, timeUs);
-    return index !== -1 ? frames[index] ?? null : null;
+    if (!frames || frames.length === 0) {
+      return null;
+    }
+    return binarySearchNearest(frames, timeUs, (frame) => frame.timestampUs ?? 0);
   }
-  addFrame(frame, clipId, frameDuration, trackId) {
+  addFrame(frame, clipId, frameDuration, trackId, globalTimeUs) {
     const rcFrame = RcFrame.wrap(frame, {
       trackId,
       clipId,
       timestampUs: frame.timestamp ?? 0,
-      durationUs: frame.duration ?? frameDuration
+      durationUs: frame.duration ?? frameDuration,
+      globalTimeUs
+      // Store global timestamp for window eviction
     });
     let frames = this.framesByClip.get(clipId);
     if (!frames) {
@@ -86,40 +138,8 @@ class VideoL1Cache {
       clipCount: this.framesByClip.size
     };
   }
-  binarySearchFrame(frames, timeUs) {
-    let low = 0;
-    let high = frames.length - 1;
-    let result = -1;
-    while (low <= high) {
-      const mid = Math.floor((low + high) / 2);
-      const frame = frames[mid];
-      if (!frame) break;
-      const frameTime = frame.timestampUs ?? 0;
-      const frameDuration = frame.durationUs ?? 0;
-      if (timeUs < frameTime) {
-        high = mid - 1;
-      } else if (timeUs >= frameTime + frameDuration) {
-        low = mid + 1;
-      } else {
-        result = mid;
-        break;
-      }
-    }
-    return result;
-  }
   findInsertIndex(frames, timestamp) {
-    let low = 0;
-    let high = frames.length;
-    while (low < high) {
-      const mid = Math.floor((low + high) / 2);
-      const midTs = frames[mid]?.timestampUs ?? 0;
-      if (midTs < timestamp) {
-        low = mid + 1;
-      } else {
-        high = mid;
-      }
-    }
-    return low;
+    return binarySearchFirst(frames, (frame) => (frame.timestampUs ?? 0) >= timestamp);
   }
 }
 export {

package/dist/cache/l1/VideoL1Cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"VideoL1Cache.js","sources":["../../../src/cache/l1/VideoL1Cache.ts"],"sourcesContent":["import type { TimeUs } from '../../model/types';\nimport { RcFrame } from '../../model';\n\nconst BYTES_PER_MB = 1024 * 1024;\n\ninterface L1Config {\n  maxMemoryMB: number;\n}\n\nexport interface L1CacheMetadata {\n  size: number;\n  maxSize: number;\n  entries: number;\n  clipCount: number;\n}\n\n/**\n * Simplified VideoL1Cache - Single-layer frame storage per clip\n *\n * Each clip stores frames in a sorted array by timestamp.\n * No GOP management - frames are directly stored and retrieved via binary search.\n */\nexport class VideoL1Cache {\n  private readonly framesByClip = new Map<string, RcFrame[]>();\n  private readonly maxMemoryBytes: number;\n  private currentBytes = 0;\n\n  constructor(config: L1Config) {\n    this.maxMemoryBytes = config.maxMemoryMB * BYTES_PER_MB;\n  }\n\n  get(timeUs: TimeUs, clipId: string): RcFrame | null {\n    const frames = this.framesByClip.get(clipId);\n    if (!frames || frames.length === 0) return null;\n\n    // Binary search for frame at timeUs\n    const index = this.binarySearchFrame(frames, timeUs);\n    return index !== -1 ? (frames[index] ?? null) : null;\n  }\n\n  addFrame(frame: VideoFrame, clipId: string, frameDuration: TimeUs, trackId: string): RcFrame {\n    const rcFrame = RcFrame.wrap(frame, {\n      trackId,\n      clipId,\n      timestampUs: frame.timestamp ?? 0,\n      durationUs: frame.duration ?? frameDuration,\n    });\n\n    let frames = this.framesByClip.get(clipId);\n    if (!frames) {\n      frames = [];\n      this.framesByClip.set(clipId, frames);\n    }\n\n    const timestamp = rcFrame.timestampUs ?? 0;\n    const insertIndex = this.findInsertIndex(frames, timestamp);\n\n    // Check for duplicate timestamp\n    if (insertIndex < frames.length && (frames[insertIndex]?.timestampUs ?? 0) === timestamp) {\n      const oldFrame = frames[insertIndex];\n      frames[insertIndex] = rcFrame;\n      this.currentBytes -= oldFrame?.sizeEstimate ?? 0;\n      oldFrame?.close?.();\n    } else {\n      frames.splice(insertIndex, 0, rcFrame);\n    }\n\n    this.currentBytes += rcFrame.sizeEstimate;\n    return rcFrame;\n  }\n\n  invalidateClip(clipId: string): void {\n    const frames = this.framesByClip.get(clipId);\n    if (!frames) return;\n\n    for (const frame of frames) {\n      this.currentBytes -= frame.sizeEstimate;\n      frame?.close?.();\n    }\n\n    this.framesByClip.delete(clipId);\n  }\n\n  hasClip(clipId: string): boolean {\n    const frames = this.framesByClip.get(clipId);\n    return !!frames && frames.length > 0;\n  }\n\n  getClipFrameCount(clipId: string, startTimeUs?: TimeUs): number {\n    const frames = this.framesByClip.get(clipId);\n    if (!frames) return 0;\n\n    if (startTimeUs === undefined) {\n      return frames.length;\n    }\n\n    // Count frames >= startTimeUs\n    let count = 0;\n    for (const frame of frames) {\n      if ((frame.timestampUs ?? 0) >= startTimeUs) {\n        count++;\n      }\n    }\n    return count;\n  }\n\n  clear(): void {\n    for (const frames of this.framesByClip.values()) {\n      for (const frame of frames) {\n        frame?.close?.();\n      }\n    }\n    this.framesByClip.clear();\n    this.currentBytes = 0;\n  }\n\n  getMetadata(): L1CacheMetadata {\n    let totalFrames = 0;\n    for (const frames of this.framesByClip.values()) {\n      totalFrames += frames.length;\n    }\n\n    return {\n      size: this.currentBytes,\n      maxSize: this.maxMemoryBytes,\n      entries: totalFrames,\n      clipCount: this.framesByClip.size,\n    };\n  }\n\n  private binarySearchFrame(frames: RcFrame[], timeUs: TimeUs): number {\n    let low = 0;\n    let high = frames.length - 1;\n    let result = -1;\n\n    while (low <= high) {\n      const mid = Math.floor((low + high) / 2);\n      const frame = frames[mid];\n      if (!frame) break;\n\n      const frameTime = frame.timestampUs ?? 0;\n      const frameDuration = frame.durationUs ?? 0;\n\n      if (timeUs < frameTime) {\n        high = mid - 1;\n      } else if (timeUs >= frameTime + frameDuration) {\n        low = mid + 1;\n      } else {\n        result = mid;\n        break;\n      }\n    }\n\n    return result;\n  }\n\n  private findInsertIndex(frames: RcFrame[], timestamp: TimeUs): number {\n    let low = 0;\n    let high = frames.length;\n\n    while (low < high) {\n      const mid = Math.floor((low + high) / 2);\n      const midTs = frames[mid]?.timestampUs ?? 0;\n\n      if (midTs < timestamp) {\n        low = mid + 1;\n      } else {\n        high = mid;\n      }\n    }\n\n    return low;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"VideoL1Cache.js","sources":["../../../src/cache/l1/VideoL1Cache.ts"],"sourcesContent":["import type { TimeUs } from '../../model/types';\nimport { RcFrame } from '../../model';\nimport { binarySearchNearest, binarySearchFirst } from '../../utils/binary-search';\n\nconst BYTES_PER_MB = 1024 * 1024;\n\ninterface L1Config {\n  maxMemoryMB: number;\n}\n\nexport interface L1CacheMetadata {\n  size: number;\n  maxSize: number;\n  entries: number;\n  clipCount: number;\n}\n\n/**\n * Simplified VideoL1Cache - Single-layer frame storage per clip\n *\n * Each clip stores frames in a sorted array by timestamp.\n * No GOP management - frames are directly stored and retrieved via binary search.\n */\nexport class VideoL1Cache {\n  private readonly framesByClip = new Map<string, RcFrame[]>();\n  private readonly maxMemoryBytes: number;\n  private currentBytes = 0;\n  private windowCenter: TimeUs = 0;\n  private windowSize: TimeUs = 3_500_000; // ±3.5s\n  private lastEvictTime = 0;\n  private readonly EVICT_THROTTLE_MS = 500;\n\n  constructor(config: L1Config) {\n    this.maxMemoryBytes = config.maxMemoryMB * BYTES_PER_MB;\n  }\n\n  /**\n   * Set window center and trigger eviction\n   * Window management helps limit memory usage for long clips\n   */\n  setWindow(centerTimeUs: TimeUs): void {\n    this.windowCenter = centerTimeUs;\n\n    // Throttle eviction to avoid excessive processing\n    const now = Date.now();\n    if (now - this.lastEvictTime > this.EVICT_THROTTLE_MS) {\n      this.evictOutOfWindow();\n      this.lastEvictTime = now;\n    }\n  }\n\n  /**\n   * Evict frames outside the window\n   * Essential for long clips to limit memory usage to window size (±3s)\n   */\n  private evictOutOfWindow(): void {\n    const minTime = Math.max(0, this.windowCenter - this.windowSize);\n    const maxTime = this.windowCenter + this.windowSize;\n\n    for (const [clipId, frames] of this.framesByClip) {\n      const toEvict: RcFrame[] = [];\n      const toKeep: RcFrame[] = [];\n\n      for (const frame of frames) {\n        const globalTime = frame.globalTimeUs;\n\n        // Frames without globalTimeUs (legacy) are kept (will be evicted by clip-level logic)\n        if (globalTime === undefined) {\n          toKeep.push(frame);\n          continue;\n        }\n\n        // Evict frames outside window\n        if (globalTime < minTime || globalTime > maxTime) {\n          // console.log('[VideoL1Cache] Evicting frame outside window:', {\n          //   globalTime,\n          //   windowCenter: this.windowCenter,\n          //   windowSize: this.windowSize,\n          //   minTime,\n          //   maxTime,\n          // });\n          toEvict.push(frame);\n        } else {\n          toKeep.push(frame);\n        }\n      }\n\n      // Release evicted frames\n      if (toEvict.length > 0) {\n        for (const frame of toEvict) {\n          this.currentBytes -= frame.sizeEstimate;\n          frame.close();\n        }\n\n        this.framesByClip.set(clipId, toKeep);\n      }\n    }\n  }\n\n  get(timeUs: TimeUs, clipId: string): RcFrame | null {\n    const frames = this.framesByClip.get(clipId);\n    if (!frames || frames.length === 0) {\n      return null;\n    }\n\n    // Use nearest frame search (instead of exact range match)\n    return binarySearchNearest(frames, timeUs, (frame) => frame.timestampUs ?? 0);\n  }\n\n  addFrame(\n    frame: VideoFrame,\n    clipId: string,\n    frameDuration: TimeUs,\n    trackId: string,\n    globalTimeUs?: TimeUs\n  ): RcFrame {\n    const rcFrame = RcFrame.wrap(frame, {\n      trackId,\n      clipId,\n      timestampUs: frame.timestamp ?? 0,\n      durationUs: frame.duration ?? frameDuration,\n      globalTimeUs, // Store global timestamp for window eviction\n    });\n\n    let frames = this.framesByClip.get(clipId);\n    if (!frames) {\n      frames = [];\n      this.framesByClip.set(clipId, frames);\n    }\n\n    const timestamp = rcFrame.timestampUs ?? 0;\n    const insertIndex = this.findInsertIndex(frames, timestamp);\n\n    // Check for duplicate timestamp\n    if (insertIndex < frames.length && (frames[insertIndex]?.timestampUs ?? 0) === timestamp) {\n      const oldFrame = frames[insertIndex];\n      frames[insertIndex] = rcFrame;\n      this.currentBytes -= oldFrame?.sizeEstimate ?? 0;\n      oldFrame?.close?.();\n    } else {\n      frames.splice(insertIndex, 0, rcFrame);\n    }\n\n    this.currentBytes += rcFrame.sizeEstimate;\n    return rcFrame;\n  }\n\n  invalidateClip(clipId: string): void {\n    const frames = this.framesByClip.get(clipId);\n    if (!frames) return;\n\n    for (const frame of frames) {\n      this.currentBytes -= frame.sizeEstimate;\n      frame?.close?.();\n    }\n\n    this.framesByClip.delete(clipId);\n  }\n\n  hasClip(clipId: string): boolean {\n    const frames = this.framesByClip.get(clipId);\n    return !!frames && frames.length > 0;\n  }\n\n  getClipFrameCount(clipId: string, startTimeUs?: TimeUs): number {\n    const frames = this.framesByClip.get(clipId);\n    if (!frames) return 0;\n\n    if (startTimeUs === undefined) {\n      return frames.length;\n    }\n\n    // Count frames >= startTimeUs\n    let count = 0;\n    for (const frame of frames) {\n      if ((frame.timestampUs ?? 0) >= startTimeUs) {\n        count++;\n      }\n    }\n    return count;\n  }\n\n  clear(): void {\n    for (const frames of this.framesByClip.values()) {\n      for (const frame of frames) {\n        frame?.close?.();\n      }\n    }\n    this.framesByClip.clear();\n    this.currentBytes = 0;\n  }\n\n  getMetadata(): L1CacheMetadata {\n    let totalFrames = 0;\n    for (const frames of this.framesByClip.values()) {\n      totalFrames += frames.length;\n    }\n\n    return {\n      size: this.currentBytes,\n      maxSize: this.maxMemoryBytes,\n      entries: totalFrames,\n      clipCount: this.framesByClip.size,\n    };\n  }\n\n  private findInsertIndex(frames: RcFrame[], timestamp: TimeUs): number {\n    return binarySearchFirst(frames, (frame) => (frame.timestampUs ?? 0) >= timestamp);\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/cache/l2/L2Cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"L2Cache.d.ts","sourceRoot":"","sources":["../../../src/cache/l2/L2Cache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"L2Cache.d.ts","sourceRoot":"","sources":["../../../src/cache/l2/L2Cache.ts"],"names":[],"mappings":"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"}

package/dist/cache/l2/L2OPFSStore.d.ts

@@ -0,0 +1,37 @@
+import { ChunkBatch } from '../storage/opfs/types';
+
+/**
+ * L2-specific OPFS wrapper
+ * Adapts OPFSManager for L2 cache chunk operations
+ */
+export declare class L2OPFSStore {
+    private opfsManager;
+    constructor();
+    init(): Promise<void>;
+    /**
+     * Read chunk data from OPFS file
+     */
+    read(fileName: string, batch: ChunkBatch, projectId: string): Promise<ArrayBuffer | null>;
+    /**
+     * Append chunks to OPFS file (or create new file)
+     */
+    append(fileName: string, chunks: Array<EncodedVideoChunk | EncodedAudioChunk>, existingBatches: ChunkBatch[] | undefined, projectId: string): Promise<ChunkBatch[]>;
+    /**
+     * Delete a file from OPFS
+     */
+    deleteFile(fileName: string, projectId: string): Promise<void>;
+    /**
+     * Delete entire project directory
+     */
+    deleteProjectDirectory(projectId: string): Promise<void>;
+    /**
+     * Check if a file exists in OPFS
+     */
+    fileExists(fileName: string, projectId: string): Promise<boolean>;
+    /**
+     * Clear all OPFS data for current project
+     */
+    clear(projectId: string): Promise<void>;
+    private chunkToArrayBuffer;
+}
+//# sourceMappingURL=L2OPFSStore.d.ts.map

package/dist/cache/l2/L2OPFSStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"L2OPFSStore.d.ts","sourceRoot":"","sources":["../../../src/cache/l2/L2OPFSStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAc;;IAM3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAe/F;;OAEG;IACG,MAAM,CACV,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,KAAK,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,EACpD,eAAe,EAAE,UAAU,EAAE,GAAG,SAAS,EACzC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,EAAE,CAAC;IAkCxB;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;OAEG;IACG,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvE;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAI/B,kBAAkB;CAOjC"}

package/dist/cache/resource/AudioSampleCache.d.ts

@@ -0,0 +1,52 @@
+import { TimeUs } from '../../model/types';
+
+export interface AudioSampleRecord {
+    resourceId: string;
+    samples: EncodedAudioChunk[];
+    metadata: AudioDecoderConfig;
+    totalBytes: number;
+    durationUs: TimeUs;
+}
+/**
+ * AudioSampleCache - Resource-level audio sample cache
+ *
+ * Caches all encoded audio samples from MP4 in memory
+ * Audio data is small (~100KB for 30s AAC, ~6MB for 30min)
+ *
+ * Strategy:
+ * - Extract all audio samples during moov parsing (one-time cost)
+ * - Keep encoded chunks in memory (compressed)
+ * - Decode to PCM on-demand when clip is played
+ */
+export declare class AudioSampleCache {
+    private cache;
+    /**
+     * Set audio samples for a resource
+     */
+    set(resourceId: string, samples: EncodedAudioChunk[], metadata: AudioDecoderConfig): void;
+    /**
+     * Get audio record for a resource
+     */
+    get(resourceId: string): AudioSampleRecord | null;
+    /**
+     * Check if resource has audio samples
+     */
+    has(resourceId: string): boolean;
+    /**
+     * Get samples in time range (for clip trimming)
+     */
+    getSamplesInRange(resourceId: string, startUs: TimeUs, endUs: TimeUs): EncodedAudioChunk[];
+    /**
+     * Delete audio samples for a resource
+     */
+    delete(resourceId: string): void;
+    /**
+     * Clear all cached audio samples
+     */
+    clear(): void;
+    /**
+     * Get total memory usage
+     */
+    getTotalBytes(): number;
+}
+//# sourceMappingURL=AudioSampleCache.d.ts.map

package/dist/cache/resource/AudioSampleCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioSampleCache.d.ts","sourceRoot":"","sources":["../../../src/cache/resource/AudioSampleCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAwC;IAErD;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAgBzF;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAIjD;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAW1F;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAShC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,aAAa,IAAI,MAAM;CAOxB"}

package/dist/cache/resource/AudioSampleCache.js

@@ -0,0 +1,69 @@
+class AudioSampleCache {
+  cache = /* @__PURE__ */ new Map();
+  /**
+   * Set audio samples for a resource
+   */
+  set(resourceId, samples, metadata) {
+    const totalBytes = samples.reduce((sum, s) => sum + s.byteLength, 0);
+    const durationUs = samples.length > 0 ? samples[samples.length - 1].timestamp + (samples[samples.length - 1].duration ?? 0) : 0;
+    this.cache.set(resourceId, {
+      resourceId,
+      samples,
+      metadata,
+      totalBytes,
+      durationUs
+    });
+  }
+  /**
+   * Get audio record for a resource
+   */
+  get(resourceId) {
+    return this.cache.get(resourceId) || null;
+  }
+  /**
+   * Check if resource has audio samples
+   */
+  has(resourceId) {
+    return this.cache.has(resourceId);
+  }
+  /**
+   * Get samples in time range (for clip trimming)
+   */
+  getSamplesInRange(resourceId, startUs, endUs) {
+    const record = this.cache.get(resourceId);
+    if (!record) return [];
+    return record.samples.filter((s) => {
+      const sampleEndUs = s.timestamp + (s.duration ?? 0);
+      return s.timestamp < endUs && sampleEndUs > startUs;
+    });
+  }
+  /**
+   * Delete audio samples for a resource
+   */
+  delete(resourceId) {
+    const record = this.cache.get(resourceId);
+    if (record) {
+      this.cache.delete(resourceId);
+    }
+  }
+  /**
+   * Clear all cached audio samples
+   */
+  clear() {
+    this.cache.clear();
+  }
+  /**
+   * Get total memory usage
+   */
+  getTotalBytes() {
+    let total = 0;
+    for (const record of this.cache.values()) {
+      total += record.totalBytes;
+    }
+    return total;
+  }
+}
+export {
+  AudioSampleCache
+};
+//# sourceMappingURL=AudioSampleCache.js.map

package/dist/cache/resource/AudioSampleCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioSampleCache.js","sources":["../../../src/cache/resource/AudioSampleCache.ts"],"sourcesContent":["import type { TimeUs } from '../../model/types';\n\nexport interface AudioSampleRecord {\n  resourceId: string;\n  samples: EncodedAudioChunk[];\n  metadata: AudioDecoderConfig;\n  totalBytes: number;\n  durationUs: TimeUs;\n}\n\n/**\n * AudioSampleCache - Resource-level audio sample cache\n *\n * Caches all encoded audio samples from MP4 in memory\n * Audio data is small (~100KB for 30s AAC, ~6MB for 30min)\n *\n * Strategy:\n * - Extract all audio samples during moov parsing (one-time cost)\n * - Keep encoded chunks in memory (compressed)\n * - Decode to PCM on-demand when clip is played\n */\nexport class AudioSampleCache {\n  private cache = new Map<string, AudioSampleRecord>();\n\n  /**\n   * Set audio samples for a resource\n   */\n  set(resourceId: string, samples: EncodedAudioChunk[], metadata: AudioDecoderConfig): void {\n    const totalBytes = samples.reduce((sum, s) => sum + s.byteLength, 0);\n    const durationUs =\n      samples.length > 0\n        ? samples[samples.length - 1]!.timestamp + (samples[samples.length - 1]!.duration ?? 0)\n        : 0;\n\n    this.cache.set(resourceId, {\n      resourceId,\n      samples,\n      metadata,\n      totalBytes,\n      durationUs,\n    });\n  }\n\n  /**\n   * Get audio record for a resource\n   */\n  get(resourceId: string): AudioSampleRecord | null {\n    return this.cache.get(resourceId) || null;\n  }\n\n  /**\n   * Check if resource has audio samples\n   */\n  has(resourceId: string): boolean {\n    return this.cache.has(resourceId);\n  }\n\n  /**\n   * Get samples in time range (for clip trimming)\n   */\n  getSamplesInRange(resourceId: string, startUs: TimeUs, endUs: TimeUs): EncodedAudioChunk[] {\n    const record = this.cache.get(resourceId);\n    if (!record) return [];\n\n    return record.samples.filter((s) => {\n      const sampleEndUs = s.timestamp + (s.duration ?? 0);\n      // Include sample if it overlaps with range\n      return s.timestamp < endUs && sampleEndUs > startUs;\n    });\n  }\n\n  /**\n   * Delete audio samples for a resource\n   */\n  delete(resourceId: string): void {\n    const record = this.cache.get(resourceId);\n    if (record) {\n      // Note: EncodedAudioChunk doesn't have close() method\n      // Chunks will be garbage collected automatically\n      this.cache.delete(resourceId);\n    }\n  }\n\n  /**\n   * Clear all cached audio samples\n   */\n  clear(): void {\n    // Note: EncodedAudioChunk doesn't have close() method\n    // Chunks will be garbage collected automatically\n    this.cache.clear();\n  }\n\n  /**\n   * Get total memory usage\n   */\n  getTotalBytes(): number {\n    let total = 0;\n    for (const record of this.cache.values()) {\n      total += record.totalBytes;\n    }\n    return total;\n  }\n}\n"],"names":[],"mappings":"AAqBO,MAAM,iBAAiB;AAAA,EACpB,4BAAY,IAAA;AAAA;AAAA;AAAA;AAAA,EAKpB,IAAI,YAAoB,SAA8B,UAAoC;AACxF,UAAM,aAAa,QAAQ,OAAO,CAAC,KAAK,MAAM,MAAM,EAAE,YAAY,CAAC;AACnE,UAAM,aACJ,QAAQ,SAAS,IACb,QAAQ,QAAQ,SAAS,CAAC,EAAG,aAAa,QAAQ,QAAQ,SAAS,CAAC,EAAG,YAAY,KACnF;AAEN,SAAK,MAAM,IAAI,YAAY;AAAA,MACzB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IAAA,CACD;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,YAA8C;AAChD,WAAO,KAAK,MAAM,IAAI,UAAU,KAAK;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,YAA6B;AAC/B,WAAO,KAAK,MAAM,IAAI,UAAU;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,kBAAkB,YAAoB,SAAiB,OAAoC;AACzF,UAAM,SAAS,KAAK,MAAM,IAAI,UAAU;AACxC,QAAI,CAAC,OAAQ,QAAO,CAAA;AAEpB,WAAO,OAAO,QAAQ,OAAO,CAAC,MAAM;AAClC,YAAM,cAAc,EAAE,aAAa,EAAE,YAAY;AAEjD,aAAO,EAAE,YAAY,SAAS,cAAc;AAAA,IAC9C,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,YAA0B;AAC/B,UAAM,SAAS,KAAK,MAAM,IAAI,UAAU;AACxC,QAAI,QAAQ;AAGV,WAAK,MAAM,OAAO,UAAU;AAAA,IAC9B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,QAAc;AAGZ,SAAK,MAAM,MAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAwB;AACtB,QAAI,QAAQ;AACZ,eAAW,UAAU,KAAK,MAAM,OAAA,GAAU;AACxC,eAAS,OAAO;AAAA,IAClB;AACA,WAAO;AAAA,EACT;AACF;"}

package/dist/cache/resource/ImageBitmapCache.d.ts

@@ -0,0 +1,65 @@
+export interface ImageBitmapRecord {
+    resourceId: string;
+    bitmap: ImageBitmap;
+    width: number;
+    height: number;
+    sizeBytes: number;
+}
+/**
+ * ImageBitmapCache - Resource-level image bitmap cache
+ *
+ * Caches decoded ImageBitmap for image resources in main thread
+ * Used by OnDemandComposeSession for image clip composition
+ *
+ * Strategy:
+ * - Store ImageBitmap after ResourceLoader downloads image
+ * - Keep in main thread memory for direct access
+ * - Close and evict when memory pressure is high
+ *
+ * Memory usage:
+ * - Typical image (1080p): width * height * 4 bytes = ~8MB
+ * - Cache ~10 images max to stay under ~100MB
+ */
+export declare class ImageBitmapCache {
+    private cache;
+    private maxCacheSizeMB;
+    private currentSizeBytes;
+    constructor(maxCacheSizeMB?: number);
+    /**
+     * Set image bitmap for a resource
+     */
+    set(resourceId: string, bitmap: ImageBitmap): void;
+    /**
+     * Get image bitmap for a resource
+     */
+    get(resourceId: string): ImageBitmap | null;
+    /**
+     * Get full record with metadata
+     */
+    getRecord(resourceId: string): ImageBitmapRecord | null;
+    /**
+     * Check if resource has bitmap cached
+     */
+    has(resourceId: string): boolean;
+    /**
+     * Delete bitmap for a resource
+     */
+    delete(resourceId: string): void;
+    /**
+     * Clear all cached bitmaps
+     */
+    clear(): void;
+    /**
+     * Get total memory usage in bytes
+     */
+    getTotalBytes(): number;
+    /**
+     * Get total memory usage in MB
+     */
+    getTotalMB(): number;
+    /**
+     * Evict oldest entries if over size limit
+     */
+    private evictIfNeeded;
+}
+//# sourceMappingURL=ImageBitmapCache.d.ts.map

package/dist/cache/resource/ImageBitmapCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageBitmapCache.d.ts","sourceRoot":"","sources":["../../../src/cache/resource/ImageBitmapCache.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,cAAc,CAAO;IAC7B,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,cAAc,SAAM;IAIhC;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IA0BlD;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAK3C;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAIvD;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAShC;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,OAAO,CAAC,aAAa;CAetB"}

package/dist/cache/resource/ImageBitmapCache.js

@@ -0,0 +1,101 @@
+class ImageBitmapCache {
+  cache = /* @__PURE__ */ new Map();
+  maxCacheSizeMB = 100;
+  // Default 100MB
+  currentSizeBytes = 0;
+  constructor(maxCacheSizeMB = 100) {
+    this.maxCacheSizeMB = maxCacheSizeMB;
+  }
+  /**
+   * Set image bitmap for a resource
+   */
+  set(resourceId, bitmap) {
+    const existing = this.cache.get(resourceId);
+    if (existing) {
+      existing.bitmap.close();
+      this.currentSizeBytes -= existing.sizeBytes;
+    }
+    const sizeBytes = bitmap.width * bitmap.height * 4;
+    const record = {
+      resourceId,
+      bitmap,
+      width: bitmap.width,
+      height: bitmap.height,
+      sizeBytes
+    };
+    this.cache.set(resourceId, record);
+    this.currentSizeBytes += sizeBytes;
+    this.evictIfNeeded();
+  }
+  /**
+   * Get image bitmap for a resource
+   */
+  get(resourceId) {
+    const record = this.cache.get(resourceId);
+    return record ? record.bitmap : null;
+  }
+  /**
+   * Get full record with metadata
+   */
+  getRecord(resourceId) {
+    return this.cache.get(resourceId) || null;
+  }
+  /**
+   * Check if resource has bitmap cached
+   */
+  has(resourceId) {
+    return this.cache.has(resourceId);
+  }
+  /**
+   * Delete bitmap for a resource
+   */
+  delete(resourceId) {
+    const record = this.cache.get(resourceId);
+    if (record) {
+      record.bitmap.close();
+      this.currentSizeBytes -= record.sizeBytes;
+      this.cache.delete(resourceId);
+    }
+  }
+  /**
+   * Clear all cached bitmaps
+   */
+  clear() {
+    for (const record of this.cache.values()) {
+      record.bitmap.close();
+    }
+    this.cache.clear();
+    this.currentSizeBytes = 0;
+  }
+  /**
+   * Get total memory usage in bytes
+   */
+  getTotalBytes() {
+    return this.currentSizeBytes;
+  }
+  /**
+   * Get total memory usage in MB
+   */
+  getTotalMB() {
+    return this.currentSizeBytes / (1024 * 1024);
+  }
+  /**
+   * Evict oldest entries if over size limit
+   */
+  evictIfNeeded() {
+    const maxBytes = this.maxCacheSizeMB * 1024 * 1024;
+    if (this.currentSizeBytes > maxBytes) {
+      const entries = Array.from(this.cache.entries());
+      let evictIndex = 0;
+      while (this.currentSizeBytes > maxBytes && evictIndex < entries.length) {
+        const [resourceId] = entries[evictIndex];
+        this.delete(resourceId);
+        evictIndex++;
+      }
+    }
+  }
+}
+export {
+  ImageBitmapCache
+};
+//# sourceMappingURL=ImageBitmapCache.js.map

package/dist/cache/resource/ImageBitmapCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageBitmapCache.js","sources":["../../../src/cache/resource/ImageBitmapCache.ts"],"sourcesContent":["export interface ImageBitmapRecord {\n  resourceId: string;\n  bitmap: ImageBitmap;\n  width: number;\n  height: number;\n  sizeBytes: number; // Estimated memory usage\n}\n\n/**\n * ImageBitmapCache - Resource-level image bitmap cache\n *\n * Caches decoded ImageBitmap for image resources in main thread\n * Used by OnDemandComposeSession for image clip composition\n *\n * Strategy:\n * - Store ImageBitmap after ResourceLoader downloads image\n * - Keep in main thread memory for direct access\n * - Close and evict when memory pressure is high\n *\n * Memory usage:\n * - Typical image (1080p): width * height * 4 bytes = ~8MB\n * - Cache ~10 images max to stay under ~100MB\n */\nexport class ImageBitmapCache {\n  private cache = new Map<string, ImageBitmapRecord>();\n  private maxCacheSizeMB = 100; // Default 100MB\n  private currentSizeBytes = 0;\n\n  constructor(maxCacheSizeMB = 100) {\n    this.maxCacheSizeMB = maxCacheSizeMB;\n  }\n\n  /**\n   * Set image bitmap for a resource\n   */\n  set(resourceId: string, bitmap: ImageBitmap): void {\n    // Close existing bitmap if present\n    const existing = this.cache.get(resourceId);\n    if (existing) {\n      existing.bitmap.close();\n      this.currentSizeBytes -= existing.sizeBytes;\n    }\n\n    // Estimate memory usage (RGBA format)\n    const sizeBytes = bitmap.width * bitmap.height * 4;\n\n    const record: ImageBitmapRecord = {\n      resourceId,\n      bitmap,\n      width: bitmap.width,\n      height: bitmap.height,\n      sizeBytes,\n    };\n\n    this.cache.set(resourceId, record);\n    this.currentSizeBytes += sizeBytes;\n\n    // Evict if over limit (simple FIFO for now)\n    this.evictIfNeeded();\n  }\n\n  /**\n   * Get image bitmap for a resource\n   */\n  get(resourceId: string): ImageBitmap | null {\n    const record = this.cache.get(resourceId);\n    return record ? record.bitmap : null;\n  }\n\n  /**\n   * Get full record with metadata\n   */\n  getRecord(resourceId: string): ImageBitmapRecord | null {\n    return this.cache.get(resourceId) || null;\n  }\n\n  /**\n   * Check if resource has bitmap cached\n   */\n  has(resourceId: string): boolean {\n    return this.cache.has(resourceId);\n  }\n\n  /**\n   * Delete bitmap for a resource\n   */\n  delete(resourceId: string): void {\n    const record = this.cache.get(resourceId);\n    if (record) {\n      record.bitmap.close();\n      this.currentSizeBytes -= record.sizeBytes;\n      this.cache.delete(resourceId);\n    }\n  }\n\n  /**\n   * Clear all cached bitmaps\n   */\n  clear(): void {\n    for (const record of this.cache.values()) {\n      record.bitmap.close();\n    }\n    this.cache.clear();\n    this.currentSizeBytes = 0;\n  }\n\n  /**\n   * Get total memory usage in bytes\n   */\n  getTotalBytes(): number {\n    return this.currentSizeBytes;\n  }\n\n  /**\n   * Get total memory usage in MB\n   */\n  getTotalMB(): number {\n    return this.currentSizeBytes / (1024 * 1024);\n  }\n\n  /**\n   * Evict oldest entries if over size limit\n   */\n  private evictIfNeeded(): void {\n    const maxBytes = this.maxCacheSizeMB * 1024 * 1024;\n\n    // Simple FIFO eviction: remove oldest entries until under limit\n    if (this.currentSizeBytes > maxBytes) {\n      const entries = Array.from(this.cache.entries());\n      let evictIndex = 0;\n\n      while (this.currentSizeBytes > maxBytes && evictIndex < entries.length) {\n        const [resourceId] = entries[evictIndex]!;\n        this.delete(resourceId);\n        evictIndex++;\n      }\n    }\n  }\n}\n"],"names":[],"mappings":"AAuBO,MAAM,iBAAiB;AAAA,EACpB,4BAAY,IAAA;AAAA,EACZ,iBAAiB;AAAA;AAAA,EACjB,mBAAmB;AAAA,EAE3B,YAAY,iBAAiB,KAAK;AAChC,SAAK,iBAAiB;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,YAAoB,QAA2B;AAEjD,UAAM,WAAW,KAAK,MAAM,IAAI,UAAU;AAC1C,QAAI,UAAU;AACZ,eAAS,OAAO,MAAA;AAChB,WAAK,oBAAoB,SAAS;AAAA,IACpC;AAGA,UAAM,YAAY,OAAO,QAAQ,OAAO,SAAS;AAEjD,UAAM,SAA4B;AAAA,MAChC;AAAA,MACA;AAAA,MACA,OAAO,OAAO;AAAA,MACd,QAAQ,OAAO;AAAA,MACf;AAAA,IAAA;AAGF,SAAK,MAAM,IAAI,YAAY,MAAM;AACjC,SAAK,oBAAoB;AAGzB,SAAK,cAAA;AAAA,EACP;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,YAAwC;AAC1C,UAAM,SAAS,KAAK,MAAM,IAAI,UAAU;AACxC,WAAO,SAAS,OAAO,SAAS;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU,YAA8C;AACtD,WAAO,KAAK,MAAM,IAAI,UAAU,KAAK;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,YAA6B;AAC/B,WAAO,KAAK,MAAM,IAAI,UAAU;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,YAA0B;AAC/B,UAAM,SAAS,KAAK,MAAM,IAAI,UAAU;AACxC,QAAI,QAAQ;AACV,aAAO,OAAO,MAAA;AACd,WAAK,oBAAoB,OAAO;AAChC,WAAK,MAAM,OAAO,UAAU;AAAA,IAC9B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,QAAc;AACZ,eAAW,UAAU,KAAK,MAAM,OAAA,GAAU;AACxC,aAAO,OAAO,MAAA;AAAA,IAChB;AACA,SAAK,MAAM,MAAA;AACX,SAAK,mBAAmB;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAwB;AACtB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,aAAqB;AACnB,WAAO,KAAK,oBAAoB,OAAO;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA,EAKQ,gBAAsB;AAC5B,UAAM,WAAW,KAAK,iBAAiB,OAAO;AAG9C,QAAI,KAAK,mBAAmB,UAAU;AACpC,YAAM,UAAU,MAAM,KAAK,KAAK,MAAM,SAAS;AAC/C,UAAI,aAAa;AAEjB,aAAO,KAAK,mBAAmB,YAAY,aAAa,QAAQ,QAAQ;AACtE,cAAM,CAAC,UAAU,IAAI,QAAQ,UAAU;AACvC,aAAK,OAAO,UAAU;AACtB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;"}

package/dist/cache/resource/MP4IndexCache.d.ts

@@ -0,0 +1,48 @@
+import { MP4Index, Sample, GOPRange } from '../../stages/demux/types';
+import { TimeUs } from '../../model/types';
+
+/**
+ * MP4IndexCache - In-memory cache for MP4 indexes
+ *
+ * Provides fast lookup for:
+ * - Sample at specific timestamp
+ * - GOP range for time range
+ * - Nearest keyframe
+ */
+export declare class MP4IndexCache {
+    private indexes;
+    /**
+     * Set index for a resource
+     */
+    set(resourceId: string, index: MP4Index): void;
+    /**
+     * Get index for a resource
+     */
+    get(resourceId: string): MP4Index | null;
+    /**
+     * Check if index exists for a resource
+     */
+    has(resourceId: string): boolean;
+    /**
+     * Get GOP range (byte range) for a specific time
+     * Returns the GOP that contains the target time
+     */
+    getGOPRangeForTime(resourceId: string, timeUs: TimeUs): GOPRange | null;
+    /**
+     * Get sample at specific timestamp
+     */
+    getSampleAtTime(resourceId: string, timeUs: TimeUs): Sample | null;
+    /**
+     * Get nearest keyframe before or at the target time
+     */
+    getNearestKeyframe(resourceId: string, timeUs: TimeUs): Sample | null;
+    /**
+     * Clear all cached indexes
+     */
+    clear(): void;
+    /**
+     * Remove index for a specific resource
+     */
+    remove(resourceId: string): void;
+}
+//# sourceMappingURL=MP4IndexCache.d.ts.map

package/dist/cache/resource/MP4IndexCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MP4IndexCache.d.ts","sourceRoot":"","sources":["../../../src/cache/resource/MP4IndexCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAA+B;IAE9C;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI9C;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAIxC;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIhC;;;OAGG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IA0CvE;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAclE;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAwBrE;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAGjC"}