avbridge 2.5.0 → 2.7.0

package/CHANGELOG.md

@@ -4,6 +4,91 @@ All notable changes to **avbridge.js** are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.7.0]
+
+Cross-browser confidence release. A Playwright-based test tier now
+validates that avbridge picks the right strategy on each major browser
+engine. No runtime code changes — the release is tooling, fixtures, and
+a new testing discipline.
+
+### Added
+
+- **Cross-browser test tier (Playwright).** New `tests/browser/` directory
+  with the matrix run via `npm run test:browser` across Chromium, Firefox,
+  and WebKit. Initial slice — `fixtures.spec.ts` — validates that `probe()`
+  and `classify()` produce the expected output for each fixture on each
+  browser (15 tests, ~11s). Per-browser expectations live in
+  `tests/browser/_expectations.ts` so evolving browser codec support is
+  a one-file change. Playwright's `webServer` config auto-starts Vite;
+  the five existing Puppeteer scripts are unchanged and continue to
+  cover Chromium-only scenarios. `npm run test:browser:ui` for the
+  interactive trace viewer.
+- New test harness page at `demo/tests-harness.html` that exposes the
+  avbridge API on `window` for `page.evaluate()`-style tests. Only served
+  in dev mode; not shipped in production builds.
+- New fixture: `bbb-hevc-aac.mkv` (generated via `npm run fixtures`) for
+  exercising the HEVC strategy boundary across browsers.
+- `docs/dev/TESTING.md` — documents the new Tier 4 alongside the
+  existing three tiers, with scope guidance (what belongs in `fixtures`,
+  `playback`, and `contract` spec files).
+
+### Findings worth surfacing
+
+- `classify()` is deliberately **browser-independent** for most codec
+  paths. Per-browser divergence surfaces at runtime via escalation, not
+  at classification. The test-tier split reflects this architecture:
+  `fixtures.spec.ts` for the deterministic decision, `playback.spec.ts`
+  (planned v2.7.1) for runtime escalation behavior.
+
+### Coming in follow-ups
+
+- **v2.7.1** — `playback.spec.ts`. Bootstrap → play → destroy per
+  fixture per browser. Catches runtime escalation (e.g. Firefox
+  escalating HEVC MKV from remux → fallback when MSE rejects hevc1.*).
+- **v2.7.2** — `contract.spec.ts`. HTMLMediaElement event + property
+  parity across strategies and browsers.
+
+## [2.6.0]
+
+`<avbridge-player>` polish release. Four targeted ergonomics upgrades.
+
+### Added
+
+- **Typed `addEventListener` / `removeEventListener` overloads** on both
+  `<avbridge-video>` and `<avbridge-player>`. Consumers using avbridge
+  custom events (`ready`, `strategychange`, `trackschange`, `timeupdate`,
+  `error`, etc.) now receive a typed `CustomEvent<Detail>` without the
+  `as unknown as CustomEvent` cast tax. Standard HTMLMediaElement events
+  (`play`, `pause`, `seeking`, etc.) retain their native typing via
+  `HTMLElementEventMap`. New type: `AvbridgeVideoElementEventMap`.
+- **Drag-and-drop file input** on `<avbridge-player>`. Drop a video file
+  onto the player and it loads + plays, matching the demo's file-picker
+  flow. Visual dashed-border feedback during dragover (stylable via
+  `.avp-dragover`).
+- **`<track>` children parsing.** Light-DOM `<track src="subs.vtt"
+  srclang="en">` children declared inside `<avbridge-player>` or
+  `<avbridge-video>` were already cloned into the shadow `<video>` for
+  native/remux strategies; they now also populate the subtitle list that
+  the player's settings menu renders. HTML-declared tracks get stable
+  IDs in the 10000+ range to avoid colliding with container-embedded
+  IDs. MutationObserver-driven — add or remove a `<track>` at any time
+  and the menu updates.
+- **HTMLMediaElement parity — `readyState` and `seekable`** on canvas
+  strategies. Previously the inner `<video>` (with no `src`) returned
+  `readyState: 0` and empty `seekable` ranges for hybrid/fallback.
+  Now synthesized: `readyState` reflects frame+audio readiness,
+  `seekable` spans `[0, duration]` once probe completes. `buffered`
+  and `networkState` remain deferred — both need meaningful transport
+  state machinery.
+
+### Deprecated / Deferred
+
+- `buffered` on canvas strategies still returns empty TimeRanges. Requires
+  decoder-position → media-time plumbing; tracked for a follow-up.
+- `networkState` not yet exposed on the element. Needs a transport
+  state machine spanning probe → libav reader → decoder; out of scope
+  for this release.
+
 ## [2.5.0]
 
 The "legacy transcode breadth" release. avbridge.js can now transcode

package/dist/{chunk-TBW26OPP.cjs → chunk-6SOFJV44.cjs}

@@ -1990,6 +1990,35 @@ async function loadBridge() {
   }
 }
 
+// src/util/time-ranges.ts
+function makeTimeRanges(ranges) {
+  const frozen = ranges.slice();
+  const impl = {
+    get length() {
+      return frozen.length;
+    },
+    start(index) {
+      if (index < 0 || index >= frozen.length) {
+        throw new DOMException(
+          `TimeRanges.start: index ${index} out of range (length=${frozen.length})`,
+          "IndexSizeError"
+        );
+      }
+      return frozen[index][0];
+    },
+    end(index) {
+      if (index < 0 || index >= frozen.length) {
+        throw new DOMException(
+          `TimeRanges.end: index ${index} out of range (length=${frozen.length})`,
+          "IndexSizeError"
+        );
+      }
+      return frozen[index][1];
+    }
+  };
+  return impl;
+}
+
 // src/strategies/hybrid/index.ts
 var READY_AUDIO_BUFFER_SECONDS = 0.3;
 var READY_TIMEOUT_SECONDS = 10;
@@ -2047,6 +2076,18 @@ async function createHybridSession(ctx, target, transport) {
       get: () => ctx.duration ?? NaN
     });
   }
+  Object.defineProperty(target, "readyState", {
+    configurable: true,
+    get: () => {
+      if (!renderer.hasFrames()) return 0;
+      if (!audio.isPlaying() && audio.bufferAhead() <= 0 && !audio.isNoAudio()) return 1;
+      return 2;
+    }
+  });
+  Object.defineProperty(target, "seekable", {
+    configurable: true,
+    get: () => makeTimeRanges(ctx.duration && Number.isFinite(ctx.duration) && ctx.duration > 0 ? [[0, ctx.duration]] : [])
+  });
   async function waitForBuffer() {
     const start = performance.now();
     while (true) {
@@ -2128,6 +2169,8 @@ async function createHybridSession(ctx, target, transport) {
         delete target.paused;
         delete target.volume;
         delete target.muted;
+        delete target.readyState;
+        delete target.seekable;
       } catch {
       }
     },
@@ -2648,6 +2691,18 @@ async function createFallbackSession(ctx, target, transport) {
       get: () => ctx.duration ?? NaN
     });
   }
+  Object.defineProperty(target, "readyState", {
+    configurable: true,
+    get: () => {
+      if (!renderer.hasFrames()) return 0;
+      if (!audio.isPlaying() && audio.bufferAhead() <= 0 && !audio.isNoAudio()) return 1;
+      return 2;
+    }
+  });
+  Object.defineProperty(target, "seekable", {
+    configurable: true,
+    get: () => makeTimeRanges(ctx.duration && Number.isFinite(ctx.duration) && ctx.duration > 0 ? [[0, ctx.duration]] : [])
+  });
   async function waitForBuffer() {
     const start = performance.now();
     let firstFrameAtMs = 0;
@@ -2750,6 +2805,8 @@ async function createFallbackSession(ctx, target, transport) {
         delete target.paused;
         delete target.volume;
         delete target.muted;
+        delete target.readyState;
+        delete target.seekable;
       } catch {
       }
     },
@@ -3309,5 +3366,5 @@ exports.NATIVE_VIDEO_CODECS = NATIVE_VIDEO_CODECS;
 exports.UnifiedPlayer = UnifiedPlayer;
 exports.classifyContext = classifyContext;
 exports.createPlayer = createPlayer;
-//# sourceMappingURL=chunk-TBW26OPP.cjs.map
-//# sourceMappingURL=chunk-TBW26OPP.cjs.map
+//# sourceMappingURL=chunk-6SOFJV44.cjs.map
+//# sourceMappingURL=chunk-6SOFJV44.cjs.map