@m4l/gclick 0.10.0 → 0.11.0-beta-refactor-videojs-v10-player.0

package/components/CameraStream/defaults/DefaultPhaseStreaming.d.ts

@@ -22,7 +22,7 @@ import { CameraStreamPhaseStreamingSlotProps } from '../types';
  * the consumer can override only a badge (via `slots.liveBadge` /
  * `slots.replayBadge`) without rewriting this whole component.
  *
- * Registers its `VideoPlayerHandle` in the `CameraStreamPlayersRegistry` while
+ * Registers its `VideoPlayerControl` in the `CameraStreamPlayersRegistry` while
  * mounted, so `useCameraStreamPlayers()` can drive this player's transport
  * (pause / mute / fullscreen / snapshot) from outside the slot. The
  * registration is null-safe: if the slot is rendered without a provider (e.g.

package/components/CameraStream/defaults/DefaultPhaseStreaming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultPhaseStreaming.d.ts","sourceRoot":"","sources":["../../../../../../../packages/gclick/src/components/CameraStream/defaults/DefaultPhaseStreaming.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,UAAU,CAAC;AAcpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,SAAS,EACT,MAAM,EACN,IAAI,EACJ,KAAK,EACL,OAAO,EACP,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,EAAE,mCAAmC,oDAsFrC"}
+{"version":3,"file":"DefaultPhaseStreaming.d.ts","sourceRoot":"","sources":["../../../../../../../packages/gclick/src/components/CameraStream/defaults/DefaultPhaseStreaming.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,UAAU,CAAC;AAcpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,SAAS,EACT,MAAM,EACN,IAAI,EACJ,KAAK,EACL,OAAO,EACP,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,EAAE,mCAAmC,oDAyFrC"}

package/components/CameraStreams/CameraStreamPlayersContext.d.ts

@@ -1,26 +1,34 @@
-import { VideoPlayerHandle } from '../VideoPlayer/types';
+import { VideoPlayerControl } from '../VideoPlayer/types';
 import { PlayerKey } from './types';
 /**
- * Imperative registry of live `VideoPlayerHandle`s keyed by `PlayerKey`.
+ * Imperative registry of live {@link VideoPlayerControl}s keyed by `PlayerKey`.
  *
- * Kept OUTSIDE the Zustand store on purpose: a handle is a mutable,
- * video.js-bound object, not serializable FSM state. Putting it in the store
- * would break the devtools/immer "state is serializable" invariant and blur
- * the SRP boundary (store = coordination/FSM, registry = video transport).
+ * Kept OUTSIDE the Zustand store on purpose: a control is a mutable adapter
+ * over a video.js v10 player store, not serializable FSM state. Putting it in
+ * the store would break the devtools/immer "state is serializable" invariant
+ * and blur the SRP boundary (store = coordination/FSM, registry = video
+ * transport).
  *
- * The default `phaseStreaming` slot registers its handle on mount and
+ * The default `phaseStreaming` slot registers its control on mount and
  * unregisters on unmount, so external imperative control works without the
  * consumer overriding any slot.
  */
 export interface CameraStreamPlayersRegistry {
-    /** Register (or replace) the handle for a player key. */
-    register(key: PlayerKey, handle: VideoPlayerHandle): void;
-    /** Remove the handle for a player key (called on unmount). */
+    /** Register (or replace) the control for a player key. */
+    register(key: PlayerKey, control: VideoPlayerControl): void;
+    /** Remove the control for a player key (called on unmount). */
     unregister(key: PlayerKey): void;
-    /** Resolve the handle for a player key, or `null` when not registered. */
-    get(key: PlayerKey): VideoPlayerHandle | null;
+    /** Resolve the control for a player key, or `null` when not registered. */
+    get(key: PlayerKey): VideoPlayerControl | null;
     /** Every currently-registered player key. */
     keys(): PlayerKey[];
+    /**
+     * Subscribe to registration changes (a control registered or unregistered).
+     * Returns an unsubscribe function. Lets the suspension coordinator catch
+     * players that start streaming *after* the subtree was already suspended (an
+     * in-flight request resolving while hidden), which a one-shot snapshot misses.
+     */
+    subscribe(listener: () => void): () => void;
 }
 /**
  * Context carrying the scoped registry down the tree. Mirrors the

package/components/CameraStreams/CameraStreamPlayersContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CameraStreamPlayersContext.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/components/CameraStreams/CameraStreamPlayersContext.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC1D,8DAA8D;IAC9D,UAAU,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACjC,0EAA0E;IAC1E,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,iBAAiB,GAAG,IAAI,CAAC;IAC9C,6CAA6C;IAC7C,IAAI,IAAI,SAAS,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,6DACkB,CAAC"}
+{"version":3,"file":"CameraStreamPlayersContext.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/components/CameraStreams/CameraStreamPlayersContext.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,2BAA2B;IAC1C,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC5D,+DAA+D;IAC/D,UAAU,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACjC,2EAA2E;IAC3E,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,kBAAkB,GAAG,IAAI,CAAC;IAC/C,6CAA6C;IAC7C,IAAI,IAAI,SAAS,EAAE,CAAC;IACpB;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7C;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,6DACkB,CAAC"}

package/components/CameraStreams/CameraStreamsProvider.d.ts

@@ -9,7 +9,7 @@ import { CameraStreamsProviderProps } from './types';
  * and call `useCameraStreams()` from any descendant.
  *
  * Alongside the store it provides a `CameraStreamPlayersRegistry` (a separate
- * ref-based map of live `VideoPlayerHandle`s). The default `phaseStreaming`
+ * ref-based map of live `VideoPlayerControl`s). The default `phaseStreaming`
  * slot registers into it, so `useCameraStreamPlayers()` can drive the video
  * transport (pause / mute / fullscreen / snapshot) from outside the slot.
  */

package/components/CameraStreams/CameraStreamsProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CameraStreamsProvider.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/components/CameraStreams/CameraStreamsProvider.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,oDAiCtE"}
+{"version":3,"file":"CameraStreamsProvider.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/components/CameraStreams/CameraStreamsProvider.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,oDAkCtE"}

package/components/CameraStreams/CameraStreamsProvider.js

@@ -1,27 +1,29 @@
-import { jsx as t, jsxs as l } from "@emotion/react/jsx-runtime";
+import { jsx as t, jsxs as c } from "@emotion/react/jsx-runtime";
 import { useRef as o } from "react";
-import { useModuleDictionary as c } from "@m4l/core";
-import { resolveCameraStreamsDictionaryLabels as f } from "./dictionary.js";
-import { CameraStreamsContext as u } from "./CameraStreamsContext.js";
-import { CameraStreamPlayersContext as p } from "./CameraStreamPlayersContext.js";
-import { createCameraStreamsStore as C } from "./store.js";
-import { createCameraStreamPlayersRegistry as S } from "./createCameraStreamPlayersRegistry.js";
-import { CameraStreamsEngine as d } from "./subcomponents/CameraStreamsEngine.js";
-function D(a) {
-  const { children: m, labels: i, ...n } = a, { getLabel: s } = c(), r = o(null);
-  r.current || (r.current = C({
+import { useModuleDictionary as f } from "@m4l/core";
+import { resolveCameraStreamsDictionaryLabels as u } from "./dictionary.js";
+import { CameraStreamsContext as p } from "./CameraStreamsContext.js";
+import { CameraStreamPlayersContext as C } from "./CameraStreamPlayersContext.js";
+import { createCameraStreamsStore as S } from "./store.js";
+import { createCameraStreamPlayersRegistry as d } from "./createCameraStreamPlayersRegistry.js";
+import { CameraStreamsEngine as y } from "./subcomponents/CameraStreamsEngine.js";
+import { CameraStreamsSuspensionController as v } from "./subcomponents/CameraStreamsSuspensionController.js";
+function M(a) {
+  const { children: m, labels: s, suspended: i = !1, ...n } = a, { getLabel: l } = f(), r = o(null);
+  r.current || (r.current = S({
     ...n,
     labels: {
-      ...f(s),
-      ...i ?? {}
+      ...u(l),
+      ...s ?? {}
     }
   }));
   const e = o(null);
-  return e.current || (e.current = S()), /* @__PURE__ */ t(u.Provider, { value: r.current, children: /* @__PURE__ */ l(p.Provider, { value: e.current, children: [
-    /* @__PURE__ */ t(d, {}),
+  return e.current || (e.current = d()), /* @__PURE__ */ t(p.Provider, { value: r.current, children: /* @__PURE__ */ c(C.Provider, { value: e.current, children: [
+    /* @__PURE__ */ t(y, {}),
+    /* @__PURE__ */ t(v, { suspended: i }),
     m
   ] }) });
 }
 export {
-  D as CameraStreamsProvider
+  M as CameraStreamsProvider
 };

package/components/CameraStreams/createCameraStreamPlayersRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createCameraStreamPlayersRegistry.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/components/CameraStreams/createCameraStreamPlayersRegistry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAIhF;;;GAGG;AACH,wBAAgB,iCAAiC,IAAI,2BAA2B,CAgB/E"}
+{"version":3,"file":"createCameraStreamPlayersRegistry.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/components/CameraStreams/createCameraStreamPlayersRegistry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAIhF;;;GAGG;AACH,wBAAgB,iCAAiC,IAAI,2BAA2B,CAkC/E"}

package/components/CameraStreams/createCameraStreamPlayersRegistry.js

@@ -1,20 +1,30 @@
-function n() {
-  const r = /* @__PURE__ */ new Map();
+function o() {
+  const r = /* @__PURE__ */ new Map(), t = /* @__PURE__ */ new Set(), n = () => {
+    t.forEach((e) => e());
+  };
   return {
-    register(e, t) {
-      r.set(e, t);
+    /** Store (or replace) the control for a key and notify subscribers. */
+    register(e, s) {
+      r.set(e, s), n();
     },
+    /** Drop the control for a key and notify subscribers. */
     unregister(e) {
-      r.delete(e);
+      r.delete(e), n();
     },
     get(e) {
       return r.get(e) ?? null;
     },
     keys() {
       return Array.from(r.keys());
+    },
+    /** Register a change listener; returns a function that removes it. */
+    subscribe(e) {
+      return t.add(e), () => {
+        t.delete(e);
+      };
     }
   };
 }
 export {
-  n as createCameraStreamPlayersRegistry
+  o as createCameraStreamPlayersRegistry
 };

package/components/CameraStreams/subcomponents/CameraStreamsSuspensionController.d.ts

@@ -0,0 +1,18 @@
+interface CameraStreamsSuspensionControllerProps {
+    /** Whether the provider's subtree is currently suspended (hidden). */
+    suspended: boolean;
+}
+/**
+ * Invisible coordinator that pauses/resumes video decode when the provider is
+ * suspended (the subtree is hidden but kept alive, e.g. behind an inactive tab).
+ *
+ * On suspend it pauses every currently-playing clip — freeing decode while
+ * preserving the playhead and store — and remembers exactly that set so it can
+ * resume it later. It also pauses any clip that starts streaming *while*
+ * suspended (an in-flight request resolving after the tab was hidden), which a
+ * one-shot snapshot would miss. On resume it replays only the clips it paused;
+ * idle, ended, and user-paused players are left untouched.
+ */
+export declare function CameraStreamsSuspensionController({ suspended, }: CameraStreamsSuspensionControllerProps): null;
+export {};
+//# sourceMappingURL=CameraStreamsSuspensionController.d.ts.map

package/components/CameraStreams/subcomponents/CameraStreamsSuspensionController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CameraStreamsSuspensionController.d.ts","sourceRoot":"","sources":["../../../../../../../packages/gclick/src/components/CameraStreams/subcomponents/CameraStreamsSuspensionController.tsx"],"names":[],"mappings":"AAOA,UAAU,sCAAsC;IAC9C,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iCAAiC,CAAC,EAChD,SAAS,GACV,EAAE,sCAAsC,GAAG,IAAI,CAsD/C"}

package/components/CameraStreams/subcomponents/CameraStreamsSuspensionController.js

@@ -0,0 +1,35 @@
+import { useContext as i, useRef as c, useEffect as f } from "react";
+import { CameraStreamPlayersContext as d } from "../CameraStreamPlayersContext.js";
+function p({
+  suspended: n
+}) {
+  const e = i(d), o = c(/* @__PURE__ */ new Set());
+  return f(() => {
+    if (!e)
+      return;
+    const s = o.current;
+    if (!n) {
+      s.forEach((t) => {
+        e.get(t)?.play();
+      }), s.clear();
+      return;
+    }
+    const a = new Set(e.keys());
+    e.keys().forEach((t) => {
+      const r = e.get(t);
+      r && !r.isPaused() && (r.pause(), s.add(t));
+    });
+    const u = () => {
+      e.keys().forEach((t) => {
+        if (a.has(t) || s.has(t))
+          return;
+        const r = e.get(t);
+        r && (r.pause(), s.add(t));
+      });
+    };
+    return e.subscribe(u);
+  }, [n, e]), null;
+}
+export {
+  p as CameraStreamsSuspensionController
+};

package/components/CameraStreams/types.d.ts

@@ -1,6 +1,5 @@
 import { ReactNode } from 'react';
 import { ChannelType } from '../VideoTimeLineSelector/types';
-import { VideoPlayerHandle } from '../VideoPlayer/types';
 /**
  * String identifier reused as the per-channel key. Mirrors `ChannelType['id']`
  * so consumers can index without conversion. A channel is one transport stream
@@ -265,6 +264,16 @@ export interface CameraStreamsStoreInitProps extends Omit<InitialCameraStreamsSt
 /** Provider props — init slice + React children. */
 export interface CameraStreamsProviderProps extends InitialCameraStreamsStoreProps {
     children: ReactNode;
+    /**
+     * Soft-suspend the provider while the subtree is hidden (e.g. behind an
+     * inactive tab kept alive via `display:none`). When it flips to `true` the
+     * playing clips are paused — freeing video decode — while their state, the
+     * store and the DOM stay intact; flipping back to `false` resumes exactly the
+     * clips that were playing. Idle/ended/user-paused players are left untouched.
+     * Defaults to `false` (no suspension). Tab-agnostic: callers map their own
+     * visibility (`suspended={!isActive}`).
+     */
+    suspended?: boolean;
 }
 /**
  * Public surface of `useCameraStreams()`. Selectors live on the headless hook
@@ -278,7 +287,7 @@ export interface UseCameraStreamsResult {
 }
 /**
  * Live playback status of one player, derived on demand from its
- * `VideoPlayerHandle`. Distinct from the FSM `phase` (which describes the
+ * `VideoPlayerControl`. Distinct from the FSM `phase` (which describes the
  * request lifecycle) — this reflects the `<video>` element transport state.
  */
 export interface CameraStreamPlaybackState {
@@ -317,8 +326,6 @@ export interface UseCameraStreamPlayersResult {
     snapshot(key: PlayerKey): string | null;
     /** Read the live playback status of one player, or `null` when not streaming. */
     getPlaybackState(key: PlayerKey): CameraStreamPlaybackState | null;
-    /** Escape hatch: the raw `VideoPlayerHandle` of one player, or `null`. */
-    getHandle(key: PlayerKey): VideoPlayerHandle | null;
 }
 /**
  * Compose a stable `PlayerKey` from its components. Centralised so producers

package/components/CameraStreams/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/components/CameraStreams/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/components/CameraStreams/types.ts"],"names":[],"mappings":"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"}

package/components/CameraStreams/useCameraStreamPlayers.d.ts

@@ -6,6 +6,10 @@ import { UseCameraStreamPlayersResult } from './types';
  * (`pause / mute / seek / fullscreen / snapshot`) of players that are already
  * streaming — without the consumer overriding the `phaseStreaming` slot.
  *
+ * Each registered player is a {@link VideoPlayerControl} — a thin adapter over
+ * the player's video.js v10 store — so every action below dispatches a store
+ * action under the hood.
+ *
  * Bulk-able mutations accept an optional `keys` array: omit it to act on every
  * registered player, or pass a subset to scope the action.
  *

package/components/CameraStreams/useCameraStreamPlayers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCameraStreamPlayers.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/components/CameraStreams/useCameraStreamPlayers.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAa,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAEvE;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,IAAI,4BAA4B,CAkErE"}
+{"version":3,"file":"useCameraStreamPlayers.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/components/CameraStreams/useCameraStreamPlayers.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAa,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAEvE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,IAAI,4BAA4B,CA+DrE"}

package/components/CameraStreams/useCameraStreamPlayers.js

@@ -1,13 +1,13 @@
-import { useContext as u, useMemo as n } from "react";
+import { useContext as u, useMemo as i } from "react";
 import { CameraStreamPlayersContext as o } from "./CameraStreamPlayersContext.js";
 function c() {
-  const r = u(o);
-  if (!r)
+  const s = u(o);
+  if (!s)
     throw new Error(
       "useCameraStreamPlayers must be used inside a <CameraStreamsProvider>."
     );
-  return n(() => {
-    const a = (e) => (e ?? r.keys()).map((s) => r.get(s)).filter((s) => s !== null);
+  return i(() => {
+    const a = (e) => (e ?? s.keys()).map((r) => s.get(r)).filter((r) => r !== null);
     return {
       pause(e) {
         a(e).forEach((t) => t.pause());
@@ -16,40 +16,37 @@ function c() {
         await Promise.all(a(e).map((t) => t.play()));
       },
       setMuted(e, t) {
-        a(t).forEach((s) => s.setMuted(e));
+        a(t).forEach((r) => r.setMuted(e));
       },
       toggleMuted(e) {
-        a(e).forEach((t) => t.setMuted(!t.getMuted()));
+        a(e).forEach((t) => t.setMuted(!t.isMuted()));
       },
       seek(e, t) {
-        a(t).forEach((s) => s.seek(e));
+        a(t).forEach((r) => r.seek(e));
       },
       setPlaybackRate(e, t) {
-        a(t).forEach((s) => s.setPlaybackRate(e));
+        a(t).forEach((r) => r.setPlaybackRate(e));
       },
       requestFullscreen(e) {
-        return r.get(e)?.requestFullscreen() ?? Promise.resolve();
+        return s.get(e)?.requestFullscreen() ?? Promise.resolve();
       },
       requestPictureInPicture(e) {
-        return r.get(e)?.requestPictureInPicture() ?? Promise.resolve();
+        return s.get(e)?.requestPictureInPicture() ?? Promise.resolve();
       },
       snapshot(e) {
-        return r.get(e)?.snapshot() ?? null;
+        return s.get(e)?.snapshot() ?? null;
       },
       /** Read the live mute/pause/live status of one player, or null when absent. */
       getPlaybackState(e) {
-        const t = r.get(e);
+        const t = s.get(e);
         return t ? {
-          isMuted: t.getMuted(),
+          isMuted: t.isMuted(),
           isPaused: t.isPaused(),
           isLive: t.isLive()
         } : null;
-      },
-      getHandle(e) {
-        return r.get(e);
       }
     };
-  }, [r]);
+  }, [s]);
 }
 export {
   c as useCameraStreamPlayers

package/components/VideoPlayer/VideoPlayer.d.ts

@@ -1,30 +1,37 @@
 import { VideoPlayerProps } from './types';
 /**
- * HLS-capable video player built on top of `video.js`. Pure wrapper around
- * the video.js lifecycle: no UI state for loading, error, or "no source" —
- * those concerns live one layer up (`@m4l/gclick/CameraStream`). When `src`
- * is null or empty the component returns `null`, so consumers are expected
- * to gate the mount based on their own state.
+ * HLS-capable video player built on video.js v10 (`@videojs/react`).
  *
- * Visually neutral — slot-based styling allows consumers to override the
- * root and the video wrapper via the M4L theme overrides
- * (`theme.components.M4LVideoPlayer.styleOverrides`).
+ * v10 is declarative and store-driven: a module-scope factory
+ * (`player.factory.ts`) yields a `Provider` + `Container` + `usePlayer`; this
+ * component mounts the provider once a source exists and renders the player
+ * inside it. There is no video.js `Player` object — playback is driven through
+ * the store, surfaced to consumers as a thin {@link VideoPlayerControl} handle.
  *
- * React 19 hooks used:
- * - `useEffectEvent` keeps every callback prop (`onPlayerReady`,
- *   `onPlayerError`, `onDurationChange`, …) out of the player-init effect's
- *   dependency array, so consumers can pass inline callbacks without forcing
- *   the player to be recreated on every render.
- * - `ref` is accepted as a regular prop (no `forwardRef` needed) and is wired
- *   to a `VideoPlayerHandle` via `useImperativeHandle`.
+ * Pure wrapper around the player lifecycle: no UI state for loading, error or
+ * "no source" — those live one layer up (`@m4l/gclick/CameraStream`). When
+ * `src` is null/empty the component returns `null` (unmounting the provider and
+ * tearing the player down), so consumers gate the mount based on their own
+ * state.
  *
- * Multi-instance robustness:
- * - Before initialising, the effect calls `videojs.getPlayer(videoElement)`
- *   and disposes any previous Player still attached to the same DOM node.
- *   Prevents the "Player already exists" warning when the effect re-runs
- *   (StrictMode double invoke, `mode` change, fast tab swap).
- * - On unmount, the previous `<video>` children are removed from the
- *   wrapper so a later remount cannot reuse a disposed node.
+ * Highlights:
+ * - **One composed v10 skin** — the chrome (controls, layout, poster, native
+ *   live button) is owned by `GclickVideoSkin`, assembled from the dependency's
+ *   building blocks + official `media-*` classes (no custom per-control CSS).
+ * - **Live ↔ VOD in one skin** — while the manifest is live the control bar
+ *   shows the native `<LiveButton>` and hides the seek region; once it ends
+ *   (`#EXT-X-ENDLIST` → `streamType: on-demand`) the seek bar + time displays
+ *   appear. Driven by `isLive`, so the skin never swaps and the `<video>` is
+ *   never remounted (no reload). See `GclickVideoSkin`.
+ * - **Signed-cookie HLS** — the `<video>` is configured so every manifest +
+ *   segment request carries the CloudFront cookies (see `hlsConfig.ts`).
+ * - **Flat frame** — only one styling override on our side: the skin's
+ *   `--media-border-radius` is set to `0` so the chrome is edge-to-edge and
+ *   couples to the parent surface (see `VideoPlayer.styles.ts`).
+ * - **Poster** — `poster` is forwarded to the skin's poster slot (e.g. a cloud
+ *   recording snapshot).
+ * - **React 19 ref-as-prop** — `ref` resolves to a {@link VideoPlayerControl}
+ *   without `forwardRef`.
  */
-export declare function VideoPlayer({ src, mode, className, onPlayerReady, onPlayerError, onLoadedMetadata, onDurationChange, onPlay, onPause, onEnded, onWaiting, onStalled, ref, }: VideoPlayerProps): import("@emotion/react/jsx-runtime").JSX.Element | null;
+export declare function VideoPlayer({ src, mode, poster, className, onReady, onPlay, onPause, onEnded, onWaiting, onError, onDurationChange, ref, }: VideoPlayerProps): import("@emotion/react/jsx-runtime").JSX.Element | null;
 //# sourceMappingURL=VideoPlayer.d.ts.map

package/components/VideoPlayer/VideoPlayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VideoPlayer.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/components/VideoPlayer/VideoPlayer.tsx"],"names":[],"mappings":"AAcA,OAAO,4BAA4B,CAAC;AAYpC,OAAO,KAAK,EAGV,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CAAC,EAC1B,GAAG,EACH,IAAa,EACb,SAAS,EACT,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,MAAM,EACN,OAAO,EACP,OAAO,EACP,SAAS,EACT,SAAS,EACT,GAAG,GACJ,EAAE,gBAAgB,2DAoVlB"}
+{"version":3,"file":"VideoPlayer.d.ts","sourceRoot":"","sources":["../../../../../../packages/gclick/src/components/VideoPlayer/VideoPlayer.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,WAAW,CAAC,EAC1B,GAAG,EACH,IAAa,EACb,MAAM,EACN,SAAS,EACT,OAAO,EACP,MAAM,EACN,OAAO,EACP,OAAO,EACP,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,GAAG,GACJ,EAAE,gBAAgB,2DA4BlB"}