@1001tv/manara 0.0.3-beta.0

package/dist/components/VideoPlayer/hooks/useMergedRef/useMergedRef.d.ts

@@ -0,0 +1,3 @@
+import { Ref } from 'react';
+/** Returns a callback ref that fans a DOM node out to every ref passed in. */
+export declare const useMergedRef: <T>(...refs: Array<Ref<T> | null | undefined>) => (node: T | null) => void;

package/dist/components/VideoPlayer/hooks/useNextEpisodeCountdown/useNextEpisodeCountdown.d.ts

@@ -0,0 +1,3 @@
+import { TextActionsConfig } from '../../TrackFrame/TrackFrame.types';
+/** Ticks `nextEpisode.countdownSec` down once per second and fires `onClick` exactly once at 0 (StrictMode-safe). Returns a derived `TextActionsConfig` with the live count; consumer should clear `nextEpisode` after the auto-advance. */
+export declare const useNextEpisodeCountdown: (textActions?: TextActionsConfig) => TextActionsConfig | undefined;

package/dist/components/VideoPlayer/hooks/usePlaybackPulse/usePlaybackPulse.d.ts

@@ -0,0 +1,3 @@
+import { PlaybackPulseKey, UsePlaybackPulseOptions } from './usePlaybackPulse.types';
+/** Watches Space/K · ←/→ and returns the matching playback-button key during a short pulse window so the cluster can flash the keyboard-activation visual. Visual-only — runs alongside `usePlayerShortcuts`. */
+export declare const usePlaybackPulse: (options?: UsePlaybackPulseOptions) => PlaybackPulseKey | null;

package/dist/components/VideoPlayer/hooks/usePlaybackPulse/usePlaybackPulse.types.d.ts

@@ -0,0 +1,11 @@
+import { RefObject } from 'react';
+/** One of the three center-cluster playback buttons that can flash on keyboard activation. */
+export type PlaybackPulseKey = 'playPause' | 'skipBack' | 'skipForward';
+export interface UsePlaybackPulseOptions {
+    /** When provided, the listener only fires while focus is inside this container. */
+    containerRef?: RefObject<HTMLElement | null>;
+    /** Visual pulse duration in ms. @default 280 */
+    pulseMs?: number;
+    /** @default true */
+    enabled?: boolean;
+}

package/dist/components/VideoPlayer/hooks/usePlayerShortcuts/usePlayerShortcuts.d.ts

@@ -0,0 +1,6 @@
+import { UsePlayerShortcutsOptions } from './usePlayerShortcuts.types';
+/**
+ * Player keyboard shortcuts — global keydown listener, opt-in callbacks.
+ * Pass only the actions you care about; unhandled keys pass through unchanged.
+ */
+export declare const usePlayerShortcuts: (options: UsePlayerShortcutsOptions) => void;

package/dist/components/VideoPlayer/hooks/usePlayerShortcuts/usePlayerShortcuts.types.d.ts

@@ -0,0 +1,23 @@
+import { RefObject } from 'react';
+export interface UsePlayerShortcutsOptions {
+    /** @default true */
+    enabled?: boolean;
+    /** When provided, shortcuts only fire while focus is inside this container. Otherwise the listener is global. */
+    containerRef?: RefObject<HTMLElement | null>;
+    /** Space, K */
+    onPlayPause?: () => void;
+    /** ← / → — caller computes the new time from the delta. */
+    onSeekBy?: (deltaSeconds: number) => void;
+    /** ↑ / ↓ — caller computes the new volume from the delta. */
+    onVolumeBy?: (deltaPercent: number) => void;
+    /** M */
+    onMute?: () => void;
+    /** F */
+    onFullscreen?: () => void;
+    /** 0–9, Home, End — percent of duration. */
+    onSeekToPercent?: (percent: number) => void;
+    /** @default 10 (seconds) */
+    seekStep?: number;
+    /** @default 5 (percent) */
+    volumeStep?: number;
+}

package/dist/components/VideoPlayer/index.d.ts

@@ -0,0 +1,9 @@
+export { VideoPlayer } from './VideoPlayer/VideoPlayer';
+export type { VideoPlayerProps } from './VideoPlayer/VideoPlayer.types';
+export { PlayerUI } from './PlayerUI/PlayerUI';
+export type { PlayerUIProps } from './PlayerUI/PlayerUI.types';
+export { ScrollingCard } from './ScrollingCard/ScrollingCard';
+export type { ScrollingCardProps } from './ScrollingCard/ScrollingCard.types';
+export { formatPlayerTime } from './formatPlayerTime';
+export { usePlayerShortcuts } from './hooks/usePlayerShortcuts/usePlayerShortcuts';
+export type { UsePlayerShortcutsOptions } from './hooks/usePlayerShortcuts/usePlayerShortcuts.types';

package/dist/components/VideoPlayer/playerStoryFixtures.d.ts

@@ -0,0 +1,36 @@
+import { MenusConfig } from './TrackFrame/TrackFrame.types';
+export declare const POSTER = "https://images.unsplash.com/photo-1574267432553-4b4628081c31?w=1440&h=810&fit=crop";
+export declare const QUALITY_OPTIONS: {
+    id: string;
+    label: string;
+}[];
+export declare const SPEED_OPTIONS: {
+    id: string;
+    label: string;
+}[];
+export declare const AUDIO_OPTIONS: {
+    id: string;
+    label: string;
+}[];
+export declare const SUBTITLE_TRACKS: ({
+    id: string;
+    label: string;
+    isClosedCaption?: undefined;
+} | {
+    id: string;
+    label: string;
+    isClosedCaption: boolean;
+})[];
+export declare const MenuHeader: ({ label }: {
+    label: string;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const MenuRow: ({ label, isActive }: {
+    label: string;
+    isActive?: boolean;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const episodesMenu: import("react/jsx-runtime").JSX.Element;
+export type LogAction = (name: string) => () => void;
+/** Factory for a `logAction(name)` callback prefixed with the story scope. */
+export declare const createLogAction: (scope: string) => LogAction;
+/** Fully-controlled side-menu config: every selection/toggle holds its own state so the dropups visibly update (checkmarks move, Auto Play flips) during QA. */
+export declare const useInteractiveMenus: (withEpisodes: boolean, log: LogAction) => MenusConfig;

package/dist/hooks/useDragGesture/useDragGesture.d.ts

@@ -0,0 +1,9 @@
+import { RefObject } from 'react';
+import { UseDragGestureOptions } from './useDragGesture.types';
+/**
+ * Pointer drag gesture detector. Mouse is always tracked; touch is opt-in via
+ * `includeTouch`. Toggles `data-dragging` on the element for styling, and
+ * swallows the trailing click past `clickThreshold` so descendants don't
+ * activate on drag-release. Move callbacks are coalesced to one per frame.
+ */
+export declare const useDragGesture: <T extends HTMLElement>({ enabled, includeTouch, clickThreshold, onDragStart, onDragMove, onDragEnd, }?: UseDragGestureOptions<T>) => RefObject<T | null>;

package/dist/hooks/useDragGesture/useDragGesture.types.d.ts

@@ -0,0 +1,15 @@
+/** Options for the `useDragGesture` hook. */
+export interface UseDragGestureOptions<T extends HTMLElement> {
+    /** Disable all gesture handling. @default true */
+    enabled?: boolean;
+    /** Listen for touch events too. When false, touch falls through to native gestures (e.g. inertial scroll). @default false */
+    includeTouch?: boolean;
+    /** Pixel distance past which the trailing click is suppressed. @default 5 */
+    clickThreshold?: number;
+    /** Fired on pointer-down (left mouse button or first touch). */
+    onDragStart?: (element: T) => void;
+    /** Fired with the latest X delta on each paint frame during the drag (rAF-batched). */
+    onDragMove?: (deltaX: number, element: T) => void;
+    /** Fired on release. `deltaX` is the final X offset; `distance` is the max absolute delta seen during the drag. */
+    onDragEnd?: (deltaX: number, distance: number, element: T) => void;
+}