feat(react): setup react player api

[mihar-22]

Closes #367

Summary

Add the React Player API with createPlayer() factory, player context, and media primitives. This provides typed store access via usePlayer() hook with selector support, and standalone-capable Video/Audio components.

Changes

• Add PlayerContextProvider, usePlayerContext for base player context
• Add usePlayer() with selector overload, useMedia(), useMediaRegistration() hooks
• Add Container component that attaches media to store
• Add createPlayer({ features }) factory returning typed Provider, Container, usePlayer
• Update Video component with forwardRef, works standalone (no error outside Provider)
• Add Audio component mirroring Video implementation
• Remove deprecated createStore/useStoreContext from @videojs/store/react
• Update @videojs/store/react to export only useStore, useSelector

Implementation details

usePlayer behavior:

• Base context (context.tsx): loose types for UI primitives — UnknownStore, UnknownState
• Typed (createPlayer result): full types for app code — FeatureStore<Features>, UnionFeatureState<Features>
• Without selector: returns store (no subscription, direct access to methods)
• With selector: returns selected state (subscribes via shallowEqual)

Video/Audio standalone: useMediaRegistration() returns undefined outside Provider, components just render native elements without error.

Container: Uses forwardRef + useComposedRefs, attaches { media, container } to store when media is set.

Testing

pnpm -F @videojs/react test
pnpm -F @videojs/store test
pnpm typecheck
pnpm lint

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
vjs-10-website	Skipped		Feb 2, 2026 3:07am