avbridge 2.3.0 → 2.5.0

package/dist/player.d.cts

@@ -106,6 +106,18 @@ declare class AvbridgePlayerElement extends HTMLElement {
     get strategyClass(): string | undefined;
     get audioTracks(): unknown[];
     get subtitleTracks(): unknown[];
+    /**
+     * External subtitle files to attach when the source loads. Forwarded
+     * to the inner <avbridge-video>. Takes effect on next bootstrap.
+     */
+    get subtitles(): unknown;
+    set subtitles(value: unknown);
+    /** Attach a subtitle track to the current playback without a reload. */
+    addSubtitle(subtitle: {
+        url: string;
+        language?: string;
+        format?: "vtt" | "srt";
+    }): Promise<void>;
     get player(): unknown;
     get videoElement(): HTMLVideoElement;
     play(): Promise<void>;
@@ -505,6 +517,13 @@ declare class AvbridgeVideoElement extends HTMLElementCtor {
     private _strategyClass;
     private _audioTracks;
     private _subtitleTracks;
+    /**
+     * External subtitle list forwarded to `createPlayer()` on the next
+     * bootstrap. Setting this after bootstrap queues it for the next
+     * source change; consumers that need to swap subtitles mid-playback
+     * should set `source` to reload.
+     */
+    private _subtitles;
     /**
      * Initial strategy preference. `"auto"` means "let the classifier decide";
      * any other value is passed to `createPlayer({ initialStrategy })` and
@@ -621,6 +640,37 @@ declare class AvbridgeVideoElement extends HTMLElementCtor {
     get player(): UnifiedPlayer | null;
     get audioTracks(): AudioTrackInfo[];
     get subtitleTracks(): SubtitleTrackInfo[];
+    /**
+     * External subtitle files to attach when the source loads. Takes effect
+     * on the next bootstrap — set before assigning `source`, or reload via
+     * `load()` after changing. For dynamic post-bootstrap addition, use
+     * `addSubtitle()` instead.
+     *
+     * @example
+     * el.subtitles = [{ url: "/en.srt", format: "srt", language: "en" }];
+     * el.src = "/movie.mp4";
+     */
+    get subtitles(): Array<{
+        url: string;
+        language?: string;
+        format?: "vtt" | "srt";
+    }> | null;
+    set subtitles(value: Array<{
+        url: string;
+        language?: string;
+        format?: "vtt" | "srt";
+    }> | null);
+    /**
+     * Attach a subtitle track to the current playback without rebuilding
+     * the player. Works while the element is playing — converts SRT to
+     * VTT if needed, adds a `<track>` to the inner `<video>`. Canvas
+     * strategies pick up the new track via their textTracks watcher.
+     */
+    addSubtitle(subtitle: {
+        url: string;
+        language?: string;
+        format?: "vtt" | "srt";
+    }): Promise<void>;
     /** Force a (re-)bootstrap if a source is currently set. */
     load(): Promise<void>;
     /**

package/dist/player.d.ts

@@ -106,6 +106,18 @@ declare class AvbridgePlayerElement extends HTMLElement {
     get strategyClass(): string | undefined;
     get audioTracks(): unknown[];
     get subtitleTracks(): unknown[];
+    /**
+     * External subtitle files to attach when the source loads. Forwarded
+     * to the inner <avbridge-video>. Takes effect on next bootstrap.
+     */
+    get subtitles(): unknown;
+    set subtitles(value: unknown);
+    /** Attach a subtitle track to the current playback without a reload. */
+    addSubtitle(subtitle: {
+        url: string;
+        language?: string;
+        format?: "vtt" | "srt";
+    }): Promise<void>;
     get player(): unknown;
     get videoElement(): HTMLVideoElement;
     play(): Promise<void>;
@@ -505,6 +517,13 @@ declare class AvbridgeVideoElement extends HTMLElementCtor {
     private _strategyClass;
     private _audioTracks;
     private _subtitleTracks;
+    /**
+     * External subtitle list forwarded to `createPlayer()` on the next
+     * bootstrap. Setting this after bootstrap queues it for the next
+     * source change; consumers that need to swap subtitles mid-playback
+     * should set `source` to reload.
+     */
+    private _subtitles;
     /**
      * Initial strategy preference. `"auto"` means "let the classifier decide";
      * any other value is passed to `createPlayer({ initialStrategy })` and
@@ -621,6 +640,37 @@ declare class AvbridgeVideoElement extends HTMLElementCtor {
     get player(): UnifiedPlayer | null;
     get audioTracks(): AudioTrackInfo[];
     get subtitleTracks(): SubtitleTrackInfo[];
+    /**
+     * External subtitle files to attach when the source loads. Takes effect
+     * on the next bootstrap — set before assigning `source`, or reload via
+     * `load()` after changing. For dynamic post-bootstrap addition, use
+     * `addSubtitle()` instead.
+     *
+     * @example
+     * el.subtitles = [{ url: "/en.srt", format: "srt", language: "en" }];
+     * el.src = "/movie.mp4";
+     */
+    get subtitles(): Array<{
+        url: string;
+        language?: string;
+        format?: "vtt" | "srt";
+    }> | null;
+    set subtitles(value: Array<{
+        url: string;
+        language?: string;
+        format?: "vtt" | "srt";
+    }> | null);
+    /**
+     * Attach a subtitle track to the current playback without rebuilding
+     * the player. Works while the element is playing — converts SRT to
+     * VTT if needed, adds a `<track>` to the inner `<video>`. Canvas
+     * strategies pick up the new track via their textTracks watcher.
+     */
+    addSubtitle(subtitle: {
+        url: string;
+        language?: string;
+        format?: "vtt" | "srt";
+    }): Promise<void>;
     /** Force a (re-)bootstrap if a source is currently set. */
     load(): Promise<void>;
     /**