@kodezen/player 1.0.2 → 1.0.4

package/dist/{types-TFltFgey.d.ts → types-30yBj4ll.d.ts}

@@ -23,8 +23,25 @@ interface ControlsConfig {
     volume: boolean;
     time: boolean;
     speed: boolean;
+    /** Captions (CC) button — only rendered when `tracks` are given. */
+    captions: boolean;
     fullscreen: boolean;
 }
+/**
+ * A WebVTT subtitle/caption file. The player fetches and renders it itself
+ * (not via a native `<track>`), so the same file works for every provider —
+ * YouTube/Vimeo iframes can't load an external caption file.
+ */
+interface CaptionTrack {
+    /** URL of the `.vtt` file. Must be same-origin or served with CORS. */
+    src: string;
+    /** Name shown in the captions menu when there's more than one track. */
+    label?: string;
+    /** BCP 47 language tag, e.g. `en`. */
+    srclang?: string;
+    /** Show this track as soon as it loads (otherwise captions start off). */
+    default?: boolean;
+}
 interface PlayerOptions {
     source: Source;
     /** Seconds to resume from on ready. Ignored if within 2s of the end. */
@@ -40,6 +57,8 @@ interface PlayerOptions {
     speeds?: number[];
     /** Toggle individual controls off. Everything defaults to on. */
     controls?: Partial<ControlsConfig>;
+    /** WebVTT subtitle/caption files, shown over the video for any provider. */
+    tracks?: CaptionTrack[];
     /** Extra class added to the player root for host styling. */
     className?: string;
 }
@@ -125,4 +144,4 @@ interface KodezenPlayerInstance {
     destroy(): void;
 }
 
-export type { ControlsConfig as C, KodezenPlayerInstance as K, PlayerOptions as P, ReadyPayload as R, Source as S, TimeUpdatePayload as T, PlayerState as a, PlayerEvents as b, Provider as c, ProviderCapabilities as d, ProviderEvents as e, SourceType as f };
+export type { CaptionTrack as C, KodezenPlayerInstance as K, PlayerOptions as P, ReadyPayload as R, Source as S, TimeUpdatePayload as T, PlayerState as a, PlayerEvents as b, ControlsConfig as c, Provider as d, ProviderCapabilities as e, ProviderEvents as f, SourceType as g };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kodezen/player",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Framework-agnostic, tracking-free HTML5 / YouTube / Vimeo media player core with a custom control bar. Emits progress events and accepts a resume position; the host owns all tracking and completion logic.",
   "type": "module",
   "main": "./dist/index.cjs",