@bendyline/squisq-video-react 1.2.0 → 1.2.1

package/src/audioTrack.ts

@@ -0,0 +1,323 @@
+/**
+ * audioTrack — In-browser audio rendering + AAC encoding for MP4 export.
+ *
+ * Replaces the CLI's ffmpeg `adelay`/`atrim`/`amix` graph with browser-native
+ * primitives:
+ *
+ *  - {@link supportsWebCodecsAac} probes whether the browser can encode AAC
+ *    (WebCodecs `AudioEncoder`).
+ *  - {@link renderAudioTimeline} mixes an {@link AudioTimelineClip} list into a
+ *    single `AudioBuffer` using an `OfflineAudioContext` (decode → schedule →
+ *    render).
+ *  - {@link encodeAacTrack} feeds that buffer through a WebCodecs
+ *    `AudioEncoder` and hands the chunks to an mp4-muxer audio track (tier 1).
+ *  - {@link audioBufferToWav} + {@link muxAudioWithFfmpegWasm} cover the
+ *    ffmpeg.wasm fallback (tier 2).
+ *  - {@link selectAudioTier} is the pure capability→tier decision shared with
+ *    `useVideoExport` (and unit-tested at the module boundary).
+ */
+
+import type { AudioTimelineClip } from '@bendyline/squisq-video';
+
+/** Sample rate the export renders + encodes audio at. */
+export const EXPORT_AUDIO_SAMPLE_RATE = 48_000;
+/** Channel count the export renders + encodes audio at (stereo). */
+export const EXPORT_AUDIO_CHANNELS = 2;
+
+/** Tier-3 reason used when AAC encoding is impossible and no ffmpeg fallback. */
+export const REASON_NO_AAC_NO_SAB =
+  'This browser cannot encode AAC audio (WebCodecs AudioEncoder unavailable) ' +
+  'and the ffmpeg.wasm fallback requires cross-origin isolation (SharedArrayBuffer).';
+
+// ── Capability probe ───────────────────────────────────────────────
+
+/**
+ * Whether the browser can encode AAC (`mp4a.40.2`) via WebCodecs.
+ * Returns false when `AudioEncoder` is undefined (e.g. Node/jsdom, Safari,
+ * older Chromium) or the config is unsupported.
+ */
+export async function supportsWebCodecsAac(
+  sampleRate: number = EXPORT_AUDIO_SAMPLE_RATE,
+  channels: number = EXPORT_AUDIO_CHANNELS,
+): Promise<boolean> {
+  if (typeof AudioEncoder === 'undefined') return false;
+  try {
+    const support = await AudioEncoder.isConfigSupported({
+      codec: 'mp4a.40.2',
+      sampleRate,
+      numberOfChannels: channels,
+      bitrate: 128_000,
+    });
+    return support.supported === true;
+  } catch {
+    return false;
+  }
+}
+
+// ── Tier selection (pure) ──────────────────────────────────────────
+
+export interface AudioTierInputs {
+  /** Whether the doc has any audio timeline clips to include at all. */
+  hasClips: boolean;
+  /** Whether WebCodecs AAC encoding is available. */
+  aacSupported: boolean;
+  /** Whether `SharedArrayBuffer` (ffmpeg.wasm path) is available. */
+  sharedArrayBufferAvailable: boolean;
+  /** Whether the main-thread WebCodecs H.264 encoder is in use (tier-1 host). */
+  canUseMainThreadWebCodecs: boolean;
+}
+
+export interface AudioTierDecision {
+  /**
+   * 1 → inline AAC into the video muxer.
+   * 2 → finalize video-only then ffmpeg.wasm mux pass.
+   * 3 → video-only (no audio).
+   */
+  tier: 1 | 2 | 3;
+  /**
+   * Reason audio will be absent, when tier 3. `null` means "there was simply
+   * no audio to include" (not a failure). Non-null for a genuine capability
+   * shortfall. Always `null` for tiers 1 and 2 (the attempt is expected to
+   * succeed; the caller downgrades with a fresh reason on runtime failure).
+   */
+  reason: string | null;
+}
+
+/**
+ * Decide which audio tier to run from capability booleans. Pure — the single
+ * source of truth for tier selection, shared with `useVideoExport`.
+ */
+export function selectAudioTier(inputs: AudioTierInputs): AudioTierDecision {
+  if (!inputs.hasClips) {
+    return { tier: 3, reason: null };
+  }
+  if (inputs.aacSupported && inputs.canUseMainThreadWebCodecs) {
+    return { tier: 1, reason: null };
+  }
+  if (inputs.sharedArrayBufferAvailable) {
+    return { tier: 2, reason: null };
+  }
+  return { tier: 3, reason: REASON_NO_AAC_NO_SAB };
+}
+
+// ── OfflineAudioContext rendering ──────────────────────────────────
+
+type OfflineCtor = new (
+  numberOfChannels: number,
+  length: number,
+  sampleRate: number,
+) => OfflineAudioContext;
+
+function resolveOfflineAudioContext(): OfflineCtor {
+  const g = globalThis as unknown as {
+    OfflineAudioContext?: OfflineCtor;
+    webkitOfflineAudioContext?: OfflineCtor;
+  };
+  const ctor = g.OfflineAudioContext ?? g.webkitOfflineAudioContext;
+  if (!ctor) {
+    throw new Error('OfflineAudioContext is not available in this environment.');
+  }
+  return ctor;
+}
+
+/**
+ * Mix a list of timeline clips into one `AudioBuffer`.
+ *
+ * Decodes each unique source once, then schedules an `AudioBufferSourceNode`
+ * per clip at its `startSec` with the trim window (`offset = sourceInSec`,
+ * `duration = durationSec`). Undecodable sources are skipped rather than
+ * failing the whole render.
+ */
+export async function renderAudioTimeline(
+  clips: AudioTimelineClip[],
+  buffers: Map<string, ArrayBuffer>,
+  totalDurationSec: number,
+  sampleRate: number = EXPORT_AUDIO_SAMPLE_RATE,
+): Promise<AudioBuffer> {
+  const Ctor = resolveOfflineAudioContext();
+  const channels = EXPORT_AUDIO_CHANNELS;
+  const length = Math.max(1, Math.ceil(totalDurationSec * sampleRate));
+  const ctx = new Ctor(channels, length, sampleRate);
+
+  // Decode each unique source once. decodeAudioData detaches the buffer, so
+  // hand it a copy to keep the caller's ArrayBuffer reusable.
+  const decoded = new Map<string, AudioBuffer>();
+  for (const [src, data] of buffers) {
+    try {
+      decoded.set(src, await ctx.decodeAudioData(data.slice(0)));
+    } catch {
+      // Skip undecodable sources; the clip is simply omitted.
+    }
+  }
+
+  for (const clip of clips) {
+    const buffer = decoded.get(clip.src);
+    if (!buffer) continue;
+    const node = ctx.createBufferSource();
+    node.buffer = buffer;
+    node.connect(ctx.destination);
+    const when = Math.max(0, clip.startSec);
+    const offset = Math.max(0, clip.sourceInSec);
+    const duration = Math.max(0, clip.durationSec);
+    node.start(when, offset, duration);
+  }
+
+  return ctx.startRendering();
+}
+
+// ── WebCodecs AAC encode (tier 1) ──────────────────────────────────
+
+/** Minimal muxer surface {@link encodeAacTrack} needs. */
+export interface AudioChunkSink {
+  addAudioChunk(chunk: EncodedAudioChunk, meta?: EncodedAudioChunkMetadata): void;
+}
+
+/**
+ * Encode an `AudioBuffer` to AAC via WebCodecs and feed the chunks to `sink`.
+ * Resolves once every chunk has been flushed to the muxer. Throws only if the
+ * `AudioEncoder` errors — the caller wraps this so audio failure never aborts
+ * the video export.
+ */
+export async function encodeAacTrack(
+  audioBuffer: AudioBuffer,
+  sink: AudioChunkSink,
+  bitrate: number,
+): Promise<void> {
+  if (typeof AudioEncoder === 'undefined' || typeof AudioData === 'undefined') {
+    throw new Error('WebCodecs AudioEncoder is not available.');
+  }
+
+  const sampleRate = audioBuffer.sampleRate;
+  const channels = audioBuffer.numberOfChannels;
+
+  let encodeError: Error | null = null;
+  const encoder = new AudioEncoder({
+    output: (chunk, meta) => sink.addAudioChunk(chunk, meta ?? undefined),
+    error: (err) => {
+      encodeError = err instanceof Error ? err : new Error(String(err));
+    },
+  });
+
+  encoder.configure({ codec: 'mp4a.40.2', sampleRate, numberOfChannels: channels, bitrate });
+
+  const FRAME = 1024; // samples per AudioData chunk
+  const total = audioBuffer.length;
+  const channelData: Float32Array[] = [];
+  for (let ch = 0; ch < channels; ch++) {
+    channelData.push(audioBuffer.getChannelData(ch));
+  }
+
+  for (let offset = 0; offset < total; offset += FRAME) {
+    if (encodeError) break;
+    const count = Math.min(FRAME, total - offset);
+    // Planar layout: all of channel 0, then all of channel 1, …
+    const planar = new Float32Array(count * channels);
+    for (let ch = 0; ch < channels; ch++) {
+      planar.set(channelData[ch].subarray(offset, offset + count), ch * count);
+    }
+    const timestamp = Math.round((offset / sampleRate) * 1_000_000);
+    const audioData = new AudioData({
+      format: 'f32-planar',
+      sampleRate,
+      numberOfFrames: count,
+      numberOfChannels: channels,
+      timestamp,
+      data: planar,
+    });
+    encoder.encode(audioData);
+    audioData.close();
+  }
+
+  await encoder.flush();
+  encoder.close();
+  if (encodeError) throw encodeError;
+}
+
+// ── WAV serialization (tier 2 input) ───────────────────────────────
+
+/**
+ * Serialize an `AudioBuffer` to a 16-bit PCM WAV byte array. Used to hand the
+ * rendered audio to the ffmpeg.wasm fallback for muxing.
+ */
+export function audioBufferToWav(buffer: AudioBuffer): Uint8Array {
+  const channels = buffer.numberOfChannels;
+  const sampleRate = buffer.sampleRate;
+  const frames = buffer.length;
+  const bytesPerSample = 2;
+  const blockAlign = channels * bytesPerSample;
+  const dataSize = frames * blockAlign;
+  const out = new ArrayBuffer(44 + dataSize);
+  const view = new DataView(out);
+
+  const writeStr = (offset: number, str: string) => {
+    for (let i = 0; i < str.length; i++) view.setUint8(offset + i, str.charCodeAt(i));
+  };
+
+  writeStr(0, 'RIFF');
+  view.setUint32(4, 36 + dataSize, true);
+  writeStr(8, 'WAVE');
+  writeStr(12, 'fmt ');
+  view.setUint32(16, 16, true); // PCM chunk size
+  view.setUint16(20, 1, true); // PCM format
+  view.setUint16(22, channels, true);
+  view.setUint32(24, sampleRate, true);
+  view.setUint32(28, sampleRate * blockAlign, true); // byte rate
+  view.setUint16(32, blockAlign, true);
+  view.setUint16(34, bytesPerSample * 8, true);
+  writeStr(36, 'data');
+  view.setUint32(40, dataSize, true);
+
+  const channelData: Float32Array[] = [];
+  for (let ch = 0; ch < channels; ch++) channelData.push(buffer.getChannelData(ch));
+
+  let pos = 44;
+  for (let i = 0; i < frames; i++) {
+    for (let ch = 0; ch < channels; ch++) {
+      let sample = channelData[ch][i];
+      sample = Math.max(-1, Math.min(1, sample));
+      view.setInt16(pos, sample < 0 ? sample * 0x8000 : sample * 0x7fff, true);
+      pos += 2;
+    }
+  }
+
+  return new Uint8Array(out);
+}
+
+// ── ffmpeg.wasm mux fallback (tier 2) ──────────────────────────────
+
+/**
+ * Mux a pre-encoded video-only MP4 with a WAV audio track in a single
+ * ffmpeg.wasm pass (`-c:v copy -c:a aac -shortest`). Requires
+ * `SharedArrayBuffer` (cross-origin isolation). Returns the muxed MP4 bytes.
+ */
+export async function muxAudioWithFfmpegWasm(
+  videoMp4: Uint8Array,
+  wav: Uint8Array,
+  audioBitrate: number,
+): Promise<Uint8Array> {
+  const { FFmpeg } = await import('@ffmpeg/ffmpeg');
+  const ffmpeg = new FFmpeg();
+  await ffmpeg.load();
+  try {
+    await ffmpeg.writeFile('video.mp4', videoMp4);
+    await ffmpeg.writeFile('audio.wav', wav);
+    await ffmpeg.exec([
+      '-i',
+      'video.mp4',
+      '-i',
+      'audio.wav',
+      '-c:v',
+      'copy',
+      '-c:a',
+      'aac',
+      '-b:a',
+      String(audioBitrate),
+      '-shortest',
+      'out.mp4',
+    ]);
+    const data = await ffmpeg.readFile('out.mp4');
+    return data instanceof Uint8Array ? data : new TextEncoder().encode(data as string);
+  } finally {
+    ffmpeg.terminate();
+  }
+}

package/src/hooks/useFrameCapture.ts

@@ -152,7 +152,7 @@ export function useFrameCapture(): FrameCaptureHandle {
       const captionStyle: CaptionStyle = captionMode === 'social' ? 'social' : 'standard';
 
       const playerElement = createElement(DocPlayer, {
-        script: doc,
+        doc,
         basePath: '.',
         renderMode: true,
         showControls: false,

package/src/hooks/useVideoExport.ts

@@ -18,8 +18,8 @@
 import { useState, useRef, useCallback, useEffect } from 'react';
 import type { Doc } from '@bendyline/squisq/schemas';
 import type { MediaProvider } from '@bendyline/squisq/schemas';
-import type { VideoQuality, VideoOrientation } from '@bendyline/squisq-video';
-import { resolveDimensions } from '@bendyline/squisq-video';
+import type { VideoQuality, VideoOrientation, AudioTimelineClip } from '@bendyline/squisq-video';
+import { resolveDimensions, computeAudioTimeline, QUALITY_PRESETS } from '@bendyline/squisq-video';
 import type { CaptionMode } from '@bendyline/squisq-react';
 import {
   createEncoder,
@@ -28,8 +28,52 @@ import {
   type MainThreadEncoder,
 } from '../mainThreadEncoder.js';
 import { createWorkerEncoder } from '../workerEncoder.js';
+import {
+  supportsWebCodecsAac,
+  selectAudioTier,
+  renderAudioTimeline,
+  encodeAacTrack,
+  audioBufferToWav,
+  muxAudioWithFfmpegWasm,
+  EXPORT_AUDIO_SAMPLE_RATE,
+  EXPORT_AUDIO_CHANNELS,
+} from '../audioTrack.js';
 import { useFrameCapture } from './useFrameCapture.js';
 
+// ── Audio resolution ───────────────────────────────────────────────
+
+/**
+ * Resolve the raw bytes for every unique source in the audio timeline from
+ * (in order) the pre-collected audio map, the images map, then the
+ * MediaProvider. Sources that can't be resolved are simply omitted — the
+ * caller degrades gracefully rather than failing.
+ */
+async function resolveAudioBuffers(
+  clips: AudioTimelineClip[],
+  sources: {
+    audio?: Map<string, ArrayBuffer>;
+    images?: Map<string, ArrayBuffer>;
+    mediaProvider?: MediaProvider;
+  },
+): Promise<Map<string, ArrayBuffer>> {
+  const srcs = new Set(clips.map((c) => c.src));
+  const out = new Map<string, ArrayBuffer>();
+  for (const src of srcs) {
+    let data = sources.audio?.get(src) ?? sources.images?.get(src);
+    if (!data && sources.mediaProvider) {
+      try {
+        const url = await sources.mediaProvider.resolveUrl(src);
+        const res = await fetch(url);
+        if (res.ok) data = await res.arrayBuffer();
+      } catch {
+        // Unresolvable source; skip it.
+      }
+    }
+    if (data) out.set(src, data);
+  }
+  return out;
+}
+
 // ── Types ──────────────────────────────────────────────────────────
 
 export type VideoExportState =
@@ -80,6 +124,19 @@ export interface VideoExportResult {
   downloadUrl: string | null;
   /** File size in bytes (populated when state === 'complete') */
   fileSize: number;
+  /**
+   * Whether an audio track was muxed into the exported MP4 (populated when
+   * state === 'complete'). False when the doc had no audio or when audio was
+   * skipped/degraded — see {@link audioSkippedReason}.
+   */
+  audioIncluded: boolean;
+  /**
+   * Why audio is absent, when `audioIncluded` is false. `null` means the doc
+   * simply had no audio (not a failure); a non-null string explains a genuine
+   * capability shortfall or runtime failure. Audio problems never fail the
+   * export — the video always completes.
+   */
+  audioSkippedReason: string | null;
   /** Error message (populated when state === 'error') */
   error: string | null;
   /** Seconds elapsed since export started */
@@ -104,6 +161,8 @@ export function useVideoExport(): VideoExportResult {
   const [backend, setBackend] = useState<'webcodecs' | 'ffmpeg-wasm' | null>(null);
   const [downloadUrl, setDownloadUrl] = useState<string | null>(null);
   const [fileSize, setFileSize] = useState(0);
+  const [audioIncluded, setAudioIncluded] = useState(false);
+  const [audioSkippedReason, setAudioSkippedReason] = useState<string | null>(null);
   const [error, setError] = useState<string | null>(null);
 
   const [elapsed, setElapsed] = useState(0);
@@ -148,6 +207,8 @@ export function useVideoExport(): VideoExportResult {
     setBackend(null);
     setDownloadUrl(null);
     setFileSize(0);
+    setAudioIncluded(false);
+    setAudioSkippedReason(null);
     setError(null);
     setElapsed(0);
     setEstimatedRemaining(0);
@@ -178,6 +239,8 @@ export function useVideoExport(): VideoExportResult {
       }
       setDownloadUrl(null);
       setFileSize(0);
+      setAudioIncluded(false);
+      setAudioSkippedReason(null);
       setError(null);
 
       const quality = config.quality ?? 'normal';
@@ -250,9 +313,79 @@ export function useVideoExport(): VideoExportResult {
         const canUseWebCodecs =
           webCodecsAvailable && (await supportsWebCodecsH264({ width, height, fps, quality }));
 
+        // ── Audio: tier selection + (best-effort) render ──────────
+        // The browser frame-capture path has no cover pre-roll (Playwright
+        // only), so the timeline is unshifted. Every audio operation below is
+        // wrapped so a failure degrades to a silent video with a reason —
+        // audio never aborts the export.
+        const audioBitrate = (QUALITY_PRESETS[quality] ?? QUALITY_PRESETS.normal).audioBitrate;
+        const timeline = computeAudioTimeline(doc, 0);
+        const aacSupported =
+          timeline.length > 0
+            ? await supportsWebCodecsAac(EXPORT_AUDIO_SAMPLE_RATE, EXPORT_AUDIO_CHANNELS)
+            : false;
+        const tierDecision = selectAudioTier({
+          hasClips: timeline.length > 0,
+          aacSupported,
+          sharedArrayBufferAvailable,
+          canUseMainThreadWebCodecs: canUseWebCodecs,
+        });
+
+        let renderedAudio: AudioBuffer | null = null;
+        let audioIncludedLocal = false;
+        let audioReasonLocal: string | null = tierDecision.reason;
+
+        if (tierDecision.tier === 1 || tierDecision.tier === 2) {
+          setPhase('Preparing audio…');
+          try {
+            const buffers = await resolveAudioBuffers(timeline, {
+              audio: config.audio,
+              images,
+              mediaProvider: config.mediaProvider,
+            });
+            if (buffers.size === 0) {
+              audioReasonLocal = 'Audio files for this document could not be loaded.';
+            } else {
+              const totalAudioDur = timeline.reduce(
+                (max, c) => Math.max(max, c.startSec + c.durationSec),
+                docDuration,
+              );
+              renderedAudio = await renderAudioTimeline(
+                timeline,
+                buffers,
+                totalAudioDur,
+                EXPORT_AUDIO_SAMPLE_RATE,
+              );
+            }
+          } catch (audioErr: unknown) {
+            renderedAudio = null;
+            audioReasonLocal = `Audio could not be prepared: ${
+              audioErr instanceof Error ? audioErr.message : String(audioErr)
+            }`;
+          }
+        }
+
+        const useInlineAudio = renderedAudio !== null && tierDecision.tier === 1;
+        const useFfmpegAudio = renderedAudio !== null && tierDecision.tier === 2;
+
+        if (cancelledRef.current) return;
+
         let encoder: MainThreadEncoder;
         if (canUseWebCodecs) {
-          encoder = createEncoder({ width, height, fps, quality });
+          encoder = createEncoder({
+            width,
+            height,
+            fps,
+            quality,
+            ...(useInlineAudio && renderedAudio
+              ? {
+                  audio: {
+                    numberOfChannels: renderedAudio.numberOfChannels,
+                    sampleRate: renderedAudio.sampleRate,
+                  },
+                }
+              : {}),
+          });
           setBackend('webcodecs');
         } else if (sharedArrayBufferAvailable) {
           const workerEncoder = createWorkerEncoder({ width, height, fps, quality });
@@ -315,23 +448,69 @@ export function useVideoExport(): VideoExportResult {
 
         if (cancelledRef.current) return;
 
+        // ── Step 4a: Inline audio (tier 1) ────────────────────────
+        // Encode the rendered audio into the same muxer before finalizing.
+        if (useInlineAudio && renderedAudio && encoder.addAudioChunk) {
+          setState('encoding');
+          setPhase('Encoding audio…');
+          try {
+            await encodeAacTrack(
+              renderedAudio,
+              { addAudioChunk: encoder.addAudioChunk.bind(encoder) },
+              audioBitrate,
+            );
+            audioIncludedLocal = true;
+          } catch (audioErr: unknown) {
+            audioIncludedLocal = false;
+            audioReasonLocal = `Audio encoding failed: ${
+              audioErr instanceof Error ? audioErr.message : String(audioErr)
+            }`;
+          }
+        }
+
         // ── Step 4: Finalize MP4 ──────────────────────────────────
         setState('encoding');
         setPhase('Finalizing video…');
         setProgress(95);
 
-        const mp4Buffer = await encoder.finalize();
+        let outputBytes: ArrayBuffer | Uint8Array = await encoder.finalize();
         encoderRef.current = null;
 
         if (cancelledRef.current) return;
 
+        // ── Step 4b: ffmpeg.wasm audio mux (tier 2) ───────────────
+        // Video is finalized; add the audio in a single copy-video pass.
+        if (useFfmpegAudio && renderedAudio) {
+          setPhase('Muxing audio…');
+          try {
+            const wav = audioBufferToWav(renderedAudio);
+            const videoOnly =
+              outputBytes instanceof Uint8Array ? outputBytes : new Uint8Array(outputBytes);
+            outputBytes = await muxAudioWithFfmpegWasm(videoOnly, wav, audioBitrate);
+            audioIncludedLocal = true;
+          } catch (audioErr: unknown) {
+            audioIncludedLocal = false;
+            audioReasonLocal = `Audio muxing failed: ${
+              audioErr instanceof Error ? audioErr.message : String(audioErr)
+            }`;
+          }
+        }
+
+        if (cancelledRef.current) return;
+
         // ── Step 5: Create download URL ───────────────────────────
-        const blob = new Blob([mp4Buffer], { type: 'video/mp4' });
+        // Normalize to a plain ArrayBuffer-backed view for Blob (ffmpeg.wasm
+        // output may be typed over SharedArrayBuffer).
+        const finalBytes =
+          outputBytes instanceof Uint8Array ? outputBytes.slice() : new Uint8Array(outputBytes);
+        const blob = new Blob([finalBytes], { type: 'video/mp4' });
         const url = URL.createObjectURL(blob);
         downloadUrlRef.current = url;
 
         setDownloadUrl(url);
-        setFileSize(mp4Buffer.byteLength);
+        setFileSize(finalBytes.byteLength);
+        setAudioIncluded(audioIncludedLocal);
+        setAudioSkippedReason(audioIncludedLocal ? null : audioReasonLocal);
         setState('complete');
         setProgress(100);
         setPhase('Export complete');
@@ -367,6 +546,8 @@ export function useVideoExport(): VideoExportResult {
     backend,
     downloadUrl,
     fileSize,
+    audioIncluded,
+    audioSkippedReason,
     error,
     elapsed,
     estimatedRemaining,

package/src/index.ts

@@ -31,5 +31,8 @@ export { useFrameCapture } from './hooks/useFrameCapture.js';
 export type { FrameCaptureHandle } from './hooks/useFrameCapture.js';
 
 // ── Encoder Utilities (for advanced usage) ─────────────────────────
-export { supportsWebCodecs, createEncoder } from './mainThreadEncoder.js';
-export type { MainThreadEncoder } from './mainThreadEncoder.js';
+export { supportsWebCodecs, supportsWebCodecsH264, createEncoder } from './mainThreadEncoder.js';
+export type { MainThreadEncoder, EncoderConfig } from './mainThreadEncoder.js';
+
+// ── Audio (capability probe) ───────────────────────────────────────
+export { supportsWebCodecsAac } from './audioTrack.js';