ogplayer 1.2.1 → 1.3.1

package/dist/ui/icons.d.ts

@@ -1,6 +1,6 @@
 /**
- * Control glyphs — the EXACT vector paths from the Android SDK's
- * `og_ic_*.xml` drawables (24×24 viewport, stroked, round caps/joins), so
+ * Control glyphs — the SDK's vector paths (24×24 viewport, stroked, round
+ * caps/joins), so
  * the three platforms render identical iconography. `filled` paths use fill
  * instead of stroke (play/pause/volume body).
  */

package/dist/ui/keymap.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Keyboard shortcuts for `<og-player>` — the map from `KeyboardEvent.key` to
+ * a player action, kept DOM-free so the resolution is unit-testable.
+ * Desktop keyboards only; TV remotes are a separate concern and are not
+ * wired through here.
+ *
+ * The default map is the one viewers already know from the big video sites:
+ * Space/K play-pause, ←/→ and J/L seek by the player's seek increment,
+ * ↑/↓ volume, M mute, F fullscreen, C subtitles, 0–9 jump to 0–90 % (VOD),
+ * Home/End start/end (live edge on live), Esc leaves fullscreen.
+ */
+export type OGKeyAction = "playPause" | "seekBackward" | "seekForward" | "volumeUp" | "volumeDown" | "toggleMute" | "toggleFullscreen" | "exitFullscreen" | "toggleSubtitles" | "seekToStart" | "seekToEnd" | "seekToPercent";
+/** Per-key overrides merged over {@link DEFAULT_KEYMAP}: `null` removes a
+ *  key, an action adds or remaps one. Keys are `KeyboardEvent.key` values;
+ *  single characters are matched case-insensitively. */
+export type OGKeymap = Partial<Record<string, OGKeyAction | null>>;
+export declare const DEFAULT_KEYMAP: Readonly<Record<string, OGKeyAction>>;
+/** Single characters compare case-insensitively ("M" and "m" are one key);
+ *  named keys ("ArrowLeft", "Home") are used as they come. */
+export declare function normalizeKey(key: string): string;
+/** The effective map: defaults, then the host's overrides on top. Never
+ *  mutates {@link DEFAULT_KEYMAP}. */
+export declare function mergeKeymap(overrides?: OGKeymap): Record<string, OGKeyAction>;
+export interface KeyLike {
+    key: string;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    altKey?: boolean;
+}
+export interface ResolvedKey {
+    action: OGKeyAction;
+    /** 0–9 for `seekToPercent` (the digit key that was pressed). */
+    digit?: number;
+}
+/**
+ * Which action, if any, a key press means under `keymap`. Returns `null` for
+ * keys that are not ours — including every modifier chord (Ctrl/Cmd/Alt),
+ * which stays with the browser and the page. `seekToPercent` only resolves
+ * from a digit key, because the digit is the target.
+ */
+export declare function resolveKeyAction(e: KeyLike, keymap: Record<string, OGKeyAction>): ResolvedKey | null;

package/dist/ui/og-player.d.ts

@@ -1,15 +1,16 @@
 import type { OGPlayer } from "../core/player.js";
 import type { OGPlayerError } from "../core/types.js";
 import { type OGControlColors, type OGControlDimens } from "./tokens.js";
+import { type OGKeymap } from "./keymap.js";
 /** A host-supplied icon button rendered left of the (future) cast position —
- * icon-only, max 8, part of the chrome (mirrors Android/iOS `CustomAction`). */
+ * icon-only, max 8, part of the chrome (. */
 export interface CustomAction {
     /** Inline SVG markup (24×24 recommended); rendered with the chrome tint. */
     svg: string;
     accessibilityLabel?: string;
     onClick: () => void;
 }
-/** Per-control visibility + behavior — Android's `OGUiConfig` counterpart. */
+/** Per-control visibility + behavior. */
 export interface OGUIConfig {
     showProgressBar: boolean;
     showTimeLabels: boolean;
@@ -101,16 +102,28 @@ export interface OGUIConfig {
     /** Extra inline CSS for the card (same contract as `titleStyle`), e.g.
      *  "background:#F6C445E6;color:#131313;font-family:Georgia,serif". */
     upNextStyle?: string;
+    /** Keyboard shortcuts while the player has focus (default true): Space/K
+     *  play-pause, ←/→ and J/L seek by the seek increment, ↑/↓ volume, M mute,
+     *  F fullscreen, C subtitles on/off, 0–9 jump to 0–90 % (VOD), Home/End
+     *  start/end (live edge on live), Esc leaves fullscreen. Seek keys obey
+     *  the live rules and stay inert during ads. `false` = the element handles
+     *  no keys at all (not even Space) — the host owns the keyboard. */
+    keyboardShortcuts: boolean;
+    /** Per-key overrides merged over the default map: `{ m: null }` removes
+     *  mute, `{ p: "playPause" }` adds a key, `{ ArrowUp: "seekForward" }`
+     *  remaps one. Keys are KeyboardEvent.key values; letters are
+     *  case-insensitive. Unmapped keys pass through to the page. */
+    keymap?: OGKeymap;
 }
 export declare const defaultUIConfig: OGUIConfig;
 /** Every control flag off — headless chrome in one call (mobile parity:
- * `hideAllControls()`). Title/ratings stay, exactly like Android/iOS. */
+ * `hideAllControls()`). Title/ratings stay,. */
 export declare function hidingAllControls(overrides?: Partial<OGUIConfig>): Partial<OGUIConfig>;
 /**
  * `<og-player>` — the OGPlayer UI as a framework-agnostic custom element
  * (works in plain HTML, React, Vue, Angular alike). Attach an `OGPlayer`
  * engine via the `player` property; overlays (watermarks, logos) go into the
- * nine named slots (`slot="top-end"` …), mirroring the Android/iOS
+ * nine named slots (`slot="top-end"` …),
  * `OverlaySlot` system including the clearance choreography.
  */
 export declare class OGPlayerElement extends HTMLElement {
@@ -119,6 +132,8 @@ export declare class OGPlayerElement extends HTMLElement {
     private root;
     private controlsVisible;
     private hideTimer;
+    /** Whether the current ad's provider draws its own layer over the video (IMA). */
+    private currentAdRendersUi;
     /** Where the last deliberate tap-to-hide happened; gates hover-raise. */
     private hidePoint;
     /** Pointer type of the most recent pointerdown on the stage; "" until one lands. */
@@ -143,6 +158,8 @@ export declare class OGPlayerElement extends HTMLElement {
     constructor();
     get player(): OGPlayer | null;
     set player(p: OGPlayer | null);
+    /** Subtitle track the C key switched off, restored on the next press. */
+    private lastTextTrackId;
     get config(): OGUIConfig;
     set config(c: Partial<OGUIConfig>);
     connectedCallback(): void;
@@ -171,7 +188,7 @@ export declare class OGPlayerElement extends HTMLElement {
     private maybeShowOnceOverlays;
     private ratingNode;
     /** While the rating row is shown, the top-end button row drops below it
-     * and top-row overlays clear both — the Android/iOS choreography. */
+     * and top-row overlays clear both. */
     private setRatingRow;
     private applyOverlayInsets;
     private showControls;
@@ -188,8 +205,9 @@ export declare class OGPlayerElement extends HTMLElement {
     private paintAdCues;
     private syncPeriodic;
     /** Break-mode UI: the SDK yields the chrome to the ad layer and draws its
-     * own yellow bar + AD chip + centered transport (mobile parity — IMA
-     * renders its own skip/clickthrough on top of its layer). */
+     * own yellow bar + play/pause + AD chip (mobile parity — IMA renders its own
+     * skip/clickthrough on top of its layer). Nothing sits over a playing ad:
+     * the bar button is the transport for the whole break. */
     private syncAdUi;
     private syncWatermark;
     /** Same markup as the template's `.watermark` — used when the node was removed from the open shadow root. */
@@ -202,6 +220,11 @@ export declare class OGPlayerElement extends HTMLElement {
      * a "starts in fullscreen" flow calls this from its start button. */
     enterFullscreen(): Promise<void>;
     exitFullscreen(): void;
+    /** One keyboard shortcut → one player action. Seek keys follow the live
+     *  rules (nothing on edge-locked LIVE, window-bound on LIVE_DVR, End = the
+     *  live edge) and stay inert during ads; volume, mute and fullscreen work
+     *  everywhere. Actions that change what the viewer sees raise the chrome. */
+    private runKeyAction;
     private toggleFullscreen;
     private detach;
 }

package/dist/ui/og-vertical-feed.d.ts

@@ -2,8 +2,7 @@ import { type OGVerticalFeedConfig, type OGVerticalFeedItem } from "../core/vert
 import type { OGPlayerError } from "../core/types.js";
 /**
  * `<og-vertical-feed>` — a swipeable, full-screen vertical video feed built
- * on the OGPlayer engine; the web counterpart of the Android/iOS
- * `OGVerticalFeedView`, with the same names and semantics. A separate
+ * on the OGPlayer engine. A separate
  * surface from `<og-player>` on purpose: portrait-only, no fullscreen or
  * rotation API, its own minimal chrome.
  *

package/dist/ui/tokens.d.ts

@@ -1,7 +1,5 @@
 /**
- * Design tokens — Android's `OGControlColors` / `OGControlDimens`,
- * token-for-token (dp → px at CSS-pixel scale, which is the same unit
- * philosophy the Android/iOS SDKs use).
+ * Design tokens — colours and dimensions in CSS pixels.
  */
 export interface OGControlColors {
     foreground: string;
@@ -47,5 +45,5 @@ export interface OGControlDimens {
     adCueMarkerSize: number;
 }
 export declare const embeddedDimens: OGControlDimens;
-/** Fullscreen step-up (Android `forFullscreen()`). */
+/** Fullscreen step-up. */
 export declare const fullscreenDimens: OGControlDimens;

package/dist/ui/watermark.d.ts

@@ -8,8 +8,7 @@
  * throw on the missing node and take every other overlay down with it, and
  * (2) while the player is unlicensed the mark is re-created on the next sync,
  * so a removal lasts only until the next player event — the same standing as
- * Android/iOS, where the mark is a composable / SwiftUI view with no
- * addressable instance to remove. Tampering with the mark is a terms-of-use
+ * native views, where the mark has no addressable instance to remove. Tampering with the mark is a terms-of-use
  * matter either way (terms §3); this keeps the SDK's own behaviour consistent.
  */
 export interface WatermarkHost {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ogplayer",
-  "version": "1.2.1",
+  "version": "1.3.1",
   "description": "OGPlayer video player for the browser — an <og-player> web component with HLS, DRM (Widevine, PlayReady, FairPlay), Google IMA ads, playlists and themeable controls.",
   "type": "module",
   "main": "./dist/ogplayer.js",