avbridge 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -4,7 +4,45 @@ All notable changes to **avbridge** 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).
 
-## [Unreleased]
+## [1.1.0]
+
+### Added
+
+- **`<avbridge-player>` is now a true `<video>` drop-in.** The element gained
+  the missing slice of the `HTMLMediaElement` surface so existing code that
+  reaches for a `<video>` can swap to `<avbridge-player>` with no behavioural
+  changes:
+  - **Properties**: `poster`, `volume`, `playbackRate`, `videoWidth`,
+    `videoHeight`, `played`, `seekable`, `crossOrigin`, `disableRemotePlayback`.
+  - **Method**: `canPlayType(mimeType)` — passes through to the underlying
+    `<video>`. Note that this answers about the *browser's* native support,
+    not avbridge's full capabilities.
+  - **Attributes** (reflected to the inner `<video>`): `poster`, `playsinline`,
+    `crossorigin`, `disableremoteplayback`.
+  - **Event forwarding**: 17 standard `HTMLMediaElement` events are forwarded
+    from the inner `<video>` to the wrapper element — `loadstart`,
+    `loadedmetadata`, `loadeddata`, `canplay`, `canplaythrough`, `play`,
+    `playing`, `pause`, `seeking`, `seeked`, `volumechange`, `ratechange`,
+    `durationchange`, `waiting`, `stalled`, `emptied`, `resize`. Consumers can
+    `el.addEventListener("loadedmetadata", …)` exactly like a real `<video>`.
+  - **`<track>` children**: light-DOM `<track>` elements declared as children
+    of `<avbridge-player>` are now mirrored into the shadow `<video>` and kept
+    in sync via a `MutationObserver`. This works for static HTML markup as
+    well as dynamic insertion / removal.
+  - **`videoElement` getter**: escape hatch returning the underlying shadow
+    `<video>` for native APIs the wrapper doesn't expose
+    (`requestPictureInPicture`, browser-native `audioTracks`, `captureStream`,
+    library integrations needing a real `HTMLVideoElement`). Caveat: when the
+    active strategy is `"fallback"` or `"hybrid"`, frames render to a canvas
+    overlay rather than into this `<video>`, so APIs that depend on the actual
+    pixels won't show the playing content in those modes.
+
+### Changed
+
+- The element's `observedAttributes` list grew to include `poster`,
+  `playsinline`, `crossorigin`, and `disableremoteplayback`.
+
+## [1.0.0]
 
 ### Added
 

package/dist/element.cjs

@@ -13,6 +13,26 @@ var PREFERRED_STRATEGY_VALUES = /* @__PURE__ */ new Set([
   "hybrid",
   "fallback"
 ]);
+var FORWARDED_VIDEO_EVENTS = [
+  "loadstart",
+  "loadedmetadata",
+  "loadeddata",
+  "canplay",
+  "canplaythrough",
+  "play",
+  "playing",
+  "pause",
+  "seeking",
+  "seeked",
+  "volumechange",
+  "ratechange",
+  "durationchange",
+  "waiting",
+  "stalled",
+  "emptied",
+  "resize",
+  "error"
+];
 var HTMLElementCtor = typeof HTMLElement !== "undefined" ? HTMLElement : class {
 };
 var AvbridgePlayerElement = class extends HTMLElementCtor {
@@ -22,6 +42,10 @@ var AvbridgePlayerElement = class extends HTMLElementCtor {
     "muted",
     "loop",
     "preload",
+    "poster",
+    "playsinline",
+    "crossorigin",
+    "disableremoteplayback",
     "diagnostics",
     "preferstrategy"
   ];
@@ -59,6 +83,8 @@ var AvbridgePlayerElement = class extends HTMLElementCtor {
   _pendingSeek = null;
   /** Set if play() was called before the player was ready. */
   _pendingPlay = false;
+  /** MutationObserver tracking light-DOM `<track>` children. */
+  _trackObserver = null;
   // ── Construction & lifecycle ───────────────────────────────────────────
   constructor() {
     super();
@@ -72,9 +98,20 @@ var AvbridgePlayerElement = class extends HTMLElementCtor {
       if (this._destroyed) return;
       this._dispatch("progress", { buffered: this._videoEl.buffered });
     });
+    for (const eventName of FORWARDED_VIDEO_EVENTS) {
+      this._videoEl.addEventListener(eventName, () => {
+        if (this._destroyed) return;
+        this.dispatchEvent(new Event(eventName, { bubbles: false }));
+      });
+    }
   }
   connectedCallback() {
     if (this._destroyed) return;
+    this._syncTextTracks();
+    if (!this._trackObserver) {
+      this._trackObserver = new MutationObserver(() => this._syncTextTracks());
+      this._trackObserver.observe(this, { childList: true, subtree: false });
+    }
     const source = this._activeSource();
     if (source != null) {
       void this._bootstrap(source);
@@ -82,6 +119,10 @@ var AvbridgePlayerElement = class extends HTMLElementCtor {
   }
   disconnectedCallback() {
     if (this._destroyed) return;
+    if (this._trackObserver) {
+      this._trackObserver.disconnect();
+      this._trackObserver = null;
+    }
     this._bootstrapId++;
     void this._teardown();
   }
@@ -95,12 +136,16 @@ var AvbridgePlayerElement = class extends HTMLElementCtor {
       case "autoplay":
       case "muted":
       case "loop":
+      case "playsinline":
+      case "disableremoteplayback":
         if (newValue == null) this._videoEl.removeAttribute(name);
         else this._videoEl.setAttribute(name, newValue);
         break;
       case "preload":
-        if (newValue == null) this._videoEl.removeAttribute("preload");
-        else this._videoEl.setAttribute("preload", newValue);
+      case "poster":
+      case "crossorigin":
+        if (newValue == null) this._videoEl.removeAttribute(name);
+        else this._videoEl.setAttribute(name, newValue);
         break;
       case "diagnostics":
         break;
@@ -120,6 +165,26 @@ var AvbridgePlayerElement = class extends HTMLElementCtor {
     if (this._src != null) return this._src;
     return null;
   }
+  /**
+   * Mirror light-DOM `<track>` children into the shadow `<video>` so that
+   * the browser's native text-track machinery picks them up. Called on
+   * connect, on every mutation of light-DOM children, and once after each
+   * source change so newly-set tracks survive a fresh `<video>`.
+   *
+   * Strategy: clone the children. We don't move them because the user's
+   * code may still hold references to the originals (e.g. to set `default`).
+   * The shadow copies are throwaway — we wipe them on every sync.
+   */
+  _syncTextTracks() {
+    const existing = this._videoEl.querySelectorAll("track");
+    for (const t of Array.from(existing)) t.remove();
+    for (const child of Array.from(this.children)) {
+      if (child.tagName === "TRACK") {
+        const clone = child.cloneNode(true);
+        this._videoEl.appendChild(clone);
+      }
+    }
+  }
   /** Internal src setter — separate from the property setter so the
    * attributeChangedCallback can use it without re-entering reflection. */
   _setSrcInternal(value) {
@@ -167,6 +232,7 @@ var AvbridgePlayerElement = class extends HTMLElementCtor {
       return;
     }
     this._player = player;
+    this._syncTextTracks();
     player.on("strategy", ({ strategy, reason }) => {
       const cls = player.getDiagnostics().strategyClass;
       this._strategy = strategy;
@@ -346,12 +412,87 @@ var AvbridgePlayerElement = class extends HTMLElementCtor {
    * `<video>.buffered` `TimeRanges` API. For the native and remux strategies
    * this reflects the underlying SourceBuffer / progressive download state.
    * For the hybrid and fallback (canvas-rendered) strategies it currently
-   * returns an empty TimeRanges; v1.1 will synthesize a coarse range from
-   * the decoder's read position.
+   * returns an empty TimeRanges; a future release will synthesize a coarse
+   * range from the decoder's read position.
    */
   get buffered() {
     return this._videoEl.buffered;
   }
+  // ── HTMLMediaElement parity ───────────────────────────────────────────
+  // Mirror the standard <video> surface so consumers can drop the element
+  // in as a <video> replacement. Each property is a thin passthrough to the
+  // shadow `<video>`.
+  get poster() {
+    return this._videoEl.poster;
+  }
+  set poster(value) {
+    if (value == null || value === "") this.removeAttribute("poster");
+    else this.setAttribute("poster", value);
+  }
+  get volume() {
+    return this._videoEl.volume;
+  }
+  set volume(value) {
+    this._videoEl.volume = value;
+  }
+  get playbackRate() {
+    return this._videoEl.playbackRate;
+  }
+  set playbackRate(value) {
+    this._videoEl.playbackRate = value;
+  }
+  get videoWidth() {
+    return this._videoEl.videoWidth;
+  }
+  get videoHeight() {
+    return this._videoEl.videoHeight;
+  }
+  get played() {
+    return this._videoEl.played;
+  }
+  get seekable() {
+    return this._videoEl.seekable;
+  }
+  get crossOrigin() {
+    return this._videoEl.crossOrigin;
+  }
+  set crossOrigin(value) {
+    if (value == null) this.removeAttribute("crossorigin");
+    else this.setAttribute("crossorigin", value);
+  }
+  get disableRemotePlayback() {
+    return this._videoEl.disableRemotePlayback;
+  }
+  set disableRemotePlayback(value) {
+    if (value) this.setAttribute("disableremoteplayback", "");
+    else this.removeAttribute("disableremoteplayback");
+  }
+  /**
+   * Native `HTMLMediaElement.canPlayType()` passthrough. Note that this
+   * answers about the *browser's* native support, not avbridge's full
+   * capabilities — avbridge can play many formats this method returns ""
+   * for, by routing them to the remux/hybrid/fallback strategies.
+   */
+  canPlayType(mimeType) {
+    return this._videoEl.canPlayType(mimeType);
+  }
+  /**
+   * **Escape hatch.** The underlying shadow-DOM `<video>` element.
+   *
+   * Use for native browser APIs the wrapper doesn't expose:
+   * - `el.videoElement.requestPictureInPicture()`
+   * - `el.videoElement.audioTracks` (browser native, not avbridge's track list)
+   * - direct integration with libraries that need a real HTMLVideoElement
+   *
+   * **Caveat:** When the active strategy is `"fallback"` or `"hybrid"`,
+   * frames are rendered to a canvas overlay, not into this `<video>`.
+   * APIs that depend on the actual pixels (Picture-in-Picture, captureStream)
+   * will not show the playing content in those modes. Check `el.strategy`
+   * before using such APIs.
+   */
+  get videoElement() {
+    return this._videoEl;
+  }
   get strategy() {
     return this._strategy;
   }

package/dist/element.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/element/avbridge-player.ts","../src/element.ts"],"names":["createPlayer"],"mappings":"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","file":"element.cjs","sourcesContent":["/**\n * `<avbridge-player>` — reference web component for the avbridge engine.\n *\n * This is a *thin* wrapper around `createPlayer()`. Its purpose is to:\n *\n *   1. Validate the public API by being a real consumer of it.\n *   2. Drive lifecycle correctness in the core via adversarial integration tests.\n *   3. Provide a drop-in player for users who don't want to wire `createPlayer()`\n *      themselves.\n *\n * It is **not** a player UI framework. See `docs/dev/WEB_COMPONENT_SPEC.md`\n * for the full spec, lifecycle invariants, and edge case list.\n *\n * Phase A scope (this file): lifecycle scaffold only — `src` / `source` /\n * `currentTime` / `play` / `pause` / `load` / `destroy` / events. No built-in\n * controls. Shadow DOM contains a single `<video part=\"video\">`.\n */\n\nimport { createPlayer, type UnifiedPlayer } from \"../player.js\";\nimport type {\n  MediaInput,\n  StrategyName,\n  StrategyClass,\n  AudioTrackInfo,\n  SubtitleTrackInfo,\n  DiagnosticsSnapshot,\n} from \"../types.js\";\n\n/** Strategy preference passed via the `preferstrategy` attribute. */\ntype PreferredStrategy = \"auto\" | StrategyName;\n\nconst PREFERRED_STRATEGY_VALUES = new Set<PreferredStrategy>([\n  \"auto\",\n  \"native\",\n  \"remux\",\n  \"hybrid\",\n  \"fallback\",\n]);\n\n/**\n * `HTMLElement` is a browser-only global. SSR frameworks (Next.js, Astro,\n * Remix, etc.) commonly import library modules on the server to extract\n * types or do tree-shaking, even if the user only ends up using them in\n * the browser. If we extended `HTMLElement` directly, the `class extends`\n * expression would be evaluated at module load time and crash in Node.\n *\n * The fix: in non-browser environments, fall back to an empty stub class.\n * The element is never *constructed* server-side (the registration in\n * `element.ts` is guarded by `typeof customElements !== \"undefined\"`), so\n * the stub is never instantiated — it just lets the class declaration\n * evaluate cleanly so the module can be imported anywhere.\n */\nconst HTMLElementCtor: typeof HTMLElement =\n  typeof HTMLElement !== \"undefined\"\n    ? HTMLElement\n    : (class {} as unknown as typeof HTMLElement);\n\n/**\n * Custom element. Lifecycle correctness is enforced via a monotonically\n * increasing `_bootstrapId`: every async bootstrap captures the ID at start\n * and discards itself if the ID has changed by the time it resolves. This\n * single pattern handles disconnect-during-bootstrap, rapid src reassignment,\n * bootstrap races, and destroy-during-bootstrap.\n */\nexport class AvbridgePlayerElement extends HTMLElementCtor {\n  static readonly observedAttributes = [\n    \"src\",\n    \"autoplay\",\n    \"muted\",\n    \"loop\",\n    \"preload\",\n    \"diagnostics\",\n    \"preferstrategy\",\n  ];\n\n  // ── Internal state ─────────────────────────────────────────────────────\n\n  /** The shadow DOM `<video>` element that strategies render into. */\n  private _videoEl!: HTMLVideoElement;\n\n  /** Active player session, if any. Cleared on teardown. */\n  private _player: UnifiedPlayer | null = null;\n\n  /**\n   * Monotonic counter incremented on every (re)bootstrap. Async bootstrap\n   * work captures the current ID; if it doesn't match by the time the work\n   * resolves, the work is discarded.\n   */\n  private _bootstrapId = 0;\n\n  /** True after destroy() — element is permanently unusable. */\n  private _destroyed = false;\n\n  /** Internal source state. Either string-form (src) OR rich (source). */\n  private _src: string | null = null;\n  private _source: MediaInput | null = null;\n\n  /**\n   * Set when the `source` property setter is in the middle of clearing the\n   * `src` attribute as part of mutual exclusion. The attributeChangedCallback\n   * checks this flag and skips its normal \"clear source\" side effect, which\n   * would otherwise wipe the value we just set.\n   */\n  private _suppressSrcAttrCallback = false;\n\n  /** Last-known runtime state surfaced via getters. */\n  private _strategy: StrategyName | null = null;\n  private _strategyClass: StrategyClass | null = null;\n  private _audioTracks: AudioTrackInfo[] = [];\n  private _subtitleTracks: SubtitleTrackInfo[] = [];\n\n  /** Strategy preference (does not currently affect routing — reserved). */\n  private _preferredStrategy: PreferredStrategy = \"auto\";\n\n  /** Set if currentTime was assigned before the player was ready. */\n  private _pendingSeek: number | null = null;\n  /** Set if play() was called before the player was ready. */\n  private _pendingPlay = false;\n\n  // ── Construction & lifecycle ───────────────────────────────────────────\n\n  constructor() {\n    super();\n    const root = this.attachShadow({ mode: \"open\" });\n    this._videoEl = document.createElement(\"video\");\n    this._videoEl.setAttribute(\"part\", \"video\");\n    this._videoEl.style.cssText = \"width:100%;height:100%;display:block;background:#000;\";\n    this._videoEl.playsInline = true;\n    root.appendChild(this._videoEl);\n\n    // Forward the underlying <video>'s `progress` event so consumers can\n    // observe buffered-range updates without reaching into the shadow DOM.\n    // This works for native + remux (real video element with buffered\n    // ranges) and is a no-op for hybrid/fallback (canvas-rendered, no\n    // buffered ranges yet).\n    this._videoEl.addEventListener(\"progress\", () => {\n      if (this._destroyed) return;\n      this._dispatch(\"progress\", { buffered: this._videoEl.buffered });\n    });\n  }\n\n  connectedCallback(): void {\n    if (this._destroyed) return;\n    // Connection is the trigger for bootstrap. If we have a pending source\n    // (set before connect), kick off bootstrap now.\n    const source = this._activeSource();\n    if (source != null) {\n      void this._bootstrap(source);\n    }\n  }\n\n  disconnectedCallback(): void {\n    if (this._destroyed) return;\n    // Bump the bootstrap token so any in-flight async work is invalidated\n    // before we tear down. _teardown() also bumps but we want the bump to\n    // happen synchronously here so any awaited promise that resolves\n    // between `disconnect` and `_teardown` sees the new ID.\n    this._bootstrapId++;\n    void this._teardown();\n  }\n\n  attributeChangedCallback(name: string, _oldValue: string | null, newValue: string | null): void {\n    if (this._destroyed) return;\n    switch (name) {\n      case \"src\":\n        if (this._suppressSrcAttrCallback) break;\n        this._setSrcInternal(newValue);\n        break;\n      case \"autoplay\":\n      case \"muted\":\n      case \"loop\":\n        // Reflect onto the underlying <video> element.\n        if (newValue == null) this._videoEl.removeAttribute(name);\n        else this._videoEl.setAttribute(name, newValue);\n        break;\n      case \"preload\":\n        if (newValue == null) this._videoEl.removeAttribute(\"preload\");\n        else this._videoEl.setAttribute(\"preload\", newValue);\n        break;\n      case \"diagnostics\":\n        // Phase A: no UI. Property is observable for users via getDiagnostics().\n        break;\n      case \"preferstrategy\":\n        if (newValue && PREFERRED_STRATEGY_VALUES.has(newValue as PreferredStrategy)) {\n          this._preferredStrategy = newValue as PreferredStrategy;\n        } else {\n          this._preferredStrategy = \"auto\";\n        }\n        break;\n    }\n  }\n\n  // ── Source handling ────────────────────────────────────────────────────\n\n  /** Returns the currently-active source (src or source), whichever is set. */\n  private _activeSource(): MediaInput | null {\n    if (this._source != null) return this._source;\n    if (this._src != null) return this._src;\n    return null;\n  }\n\n  /** Internal src setter — separate from the property setter so the\n   * attributeChangedCallback can use it without re-entering reflection. */\n  private _setSrcInternal(value: string | null): void {\n    // Same-value reassignment: no-op (#11 in the lifecycle list).\n    if (value === this._src && this._source == null) return;\n    this._src = value;\n    this._source = null;\n    this._onSourceChanged();\n  }\n\n  /** Called whenever the active source changes (src or source). */\n  private _onSourceChanged(): void {\n    if (this._destroyed) return;\n    const source = this._activeSource();\n    if (source == null) {\n      // Null transition: tear down and stay idle.\n      this._bootstrapId++;\n      void this._teardown();\n      return;\n    }\n    // Only bootstrap if we're connected to the DOM.\n    if (this.isConnected) {\n      void this._bootstrap(source);\n    }\n  }\n\n  // ── Bootstrap (the only place a UnifiedPlayer is created) ──────────────\n\n  private async _bootstrap(source: MediaInput): Promise<void> {\n    if (this._destroyed) return;\n    const id = ++this._bootstrapId;\n\n    // Tear down any existing player before starting a new one. Pass the\n    // bootstrap id we just claimed so teardown doesn't bump it again\n    // (which would invalidate ourselves).\n    await this._teardown(id);\n    if (id !== this._bootstrapId || this._destroyed) return;\n\n    this._dispatch(\"loadstart\", {});\n\n    let player: UnifiedPlayer;\n    try {\n      player = await createPlayer({\n        source,\n        target: this._videoEl,\n      });\n    } catch (err) {\n      // Stale or destroyed — silently abandon.\n      if (id !== this._bootstrapId || this._destroyed) return;\n      this._dispatchError(err);\n      return;\n    }\n\n    // Race check: if anything happened during the await above, bail.\n    if (id !== this._bootstrapId || this._destroyed || !this.isConnected) {\n      try { await player.destroy(); } catch { /* ignore */ }\n      return;\n    }\n\n    this._player = player;\n\n    // Wire events. The unsubscribe handles are not stored individually\n    // because destroy() will tear down the whole session anyway.\n    player.on(\"strategy\", ({ strategy, reason }) => {\n      // strategy event fires on initial classification AND any escalation.\n      const cls = player.getDiagnostics().strategyClass;\n      this._strategy = strategy;\n      this._strategyClass = cls === \"pending\" ? null : cls;\n      this._dispatch(\"strategychange\", {\n        strategy,\n        strategyClass: this._strategyClass,\n        reason,\n        diagnostics: player.getDiagnostics(),\n      });\n    });\n\n    player.on(\"strategychange\", ({ from, to, reason, currentTime }) => {\n      this._dispatch(\"strategychange\", {\n        from,\n        strategy: to,\n        strategyClass: player.getDiagnostics().strategyClass === \"pending\" ? null : player.getDiagnostics().strategyClass,\n        reason,\n        currentTime,\n        diagnostics: player.getDiagnostics(),\n      });\n    });\n\n    player.on(\"tracks\", ({ video: _v, audio, subtitle }) => {\n      this._audioTracks = audio;\n      this._subtitleTracks = subtitle;\n      this._dispatch(\"trackschange\", {\n        audioTracks: audio,\n        subtitleTracks: subtitle,\n      });\n    });\n\n    player.on(\"error\", (err: Error) => {\n      this._dispatchError(err);\n    });\n\n    player.on(\"timeupdate\", ({ currentTime }) => {\n      this._dispatch(\"timeupdate\", { currentTime });\n    });\n\n    player.on(\"ended\", () => {\n      this._dispatch(\"ended\", {});\n    });\n\n    player.on(\"ready\", () => {\n      this._dispatch(\"ready\", { diagnostics: player.getDiagnostics() });\n      // Apply any pending seek that was set before the player existed.\n      if (this._pendingSeek != null) {\n        const t = this._pendingSeek;\n        this._pendingSeek = null;\n        void player.seek(t).catch(() => { /* ignore */ });\n      }\n      // Honor any pending play() that was queued before bootstrap finished.\n      if (this._pendingPlay) {\n        this._pendingPlay = false;\n        void player.play().catch(() => { /* ignore — autoplay may be blocked */ });\n      } else if (this.autoplay) {\n        void player.play().catch(() => { /* ignore */ });\n      }\n    });\n  }\n\n  /**\n   * Tear down the active player and reset runtime state. Idempotent.\n   * If `currentBootstrapId` is provided, the bootstrap counter is NOT\n   * incremented (used by `_bootstrap()` to avoid invalidating itself).\n   */\n  private async _teardown(currentBootstrapId?: number): Promise<void> {\n    if (currentBootstrapId == null) {\n      // External callers (disconnect, destroy, source change) should bump\n      // the counter so any in-flight bootstrap is invalidated. The internal\n      // _bootstrap() call passes its own ID and we skip the bump.\n      this._bootstrapId++;\n    }\n    const player = this._player;\n    this._player = null;\n    this._strategy = null;\n    this._strategyClass = null;\n    this._audioTracks = [];\n    this._subtitleTracks = [];\n    if (player) {\n      try { await player.destroy(); } catch { /* ignore */ }\n    }\n  }\n\n  // ── Public properties ──────────────────────────────────────────────────\n\n  get src(): string | null {\n    return this._src;\n  }\n\n  set src(value: string | null) {\n    if (value == null) {\n      this.removeAttribute(\"src\");\n    } else {\n      this.setAttribute(\"src\", value);\n    }\n    // attributeChangedCallback handles the rest.\n  }\n\n  get source(): MediaInput | null {\n    return this._source;\n  }\n\n  set source(value: MediaInput | null) {\n    // Same-value reassignment for rich values is identity-based.\n    if (value === this._source && this._src == null) return;\n    this._source = value;\n    if (value != null) {\n      // Setting source clears src. Suppress the attribute callback so\n      // removing the src attribute doesn't wipe the source we just set.\n      this._src = null;\n      if (this.hasAttribute(\"src\")) {\n        this._suppressSrcAttrCallback = true;\n        try {\n          this.removeAttribute(\"src\");\n        } finally {\n          this._suppressSrcAttrCallback = false;\n        }\n      }\n    }\n    this._onSourceChanged();\n  }\n\n  get autoplay(): boolean {\n    return this.hasAttribute(\"autoplay\");\n  }\n\n  set autoplay(value: boolean) {\n    if (value) this.setAttribute(\"autoplay\", \"\");\n    else this.removeAttribute(\"autoplay\");\n  }\n\n  get muted(): boolean {\n    return this.hasAttribute(\"muted\");\n  }\n\n  set muted(value: boolean) {\n    if (value) this.setAttribute(\"muted\", \"\");\n    else this.removeAttribute(\"muted\");\n  }\n\n  get loop(): boolean {\n    return this.hasAttribute(\"loop\");\n  }\n\n  set loop(value: boolean) {\n    if (value) this.setAttribute(\"loop\", \"\");\n    else this.removeAttribute(\"loop\");\n  }\n\n  get preload(): \"none\" | \"metadata\" | \"auto\" {\n    const v = this.getAttribute(\"preload\");\n    return v === \"none\" || v === \"metadata\" || v === \"auto\" ? v : \"auto\";\n  }\n\n  set preload(value: \"none\" | \"metadata\" | \"auto\") {\n    this.setAttribute(\"preload\", value);\n  }\n\n  get diagnostics(): boolean {\n    return this.hasAttribute(\"diagnostics\");\n  }\n\n  set diagnostics(value: boolean) {\n    if (value) this.setAttribute(\"diagnostics\", \"\");\n    else this.removeAttribute(\"diagnostics\");\n  }\n\n  get preferredStrategy(): PreferredStrategy {\n    return this._preferredStrategy;\n  }\n\n  set preferredStrategy(value: PreferredStrategy) {\n    if (PREFERRED_STRATEGY_VALUES.has(value)) {\n      this.setAttribute(\"preferstrategy\", value);\n    }\n  }\n\n  get currentTime(): number {\n    return this._player?.getCurrentTime() ?? 0;\n  }\n\n  set currentTime(value: number) {\n    if (this._player) {\n      void this._player.seek(value).catch(() => { /* ignore */ });\n    } else {\n      // Defer to the next bootstrap. The `ready` handler applies it.\n      this._pendingSeek = value;\n    }\n  }\n\n  get duration(): number {\n    return this._player?.getDuration() ?? NaN;\n  }\n\n  get paused(): boolean {\n    return this._videoEl.paused;\n  }\n\n  get ended(): boolean {\n    return this._videoEl.ended;\n  }\n\n  get readyState(): number {\n    return this._videoEl.readyState;\n  }\n\n  /**\n   * Buffered time ranges for the active source. Mirrors the standard\n   * `<video>.buffered` `TimeRanges` API. For the native and remux strategies\n   * this reflects the underlying SourceBuffer / progressive download state.\n   * For the hybrid and fallback (canvas-rendered) strategies it currently\n   * returns an empty TimeRanges; v1.1 will synthesize a coarse range from\n   * the decoder's read position.\n   */\n  get buffered(): TimeRanges {\n    return this._videoEl.buffered;\n  }\n\n  get strategy(): StrategyName | null {\n    return this._strategy;\n  }\n\n  get strategyClass(): StrategyClass | null {\n    return this._strategyClass;\n  }\n\n  get player(): UnifiedPlayer | null {\n    return this._player;\n  }\n\n  get audioTracks(): AudioTrackInfo[] {\n    return this._audioTracks;\n  }\n\n  get subtitleTracks(): SubtitleTrackInfo[] {\n    return this._subtitleTracks;\n  }\n\n  // ── Public methods ─────────────────────────────────────────────────────\n\n  /** Force a (re-)bootstrap if a source is currently set. */\n  async load(): Promise<void> {\n    if (this._destroyed) return;\n    const source = this._activeSource();\n    if (source == null) return;\n    await this._bootstrap(source);\n  }\n\n  /**\n   * Begin or resume playback. If the player isn't ready yet, the call is\n   * queued and applied once `ready` fires.\n   */\n  async play(): Promise<void> {\n    if (this._destroyed) return;\n    if (this._player) {\n      await this._player.play();\n    } else {\n      this._pendingPlay = true;\n    }\n  }\n\n  pause(): void {\n    if (this._destroyed) return;\n    this._pendingPlay = false;\n    this._player?.pause();\n  }\n\n  /**\n   * Tear down the element permanently. After destroy(), the element ignores\n   * all method calls and attribute changes.\n   */\n  async destroy(): Promise<void> {\n    if (this._destroyed) return;\n    this._destroyed = true;\n    await this._teardown();\n    this._dispatch(\"destroy\", {});\n  }\n\n  async setAudioTrack(id: number): Promise<void> {\n    if (this._destroyed || !this._player) return;\n    await this._player.setAudioTrack(id);\n  }\n\n  async setSubtitleTrack(id: number | null): Promise<void> {\n    if (this._destroyed || !this._player) return;\n    await this._player.setSubtitleTrack(id);\n  }\n\n  getDiagnostics(): DiagnosticsSnapshot | null {\n    return this._player?.getDiagnostics() ?? null;\n  }\n\n  // ── Event helpers ──────────────────────────────────────────────────────\n\n  private _dispatch<T>(name: string, detail: T): void {\n    this.dispatchEvent(new CustomEvent(name, { detail, bubbles: false }));\n  }\n\n  private _dispatchError(err: unknown): void {\n    const error = err instanceof Error ? err : new Error(String(err));\n    this._dispatch(\"error\", { error, diagnostics: this._player?.getDiagnostics() ?? null });\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    \"avbridge-player\": AvbridgePlayerElement;\n  }\n}\n","/**\n * Subpath entry: `import \"avbridge/element\"` registers the\n * `<avbridge-player>` custom element.\n *\n * This is a separate entry point from the core (`avbridge`) so that consumers\n * who only want the engine don't pay for the element code, and consumers who\n * want both pay for the element code exactly once.\n *\n * The registration is guarded so re-importing this module (e.g. via HMR or\n * multiple bundles) does not throw a \"name already defined\" error.\n */\n\nimport { AvbridgePlayerElement } from \"./element/avbridge-player.js\";\n\nexport { AvbridgePlayerElement };\n\nif (typeof customElements !== \"undefined\" && !customElements.get(\"avbridge-player\")) {\n  customElements.define(\"avbridge-player\", AvbridgePlayerElement);\n}\n"]}
+{"version":3,"sources":["../src/element/avbridge-player.ts","../src/element.ts"],"names":["createPlayer"],"mappings":"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","file":"element.cjs","sourcesContent":["/**\n * `<avbridge-player>` — reference web component for the avbridge engine.\n *\n * This is a *thin* wrapper around `createPlayer()`. Its purpose is to:\n *\n *   1. Validate the public API by being a real consumer of it.\n *   2. Drive lifecycle correctness in the core via adversarial integration tests.\n *   3. Provide a drop-in player for users who don't want to wire `createPlayer()`\n *      themselves.\n *\n * It is **not** a player UI framework. See `docs/dev/WEB_COMPONENT_SPEC.md`\n * for the full spec, lifecycle invariants, and edge case list.\n *\n * Phase A scope (this file): lifecycle scaffold only — `src` / `source` /\n * `currentTime` / `play` / `pause` / `load` / `destroy` / events. No built-in\n * controls. Shadow DOM contains a single `<video part=\"video\">`.\n */\n\nimport { createPlayer, type UnifiedPlayer } from \"../player.js\";\nimport type {\n  MediaInput,\n  StrategyName,\n  StrategyClass,\n  AudioTrackInfo,\n  SubtitleTrackInfo,\n  DiagnosticsSnapshot,\n} from \"../types.js\";\n\n/** Strategy preference passed via the `preferstrategy` attribute. */\ntype PreferredStrategy = \"auto\" | StrategyName;\n\nconst PREFERRED_STRATEGY_VALUES = new Set<PreferredStrategy>([\n  \"auto\",\n  \"native\",\n  \"remux\",\n  \"hybrid\",\n  \"fallback\",\n]);\n\n/**\n * Standard `HTMLMediaElement` events we forward from the inner `<video>`\n * to the wrapper element so consumers can `el.addEventListener(\"loadedmetadata\", ...)`\n * exactly like they would with a real `<video>`. The element also dispatches\n * its own custom events (`strategychange`, `ready`, `error`, etc.) — those\n * are NOT in this list because they're avbridge-specific.\n *\n * Note: `progress` and `timeupdate` are deliberately NOT forwarded here.\n * `progress` is dispatched by the constructor with our own `{ buffered }`\n * detail. `timeupdate` is dispatched by the player layer (so it works for\n * canvas-rendered fallback playback too, where the inner <video> never\n * fires its own timeupdate).\n */\nconst FORWARDED_VIDEO_EVENTS = [\n  \"loadstart\",\n  \"loadedmetadata\",\n  \"loadeddata\",\n  \"canplay\",\n  \"canplaythrough\",\n  \"play\",\n  \"playing\",\n  \"pause\",\n  \"seeking\",\n  \"seeked\",\n  \"volumechange\",\n  \"ratechange\",\n  \"durationchange\",\n  \"waiting\",\n  \"stalled\",\n  \"emptied\",\n  \"resize\",\n  \"error\",\n] as const;\n\n/**\n * `HTMLElement` is a browser-only global. SSR frameworks (Next.js, Astro,\n * Remix, etc.) commonly import library modules on the server to extract\n * types or do tree-shaking, even if the user only ends up using them in\n * the browser. If we extended `HTMLElement` directly, the `class extends`\n * expression would be evaluated at module load time and crash in Node.\n *\n * The fix: in non-browser environments, fall back to an empty stub class.\n * The element is never *constructed* server-side (the registration in\n * `element.ts` is guarded by `typeof customElements !== \"undefined\"`), so\n * the stub is never instantiated — it just lets the class declaration\n * evaluate cleanly so the module can be imported anywhere.\n */\nconst HTMLElementCtor: typeof HTMLElement =\n  typeof HTMLElement !== \"undefined\"\n    ? HTMLElement\n    : (class {} as unknown as typeof HTMLElement);\n\n/**\n * Custom element. Lifecycle correctness is enforced via a monotonically\n * increasing `_bootstrapId`: every async bootstrap captures the ID at start\n * and discards itself if the ID has changed by the time it resolves. This\n * single pattern handles disconnect-during-bootstrap, rapid src reassignment,\n * bootstrap races, and destroy-during-bootstrap.\n */\nexport class AvbridgePlayerElement extends HTMLElementCtor {\n  static readonly observedAttributes = [\n    \"src\",\n    \"autoplay\",\n    \"muted\",\n    \"loop\",\n    \"preload\",\n    \"poster\",\n    \"playsinline\",\n    \"crossorigin\",\n    \"disableremoteplayback\",\n    \"diagnostics\",\n    \"preferstrategy\",\n  ];\n\n  // ── Internal state ─────────────────────────────────────────────────────\n\n  /** The shadow DOM `<video>` element that strategies render into. */\n  private _videoEl!: HTMLVideoElement;\n\n  /** Active player session, if any. Cleared on teardown. */\n  private _player: UnifiedPlayer | null = null;\n\n  /**\n   * Monotonic counter incremented on every (re)bootstrap. Async bootstrap\n   * work captures the current ID; if it doesn't match by the time the work\n   * resolves, the work is discarded.\n   */\n  private _bootstrapId = 0;\n\n  /** True after destroy() — element is permanently unusable. */\n  private _destroyed = false;\n\n  /** Internal source state. Either string-form (src) OR rich (source). */\n  private _src: string | null = null;\n  private _source: MediaInput | null = null;\n\n  /**\n   * Set when the `source` property setter is in the middle of clearing the\n   * `src` attribute as part of mutual exclusion. The attributeChangedCallback\n   * checks this flag and skips its normal \"clear source\" side effect, which\n   * would otherwise wipe the value we just set.\n   */\n  private _suppressSrcAttrCallback = false;\n\n  /** Last-known runtime state surfaced via getters. */\n  private _strategy: StrategyName | null = null;\n  private _strategyClass: StrategyClass | null = null;\n  private _audioTracks: AudioTrackInfo[] = [];\n  private _subtitleTracks: SubtitleTrackInfo[] = [];\n\n  /** Strategy preference (does not currently affect routing — reserved). */\n  private _preferredStrategy: PreferredStrategy = \"auto\";\n\n  /** Set if currentTime was assigned before the player was ready. */\n  private _pendingSeek: number | null = null;\n  /** Set if play() was called before the player was ready. */\n  private _pendingPlay = false;\n\n  /** MutationObserver tracking light-DOM `<track>` children. */\n  private _trackObserver: MutationObserver | null = null;\n\n  // ── Construction & lifecycle ───────────────────────────────────────────\n\n  constructor() {\n    super();\n    const root = this.attachShadow({ mode: \"open\" });\n    this._videoEl = document.createElement(\"video\");\n    this._videoEl.setAttribute(\"part\", \"video\");\n    this._videoEl.style.cssText = \"width:100%;height:100%;display:block;background:#000;\";\n    this._videoEl.playsInline = true;\n    root.appendChild(this._videoEl);\n\n    // Forward the underlying <video>'s `progress` event so consumers can\n    // observe buffered-range updates without reaching into the shadow DOM.\n    // This works for native + remux (real video element with buffered\n    // ranges) and is a no-op for hybrid/fallback (canvas-rendered, no\n    // buffered ranges yet).\n    this._videoEl.addEventListener(\"progress\", () => {\n      if (this._destroyed) return;\n      this._dispatch(\"progress\", { buffered: this._videoEl.buffered });\n    });\n\n    // Forward all standard HTMLMediaElement events from the inner <video>\n    // so consumers can use the element as a drop-in <video> replacement.\n    // Each event is re-dispatched on the wrapper element with no detail —\n    // listeners that need state should read it from the element directly.\n    for (const eventName of FORWARDED_VIDEO_EVENTS) {\n      this._videoEl.addEventListener(eventName, () => {\n        if (this._destroyed) return;\n        this.dispatchEvent(new Event(eventName, { bubbles: false }));\n      });\n    }\n  }\n\n  connectedCallback(): void {\n    if (this._destroyed) return;\n    // Pick up any <track> children that were declared in HTML before the\n    // element upgraded, and watch for future additions/removals.\n    this._syncTextTracks();\n    if (!this._trackObserver) {\n      this._trackObserver = new MutationObserver(() => this._syncTextTracks());\n      this._trackObserver.observe(this, { childList: true, subtree: false });\n    }\n    // Connection is the trigger for bootstrap. If we have a pending source\n    // (set before connect), kick off bootstrap now.\n    const source = this._activeSource();\n    if (source != null) {\n      void this._bootstrap(source);\n    }\n  }\n\n  disconnectedCallback(): void {\n    if (this._destroyed) return;\n    if (this._trackObserver) {\n      this._trackObserver.disconnect();\n      this._trackObserver = null;\n    }\n    // Bump the bootstrap token so any in-flight async work is invalidated\n    // before we tear down. _teardown() also bumps but we want the bump to\n    // happen synchronously here so any awaited promise that resolves\n    // between `disconnect` and `_teardown` sees the new ID.\n    this._bootstrapId++;\n    void this._teardown();\n  }\n\n  attributeChangedCallback(name: string, _oldValue: string | null, newValue: string | null): void {\n    if (this._destroyed) return;\n    switch (name) {\n      case \"src\":\n        if (this._suppressSrcAttrCallback) break;\n        this._setSrcInternal(newValue);\n        break;\n      case \"autoplay\":\n      case \"muted\":\n      case \"loop\":\n      case \"playsinline\":\n      case \"disableremoteplayback\":\n        // Reflect onto the underlying <video> element.\n        if (newValue == null) this._videoEl.removeAttribute(name);\n        else this._videoEl.setAttribute(name, newValue);\n        break;\n      case \"preload\":\n      case \"poster\":\n      case \"crossorigin\":\n        if (newValue == null) this._videoEl.removeAttribute(name);\n        else this._videoEl.setAttribute(name, newValue);\n        break;\n      case \"diagnostics\":\n        // Phase A: no UI. Property is observable for users via getDiagnostics().\n        break;\n      case \"preferstrategy\":\n        if (newValue && PREFERRED_STRATEGY_VALUES.has(newValue as PreferredStrategy)) {\n          this._preferredStrategy = newValue as PreferredStrategy;\n        } else {\n          this._preferredStrategy = \"auto\";\n        }\n        break;\n    }\n  }\n\n  // ── Source handling ────────────────────────────────────────────────────\n\n  /** Returns the currently-active source (src or source), whichever is set. */\n  private _activeSource(): MediaInput | null {\n    if (this._source != null) return this._source;\n    if (this._src != null) return this._src;\n    return null;\n  }\n\n  /**\n   * Mirror light-DOM `<track>` children into the shadow `<video>` so that\n   * the browser's native text-track machinery picks them up. Called on\n   * connect, on every mutation of light-DOM children, and once after each\n   * source change so newly-set tracks survive a fresh `<video>`.\n   *\n   * Strategy: clone the children. We don't move them because the user's\n   * code may still hold references to the originals (e.g. to set `default`).\n   * The shadow copies are throwaway — we wipe them on every sync.\n   */\n  private _syncTextTracks(): void {\n    // Remove existing shadow tracks.\n    const existing = this._videoEl.querySelectorAll(\"track\");\n    for (const t of Array.from(existing)) t.remove();\n    // Clone every <track> light-DOM child into the shadow video.\n    for (const child of Array.from(this.children)) {\n      if (child.tagName === \"TRACK\") {\n        const clone = child.cloneNode(true) as HTMLTrackElement;\n        this._videoEl.appendChild(clone);\n      }\n    }\n  }\n\n  /** Internal src setter — separate from the property setter so the\n   * attributeChangedCallback can use it without re-entering reflection. */\n  private _setSrcInternal(value: string | null): void {\n    // Same-value reassignment: no-op (#11 in the lifecycle list).\n    if (value === this._src && this._source == null) return;\n    this._src = value;\n    this._source = null;\n    this._onSourceChanged();\n  }\n\n  /** Called whenever the active source changes (src or source). */\n  private _onSourceChanged(): void {\n    if (this._destroyed) return;\n    const source = this._activeSource();\n    if (source == null) {\n      // Null transition: tear down and stay idle.\n      this._bootstrapId++;\n      void this._teardown();\n      return;\n    }\n    // Only bootstrap if we're connected to the DOM.\n    if (this.isConnected) {\n      void this._bootstrap(source);\n    }\n  }\n\n  // ── Bootstrap (the only place a UnifiedPlayer is created) ──────────────\n\n  private async _bootstrap(source: MediaInput): Promise<void> {\n    if (this._destroyed) return;\n    const id = ++this._bootstrapId;\n\n    // Tear down any existing player before starting a new one. Pass the\n    // bootstrap id we just claimed so teardown doesn't bump it again\n    // (which would invalidate ourselves).\n    await this._teardown(id);\n    if (id !== this._bootstrapId || this._destroyed) return;\n\n    this._dispatch(\"loadstart\", {});\n\n    let player: UnifiedPlayer;\n    try {\n      player = await createPlayer({\n        source,\n        target: this._videoEl,\n      });\n    } catch (err) {\n      // Stale or destroyed — silently abandon.\n      if (id !== this._bootstrapId || this._destroyed) return;\n      this._dispatchError(err);\n      return;\n    }\n\n    // Race check: if anything happened during the await above, bail.\n    if (id !== this._bootstrapId || this._destroyed || !this.isConnected) {\n      try { await player.destroy(); } catch { /* ignore */ }\n      return;\n    }\n\n    this._player = player;\n\n    // Resync any light-DOM <track> children into the (possibly fresh) shadow\n    // <video>. Strategies that swap or reset the inner video state would\n    // otherwise lose the tracks the user declared in HTML.\n    this._syncTextTracks();\n\n    // Wire events. The unsubscribe handles are not stored individually\n    // because destroy() will tear down the whole session anyway.\n    player.on(\"strategy\", ({ strategy, reason }) => {\n      // strategy event fires on initial classification AND any escalation.\n      const cls = player.getDiagnostics().strategyClass;\n      this._strategy = strategy;\n      this._strategyClass = cls === \"pending\" ? null : cls;\n      this._dispatch(\"strategychange\", {\n        strategy,\n        strategyClass: this._strategyClass,\n        reason,\n        diagnostics: player.getDiagnostics(),\n      });\n    });\n\n    player.on(\"strategychange\", ({ from, to, reason, currentTime }) => {\n      this._dispatch(\"strategychange\", {\n        from,\n        strategy: to,\n        strategyClass: player.getDiagnostics().strategyClass === \"pending\" ? null : player.getDiagnostics().strategyClass,\n        reason,\n        currentTime,\n        diagnostics: player.getDiagnostics(),\n      });\n    });\n\n    player.on(\"tracks\", ({ video: _v, audio, subtitle }) => {\n      this._audioTracks = audio;\n      this._subtitleTracks = subtitle;\n      this._dispatch(\"trackschange\", {\n        audioTracks: audio,\n        subtitleTracks: subtitle,\n      });\n    });\n\n    player.on(\"error\", (err: Error) => {\n      this._dispatchError(err);\n    });\n\n    player.on(\"timeupdate\", ({ currentTime }) => {\n      this._dispatch(\"timeupdate\", { currentTime });\n    });\n\n    player.on(\"ended\", () => {\n      this._dispatch(\"ended\", {});\n    });\n\n    player.on(\"ready\", () => {\n      this._dispatch(\"ready\", { diagnostics: player.getDiagnostics() });\n      // Apply any pending seek that was set before the player existed.\n      if (this._pendingSeek != null) {\n        const t = this._pendingSeek;\n        this._pendingSeek = null;\n        void player.seek(t).catch(() => { /* ignore */ });\n      }\n      // Honor any pending play() that was queued before bootstrap finished.\n      if (this._pendingPlay) {\n        this._pendingPlay = false;\n        void player.play().catch(() => { /* ignore — autoplay may be blocked */ });\n      } else if (this.autoplay) {\n        void player.play().catch(() => { /* ignore */ });\n      }\n    });\n  }\n\n  /**\n   * Tear down the active player and reset runtime state. Idempotent.\n   * If `currentBootstrapId` is provided, the bootstrap counter is NOT\n   * incremented (used by `_bootstrap()` to avoid invalidating itself).\n   */\n  private async _teardown(currentBootstrapId?: number): Promise<void> {\n    if (currentBootstrapId == null) {\n      // External callers (disconnect, destroy, source change) should bump\n      // the counter so any in-flight bootstrap is invalidated. The internal\n      // _bootstrap() call passes its own ID and we skip the bump.\n      this._bootstrapId++;\n    }\n    const player = this._player;\n    this._player = null;\n    this._strategy = null;\n    this._strategyClass = null;\n    this._audioTracks = [];\n    this._subtitleTracks = [];\n    if (player) {\n      try { await player.destroy(); } catch { /* ignore */ }\n    }\n  }\n\n  // ── Public properties ──────────────────────────────────────────────────\n\n  get src(): string | null {\n    return this._src;\n  }\n\n  set src(value: string | null) {\n    if (value == null) {\n      this.removeAttribute(\"src\");\n    } else {\n      this.setAttribute(\"src\", value);\n    }\n    // attributeChangedCallback handles the rest.\n  }\n\n  get source(): MediaInput | null {\n    return this._source;\n  }\n\n  set source(value: MediaInput | null) {\n    // Same-value reassignment for rich values is identity-based.\n    if (value === this._source && this._src == null) return;\n    this._source = value;\n    if (value != null) {\n      // Setting source clears src. Suppress the attribute callback so\n      // removing the src attribute doesn't wipe the source we just set.\n      this._src = null;\n      if (this.hasAttribute(\"src\")) {\n        this._suppressSrcAttrCallback = true;\n        try {\n          this.removeAttribute(\"src\");\n        } finally {\n          this._suppressSrcAttrCallback = false;\n        }\n      }\n    }\n    this._onSourceChanged();\n  }\n\n  get autoplay(): boolean {\n    return this.hasAttribute(\"autoplay\");\n  }\n\n  set autoplay(value: boolean) {\n    if (value) this.setAttribute(\"autoplay\", \"\");\n    else this.removeAttribute(\"autoplay\");\n  }\n\n  get muted(): boolean {\n    return this.hasAttribute(\"muted\");\n  }\n\n  set muted(value: boolean) {\n    if (value) this.setAttribute(\"muted\", \"\");\n    else this.removeAttribute(\"muted\");\n  }\n\n  get loop(): boolean {\n    return this.hasAttribute(\"loop\");\n  }\n\n  set loop(value: boolean) {\n    if (value) this.setAttribute(\"loop\", \"\");\n    else this.removeAttribute(\"loop\");\n  }\n\n  get preload(): \"none\" | \"metadata\" | \"auto\" {\n    const v = this.getAttribute(\"preload\");\n    return v === \"none\" || v === \"metadata\" || v === \"auto\" ? v : \"auto\";\n  }\n\n  set preload(value: \"none\" | \"metadata\" | \"auto\") {\n    this.setAttribute(\"preload\", value);\n  }\n\n  get diagnostics(): boolean {\n    return this.hasAttribute(\"diagnostics\");\n  }\n\n  set diagnostics(value: boolean) {\n    if (value) this.setAttribute(\"diagnostics\", \"\");\n    else this.removeAttribute(\"diagnostics\");\n  }\n\n  get preferredStrategy(): PreferredStrategy {\n    return this._preferredStrategy;\n  }\n\n  set preferredStrategy(value: PreferredStrategy) {\n    if (PREFERRED_STRATEGY_VALUES.has(value)) {\n      this.setAttribute(\"preferstrategy\", value);\n    }\n  }\n\n  get currentTime(): number {\n    return this._player?.getCurrentTime() ?? 0;\n  }\n\n  set currentTime(value: number) {\n    if (this._player) {\n      void this._player.seek(value).catch(() => { /* ignore */ });\n    } else {\n      // Defer to the next bootstrap. The `ready` handler applies it.\n      this._pendingSeek = value;\n    }\n  }\n\n  get duration(): number {\n    return this._player?.getDuration() ?? NaN;\n  }\n\n  get paused(): boolean {\n    return this._videoEl.paused;\n  }\n\n  get ended(): boolean {\n    return this._videoEl.ended;\n  }\n\n  get readyState(): number {\n    return this._videoEl.readyState;\n  }\n\n  /**\n   * Buffered time ranges for the active source. Mirrors the standard\n   * `<video>.buffered` `TimeRanges` API. For the native and remux strategies\n   * this reflects the underlying SourceBuffer / progressive download state.\n   * For the hybrid and fallback (canvas-rendered) strategies it currently\n   * returns an empty TimeRanges; a future release will synthesize a coarse\n   * range from the decoder's read position.\n   */\n  get buffered(): TimeRanges {\n    return this._videoEl.buffered;\n  }\n\n  // ── HTMLMediaElement parity ───────────────────────────────────────────\n  // Mirror the standard <video> surface so consumers can drop the element\n  // in as a <video> replacement. Each property is a thin passthrough to the\n  // shadow `<video>`.\n\n  get poster(): string {\n    return this._videoEl.poster;\n  }\n  set poster(value: string) {\n    if (value == null || value === \"\") this.removeAttribute(\"poster\");\n    else this.setAttribute(\"poster\", value);\n  }\n\n  get volume(): number {\n    return this._videoEl.volume;\n  }\n  set volume(value: number) {\n    this._videoEl.volume = value;\n  }\n\n  get playbackRate(): number {\n    return this._videoEl.playbackRate;\n  }\n  set playbackRate(value: number) {\n    this._videoEl.playbackRate = value;\n  }\n\n  get videoWidth(): number {\n    return this._videoEl.videoWidth;\n  }\n\n  get videoHeight(): number {\n    return this._videoEl.videoHeight;\n  }\n\n  get played(): TimeRanges {\n    return this._videoEl.played;\n  }\n\n  get seekable(): TimeRanges {\n    return this._videoEl.seekable;\n  }\n\n  get crossOrigin(): string | null {\n    return this._videoEl.crossOrigin;\n  }\n  set crossOrigin(value: string | null) {\n    if (value == null) this.removeAttribute(\"crossorigin\");\n    else this.setAttribute(\"crossorigin\", value);\n  }\n\n  get disableRemotePlayback(): boolean {\n    return this._videoEl.disableRemotePlayback;\n  }\n  set disableRemotePlayback(value: boolean) {\n    if (value) this.setAttribute(\"disableremoteplayback\", \"\");\n    else this.removeAttribute(\"disableremoteplayback\");\n  }\n\n  /**\n   * Native `HTMLMediaElement.canPlayType()` passthrough. Note that this\n   * answers about the *browser's* native support, not avbridge's full\n   * capabilities — avbridge can play many formats this method returns \"\"\n   * for, by routing them to the remux/hybrid/fallback strategies.\n   */\n  canPlayType(mimeType: string): CanPlayTypeResult {\n    return this._videoEl.canPlayType(mimeType);\n  }\n\n  /**\n   * **Escape hatch.** The underlying shadow-DOM `<video>` element.\n   *\n   * Use for native browser APIs the wrapper doesn't expose:\n   * - `el.videoElement.requestPictureInPicture()`\n   * - `el.videoElement.audioTracks` (browser native, not avbridge's track list)\n   * - direct integration with libraries that need a real HTMLVideoElement\n   *\n   * **Caveat:** When the active strategy is `\"fallback\"` or `\"hybrid\"`,\n   * frames are rendered to a canvas overlay, not into this `<video>`.\n   * APIs that depend on the actual pixels (Picture-in-Picture, captureStream)\n   * will not show the playing content in those modes. Check `el.strategy`\n   * before using such APIs.\n   */\n  get videoElement(): HTMLVideoElement {\n    return this._videoEl;\n  }\n\n  get strategy(): StrategyName | null {\n    return this._strategy;\n  }\n\n  get strategyClass(): StrategyClass | null {\n    return this._strategyClass;\n  }\n\n  get player(): UnifiedPlayer | null {\n    return this._player;\n  }\n\n  get audioTracks(): AudioTrackInfo[] {\n    return this._audioTracks;\n  }\n\n  get subtitleTracks(): SubtitleTrackInfo[] {\n    return this._subtitleTracks;\n  }\n\n  // ── Public methods ─────────────────────────────────────────────────────\n\n  /** Force a (re-)bootstrap if a source is currently set. */\n  async load(): Promise<void> {\n    if (this._destroyed) return;\n    const source = this._activeSource();\n    if (source == null) return;\n    await this._bootstrap(source);\n  }\n\n  /**\n   * Begin or resume playback. If the player isn't ready yet, the call is\n   * queued and applied once `ready` fires.\n   */\n  async play(): Promise<void> {\n    if (this._destroyed) return;\n    if (this._player) {\n      await this._player.play();\n    } else {\n      this._pendingPlay = true;\n    }\n  }\n\n  pause(): void {\n    if (this._destroyed) return;\n    this._pendingPlay = false;\n    this._player?.pause();\n  }\n\n  /**\n   * Tear down the element permanently. After destroy(), the element ignores\n   * all method calls and attribute changes.\n   */\n  async destroy(): Promise<void> {\n    if (this._destroyed) return;\n    this._destroyed = true;\n    await this._teardown();\n    this._dispatch(\"destroy\", {});\n  }\n\n  async setAudioTrack(id: number): Promise<void> {\n    if (this._destroyed || !this._player) return;\n    await this._player.setAudioTrack(id);\n  }\n\n  async setSubtitleTrack(id: number | null): Promise<void> {\n    if (this._destroyed || !this._player) return;\n    await this._player.setSubtitleTrack(id);\n  }\n\n  getDiagnostics(): DiagnosticsSnapshot | null {\n    return this._player?.getDiagnostics() ?? null;\n  }\n\n  // ── Event helpers ──────────────────────────────────────────────────────\n\n  private _dispatch<T>(name: string, detail: T): void {\n    this.dispatchEvent(new CustomEvent(name, { detail, bubbles: false }));\n  }\n\n  private _dispatchError(err: unknown): void {\n    const error = err instanceof Error ? err : new Error(String(err));\n    this._dispatch(\"error\", { error, diagnostics: this._player?.getDiagnostics() ?? null });\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    \"avbridge-player\": AvbridgePlayerElement;\n  }\n}\n","/**\n * Subpath entry: `import \"avbridge/element\"` registers the\n * `<avbridge-player>` custom element.\n *\n * This is a separate entry point from the core (`avbridge`) so that consumers\n * who only want the engine don't pay for the element code, and consumers who\n * want both pay for the element code exactly once.\n *\n * The registration is guarded so re-importing this module (e.g. via HMR or\n * multiple bundles) does not throw a \"name already defined\" error.\n */\n\nimport { AvbridgePlayerElement } from \"./element/avbridge-player.js\";\n\nexport { AvbridgePlayerElement };\n\nif (typeof customElements !== \"undefined\" && !customElements.get(\"avbridge-player\")) {\n  customElements.define(\"avbridge-player\", AvbridgePlayerElement);\n}\n"]}

package/dist/element.d.cts

@@ -76,12 +76,25 @@ declare class AvbridgePlayerElement extends HTMLElementCtor {
     private _pendingSeek;
     /** Set if play() was called before the player was ready. */
     private _pendingPlay;
+    /** MutationObserver tracking light-DOM `<track>` children. */
+    private _trackObserver;
     constructor();
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, _oldValue: string | null, newValue: string | null): void;
     /** Returns the currently-active source (src or source), whichever is set. */
     private _activeSource;
+    /**
+     * Mirror light-DOM `<track>` children into the shadow `<video>` so that
+     * the browser's native text-track machinery picks them up. Called on
+     * connect, on every mutation of light-DOM children, and once after each
+     * source change so newly-set tracks survive a fresh `<video>`.
+     *
+     * Strategy: clone the children. We don't move them because the user's
+     * code may still hold references to the originals (e.g. to set `default`).
+     * The shadow copies are throwaway — we wipe them on every sync.
+     */
+    private _syncTextTracks;
     /** Internal src setter — separate from the property setter so the
      * attributeChangedCallback can use it without re-entering reflection. */
     private _setSrcInternal;
@@ -121,10 +134,46 @@ declare class AvbridgePlayerElement extends HTMLElementCtor {
      * `<video>.buffered` `TimeRanges` API. For the native and remux strategies
      * this reflects the underlying SourceBuffer / progressive download state.
      * For the hybrid and fallback (canvas-rendered) strategies it currently
-     * returns an empty TimeRanges; v1.1 will synthesize a coarse range from
-     * the decoder's read position.
+     * returns an empty TimeRanges; a future release will synthesize a coarse
+     * range from the decoder's read position.
      */
     get buffered(): TimeRanges;
+    get poster(): string;
+    set poster(value: string);
+    get volume(): number;
+    set volume(value: number);
+    get playbackRate(): number;
+    set playbackRate(value: number);
+    get videoWidth(): number;
+    get videoHeight(): number;
+    get played(): TimeRanges;
+    get seekable(): TimeRanges;
+    get crossOrigin(): string | null;
+    set crossOrigin(value: string | null);
+    get disableRemotePlayback(): boolean;
+    set disableRemotePlayback(value: boolean);
+    /**
+     * Native `HTMLMediaElement.canPlayType()` passthrough. Note that this
+     * answers about the *browser's* native support, not avbridge's full
+     * capabilities — avbridge can play many formats this method returns ""
+     * for, by routing them to the remux/hybrid/fallback strategies.
+     */
+    canPlayType(mimeType: string): CanPlayTypeResult;
+    /**
+     * **Escape hatch.** The underlying shadow-DOM `<video>` element.
+     *
+     * Use for native browser APIs the wrapper doesn't expose:
+     * - `el.videoElement.requestPictureInPicture()`
+     * - `el.videoElement.audioTracks` (browser native, not avbridge's track list)
+     * - direct integration with libraries that need a real HTMLVideoElement
+     *
+     * **Caveat:** When the active strategy is `"fallback"` or `"hybrid"`,
+     * frames are rendered to a canvas overlay, not into this `<video>`.
+     * APIs that depend on the actual pixels (Picture-in-Picture, captureStream)
+     * will not show the playing content in those modes. Check `el.strategy`
+     * before using such APIs.
+     */
+    get videoElement(): HTMLVideoElement;
     get strategy(): StrategyName | null;
     get strategyClass(): StrategyClass | null;
     get player(): UnifiedPlayer | null;

package/dist/element.d.ts

@@ -76,12 +76,25 @@ declare class AvbridgePlayerElement extends HTMLElementCtor {
     private _pendingSeek;
     /** Set if play() was called before the player was ready. */
     private _pendingPlay;
+    /** MutationObserver tracking light-DOM `<track>` children. */
+    private _trackObserver;
     constructor();
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, _oldValue: string | null, newValue: string | null): void;
     /** Returns the currently-active source (src or source), whichever is set. */
     private _activeSource;
+    /**
+     * Mirror light-DOM `<track>` children into the shadow `<video>` so that
+     * the browser's native text-track machinery picks them up. Called on
+     * connect, on every mutation of light-DOM children, and once after each
+     * source change so newly-set tracks survive a fresh `<video>`.
+     *
+     * Strategy: clone the children. We don't move them because the user's
+     * code may still hold references to the originals (e.g. to set `default`).
+     * The shadow copies are throwaway — we wipe them on every sync.
+     */
+    private _syncTextTracks;
     /** Internal src setter — separate from the property setter so the
      * attributeChangedCallback can use it without re-entering reflection. */
     private _setSrcInternal;
@@ -121,10 +134,46 @@ declare class AvbridgePlayerElement extends HTMLElementCtor {
      * `<video>.buffered` `TimeRanges` API. For the native and remux strategies
      * this reflects the underlying SourceBuffer / progressive download state.
      * For the hybrid and fallback (canvas-rendered) strategies it currently
-     * returns an empty TimeRanges; v1.1 will synthesize a coarse range from
-     * the decoder's read position.
+     * returns an empty TimeRanges; a future release will synthesize a coarse
+     * range from the decoder's read position.
      */
     get buffered(): TimeRanges;
+    get poster(): string;
+    set poster(value: string);
+    get volume(): number;
+    set volume(value: number);
+    get playbackRate(): number;
+    set playbackRate(value: number);
+    get videoWidth(): number;
+    get videoHeight(): number;
+    get played(): TimeRanges;
+    get seekable(): TimeRanges;
+    get crossOrigin(): string | null;
+    set crossOrigin(value: string | null);
+    get disableRemotePlayback(): boolean;
+    set disableRemotePlayback(value: boolean);
+    /**
+     * Native `HTMLMediaElement.canPlayType()` passthrough. Note that this
+     * answers about the *browser's* native support, not avbridge's full
+     * capabilities — avbridge can play many formats this method returns ""
+     * for, by routing them to the remux/hybrid/fallback strategies.
+     */
+    canPlayType(mimeType: string): CanPlayTypeResult;
+    /**
+     * **Escape hatch.** The underlying shadow-DOM `<video>` element.
+     *
+     * Use for native browser APIs the wrapper doesn't expose:
+     * - `el.videoElement.requestPictureInPicture()`
+     * - `el.videoElement.audioTracks` (browser native, not avbridge's track list)
+     * - direct integration with libraries that need a real HTMLVideoElement
+     *
+     * **Caveat:** When the active strategy is `"fallback"` or `"hybrid"`,
+     * frames are rendered to a canvas overlay, not into this `<video>`.
+     * APIs that depend on the actual pixels (Picture-in-Picture, captureStream)
+     * will not show the playing content in those modes. Check `el.strategy`
+     * before using such APIs.
+     */
+    get videoElement(): HTMLVideoElement;
     get strategy(): StrategyName | null;
     get strategyClass(): StrategyClass | null;
     get player(): UnifiedPlayer | null;

package/dist/element.js

@@ -11,6 +11,26 @@ var PREFERRED_STRATEGY_VALUES = /* @__PURE__ */ new Set([
   "hybrid",
   "fallback"
 ]);
+var FORWARDED_VIDEO_EVENTS = [
+  "loadstart",
+  "loadedmetadata",
+  "loadeddata",
+  "canplay",
+  "canplaythrough",
+  "play",
+  "playing",
+  "pause",
+  "seeking",
+  "seeked",
+  "volumechange",
+  "ratechange",
+  "durationchange",
+  "waiting",
+  "stalled",
+  "emptied",
+  "resize",
+  "error"
+];
 var HTMLElementCtor = typeof HTMLElement !== "undefined" ? HTMLElement : class {
 };
 var AvbridgePlayerElement = class extends HTMLElementCtor {
@@ -20,6 +40,10 @@ var AvbridgePlayerElement = class extends HTMLElementCtor {
     "muted",
     "loop",
     "preload",
+    "poster",
+    "playsinline",
+    "crossorigin",
+    "disableremoteplayback",
     "diagnostics",
     "preferstrategy"
   ];
@@ -57,6 +81,8 @@ var AvbridgePlayerElement = class extends HTMLElementCtor {
   _pendingSeek = null;
   /** Set if play() was called before the player was ready. */
   _pendingPlay = false;
+  /** MutationObserver tracking light-DOM `<track>` children. */
+  _trackObserver = null;
   // ── Construction & lifecycle ───────────────────────────────────────────
   constructor() {
     super();
@@ -70,9 +96,20 @@ var AvbridgePlayerElement = class extends HTMLElementCtor {
       if (this._destroyed) return;
       this._dispatch("progress", { buffered: this._videoEl.buffered });
     });
+    for (const eventName of FORWARDED_VIDEO_EVENTS) {
+      this._videoEl.addEventListener(eventName, () => {
+        if (this._destroyed) return;
+        this.dispatchEvent(new Event(eventName, { bubbles: false }));
+      });
+    }
   }
   connectedCallback() {
     if (this._destroyed) return;
+    this._syncTextTracks();
+    if (!this._trackObserver) {
+      this._trackObserver = new MutationObserver(() => this._syncTextTracks());
+      this._trackObserver.observe(this, { childList: true, subtree: false });
+    }
     const source = this._activeSource();
     if (source != null) {
       void this._bootstrap(source);
@@ -80,6 +117,10 @@ var AvbridgePlayerElement = class extends HTMLElementCtor {
   }
   disconnectedCallback() {
     if (this._destroyed) return;
+    if (this._trackObserver) {
+      this._trackObserver.disconnect();
+      this._trackObserver = null;
+    }
     this._bootstrapId++;
     void this._teardown();
   }
@@ -93,12 +134,16 @@ var AvbridgePlayerElement = class extends HTMLElementCtor {
       case "autoplay":
       case "muted":
       case "loop":
+      case "playsinline":
+      case "disableremoteplayback":
         if (newValue == null) this._videoEl.removeAttribute(name);
         else this._videoEl.setAttribute(name, newValue);
         break;
       case "preload":
-        if (newValue == null) this._videoEl.removeAttribute("preload");
-        else this._videoEl.setAttribute("preload", newValue);
+      case "poster":
+      case "crossorigin":
+        if (newValue == null) this._videoEl.removeAttribute(name);
+        else this._videoEl.setAttribute(name, newValue);
         break;
       case "diagnostics":
         break;
@@ -118,6 +163,26 @@ var AvbridgePlayerElement = class extends HTMLElementCtor {
     if (this._src != null) return this._src;
     return null;
   }
+  /**
+   * Mirror light-DOM `<track>` children into the shadow `<video>` so that
+   * the browser's native text-track machinery picks them up. Called on
+   * connect, on every mutation of light-DOM children, and once after each
+   * source change so newly-set tracks survive a fresh `<video>`.
+   *
+   * Strategy: clone the children. We don't move them because the user's
+   * code may still hold references to the originals (e.g. to set `default`).
+   * The shadow copies are throwaway — we wipe them on every sync.
+   */
+  _syncTextTracks() {
+    const existing = this._videoEl.querySelectorAll("track");
+    for (const t of Array.from(existing)) t.remove();
+    for (const child of Array.from(this.children)) {
+      if (child.tagName === "TRACK") {
+        const clone = child.cloneNode(true);
+        this._videoEl.appendChild(clone);
+      }
+    }
+  }
   /** Internal src setter — separate from the property setter so the
    * attributeChangedCallback can use it without re-entering reflection. */
   _setSrcInternal(value) {
@@ -165,6 +230,7 @@ var AvbridgePlayerElement = class extends HTMLElementCtor {
       return;
     }
     this._player = player;
+    this._syncTextTracks();
     player.on("strategy", ({ strategy, reason }) => {
       const cls = player.getDiagnostics().strategyClass;
       this._strategy = strategy;
@@ -344,12 +410,87 @@ var AvbridgePlayerElement = class extends HTMLElementCtor {
    * `<video>.buffered` `TimeRanges` API. For the native and remux strategies
    * this reflects the underlying SourceBuffer / progressive download state.
    * For the hybrid and fallback (canvas-rendered) strategies it currently
-   * returns an empty TimeRanges; v1.1 will synthesize a coarse range from
-   * the decoder's read position.
+   * returns an empty TimeRanges; a future release will synthesize a coarse
+   * range from the decoder's read position.
    */
   get buffered() {
     return this._videoEl.buffered;
   }
+  // ── HTMLMediaElement parity ───────────────────────────────────────────
+  // Mirror the standard <video> surface so consumers can drop the element
+  // in as a <video> replacement. Each property is a thin passthrough to the
+  // shadow `<video>`.
+  get poster() {
+    return this._videoEl.poster;
+  }
+  set poster(value) {
+    if (value == null || value === "") this.removeAttribute("poster");
+    else this.setAttribute("poster", value);
+  }
+  get volume() {
+    return this._videoEl.volume;
+  }
+  set volume(value) {
+    this._videoEl.volume = value;
+  }
+  get playbackRate() {
+    return this._videoEl.playbackRate;
+  }
+  set playbackRate(value) {
+    this._videoEl.playbackRate = value;
+  }
+  get videoWidth() {
+    return this._videoEl.videoWidth;
+  }
+  get videoHeight() {
+    return this._videoEl.videoHeight;
+  }
+  get played() {
+    return this._videoEl.played;
+  }
+  get seekable() {
+    return this._videoEl.seekable;
+  }
+  get crossOrigin() {
+    return this._videoEl.crossOrigin;
+  }
+  set crossOrigin(value) {
+    if (value == null) this.removeAttribute("crossorigin");
+    else this.setAttribute("crossorigin", value);
+  }
+  get disableRemotePlayback() {
+    return this._videoEl.disableRemotePlayback;
+  }
+  set disableRemotePlayback(value) {
+    if (value) this.setAttribute("disableremoteplayback", "");
+    else this.removeAttribute("disableremoteplayback");
+  }
+  /**
+   * Native `HTMLMediaElement.canPlayType()` passthrough. Note that this
+   * answers about the *browser's* native support, not avbridge's full
+   * capabilities — avbridge can play many formats this method returns ""
+   * for, by routing them to the remux/hybrid/fallback strategies.
+   */
+  canPlayType(mimeType) {
+    return this._videoEl.canPlayType(mimeType);
+  }
+  /**
+   * **Escape hatch.** The underlying shadow-DOM `<video>` element.
+   *
+   * Use for native browser APIs the wrapper doesn't expose:
+   * - `el.videoElement.requestPictureInPicture()`
+   * - `el.videoElement.audioTracks` (browser native, not avbridge's track list)
+   * - direct integration with libraries that need a real HTMLVideoElement
+   *
+   * **Caveat:** When the active strategy is `"fallback"` or `"hybrid"`,
+   * frames are rendered to a canvas overlay, not into this `<video>`.
+   * APIs that depend on the actual pixels (Picture-in-Picture, captureStream)
+   * will not show the playing content in those modes. Check `el.strategy`
+   * before using such APIs.
+   */
+  get videoElement() {
+    return this._videoEl;
+  }
   get strategy() {
     return this._strategy;
   }

package/dist/element.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/element/avbridge-player.ts","../src/element.ts"],"names":[],"mappings":"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","file":"element.js","sourcesContent":["/**\n * `<avbridge-player>` — reference web component for the avbridge engine.\n *\n * This is a *thin* wrapper around `createPlayer()`. Its purpose is to:\n *\n *   1. Validate the public API by being a real consumer of it.\n *   2. Drive lifecycle correctness in the core via adversarial integration tests.\n *   3. Provide a drop-in player for users who don't want to wire `createPlayer()`\n *      themselves.\n *\n * It is **not** a player UI framework. See `docs/dev/WEB_COMPONENT_SPEC.md`\n * for the full spec, lifecycle invariants, and edge case list.\n *\n * Phase A scope (this file): lifecycle scaffold only — `src` / `source` /\n * `currentTime` / `play` / `pause` / `load` / `destroy` / events. No built-in\n * controls. Shadow DOM contains a single `<video part=\"video\">`.\n */\n\nimport { createPlayer, type UnifiedPlayer } from \"../player.js\";\nimport type {\n  MediaInput,\n  StrategyName,\n  StrategyClass,\n  AudioTrackInfo,\n  SubtitleTrackInfo,\n  DiagnosticsSnapshot,\n} from \"../types.js\";\n\n/** Strategy preference passed via the `preferstrategy` attribute. */\ntype PreferredStrategy = \"auto\" | StrategyName;\n\nconst PREFERRED_STRATEGY_VALUES = new Set<PreferredStrategy>([\n  \"auto\",\n  \"native\",\n  \"remux\",\n  \"hybrid\",\n  \"fallback\",\n]);\n\n/**\n * `HTMLElement` is a browser-only global. SSR frameworks (Next.js, Astro,\n * Remix, etc.) commonly import library modules on the server to extract\n * types or do tree-shaking, even if the user only ends up using them in\n * the browser. If we extended `HTMLElement` directly, the `class extends`\n * expression would be evaluated at module load time and crash in Node.\n *\n * The fix: in non-browser environments, fall back to an empty stub class.\n * The element is never *constructed* server-side (the registration in\n * `element.ts` is guarded by `typeof customElements !== \"undefined\"`), so\n * the stub is never instantiated — it just lets the class declaration\n * evaluate cleanly so the module can be imported anywhere.\n */\nconst HTMLElementCtor: typeof HTMLElement =\n  typeof HTMLElement !== \"undefined\"\n    ? HTMLElement\n    : (class {} as unknown as typeof HTMLElement);\n\n/**\n * Custom element. Lifecycle correctness is enforced via a monotonically\n * increasing `_bootstrapId`: every async bootstrap captures the ID at start\n * and discards itself if the ID has changed by the time it resolves. This\n * single pattern handles disconnect-during-bootstrap, rapid src reassignment,\n * bootstrap races, and destroy-during-bootstrap.\n */\nexport class AvbridgePlayerElement extends HTMLElementCtor {\n  static readonly observedAttributes = [\n    \"src\",\n    \"autoplay\",\n    \"muted\",\n    \"loop\",\n    \"preload\",\n    \"diagnostics\",\n    \"preferstrategy\",\n  ];\n\n  // ── Internal state ─────────────────────────────────────────────────────\n\n  /** The shadow DOM `<video>` element that strategies render into. */\n  private _videoEl!: HTMLVideoElement;\n\n  /** Active player session, if any. Cleared on teardown. */\n  private _player: UnifiedPlayer | null = null;\n\n  /**\n   * Monotonic counter incremented on every (re)bootstrap. Async bootstrap\n   * work captures the current ID; if it doesn't match by the time the work\n   * resolves, the work is discarded.\n   */\n  private _bootstrapId = 0;\n\n  /** True after destroy() — element is permanently unusable. */\n  private _destroyed = false;\n\n  /** Internal source state. Either string-form (src) OR rich (source). */\n  private _src: string | null = null;\n  private _source: MediaInput | null = null;\n\n  /**\n   * Set when the `source` property setter is in the middle of clearing the\n   * `src` attribute as part of mutual exclusion. The attributeChangedCallback\n   * checks this flag and skips its normal \"clear source\" side effect, which\n   * would otherwise wipe the value we just set.\n   */\n  private _suppressSrcAttrCallback = false;\n\n  /** Last-known runtime state surfaced via getters. */\n  private _strategy: StrategyName | null = null;\n  private _strategyClass: StrategyClass | null = null;\n  private _audioTracks: AudioTrackInfo[] = [];\n  private _subtitleTracks: SubtitleTrackInfo[] = [];\n\n  /** Strategy preference (does not currently affect routing — reserved). */\n  private _preferredStrategy: PreferredStrategy = \"auto\";\n\n  /** Set if currentTime was assigned before the player was ready. */\n  private _pendingSeek: number | null = null;\n  /** Set if play() was called before the player was ready. */\n  private _pendingPlay = false;\n\n  // ── Construction & lifecycle ───────────────────────────────────────────\n\n  constructor() {\n    super();\n    const root = this.attachShadow({ mode: \"open\" });\n    this._videoEl = document.createElement(\"video\");\n    this._videoEl.setAttribute(\"part\", \"video\");\n    this._videoEl.style.cssText = \"width:100%;height:100%;display:block;background:#000;\";\n    this._videoEl.playsInline = true;\n    root.appendChild(this._videoEl);\n\n    // Forward the underlying <video>'s `progress` event so consumers can\n    // observe buffered-range updates without reaching into the shadow DOM.\n    // This works for native + remux (real video element with buffered\n    // ranges) and is a no-op for hybrid/fallback (canvas-rendered, no\n    // buffered ranges yet).\n    this._videoEl.addEventListener(\"progress\", () => {\n      if (this._destroyed) return;\n      this._dispatch(\"progress\", { buffered: this._videoEl.buffered });\n    });\n  }\n\n  connectedCallback(): void {\n    if (this._destroyed) return;\n    // Connection is the trigger for bootstrap. If we have a pending source\n    // (set before connect), kick off bootstrap now.\n    const source = this._activeSource();\n    if (source != null) {\n      void this._bootstrap(source);\n    }\n  }\n\n  disconnectedCallback(): void {\n    if (this._destroyed) return;\n    // Bump the bootstrap token so any in-flight async work is invalidated\n    // before we tear down. _teardown() also bumps but we want the bump to\n    // happen synchronously here so any awaited promise that resolves\n    // between `disconnect` and `_teardown` sees the new ID.\n    this._bootstrapId++;\n    void this._teardown();\n  }\n\n  attributeChangedCallback(name: string, _oldValue: string | null, newValue: string | null): void {\n    if (this._destroyed) return;\n    switch (name) {\n      case \"src\":\n        if (this._suppressSrcAttrCallback) break;\n        this._setSrcInternal(newValue);\n        break;\n      case \"autoplay\":\n      case \"muted\":\n      case \"loop\":\n        // Reflect onto the underlying <video> element.\n        if (newValue == null) this._videoEl.removeAttribute(name);\n        else this._videoEl.setAttribute(name, newValue);\n        break;\n      case \"preload\":\n        if (newValue == null) this._videoEl.removeAttribute(\"preload\");\n        else this._videoEl.setAttribute(\"preload\", newValue);\n        break;\n      case \"diagnostics\":\n        // Phase A: no UI. Property is observable for users via getDiagnostics().\n        break;\n      case \"preferstrategy\":\n        if (newValue && PREFERRED_STRATEGY_VALUES.has(newValue as PreferredStrategy)) {\n          this._preferredStrategy = newValue as PreferredStrategy;\n        } else {\n          this._preferredStrategy = \"auto\";\n        }\n        break;\n    }\n  }\n\n  // ── Source handling ────────────────────────────────────────────────────\n\n  /** Returns the currently-active source (src or source), whichever is set. */\n  private _activeSource(): MediaInput | null {\n    if (this._source != null) return this._source;\n    if (this._src != null) return this._src;\n    return null;\n  }\n\n  /** Internal src setter — separate from the property setter so the\n   * attributeChangedCallback can use it without re-entering reflection. */\n  private _setSrcInternal(value: string | null): void {\n    // Same-value reassignment: no-op (#11 in the lifecycle list).\n    if (value === this._src && this._source == null) return;\n    this._src = value;\n    this._source = null;\n    this._onSourceChanged();\n  }\n\n  /** Called whenever the active source changes (src or source). */\n  private _onSourceChanged(): void {\n    if (this._destroyed) return;\n    const source = this._activeSource();\n    if (source == null) {\n      // Null transition: tear down and stay idle.\n      this._bootstrapId++;\n      void this._teardown();\n      return;\n    }\n    // Only bootstrap if we're connected to the DOM.\n    if (this.isConnected) {\n      void this._bootstrap(source);\n    }\n  }\n\n  // ── Bootstrap (the only place a UnifiedPlayer is created) ──────────────\n\n  private async _bootstrap(source: MediaInput): Promise<void> {\n    if (this._destroyed) return;\n    const id = ++this._bootstrapId;\n\n    // Tear down any existing player before starting a new one. Pass the\n    // bootstrap id we just claimed so teardown doesn't bump it again\n    // (which would invalidate ourselves).\n    await this._teardown(id);\n    if (id !== this._bootstrapId || this._destroyed) return;\n\n    this._dispatch(\"loadstart\", {});\n\n    let player: UnifiedPlayer;\n    try {\n      player = await createPlayer({\n        source,\n        target: this._videoEl,\n      });\n    } catch (err) {\n      // Stale or destroyed — silently abandon.\n      if (id !== this._bootstrapId || this._destroyed) return;\n      this._dispatchError(err);\n      return;\n    }\n\n    // Race check: if anything happened during the await above, bail.\n    if (id !== this._bootstrapId || this._destroyed || !this.isConnected) {\n      try { await player.destroy(); } catch { /* ignore */ }\n      return;\n    }\n\n    this._player = player;\n\n    // Wire events. The unsubscribe handles are not stored individually\n    // because destroy() will tear down the whole session anyway.\n    player.on(\"strategy\", ({ strategy, reason }) => {\n      // strategy event fires on initial classification AND any escalation.\n      const cls = player.getDiagnostics().strategyClass;\n      this._strategy = strategy;\n      this._strategyClass = cls === \"pending\" ? null : cls;\n      this._dispatch(\"strategychange\", {\n        strategy,\n        strategyClass: this._strategyClass,\n        reason,\n        diagnostics: player.getDiagnostics(),\n      });\n    });\n\n    player.on(\"strategychange\", ({ from, to, reason, currentTime }) => {\n      this._dispatch(\"strategychange\", {\n        from,\n        strategy: to,\n        strategyClass: player.getDiagnostics().strategyClass === \"pending\" ? null : player.getDiagnostics().strategyClass,\n        reason,\n        currentTime,\n        diagnostics: player.getDiagnostics(),\n      });\n    });\n\n    player.on(\"tracks\", ({ video: _v, audio, subtitle }) => {\n      this._audioTracks = audio;\n      this._subtitleTracks = subtitle;\n      this._dispatch(\"trackschange\", {\n        audioTracks: audio,\n        subtitleTracks: subtitle,\n      });\n    });\n\n    player.on(\"error\", (err: Error) => {\n      this._dispatchError(err);\n    });\n\n    player.on(\"timeupdate\", ({ currentTime }) => {\n      this._dispatch(\"timeupdate\", { currentTime });\n    });\n\n    player.on(\"ended\", () => {\n      this._dispatch(\"ended\", {});\n    });\n\n    player.on(\"ready\", () => {\n      this._dispatch(\"ready\", { diagnostics: player.getDiagnostics() });\n      // Apply any pending seek that was set before the player existed.\n      if (this._pendingSeek != null) {\n        const t = this._pendingSeek;\n        this._pendingSeek = null;\n        void player.seek(t).catch(() => { /* ignore */ });\n      }\n      // Honor any pending play() that was queued before bootstrap finished.\n      if (this._pendingPlay) {\n        this._pendingPlay = false;\n        void player.play().catch(() => { /* ignore — autoplay may be blocked */ });\n      } else if (this.autoplay) {\n        void player.play().catch(() => { /* ignore */ });\n      }\n    });\n  }\n\n  /**\n   * Tear down the active player and reset runtime state. Idempotent.\n   * If `currentBootstrapId` is provided, the bootstrap counter is NOT\n   * incremented (used by `_bootstrap()` to avoid invalidating itself).\n   */\n  private async _teardown(currentBootstrapId?: number): Promise<void> {\n    if (currentBootstrapId == null) {\n      // External callers (disconnect, destroy, source change) should bump\n      // the counter so any in-flight bootstrap is invalidated. The internal\n      // _bootstrap() call passes its own ID and we skip the bump.\n      this._bootstrapId++;\n    }\n    const player = this._player;\n    this._player = null;\n    this._strategy = null;\n    this._strategyClass = null;\n    this._audioTracks = [];\n    this._subtitleTracks = [];\n    if (player) {\n      try { await player.destroy(); } catch { /* ignore */ }\n    }\n  }\n\n  // ── Public properties ──────────────────────────────────────────────────\n\n  get src(): string | null {\n    return this._src;\n  }\n\n  set src(value: string | null) {\n    if (value == null) {\n      this.removeAttribute(\"src\");\n    } else {\n      this.setAttribute(\"src\", value);\n    }\n    // attributeChangedCallback handles the rest.\n  }\n\n  get source(): MediaInput | null {\n    return this._source;\n  }\n\n  set source(value: MediaInput | null) {\n    // Same-value reassignment for rich values is identity-based.\n    if (value === this._source && this._src == null) return;\n    this._source = value;\n    if (value != null) {\n      // Setting source clears src. Suppress the attribute callback so\n      // removing the src attribute doesn't wipe the source we just set.\n      this._src = null;\n      if (this.hasAttribute(\"src\")) {\n        this._suppressSrcAttrCallback = true;\n        try {\n          this.removeAttribute(\"src\");\n        } finally {\n          this._suppressSrcAttrCallback = false;\n        }\n      }\n    }\n    this._onSourceChanged();\n  }\n\n  get autoplay(): boolean {\n    return this.hasAttribute(\"autoplay\");\n  }\n\n  set autoplay(value: boolean) {\n    if (value) this.setAttribute(\"autoplay\", \"\");\n    else this.removeAttribute(\"autoplay\");\n  }\n\n  get muted(): boolean {\n    return this.hasAttribute(\"muted\");\n  }\n\n  set muted(value: boolean) {\n    if (value) this.setAttribute(\"muted\", \"\");\n    else this.removeAttribute(\"muted\");\n  }\n\n  get loop(): boolean {\n    return this.hasAttribute(\"loop\");\n  }\n\n  set loop(value: boolean) {\n    if (value) this.setAttribute(\"loop\", \"\");\n    else this.removeAttribute(\"loop\");\n  }\n\n  get preload(): \"none\" | \"metadata\" | \"auto\" {\n    const v = this.getAttribute(\"preload\");\n    return v === \"none\" || v === \"metadata\" || v === \"auto\" ? v : \"auto\";\n  }\n\n  set preload(value: \"none\" | \"metadata\" | \"auto\") {\n    this.setAttribute(\"preload\", value);\n  }\n\n  get diagnostics(): boolean {\n    return this.hasAttribute(\"diagnostics\");\n  }\n\n  set diagnostics(value: boolean) {\n    if (value) this.setAttribute(\"diagnostics\", \"\");\n    else this.removeAttribute(\"diagnostics\");\n  }\n\n  get preferredStrategy(): PreferredStrategy {\n    return this._preferredStrategy;\n  }\n\n  set preferredStrategy(value: PreferredStrategy) {\n    if (PREFERRED_STRATEGY_VALUES.has(value)) {\n      this.setAttribute(\"preferstrategy\", value);\n    }\n  }\n\n  get currentTime(): number {\n    return this._player?.getCurrentTime() ?? 0;\n  }\n\n  set currentTime(value: number) {\n    if (this._player) {\n      void this._player.seek(value).catch(() => { /* ignore */ });\n    } else {\n      // Defer to the next bootstrap. The `ready` handler applies it.\n      this._pendingSeek = value;\n    }\n  }\n\n  get duration(): number {\n    return this._player?.getDuration() ?? NaN;\n  }\n\n  get paused(): boolean {\n    return this._videoEl.paused;\n  }\n\n  get ended(): boolean {\n    return this._videoEl.ended;\n  }\n\n  get readyState(): number {\n    return this._videoEl.readyState;\n  }\n\n  /**\n   * Buffered time ranges for the active source. Mirrors the standard\n   * `<video>.buffered` `TimeRanges` API. For the native and remux strategies\n   * this reflects the underlying SourceBuffer / progressive download state.\n   * For the hybrid and fallback (canvas-rendered) strategies it currently\n   * returns an empty TimeRanges; v1.1 will synthesize a coarse range from\n   * the decoder's read position.\n   */\n  get buffered(): TimeRanges {\n    return this._videoEl.buffered;\n  }\n\n  get strategy(): StrategyName | null {\n    return this._strategy;\n  }\n\n  get strategyClass(): StrategyClass | null {\n    return this._strategyClass;\n  }\n\n  get player(): UnifiedPlayer | null {\n    return this._player;\n  }\n\n  get audioTracks(): AudioTrackInfo[] {\n    return this._audioTracks;\n  }\n\n  get subtitleTracks(): SubtitleTrackInfo[] {\n    return this._subtitleTracks;\n  }\n\n  // ── Public methods ─────────────────────────────────────────────────────\n\n  /** Force a (re-)bootstrap if a source is currently set. */\n  async load(): Promise<void> {\n    if (this._destroyed) return;\n    const source = this._activeSource();\n    if (source == null) return;\n    await this._bootstrap(source);\n  }\n\n  /**\n   * Begin or resume playback. If the player isn't ready yet, the call is\n   * queued and applied once `ready` fires.\n   */\n  async play(): Promise<void> {\n    if (this._destroyed) return;\n    if (this._player) {\n      await this._player.play();\n    } else {\n      this._pendingPlay = true;\n    }\n  }\n\n  pause(): void {\n    if (this._destroyed) return;\n    this._pendingPlay = false;\n    this._player?.pause();\n  }\n\n  /**\n   * Tear down the element permanently. After destroy(), the element ignores\n   * all method calls and attribute changes.\n   */\n  async destroy(): Promise<void> {\n    if (this._destroyed) return;\n    this._destroyed = true;\n    await this._teardown();\n    this._dispatch(\"destroy\", {});\n  }\n\n  async setAudioTrack(id: number): Promise<void> {\n    if (this._destroyed || !this._player) return;\n    await this._player.setAudioTrack(id);\n  }\n\n  async setSubtitleTrack(id: number | null): Promise<void> {\n    if (this._destroyed || !this._player) return;\n    await this._player.setSubtitleTrack(id);\n  }\n\n  getDiagnostics(): DiagnosticsSnapshot | null {\n    return this._player?.getDiagnostics() ?? null;\n  }\n\n  // ── Event helpers ──────────────────────────────────────────────────────\n\n  private _dispatch<T>(name: string, detail: T): void {\n    this.dispatchEvent(new CustomEvent(name, { detail, bubbles: false }));\n  }\n\n  private _dispatchError(err: unknown): void {\n    const error = err instanceof Error ? err : new Error(String(err));\n    this._dispatch(\"error\", { error, diagnostics: this._player?.getDiagnostics() ?? null });\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    \"avbridge-player\": AvbridgePlayerElement;\n  }\n}\n","/**\n * Subpath entry: `import \"avbridge/element\"` registers the\n * `<avbridge-player>` custom element.\n *\n * This is a separate entry point from the core (`avbridge`) so that consumers\n * who only want the engine don't pay for the element code, and consumers who\n * want both pay for the element code exactly once.\n *\n * The registration is guarded so re-importing this module (e.g. via HMR or\n * multiple bundles) does not throw a \"name already defined\" error.\n */\n\nimport { AvbridgePlayerElement } from \"./element/avbridge-player.js\";\n\nexport { AvbridgePlayerElement };\n\nif (typeof customElements !== \"undefined\" && !customElements.get(\"avbridge-player\")) {\n  customElements.define(\"avbridge-player\", AvbridgePlayerElement);\n}\n"]}
+{"version":3,"sources":["../src/element/avbridge-player.ts","../src/element.ts"],"names":[],"mappings":";;;;;;AA+BA,IAAM,yBAAA,uBAAgC,GAAA,CAAuB;AAAA,EAC3D,MAAA;AAAA,EACA,QAAA;AAAA,EACA,OAAA;AAAA,EACA,QAAA;AAAA,EACA;AACF,CAAC,CAAA;AAeD,IAAM,sBAAA,GAAyB;AAAA,EAC7B,WAAA;AAAA,EACA,gBAAA;AAAA,EACA,YAAA;AAAA,EACA,SAAA;AAAA,EACA,gBAAA;AAAA,EACA,MAAA;AAAA,EACA,SAAA;AAAA,EACA,OAAA;AAAA,EACA,SAAA;AAAA,EACA,QAAA;AAAA,EACA,cAAA;AAAA,EACA,YAAA;AAAA,EACA,gBAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,QAAA;AAAA,EACA;AACF,CAAA;AAeA,IAAM,eAAA,GACJ,OAAO,WAAA,KAAgB,WAAA,GACnB,cACC,MAAM;AAAC,CAAA;AASP,IAAM,qBAAA,GAAN,cAAoC,eAAA,CAAgB;AAAA,EACzD,OAAgB,kBAAA,GAAqB;AAAA,IACnC,KAAA;AAAA,IACA,UAAA;AAAA,IACA,OAAA;AAAA,IACA,MAAA;AAAA,IACA,SAAA;AAAA,IACA,QAAA;AAAA,IACA,aAAA;AAAA,IACA,aAAA;AAAA,IACA,uBAAA;AAAA,IACA,aAAA;AAAA,IACA;AAAA,GACF;AAAA;AAAA;AAAA,EAKQ,QAAA;AAAA;AAAA,EAGA,OAAA,GAAgC,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOhC,YAAA,GAAe,CAAA;AAAA;AAAA,EAGf,UAAA,GAAa,KAAA;AAAA;AAAA,EAGb,IAAA,GAAsB,IAAA;AAAA,EACtB,OAAA,GAA6B,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ7B,wBAAA,GAA2B,KAAA;AAAA;AAAA,EAG3B,SAAA,GAAiC,IAAA;AAAA,EACjC,cAAA,GAAuC,IAAA;AAAA,EACvC,eAAiC,EAAC;AAAA,EAClC,kBAAuC,EAAC;AAAA;AAAA,EAGxC,kBAAA,GAAwC,MAAA;AAAA;AAAA,EAGxC,YAAA,GAA8B,IAAA;AAAA;AAAA,EAE9B,YAAA,GAAe,KAAA;AAAA;AAAA,EAGf,cAAA,GAA0C,IAAA;AAAA;AAAA,EAIlD,WAAA,GAAc;AACZ,IAAA,KAAA,EAAM;AACN,IAAA,MAAM,OAAO,IAAA,CAAK,YAAA,CAAa,EAAE,IAAA,EAAM,QAAQ,CAAA;AAC/C,IAAA,IAAA,CAAK,QAAA,GAAW,QAAA,CAAS,aAAA,CAAc,OAAO,CAAA;AAC9C,IAAA,IAAA,CAAK,QAAA,CAAS,YAAA,CAAa,MAAA,EAAQ,OAAO,CAAA;AAC1C,IAAA,IAAA,CAAK,QAAA,CAAS,MAAM,OAAA,GAAU,uDAAA;AAC9B,IAAA,IAAA,CAAK,SAAS,WAAA,GAAc,IAAA;AAC5B,IAAA,IAAA,CAAK,WAAA,CAAY,KAAK,QAAQ,CAAA;AAO9B,IAAA,IAAA,CAAK,QAAA,CAAS,gBAAA,CAAiB,UAAA,EAAY,MAAM;AAC/C,MAAA,IAAI,KAAK,UAAA,EAAY;AACrB,MAAA,IAAA,CAAK,UAAU,UAAA,EAAY,EAAE,UAAU,IAAA,CAAK,QAAA,CAAS,UAAU,CAAA;AAAA,IACjE,CAAC,CAAA;AAMD,IAAA,KAAA,MAAW,aAAa,sBAAA,EAAwB;AAC9C,MAAA,IAAA,CAAK,QAAA,CAAS,gBAAA,CAAiB,SAAA,EAAW,MAAM;AAC9C,QAAA,IAAI,KAAK,UAAA,EAAY;AACrB,QAAA,IAAA,CAAK,aAAA,CAAc,IAAI,KAAA,CAAM,SAAA,EAAW,EAAE,OAAA,EAAS,KAAA,EAAO,CAAC,CAAA;AAAA,MAC7D,CAAC,CAAA;AAAA,IACH;AAAA,EACF;AAAA,EAEA,iBAAA,GAA0B;AACxB,IAAA,IAAI,KAAK,UAAA,EAAY;AAGrB,IAAA,IAAA,CAAK,eAAA,EAAgB;AACrB,IAAA,IAAI,CAAC,KAAK,cAAA,EAAgB;AACxB,MAAA,IAAA,CAAK,iBAAiB,IAAI,gBAAA,CAAiB,MAAM,IAAA,CAAK,iBAAiB,CAAA;AACvE,MAAA,IAAA,CAAK,cAAA,CAAe,QAAQ,IAAA,EAAM,EAAE,WAAW,IAAA,EAAM,OAAA,EAAS,OAAO,CAAA;AAAA,IACvE;AAGA,IAAA,MAAM,MAAA,GAAS,KAAK,aAAA,EAAc;AAClC,IAAA,IAAI,UAAU,IAAA,EAAM;AAClB,MAAA,KAAK,IAAA,CAAK,WAAW,MAAM,CAAA;AAAA,IAC7B;AAAA,EACF;AAAA,EAEA,oBAAA,GAA6B;AAC3B,IAAA,IAAI,KAAK,UAAA,EAAY;AACrB,IAAA,IAAI,KAAK,cAAA,EAAgB;AACvB,MAAA,IAAA,CAAK,eAAe,UAAA,EAAW;AAC/B,MAAA,IAAA,CAAK,cAAA,GAAiB,IAAA;AAAA,IACxB;AAKA,IAAA,IAAA,CAAK,YAAA,EAAA;AACL,IAAA,KAAK,KAAK,SAAA,EAAU;AAAA,EACtB;AAAA,EAEA,wBAAA,CAAyB,IAAA,EAAc,SAAA,EAA0B,QAAA,EAA+B;AAC9F,IAAA,IAAI,KAAK,UAAA,EAAY;AACrB,IAAA,QAAQ,IAAA;AAAM,MACZ,KAAK,KAAA;AACH,QAAA,IAAI,KAAK,wBAAA,EAA0B;AACnC,QAAA,IAAA,CAAK,gBAAgB,QAAQ,CAAA;AAC7B,QAAA;AAAA,MACF,KAAK,UAAA;AAAA,MACL,KAAK,OAAA;AAAA,MACL,KAAK,MAAA;AAAA,MACL,KAAK,aAAA;AAAA,MACL,KAAK,uBAAA;AAEH,QAAA,IAAI,QAAA,IAAY,IAAA,EAAM,IAAA,CAAK,QAAA,CAAS,gBAAgB,IAAI,CAAA;AAAA,aACnD,IAAA,CAAK,QAAA,CAAS,YAAA,CAAa,IAAA,EAAM,QAAQ,CAAA;AAC9C,QAAA;AAAA,MACF,KAAK,SAAA;AAAA,MACL,KAAK,QAAA;AAAA,MACL,KAAK,aAAA;AACH,QAAA,IAAI,QAAA,IAAY,IAAA,EAAM,IAAA,CAAK,QAAA,CAAS,gBAAgB,IAAI,CAAA;AAAA,aACnD,IAAA,CAAK,QAAA,CAAS,YAAA,CAAa,IAAA,EAAM,QAAQ,CAAA;AAC9C,QAAA;AAAA,MACF,KAAK,aAAA;AAEH,QAAA;AAAA,MACF,KAAK,gBAAA;AACH,QAAA,IAAI,QAAA,IAAY,yBAAA,CAA0B,GAAA,CAAI,QAA6B,CAAA,EAAG;AAC5E,UAAA,IAAA,CAAK,kBAAA,GAAqB,QAAA;AAAA,QAC5B,CAAA,MAAO;AACL,UAAA,IAAA,CAAK,kBAAA,GAAqB,MAAA;AAAA,QAC5B;AACA,QAAA;AAAA;AACJ,EACF;AAAA;AAAA;AAAA,EAKQ,aAAA,GAAmC;AACzC,IAAA,IAAI,IAAA,CAAK,OAAA,IAAW,IAAA,EAAM,OAAO,IAAA,CAAK,OAAA;AACtC,IAAA,IAAI,IAAA,CAAK,IAAA,IAAQ,IAAA,EAAM,OAAO,IAAA,CAAK,IAAA;AACnC,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYQ,eAAA,GAAwB;AAE9B,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,QAAA,CAAS,gBAAA,CAAiB,OAAO,CAAA;AACvD,IAAA,KAAA,MAAW,KAAK,KAAA,CAAM,IAAA,CAAK,QAAQ,CAAA,IAAK,MAAA,EAAO;AAE/C,IAAA,KAAA,MAAW,KAAA,IAAS,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,QAAQ,CAAA,EAAG;AAC7C,MAAA,IAAI,KAAA,CAAM,YAAY,OAAA,EAAS;AAC7B,QAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,SAAA,CAAU,IAAI,CAAA;AAClC,QAAA,IAAA,CAAK,QAAA,CAAS,YAAY,KAAK,CAAA;AAAA,MACjC;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA,EAIQ,gBAAgB,KAAA,EAA4B;AAElD,IAAA,IAAI,KAAA,KAAU,IAAA,CAAK,IAAA,IAAQ,IAAA,CAAK,WAAW,IAAA,EAAM;AACjD,IAAA,IAAA,CAAK,IAAA,GAAO,KAAA;AACZ,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA;AACf,IAAA,IAAA,CAAK,gBAAA,EAAiB;AAAA,EACxB;AAAA;AAAA,EAGQ,gBAAA,GAAyB;AAC/B,IAAA,IAAI,KAAK,UAAA,EAAY;AACrB,IAAA,MAAM,MAAA,GAAS,KAAK,aAAA,EAAc;AAClC,IAAA,IAAI,UAAU,IAAA,EAAM;AAElB,MAAA,IAAA,CAAK,YAAA,EAAA;AACL,MAAA,KAAK,KAAK,SAAA,EAAU;AACpB,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,KAAK,WAAA,EAAa;AACpB,MAAA,KAAK,IAAA,CAAK,WAAW,MAAM,CAAA;AAAA,IAC7B;AAAA,EACF;AAAA;AAAA,EAIA,MAAc,WAAW,MAAA,EAAmC;AAC1D,IAAA,IAAI,KAAK,UAAA,EAAY;AACrB,IAAA,MAAM,EAAA,GAAK,EAAE,IAAA,CAAK,YAAA;AAKlB,IAAA,MAAM,IAAA,CAAK,UAAU,EAAE,CAAA;AACvB,IAAA,IAAI,EAAA,KAAO,IAAA,CAAK,YAAA,IAAgB,IAAA,CAAK,UAAA,EAAY;AAEjD,IAAA,IAAA,CAAK,SAAA,CAAU,WAAA,EAAa,EAAE,CAAA;AAE9B,IAAA,IAAI,MAAA;AACJ,IAAA,IAAI;AACF,MAAA,MAAA,GAAS,MAAM,YAAA,CAAa;AAAA,QAC1B,MAAA;AAAA,QACA,QAAQ,IAAA,CAAK;AAAA,OACd,CAAA;AAAA,IACH,SAAS,GAAA,EAAK;AAEZ,MAAA,IAAI,EAAA,KAAO,IAAA,CAAK,YAAA,IAAgB,IAAA,CAAK,UAAA,EAAY;AACjD,MAAA,IAAA,CAAK,eAAe,GAAG,CAAA;AACvB,MAAA;AAAA,IACF;AAGA,IAAA,IAAI,OAAO,IAAA,CAAK,YAAA,IAAgB,KAAK,UAAA,IAAc,CAAC,KAAK,WAAA,EAAa;AACpE,MAAA,IAAI;AAAE,QAAA,MAAM,OAAO,OAAA,EAAQ;AAAA,MAAG,CAAA,CAAA,MAAQ;AAAA,MAAe;AACrD,MAAA;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,OAAA,GAAU,MAAA;AAKf,IAAA,IAAA,CAAK,eAAA,EAAgB;AAIrB,IAAA,MAAA,CAAO,GAAG,UAAA,EAAY,CAAC,EAAE,QAAA,EAAU,QAAO,KAAM;AAE9C,MAAA,MAAM,GAAA,GAAM,MAAA,CAAO,cAAA,EAAe,CAAE,aAAA;AACpC,MAAA,IAAA,CAAK,SAAA,GAAY,QAAA;AACjB,MAAA,IAAA,CAAK,cAAA,GAAiB,GAAA,KAAQ,SAAA,GAAY,IAAA,GAAO,GAAA;AACjD,MAAA,IAAA,CAAK,UAAU,gBAAA,EAAkB;AAAA,QAC/B,QAAA;AAAA,QACA,eAAe,IAAA,CAAK,cAAA;AAAA,QACpB,MAAA;AAAA,QACA,WAAA,EAAa,OAAO,cAAA;AAAe,OACpC,CAAA;AAAA,IACH,CAAC,CAAA;AAED,IAAA,MAAA,CAAO,EAAA,CAAG,kBAAkB,CAAC,EAAE,MAAM,EAAA,EAAI,MAAA,EAAQ,aAAY,KAAM;AACjE,MAAA,IAAA,CAAK,UAAU,gBAAA,EAAkB;AAAA,QAC/B,IAAA;AAAA,QACA,QAAA,EAAU,EAAA;AAAA,QACV,aAAA,EAAe,OAAO,cAAA,EAAe,CAAE,kBAAkB,SAAA,GAAY,IAAA,GAAO,MAAA,CAAO,cAAA,EAAe,CAAE,aAAA;AAAA,QACpG,MAAA;AAAA,QACA,WAAA;AAAA,QACA,WAAA,EAAa,OAAO,cAAA;AAAe,OACpC,CAAA;AAAA,IACH,CAAC,CAAA;AAED,IAAA,MAAA,CAAO,EAAA,CAAG,UAAU,CAAC,EAAE,OAAO,EAAA,EAAI,KAAA,EAAO,UAAS,KAAM;AACtD,MAAA,IAAA,CAAK,YAAA,GAAe,KAAA;AACpB,MAAA,IAAA,CAAK,eAAA,GAAkB,QAAA;AACvB,MAAA,IAAA,CAAK,UAAU,cAAA,EAAgB;AAAA,QAC7B,WAAA,EAAa,KAAA;AAAA,QACb,cAAA,EAAgB;AAAA,OACjB,CAAA;AAAA,IACH,CAAC,CAAA;AAED,IAAA,MAAA,CAAO,EAAA,CAAG,OAAA,EAAS,CAAC,GAAA,KAAe;AACjC,MAAA,IAAA,CAAK,eAAe,GAAG,CAAA;AAAA,IACzB,CAAC,CAAA;AAED,IAAA,MAAA,CAAO,EAAA,CAAG,YAAA,EAAc,CAAC,EAAE,aAAY,KAAM;AAC3C,MAAA,IAAA,CAAK,SAAA,CAAU,YAAA,EAAc,EAAE,WAAA,EAAa,CAAA;AAAA,IAC9C,CAAC,CAAA;AAED,IAAA,MAAA,CAAO,EAAA,CAAG,SAAS,MAAM;AACvB,MAAA,IAAA,CAAK,SAAA,CAAU,OAAA,EAAS,EAAE,CAAA;AAAA,IAC5B,CAAC,CAAA;AAED,IAAA,MAAA,CAAO,EAAA,CAAG,SAAS,MAAM;AACvB,MAAA,IAAA,CAAK,UAAU,OAAA,EAAS,EAAE,aAAa,MAAA,CAAO,cAAA,IAAkB,CAAA;AAEhE,MAAA,IAAI,IAAA,CAAK,gBAAgB,IAAA,EAAM;AAC7B,QAAA,MAAM,IAAI,IAAA,CAAK,YAAA;AACf,QAAA,IAAA,CAAK,YAAA,GAAe,IAAA;AACpB,QAAA,KAAK,MAAA,CAAO,IAAA,CAAK,CAAC,CAAA,CAAE,MAAM,MAAM;AAAA,QAAe,CAAC,CAAA;AAAA,MAClD;AAEA,MAAA,IAAI,KAAK,YAAA,EAAc;AACrB,QAAA,IAAA,CAAK,YAAA,GAAe,KAAA;AACpB,QAAA,KAAK,MAAA,CAAO,IAAA,EAAK,CAAE,KAAA,CAAM,MAAM;AAAA,QAAyC,CAAC,CAAA;AAAA,MAC3E,CAAA,MAAA,IAAW,KAAK,QAAA,EAAU;AACxB,QAAA,KAAK,MAAA,CAAO,IAAA,EAAK,CAAE,KAAA,CAAM,MAAM;AAAA,QAAe,CAAC,CAAA;AAAA,MACjD;AAAA,IACF,CAAC,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAc,UAAU,kBAAA,EAA4C;AAClE,IAAA,IAAI,sBAAsB,IAAA,EAAM;AAI9B,MAAA,IAAA,CAAK,YAAA,EAAA;AAAA,IACP;AACA,IAAA,MAAM,SAAS,IAAA,CAAK,OAAA;AACpB,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA;AACf,IAAA,IAAA,CAAK,SAAA,GAAY,IAAA;AACjB,IAAA,IAAA,CAAK,cAAA,GAAiB,IAAA;AACtB,IAAA,IAAA,CAAK,eAAe,EAAC;AACrB,IAAA,IAAA,CAAK,kBAAkB,EAAC;AACxB,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,IAAI;AAAE,QAAA,MAAM,OAAO,OAAA,EAAQ;AAAA,MAAG,CAAA,CAAA,MAAQ;AAAA,MAAe;AAAA,IACvD;AAAA,EACF;AAAA;AAAA,EAIA,IAAI,GAAA,GAAqB;AACvB,IAAA,OAAO,IAAA,CAAK,IAAA;AAAA,EACd;AAAA,EAEA,IAAI,IAAI,KAAA,EAAsB;AAC5B,IAAA,IAAI,SAAS,IAAA,EAAM;AACjB,MAAA,IAAA,CAAK,gBAAgB,KAAK,CAAA;AAAA,IAC5B,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,YAAA,CAAa,OAAO,KAAK,CAAA;AAAA,IAChC;AAAA,EAEF;AAAA,EAEA,IAAI,MAAA,GAA4B;AAC9B,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA,EAEA,IAAI,OAAO,KAAA,EAA0B;AAEnC,IAAA,IAAI,KAAA,KAAU,IAAA,CAAK,OAAA,IAAW,IAAA,CAAK,QAAQ,IAAA,EAAM;AACjD,IAAA,IAAA,CAAK,OAAA,GAAU,KAAA;AACf,IAAA,IAAI,SAAS,IAAA,EAAM;AAGjB,MAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,MAAA,IAAI,IAAA,CAAK,YAAA,CAAa,KAAK,CAAA,EAAG;AAC5B,QAAA,IAAA,CAAK,wBAAA,GAA2B,IAAA;AAChC,QAAA,IAAI;AACF,UAAA,IAAA,CAAK,gBAAgB,KAAK,CAAA;AAAA,QAC5B,CAAA,SAAE;AACA,UAAA,IAAA,CAAK,wBAAA,GAA2B,KAAA;AAAA,QAClC;AAAA,MACF;AAAA,IACF;AACA,IAAA,IAAA,CAAK,gBAAA,EAAiB;AAAA,EACxB;AAAA,EAEA,IAAI,QAAA,GAAoB;AACtB,IAAA,OAAO,IAAA,CAAK,aAAa,UAAU,CAAA;AAAA,EACrC;AAAA,EAEA,IAAI,SAAS,KAAA,EAAgB;AAC3B,IAAA,IAAI,KAAA,EAAO,IAAA,CAAK,YAAA,CAAa,UAAA,EAAY,EAAE,CAAA;AAAA,SACtC,IAAA,CAAK,gBAAgB,UAAU,CAAA;AAAA,EACtC;AAAA,EAEA,IAAI,KAAA,GAAiB;AACnB,IAAA,OAAO,IAAA,CAAK,aAAa,OAAO,CAAA;AAAA,EAClC;AAAA,EAEA,IAAI,MAAM,KAAA,EAAgB;AACxB,IAAA,IAAI,KAAA,EAAO,IAAA,CAAK,YAAA,CAAa,OAAA,EAAS,EAAE,CAAA;AAAA,SACnC,IAAA,CAAK,gBAAgB,OAAO,CAAA;AAAA,EACnC;AAAA,EAEA,IAAI,IAAA,GAAgB;AAClB,IAAA,OAAO,IAAA,CAAK,aAAa,MAAM,CAAA;AAAA,EACjC;AAAA,EAEA,IAAI,KAAK,KAAA,EAAgB;AACvB,IAAA,IAAI,KAAA,EAAO,IAAA,CAAK,YAAA,CAAa,MAAA,EAAQ,EAAE,CAAA;AAAA,SAClC,IAAA,CAAK,gBAAgB,MAAM,CAAA;AAAA,EAClC;AAAA,EAEA,IAAI,OAAA,GAAwC;AAC1C,IAAA,MAAM,CAAA,GAAI,IAAA,CAAK,YAAA,CAAa,SAAS,CAAA;AACrC,IAAA,OAAO,MAAM,MAAA,IAAU,CAAA,KAAM,UAAA,IAAc,CAAA,KAAM,SAAS,CAAA,GAAI,MAAA;AAAA,EAChE;AAAA,EAEA,IAAI,QAAQ,KAAA,EAAqC;AAC/C,IAAA,IAAA,CAAK,YAAA,CAAa,WAAW,KAAK,CAAA;AAAA,EACpC;AAAA,EAEA,IAAI,WAAA,GAAuB;AACzB,IAAA,OAAO,IAAA,CAAK,aAAa,aAAa,CAAA;AAAA,EACxC;AAAA,EAEA,IAAI,YAAY,KAAA,EAAgB;AAC9B,IAAA,IAAI,KAAA,EAAO,IAAA,CAAK,YAAA,CAAa,aAAA,EAAe,EAAE,CAAA;AAAA,SACzC,IAAA,CAAK,gBAAgB,aAAa,CAAA;AAAA,EACzC;AAAA,EAEA,IAAI,iBAAA,GAAuC;AACzC,IAAA,OAAO,IAAA,CAAK,kBAAA;AAAA,EACd;AAAA,EAEA,IAAI,kBAAkB,KAAA,EAA0B;AAC9C,IAAA,IAAI,yBAAA,CAA0B,GAAA,CAAI,KAAK,CAAA,EAAG;AACxC,MAAA,IAAA,CAAK,YAAA,CAAa,kBAAkB,KAAK,CAAA;AAAA,IAC3C;AAAA,EACF;AAAA,EAEA,IAAI,WAAA,GAAsB;AACxB,IAAA,OAAO,IAAA,CAAK,OAAA,EAAS,cAAA,EAAe,IAAK,CAAA;AAAA,EAC3C;AAAA,EAEA,IAAI,YAAY,KAAA,EAAe;AAC7B,IAAA,IAAI,KAAK,OAAA,EAAS;AAChB,MAAA,KAAK,KAAK,OAAA,CAAQ,IAAA,CAAK,KAAK,CAAA,CAAE,MAAM,MAAM;AAAA,MAAe,CAAC,CAAA;AAAA,IAC5D,CAAA,MAAO;AAEL,MAAA,IAAA,CAAK,YAAA,GAAe,KAAA;AAAA,IACtB;AAAA,EACF;AAAA,EAEA,IAAI,QAAA,GAAmB;AACrB,IAAA,OAAO,IAAA,CAAK,OAAA,EAAS,WAAA,EAAY,IAAK,GAAA;AAAA,EACxC;AAAA,EAEA,IAAI,MAAA,GAAkB;AACpB,IAAA,OAAO,KAAK,QAAA,CAAS,MAAA;AAAA,EACvB;AAAA,EAEA,IAAI,KAAA,GAAiB;AACnB,IAAA,OAAO,KAAK,QAAA,CAAS,KAAA;AAAA,EACvB;AAAA,EAEA,IAAI,UAAA,GAAqB;AACvB,IAAA,OAAO,KAAK,QAAA,CAAS,UAAA;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,IAAI,QAAA,GAAuB;AACzB,IAAA,OAAO,KAAK,QAAA,CAAS,QAAA;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,IAAI,MAAA,GAAiB;AACnB,IAAA,OAAO,KAAK,QAAA,CAAS,MAAA;AAAA,EACvB;AAAA,EACA,IAAI,OAAO,KAAA,EAAe;AACxB,IAAA,IAAI,SAAS,IAAA,IAAQ,KAAA,KAAU,EAAA,EAAI,IAAA,CAAK,gBAAgB,QAAQ,CAAA;AAAA,SAC3D,IAAA,CAAK,YAAA,CAAa,QAAA,EAAU,KAAK,CAAA;AAAA,EACxC;AAAA,EAEA,IAAI,MAAA,GAAiB;AACnB,IAAA,OAAO,KAAK,QAAA,CAAS,MAAA;AAAA,EACvB;AAAA,EACA,IAAI,OAAO,KAAA,EAAe;AACxB,IAAA,IAAA,CAAK,SAAS,MAAA,GAAS,KAAA;AAAA,EACzB;AAAA,EAEA,IAAI,YAAA,GAAuB;AACzB,IAAA,OAAO,KAAK,QAAA,CAAS,YAAA;AAAA,EACvB;AAAA,EACA,IAAI,aAAa,KAAA,EAAe;AAC9B,IAAA,IAAA,CAAK,SAAS,YAAA,GAAe,KAAA;AAAA,EAC/B;AAAA,EAEA,IAAI,UAAA,GAAqB;AACvB,IAAA,OAAO,KAAK,QAAA,CAAS,UAAA;AAAA,EACvB;AAAA,EAEA,IAAI,WAAA,GAAsB;AACxB,IAAA,OAAO,KAAK,QAAA,CAAS,WAAA;AAAA,EACvB;AAAA,EAEA,IAAI,MAAA,GAAqB;AACvB,IAAA,OAAO,KAAK,QAAA,CAAS,MAAA;AAAA,EACvB;AAAA,EAEA,IAAI,QAAA,GAAuB;AACzB,IAAA,OAAO,KAAK,QAAA,CAAS,QAAA;AAAA,EACvB;AAAA,EAEA,IAAI,WAAA,GAA6B;AAC/B,IAAA,OAAO,KAAK,QAAA,CAAS,WAAA;AAAA,EACvB;AAAA,EACA,IAAI,YAAY,KAAA,EAAsB;AACpC,IAAA,IAAI,KAAA,IAAS,IAAA,EAAM,IAAA,CAAK,eAAA,CAAgB,aAAa,CAAA;AAAA,SAChD,IAAA,CAAK,YAAA,CAAa,aAAA,EAAe,KAAK,CAAA;AAAA,EAC7C;AAAA,EAEA,IAAI,qBAAA,GAAiC;AACnC,IAAA,OAAO,KAAK,QAAA,CAAS,qBAAA;AAAA,EACvB;AAAA,EACA,IAAI,sBAAsB,KAAA,EAAgB;AACxC,IAAA,IAAI,KAAA,EAAO,IAAA,CAAK,YAAA,CAAa,uBAAA,EAAyB,EAAE,CAAA;AAAA,SACnD,IAAA,CAAK,gBAAgB,uBAAuB,CAAA;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,YAAY,QAAA,EAAqC;AAC/C,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,WAAA,CAAY,QAAQ,CAAA;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,IAAI,YAAA,GAAiC;AACnC,IAAA,OAAO,IAAA,CAAK,QAAA;AAAA,EACd;AAAA,EAEA,IAAI,QAAA,GAAgC;AAClC,IAAA,OAAO,IAAA,CAAK,SAAA;AAAA,EACd;AAAA,EAEA,IAAI,aAAA,GAAsC;AACxC,IAAA,OAAO,IAAA,CAAK,cAAA;AAAA,EACd;AAAA,EAEA,IAAI,MAAA,GAA+B;AACjC,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA,EAEA,IAAI,WAAA,GAAgC;AAClC,IAAA,OAAO,IAAA,CAAK,YAAA;AAAA,EACd;AAAA,EAEA,IAAI,cAAA,GAAsC;AACxC,IAAA,OAAO,IAAA,CAAK,eAAA;AAAA,EACd;AAAA;AAAA;AAAA,EAKA,MAAM,IAAA,GAAsB;AAC1B,IAAA,IAAI,KAAK,UAAA,EAAY;AACrB,IAAA,MAAM,MAAA,GAAS,KAAK,aAAA,EAAc;AAClC,IAAA,IAAI,UAAU,IAAA,EAAM;AACpB,IAAA,MAAM,IAAA,CAAK,WAAW,MAAM,CAAA;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,IAAA,GAAsB;AAC1B,IAAA,IAAI,KAAK,UAAA,EAAY;AACrB,IAAA,IAAI,KAAK,OAAA,EAAS;AAChB,MAAA,MAAM,IAAA,CAAK,QAAQ,IAAA,EAAK;AAAA,IAC1B,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,YAAA,GAAe,IAAA;AAAA,IACtB;AAAA,EACF;AAAA,EAEA,KAAA,GAAc;AACZ,IAAA,IAAI,KAAK,UAAA,EAAY;AACrB,IAAA,IAAA,CAAK,YAAA,GAAe,KAAA;AACpB,IAAA,IAAA,CAAK,SAAS,KAAA,EAAM;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OAAA,GAAyB;AAC7B,IAAA,IAAI,KAAK,UAAA,EAAY;AACrB,IAAA,IAAA,CAAK,UAAA,GAAa,IAAA;AAClB,IAAA,MAAM,KAAK,SAAA,EAAU;AACrB,IAAA,IAAA,CAAK,SAAA,CAAU,SAAA,EAAW,EAAE,CAAA;AAAA,EAC9B;AAAA,EAEA,MAAM,cAAc,EAAA,EAA2B;AAC7C,IAAA,IAAI,IAAA,CAAK,UAAA,IAAc,CAAC,IAAA,CAAK,OAAA,EAAS;AACtC,IAAA,MAAM,IAAA,CAAK,OAAA,CAAQ,aAAA,CAAc,EAAE,CAAA;AAAA,EACrC;AAAA,EAEA,MAAM,iBAAiB,EAAA,EAAkC;AACvD,IAAA,IAAI,IAAA,CAAK,UAAA,IAAc,CAAC,IAAA,CAAK,OAAA,EAAS;AACtC,IAAA,MAAM,IAAA,CAAK,OAAA,CAAQ,gBAAA,CAAiB,EAAE,CAAA;AAAA,EACxC;AAAA,EAEA,cAAA,GAA6C;AAC3C,IAAA,OAAO,IAAA,CAAK,OAAA,EAAS,cAAA,EAAe,IAAK,IAAA;AAAA,EAC3C;AAAA;AAAA,EAIQ,SAAA,CAAa,MAAc,MAAA,EAAiB;AAClD,IAAA,IAAA,CAAK,aAAA,CAAc,IAAI,WAAA,CAAY,IAAA,EAAM,EAAE,MAAA,EAAQ,OAAA,EAAS,KAAA,EAAO,CAAC,CAAA;AAAA,EACtE;AAAA,EAEQ,eAAe,GAAA,EAAoB;AACzC,IAAA,MAAM,KAAA,GAAQ,eAAe,KAAA,GAAQ,GAAA,GAAM,IAAI,KAAA,CAAM,MAAA,CAAO,GAAG,CAAC,CAAA;AAChE,IAAA,IAAA,CAAK,SAAA,CAAU,OAAA,EAAS,EAAE,KAAA,EAAO,WAAA,EAAa,KAAK,OAAA,EAAS,cAAA,EAAe,IAAK,IAAA,EAAM,CAAA;AAAA,EACxF;AACF;;;AC/tBA,IAAI,OAAO,cAAA,KAAmB,WAAA,IAAe,CAAC,cAAA,CAAe,GAAA,CAAI,iBAAiB,CAAA,EAAG;AACnF,EAAA,cAAA,CAAe,MAAA,CAAO,mBAAmB,qBAAqB,CAAA;AAChE","file":"element.js","sourcesContent":["/**\n * `<avbridge-player>` — reference web component for the avbridge engine.\n *\n * This is a *thin* wrapper around `createPlayer()`. Its purpose is to:\n *\n *   1. Validate the public API by being a real consumer of it.\n *   2. Drive lifecycle correctness in the core via adversarial integration tests.\n *   3. Provide a drop-in player for users who don't want to wire `createPlayer()`\n *      themselves.\n *\n * It is **not** a player UI framework. See `docs/dev/WEB_COMPONENT_SPEC.md`\n * for the full spec, lifecycle invariants, and edge case list.\n *\n * Phase A scope (this file): lifecycle scaffold only — `src` / `source` /\n * `currentTime` / `play` / `pause` / `load` / `destroy` / events. No built-in\n * controls. Shadow DOM contains a single `<video part=\"video\">`.\n */\n\nimport { createPlayer, type UnifiedPlayer } from \"../player.js\";\nimport type {\n  MediaInput,\n  StrategyName,\n  StrategyClass,\n  AudioTrackInfo,\n  SubtitleTrackInfo,\n  DiagnosticsSnapshot,\n} from \"../types.js\";\n\n/** Strategy preference passed via the `preferstrategy` attribute. */\ntype PreferredStrategy = \"auto\" | StrategyName;\n\nconst PREFERRED_STRATEGY_VALUES = new Set<PreferredStrategy>([\n  \"auto\",\n  \"native\",\n  \"remux\",\n  \"hybrid\",\n  \"fallback\",\n]);\n\n/**\n * Standard `HTMLMediaElement` events we forward from the inner `<video>`\n * to the wrapper element so consumers can `el.addEventListener(\"loadedmetadata\", ...)`\n * exactly like they would with a real `<video>`. The element also dispatches\n * its own custom events (`strategychange`, `ready`, `error`, etc.) — those\n * are NOT in this list because they're avbridge-specific.\n *\n * Note: `progress` and `timeupdate` are deliberately NOT forwarded here.\n * `progress` is dispatched by the constructor with our own `{ buffered }`\n * detail. `timeupdate` is dispatched by the player layer (so it works for\n * canvas-rendered fallback playback too, where the inner <video> never\n * fires its own timeupdate).\n */\nconst FORWARDED_VIDEO_EVENTS = [\n  \"loadstart\",\n  \"loadedmetadata\",\n  \"loadeddata\",\n  \"canplay\",\n  \"canplaythrough\",\n  \"play\",\n  \"playing\",\n  \"pause\",\n  \"seeking\",\n  \"seeked\",\n  \"volumechange\",\n  \"ratechange\",\n  \"durationchange\",\n  \"waiting\",\n  \"stalled\",\n  \"emptied\",\n  \"resize\",\n  \"error\",\n] as const;\n\n/**\n * `HTMLElement` is a browser-only global. SSR frameworks (Next.js, Astro,\n * Remix, etc.) commonly import library modules on the server to extract\n * types or do tree-shaking, even if the user only ends up using them in\n * the browser. If we extended `HTMLElement` directly, the `class extends`\n * expression would be evaluated at module load time and crash in Node.\n *\n * The fix: in non-browser environments, fall back to an empty stub class.\n * The element is never *constructed* server-side (the registration in\n * `element.ts` is guarded by `typeof customElements !== \"undefined\"`), so\n * the stub is never instantiated — it just lets the class declaration\n * evaluate cleanly so the module can be imported anywhere.\n */\nconst HTMLElementCtor: typeof HTMLElement =\n  typeof HTMLElement !== \"undefined\"\n    ? HTMLElement\n    : (class {} as unknown as typeof HTMLElement);\n\n/**\n * Custom element. Lifecycle correctness is enforced via a monotonically\n * increasing `_bootstrapId`: every async bootstrap captures the ID at start\n * and discards itself if the ID has changed by the time it resolves. This\n * single pattern handles disconnect-during-bootstrap, rapid src reassignment,\n * bootstrap races, and destroy-during-bootstrap.\n */\nexport class AvbridgePlayerElement extends HTMLElementCtor {\n  static readonly observedAttributes = [\n    \"src\",\n    \"autoplay\",\n    \"muted\",\n    \"loop\",\n    \"preload\",\n    \"poster\",\n    \"playsinline\",\n    \"crossorigin\",\n    \"disableremoteplayback\",\n    \"diagnostics\",\n    \"preferstrategy\",\n  ];\n\n  // ── Internal state ─────────────────────────────────────────────────────\n\n  /** The shadow DOM `<video>` element that strategies render into. */\n  private _videoEl!: HTMLVideoElement;\n\n  /** Active player session, if any. Cleared on teardown. */\n  private _player: UnifiedPlayer | null = null;\n\n  /**\n   * Monotonic counter incremented on every (re)bootstrap. Async bootstrap\n   * work captures the current ID; if it doesn't match by the time the work\n   * resolves, the work is discarded.\n   */\n  private _bootstrapId = 0;\n\n  /** True after destroy() — element is permanently unusable. */\n  private _destroyed = false;\n\n  /** Internal source state. Either string-form (src) OR rich (source). */\n  private _src: string | null = null;\n  private _source: MediaInput | null = null;\n\n  /**\n   * Set when the `source` property setter is in the middle of clearing the\n   * `src` attribute as part of mutual exclusion. The attributeChangedCallback\n   * checks this flag and skips its normal \"clear source\" side effect, which\n   * would otherwise wipe the value we just set.\n   */\n  private _suppressSrcAttrCallback = false;\n\n  /** Last-known runtime state surfaced via getters. */\n  private _strategy: StrategyName | null = null;\n  private _strategyClass: StrategyClass | null = null;\n  private _audioTracks: AudioTrackInfo[] = [];\n  private _subtitleTracks: SubtitleTrackInfo[] = [];\n\n  /** Strategy preference (does not currently affect routing — reserved). */\n  private _preferredStrategy: PreferredStrategy = \"auto\";\n\n  /** Set if currentTime was assigned before the player was ready. */\n  private _pendingSeek: number | null = null;\n  /** Set if play() was called before the player was ready. */\n  private _pendingPlay = false;\n\n  /** MutationObserver tracking light-DOM `<track>` children. */\n  private _trackObserver: MutationObserver | null = null;\n\n  // ── Construction & lifecycle ───────────────────────────────────────────\n\n  constructor() {\n    super();\n    const root = this.attachShadow({ mode: \"open\" });\n    this._videoEl = document.createElement(\"video\");\n    this._videoEl.setAttribute(\"part\", \"video\");\n    this._videoEl.style.cssText = \"width:100%;height:100%;display:block;background:#000;\";\n    this._videoEl.playsInline = true;\n    root.appendChild(this._videoEl);\n\n    // Forward the underlying <video>'s `progress` event so consumers can\n    // observe buffered-range updates without reaching into the shadow DOM.\n    // This works for native + remux (real video element with buffered\n    // ranges) and is a no-op for hybrid/fallback (canvas-rendered, no\n    // buffered ranges yet).\n    this._videoEl.addEventListener(\"progress\", () => {\n      if (this._destroyed) return;\n      this._dispatch(\"progress\", { buffered: this._videoEl.buffered });\n    });\n\n    // Forward all standard HTMLMediaElement events from the inner <video>\n    // so consumers can use the element as a drop-in <video> replacement.\n    // Each event is re-dispatched on the wrapper element with no detail —\n    // listeners that need state should read it from the element directly.\n    for (const eventName of FORWARDED_VIDEO_EVENTS) {\n      this._videoEl.addEventListener(eventName, () => {\n        if (this._destroyed) return;\n        this.dispatchEvent(new Event(eventName, { bubbles: false }));\n      });\n    }\n  }\n\n  connectedCallback(): void {\n    if (this._destroyed) return;\n    // Pick up any <track> children that were declared in HTML before the\n    // element upgraded, and watch for future additions/removals.\n    this._syncTextTracks();\n    if (!this._trackObserver) {\n      this._trackObserver = new MutationObserver(() => this._syncTextTracks());\n      this._trackObserver.observe(this, { childList: true, subtree: false });\n    }\n    // Connection is the trigger for bootstrap. If we have a pending source\n    // (set before connect), kick off bootstrap now.\n    const source = this._activeSource();\n    if (source != null) {\n      void this._bootstrap(source);\n    }\n  }\n\n  disconnectedCallback(): void {\n    if (this._destroyed) return;\n    if (this._trackObserver) {\n      this._trackObserver.disconnect();\n      this._trackObserver = null;\n    }\n    // Bump the bootstrap token so any in-flight async work is invalidated\n    // before we tear down. _teardown() also bumps but we want the bump to\n    // happen synchronously here so any awaited promise that resolves\n    // between `disconnect` and `_teardown` sees the new ID.\n    this._bootstrapId++;\n    void this._teardown();\n  }\n\n  attributeChangedCallback(name: string, _oldValue: string | null, newValue: string | null): void {\n    if (this._destroyed) return;\n    switch (name) {\n      case \"src\":\n        if (this._suppressSrcAttrCallback) break;\n        this._setSrcInternal(newValue);\n        break;\n      case \"autoplay\":\n      case \"muted\":\n      case \"loop\":\n      case \"playsinline\":\n      case \"disableremoteplayback\":\n        // Reflect onto the underlying <video> element.\n        if (newValue == null) this._videoEl.removeAttribute(name);\n        else this._videoEl.setAttribute(name, newValue);\n        break;\n      case \"preload\":\n      case \"poster\":\n      case \"crossorigin\":\n        if (newValue == null) this._videoEl.removeAttribute(name);\n        else this._videoEl.setAttribute(name, newValue);\n        break;\n      case \"diagnostics\":\n        // Phase A: no UI. Property is observable for users via getDiagnostics().\n        break;\n      case \"preferstrategy\":\n        if (newValue && PREFERRED_STRATEGY_VALUES.has(newValue as PreferredStrategy)) {\n          this._preferredStrategy = newValue as PreferredStrategy;\n        } else {\n          this._preferredStrategy = \"auto\";\n        }\n        break;\n    }\n  }\n\n  // ── Source handling ────────────────────────────────────────────────────\n\n  /** Returns the currently-active source (src or source), whichever is set. */\n  private _activeSource(): MediaInput | null {\n    if (this._source != null) return this._source;\n    if (this._src != null) return this._src;\n    return null;\n  }\n\n  /**\n   * Mirror light-DOM `<track>` children into the shadow `<video>` so that\n   * the browser's native text-track machinery picks them up. Called on\n   * connect, on every mutation of light-DOM children, and once after each\n   * source change so newly-set tracks survive a fresh `<video>`.\n   *\n   * Strategy: clone the children. We don't move them because the user's\n   * code may still hold references to the originals (e.g. to set `default`).\n   * The shadow copies are throwaway — we wipe them on every sync.\n   */\n  private _syncTextTracks(): void {\n    // Remove existing shadow tracks.\n    const existing = this._videoEl.querySelectorAll(\"track\");\n    for (const t of Array.from(existing)) t.remove();\n    // Clone every <track> light-DOM child into the shadow video.\n    for (const child of Array.from(this.children)) {\n      if (child.tagName === \"TRACK\") {\n        const clone = child.cloneNode(true) as HTMLTrackElement;\n        this._videoEl.appendChild(clone);\n      }\n    }\n  }\n\n  /** Internal src setter — separate from the property setter so the\n   * attributeChangedCallback can use it without re-entering reflection. */\n  private _setSrcInternal(value: string | null): void {\n    // Same-value reassignment: no-op (#11 in the lifecycle list).\n    if (value === this._src && this._source == null) return;\n    this._src = value;\n    this._source = null;\n    this._onSourceChanged();\n  }\n\n  /** Called whenever the active source changes (src or source). */\n  private _onSourceChanged(): void {\n    if (this._destroyed) return;\n    const source = this._activeSource();\n    if (source == null) {\n      // Null transition: tear down and stay idle.\n      this._bootstrapId++;\n      void this._teardown();\n      return;\n    }\n    // Only bootstrap if we're connected to the DOM.\n    if (this.isConnected) {\n      void this._bootstrap(source);\n    }\n  }\n\n  // ── Bootstrap (the only place a UnifiedPlayer is created) ──────────────\n\n  private async _bootstrap(source: MediaInput): Promise<void> {\n    if (this._destroyed) return;\n    const id = ++this._bootstrapId;\n\n    // Tear down any existing player before starting a new one. Pass the\n    // bootstrap id we just claimed so teardown doesn't bump it again\n    // (which would invalidate ourselves).\n    await this._teardown(id);\n    if (id !== this._bootstrapId || this._destroyed) return;\n\n    this._dispatch(\"loadstart\", {});\n\n    let player: UnifiedPlayer;\n    try {\n      player = await createPlayer({\n        source,\n        target: this._videoEl,\n      });\n    } catch (err) {\n      // Stale or destroyed — silently abandon.\n      if (id !== this._bootstrapId || this._destroyed) return;\n      this._dispatchError(err);\n      return;\n    }\n\n    // Race check: if anything happened during the await above, bail.\n    if (id !== this._bootstrapId || this._destroyed || !this.isConnected) {\n      try { await player.destroy(); } catch { /* ignore */ }\n      return;\n    }\n\n    this._player = player;\n\n    // Resync any light-DOM <track> children into the (possibly fresh) shadow\n    // <video>. Strategies that swap or reset the inner video state would\n    // otherwise lose the tracks the user declared in HTML.\n    this._syncTextTracks();\n\n    // Wire events. The unsubscribe handles are not stored individually\n    // because destroy() will tear down the whole session anyway.\n    player.on(\"strategy\", ({ strategy, reason }) => {\n      // strategy event fires on initial classification AND any escalation.\n      const cls = player.getDiagnostics().strategyClass;\n      this._strategy = strategy;\n      this._strategyClass = cls === \"pending\" ? null : cls;\n      this._dispatch(\"strategychange\", {\n        strategy,\n        strategyClass: this._strategyClass,\n        reason,\n        diagnostics: player.getDiagnostics(),\n      });\n    });\n\n    player.on(\"strategychange\", ({ from, to, reason, currentTime }) => {\n      this._dispatch(\"strategychange\", {\n        from,\n        strategy: to,\n        strategyClass: player.getDiagnostics().strategyClass === \"pending\" ? null : player.getDiagnostics().strategyClass,\n        reason,\n        currentTime,\n        diagnostics: player.getDiagnostics(),\n      });\n    });\n\n    player.on(\"tracks\", ({ video: _v, audio, subtitle }) => {\n      this._audioTracks = audio;\n      this._subtitleTracks = subtitle;\n      this._dispatch(\"trackschange\", {\n        audioTracks: audio,\n        subtitleTracks: subtitle,\n      });\n    });\n\n    player.on(\"error\", (err: Error) => {\n      this._dispatchError(err);\n    });\n\n    player.on(\"timeupdate\", ({ currentTime }) => {\n      this._dispatch(\"timeupdate\", { currentTime });\n    });\n\n    player.on(\"ended\", () => {\n      this._dispatch(\"ended\", {});\n    });\n\n    player.on(\"ready\", () => {\n      this._dispatch(\"ready\", { diagnostics: player.getDiagnostics() });\n      // Apply any pending seek that was set before the player existed.\n      if (this._pendingSeek != null) {\n        const t = this._pendingSeek;\n        this._pendingSeek = null;\n        void player.seek(t).catch(() => { /* ignore */ });\n      }\n      // Honor any pending play() that was queued before bootstrap finished.\n      if (this._pendingPlay) {\n        this._pendingPlay = false;\n        void player.play().catch(() => { /* ignore — autoplay may be blocked */ });\n      } else if (this.autoplay) {\n        void player.play().catch(() => { /* ignore */ });\n      }\n    });\n  }\n\n  /**\n   * Tear down the active player and reset runtime state. Idempotent.\n   * If `currentBootstrapId` is provided, the bootstrap counter is NOT\n   * incremented (used by `_bootstrap()` to avoid invalidating itself).\n   */\n  private async _teardown(currentBootstrapId?: number): Promise<void> {\n    if (currentBootstrapId == null) {\n      // External callers (disconnect, destroy, source change) should bump\n      // the counter so any in-flight bootstrap is invalidated. The internal\n      // _bootstrap() call passes its own ID and we skip the bump.\n      this._bootstrapId++;\n    }\n    const player = this._player;\n    this._player = null;\n    this._strategy = null;\n    this._strategyClass = null;\n    this._audioTracks = [];\n    this._subtitleTracks = [];\n    if (player) {\n      try { await player.destroy(); } catch { /* ignore */ }\n    }\n  }\n\n  // ── Public properties ──────────────────────────────────────────────────\n\n  get src(): string | null {\n    return this._src;\n  }\n\n  set src(value: string | null) {\n    if (value == null) {\n      this.removeAttribute(\"src\");\n    } else {\n      this.setAttribute(\"src\", value);\n    }\n    // attributeChangedCallback handles the rest.\n  }\n\n  get source(): MediaInput | null {\n    return this._source;\n  }\n\n  set source(value: MediaInput | null) {\n    // Same-value reassignment for rich values is identity-based.\n    if (value === this._source && this._src == null) return;\n    this._source = value;\n    if (value != null) {\n      // Setting source clears src. Suppress the attribute callback so\n      // removing the src attribute doesn't wipe the source we just set.\n      this._src = null;\n      if (this.hasAttribute(\"src\")) {\n        this._suppressSrcAttrCallback = true;\n        try {\n          this.removeAttribute(\"src\");\n        } finally {\n          this._suppressSrcAttrCallback = false;\n        }\n      }\n    }\n    this._onSourceChanged();\n  }\n\n  get autoplay(): boolean {\n    return this.hasAttribute(\"autoplay\");\n  }\n\n  set autoplay(value: boolean) {\n    if (value) this.setAttribute(\"autoplay\", \"\");\n    else this.removeAttribute(\"autoplay\");\n  }\n\n  get muted(): boolean {\n    return this.hasAttribute(\"muted\");\n  }\n\n  set muted(value: boolean) {\n    if (value) this.setAttribute(\"muted\", \"\");\n    else this.removeAttribute(\"muted\");\n  }\n\n  get loop(): boolean {\n    return this.hasAttribute(\"loop\");\n  }\n\n  set loop(value: boolean) {\n    if (value) this.setAttribute(\"loop\", \"\");\n    else this.removeAttribute(\"loop\");\n  }\n\n  get preload(): \"none\" | \"metadata\" | \"auto\" {\n    const v = this.getAttribute(\"preload\");\n    return v === \"none\" || v === \"metadata\" || v === \"auto\" ? v : \"auto\";\n  }\n\n  set preload(value: \"none\" | \"metadata\" | \"auto\") {\n    this.setAttribute(\"preload\", value);\n  }\n\n  get diagnostics(): boolean {\n    return this.hasAttribute(\"diagnostics\");\n  }\n\n  set diagnostics(value: boolean) {\n    if (value) this.setAttribute(\"diagnostics\", \"\");\n    else this.removeAttribute(\"diagnostics\");\n  }\n\n  get preferredStrategy(): PreferredStrategy {\n    return this._preferredStrategy;\n  }\n\n  set preferredStrategy(value: PreferredStrategy) {\n    if (PREFERRED_STRATEGY_VALUES.has(value)) {\n      this.setAttribute(\"preferstrategy\", value);\n    }\n  }\n\n  get currentTime(): number {\n    return this._player?.getCurrentTime() ?? 0;\n  }\n\n  set currentTime(value: number) {\n    if (this._player) {\n      void this._player.seek(value).catch(() => { /* ignore */ });\n    } else {\n      // Defer to the next bootstrap. The `ready` handler applies it.\n      this._pendingSeek = value;\n    }\n  }\n\n  get duration(): number {\n    return this._player?.getDuration() ?? NaN;\n  }\n\n  get paused(): boolean {\n    return this._videoEl.paused;\n  }\n\n  get ended(): boolean {\n    return this._videoEl.ended;\n  }\n\n  get readyState(): number {\n    return this._videoEl.readyState;\n  }\n\n  /**\n   * Buffered time ranges for the active source. Mirrors the standard\n   * `<video>.buffered` `TimeRanges` API. For the native and remux strategies\n   * this reflects the underlying SourceBuffer / progressive download state.\n   * For the hybrid and fallback (canvas-rendered) strategies it currently\n   * returns an empty TimeRanges; a future release will synthesize a coarse\n   * range from the decoder's read position.\n   */\n  get buffered(): TimeRanges {\n    return this._videoEl.buffered;\n  }\n\n  // ── HTMLMediaElement parity ───────────────────────────────────────────\n  // Mirror the standard <video> surface so consumers can drop the element\n  // in as a <video> replacement. Each property is a thin passthrough to the\n  // shadow `<video>`.\n\n  get poster(): string {\n    return this._videoEl.poster;\n  }\n  set poster(value: string) {\n    if (value == null || value === \"\") this.removeAttribute(\"poster\");\n    else this.setAttribute(\"poster\", value);\n  }\n\n  get volume(): number {\n    return this._videoEl.volume;\n  }\n  set volume(value: number) {\n    this._videoEl.volume = value;\n  }\n\n  get playbackRate(): number {\n    return this._videoEl.playbackRate;\n  }\n  set playbackRate(value: number) {\n    this._videoEl.playbackRate = value;\n  }\n\n  get videoWidth(): number {\n    return this._videoEl.videoWidth;\n  }\n\n  get videoHeight(): number {\n    return this._videoEl.videoHeight;\n  }\n\n  get played(): TimeRanges {\n    return this._videoEl.played;\n  }\n\n  get seekable(): TimeRanges {\n    return this._videoEl.seekable;\n  }\n\n  get crossOrigin(): string | null {\n    return this._videoEl.crossOrigin;\n  }\n  set crossOrigin(value: string | null) {\n    if (value == null) this.removeAttribute(\"crossorigin\");\n    else this.setAttribute(\"crossorigin\", value);\n  }\n\n  get disableRemotePlayback(): boolean {\n    return this._videoEl.disableRemotePlayback;\n  }\n  set disableRemotePlayback(value: boolean) {\n    if (value) this.setAttribute(\"disableremoteplayback\", \"\");\n    else this.removeAttribute(\"disableremoteplayback\");\n  }\n\n  /**\n   * Native `HTMLMediaElement.canPlayType()` passthrough. Note that this\n   * answers about the *browser's* native support, not avbridge's full\n   * capabilities — avbridge can play many formats this method returns \"\"\n   * for, by routing them to the remux/hybrid/fallback strategies.\n   */\n  canPlayType(mimeType: string): CanPlayTypeResult {\n    return this._videoEl.canPlayType(mimeType);\n  }\n\n  /**\n   * **Escape hatch.** The underlying shadow-DOM `<video>` element.\n   *\n   * Use for native browser APIs the wrapper doesn't expose:\n   * - `el.videoElement.requestPictureInPicture()`\n   * - `el.videoElement.audioTracks` (browser native, not avbridge's track list)\n   * - direct integration with libraries that need a real HTMLVideoElement\n   *\n   * **Caveat:** When the active strategy is `\"fallback\"` or `\"hybrid\"`,\n   * frames are rendered to a canvas overlay, not into this `<video>`.\n   * APIs that depend on the actual pixels (Picture-in-Picture, captureStream)\n   * will not show the playing content in those modes. Check `el.strategy`\n   * before using such APIs.\n   */\n  get videoElement(): HTMLVideoElement {\n    return this._videoEl;\n  }\n\n  get strategy(): StrategyName | null {\n    return this._strategy;\n  }\n\n  get strategyClass(): StrategyClass | null {\n    return this._strategyClass;\n  }\n\n  get player(): UnifiedPlayer | null {\n    return this._player;\n  }\n\n  get audioTracks(): AudioTrackInfo[] {\n    return this._audioTracks;\n  }\n\n  get subtitleTracks(): SubtitleTrackInfo[] {\n    return this._subtitleTracks;\n  }\n\n  // ── Public methods ─────────────────────────────────────────────────────\n\n  /** Force a (re-)bootstrap if a source is currently set. */\n  async load(): Promise<void> {\n    if (this._destroyed) return;\n    const source = this._activeSource();\n    if (source == null) return;\n    await this._bootstrap(source);\n  }\n\n  /**\n   * Begin or resume playback. If the player isn't ready yet, the call is\n   * queued and applied once `ready` fires.\n   */\n  async play(): Promise<void> {\n    if (this._destroyed) return;\n    if (this._player) {\n      await this._player.play();\n    } else {\n      this._pendingPlay = true;\n    }\n  }\n\n  pause(): void {\n    if (this._destroyed) return;\n    this._pendingPlay = false;\n    this._player?.pause();\n  }\n\n  /**\n   * Tear down the element permanently. After destroy(), the element ignores\n   * all method calls and attribute changes.\n   */\n  async destroy(): Promise<void> {\n    if (this._destroyed) return;\n    this._destroyed = true;\n    await this._teardown();\n    this._dispatch(\"destroy\", {});\n  }\n\n  async setAudioTrack(id: number): Promise<void> {\n    if (this._destroyed || !this._player) return;\n    await this._player.setAudioTrack(id);\n  }\n\n  async setSubtitleTrack(id: number | null): Promise<void> {\n    if (this._destroyed || !this._player) return;\n    await this._player.setSubtitleTrack(id);\n  }\n\n  getDiagnostics(): DiagnosticsSnapshot | null {\n    return this._player?.getDiagnostics() ?? null;\n  }\n\n  // ── Event helpers ──────────────────────────────────────────────────────\n\n  private _dispatch<T>(name: string, detail: T): void {\n    this.dispatchEvent(new CustomEvent(name, { detail, bubbles: false }));\n  }\n\n  private _dispatchError(err: unknown): void {\n    const error = err instanceof Error ? err : new Error(String(err));\n    this._dispatch(\"error\", { error, diagnostics: this._player?.getDiagnostics() ?? null });\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    \"avbridge-player\": AvbridgePlayerElement;\n  }\n}\n","/**\n * Subpath entry: `import \"avbridge/element\"` registers the\n * `<avbridge-player>` custom element.\n *\n * This is a separate entry point from the core (`avbridge`) so that consumers\n * who only want the engine don't pay for the element code, and consumers who\n * want both pay for the element code exactly once.\n *\n * The registration is guarded so re-importing this module (e.g. via HMR or\n * multiple bundles) does not throw a \"name already defined\" error.\n */\n\nimport { AvbridgePlayerElement } from \"./element/avbridge-player.js\";\n\nexport { AvbridgePlayerElement };\n\nif (typeof customElements !== \"undefined\" && !customElements.get(\"avbridge-player\")) {\n  customElements.define(\"avbridge-player\", AvbridgePlayerElement);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "avbridge",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Play and convert arbitrary video files in the browser. Native, remux, hybrid, fallback, and transcode — one API.",
   "license": "MIT",
   "author": "Keishi Hattori",

package/src/element/avbridge-player.ts

@@ -37,6 +37,40 @@ const PREFERRED_STRATEGY_VALUES = new Set<PreferredStrategy>([
   "fallback",
 ]);
 
+/**
+ * Standard `HTMLMediaElement` events we forward from the inner `<video>`
+ * to the wrapper element so consumers can `el.addEventListener("loadedmetadata", ...)`
+ * exactly like they would with a real `<video>`. The element also dispatches
+ * its own custom events (`strategychange`, `ready`, `error`, etc.) — those
+ * are NOT in this list because they're avbridge-specific.
+ *
+ * Note: `progress` and `timeupdate` are deliberately NOT forwarded here.
+ * `progress` is dispatched by the constructor with our own `{ buffered }`
+ * detail. `timeupdate` is dispatched by the player layer (so it works for
+ * canvas-rendered fallback playback too, where the inner <video> never
+ * fires its own timeupdate).
+ */
+const FORWARDED_VIDEO_EVENTS = [
+  "loadstart",
+  "loadedmetadata",
+  "loadeddata",
+  "canplay",
+  "canplaythrough",
+  "play",
+  "playing",
+  "pause",
+  "seeking",
+  "seeked",
+  "volumechange",
+  "ratechange",
+  "durationchange",
+  "waiting",
+  "stalled",
+  "emptied",
+  "resize",
+  "error",
+] as const;
+
 /**
  * `HTMLElement` is a browser-only global. SSR frameworks (Next.js, Astro,
  * Remix, etc.) commonly import library modules on the server to extract
@@ -69,6 +103,10 @@ export class AvbridgePlayerElement extends HTMLElementCtor {
     "muted",
     "loop",
     "preload",
+    "poster",
+    "playsinline",
+    "crossorigin",
+    "disableremoteplayback",
     "diagnostics",
     "preferstrategy",
   ];
@@ -117,6 +155,9 @@ export class AvbridgePlayerElement extends HTMLElementCtor {
   /** Set if play() was called before the player was ready. */
   private _pendingPlay = false;
 
+  /** MutationObserver tracking light-DOM `<track>` children. */
+  private _trackObserver: MutationObserver | null = null;
+
   // ── Construction & lifecycle ───────────────────────────────────────────
 
   constructor() {
@@ -137,10 +178,28 @@ export class AvbridgePlayerElement extends HTMLElementCtor {
       if (this._destroyed) return;
       this._dispatch("progress", { buffered: this._videoEl.buffered });
     });
+
+    // Forward all standard HTMLMediaElement events from the inner <video>
+    // so consumers can use the element as a drop-in <video> replacement.
+    // Each event is re-dispatched on the wrapper element with no detail —
+    // listeners that need state should read it from the element directly.
+    for (const eventName of FORWARDED_VIDEO_EVENTS) {
+      this._videoEl.addEventListener(eventName, () => {
+        if (this._destroyed) return;
+        this.dispatchEvent(new Event(eventName, { bubbles: false }));
+      });
+    }
   }
 
   connectedCallback(): void {
     if (this._destroyed) return;
+    // Pick up any <track> children that were declared in HTML before the
+    // element upgraded, and watch for future additions/removals.
+    this._syncTextTracks();
+    if (!this._trackObserver) {
+      this._trackObserver = new MutationObserver(() => this._syncTextTracks());
+      this._trackObserver.observe(this, { childList: true, subtree: false });
+    }
     // Connection is the trigger for bootstrap. If we have a pending source
     // (set before connect), kick off bootstrap now.
     const source = this._activeSource();
@@ -151,6 +210,10 @@ export class AvbridgePlayerElement extends HTMLElementCtor {
 
   disconnectedCallback(): void {
     if (this._destroyed) return;
+    if (this._trackObserver) {
+      this._trackObserver.disconnect();
+      this._trackObserver = null;
+    }
     // Bump the bootstrap token so any in-flight async work is invalidated
     // before we tear down. _teardown() also bumps but we want the bump to
     // happen synchronously here so any awaited promise that resolves
@@ -169,13 +232,17 @@ export class AvbridgePlayerElement extends HTMLElementCtor {
       case "autoplay":
       case "muted":
       case "loop":
+      case "playsinline":
+      case "disableremoteplayback":
         // Reflect onto the underlying <video> element.
         if (newValue == null) this._videoEl.removeAttribute(name);
         else this._videoEl.setAttribute(name, newValue);
         break;
       case "preload":
-        if (newValue == null) this._videoEl.removeAttribute("preload");
-        else this._videoEl.setAttribute("preload", newValue);
+      case "poster":
+      case "crossorigin":
+        if (newValue == null) this._videoEl.removeAttribute(name);
+        else this._videoEl.setAttribute(name, newValue);
         break;
       case "diagnostics":
         // Phase A: no UI. Property is observable for users via getDiagnostics().
@@ -199,6 +266,29 @@ export class AvbridgePlayerElement extends HTMLElementCtor {
     return null;
   }
 
+  /**
+   * Mirror light-DOM `<track>` children into the shadow `<video>` so that
+   * the browser's native text-track machinery picks them up. Called on
+   * connect, on every mutation of light-DOM children, and once after each
+   * source change so newly-set tracks survive a fresh `<video>`.
+   *
+   * Strategy: clone the children. We don't move them because the user's
+   * code may still hold references to the originals (e.g. to set `default`).
+   * The shadow copies are throwaway — we wipe them on every sync.
+   */
+  private _syncTextTracks(): void {
+    // Remove existing shadow tracks.
+    const existing = this._videoEl.querySelectorAll("track");
+    for (const t of Array.from(existing)) t.remove();
+    // Clone every <track> light-DOM child into the shadow video.
+    for (const child of Array.from(this.children)) {
+      if (child.tagName === "TRACK") {
+        const clone = child.cloneNode(true) as HTMLTrackElement;
+        this._videoEl.appendChild(clone);
+      }
+    }
+  }
+
   /** Internal src setter — separate from the property setter so the
    * attributeChangedCallback can use it without re-entering reflection. */
   private _setSrcInternal(value: string | null): void {
@@ -260,6 +350,11 @@ export class AvbridgePlayerElement extends HTMLElementCtor {
 
     this._player = player;
 
+    // Resync any light-DOM <track> children into the (possibly fresh) shadow
+    // <video>. Strategies that swap or reset the inner video state would
+    // otherwise lose the tracks the user declared in HTML.
+    this._syncTextTracks();
+
     // Wire events. The unsubscribe handles are not stored individually
     // because destroy() will tear down the whole session anyway.
     player.on("strategy", ({ strategy, reason }) => {
@@ -476,13 +571,100 @@ export class AvbridgePlayerElement extends HTMLElementCtor {
    * `<video>.buffered` `TimeRanges` API. For the native and remux strategies
    * this reflects the underlying SourceBuffer / progressive download state.
    * For the hybrid and fallback (canvas-rendered) strategies it currently
-   * returns an empty TimeRanges; v1.1 will synthesize a coarse range from
-   * the decoder's read position.
+   * returns an empty TimeRanges; a future release will synthesize a coarse
+   * range from the decoder's read position.
    */
   get buffered(): TimeRanges {
     return this._videoEl.buffered;
   }
 
+  // ── HTMLMediaElement parity ───────────────────────────────────────────
+  // Mirror the standard <video> surface so consumers can drop the element
+  // in as a <video> replacement. Each property is a thin passthrough to the
+  // shadow `<video>`.
+
+  get poster(): string {
+    return this._videoEl.poster;
+  }
+  set poster(value: string) {
+    if (value == null || value === "") this.removeAttribute("poster");
+    else this.setAttribute("poster", value);
+  }
+
+  get volume(): number {
+    return this._videoEl.volume;
+  }
+  set volume(value: number) {
+    this._videoEl.volume = value;
+  }
+
+  get playbackRate(): number {
+    return this._videoEl.playbackRate;
+  }
+  set playbackRate(value: number) {
+    this._videoEl.playbackRate = value;
+  }
+
+  get videoWidth(): number {
+    return this._videoEl.videoWidth;
+  }
+
+  get videoHeight(): number {
+    return this._videoEl.videoHeight;
+  }
+
+  get played(): TimeRanges {
+    return this._videoEl.played;
+  }
+
+  get seekable(): TimeRanges {
+    return this._videoEl.seekable;
+  }
+
+  get crossOrigin(): string | null {
+    return this._videoEl.crossOrigin;
+  }
+  set crossOrigin(value: string | null) {
+    if (value == null) this.removeAttribute("crossorigin");
+    else this.setAttribute("crossorigin", value);
+  }
+
+  get disableRemotePlayback(): boolean {
+    return this._videoEl.disableRemotePlayback;
+  }
+  set disableRemotePlayback(value: boolean) {
+    if (value) this.setAttribute("disableremoteplayback", "");
+    else this.removeAttribute("disableremoteplayback");
+  }
+
+  /**
+   * Native `HTMLMediaElement.canPlayType()` passthrough. Note that this
+   * answers about the *browser's* native support, not avbridge's full
+   * capabilities — avbridge can play many formats this method returns ""
+   * for, by routing them to the remux/hybrid/fallback strategies.
+   */
+  canPlayType(mimeType: string): CanPlayTypeResult {
+    return this._videoEl.canPlayType(mimeType);
+  }
+
+  /**
+   * **Escape hatch.** The underlying shadow-DOM `<video>` element.
+   *
+   * Use for native browser APIs the wrapper doesn't expose:
+   * - `el.videoElement.requestPictureInPicture()`
+   * - `el.videoElement.audioTracks` (browser native, not avbridge's track list)
+   * - direct integration with libraries that need a real HTMLVideoElement
+   *
+   * **Caveat:** When the active strategy is `"fallback"` or `"hybrid"`,
+   * frames are rendered to a canvas overlay, not into this `<video>`.
+   * APIs that depend on the actual pixels (Picture-in-Picture, captureStream)
+   * will not show the playing content in those modes. Check `el.strategy`
+   * before using such APIs.
+   */
+  get videoElement(): HTMLVideoElement {
+    return this._videoEl;
+  }
+
   get strategy(): StrategyName | null {
     return this._strategy;
   }