ogplayer 0.1.2 → 0.2.0

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

@@ -74,6 +74,15 @@ export interface OGUIConfig {
      * 5000 renderer, 6000 live, 9000 unknown). Return null/undefined for the
      * SDK default. The error object still reaches onError unchanged. */
     errorMessageProvider?: (error: OGPlayerError) => string | null | undefined;
+    /**
+     * Your own error UI, rendered ON the player surface when a fatal playback
+     * error occurs (embedded and fullscreen alike). Return an element; the SDK
+     * mounts it exactly when the built-in overlay would show, clears it on
+     * retry/new load, and skips the built-in overlay entirely (so
+     * errorMessageProvider / showRetryButton / retryButtonLabel don't apply).
+     * The retry callback runs player.retry() plus the SDK's housekeeping.
+     */
+    renderErrorOverlay?: (error: OGPlayerError, retry: () => void) => HTMLElement;
 }
 export declare const defaultUIConfig: OGUIConfig;
 /** Every control flag off — headless chrome in one call (mobile parity:

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

@@ -0,0 +1,77 @@
+import { type OGVerticalFeedConfig, type OGVerticalFeedItem } from "../core/vertical-feed.js";
+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
+ * surface from `<og-player>` on purpose: portrait-only, no fullscreen or
+ * rotation API, its own minimal chrome.
+ *
+ * The element owns a pool of at most three engine instances (see
+ * `VerticalFeedPlayerPool`); the host supplies `items`, listens to
+ * `og-nearend`, and appends — the SDK never fetches feed data.
+ *
+ * Events (CustomEvent detail in braces):
+ *   og-activeitemchanged {index, item} · og-nearend {remaining} ·
+ *   og-itemskipped {index, reason} · og-itemerror {index, error} ·
+ *   og-analytics {event} · og-itemdoubletapped {index, item} ·
+ *   og-mutedfallback {}
+ */
+export declare class OGVerticalFeedElement extends HTMLElement {
+    private root;
+    private pool;
+    private itemsValue;
+    private cfg;
+    private mutedValue;
+    private intendedPage;
+    private observer;
+    private resizeObserver;
+    private tickTimer;
+    private itemErrors;
+    private secondary;
+    private secondaryFor;
+    private secondaryDetach;
+    private singleTapTimer;
+    private scrubbing;
+    private mounted;
+    /** Host hook: replace the default "Sponsored" chip (level-3 slot). */
+    sponsoredBadge: ((item: OGVerticalFeedItem) => HTMLElement) | null;
+    /** Host hook: replace the whole error surface on a failed page. */
+    errorOverlay: ((error: OGPlayerError, retry: () => void) => HTMLElement) | null;
+    /** When set, single-tap pause waits ~300 ms for double-tap disambiguation
+     *  (the SDK attaches no meaning to the double tap — that's the host's). */
+    onItemDoubleTapped: ((index: number, item: OGVerticalFeedItem) => void) | null;
+    constructor();
+    get items(): OGVerticalFeedItem[];
+    set items(v: OGVerticalFeedItem[]);
+    get config(): OGVerticalFeedConfig;
+    set config(c: Partial<OGVerticalFeedConfig>);
+    /** Feed-level mute — sticky across items, applied to the audible half. */
+    get muted(): boolean;
+    set muted(v: boolean);
+    /** Index of the item currently on screen. */
+    get currentIndex(): number;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private mount;
+    private remount;
+    private teardown;
+    private banded;
+    private renderPages;
+    private makeRegion;
+    /** Re-parent pool `<video>` elements into their pages' video regions. */
+    private attachSurfaces;
+    private renderActiveChrome;
+    private railButton;
+    /** State-derived feedback + hairline progress, every 250 ms. */
+    private tick;
+    private manageSecondary;
+    private syncSecondaryAudio;
+    private releaseSecondary;
+    private settle;
+    private scrollToPage;
+    private syncWatermark;
+    private dispatch;
+    private q;
+}
+export declare function defineOGVerticalFeedElement(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ogplayer",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "OGPlayer web SDK — one video player API across Android, iOS and the web.",
   "type": "module",
   "main": "./dist/ogplayer.js",
@@ -23,7 +23,7 @@
     "smoke": "node scripts/smoke.mjs"
   },
   "dependencies": {
-    "hls.js": "^1.5.0"
+    "hls.js": "^1.7.1"
   },
   "devDependencies": {
     "esbuild": "^0.23.0",