\n {ready ? `${currentTime.toFixed(1)} / ${duration.toFixed(1)} (${isPlaying ? 'playing' : 'paused'})` : 'Loading…'}\n
\n {error &&{error.message}
}\n{{ currentTime.toFixed(1) }} / {{ duration.toFixed(1) }} ({{ isPlaying ? 'playing' : 'paused' }})
\n{$currentTime.toFixed(1)} / {$duration.toFixed(1)} ({$isPlaying ? 'playing' : 'paused'})
\n{/if}\n```\n\nAll three adapters auto-include `timeUpdateExtension` and `durationChangeExtension` and set `isolate: true` so the consumer's container ref stays stable across re-renders.\n\n## Content Security Policy\n\nAdd the following directives:\n\n```\nscript-src https://www.youtube.com https://s.ytimg.com\nframe-src https://www.youtube.com https://www.youtube-nocookie.com\n```\n\nIf you only use `privacyMode: 'enhanced'`, you may omit `https://www.youtube.com` from `frame-src`.\n\n## SSR / Next.js\n\nThe constructor is SSR-safe — no DOM access until first call into the player. `whenReady()` rejects with `EnvironmentError` in non-browser environments, which is what you want for failure-fast diagnostics.\n\nFor the App Router, render the player in a client-only chunk:\n\n```tsx\n'use client';\nimport { useYTEmbed } from '@bogdanrn/yt-embed/react';\n\nexport function YouTubePlayer({ videoId }: { videoId: string }) {\n const { containerRef } = useYTEmbed(videoId);\n return ;\n}\n```\n\n```tsx\n// In the server component\nimport dynamic from 'next/dynamic';\nconst YouTubePlayer = dynamic(() => import('./player').then((m) => m.YouTubePlayer), { ssr: false });\n```\n\n## Cleanup contract\n\n- `destroy()` is idempotent.\n- After `destroy()`, every in-flight wrapper promise rejects with `PlayerDestroyedError`. Pre-ready queued calls reject with `PlayerDestroyedError('Player destroyed before call')`.\n- A `signal.abort()` rejects in-flight calls with `DOMException('Aborted', 'AbortError')` and triggers `destroy()`. Calling `destroy()` afterwards is a no-op.\n- `whenReady()` rejects with `PlayerDestroyedError` if destroyed before init, `PlayerInitError` on timeout, or `EnvironmentError` in SSR.\n\nUse `e.name === 'AbortError'` for caller aborts; `instanceof PlayerInitError` for timeouts; `instanceof PlayerDestroyedError` for destroy-during-init; `instanceof EnvironmentError` for SSR mismatches.\n\n## Multiple concurrent players\n\nThe IFrame API exposes a single `window.onYouTubeIframeAPIReady` slot. This package handles that internally — multiple `YTEmbed` instances created in the same tick share one script load and each receive `onReady` independently.\n\n```ts\nconst a = new YTEmbed(elA, { videoId: 'M7lc1UVf-VE' });\nconst b = new YTEmbed(elB, { videoId: 'tgbNymZ7vqY' });\nawait Promise.all([a.whenReady(), b.whenReady()]);\n```\n\n## API Reference\n\nThe full TypeDoc-generated reference for every exported symbol lives at [`docs/api/README.md`](./docs/api/README.md). Regenerate it with `pnpm docs:build` (typedoc + `typedoc-plugin-markdown`).\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n","readmeFilename":"README.md"}