@codenkay/video-nsgplayer-ui 3.0.0 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import * as react from 'react';
2
2
  import { CSSProperties, RefObject, ReactNode } from 'react';
3
- import { AuthConfig, PlaybackCredentialConfig, mergePlayerConfig, VideoPlayer, PlayerConfig, PlaybackRate, HlsQualityLevel, QualitySelection, PlayerTextTrack, TextTrackSelection, PlayerAudioTrack, PlayIconPreset as PlayIconPreset$1 } from '@codenkay/video-nsgplayer-core';
3
+ import { AuthConfig, PlaybackCredentialConfig, mergePlayerConfig, AnalyticsConfig, VideoPlayer, PlayerConfig, PlaybackRate, HlsQualityLevel, QualitySelection, PlayerTextTrack, TextTrackSelection, PlayerAudioTrack, PlayIconPreset as PlayIconPreset$1 } from '@codenkay/video-nsgplayer-core';
4
4
 
5
5
  type NsgVideoPlayerWithControlsProps = {
6
6
  videoId: string;
@@ -8,6 +8,7 @@ type NsgVideoPlayerWithControlsProps = {
8
8
  playback?: PlaybackCredentialConfig;
9
9
  sourceUrl?: string;
10
10
  config?: Parameters<typeof mergePlayerConfig>[0];
11
+ analytics?: AnalyticsConfig;
11
12
  className?: string;
12
13
  style?: CSSProperties;
13
14
  onWatchTime?: (time: number) => void;
@@ -19,12 +20,18 @@ type NsgVideoPlayerWithControlsProps = {
19
20
  }) => void;
20
21
  onPlay?: () => void;
21
22
  onPause?: () => void;
23
+ onAuthError?: (error: {
24
+ message: string;
25
+ retryable: boolean;
26
+ }) => void;
27
+ /** Optional seek-bar hover preview image URL for a given media time. */
28
+ getSeekPreview?: (time: number) => string | null | undefined;
22
29
  };
23
30
  /**
24
31
  * Full player with control chrome (seek, quality, speed, live, zoom, keyboard).
25
32
  * Does not use native `<video controls>`.
26
33
  */
27
- declare function NsgVideoPlayerWithControls(props: NsgVideoPlayerWithControlsProps): react.JSX.Element;
34
+ declare const NsgVideoPlayerWithControls: react.ForwardRefExoticComponent<NsgVideoPlayerWithControlsProps & react.RefAttributes<VideoPlayer>>;
28
35
 
29
36
  type PlayerChromeProps = {
30
37
  player: VideoPlayer | null;
@@ -32,12 +39,13 @@ type PlayerChromeProps = {
32
39
  containerRef: RefObject<HTMLElement | null>;
33
40
  videoSlot: ReactNode;
34
41
  className?: string;
42
+ getSeekPreview?: (time: number) => string | null | undefined;
35
43
  };
36
44
  /**
37
45
  * Control shell over an already-mounted video (children / videoSlot).
38
46
  * Zoom is UI-only via CSS transform.
39
47
  */
40
- declare function PlayerChrome({ player, config, containerRef, videoSlot, className, }: PlayerChromeProps): react.JSX.Element;
48
+ declare function PlayerChrome({ player, config, containerRef, videoSlot, className, getSeekPreview, }: PlayerChromeProps): react.JSX.Element;
41
49
 
42
50
  declare function formatPlaybackTime(seconds: number): string;
43
51
  declare function resolveVisiblePlaybackRates(count: number): PlaybackRate[];
@@ -87,6 +95,7 @@ type PlayerControlBarProps = {
87
95
  onZoomIn: () => void;
88
96
  onZoomOut: () => void;
89
97
  seekBarRef?: RefObject<HTMLInputElement | null>;
98
+ getSeekPreview?: (time: number) => string | null | undefined;
90
99
  };
91
100
  declare function PlayerControlBar(props: PlayerControlBarProps): react.JSX.Element;
92
101
 
@@ -145,12 +154,13 @@ declare function PlaybackSpeedSelector({ rate, speedOptionCount, onSelect, }: {
145
154
  onSelect: (rate: PlaybackRate) => void;
146
155
  }): react.JSX.Element;
147
156
 
148
- declare function SeekBar({ currentTime, duration, bufferedEnd, onSeek, seekInputRef, }: {
157
+ declare function SeekBar({ currentTime, duration, bufferedEnd, onSeek, seekInputRef, getSeekPreview, }: {
149
158
  currentTime: number;
150
159
  duration: number;
151
160
  bufferedEnd: number;
152
161
  onSeek: (time: number) => void;
153
162
  seekInputRef?: RefObject<HTMLInputElement | null> | RefObject<HTMLInputElement>;
163
+ getSeekPreview?: (time: number) => string | null | undefined;
154
164
  }): react.JSX.Element;
155
165
 
156
166
  declare function TextTrackSelector({ tracks, selection, onSelect, }: {
@@ -203,4 +213,66 @@ declare function PlayIconPreset({ preset, size, }: {
203
213
  size?: number;
204
214
  }): react.JSX.Element;
205
215
 
206
- export { AudioTrackSelector, LiveBadgeButton, NsgVideoPlayerWithControls, type NsgVideoPlayerWithControlsProps, PlayIconPreset, PlaybackSpeedSelector, PlayerCenterOverlay, PlayerChrome, type PlayerChromeProps, PlayerControlBar, type PlayerControlBarProps, PlayerMenu, PlayerMenuItem, type PlayerOverlayKind, PlayerSkipCue, type PlayerZoomLevel, QualitySelector, SeekBar, TextTrackSelector, type UsePlayerControlsOptions, type UsePlayerControlsResult, ZOOM_STEPS, formatPlaybackTime, nextZoom, resolvePlayerOverlay, resolveVisiblePlaybackRates, snapPlaybackRate, usePlayerControls };
216
+ type WatermarkPosition = {
217
+ topPct: number;
218
+ leftPct: number;
219
+ };
220
+ /**
221
+ * Random on-player position within safe margins (percent of container).
222
+ */
223
+ declare function randomWatermarkPosition(random?: () => number): WatermarkPosition;
224
+ /**
225
+ * Random delay in `[0, maxMs]` for the gap between watermark appearances.
226
+ */
227
+ declare function randomWatermarkDelay(maxMs: number, random?: () => number): number;
228
+ /**
229
+ * Random delay before the first watermark show after playback is ready.
230
+ */
231
+ declare function randomFirstShowDelay(random?: () => number): number;
232
+
233
+ type StoredQualityPreference = "auto" | {
234
+ height: number;
235
+ };
236
+ declare const QUALITY_PREFERENCE_STORAGE_KEY = "nsg-player:quality-preference";
237
+ /**
238
+ * Reads the stored quality preference from localStorage.
239
+ * Returns `"auto"` when missing, invalid, or unavailable (SSR).
240
+ */
241
+ declare function readQualityPreference(): StoredQualityPreference;
242
+ /**
243
+ * Persists quality preference. Stores `"auto"` or `{ height }` only.
244
+ */
245
+ declare function writeQualityPreference(preference: StoredQualityPreference): void;
246
+ /**
247
+ * Maps a stored preference onto available levels.
248
+ * Missing height → `"auto"` (preference is kept in storage for later videos).
249
+ */
250
+ declare function matchQualityPreference(preference: StoredQualityPreference, levels: Array<{
251
+ index: number;
252
+ height: number;
253
+ }>): "auto" | number;
254
+ /**
255
+ * Builds a preference payload from the user's runtime selection.
256
+ */
257
+ declare function preferenceFromSelection(selection: "auto" | number, levels: Array<{
258
+ index: number;
259
+ height: number;
260
+ }>): StoredQualityPreference;
261
+
262
+ type PlaybackWatermarkState = WatermarkPosition & {
263
+ visible: boolean;
264
+ };
265
+ /**
266
+ * Schedules intermittent anti-leak watermark appearances while playback is active.
267
+ * When `reducedMotion` is true, shows a fixed-position watermark continuously.
268
+ */
269
+ declare function usePlaybackWatermark({ enabled, label, active, durationMs, intervalMaxMs, reducedMotion, }: {
270
+ enabled: boolean;
271
+ label: string | null;
272
+ active: boolean;
273
+ durationMs: number;
274
+ intervalMaxMs: number;
275
+ reducedMotion?: boolean;
276
+ }): PlaybackWatermarkState;
277
+
278
+ export { AudioTrackSelector, LiveBadgeButton, NsgVideoPlayerWithControls, type NsgVideoPlayerWithControlsProps, PlayIconPreset, PlaybackSpeedSelector, type PlaybackWatermarkState, PlayerCenterOverlay, PlayerChrome, type PlayerChromeProps, PlayerControlBar, type PlayerControlBarProps, PlayerMenu, PlayerMenuItem, type PlayerOverlayKind, PlayerSkipCue, type PlayerZoomLevel, QUALITY_PREFERENCE_STORAGE_KEY, QualitySelector, SeekBar, type StoredQualityPreference, TextTrackSelector, type UsePlayerControlsOptions, type UsePlayerControlsResult, type WatermarkPosition, ZOOM_STEPS, formatPlaybackTime, matchQualityPreference, nextZoom, preferenceFromSelection, randomFirstShowDelay, randomWatermarkDelay, randomWatermarkPosition, readQualityPreference, resolvePlayerOverlay, resolveVisiblePlaybackRates, snapPlaybackRate, usePlaybackWatermark, usePlayerControls, writeQualityPreference };
package/dist/index.js CHANGED
@@ -1,8 +1,12 @@
1
+ "use client";
2
+
1
3
  // src/NsgVideoPlayerWithControls.tsx
2
4
  import {
3
- useEffect as useEffect6,
5
+ forwardRef,
6
+ useEffect as useEffect7,
7
+ useImperativeHandle,
4
8
  useMemo as useMemo2,
5
- useRef as useRef5
9
+ useRef as useRef6
6
10
  } from "react";
7
11
  import {
8
12
  mergePlayerConfig,
@@ -86,6 +90,62 @@ function nextZoom(current, direction) {
86
90
  return ZOOM_STEPS[next] ?? 1;
87
91
  }
88
92
 
93
+ // src/utils/qualityPreference.ts
94
+ var QUALITY_PREFERENCE_STORAGE_KEY = "nsg-player:quality-preference";
95
+ function readQualityPreference() {
96
+ if (typeof window === "undefined" || !window.localStorage) {
97
+ return "auto";
98
+ }
99
+ try {
100
+ const raw = window.localStorage.getItem(QUALITY_PREFERENCE_STORAGE_KEY);
101
+ if (!raw) {
102
+ return "auto";
103
+ }
104
+ if (raw === "auto") {
105
+ return "auto";
106
+ }
107
+ const parsed = JSON.parse(raw);
108
+ if (parsed && typeof parsed === "object" && "height" in parsed && typeof parsed.height === "number" && Number.isFinite(parsed.height) && parsed.height > 0) {
109
+ return { height: parsed.height };
110
+ }
111
+ } catch {
112
+ }
113
+ return "auto";
114
+ }
115
+ function writeQualityPreference(preference) {
116
+ if (typeof window === "undefined" || !window.localStorage) {
117
+ return;
118
+ }
119
+ try {
120
+ if (preference === "auto") {
121
+ window.localStorage.setItem(QUALITY_PREFERENCE_STORAGE_KEY, "auto");
122
+ return;
123
+ }
124
+ window.localStorage.setItem(
125
+ QUALITY_PREFERENCE_STORAGE_KEY,
126
+ JSON.stringify({ height: preference.height })
127
+ );
128
+ } catch {
129
+ }
130
+ }
131
+ function matchQualityPreference(preference, levels) {
132
+ if (preference === "auto" || levels.length === 0) {
133
+ return "auto";
134
+ }
135
+ const match = levels.find((level) => level.height === preference.height);
136
+ return match ? match.index : "auto";
137
+ }
138
+ function preferenceFromSelection(selection, levels) {
139
+ if (selection === "auto") {
140
+ return "auto";
141
+ }
142
+ const level = levels.find((item) => item.index === selection);
143
+ if (!level || level.height <= 0) {
144
+ return "auto";
145
+ }
146
+ return { height: level.height };
147
+ }
148
+
89
149
  // src/hooks/usePlayerControls.ts
90
150
  function usePlayerControls(options) {
91
151
  const { player, config, containerRef } = options;
@@ -113,16 +173,31 @@ function usePlayerControls(options) {
113
173
  useEffect(() => {
114
174
  setZoom(config.player.defaultZoom || 1);
115
175
  }, [config.player.defaultZoom]);
176
+ useEffect(() => {
177
+ setVolumeState(config.player.volume);
178
+ setMuted(config.player.startMuted);
179
+ }, [config.player.volume, config.player.startMuted]);
116
180
  useEffect(() => {
117
181
  if (!player) return;
118
182
  if (containerRef?.current) {
119
183
  player.setFullscreenElement(containerRef.current);
120
184
  }
121
185
  const syncTracks = () => {
122
- setQualities(player.getAvailableQualities());
123
- setQualitySelection(player.getQuality());
124
- const q = player.getQuality();
125
- setActiveLevel(typeof q === "number" ? q : -1);
186
+ const levels = player.getAvailableQualities();
187
+ setQualities(levels);
188
+ let selection = player.getQuality();
189
+ if (config.controls.persistQualityPreference && levels.length > 0) {
190
+ const preferred = matchQualityPreference(
191
+ readQualityPreference(),
192
+ levels
193
+ );
194
+ if (preferred !== selection) {
195
+ player.setQuality(preferred);
196
+ selection = preferred;
197
+ }
198
+ }
199
+ setQualitySelection(selection);
200
+ setActiveLevel(typeof selection === "number" ? selection : -1);
126
201
  setTextTracks(player.getTextTracks());
127
202
  setSelectedTextTrack(player.getSelectedTextTrack());
128
203
  setAudioTracks(player.getAudioTracks());
@@ -131,7 +206,12 @@ function usePlayerControls(options) {
131
206
  setAtLiveEdge(player.isAtLiveEdge());
132
207
  setVolumeState(player.getVolume());
133
208
  setMuted(player.isMuted());
134
- setPlaybackRateState(player.getPlaybackRate());
209
+ if (player.isLive()) {
210
+ player.setPlaybackRate(1);
211
+ setPlaybackRateState(1);
212
+ } else {
213
+ setPlaybackRateState(player.getPlaybackRate());
214
+ }
135
215
  setIsFullscreen(player.isFullscreen());
136
216
  };
137
217
  const offs = [
@@ -196,7 +276,7 @@ function usePlayerControls(options) {
196
276
  for (const off of offs) off();
197
277
  document.removeEventListener("fullscreenchange", onFs);
198
278
  };
199
- }, [player, containerRef]);
279
+ }, [player, containerRef, config.controls.persistQualityPreference]);
200
280
  const togglePlay = useCallback(() => {
201
281
  if (!player) return;
202
282
  if (player.getState() === "playing") {
@@ -237,6 +317,9 @@ function usePlayerControls(options) {
237
317
  }, [player]);
238
318
  const setPlaybackRate = useCallback(
239
319
  (rate) => {
320
+ if (player?.isLive()) {
321
+ return;
322
+ }
240
323
  player?.setPlaybackRate(rate);
241
324
  setPlaybackRateState(rate);
242
325
  },
@@ -245,8 +328,16 @@ function usePlayerControls(options) {
245
328
  const setQuality = useCallback(
246
329
  (selection) => {
247
330
  player?.setQuality(selection);
331
+ if (config.controls.persistQualityPreference) {
332
+ writeQualityPreference(
333
+ preferenceFromSelection(
334
+ selection,
335
+ player?.getAvailableQualities() ?? []
336
+ )
337
+ );
338
+ }
248
339
  },
249
- [player]
340
+ [player, config.controls.persistQualityPreference]
250
341
  );
251
342
  const setTextTrack = useCallback(
252
343
  (selection) => {
@@ -661,13 +752,15 @@ function SeekBar({
661
752
  duration,
662
753
  bufferedEnd,
663
754
  onSeek,
664
- seekInputRef
755
+ seekInputRef,
756
+ getSeekPreview
665
757
  }) {
666
758
  const trackRef = useRef3(null);
667
759
  const [hover, setHover] = useState4(INITIAL_HOVER);
668
760
  const max = duration > 0 ? duration : 0;
669
761
  const bufferedPct = max > 0 ? Math.min(100, bufferedEnd / max * 100) : 0;
670
762
  const playedPct = max > 0 ? Math.min(100, currentTime / max * 100) : 0;
763
+ const previewUrl = hover.visible && getSeekPreview ? getSeekPreview(hover.time) : null;
671
764
  const updateHover = useCallback2(
672
765
  (clientX) => {
673
766
  const track = trackRef.current;
@@ -729,13 +822,24 @@ function SeekBar({
729
822
  style: { width: `${playedPct}%` }
730
823
  }
731
824
  ),
732
- hover.visible && max > 0 ? /* @__PURE__ */ jsx8(
825
+ hover.visible && max > 0 ? /* @__PURE__ */ jsxs6(
733
826
  "div",
734
827
  {
735
828
  className: "nsg-player-seek__tooltip",
736
829
  style: { left: `${hover.percent}%` },
737
830
  role: "tooltip",
738
- children: formatPlaybackTime(hover.time)
831
+ children: [
832
+ previewUrl ? /* @__PURE__ */ jsx8(
833
+ "img",
834
+ {
835
+ className: "nsg-player-seek__preview",
836
+ src: previewUrl,
837
+ alt: "",
838
+ draggable: false
839
+ }
840
+ ) : null,
841
+ formatPlaybackTime(hover.time)
842
+ ]
739
843
  }
740
844
  ) : null,
741
845
  /* @__PURE__ */ jsx8(
@@ -825,7 +929,8 @@ function PlayerControlBar(props) {
825
929
  onToggleFullscreen,
826
930
  onZoomIn,
827
931
  onZoomOut,
828
- seekBarRef
932
+ seekBarRef,
933
+ getSeekPreview
829
934
  } = props;
830
935
  const controls = config.controls;
831
936
  const showZoom = config.player.zoomEnabled && controls.showZoom;
@@ -844,7 +949,8 @@ function PlayerControlBar(props) {
844
949
  duration,
845
950
  bufferedEnd,
846
951
  onSeek,
847
- seekInputRef: seekBarRef
952
+ seekInputRef: seekBarRef,
953
+ getSeekPreview
848
954
  }
849
955
  ),
850
956
  /* @__PURE__ */ jsxs8("div", { className: "nsg-player-control-row", children: [
@@ -954,7 +1060,7 @@ function PlayerControlBar(props) {
954
1060
  ]
955
1061
  }
956
1062
  ) : null,
957
- controls.showSpeed ? /* @__PURE__ */ jsx10(
1063
+ controls.showSpeed && !isLive ? /* @__PURE__ */ jsx10(
958
1064
  PlaybackSpeedSelector,
959
1065
  {
960
1066
  rate: playbackRate,
@@ -1053,7 +1159,8 @@ function PlayerChrome({
1053
1159
  config,
1054
1160
  containerRef,
1055
1161
  videoSlot,
1056
- className
1162
+ className,
1163
+ getSeekPreview
1057
1164
  }) {
1058
1165
  const rootRef = useRef4(null);
1059
1166
  const seekBarRef = useRef4(null);
@@ -1237,7 +1344,8 @@ function PlayerChrome({
1237
1344
  onToggleFullscreen: () => void controls.toggleFullscreen(),
1238
1345
  onZoomIn: controls.zoomIn,
1239
1346
  onZoomOut: controls.zoomOut,
1240
- seekBarRef
1347
+ seekBarRef,
1348
+ getSeekPreview
1241
1349
  }
1242
1350
  ) : null
1243
1351
  ]
@@ -1245,11 +1353,117 @@ function PlayerChrome({
1245
1353
  );
1246
1354
  }
1247
1355
 
1356
+ // src/hooks/usePlaybackWatermark.ts
1357
+ import { useEffect as useEffect6, useRef as useRef5, useState as useState6 } from "react";
1358
+
1359
+ // src/utils/watermarkSchedule.ts
1360
+ var WATERMARK_TOP_MIN_PCT = 8;
1361
+ var WATERMARK_TOP_MAX_PCT = 70;
1362
+ var WATERMARK_LEFT_MIN_PCT = 5;
1363
+ var WATERMARK_LEFT_MAX_PCT = 70;
1364
+ var WATERMARK_FIRST_SHOW_MIN_MS = 3e3;
1365
+ var WATERMARK_FIRST_SHOW_MAX_MS = 8e3;
1366
+ function randomInRange(min, max, random = Math.random) {
1367
+ if (max <= min) {
1368
+ return min;
1369
+ }
1370
+ return min + random() * (max - min);
1371
+ }
1372
+ function randomWatermarkPosition(random = Math.random) {
1373
+ const topPct = WATERMARK_TOP_MIN_PCT + random() * (WATERMARK_TOP_MAX_PCT - WATERMARK_TOP_MIN_PCT);
1374
+ const leftPct = WATERMARK_LEFT_MIN_PCT + random() * (WATERMARK_LEFT_MAX_PCT - WATERMARK_LEFT_MIN_PCT);
1375
+ return { topPct, leftPct };
1376
+ }
1377
+ function randomWatermarkDelay(maxMs, random = Math.random) {
1378
+ if (!Number.isFinite(maxMs) || maxMs <= 0) {
1379
+ return 0;
1380
+ }
1381
+ return Math.min(maxMs, Math.floor(random() * (maxMs + 1)));
1382
+ }
1383
+ function randomFirstShowDelay(random = Math.random) {
1384
+ return Math.floor(
1385
+ randomInRange(
1386
+ WATERMARK_FIRST_SHOW_MIN_MS,
1387
+ WATERMARK_FIRST_SHOW_MAX_MS,
1388
+ random
1389
+ )
1390
+ );
1391
+ }
1392
+
1393
+ // src/hooks/usePlaybackWatermark.ts
1394
+ var HIDDEN = {
1395
+ visible: false,
1396
+ topPct: 0,
1397
+ leftPct: 0
1398
+ };
1399
+ function usePlaybackWatermark({
1400
+ enabled,
1401
+ label,
1402
+ active,
1403
+ durationMs,
1404
+ intervalMaxMs,
1405
+ reducedMotion = false
1406
+ }) {
1407
+ const [state, setState] = useState6(HIDDEN);
1408
+ const showTimerRef = useRef5(null);
1409
+ const hideTimerRef = useRef5(null);
1410
+ const generationRef = useRef5(0);
1411
+ useEffect6(() => {
1412
+ const clearTimers = () => {
1413
+ if (showTimerRef.current !== null) {
1414
+ window.clearTimeout(showTimerRef.current);
1415
+ showTimerRef.current = null;
1416
+ }
1417
+ if (hideTimerRef.current !== null) {
1418
+ window.clearTimeout(hideTimerRef.current);
1419
+ hideTimerRef.current = null;
1420
+ }
1421
+ };
1422
+ generationRef.current += 1;
1423
+ const generation = generationRef.current;
1424
+ clearTimers();
1425
+ setState(HIDDEN);
1426
+ if (!enabled || !label || !active) {
1427
+ return () => {
1428
+ clearTimers();
1429
+ };
1430
+ }
1431
+ if (reducedMotion) {
1432
+ setState({ visible: true, topPct: 12, leftPct: 8 });
1433
+ return () => {
1434
+ clearTimers();
1435
+ };
1436
+ }
1437
+ const scheduleShow = (delayMs) => {
1438
+ showTimerRef.current = window.setTimeout(() => {
1439
+ if (generation !== generationRef.current) {
1440
+ return;
1441
+ }
1442
+ const position = randomWatermarkPosition();
1443
+ setState({ visible: true, ...position });
1444
+ hideTimerRef.current = window.setTimeout(() => {
1445
+ if (generation !== generationRef.current) {
1446
+ return;
1447
+ }
1448
+ setState(HIDDEN);
1449
+ scheduleShow(randomWatermarkDelay(intervalMaxMs));
1450
+ }, durationMs);
1451
+ }, delayMs);
1452
+ };
1453
+ scheduleShow(randomFirstShowDelay());
1454
+ return () => {
1455
+ generationRef.current += 1;
1456
+ clearTimers();
1457
+ };
1458
+ }, [enabled, label, active, durationMs, intervalMaxMs, reducedMotion]);
1459
+ return state;
1460
+ }
1461
+
1248
1462
  // src/NsgVideoPlayerWithControls.tsx
1249
1463
  import { jsx as jsx13, jsxs as jsxs11 } from "react/jsx-runtime";
1250
- function NsgVideoPlayerWithControls(props) {
1251
- const containerRef = useRef5(null);
1252
- const onWatchTimeRef = useRef5(props.onWatchTime);
1464
+ var NsgVideoPlayerWithControls = forwardRef(function NsgVideoPlayerWithControls2(props, ref) {
1465
+ const containerRef = useRef6(null);
1466
+ const onWatchTimeRef = useRef6(props.onWatchTime);
1253
1467
  onWatchTimeRef.current = props.onWatchTime;
1254
1468
  const resolvedConfig = useMemo2(
1255
1469
  () => mergePlayerConfig({
@@ -1267,10 +1481,15 @@ function NsgVideoPlayerWithControls(props) {
1267
1481
  playback: props.playback,
1268
1482
  sourceUrl: props.sourceUrl,
1269
1483
  config: resolvedConfig,
1484
+ analytics: props.analytics,
1270
1485
  onReady: props.onReady,
1271
- onError: props.onError
1486
+ onError: props.onError,
1487
+ onPlay: props.onPlay,
1488
+ onPause: props.onPause,
1489
+ onAuthError: props.onAuthError
1272
1490
  });
1273
- useEffect6(() => {
1491
+ useImperativeHandle(ref, () => player, [player]);
1492
+ useEffect7(() => {
1274
1493
  if (!player) return;
1275
1494
  const report = () => {
1276
1495
  const t = player.getCurrentTime();
@@ -1278,9 +1497,7 @@ function NsgVideoPlayerWithControls(props) {
1278
1497
  };
1279
1498
  const offs = [
1280
1499
  player.on("pause", report),
1281
- player.on("ended", report),
1282
- player.on("play", () => props.onPlay?.()),
1283
- player.on("pause", () => props.onPause?.())
1500
+ player.on("ended", report)
1284
1501
  ];
1285
1502
  const onBeforeUnload = () => report();
1286
1503
  window.addEventListener("beforeunload", onBeforeUnload);
@@ -1288,7 +1505,16 @@ function NsgVideoPlayerWithControls(props) {
1288
1505
  for (const off of offs) off();
1289
1506
  window.removeEventListener("beforeunload", onBeforeUnload);
1290
1507
  };
1291
- }, [player, props]);
1508
+ }, [player]);
1509
+ const watermarkActive = state === "playing" || state === "paused" || state === "buffering";
1510
+ const watermark = usePlaybackWatermark({
1511
+ enabled: resolvedConfig.watermark.enabled,
1512
+ label: resolvedConfig.watermark.text?.trim() || null,
1513
+ active: watermarkActive,
1514
+ durationMs: resolvedConfig.watermark.durationMs,
1515
+ intervalMaxMs: resolvedConfig.watermark.intervalMaxMs,
1516
+ reducedMotion: resolvedConfig.accessibility.reducedMotion
1517
+ });
1292
1518
  const cssVars = themeToCssVars(resolvedConfig.theme);
1293
1519
  const showBootstrap = state === "loading" || state === "idle";
1294
1520
  return /* @__PURE__ */ jsxs11(
@@ -1314,6 +1540,7 @@ function NsgVideoPlayerWithControls(props) {
1314
1540
  player,
1315
1541
  config: resolvedConfig,
1316
1542
  containerRef,
1543
+ getSeekPreview: props.getSeekPreview,
1317
1544
  videoSlot: /* @__PURE__ */ jsx13(
1318
1545
  "video",
1319
1546
  {
@@ -1325,13 +1552,24 @@ function NsgVideoPlayerWithControls(props) {
1325
1552
  )
1326
1553
  }
1327
1554
  ),
1328
- resolvedConfig.watermark.enabled && resolvedConfig.watermark.text ? /* @__PURE__ */ jsx13("div", { className: "nsg-player-watermark", "aria-hidden": true, children: resolvedConfig.watermark.text }) : null,
1555
+ watermark.visible ? /* @__PURE__ */ jsx13(
1556
+ "div",
1557
+ {
1558
+ className: "nsg-player-watermark",
1559
+ "aria-hidden": true,
1560
+ style: {
1561
+ top: `${watermark.topPct}%`,
1562
+ left: `${watermark.leftPct}%`
1563
+ },
1564
+ children: resolvedConfig.watermark.text
1565
+ }
1566
+ ) : null,
1329
1567
  error ? /* @__PURE__ */ jsx13("p", { className: "nsg-player-error", role: "alert", children: error.message || "Unable to play this video." }) : null,
1330
1568
  showBootstrap && !error ? /* @__PURE__ */ jsx13("p", { className: "nsg-player-status", children: "Loading video\u2026" }) : null
1331
1569
  ]
1332
1570
  }
1333
1571
  );
1334
- }
1572
+ });
1335
1573
  export {
1336
1574
  AudioTrackSelector,
1337
1575
  LiveBadgeButton,
@@ -1344,15 +1582,24 @@ export {
1344
1582
  PlayerMenu,
1345
1583
  PlayerMenuItem,
1346
1584
  PlayerSkipCue,
1585
+ QUALITY_PREFERENCE_STORAGE_KEY,
1347
1586
  QualitySelector,
1348
1587
  SeekBar,
1349
1588
  TextTrackSelector,
1350
1589
  ZOOM_STEPS,
1351
1590
  formatPlaybackTime,
1591
+ matchQualityPreference,
1352
1592
  nextZoom,
1593
+ preferenceFromSelection,
1594
+ randomFirstShowDelay,
1595
+ randomWatermarkDelay,
1596
+ randomWatermarkPosition,
1597
+ readQualityPreference,
1353
1598
  resolvePlayerOverlay,
1354
1599
  resolveVisiblePlaybackRates,
1355
1600
  snapPlaybackRate,
1356
- usePlayerControls
1601
+ usePlaybackWatermark,
1602
+ usePlayerControls,
1603
+ writeQualityPreference
1357
1604
  };
1358
1605
  //# sourceMappingURL=index.js.map