@meframe/core 0.0.1

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

@@ -0,0 +1,47 @@
+import { Resource } from '../../model';
+
+type TrackSample = {
+    timeUs: number;
+    byteOffset: number;
+    byteSize: number;
+    isKey: boolean;
+};
+type TrackIndex = {
+    trackId: number;
+    timescale: number;
+    samples: TrackSample[];
+};
+interface ResolverOptions {
+    maxMoovBytes?: number;
+    maxInitialFetchBytes?: number;
+}
+export interface ByteRange {
+    byteStart: number;
+    byteEnd: number;
+    alignedToKeyframe: boolean;
+}
+interface ResolverState {
+    resource: Resource;
+    status: 'pending' | 'ready' | 'failed';
+    promise: Promise<void>;
+    trackIndex?: TrackIndex;
+    error?: Error;
+}
+export declare class WindowByteRangeResolver {
+    private maxMoovBytes;
+    private initialFetchBytes;
+    private states;
+    constructor(options?: ResolverOptions);
+    ensureReady(resource: Resource): Promise<void>;
+    resolveWindow(resourceId: string, startUs: number, endUs: number): ByteRange | null;
+    getStatus(resourceId: string): ResolverState['status'] | undefined;
+    dispose(): void;
+    private buildIndex;
+    private createTrackIndex;
+    private findStartSampleIndex;
+    private findEndSampleIndex;
+    private binarySearch;
+    private resolveSampleByteOffset;
+}
+export {};
+//# sourceMappingURL=WindowByteRangeResolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WindowByteRangeResolver.d.ts","sourceRoot":"","sources":["../../../src/stages/load/WindowByteRangeResolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,KAAK,WAAW,GAAG;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB,CAAC;AAEF,UAAU,eAAe;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,UAAU,aAAa;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACvC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAKD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,MAAM,CAAoC;gBAEtC,OAAO,CAAC,EAAE,eAAe;IAKrC,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC9C,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAyCnF,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,GAAG,SAAS;IAIlE,OAAO,IAAI,IAAI;YAID,UAAU;IAyFxB,OAAO,CAAC,gBAAgB;IAwCxB,OAAO,CAAC,oBAAoB;IAwB5B,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,YAAY;IA6BpB,OAAO,CAAC,uBAAuB;CA8ChC"}

package/dist/stages/load/WindowByteRangeResolver.js

@@ -0,0 +1,270 @@
+import "../../node_modules/.pnpm/mp4box@0.5.4/node_modules/mp4box/dist/mp4box.all.js";
+import { __exports as mp4box_all } from "../../_virtual/mp4box.all.js";
+const DEFAULT_MAX_MOOV_BYTES = 4 * 1024 * 1024;
+const DEFAULT_INITIAL_FETCH_BYTES = 1024 * 1024;
+class WindowByteRangeResolver {
+  maxMoovBytes;
+  initialFetchBytes;
+  states = /* @__PURE__ */ new Map();
+  constructor(options) {
+    this.maxMoovBytes = options?.maxMoovBytes ?? DEFAULT_MAX_MOOV_BYTES;
+    this.initialFetchBytes = options?.maxInitialFetchBytes ?? DEFAULT_INITIAL_FETCH_BYTES;
+  }
+  ensureReady(resource) {
+    if (!resource.id) {
+      return Promise.reject(new Error("Resource id missing"));
+    }
+    const existing = this.states.get(resource.id);
+    if (existing) {
+      if (existing.status === "failed") {
+        return Promise.reject(existing.error ?? new Error("Resolver failed"));
+      }
+      return existing.promise;
+    }
+    const promise = this.buildIndex(resource).catch((error) => {
+      const state = this.states.get(resource.id);
+      if (state) {
+        state.status = "failed";
+        state.error = error instanceof Error ? error : new Error(String(error));
+      }
+      throw error;
+    });
+    this.states.set(resource.id, {
+      resource,
+      status: "pending",
+      promise
+    });
+    return promise;
+  }
+  resolveWindow(resourceId, startUs, endUs) {
+    const state = this.states.get(resourceId);
+    if (!state || state.status !== "ready" || !state.trackIndex) {
+      return null;
+    }
+    const { samples } = state.trackIndex;
+    if (!samples.length) {
+      return null;
+    }
+    const startSampleIndex = this.findStartSampleIndex(samples, startUs);
+    const endSampleIndex = this.findEndSampleIndex(samples, endUs, startSampleIndex);
+    if (startSampleIndex < 0 || endSampleIndex < 0) {
+      return null;
+    }
+    const startSample = samples[startSampleIndex];
+    const endSample = samples[endSampleIndex];
+    if (!startSample || !endSample) {
+      return null;
+    }
+    const alignedToKeyframe = startSample.isKey;
+    const byteStart = startSample.byteOffset;
+    const byteEnd = endSample.byteOffset + endSample.byteSize - 1;
+    if (Number.isNaN(byteStart) || Number.isNaN(byteEnd) || byteEnd < byteStart) {
+      return null;
+    }
+    return {
+      byteStart,
+      byteEnd,
+      alignedToKeyframe
+    };
+  }
+  getStatus(resourceId) {
+    return this.states.get(resourceId)?.status;
+  }
+  dispose() {
+    this.states.clear();
+  }
+  async buildIndex(resource) {
+    if (!resource.uri) {
+      throw new Error(`Resource ${resource.id} missing uri`);
+    }
+    const mp4boxFile = mp4box_all.createFile();
+    const buffers = [];
+    let totalFetched = 0;
+    let readyInfo;
+    let trackIndex;
+    const readyPromise = new Promise((resolve, reject) => {
+      mp4boxFile.onReady = (info) => {
+        readyInfo = info;
+        resolve();
+      };
+      mp4boxFile.onError = (error) => {
+        reject(error instanceof Error ? error : new Error(String(error)));
+      };
+    });
+    while (totalFetched < this.maxMoovBytes) {
+      const chunkSize = Math.min(
+        this.initialFetchBytes * Math.pow(2, buffers.length),
+        this.maxMoovBytes - totalFetched
+      );
+      const rangeStart = totalFetched;
+      const rangeEnd = totalFetched + chunkSize - 1;
+      const response = await fetch(resource.uri, {
+        headers: {
+          Range: `bytes=${rangeStart}-${rangeEnd}`
+        }
+      });
+      if (!response.ok) {
+        throw new Error(`Failed to fetch range ${rangeStart}-${rangeEnd}: HTTP ${response.status}`);
+      }
+      const buffer = await response.arrayBuffer();
+      buffer.fileStart = rangeStart;
+      totalFetched += buffer.byteLength;
+      buffers.push(buffer);
+      mp4boxFile.appendBuffer(buffer);
+      try {
+        await readyPromise;
+        break;
+      } catch (error) {
+        if (totalFetched >= this.maxMoovBytes) {
+          throw error;
+        }
+      }
+    }
+    if (readyInfo) {
+      for (const track of readyInfo.tracks ?? []) {
+        const extractionOptions = {
+          rapAlignment: false,
+          keepSamples: true
+        };
+        const totalSamples = track?.samples?.length ?? track?.sample_count;
+        if (typeof totalSamples === "number" && Number.isFinite(totalSamples) && totalSamples > 0) {
+          extractionOptions.nbSamples = totalSamples;
+        }
+        mp4boxFile.setExtractionOptions(track.id, null, extractionOptions);
+      }
+      mp4boxFile.start();
+      mp4boxFile.flush();
+      trackIndex = this.createTrackIndex(mp4boxFile, readyInfo);
+    }
+    if (!trackIndex) {
+      throw new Error("Failed to build track index");
+    }
+    const state = this.states.get(resource.id);
+    if (state) {
+      state.status = "ready";
+      state.trackIndex = trackIndex;
+    }
+  }
+  createTrackIndex(mp4boxFile, info) {
+    const videoTrack = info.tracks?.find((track) => track.type === "video");
+    if (!videoTrack) {
+      throw new Error("No video track found");
+    }
+    const timescale = videoTrack.timescale || 9e4;
+    const trackId = videoTrack.id;
+    let samples = mp4boxFile.getTrackSamples?.(trackId) ?? [];
+    if ((!samples || samples.length === 0) && typeof mp4boxFile.getTrackById === "function") {
+      const fullTrack = mp4boxFile.getTrackById(trackId);
+      if (fullTrack?.samples?.length) {
+        samples = fullTrack.samples;
+      }
+    }
+    const indexedSamples = (samples ?? []).map((sample, index) => {
+      const sampleByteOffset = this.resolveSampleByteOffset(mp4boxFile, trackId, sample, index);
+      const timeUs = Math.round(sample.cts * 1e6 / timescale);
+      return {
+        timeUs,
+        byteOffset: sampleByteOffset,
+        byteSize: sample.size,
+        isKey: Boolean(sample.is_sync)
+      };
+    });
+    return {
+      trackId,
+      timescale,
+      samples: indexedSamples
+    };
+  }
+  findStartSampleIndex(samples, targetUs) {
+    if (!samples.length) {
+      return 0;
+    }
+    let index = this.binarySearch(samples, targetUs, (sample, time) => sample.timeUs - time);
+    if (index < 0) {
+      index = ~index;
+      if (index >= samples.length) {
+        index = samples.length - 1;
+      }
+    }
+    while (index > 0) {
+      const current = samples[index];
+      if (!current || current.isKey) {
+        break;
+      }
+      index -= 1;
+    }
+    return index;
+  }
+  findEndSampleIndex(samples, targetUs, startIndex) {
+    if (!samples.length) {
+      return 0;
+    }
+    let index = Math.min(Math.max(startIndex, 0), samples.length - 1);
+    while (index + 1 < samples.length) {
+      const nextSample = samples[index + 1];
+      if (!nextSample || nextSample.timeUs > targetUs) {
+        break;
+      }
+      index += 1;
+    }
+    return index;
+  }
+  binarySearch(samples, targetUs, compare) {
+    let low = 0;
+    let high = samples.length - 1;
+    while (low <= high) {
+      const mid = Math.floor((low + high) / 2);
+      const sample = samples[mid];
+      if (!sample) {
+        break;
+      }
+      const cmp = compare(sample, targetUs);
+      if (cmp === 0) {
+        return mid;
+      }
+      if (cmp < 0) {
+        low = mid + 1;
+      } else {
+        high = mid - 1;
+      }
+    }
+    return ~low;
+  }
+  resolveSampleByteOffset(mp4boxFile, trackId, sample, sampleIndex) {
+    if (typeof sample.position === "number" && Number.isFinite(sample.position)) {
+      return sample.position;
+    }
+    const trak = mp4boxFile.getTrackById?.(trackId);
+    if (!trak) {
+      return NaN;
+    }
+    const chunkRefs = trak?.samples;
+    const chunkIndex = sample.chunk_index ?? sample.chunk_index_in_trak ?? sample.chunkIndex;
+    const chunkOffset = typeof chunkIndex === "number" ? trak?.stco?.chunk_offsets?.[chunkIndex] : void 0;
+    if (typeof chunkOffset === "number" && Number.isFinite(chunkOffset)) {
+      const offsetInChunk = typeof sample.offset === "number" ? sample.offset : 0;
+      return chunkOffset + offsetInChunk;
+    }
+    if (Array.isArray(chunkRefs) && chunkIndex >= 0 && chunkIndex < chunkRefs.length) {
+      const chunk = chunkRefs[chunkIndex];
+      if (chunk && typeof chunk.offset === "number") {
+        return chunk.offset;
+      }
+    }
+    if (sample.fileStart && typeof sample.fileStart === "number") {
+      return sample.fileStart;
+    }
+    const positions = mp4boxFile.getTrackSamplePositions?.(trackId);
+    if (Array.isArray(positions) && sampleIndex < positions.length) {
+      const pos = positions[sampleIndex];
+      if (typeof pos === "number") {
+        return pos;
+      }
+    }
+    return NaN;
+  }
+}
+export {
+  WindowByteRangeResolver
+};
+//# sourceMappingURL=WindowByteRangeResolver.js.map

package/dist/stages/load/WindowByteRangeResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WindowByteRangeResolver.js","sources":["../../../src/stages/load/WindowByteRangeResolver.ts"],"sourcesContent":["import * as MP4Box from 'mp4box';\nimport type { MP4BoxFile } from 'mp4box';\nimport type { Resource } from '../../model';\n\ntype TrackSample = {\n  timeUs: number;\n  byteOffset: number;\n  byteSize: number;\n  isKey: boolean;\n};\n\ntype TrackIndex = {\n  trackId: number;\n  timescale: number;\n  samples: TrackSample[];\n};\n\ninterface ResolverOptions {\n  maxMoovBytes?: number;\n  maxInitialFetchBytes?: number;\n}\n\nexport interface ByteRange {\n  byteStart: number;\n  byteEnd: number;\n  alignedToKeyframe: boolean;\n}\n\ninterface ResolverState {\n  resource: Resource;\n  status: 'pending' | 'ready' | 'failed';\n  promise: Promise<void>;\n  trackIndex?: TrackIndex;\n  error?: Error;\n}\n\nconst DEFAULT_MAX_MOOV_BYTES = 4 * 1024 * 1024;\nconst DEFAULT_INITIAL_FETCH_BYTES = 1024 * 1024;\n\nexport class WindowByteRangeResolver {\n  private maxMoovBytes: number;\n  private initialFetchBytes: number;\n  private states = new Map<string, ResolverState>();\n\n  constructor(options?: ResolverOptions) {\n    this.maxMoovBytes = options?.maxMoovBytes ?? DEFAULT_MAX_MOOV_BYTES;\n    this.initialFetchBytes = options?.maxInitialFetchBytes ?? DEFAULT_INITIAL_FETCH_BYTES;\n  }\n\n  ensureReady(resource: Resource): Promise<void> {\n    // console.log('>>>>>>>>>>>>>> ensureReady', resource.id, resource.type, resource.state);\n    if (!resource.id) {\n      return Promise.reject(new Error('Resource id missing'));\n    }\n\n    const existing = this.states.get(resource.id);\n    if (existing) {\n      if (existing.status === 'failed') {\n        return Promise.reject(existing.error ?? new Error('Resolver failed'));\n      }\n      return existing.promise;\n    }\n\n    const promise = this.buildIndex(resource).catch((error) => {\n      const state = this.states.get(resource.id);\n      if (state) {\n        state.status = 'failed';\n        state.error = error instanceof Error ? error : new Error(String(error));\n      }\n      throw error;\n    });\n\n    this.states.set(resource.id, {\n      resource,\n      status: 'pending',\n      promise,\n    });\n\n    return promise;\n  }\n\n  resolveWindow(resourceId: string, startUs: number, endUs: number): ByteRange | null {\n    const state = this.states.get(resourceId);\n    if (!state || state.status !== 'ready' || !state.trackIndex) {\n      return null;\n    }\n\n    const { samples } = state.trackIndex;\n    // console.log('>>>>>>>>>>>>>> resolveWindow samples length', samples[0], state);\n    if (!samples.length) {\n      return null;\n    }\n\n    const startSampleIndex = this.findStartSampleIndex(samples, startUs);\n    const endSampleIndex = this.findEndSampleIndex(samples, endUs, startSampleIndex);\n\n    if (startSampleIndex < 0 || endSampleIndex < 0) {\n      return null;\n    }\n\n    const startSample = samples[startSampleIndex];\n    const endSample = samples[endSampleIndex];\n\n    if (!startSample || !endSample) {\n      return null;\n    }\n\n    const alignedToKeyframe = startSample.isKey;\n    const byteStart = startSample.byteOffset;\n    const byteEnd = endSample.byteOffset + endSample.byteSize - 1;\n\n    if (Number.isNaN(byteStart) || Number.isNaN(byteEnd) || byteEnd < byteStart) {\n      return null;\n    }\n\n    return {\n      byteStart,\n      byteEnd,\n      alignedToKeyframe,\n    };\n  }\n\n  getStatus(resourceId: string): ResolverState['status'] | undefined {\n    return this.states.get(resourceId)?.status;\n  }\n\n  dispose(): void {\n    this.states.clear();\n  }\n\n  private async buildIndex(resource: Resource): Promise<void> {\n    if (!resource.uri) {\n      throw new Error(`Resource ${resource.id} missing uri`);\n    }\n\n    const mp4boxFile = MP4Box.createFile();\n    const buffers: ArrayBuffer[] = [];\n    let totalFetched = 0;\n    let readyInfo: any | undefined;\n    let trackIndex: TrackIndex | undefined;\n\n    const readyPromise = new Promise<void>((resolve, reject) => {\n      mp4boxFile.onReady = (info: any) => {\n        readyInfo = info;\n        resolve();\n      };\n\n      mp4boxFile.onError = (error: any) => {\n        reject(error instanceof Error ? error : new Error(String(error)));\n      };\n    });\n\n    while (totalFetched < this.maxMoovBytes) {\n      const chunkSize = Math.min(\n        this.initialFetchBytes * Math.pow(2, buffers.length),\n        this.maxMoovBytes - totalFetched\n      );\n      const rangeStart = totalFetched;\n      const rangeEnd = totalFetched + chunkSize - 1;\n\n      const response = await fetch(resource.uri, {\n        headers: {\n          Range: `bytes=${rangeStart}-${rangeEnd}`,\n        },\n      });\n\n      if (!response.ok) {\n        throw new Error(`Failed to fetch range ${rangeStart}-${rangeEnd}: HTTP ${response.status}`);\n      }\n\n      const buffer = await response.arrayBuffer();\n      (buffer as ArrayBuffer & { fileStart?: number }).fileStart = rangeStart;\n      totalFetched += buffer.byteLength;\n      buffers.push(buffer);\n\n      mp4boxFile.appendBuffer(buffer);\n\n      try {\n        await readyPromise;\n        break;\n      } catch (error) {\n        if (totalFetched >= this.maxMoovBytes) {\n          throw error;\n        }\n      }\n    }\n\n    if (readyInfo) {\n      for (const track of readyInfo.tracks ?? []) {\n        const extractionOptions: Record<string, unknown> = {\n          rapAlignment: false,\n          keepSamples: true,\n        };\n\n        const totalSamples = (track as any)?.samples?.length ?? (track as any)?.sample_count;\n        if (typeof totalSamples === 'number' && Number.isFinite(totalSamples) && totalSamples > 0) {\n          extractionOptions.nbSamples = totalSamples;\n        }\n\n        mp4boxFile.setExtractionOptions(track.id, null, extractionOptions);\n      }\n\n      mp4boxFile.start();\n      mp4boxFile.flush();\n\n      trackIndex = this.createTrackIndex(mp4boxFile, readyInfo);\n    }\n\n    if (!trackIndex) {\n      throw new Error('Failed to build track index');\n    }\n\n    const state = this.states.get(resource.id!);\n    if (state) {\n      state.status = 'ready';\n      state.trackIndex = trackIndex;\n    }\n  }\n\n  private createTrackIndex(mp4boxFile: MP4BoxFile, info: any): TrackIndex {\n    const videoTrack = info.tracks?.find((track: any) => track.type === 'video');\n    if (!videoTrack) {\n      throw new Error('No video track found');\n    }\n\n    const timescale = videoTrack.timescale || 90000;\n    const trackId = videoTrack.id;\n    let samples = mp4boxFile.getTrackSamples?.(trackId) ?? [];\n\n    if (\n      (!samples || samples.length === 0) &&\n      typeof (mp4boxFile as any).getTrackById === 'function'\n    ) {\n      const fullTrack = (mp4boxFile as any).getTrackById(trackId);\n      if (fullTrack?.samples?.length) {\n        samples = fullTrack.samples;\n      }\n    }\n\n    // console.log('>>>>>>>>>>>>>> createTrackIndex samples length', samples[0]);\n\n    const indexedSamples: TrackSample[] = (samples ?? []).map((sample: any, index: number) => {\n      const sampleByteOffset = this.resolveSampleByteOffset(mp4boxFile, trackId, sample, index);\n      const timeUs = Math.round((sample.cts * 1_000_000) / timescale);\n      return {\n        timeUs,\n        byteOffset: sampleByteOffset,\n        byteSize: sample.size,\n        isKey: Boolean(sample.is_sync),\n      };\n    });\n\n    return {\n      trackId,\n      timescale,\n      samples: indexedSamples,\n    };\n  }\n\n  private findStartSampleIndex(samples: TrackSample[], targetUs: number): number {\n    if (!samples.length) {\n      return 0;\n    }\n\n    let index = this.binarySearch(samples, targetUs, (sample, time) => sample.timeUs - time);\n    if (index < 0) {\n      index = ~index;\n      if (index >= samples.length) {\n        index = samples.length - 1;\n      }\n    }\n\n    while (index > 0) {\n      const current = samples[index];\n      if (!current || current.isKey) {\n        break;\n      }\n      index -= 1;\n    }\n\n    return index;\n  }\n\n  private findEndSampleIndex(samples: TrackSample[], targetUs: number, startIndex: number): number {\n    if (!samples.length) {\n      return 0;\n    }\n\n    let index = Math.min(Math.max(startIndex, 0), samples.length - 1);\n    while (index + 1 < samples.length) {\n      const nextSample = samples[index + 1];\n      if (!nextSample || nextSample.timeUs > targetUs) {\n        break;\n      }\n      index += 1;\n    }\n\n    return index;\n  }\n\n  private binarySearch(\n    samples: TrackSample[],\n    targetUs: number,\n    compare: (sample: TrackSample, targetUs: number) => number\n  ): number {\n    let low = 0;\n    let high = samples.length - 1;\n\n    while (low <= high) {\n      const mid = Math.floor((low + high) / 2);\n      const sample = samples[mid];\n      if (!sample) {\n        break;\n      }\n      const cmp = compare(sample, targetUs);\n\n      if (cmp === 0) {\n        return mid;\n      }\n      if (cmp < 0) {\n        low = mid + 1;\n      } else {\n        high = mid - 1;\n      }\n    }\n\n    return ~low;\n  }\n\n  private resolveSampleByteOffset(\n    mp4boxFile: MP4BoxFile,\n    trackId: number,\n    sample: any,\n    sampleIndex: number\n  ): number {\n    if (typeof sample.position === 'number' && Number.isFinite(sample.position)) {\n      return sample.position;\n    }\n\n    const trak = (mp4boxFile as any).getTrackById?.(trackId);\n    if (!trak) {\n      return NaN;\n    }\n\n    const chunkRefs = trak?.samples as any[] | undefined;\n    const chunkIndex = sample.chunk_index ?? sample.chunk_index_in_trak ?? sample.chunkIndex;\n    const chunkOffset =\n      typeof chunkIndex === 'number' ? trak?.stco?.chunk_offsets?.[chunkIndex] : undefined;\n\n    if (typeof chunkOffset === 'number' && Number.isFinite(chunkOffset)) {\n      const offsetInChunk = typeof sample.offset === 'number' ? sample.offset : 0;\n      return chunkOffset + offsetInChunk;\n    }\n\n    if (Array.isArray(chunkRefs) && chunkIndex >= 0 && chunkIndex < chunkRefs.length) {\n      const chunk = chunkRefs[chunkIndex];\n      if (chunk && typeof chunk.offset === 'number') {\n        return chunk.offset;\n      }\n    }\n\n    if (sample.fileStart && typeof sample.fileStart === 'number') {\n      return sample.fileStart;\n    }\n\n    const positions = (mp4boxFile as any).getTrackSamplePositions?.(trackId);\n    if (Array.isArray(positions) && sampleIndex < positions.length) {\n      const pos = positions[sampleIndex];\n      if (typeof pos === 'number') {\n        return pos;\n      }\n    }\n\n    return NaN;\n  }\n}\n"],"names":["MP4Box.createFile"],"mappings":";;AAoCA,MAAM,yBAAyB,IAAI,OAAO;AAC1C,MAAM,8BAA8B,OAAO;AAEpC,MAAM,wBAAwB;AAAA,EAC3B;AAAA,EACA;AAAA,EACA,6BAAa,IAAA;AAAA,EAErB,YAAY,SAA2B;AACrC,SAAK,eAAe,SAAS,gBAAgB;AAC7C,SAAK,oBAAoB,SAAS,wBAAwB;AAAA,EAC5D;AAAA,EAEA,YAAY,UAAmC;AAE7C,QAAI,CAAC,SAAS,IAAI;AAChB,aAAO,QAAQ,OAAO,IAAI,MAAM,qBAAqB,CAAC;AAAA,IACxD;AAEA,UAAM,WAAW,KAAK,OAAO,IAAI,SAAS,EAAE;AAC5C,QAAI,UAAU;AACZ,UAAI,SAAS,WAAW,UAAU;AAChC,eAAO,QAAQ,OAAO,SAAS,SAAS,IAAI,MAAM,iBAAiB,CAAC;AAAA,MACtE;AACA,aAAO,SAAS;AAAA,IAClB;AAEA,UAAM,UAAU,KAAK,WAAW,QAAQ,EAAE,MAAM,CAAC,UAAU;AACzD,YAAM,QAAQ,KAAK,OAAO,IAAI,SAAS,EAAE;AACzC,UAAI,OAAO;AACT,cAAM,SAAS;AACf,cAAM,QAAQ,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,MACxE;AACA,YAAM;AAAA,IACR,CAAC;AAED,SAAK,OAAO,IAAI,SAAS,IAAI;AAAA,MAC3B;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,IAAA,CACD;AAED,WAAO;AAAA,EACT;AAAA,EAEA,cAAc,YAAoB,SAAiB,OAAiC;AAClF,UAAM,QAAQ,KAAK,OAAO,IAAI,UAAU;AACxC,QAAI,CAAC,SAAS,MAAM,WAAW,WAAW,CAAC,MAAM,YAAY;AAC3D,aAAO;AAAA,IACT;AAEA,UAAM,EAAE,YAAY,MAAM;AAE1B,QAAI,CAAC,QAAQ,QAAQ;AACnB,aAAO;AAAA,IACT;AAEA,UAAM,mBAAmB,KAAK,qBAAqB,SAAS,OAAO;AACnE,UAAM,iBAAiB,KAAK,mBAAmB,SAAS,OAAO,gBAAgB;AAE/E,QAAI,mBAAmB,KAAK,iBAAiB,GAAG;AAC9C,aAAO;AAAA,IACT;AAEA,UAAM,cAAc,QAAQ,gBAAgB;AAC5C,UAAM,YAAY,QAAQ,cAAc;AAExC,QAAI,CAAC,eAAe,CAAC,WAAW;AAC9B,aAAO;AAAA,IACT;AAEA,UAAM,oBAAoB,YAAY;AACtC,UAAM,YAAY,YAAY;AAC9B,UAAM,UAAU,UAAU,aAAa,UAAU,WAAW;AAE5D,QAAI,OAAO,MAAM,SAAS,KAAK,OAAO,MAAM,OAAO,KAAK,UAAU,WAAW;AAC3E,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAAA,EAEJ;AAAA,EAEA,UAAU,YAAyD;AACjE,WAAO,KAAK,OAAO,IAAI,UAAU,GAAG;AAAA,EACtC;AAAA,EAEA,UAAgB;AACd,SAAK,OAAO,MAAA;AAAA,EACd;AAAA,EAEA,MAAc,WAAW,UAAmC;AAC1D,QAAI,CAAC,SAAS,KAAK;AACjB,YAAM,IAAI,MAAM,YAAY,SAAS,EAAE,cAAc;AAAA,IACvD;AAEA,UAAM,aAAaA,WAAAA,WAAO;AAC1B,UAAM,UAAyB,CAAA;AAC/B,QAAI,eAAe;AACnB,QAAI;AACJ,QAAI;AAEJ,UAAM,eAAe,IAAI,QAAc,CAAC,SAAS,WAAW;AAC1D,iBAAW,UAAU,CAAC,SAAc;AAClC,oBAAY;AACZ,gBAAA;AAAA,MACF;AAEA,iBAAW,UAAU,CAAC,UAAe;AACnC,eAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC,CAAC;AAAA,MAClE;AAAA,IACF,CAAC;AAED,WAAO,eAAe,KAAK,cAAc;AACvC,YAAM,YAAY,KAAK;AAAA,QACrB,KAAK,oBAAoB,KAAK,IAAI,GAAG,QAAQ,MAAM;AAAA,QACnD,KAAK,eAAe;AAAA,MAAA;AAEtB,YAAM,aAAa;AACnB,YAAM,WAAW,eAAe,YAAY;AAE5C,YAAM,WAAW,MAAM,MAAM,SAAS,KAAK;AAAA,QACzC,SAAS;AAAA,UACP,OAAO,SAAS,UAAU,IAAI,QAAQ;AAAA,QAAA;AAAA,MACxC,CACD;AAED,UAAI,CAAC,SAAS,IAAI;AAChB,cAAM,IAAI,MAAM,yBAAyB,UAAU,IAAI,QAAQ,UAAU,SAAS,MAAM,EAAE;AAAA,MAC5F;AAEA,YAAM,SAAS,MAAM,SAAS,YAAA;AAC7B,aAAgD,YAAY;AAC7D,sBAAgB,OAAO;AACvB,cAAQ,KAAK,MAAM;AAEnB,iBAAW,aAAa,MAAM;AAE9B,UAAI;AACF,cAAM;AACN;AAAA,MACF,SAAS,OAAO;AACd,YAAI,gBAAgB,KAAK,cAAc;AACrC,gBAAM;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,QAAI,WAAW;AACb,iBAAW,SAAS,UAAU,UAAU,CAAA,GAAI;AAC1C,cAAM,oBAA6C;AAAA,UACjD,cAAc;AAAA,UACd,aAAa;AAAA,QAAA;AAGf,cAAM,eAAgB,OAAe,SAAS,UAAW,OAAe;AACxE,YAAI,OAAO,iBAAiB,YAAY,OAAO,SAAS,YAAY,KAAK,eAAe,GAAG;AACzF,4BAAkB,YAAY;AAAA,QAChC;AAEA,mBAAW,qBAAqB,MAAM,IAAI,MAAM,iBAAiB;AAAA,MACnE;AAEA,iBAAW,MAAA;AACX,iBAAW,MAAA;AAEX,mBAAa,KAAK,iBAAiB,YAAY,SAAS;AAAA,IAC1D;AAEA,QAAI,CAAC,YAAY;AACf,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AAEA,UAAM,QAAQ,KAAK,OAAO,IAAI,SAAS,EAAG;AAC1C,QAAI,OAAO;AACT,YAAM,SAAS;AACf,YAAM,aAAa;AAAA,IACrB;AAAA,EACF;AAAA,EAEQ,iBAAiB,YAAwB,MAAuB;AACtE,UAAM,aAAa,KAAK,QAAQ,KAAK,CAAC,UAAe,MAAM,SAAS,OAAO;AAC3E,QAAI,CAAC,YAAY;AACf,YAAM,IAAI,MAAM,sBAAsB;AAAA,IACxC;AAEA,UAAM,YAAY,WAAW,aAAa;AAC1C,UAAM,UAAU,WAAW;AAC3B,QAAI,UAAU,WAAW,kBAAkB,OAAO,KAAK,CAAA;AAEvD,SACG,CAAC,WAAW,QAAQ,WAAW,MAChC,OAAQ,WAAmB,iBAAiB,YAC5C;AACA,YAAM,YAAa,WAAmB,aAAa,OAAO;AAC1D,UAAI,WAAW,SAAS,QAAQ;AAC9B,kBAAU,UAAU;AAAA,MACtB;AAAA,IACF;AAIA,UAAM,kBAAiC,WAAW,CAAA,GAAI,IAAI,CAAC,QAAa,UAAkB;AACxF,YAAM,mBAAmB,KAAK,wBAAwB,YAAY,SAAS,QAAQ,KAAK;AACxF,YAAM,SAAS,KAAK,MAAO,OAAO,MAAM,MAAa,SAAS;AAC9D,aAAO;AAAA,QACL;AAAA,QACA,YAAY;AAAA,QACZ,UAAU,OAAO;AAAA,QACjB,OAAO,QAAQ,OAAO,OAAO;AAAA,MAAA;AAAA,IAEjC,CAAC;AAED,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,SAAS;AAAA,IAAA;AAAA,EAEb;AAAA,EAEQ,qBAAqB,SAAwB,UAA0B;AAC7E,QAAI,CAAC,QAAQ,QAAQ;AACnB,aAAO;AAAA,IACT;AAEA,QAAI,QAAQ,KAAK,aAAa,SAAS,UAAU,CAAC,QAAQ,SAAS,OAAO,SAAS,IAAI;AACvF,QAAI,QAAQ,GAAG;AACb,cAAQ,CAAC;AACT,UAAI,SAAS,QAAQ,QAAQ;AAC3B,gBAAQ,QAAQ,SAAS;AAAA,MAC3B;AAAA,IACF;AAEA,WAAO,QAAQ,GAAG;AAChB,YAAM,UAAU,QAAQ,KAAK;AAC7B,UAAI,CAAC,WAAW,QAAQ,OAAO;AAC7B;AAAA,MACF;AACA,eAAS;AAAA,IACX;AAEA,WAAO;AAAA,EACT;AAAA,EAEQ,mBAAmB,SAAwB,UAAkB,YAA4B;AAC/F,QAAI,CAAC,QAAQ,QAAQ;AACnB,aAAO;AAAA,IACT;AAEA,QAAI,QAAQ,KAAK,IAAI,KAAK,IAAI,YAAY,CAAC,GAAG,QAAQ,SAAS,CAAC;AAChE,WAAO,QAAQ,IAAI,QAAQ,QAAQ;AACjC,YAAM,aAAa,QAAQ,QAAQ,CAAC;AACpC,UAAI,CAAC,cAAc,WAAW,SAAS,UAAU;AAC/C;AAAA,MACF;AACA,eAAS;AAAA,IACX;AAEA,WAAO;AAAA,EACT;AAAA,EAEQ,aACN,SACA,UACA,SACQ;AACR,QAAI,MAAM;AACV,QAAI,OAAO,QAAQ,SAAS;AAE5B,WAAO,OAAO,MAAM;AAClB,YAAM,MAAM,KAAK,OAAO,MAAM,QAAQ,CAAC;AACvC,YAAM,SAAS,QAAQ,GAAG;AAC1B,UAAI,CAAC,QAAQ;AACX;AAAA,MACF;AACA,YAAM,MAAM,QAAQ,QAAQ,QAAQ;AAEpC,UAAI,QAAQ,GAAG;AACb,eAAO;AAAA,MACT;AACA,UAAI,MAAM,GAAG;AACX,cAAM,MAAM;AAAA,MACd,OAAO;AACL,eAAO,MAAM;AAAA,MACf;AAAA,IACF;AAEA,WAAO,CAAC;AAAA,EACV;AAAA,EAEQ,wBACN,YACA,SACA,QACA,aACQ;AACR,QAAI,OAAO,OAAO,aAAa,YAAY,OAAO,SAAS,OAAO,QAAQ,GAAG;AAC3E,aAAO,OAAO;AAAA,IAChB;AAEA,UAAM,OAAQ,WAAmB,eAAe,OAAO;AACvD,QAAI,CAAC,MAAM;AACT,aAAO;AAAA,IACT;AAEA,UAAM,YAAY,MAAM;AACxB,UAAM,aAAa,OAAO,eAAe,OAAO,uBAAuB,OAAO;AAC9E,UAAM,cACJ,OAAO,eAAe,WAAW,MAAM,MAAM,gBAAgB,UAAU,IAAI;AAE7E,QAAI,OAAO,gBAAgB,YAAY,OAAO,SAAS,WAAW,GAAG;AACnE,YAAM,gBAAgB,OAAO,OAAO,WAAW,WAAW,OAAO,SAAS;AAC1E,aAAO,cAAc;AAAA,IACvB;AAEA,QAAI,MAAM,QAAQ,SAAS,KAAK,cAAc,KAAK,aAAa,UAAU,QAAQ;AAChF,YAAM,QAAQ,UAAU,UAAU;AAClC,UAAI,SAAS,OAAO,MAAM,WAAW,UAAU;AAC7C,eAAO,MAAM;AAAA,MACf;AAAA,IACF;AAEA,QAAI,OAAO,aAAa,OAAO,OAAO,cAAc,UAAU;AAC5D,aAAO,OAAO;AAAA,IAChB;AAEA,UAAM,YAAa,WAAmB,0BAA0B,OAAO;AACvE,QAAI,MAAM,QAAQ,SAAS,KAAK,cAAc,UAAU,QAAQ;AAC9D,YAAM,MAAM,UAAU,WAAW;AACjC,UAAI,OAAO,QAAQ,UAAU;AAC3B,eAAO;AAAA,MACT;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;"}

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

@@ -0,0 +1,11 @@
+/**
+ * Resource Loaders Module
+ * First stage in the processing pipeline
+ */
+export { ResourceLoader } from './ResourceLoader';
+export { TaskManager } from './TaskManager';
+export { StreamFactory } from './StreamFactory';
+export { EventHandlers } from './EventHandlers';
+export { WindowByteRangeResolver } from './WindowByteRangeResolver';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stages/load/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,177 @@
+import { Resource } from '../../model';
+import { Clip } from '../../model/types';
+import { EventPayloadMap } from '../../event/events';
+import { EventBus } from '../../event/EventBus';
+
+export interface Orchestrator {
+    on(event: string, handler: (data: any) => void): void;
+    off(event: string, handler: (data: any) => void): void;
+    emit(event: string, data: any): void;
+    workers: {
+        get(type: string, id?: string, options?: Record<string, any>): Promise<any>;
+    };
+}
+export interface LoaderConfig {
+    highWaterMark?: number;
+    maxConcurrent?: number;
+    chunkSize?: number;
+    retryCount?: number;
+    retryDelay?: number;
+}
+export interface ResourceLoadOptions {
+    signal?: AbortSignal;
+    priority?: 'high' | 'normal' | 'low';
+    resumable?: boolean;
+    range?: {
+        start: number;
+        end: number;
+    };
+}
+export interface ClipLoadOptions {
+    clipId: string;
+    resourceId: string;
+    trimStartUs?: number;
+    durationUs?: number;
+    priority?: 'high' | 'normal' | 'low';
+}
+export interface LoadProgress {
+    resourceId: string;
+    bytesLoaded: number;
+    totalBytes: number;
+    percentage: number;
+    speed: number;
+    estimatedTimeRemaining: number;
+}
+export interface StreamMetadata {
+    url: string;
+    contentLength: number;
+    acceptRanges: boolean;
+    contentType?: string;
+    lastModified?: string;
+    etag?: string;
+}
+export interface LoadTask {
+    resourceId: string;
+    resource: Resource;
+    stream?: ReadableStream<Uint8Array>;
+    controller?: AbortController;
+    metadata?: StreamMetadata;
+    bytesLoaded: number;
+    totalBytes: number;
+    startTime: number;
+    priority: 'high' | 'normal' | 'low';
+    pausedAt?: number;
+    error?: Error;
+    range?: {
+        start: number;
+        end: number;
+    };
+}
+export interface ResourceLoaderOptions {
+    orchestrator?: Orchestrator;
+    eventBus?: EventBus<EventPayloadMap>;
+    config?: LoaderConfig;
+    onProgress?: (progress: LoadProgress) => void;
+    onStateChange?: (resourceId: string, state: Resource['state']) => void;
+}
+export interface LoaderWorkerMessage {
+    type: 'load' | 'pause' | 'resume' | 'cancel' | 'getStatus';
+    resourceId: string;
+    resource?: Resource;
+    options?: ResourceLoadOptions;
+}
+export interface LoaderWorkerResponse {
+    type: 'stream' | 'progress' | 'complete' | 'error' | 'state';
+    resourceId: string;
+    stream?: ReadableStream<Uint8Array>;
+    progress?: LoadProgress;
+    error?: Error;
+    state?: Resource['state'];
+}
+export type LoaderWindowPriority = 'seek' | 'playback' | 'prerender' | 'background';
+export type LoaderWindowSource = 'playback' | 'seek' | 'prerender' | 'background';
+export interface LoaderWindowRequest {
+    clipId: string;
+    resourceId: string;
+    source: LoaderWindowSource;
+    targetTimeUs: number;
+    windowStartUs: number;
+    windowEndUs: number;
+    byteStart?: number;
+    byteEnd?: number;
+    priority: LoaderWindowPriority;
+    dedupeKey: string;
+    alignedToKeyframe?: boolean;
+}
+export interface LoaderWindowTask {
+    clip: Clip;
+    resource: Resource;
+    request: LoaderWindowRequest;
+    attempts: number;
+    state: LoaderWindowState;
+    bytesFetched: number;
+    enqueuedAt: number;
+    startedAt?: number;
+}
+export interface LoaderWindowQueueEntry {
+    task: LoaderWindowTask;
+    enqueuedAt: number;
+}
+export interface LoaderWindowQueueSnapshot {
+    clipId: string;
+    priority: LoaderWindowPriority;
+    state: LoaderWindowState;
+    attempts: number;
+    enqueuedAt: number;
+    windowStartUs: number;
+    windowEndUs: number;
+}
+export interface WindowTaskContext {
+    task: LoaderWindowTask;
+    abortController: AbortController;
+    fetchPromise: Promise<void>;
+    abortReason?: 'cancelled' | 'stall' | 'dispose' | 'error';
+}
+export type LoaderWindowState = 'pending' | 'fetching' | 'streaming' | 'completed' | 'failed';
+export interface LoaderWindowConfig {
+    maxInflightPerClip: number;
+    maxInflight: number;
+    chunkSize: number;
+}
+export interface LoaderWindowRuntimeConfig {
+    maxInflightPerClip: number;
+    maxInflight: number;
+    chunkSize: number;
+    stallTimeoutMs: number;
+    retry: {
+        maxAttempts: number;
+        baseDelayMs: number;
+    };
+}
+export interface LoaderWindowMetrics {
+    dispatched: number;
+    completed: number;
+    failed: number;
+    retries: number;
+    stall: number;
+    rangeResolved: number;
+    rangeUnavailable: number;
+}
+export interface LoaderWindowMetricsSnapshot extends LoaderWindowMetrics {
+    inflight: number;
+    queued: number;
+}
+export interface LoaderWindowEventPayload {
+    clipId: string;
+    windowStartUs: number;
+    windowEndUs: number;
+    priority: LoaderWindowPriority;
+    requestId: string;
+    metrics: LoaderWindowMetricsSnapshot;
+    bytesFetched?: number;
+    bytesWritten?: number;
+    durationMs?: number;
+    reason?: string;
+    retryCount?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/stages/mux/MP4Muxer.d.ts

@@ -0,0 +1,44 @@
+import { MuxConfig, MuxTrack } from './types';
+
+/**
+ * MP4 Muxer - Multiplex encoded chunks into MP4 container
+ * Terminal stage that consumes encoded chunks and produces MP4 file
+ */
+export declare class MP4Muxer {
+    private mp4boxFile;
+    tracks: Map<number, MuxTrack>;
+    private mp4Tracks;
+    outputChunks: Uint8Array[];
+    get totalBytesWritten(): number;
+    isFinalized: boolean;
+    private config;
+    constructor(config?: MuxConfig);
+    private setupHandlers;
+    private initializeTracks;
+    private addTrack;
+    private configureFragmentedTrack;
+    private createVideoTrackOptions;
+    private createAudioTrackOptions;
+    /**
+     * Write video chunk to muxer
+     */
+    writeVideoChunk(chunk: EncodedVideoChunk, trackId?: number): void;
+    /**
+     * Write audio chunk to muxer
+     */
+    writeAudioChunk(chunk: EncodedAudioChunk, trackId?: number): void;
+    /**
+     * Flush pending samples
+     */
+    flush(): void;
+    /**
+     * Finalize and get the output
+     */
+    finalize(): Blob;
+    /**
+     * Clear output chunks (after they've been consumed)
+     */
+    clearOutputChunks(): void;
+    destroy(): void;
+}
+//# sourceMappingURL=MP4Muxer.d.ts.map

package/dist/stages/mux/MP4Muxer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MP4Muxer.d.ts","sourceRoot":"","sources":["../../../src/stages/mux/MP4Muxer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAqBnD;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,UAAU,CAAM;IACxB,MAAM,wBAA+B;IACrC,OAAO,CAAC,SAAS,CAA6B;IAG9C,YAAY,EAAE,UAAU,EAAE,CAAM;IAGhC,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAGD,WAAW,UAAS;IAEpB,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,GAAE,SAAgC;IAOpD,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,gBAAgB;IA+BxB,OAAO,CAAC,QAAQ;IA0BhB,OAAO,CAAC,wBAAwB;IAsChC,OAAO,CAAC,uBAAuB;IAqC/B,OAAO,CAAC,uBAAuB;IAuC/B;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,GAAE,MAAU,GAAG,IAAI;IAkCpE;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,GAAE,MAAU,GAAG,IAAI;IAgCpE;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,QAAQ,IAAI,IAAI;IAuBhB;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB,OAAO,IAAI,IAAI;CAOhB"}