@editframe/elements 0.23.8-beta.0 → 0.25.0-beta.0

package/dist/elements/EFMedia/videoTasks/ScrubInputCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrubInputCache.js","names":[],"sources":["../../../../src/elements/EFMedia/videoTasks/ScrubInputCache.ts"],"sourcesContent":["import type { BufferedSeekingInput } from \"../BufferedSeekingInput\";\n\n/**\n * Cache for scrub BufferedSeekingInput instances\n * Since scrub segments are 30s long, we can reuse the same input for many seeks\n * within that time range, making scrub seeking very efficient\n */\nexport class ScrubInputCache {\n  private cache = new Map<number, BufferedSeekingInput>();\n  private maxCacheSize = 5; // Keep last 5 scrub inputs (covers 2.5 minutes)\n\n  /**\n   * Get or create BufferedSeekingInput for a scrub segment\n   */\n  async getOrCreateInput(\n    segmentId: number,\n    createInputFn: () => Promise<BufferedSeekingInput | undefined>,\n  ): Promise<BufferedSeekingInput | undefined> {\n    // Check if we already have this segment cached\n    const cached = this.cache.get(segmentId);\n    if (cached) {\n      return cached;\n    }\n\n    // Create new input\n    const input = await createInputFn();\n    if (!input) {\n      return undefined;\n    }\n\n    // Add to cache and maintain size limit\n    this.cache.set(segmentId, input);\n\n    // Evict oldest entries if cache is too large\n    if (this.cache.size > this.maxCacheSize) {\n      const oldestKey = this.cache.keys().next().value;\n      if (oldestKey !== undefined) {\n        this.cache.delete(oldestKey);\n      }\n    }\n\n    return input;\n  }\n\n  /**\n   * Clear the entire cache (called when video changes)\n   */\n  clear() {\n    this.cache.clear();\n  }\n\n  /**\n   * Get cache statistics\n   */\n  getStats() {\n    return {\n      size: this.cache.size,\n      segmentIds: Array.from(this.cache.keys()),\n    };\n  }\n}\n"],"mappings":";;;;;;AAOA,IAAa,kBAAb,MAA6B;;+BACX,IAAI,KAAmC;sBAChC;;;;;CAKvB,MAAM,iBACJ,WACA,eAC2C;EAE3C,MAAM,SAAS,KAAK,MAAM,IAAI,UAAU;AACxC,MAAI,OACF,QAAO;EAIT,MAAM,QAAQ,MAAM,eAAe;AACnC,MAAI,CAAC,MACH;AAIF,OAAK,MAAM,IAAI,WAAW,MAAM;AAGhC,MAAI,KAAK,MAAM,OAAO,KAAK,cAAc;GACvC,MAAM,YAAY,KAAK,MAAM,MAAM,CAAC,MAAM,CAAC;AAC3C,OAAI,cAAc,OAChB,MAAK,MAAM,OAAO,UAAU;;AAIhC,SAAO;;;;;CAMT,QAAQ;AACN,OAAK,MAAM,OAAO;;;;;CAMpB,WAAW;AACT,SAAO;GACL,MAAM,KAAK,MAAM;GACjB,YAAY,MAAM,KAAK,KAAK,MAAM,MAAM,CAAC;GAC1C"}

package/dist/elements/EFMedia/videoTasks/makeScrubVideoBufferTask.js

@@ -2,6 +2,13 @@ import { EF_INTERACTIVE } from "../../../EF_INTERACTIVE.js";
 import { EF_RENDERING } from "../../../EF_RENDERING.js";
 import { manageMediaBuffer } from "../shared/BufferUtils.js";
 import { Task } from "@lit/task";
+
+//#region src/elements/EFMedia/videoTasks/makeScrubVideoBufferTask.ts
+/**
+* Scrub video buffer task - aggressively preloads the ENTIRE scrub track
+* Unlike main video buffering, this loads the full duration with higher concurrency
+* for instant visual feedback during seeking
+*/
 const makeScrubVideoBufferTask = (host) => {
 	let currentState = {
 		currentSeekTimeMs: 0,
@@ -62,4 +69,7 @@ const makeScrubVideoBufferTask = (host) => {
 		}
 	});
 };
+
+//#endregion
 export { makeScrubVideoBufferTask };
+//# sourceMappingURL=makeScrubVideoBufferTask.js.map

package/dist/elements/EFMedia/videoTasks/makeScrubVideoBufferTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeScrubVideoBufferTask.js","names":["currentState: MediaBufferState"],"sources":["../../../../src/elements/EFMedia/videoTasks/makeScrubVideoBufferTask.ts"],"sourcesContent":["import { Task } from \"@lit/task\";\n\nimport { EF_INTERACTIVE } from \"../../../EF_INTERACTIVE.js\";\nimport { EF_RENDERING } from \"../../../EF_RENDERING.js\";\nimport type { VideoRendition } from \"../../../transcoding/types\";\nimport type { EFVideo } from \"../../EFVideo\";\nimport type { MediaBufferState } from \"../shared/BufferUtils\";\nimport { manageMediaBuffer } from \"../shared/BufferUtils\";\n\n/**\n * Scrub video buffer task - aggressively preloads the ENTIRE scrub track\n * Unlike main video buffering, this loads the full duration with higher concurrency\n * for instant visual feedback during seeking\n */\nexport const makeScrubVideoBufferTask = (host: EFVideo) => {\n  let currentState: MediaBufferState = {\n    currentSeekTimeMs: 0,\n    requestedSegments: new Set(),\n    activeRequests: new Set(),\n    requestQueue: [],\n  };\n\n  return new Task(host, {\n    autoRun: EF_INTERACTIVE,\n    args: () => [host.mediaEngineTask.value] as const,\n    onError: (error) => {\n      console.error(\"scrubVideoBufferTask error\", error);\n    },\n    onComplete: (value) => {\n      currentState = value as MediaBufferState;\n    },\n    task: async ([mediaEngine], { signal }) => {\n      // Skip entirely in rendering mode\n      if (EF_RENDERING()) {\n        return currentState;\n      }\n\n      // Don't run if video buffering is disabled\n      if (!host.enableVideoBuffering) {\n        return currentState;\n      }\n\n      // Need media engine to be available\n      if (!mediaEngine) {\n        return currentState;\n      }\n\n      // Get scrub rendition using the proper interface method\n      const scrubRendition = mediaEngine.getScrubVideoRendition();\n\n      if (!scrubRendition) {\n        // No scrub rendition available - this is fine, just return current state\n        return currentState;\n      }\n\n      // Add src to rendition\n      const scrubRenditionWithSrc = {\n        ...scrubRendition,\n        src: mediaEngine.src,\n      };\n\n      try {\n        // First, ensure the init segment is cached for scrub content\n        try {\n          await mediaEngine.fetchInitSegment(scrubRenditionWithSrc, signal);\n        } catch (error) {\n          console.warn(\n            \"ScrubBuffer: Failed to cache scrub init segment:\",\n            error,\n          );\n        }\n\n        // Aggressively buffer the ENTIRE scrub track\n        const newState = await manageMediaBuffer<VideoRendition>(\n          0, // Always start from beginning to ensure complete coverage\n          {\n            // Buffer entire duration - scrub segments are 30s so much fewer total segments\n            bufferDurationMs: mediaEngine.durationMs,\n            // High concurrency for scrub - fewer segments overall (30s each vs 2s for main)\n            // E.g., 10min video = ~20 scrub segments vs ~300 main segments\n            maxParallelFetches: 10,\n            enableBuffering: true,\n            enableContinuousBuffering: true, // Keep going until all segments loaded\n          },\n          currentState,\n          mediaEngine.durationMs,\n          signal,\n          {\n            computeSegmentId: async (timeMs, rendition) => {\n              return mediaEngine.computeSegmentId(timeMs, rendition);\n            },\n            prefetchSegment: async (segmentId, rendition) => {\n              // Use the media engine to fetch and cache scrub segments\n              await mediaEngine.fetchMediaSegment(segmentId, rendition);\n            },\n            isSegmentCached: (segmentId, rendition) => {\n              return mediaEngine.isSegmentCached(segmentId, rendition);\n            },\n            getRendition: async () => scrubRenditionWithSrc,\n            logError: (message, error) => {\n              console.warn(`ScrubBuffer: ${message}`, error);\n            },\n          },\n        );\n\n        return newState;\n      } catch (error) {\n        if (signal.aborted) return currentState;\n        console.warn(\"ScrubBuffer failed:\", error);\n        return currentState;\n      }\n    },\n  });\n};\n"],"mappings":";;;;;;;;;;;AAcA,MAAa,4BAA4B,SAAkB;CACzD,IAAIA,eAAiC;EACnC,mBAAmB;EACnB,mCAAmB,IAAI,KAAK;EAC5B,gCAAgB,IAAI,KAAK;EACzB,cAAc,EAAE;EACjB;AAED,QAAO,IAAI,KAAK,MAAM;EACpB,SAAS;EACT,YAAY,CAAC,KAAK,gBAAgB,MAAM;EACxC,UAAU,UAAU;AAClB,WAAQ,MAAM,8BAA8B,MAAM;;EAEpD,aAAa,UAAU;AACrB,kBAAe;;EAEjB,MAAM,OAAO,CAAC,cAAc,EAAE,aAAa;AAEzC,OAAI,cAAc,CAChB,QAAO;AAIT,OAAI,CAAC,KAAK,qBACR,QAAO;AAIT,OAAI,CAAC,YACH,QAAO;GAIT,MAAM,iBAAiB,YAAY,wBAAwB;AAE3D,OAAI,CAAC,eAEH,QAAO;GAIT,MAAM,wBAAwB;IAC5B,GAAG;IACH,KAAK,YAAY;IAClB;AAED,OAAI;AAEF,QAAI;AACF,WAAM,YAAY,iBAAiB,uBAAuB,OAAO;aAC1D,OAAO;AACd,aAAQ,KACN,oDACA,MACD;;AAoCH,WAhCiB,MAAM,kBACrB,GACA;KAEE,kBAAkB,YAAY;KAG9B,oBAAoB;KACpB,iBAAiB;KACjB,2BAA2B;KAC5B,EACD,cACA,YAAY,YACZ,QACA;KACE,kBAAkB,OAAO,QAAQ,cAAc;AAC7C,aAAO,YAAY,iBAAiB,QAAQ,UAAU;;KAExD,iBAAiB,OAAO,WAAW,cAAc;AAE/C,YAAM,YAAY,kBAAkB,WAAW,UAAU;;KAE3D,kBAAkB,WAAW,cAAc;AACzC,aAAO,YAAY,gBAAgB,WAAW,UAAU;;KAE1D,cAAc,YAAY;KAC1B,WAAW,SAAS,UAAU;AAC5B,cAAQ,KAAK,gBAAgB,WAAW,MAAM;;KAEjD,CACF;YAGM,OAAO;AACd,QAAI,OAAO,QAAS,QAAO;AAC3B,YAAQ,KAAK,uBAAuB,MAAM;AAC1C,WAAO;;;EAGZ,CAAC"}

package/dist/elements/EFMedia/videoTasks/makeScrubVideoInitSegmentFetchTask.js

@@ -1,5 +1,7 @@
 import { getLatestMediaEngine } from "../tasks/makeMediaEngineTask.js";
 import { Task } from "@lit/task";
+
+//#region src/elements/EFMedia/videoTasks/makeScrubVideoInitSegmentFetchTask.ts
 const makeScrubVideoInitSegmentFetchTask = (host) => {
 	return new Task(host, {
 		args: () => [host.mediaEngineTask.value],
@@ -18,4 +20,7 @@ const makeScrubVideoInitSegmentFetchTask = (host) => {
 		}
 	});
 };
+
+//#endregion
 export { makeScrubVideoInitSegmentFetchTask };
+//# sourceMappingURL=makeScrubVideoInitSegmentFetchTask.js.map

package/dist/elements/EFMedia/videoTasks/makeScrubVideoInitSegmentFetchTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeScrubVideoInitSegmentFetchTask.js","names":[],"sources":["../../../../src/elements/EFMedia/videoTasks/makeScrubVideoInitSegmentFetchTask.ts"],"sourcesContent":["import { Task } from \"@lit/task\";\nimport type { MediaEngine } from \"../../../transcoding/types\";\nimport type { EFVideo } from \"../../EFVideo\";\nimport { getLatestMediaEngine } from \"../tasks/makeMediaEngineTask\";\n\nexport const makeScrubVideoInitSegmentFetchTask = (\n  host: EFVideo,\n): Task<readonly [MediaEngine | undefined], ArrayBuffer> => {\n  return new Task(host, {\n    args: () => [host.mediaEngineTask.value] as const,\n    onError: (error) => {\n      console.error(\"scrubVideoInitSegmentFetchTask error\", error);\n    },\n    onComplete: (_value) => {},\n    task: async ([_mediaEngine], { signal }) => {\n      const mediaEngine = await getLatestMediaEngine(host, signal);\n\n      // Get scrub rendition using the proper interface method\n      const scrubRendition = mediaEngine.getScrubVideoRendition();\n\n      if (!scrubRendition) {\n        // No scrub rendition available - this is fine, scrub is optional\n        throw new Error(\"No scrub rendition available\");\n      }\n\n      return mediaEngine.fetchInitSegment(\n        {\n          ...scrubRendition,\n          src: mediaEngine.src, // Ensure src is set\n        },\n        signal,\n      );\n    },\n  });\n};\n"],"mappings":";;;;AAKA,MAAa,sCACX,SAC0D;AAC1D,QAAO,IAAI,KAAK,MAAM;EACpB,YAAY,CAAC,KAAK,gBAAgB,MAAM;EACxC,UAAU,UAAU;AAClB,WAAQ,MAAM,wCAAwC,MAAM;;EAE9D,aAAa,WAAW;EACxB,MAAM,OAAO,CAAC,eAAe,EAAE,aAAa;GAC1C,MAAM,cAAc,MAAM,qBAAqB,MAAM,OAAO;GAG5D,MAAM,iBAAiB,YAAY,wBAAwB;AAE3D,OAAI,CAAC,eAEH,OAAM,IAAI,MAAM,+BAA+B;AAGjD,UAAO,YAAY,iBACjB;IACE,GAAG;IACH,KAAK,YAAY;IAClB,EACD,OACD;;EAEJ,CAAC"}

package/dist/elements/EFMedia/videoTasks/makeScrubVideoInputTask.js

@@ -1,6 +1,8 @@
 import { BufferedSeekingInput } from "../BufferedSeekingInput.js";
 import { EFMedia } from "../../EFMedia.js";
 import { Task } from "@lit/task";
+
+//#region src/elements/EFMedia/videoTasks/makeScrubVideoInputTask.ts
 const makeScrubVideoInputTask = (host) => {
 	return new Task(host, {
 		args: () => [host.scrubVideoInitSegmentFetchTask.value, host.scrubVideoSegmentFetchTask.value],
@@ -27,4 +29,7 @@ const makeScrubVideoInputTask = (host) => {
 		}
 	});
 };
+
+//#endregion
 export { makeScrubVideoInputTask };
+//# sourceMappingURL=makeScrubVideoInputTask.js.map

package/dist/elements/EFMedia/videoTasks/makeScrubVideoInputTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeScrubVideoInputTask.js","names":[],"sources":["../../../../src/elements/EFMedia/videoTasks/makeScrubVideoInputTask.ts"],"sourcesContent":["import { Task } from \"@lit/task\";\n\nimport { EFMedia } from \"../../EFMedia\";\nimport type { EFVideo } from \"../../EFVideo\";\nimport { BufferedSeekingInput } from \"../BufferedSeekingInput\";\nimport type { InputTask } from \"../shared/MediaTaskUtils\";\n\nexport const makeScrubVideoInputTask = (host: EFVideo): InputTask => {\n  return new Task<\n    readonly [ArrayBuffer | undefined, ArrayBuffer | undefined],\n    BufferedSeekingInput | undefined\n  >(host, {\n    args: () =>\n      [\n        host.scrubVideoInitSegmentFetchTask.value,\n        host.scrubVideoSegmentFetchTask.value,\n      ] as const,\n    onError: (error) => {\n      console.error(\"scrubVideoInputTask error\", error);\n    },\n    onComplete: (_value) => {},\n    task: async (_, { signal }) => {\n      const initSegment =\n        await host.scrubVideoInitSegmentFetchTask.taskComplete;\n      if (signal.aborted) return undefined;\n\n      const segment = await host.scrubVideoSegmentFetchTask.taskComplete;\n      if (signal.aborted) return undefined;\n\n      if (!initSegment || !segment) {\n        throw new Error(\"Scrub init segment or segment is not available\");\n      }\n\n      // Get startTimeOffsetMs from the scrub rendition if available\n      const mediaEngine = await host.mediaEngineTask.taskComplete;\n      if (signal.aborted) return undefined;\n\n      const scrubRendition = mediaEngine.getScrubVideoRendition();\n      const startTimeOffsetMs = scrubRendition?.startTimeOffsetMs;\n\n      const arrayBuffer = await new Blob([initSegment, segment]).arrayBuffer();\n      if (signal.aborted) return undefined;\n\n      const input = new BufferedSeekingInput(arrayBuffer, {\n        videoBufferSize: EFMedia.VIDEO_SAMPLE_BUFFER_SIZE,\n        audioBufferSize: EFMedia.AUDIO_SAMPLE_BUFFER_SIZE,\n        startTimeOffsetMs,\n      });\n      return input;\n    },\n  });\n};\n"],"mappings":";;;;;AAOA,MAAa,2BAA2B,SAA6B;AACnE,QAAO,IAAI,KAGT,MAAM;EACN,YACE,CACE,KAAK,+BAA+B,OACpC,KAAK,2BAA2B,MACjC;EACH,UAAU,UAAU;AAClB,WAAQ,MAAM,6BAA6B,MAAM;;EAEnD,aAAa,WAAW;EACxB,MAAM,OAAO,GAAG,EAAE,aAAa;GAC7B,MAAM,cACJ,MAAM,KAAK,+BAA+B;AAC5C,OAAI,OAAO,QAAS,QAAO;GAE3B,MAAM,UAAU,MAAM,KAAK,2BAA2B;AACtD,OAAI,OAAO,QAAS,QAAO;AAE3B,OAAI,CAAC,eAAe,CAAC,QACnB,OAAM,IAAI,MAAM,iDAAiD;GAInE,MAAM,cAAc,MAAM,KAAK,gBAAgB;AAC/C,OAAI,OAAO,QAAS,QAAO;GAG3B,MAAM,oBADiB,YAAY,wBAAwB,EACjB;GAE1C,MAAM,cAAc,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,CAAC,aAAa;AACxE,OAAI,OAAO,QAAS,QAAO;AAO3B,UALc,IAAI,qBAAqB,aAAa;IAClD,iBAAiB,QAAQ;IACzB,iBAAiB,QAAQ;IACzB;IACD,CAAC;;EAGL,CAAC"}

package/dist/elements/EFMedia/videoTasks/makeScrubVideoSeekTask.js

@@ -1,6 +1,8 @@
 import { ScrubInputCache } from "./ScrubInputCache.js";
 import { Task } from "@lit/task";
-var scrubInputCache = new ScrubInputCache();
+
+//#region src/elements/EFMedia/videoTasks/makeScrubVideoSeekTask.ts
+const scrubInputCache = new ScrubInputCache();
 const makeScrubVideoSeekTask = (host) => {
 	return new Task(host, {
 		args: () => [host.desiredSeekTimeMs],
@@ -48,4 +50,7 @@ const makeScrubVideoSeekTask = (host) => {
 		}
 	});
 };
+
+//#endregion
 export { makeScrubVideoSeekTask };
+//# sourceMappingURL=makeScrubVideoSeekTask.js.map

package/dist/elements/EFMedia/videoTasks/makeScrubVideoSeekTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeScrubVideoSeekTask.js","names":[],"sources":["../../../../src/elements/EFMedia/videoTasks/makeScrubVideoSeekTask.ts"],"sourcesContent":["import { Task } from \"@lit/task\";\n\nimport type { VideoSample } from \"mediabunny\";\n\nimport type { EFVideo } from \"../../EFVideo\";\nimport { ScrubInputCache } from \"./ScrubInputCache\";\n\ntype ScrubVideoSeekTask = Task<readonly [number], VideoSample | undefined>;\n\n// Shared cache instance across all scrub seek tasks\nconst scrubInputCache = new ScrubInputCache();\n\nexport const makeScrubVideoSeekTask = (host: EFVideo): ScrubVideoSeekTask => {\n  return new Task(host, {\n    args: () => [host.desiredSeekTimeMs] as const,\n    onError: (error) => {\n      console.error(\"scrubVideoSeekTask error\", error);\n    },\n    onComplete: (_value) => {},\n    task: async ([desiredSeekTimeMs], { signal }) => {\n      signal.throwIfAborted();\n\n      const mediaEngine = host.mediaEngineTask.value;\n      if (!mediaEngine) {\n        return undefined;\n      }\n\n      // Get scrub rendition using the proper interface method\n      const scrubRendition = mediaEngine.getScrubVideoRendition();\n\n      if (!scrubRendition) {\n        return undefined; // No scrub rendition\n      }\n\n      const scrubRenditionWithSrc = {\n        ...scrubRendition,\n        src: mediaEngine.src,\n      };\n\n      // Compute which scrub segment (30s) contains the desired seek time\n      const segmentId = mediaEngine.computeSegmentId(\n        desiredSeekTimeMs,\n        scrubRenditionWithSrc,\n      );\n      if (segmentId === undefined) {\n        return undefined;\n      }\n\n      // Check if this scrub segment is cached (preloaded by scrub buffer task)\n      const isCached = mediaEngine.isSegmentCached(\n        segmentId,\n        scrubRenditionWithSrc,\n      );\n      if (!isCached) {\n        // Scrub content not preloaded - fail fast, let main video handle it\n        // Scrub's job is instant feedback from cached content only\n        return undefined;\n      }\n\n      signal.throwIfAborted();\n\n      try {\n        // Get or create BufferedSeekingInput for this scrub segment (30s)\n        // This efficiently reuses the same input for seeks within the same 30s range\n        const scrubInput = await scrubInputCache.getOrCreateInput(\n          segmentId,\n          async () => {\n            const [initSegment, mediaSegment] = await Promise.all([\n              mediaEngine.fetchInitSegment(scrubRenditionWithSrc, signal),\n              mediaEngine.fetchMediaSegment(segmentId, scrubRenditionWithSrc),\n            ]);\n\n            if (!initSegment || !mediaSegment || signal.aborted) {\n              return undefined;\n            }\n\n            const { BufferedSeekingInput } = await import(\n              \"../BufferedSeekingInput.js\"\n            );\n            const { EFMedia } = await import(\"../../EFMedia.js\");\n\n            return new BufferedSeekingInput(\n              await new Blob([initSegment, mediaSegment]).arrayBuffer(),\n              {\n                videoBufferSize: EFMedia.VIDEO_SAMPLE_BUFFER_SIZE,\n                audioBufferSize: EFMedia.AUDIO_SAMPLE_BUFFER_SIZE,\n                startTimeOffsetMs: scrubRendition.startTimeOffsetMs,\n              },\n            );\n          },\n        );\n\n        if (!scrubInput) {\n          return undefined;\n        }\n\n        if (signal.aborted) {\n          return undefined;\n        }\n\n        // Get video track and seek to precise time within the 30s scrub segment\n        const videoTrack = await scrubInput.getFirstVideoTrack();\n        if (!videoTrack) {\n          return undefined;\n        }\n\n        if (signal.aborted) {\n          return undefined;\n        }\n\n        const sample = (await scrubInput.seek(\n          videoTrack.id,\n          desiredSeekTimeMs,\n        )) as unknown as VideoSample | undefined;\n\n        return sample;\n      } catch (error) {\n        if (signal.aborted) return undefined;\n        console.warn(\"Failed to get scrub video sample:\", error);\n        return undefined;\n      }\n    },\n  });\n};\n"],"mappings":";;;;AAUA,MAAM,kBAAkB,IAAI,iBAAiB;AAE7C,MAAa,0BAA0B,SAAsC;AAC3E,QAAO,IAAI,KAAK,MAAM;EACpB,YAAY,CAAC,KAAK,kBAAkB;EACpC,UAAU,UAAU;AAClB,WAAQ,MAAM,4BAA4B,MAAM;;EAElD,aAAa,WAAW;EACxB,MAAM,OAAO,CAAC,oBAAoB,EAAE,aAAa;AAC/C,UAAO,gBAAgB;GAEvB,MAAM,cAAc,KAAK,gBAAgB;AACzC,OAAI,CAAC,YACH;GAIF,MAAM,iBAAiB,YAAY,wBAAwB;AAE3D,OAAI,CAAC,eACH;GAGF,MAAM,wBAAwB;IAC5B,GAAG;IACH,KAAK,YAAY;IAClB;GAGD,MAAM,YAAY,YAAY,iBAC5B,mBACA,sBACD;AACD,OAAI,cAAc,OAChB;AAQF,OAAI,CAJa,YAAY,gBAC3B,WACA,sBACD,CAIC;AAGF,UAAO,gBAAgB;AAEvB,OAAI;IAGF,MAAM,aAAa,MAAM,gBAAgB,iBACvC,WACA,YAAY;KACV,MAAM,CAAC,aAAa,gBAAgB,MAAM,QAAQ,IAAI,CACpD,YAAY,iBAAiB,uBAAuB,OAAO,EAC3D,YAAY,kBAAkB,WAAW,sBAAsB,CAChE,CAAC;AAEF,SAAI,CAAC,eAAe,CAAC,gBAAgB,OAAO,QAC1C;KAGF,MAAM,EAAE,yBAAyB,MAAM,OACrC;KAEF,MAAM,EAAE,YAAY,MAAM,OAAO;AAEjC,YAAO,IAAI,qBACT,MAAM,IAAI,KAAK,CAAC,aAAa,aAAa,CAAC,CAAC,aAAa,EACzD;MACE,iBAAiB,QAAQ;MACzB,iBAAiB,QAAQ;MACzB,mBAAmB,eAAe;MACnC,CACF;MAEJ;AAED,QAAI,CAAC,WACH;AAGF,QAAI,OAAO,QACT;IAIF,MAAM,aAAa,MAAM,WAAW,oBAAoB;AACxD,QAAI,CAAC,WACH;AAGF,QAAI,OAAO,QACT;AAQF,WALgB,MAAM,WAAW,KAC/B,WAAW,IACX,kBACD;YAGM,OAAO;AACd,QAAI,OAAO,QAAS,QAAO;AAC3B,YAAQ,KAAK,qCAAqC,MAAM;AACxD;;;EAGL,CAAC"}

package/dist/elements/EFMedia/videoTasks/makeScrubVideoSegmentFetchTask.js

@@ -1,5 +1,7 @@
 import { getLatestMediaEngine } from "../tasks/makeMediaEngineTask.js";
 import { Task } from "@lit/task";
+
+//#region src/elements/EFMedia/videoTasks/makeScrubVideoSegmentFetchTask.ts
 const makeScrubVideoSegmentFetchTask = (host) => {
 	return new Task(host, {
 		args: () => [host.mediaEngineTask.value, host.scrubVideoSegmentIdTask.value],
@@ -20,4 +22,7 @@ const makeScrubVideoSegmentFetchTask = (host) => {
 		}
 	});
 };
+
+//#endregion
 export { makeScrubVideoSegmentFetchTask };
+//# sourceMappingURL=makeScrubVideoSegmentFetchTask.js.map

package/dist/elements/EFMedia/videoTasks/makeScrubVideoSegmentFetchTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeScrubVideoSegmentFetchTask.js","names":[],"sources":["../../../../src/elements/EFMedia/videoTasks/makeScrubVideoSegmentFetchTask.ts"],"sourcesContent":["import { Task } from \"@lit/task\";\nimport type { MediaEngine } from \"../../../transcoding/types\";\nimport type { EFVideo } from \"../../EFVideo\";\nimport { getLatestMediaEngine } from \"../tasks/makeMediaEngineTask\";\n\nexport const makeScrubVideoSegmentFetchTask = (\n  host: EFVideo,\n): Task<\n  readonly [MediaEngine | undefined, number | undefined],\n  ArrayBuffer\n> => {\n  return new Task(host, {\n    args: () =>\n      [host.mediaEngineTask.value, host.scrubVideoSegmentIdTask.value] as const,\n    onError: (error) => {\n      console.error(\"scrubVideoSegmentFetchTask error\", error);\n    },\n    onComplete: (_value) => {},\n    task: async (_, { signal }) => {\n      const mediaEngine = await getLatestMediaEngine(host, signal);\n      const segmentId = await host.scrubVideoSegmentIdTask.taskComplete;\n      if (segmentId === undefined) {\n        throw new Error(\"Scrub segment ID is not available for video\");\n      }\n\n      // Get scrub rendition using the proper interface method\n      const scrubRendition = mediaEngine.getScrubVideoRendition();\n\n      if (!scrubRendition) {\n        // No scrub rendition available - this is fine, scrub is optional\n        throw new Error(\"No scrub rendition available\");\n      }\n\n      return mediaEngine.fetchMediaSegment(\n        segmentId,\n        {\n          ...scrubRendition,\n          src: mediaEngine.src, // Ensure src is set\n        },\n        signal,\n      );\n    },\n  });\n};\n"],"mappings":";;;;AAKA,MAAa,kCACX,SAIG;AACH,QAAO,IAAI,KAAK,MAAM;EACpB,YACE,CAAC,KAAK,gBAAgB,OAAO,KAAK,wBAAwB,MAAM;EAClE,UAAU,UAAU;AAClB,WAAQ,MAAM,oCAAoC,MAAM;;EAE1D,aAAa,WAAW;EACxB,MAAM,OAAO,GAAG,EAAE,aAAa;GAC7B,MAAM,cAAc,MAAM,qBAAqB,MAAM,OAAO;GAC5D,MAAM,YAAY,MAAM,KAAK,wBAAwB;AACrD,OAAI,cAAc,OAChB,OAAM,IAAI,MAAM,8CAA8C;GAIhE,MAAM,iBAAiB,YAAY,wBAAwB;AAE3D,OAAI,CAAC,eAEH,OAAM,IAAI,MAAM,+BAA+B;AAGjD,UAAO,YAAY,kBACjB,WACA;IACE,GAAG;IACH,KAAK,YAAY;IAClB,EACD,OACD;;EAEJ,CAAC"}

package/dist/elements/EFMedia/videoTasks/makeScrubVideoSegmentIdTask.js

@@ -1,5 +1,7 @@
 import { getLatestMediaEngine } from "../tasks/makeMediaEngineTask.js";
 import { Task } from "@lit/task";
+
+//#region src/elements/EFMedia/videoTasks/makeScrubVideoSegmentIdTask.ts
 const makeScrubVideoSegmentIdTask = (host) => {
 	return new Task(host, {
 		args: () => [host.mediaEngineTask.value, host.desiredSeekTimeMs],
@@ -19,4 +21,7 @@ const makeScrubVideoSegmentIdTask = (host) => {
 		}
 	});
 };
+
+//#endregion
 export { makeScrubVideoSegmentIdTask };
+//# sourceMappingURL=makeScrubVideoSegmentIdTask.js.map

package/dist/elements/EFMedia/videoTasks/makeScrubVideoSegmentIdTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeScrubVideoSegmentIdTask.js","names":[],"sources":["../../../../src/elements/EFMedia/videoTasks/makeScrubVideoSegmentIdTask.ts"],"sourcesContent":["import { Task } from \"@lit/task\";\nimport type { MediaEngine } from \"../../../transcoding/types\";\nimport type { EFVideo } from \"../../EFVideo\";\nimport { getLatestMediaEngine } from \"../tasks/makeMediaEngineTask\";\n\nexport const makeScrubVideoSegmentIdTask = (\n  host: EFVideo,\n): Task<readonly [MediaEngine | undefined, number], number | undefined> => {\n  return new Task(host, {\n    args: () => [host.mediaEngineTask.value, host.desiredSeekTimeMs] as const,\n    onError: (error) => {\n      console.error(\"scrubVideoSegmentIdTask error\", error);\n    },\n    onComplete: (_value) => {},\n    task: async ([, targetSeekTimeMs], { signal }) => {\n      const mediaEngine = await getLatestMediaEngine(host, signal);\n      signal.throwIfAborted(); // Abort if a new seek started\n\n      // Get scrub rendition using the proper interface method\n      const scrubRendition = mediaEngine.getScrubVideoRendition();\n\n      if (!scrubRendition) {\n        return undefined; // No scrub rendition available\n      }\n\n      return mediaEngine.computeSegmentId(targetSeekTimeMs, {\n        ...scrubRendition,\n        src: mediaEngine.src, // Ensure src is set\n      });\n    },\n  });\n};\n"],"mappings":";;;;AAKA,MAAa,+BACX,SACyE;AACzE,QAAO,IAAI,KAAK,MAAM;EACpB,YAAY,CAAC,KAAK,gBAAgB,OAAO,KAAK,kBAAkB;EAChE,UAAU,UAAU;AAClB,WAAQ,MAAM,iCAAiC,MAAM;;EAEvD,aAAa,WAAW;EACxB,MAAM,OAAO,GAAG,mBAAmB,EAAE,aAAa;GAChD,MAAM,cAAc,MAAM,qBAAqB,MAAM,OAAO;AAC5D,UAAO,gBAAgB;GAGvB,MAAM,iBAAiB,YAAY,wBAAwB;AAE3D,OAAI,CAAC,eACH;AAGF,UAAO,YAAY,iBAAiB,kBAAkB;IACpD,GAAG;IACH,KAAK,YAAY;IAClB,CAAC;;EAEL,CAAC"}

package/dist/elements/EFMedia/videoTasks/makeUnifiedVideoSeekTask.js

@@ -5,8 +5,10 @@ import { EFMedia } from "../../EFMedia.js";
 import { ScrubInputCache } from "./ScrubInputCache.js";
 import { MainVideoInputCache } from "./MainVideoInputCache.js";
 import { Task } from "@lit/task";
-var scrubInputCache = new ScrubInputCache();
-var mainVideoInputCache = new MainVideoInputCache();
+
+//#region src/elements/EFMedia/videoTasks/makeUnifiedVideoSeekTask.ts
+const scrubInputCache = new ScrubInputCache();
+const mainVideoInputCache = new MainVideoInputCache();
 const makeUnifiedVideoSeekTask = (host) => {
 	return new Task(host, {
 		autoRun: false,
@@ -39,6 +41,9 @@ const makeUnifiedVideoSeekTask = (host) => {
 		}
 	});
 };
+/**
+* Try to get scrub sample from cache (instant if available)
+*/
 async function tryGetScrubSample(mediaEngine, desiredSeekTimeMs, signal) {
 	return withSpan("video.tryGetScrubSample", {
 		desiredSeekTimeMs,
@@ -108,6 +113,9 @@ async function tryGetScrubSample(mediaEngine, desiredSeekTimeMs, signal) {
 		}
 	});
 }
+/**
+* Get main video sample (slower path with fetching)
+*/
 async function getMainVideoSample(_host, mediaEngine, desiredSeekTimeMs, signal) {
 	return withSpan("video.getMainVideoSample", {
 		desiredSeekTimeMs,
@@ -162,6 +170,9 @@ async function getMainVideoSample(_host, mediaEngine, desiredSeekTimeMs, signal)
 		}
 	});
 }
+/**
+* Start background upgrade to main quality (non-blocking)
+*/
 async function startMainQualityUpgrade(host, mediaEngine, targetSeekTimeMs, signal) {
 	await new Promise((resolve) => setTimeout(resolve, 50));
 	if (signal.aborted || host.desiredSeekTimeMs !== targetSeekTimeMs) return;
@@ -175,4 +186,7 @@ async function startMainQualityUpgrade(host, mediaEngine, targetSeekTimeMs, sign
 		}
 	}
 }
+
+//#endregion
 export { makeUnifiedVideoSeekTask };
+//# sourceMappingURL=makeUnifiedVideoSeekTask.js.map

package/dist/elements/EFMedia/videoTasks/makeUnifiedVideoSeekTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeUnifiedVideoSeekTask.js","names":["result","scrubRendition: VideoRendition | undefined","BufferedSeekingInput","EFMedia"],"sources":["../../../../src/elements/EFMedia/videoTasks/makeUnifiedVideoSeekTask.ts"],"sourcesContent":["import { Task } from \"@lit/task\";\nimport type { VideoSample } from \"mediabunny\";\nimport { withSpan } from \"../../../otel/tracingHelpers.js\";\nimport type { VideoRendition } from \"../../../transcoding/types\";\nimport { EFMedia } from \"../../EFMedia.js\";\nimport type { EFVideo } from \"../../EFVideo\";\nimport { BufferedSeekingInput } from \"../BufferedSeekingInput.js\";\nimport { getLatestMediaEngine } from \"../tasks/makeMediaEngineTask\";\nimport { MainVideoInputCache } from \"./MainVideoInputCache\";\nimport { ScrubInputCache } from \"./ScrubInputCache\";\n\ntype UnifiedVideoSeekTask = Task<readonly [number], VideoSample | undefined>;\n\n// Shared cache for scrub inputs\nconst scrubInputCache = new ScrubInputCache();\n\n// Shared cache for main video inputs\nconst mainVideoInputCache = new MainVideoInputCache();\n\nexport const makeUnifiedVideoSeekTask = (\n  host: EFVideo,\n): UnifiedVideoSeekTask => {\n  return new Task(host, {\n    autoRun: false,\n    args: () => [host.desiredSeekTimeMs] as const,\n    onError: (error) => {\n      console.error(\"unifiedVideoSeekTask error\", error);\n    },\n    onComplete: (_value) => {},\n    task: async ([desiredSeekTimeMs], { signal }) => {\n      const mediaEngine = await getLatestMediaEngine(host, signal);\n      if (!mediaEngine || signal.aborted) return undefined;\n\n      // FIRST: Check if main quality content is already cached\n      const mainRendition = mediaEngine.videoRendition;\n      if (mainRendition) {\n        const mainSegmentId = mediaEngine.computeSegmentId(\n          desiredSeekTimeMs,\n          mainRendition,\n        );\n        if (\n          mainSegmentId !== undefined &&\n          mediaEngine.isSegmentCached(mainSegmentId, mainRendition)\n        ) {\n          const result = await getMainVideoSample(\n            host,\n            mediaEngine,\n            desiredSeekTimeMs,\n            signal,\n          );\n\n          if (signal.aborted) {\n            return undefined;\n          }\n\n          return result;\n        }\n      }\n\n      // SECOND: Main not cached, try scrub path (instant if cached)\n      const scrubSample = await tryGetScrubSample(\n        mediaEngine,\n        desiredSeekTimeMs,\n        signal,\n      );\n\n      if (scrubSample || signal.aborted) {\n        if (signal.aborted) {\n          return undefined;\n        }\n\n        // If scrub succeeded, start background main quality upgrade (non-blocking)\n        if (scrubSample) {\n          startMainQualityUpgrade(\n            host,\n            mediaEngine,\n            desiredSeekTimeMs,\n            signal,\n          ).catch(() => {\n            // Main upgrade failed - scrub already succeeded, that's fine\n          });\n        }\n\n        return scrubSample;\n      }\n\n      // THIRD: Neither are cached, fetch main video path as final fallback\n      const result = await getMainVideoSample(\n        host,\n        mediaEngine,\n        desiredSeekTimeMs,\n        signal,\n      );\n\n      if (signal.aborted) {\n        return undefined;\n      }\n\n      return result;\n    },\n  });\n};\n\n/**\n * Try to get scrub sample from cache (instant if available)\n */\nasync function tryGetScrubSample(\n  mediaEngine: any,\n  desiredSeekTimeMs: number,\n  signal: AbortSignal,\n): Promise<VideoSample | undefined> {\n  return withSpan(\n    \"video.tryGetScrubSample\",\n    {\n      desiredSeekTimeMs,\n      src: mediaEngine.src || \"unknown\",\n    },\n    undefined,\n    async (span) => {\n      try {\n        // Get scrub rendition\n        let scrubRendition: VideoRendition | undefined;\n\n        // Check if media engine has a getScrubVideoRendition method (AssetMediaEngine, etc.)\n        if (typeof mediaEngine.getScrubVideoRendition === \"function\") {\n          scrubRendition = mediaEngine.getScrubVideoRendition();\n        } else if (\"data\" in mediaEngine && mediaEngine.data?.videoRenditions) {\n          // Fallback to data structure for other engines\n          scrubRendition = mediaEngine.data.videoRenditions.find(\n            (r: any) => r.id === \"scrub\",\n          );\n        }\n\n        if (!scrubRendition) {\n          span.setAttribute(\"result\", \"no-scrub-rendition\");\n          return undefined;\n        }\n\n        const scrubRenditionWithSrc = {\n          ...scrubRendition,\n          src: mediaEngine.src,\n        };\n\n        // Check if scrub segment is cached\n        const segmentId = mediaEngine.computeSegmentId(\n          desiredSeekTimeMs,\n          scrubRenditionWithSrc,\n        );\n        if (segmentId === undefined) {\n          span.setAttribute(\"result\", \"no-segment-id\");\n          return undefined;\n        }\n\n        const isCached = mediaEngine.isSegmentCached(\n          segmentId,\n          scrubRenditionWithSrc,\n        );\n        span.setAttribute(\"isCached\", isCached);\n        if (!isCached) {\n          span.setAttribute(\"result\", \"not-cached\");\n          return undefined; // Not cached - let main video handle it\n        }\n\n        // Get cached scrub input and seek within it\n        const scrubInput = await scrubInputCache.getOrCreateInput(\n          segmentId,\n          async () => {\n            const [initSegment, mediaSegment] = await Promise.all([\n              mediaEngine.fetchInitSegment(scrubRenditionWithSrc, signal),\n              mediaEngine.fetchMediaSegment(segmentId, scrubRenditionWithSrc),\n            ]);\n\n            if (!initSegment || !mediaSegment || signal.aborted)\n              return undefined;\n\n            const { BufferedSeekingInput } = await import(\n              \"../BufferedSeekingInput.js\"\n            );\n            const { EFMedia } = await import(\"../../EFMedia.js\");\n\n            return new BufferedSeekingInput(\n              await new Blob([initSegment, mediaSegment]).arrayBuffer(),\n              {\n                videoBufferSize: EFMedia.VIDEO_SAMPLE_BUFFER_SIZE,\n                audioBufferSize: EFMedia.AUDIO_SAMPLE_BUFFER_SIZE,\n                startTimeOffsetMs: scrubRendition.startTimeOffsetMs,\n              },\n            );\n          },\n        );\n\n        if (!scrubInput) {\n          span.setAttribute(\"result\", \"no-scrub-input\");\n          return undefined;\n        }\n\n        if (signal.aborted) {\n          span.setAttribute(\"result\", \"aborted-after-scrub-input\");\n          return undefined;\n        }\n\n        const videoTrack = await scrubInput.getFirstVideoTrack();\n        if (!videoTrack) {\n          span.setAttribute(\"result\", \"no-video-track\");\n          return undefined;\n        }\n\n        if (signal.aborted) {\n          span.setAttribute(\"result\", \"aborted-after-scrub-track\");\n          return undefined;\n        }\n\n        const sample = (await scrubInput.seek(\n          videoTrack.id,\n          desiredSeekTimeMs,\n        )) as unknown as VideoSample | undefined;\n\n        span.setAttribute(\"result\", sample ? \"success\" : \"no-sample\");\n        return sample;\n      } catch (_error) {\n        if (signal.aborted) {\n          span.setAttribute(\"result\", \"aborted\");\n          return undefined;\n        }\n        span.setAttribute(\"result\", \"error\");\n        return undefined; // Scrub failed - let main video handle it\n      }\n    },\n  );\n}\n\n/**\n * Get main video sample (slower path with fetching)\n */\nasync function getMainVideoSample(\n  _host: EFVideo,\n  mediaEngine: any,\n  desiredSeekTimeMs: number,\n  signal: AbortSignal,\n): Promise<VideoSample | undefined> {\n  return withSpan(\n    \"video.getMainVideoSample\",\n    {\n      desiredSeekTimeMs,\n      src: mediaEngine.src || \"unknown\",\n    },\n    undefined,\n    async (span) => {\n      try {\n        // Use existing main video task chain\n        const videoRendition = mediaEngine.getVideoRendition();\n        if (!videoRendition) {\n          throw new Error(\n            \"Video rendition unavailable after checking videoRendition exists\",\n          );\n        }\n\n        const segmentId = mediaEngine.computeSegmentId(\n          desiredSeekTimeMs,\n          videoRendition,\n        );\n        if (segmentId === undefined) {\n          span.setAttribute(\"result\", \"no-segment-id\");\n          return undefined;\n        }\n\n        span.setAttribute(\"segmentId\", segmentId);\n\n        // Get cached main video input or create new one\n        const mainInput = await mainVideoInputCache.getOrCreateInput(\n          mediaEngine.src,\n          segmentId,\n          videoRendition.id,\n          async () => {\n            // Fetch main video segment (will be cached at mediaEngine level)\n            const [initSegment, mediaSegment] = await Promise.all([\n              mediaEngine.fetchInitSegment(videoRendition, signal),\n              mediaEngine.fetchMediaSegment(segmentId, videoRendition, signal),\n            ]);\n\n            if (!initSegment || !mediaSegment) {\n              return undefined;\n            }\n            signal.throwIfAborted();\n\n            const startTimeOffsetMs = videoRendition?.startTimeOffsetMs;\n\n            return new BufferedSeekingInput(\n              await new Blob([initSegment, mediaSegment]).arrayBuffer(),\n              {\n                videoBufferSize: EFMedia.VIDEO_SAMPLE_BUFFER_SIZE,\n                audioBufferSize: EFMedia.AUDIO_SAMPLE_BUFFER_SIZE,\n                startTimeOffsetMs,\n              },\n            );\n          },\n        );\n\n        if (!mainInput) {\n          span.setAttribute(\"result\", \"no-segments\");\n          return undefined;\n        }\n\n        if (signal.aborted) {\n          span.setAttribute(\"result\", \"aborted-after-input\");\n          return undefined;\n        }\n\n        const videoTrack = await mainInput.getFirstVideoTrack();\n        if (!videoTrack) {\n          span.setAttribute(\"result\", \"no-video-track\");\n          return undefined;\n        }\n\n        if (signal.aborted) {\n          span.setAttribute(\"result\", \"aborted-after-track\");\n          return undefined;\n        }\n\n        const sample = (await mainInput.seek(\n          videoTrack.id,\n          desiredSeekTimeMs,\n        )) as unknown as VideoSample | undefined;\n\n        span.setAttribute(\"result\", sample ? \"success\" : \"no-sample\");\n        return sample;\n      } catch (error) {\n        if (signal.aborted) {\n          span.setAttribute(\"result\", \"aborted\");\n          return undefined;\n        }\n        throw error;\n      }\n    },\n  );\n}\n\n/**\n * Start background upgrade to main quality (non-blocking)\n */\nasync function startMainQualityUpgrade(\n  host: EFVideo,\n  mediaEngine: any,\n  targetSeekTimeMs: number,\n  signal: AbortSignal,\n): Promise<void> {\n  // Small delay to let scrub content display first\n  await new Promise((resolve) => setTimeout(resolve, 50));\n  if (signal.aborted || host.desiredSeekTimeMs !== targetSeekTimeMs) return;\n\n  // Get main quality sample and upgrade display\n  const mainSample = await getMainVideoSample(\n    host,\n    mediaEngine,\n    targetSeekTimeMs,\n    signal,\n  );\n  if (\n    mainSample &&\n    !signal.aborted &&\n    host.desiredSeekTimeMs === targetSeekTimeMs\n  ) {\n    const videoFrame = mainSample.toVideoFrame();\n    try {\n      host.displayFrame(videoFrame, targetSeekTimeMs);\n    } finally {\n      videoFrame.close();\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/elements/EFMedia/videoTasks/makeVideoBufferTask.d.ts

@@ -1,16 +1,12 @@
-import { Task } from '@lit/task';
-import { EFVideo } from '../../EFVideo';
-import { MediaBufferConfig, MediaBufferState } from '../shared/BufferUtils';
-/**
- * Configuration for video buffering - extends the generic interface
- */
-export interface VideoBufferConfig extends MediaBufferConfig {
-}
+import { MediaBufferState } from "../shared/BufferUtils.js";
+import { Task } from "@lit/task";
+
+//#region src/elements/EFMedia/videoTasks/makeVideoBufferTask.d.ts
+
 /**
  * State of the video buffer - uses the generic interface
  */
-export interface VideoBufferState extends MediaBufferState {
-}
-type VideoBufferTask = Task<readonly [number], VideoBufferState>;
-export declare const makeVideoBufferTask: (host: EFVideo) => VideoBufferTask;
-export {};
+interface VideoBufferState extends MediaBufferState {}
+//#endregion
+export { VideoBufferState };
+//# sourceMappingURL=makeVideoBufferTask.d.ts.map

package/dist/elements/EFMedia/videoTasks/makeVideoBufferTask.js

@@ -3,6 +3,8 @@ import { EF_RENDERING } from "../../../EF_RENDERING.js";
 import { manageMediaBuffer } from "../shared/BufferUtils.js";
 import { getLatestMediaEngine } from "../tasks/makeMediaEngineTask.js";
 import { Task } from "@lit/task";
+
+//#region src/elements/EFMedia/videoTasks/makeVideoBufferTask.ts
 const makeVideoBufferTask = (host) => {
 	let currentState = {
 		currentSeekTimeMs: 0,
@@ -46,4 +48,7 @@ const makeVideoBufferTask = (host) => {
 		}
 	});
 };
+
+//#endregion
 export { makeVideoBufferTask };
+//# sourceMappingURL=makeVideoBufferTask.js.map

package/dist/elements/EFMedia/videoTasks/makeVideoBufferTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeVideoBufferTask.js","names":["currentState: VideoBufferState"],"sources":["../../../../src/elements/EFMedia/videoTasks/makeVideoBufferTask.ts"],"sourcesContent":["import { Task } from \"@lit/task\";\n\nimport { EF_INTERACTIVE } from \"../../../EF_INTERACTIVE\";\nimport { EF_RENDERING } from \"../../../EF_RENDERING\";\nimport type { VideoRendition } from \"../../../transcoding/types\";\nimport type { EFVideo } from \"../../EFVideo\";\nimport {\n  type MediaBufferConfig,\n  type MediaBufferState,\n  manageMediaBuffer,\n} from \"../shared/BufferUtils\";\nimport { getLatestMediaEngine } from \"../tasks/makeMediaEngineTask\";\n\n/**\n * Configuration for video buffering - extends the generic interface\n */\nexport interface VideoBufferConfig extends MediaBufferConfig {}\n\n/**\n * State of the video buffer - uses the generic interface\n */\nexport interface VideoBufferState extends MediaBufferState {}\n\ntype VideoBufferTask = Task<readonly [number], VideoBufferState>;\nexport const makeVideoBufferTask = (host: EFVideo): VideoBufferTask => {\n  let currentState: VideoBufferState = {\n    currentSeekTimeMs: 0,\n    requestedSegments: new Set(),\n    activeRequests: new Set(),\n    requestQueue: [],\n  };\n\n  return new Task(host, {\n    autoRun: EF_INTERACTIVE, // Make lazy - only run when element becomes timeline-active\n    args: () => [host.desiredSeekTimeMs] as const,\n    onError: (error) => {\n      console.error(\"videoBufferTask error\", error);\n    },\n    onComplete: (value) => {\n      currentState = value;\n    },\n    task: async ([seekTimeMs], { signal }) => {\n      // Skip buffering entirely in rendering mode\n      if (EF_RENDERING()) {\n        return currentState; // Return existing state without any buffering activity\n      }\n\n      // Get media engine to potentially override buffer configuration\n      const mediaEngine = await getLatestMediaEngine(host, signal);\n\n      // Use media engine's buffer config, falling back to host properties\n      const engineConfig = mediaEngine.getBufferConfig();\n      const bufferDurationMs = engineConfig.videoBufferDurationMs;\n      const maxParallelFetches = engineConfig.maxVideoBufferFetches;\n\n      const currentConfig: VideoBufferConfig = {\n        bufferDurationMs,\n        maxParallelFetches,\n        enableBuffering: host.enableVideoBuffering,\n      };\n\n      return manageMediaBuffer<VideoRendition>(\n        seekTimeMs,\n        currentConfig,\n        currentState,\n        (host as any).intrinsicDurationMs || 10000,\n        signal,\n        {\n          computeSegmentId: async (timeMs, rendition) => {\n            // Use media engine's computeSegmentId\n            const mediaEngine = await getLatestMediaEngine(host, signal);\n            return mediaEngine.computeSegmentId(timeMs, rendition);\n          },\n          prefetchSegment: async (segmentId, rendition) => {\n            // Trigger prefetch through BaseMediaEngine - let it handle caching\n            const mediaEngine = await getLatestMediaEngine(host, signal);\n            await mediaEngine.fetchMediaSegment(segmentId, rendition);\n            // Don't return data - just ensure it's cached in BaseMediaEngine\n          },\n          isSegmentCached: (segmentId, rendition) => {\n            // Check if segment is already cached in BaseMediaEngine\n            const mediaEngine = host.mediaEngineTask.value;\n            if (!mediaEngine) return false;\n\n            return mediaEngine.isSegmentCached(segmentId, rendition);\n          },\n          getRendition: async () => {\n            // Get real video rendition from media engine\n            const mediaEngine = await getLatestMediaEngine(host, signal);\n            return mediaEngine.getVideoRendition();\n          },\n          logError: console.error,\n        },\n      );\n    },\n  });\n};\n"],"mappings":";;;;;;;AAwBA,MAAa,uBAAuB,SAAmC;CACrE,IAAIA,eAAiC;EACnC,mBAAmB;EACnB,mCAAmB,IAAI,KAAK;EAC5B,gCAAgB,IAAI,KAAK;EACzB,cAAc,EAAE;EACjB;AAED,QAAO,IAAI,KAAK,MAAM;EACpB,SAAS;EACT,YAAY,CAAC,KAAK,kBAAkB;EACpC,UAAU,UAAU;AAClB,WAAQ,MAAM,yBAAyB,MAAM;;EAE/C,aAAa,UAAU;AACrB,kBAAe;;EAEjB,MAAM,OAAO,CAAC,aAAa,EAAE,aAAa;AAExC,OAAI,cAAc,CAChB,QAAO;GAOT,MAAM,gBAHc,MAAM,qBAAqB,MAAM,OAAO,EAG3B,iBAAiB;AAUlD,UAAO,kBACL,YAPuC;IACvC,kBAJuB,aAAa;IAKpC,oBAJyB,aAAa;IAKtC,iBAAiB,KAAK;IACvB,EAKC,cACC,KAAa,uBAAuB,KACrC,QACA;IACE,kBAAkB,OAAO,QAAQ,cAAc;AAG7C,aADoB,MAAM,qBAAqB,MAAM,OAAO,EACzC,iBAAiB,QAAQ,UAAU;;IAExD,iBAAiB,OAAO,WAAW,cAAc;AAG/C,YADoB,MAAM,qBAAqB,MAAM,OAAO,EAC1C,kBAAkB,WAAW,UAAU;;IAG3D,kBAAkB,WAAW,cAAc;KAEzC,MAAM,cAAc,KAAK,gBAAgB;AACzC,SAAI,CAAC,YAAa,QAAO;AAEzB,YAAO,YAAY,gBAAgB,WAAW,UAAU;;IAE1D,cAAc,YAAY;AAGxB,aADoB,MAAM,qBAAqB,MAAM,OAAO,EACzC,mBAAmB;;IAExC,UAAU,QAAQ;IACnB,CACF;;EAEJ,CAAC"}

package/dist/elements/EFMedia.d.ts

@@ -1,107 +1,118 @@
-import { LitElement, PropertyValueMap } from 'lit';
-import { ControllableInterface } from '../gui/Controllable.js';
-import { AudioSpan } from '../transcoding/types/index.ts';
-import { UrlGenerator } from '../transcoding/utils/UrlGenerator.ts';
+import { TemporalMixinInterface } from "./EFTemporal.js";
+import { EFFramegen } from "../EF_FRAMEGEN.js";
+import { EFSourceMixinInterface } from "./EFSourceMixin.js";
+import { FetchMixinInterface } from "./FetchMixin.js";
+import { BufferedSeekingInput } from "./EFMedia/BufferedSeekingInput.js";
+import { InputTask } from "./EFMedia/shared/MediaTaskUtils.js";
+import { AudioSpan, MediaEngine } from "../transcoding/types/index.js";
+import { AudioBufferState } from "./EFMedia/audioTasks/makeAudioBufferTask.js";
+import { ControllableInterface } from "../gui/Controllable.js";
+import { UrlGenerator } from "../transcoding/utils/UrlGenerator.js";
+import * as _lit_task0 from "@lit/task";
+import * as lit1 from "lit";
+import { LitElement, PropertyValueMap } from "lit";
+import * as mediabunny0 from "mediabunny";
+
+//#region src/elements/EFMedia.d.ts
 declare global {
-    var EF_FRAMEGEN: import("../EF_FRAMEGEN.js").EFFramegen;
+  var EF_FRAMEGEN: EFFramegen;
 }
-export declare class IgnorableError extends Error {
+declare const EFMedia_base: (new (...args: any[]) => EFSourceMixinInterface) & (new (...args: any[]) => TemporalMixinInterface) & (new (...args: any[]) => FetchMixinInterface) & typeof LitElement;
+declare class EFMedia extends EFMedia_base {
+  get efContext(): ControllableInterface | null;
+  static readonly VIDEO_SAMPLE_BUFFER_SIZE = 30;
+  static readonly AUDIO_SAMPLE_BUFFER_SIZE = 120;
+  static get observedAttributes(): string[];
+  static styles: lit1.CSSResult[];
+  /**
+   * Duration in milliseconds for audio buffering ahead of current time
+   * @domAttribute "audio-buffer-duration"
+   */
+  audioBufferDurationMs: number;
+  /**
+   * Maximum number of concurrent audio segment fetches for buffering
+   * @domAttribute "max-audio-buffer-fetches"
+   */
+  maxAudioBufferFetches: number;
+  /**
+   * Enable/disable audio buffering system
+   * @domAttribute "enable-audio-buffering"
+   */
+  enableAudioBuffering: boolean;
+  /**
+   * Mute/unmute the media element
+   * @domAttribute "mute"
+   */
+  mute: boolean;
+  /**
+   * FFT size for frequency analysis
+   * @domAttribute "fft-size"
+   */
+  fftSize: number;
+  /**
+   * FFT decay rate for frequency analysis
+   * @domAttribute "fft-decay"
+   */
+  fftDecay: number;
+  /**
+   * FFT gain for frequency analysis
+   * @domAttribute "fft-gain"
+   */
+  fftGain: number;
+  /**
+   * Enable/disable frequency interpolation
+   * @domAttribute "interpolate-frequencies"
+   */
+  interpolateFrequencies: boolean;
+  get FREQ_WEIGHTS(): Float32Array;
+  get shouldInterpolateFrequencies(): boolean;
+  get urlGenerator(): UrlGenerator;
+  mediaEngineTask: _lit_task0.Task<readonly [string, string | null], MediaEngine>;
+  audioSegmentIdTask: _lit_task0.Task<readonly [MediaEngine | undefined, number], number | undefined>;
+  audioInitSegmentFetchTask: _lit_task0.Task<readonly [MediaEngine | undefined], ArrayBuffer | undefined>;
+  audioSegmentFetchTask: _lit_task0.Task<readonly [MediaEngine | undefined, number | undefined], ArrayBuffer | undefined>;
+  audioInputTask: InputTask;
+  audioSeekTask: _lit_task0.Task<readonly [number, BufferedSeekingInput | undefined], mediabunny0.VideoSample | undefined>;
+  audioBufferTask: _lit_task0.Task<readonly [number], AudioBufferState>;
+  byteTimeDomainTask: _lit_task0.Task<readonly [number, number, number, number, boolean], Uint8Array | null>;
+  frequencyDataTask: _lit_task0.Task<readonly [number, number, number, number, boolean], Uint8Array | null>;
+  /**
+   * The unique identifier for the media asset.
+   * This property can be set programmatically or via the "asset-id" attribute.
+   * @domAttribute "asset-id"
+   */
+  assetId: string | null;
+  get intrinsicDurationMs(): number;
+  protected updated(changedProperties: PropertyValueMap<any> | Map<PropertyKey, unknown>): void;
+  get hasOwnDuration(): boolean;
+  private _desiredSeekTimeMs;
+  get desiredSeekTimeMs(): number;
+  set desiredSeekTimeMs(value: number);
+  protected executeSeek(seekToMs: number): Promise<void>;
+  /**
+   * Main integration method for EFTimegroup audio playback
+   * Now powered by clean, testable utility functions
+   * Returns undefined if no audio rendition is available
+   */
+  fetchAudioSpanningTime(fromMs: number, toMs: number, signal?: AbortSignal): Promise<AudioSpan | undefined>;
+  /**
+   * Wait for media engine to load and determine duration
+   * Ensures media is ready for playback
+   */
+  waitForMediaDurations(): Promise<void>;
+  /**
+   * Returns media elements for playback audio rendering
+   * For standalone media, returns [this]; for timegroups, returns all descendants
+   * Used by PlaybackController for audio-driven playback
+   */
+  getMediaElements(): EFMedia[];
+  /**
+   * Render audio buffer for playback
+   * Called by PlaybackController during live playback
+   * Delegates to shared renderTemporalAudio utility for consistent behavior
+   */
+  renderAudio(fromMs: number, toMs: number): Promise<AudioBuffer>;
 }
-export declare const deepGetMediaElements: (element: Element, medias?: EFMedia[]) => EFMedia[];
-declare const EFMedia_base: (new (...args: any[]) => import('./EFSourceMixin.js').EFSourceMixinInterface) & (new (...args: any[]) => import('./EFTemporal.js').TemporalMixinInterface) & (new (...args: any[]) => import('./FetchMixin.js').FetchMixinInterface) & typeof LitElement;
-export declare class EFMedia extends EFMedia_base {
-    get efContext(): ControllableInterface | null;
-    static readonly VIDEO_SAMPLE_BUFFER_SIZE = 30;
-    static readonly AUDIO_SAMPLE_BUFFER_SIZE = 120;
-    static get observedAttributes(): string[];
-    static styles: import('lit').CSSResult[];
-    /**
-     * Duration in milliseconds for audio buffering ahead of current time
-     * @domAttribute "audio-buffer-duration"
-     */
-    audioBufferDurationMs: number;
-    /**
-     * Maximum number of concurrent audio segment fetches for buffering
-     * @domAttribute "max-audio-buffer-fetches"
-     */
-    maxAudioBufferFetches: number;
-    /**
-     * Enable/disable audio buffering system
-     * @domAttribute "enable-audio-buffering"
-     */
-    enableAudioBuffering: boolean;
-    /**
-     * Mute/unmute the media element
-     * @domAttribute "mute"
-     */
-    mute: boolean;
-    /**
-     * FFT size for frequency analysis
-     * @domAttribute "fft-size"
-     */
-    fftSize: number;
-    /**
-     * FFT decay rate for frequency analysis
-     * @domAttribute "fft-decay"
-     */
-    fftDecay: number;
-    /**
-     * FFT gain for frequency analysis
-     * @domAttribute "fft-gain"
-     */
-    fftGain: number;
-    /**
-     * Enable/disable frequency interpolation
-     * @domAttribute "interpolate-frequencies"
-     */
-    interpolateFrequencies: boolean;
-    get FREQ_WEIGHTS(): Float32Array;
-    get shouldInterpolateFrequencies(): boolean;
-    get urlGenerator(): UrlGenerator;
-    mediaEngineTask: import('@lit/task').Task<readonly [string, string | null], import('../transcoding/types/index.ts').MediaEngine>;
-    audioSegmentIdTask: import('@lit/task').Task<readonly [import('../transcoding/types/index.ts').MediaEngine | undefined, number], number | undefined>;
-    audioInitSegmentFetchTask: import('@lit/task').Task<readonly [import('../transcoding/types/index.ts').MediaEngine | undefined], ArrayBuffer | undefined>;
-    audioSegmentFetchTask: import('@lit/task').Task<readonly [import('../transcoding/types/index.ts').MediaEngine | undefined, number | undefined], ArrayBuffer | undefined>;
-    audioInputTask: import('./EFMedia/shared/MediaTaskUtils.ts').InputTask;
-    audioSeekTask: import('@lit/task').Task<readonly [number, import('./EFMedia/BufferedSeekingInput.ts').BufferedSeekingInput | undefined], import('mediabunny').VideoSample | undefined>;
-    audioBufferTask: import('@lit/task').Task<readonly [number], import('./EFMedia/audioTasks/makeAudioBufferTask.ts').AudioBufferState>;
-    byteTimeDomainTask: import('@lit/task').Task<readonly [number, number, number, number, boolean], Uint8Array | null>;
-    frequencyDataTask: import('@lit/task').Task<readonly [number, number, number, number, boolean], Uint8Array | null>;
-    /**
-     * The unique identifier for the media asset.
-     * This property can be set programmatically or via the "asset-id" attribute.
-     * @domAttribute "asset-id"
-     */
-    assetId: string | null;
-    get intrinsicDurationMs(): number;
-    protected updated(changedProperties: PropertyValueMap<any> | Map<PropertyKey, unknown>): void;
-    get hasOwnDuration(): boolean;
-    private _desiredSeekTimeMs;
-    get desiredSeekTimeMs(): number;
-    set desiredSeekTimeMs(value: number);
-    protected executeSeek(seekToMs: number): Promise<void>;
-    /**
-     * Main integration method for EFTimegroup audio playback
-     * Now powered by clean, testable utility functions
-     * Returns undefined if no audio rendition is available
-     */
-    fetchAudioSpanningTime(fromMs: number, toMs: number, signal?: AbortSignal): Promise<AudioSpan | undefined>;
-    /**
-     * Wait for media engine to load and determine duration
-     * Ensures media is ready for playback
-     */
-    waitForMediaDurations(): Promise<void>;
-    /**
-     * Returns media elements for playback audio rendering
-     * For standalone media, returns [this]; for timegroups, returns all descendants
-     * Used by PlaybackController for audio-driven playback
-     */
-    getMediaElements(): EFMedia[];
-    /**
-     * Render audio buffer for playback
-     * Called by PlaybackController during live playback
-     * Delegates to shared renderTemporalAudio utility for consistent behavior
-     */
-    renderAudio(fromMs: number, toMs: number): Promise<AudioBuffer>;
-}
-export {};
+//#endregion
+export { EFMedia };
+//# sourceMappingURL=EFMedia.d.ts.map

package/dist/elements/EFMedia.js

@@ -21,7 +21,9 @@ import { EFTargetable } from "./TargetController.js";
 import { provide } from "@lit/context";
 import { LitElement, css } from "lit";
 import { property, state } from "lit/decorators.js";
-var freqWeightsCache = /* @__PURE__ */ new Map();
+
+//#region src/elements/EFMedia.ts
+const freqWeightsCache = /* @__PURE__ */ new Map();
 var IgnorableError = class extends Error {};
 const deepGetMediaElements = (element, medias = []) => {
 	for (const child of Array.from(element.children)) if (child instanceof EFMedia) medias.push(child);
@@ -146,6 +148,11 @@ var EFMedia = class extends EFTargetable(EFSourceMixin(EFTemporal(FetchMixin(Lit
 	async executeSeek(seekToMs) {
 		this.desiredSeekTimeMs = seekToMs;
 	}
+	/**
+	* Main integration method for EFTimegroup audio playback
+	* Now powered by clean, testable utility functions
+	* Returns undefined if no audio rendition is available
+	*/
 	async fetchAudioSpanningTime(fromMs, toMs, signal = new AbortController().signal) {
 		return withSpan("media.fetchAudioSpanningTime", {
 			elementId: this.id || "unknown",
@@ -158,13 +165,27 @@ var EFMedia = class extends EFTargetable(EFSourceMixin(EFTemporal(FetchMixin(Lit
 			return fetchAudioSpanningTime(this, fromMs, toMs, signal);
 		});
 	}
+	/**
+	* Wait for media engine to load and determine duration
+	* Ensures media is ready for playback
+	*/
 	async waitForMediaDurations() {
 		if (this.mediaEngineTask.value) return;
 		await this.mediaEngineTask.run();
 	}
+	/**
+	* Returns media elements for playback audio rendering
+	* For standalone media, returns [this]; for timegroups, returns all descendants
+	* Used by PlaybackController for audio-driven playback
+	*/
 	getMediaElements() {
 		return [this];
 	}
+	/**
+	* Render audio buffer for playback
+	* Called by PlaybackController during live playback
+	* Delegates to shared renderTemporalAudio utility for consistent behavior
+	*/
 	async renderAudio(fromMs, toMs) {
 		return renderTemporalAudio(this, fromMs, toMs);
 	}
@@ -213,4 +234,7 @@ __decorate([property({
 	reflect: true
 })], EFMedia.prototype, "assetId", void 0);
 __decorate([state()], EFMedia.prototype, "_desiredSeekTimeMs", void 0);
+
+//#endregion
 export { EFMedia, IgnorableError, deepGetMediaElements };
+//# sourceMappingURL=EFMedia.js.map