@gentomiyano/optimized-web-audio-player 0.2.3 → 0.3.0

package/README.md

@@ -1,216 +1,237 @@
-# Optimized Web Audio Player
-
-Consumer-neutral Music Player package published as
-`@gentomiyano/optimized-web-audio-player`.
-
-## MVP status
-
-The standalone Player MVP was accepted on 2026-08-01. The accepted scope
-includes the framework-independent Core, reusable React Runtime and UI,
-Compact / Wide / Detailed / Podcast / Mini views, Queue, Debug customization,
-local-media Showcase tooling, Media Session integration, responsive mobile
-review, and the media-delivery boundary contract.
-
-The tested iOS device continued playback in the background, during sleep, and
-on the Lock Screen. Lock Screen Previous / Next and Seek worked, and starting
-audio in another application interrupted the Player as expected. iOS uses the
-continuity-first native HTML media path by default; fade timing is not
-perceptible there and is an accepted MVP platform limitation. Narrow Compact
-and Mini layouts, including Global Mini, omit their in-player volume control
-because iOS owns device output volume.
-
-This acceptance does not connect a consumer application or production media
-origin, and it is not a claim of identical behavior across every iOS version,
-browser, Bluetooth route, or device.
-
-## WP-07 consumer integration foundation
-
-The production React Runtime, UI, CSS, and consumer queue builder now have
-explicit package entry points. A consumer can mount one empty
-`PlayerProvider` in its application shell, map authorized public media through
-its own Host Adapter, and build collection, selection, or page-order queues
-without copying Player source.
-
-Official Website and Timeline are not changed in this phase. Protected-URL
-refresh and the first consumer connection remain explicit checkpoints. See
-`docs/WP-07-CONSUMER-INTEGRATION-FOUNDATION.md`.
-
-The public npm registry, scoped package name, and release workflow are fixed.
-Initial npm publication still requires the scope owner's authentication.
-Release and consumer pinning rules are documented in `docs/RELEASING.md`.
-
-## PLAYER-UI-CONTRACT-01 Bound Compact
-
-Version 0.2.3 makes the occurrence-bound inline Player use the standard
-Compact visual implementation. `CompactPlayer` and `BoundCompactPlayerView`
-now share one surface, metadata grid, waveform signal, seek overlay, tokens,
-and container-query behavior; the former `player-bound-compact` surface and
-its separate active panel are removed.
-
-The React API and playback semantics are unchanged. An inactive occurrence
-shows its own metadata at zero and activates its context only on Play. The
-active occurrence exposes global Play / Pause, time, and seek while the
-existing Global Mini continues to use the same Store and audio element. See
-`docs/PLAYER-UI-CONTRACT-01-BOUND-COMPACT.md`.
-
-## WP-04.4 SSR-transparent Provider
-
-Version 0.2.2 renders consumer children inside the same Player Context from
-server rendering through hydration and Runtime readiness. `usePlayer()`
-exposes `runtimeStatus` as `pending` or `ready`; pending state uses an inert,
-SSR-safe Store bridge and never creates browser audio infrastructure.
-
-`BoundCompactPlayer` renders its occurrence metadata while pending. Runtime
-attachment updates the shared external Store without replacing or remounting
-the consumer subtree. The built-package smoke now performs server rendering,
-hydration, duplicate-ID, stable-sentinel, shared Mini Player, and single-audio
-checks. See `docs/WP-04.4-SSR-TRANSPARENT-PROVIDER.md`.
-
-## WP-04.3 React package boundary
-
-Version 0.2.1 keeps React Context consumers in the `/react` entrypoint and
-exports props-only views from `/ui`. Import `PlayerProvider`, `usePlayer`,
-`useBoundPlayer`, and `BoundCompactPlayer` from `/react`; import
-`BoundCompactPlayerView`, `MiniPlayer`, and the other pure views from `/ui`.
-
-The release check packs the built package, installs that tarball into an empty
-consumer, renders a bound inline Player with a shared Mini Player, and verifies
-one Store, one active item, and one audio element. See
-`docs/WP-04.3-REACT-BOUNDARY.md`.
-
-## WP-04.2 playback contexts and bound inline players
-
-Version 0.2.0 adds consumer-neutral `manual-history` and `ordered-queue`
-playback contexts. Contexts change only through an explicit
-`activateContext` command; rerendering or navigating while the application
-shell retains `PlayerProvider` does not replace the active context.
-
-`manual-history` records only explicitly played occurrences, never advances
-on natural end, and supports Previous / Next only inside the recorded session
-history. `ordered-queue` keeps normal queue navigation, natural advancement,
-shuffle, and repeat behavior. Queue updates preserve playback when the same
-`queueItemId` and source descriptor remain selected.
-
-Consumers can use `useBoundPlayer` or `BoundCompactPlayer` to bind an inline
-control to one queue occurrence without creating another audio element or
-store. See `docs/WP-04.2-PLAYBACK-CONTEXT.md` for contracts and integration
-examples.
-
-## WP-06 debug local media import
-
-The standalone Showcase has a dev-only Local Media panel for dropping WAV,
-MP3, JPG/JPEG, PNG, and WebP files. Multi-file audio drops become a temporary
-Queue in drop order. Metadata overrides, artwork switching, track-number
-sorting, duplicate policy, re-read, reorder, delete, clear, and cancellable
-waveform analysis remain in tab memory only.
-
-No local file, metadata, filename, or object URL is sent, logged, persisted, or
-written back. Reloading clears the import. Audio and artwork object URLs are
-reference-counted, reused for duplicate identities, and revoked after the last
-item is removed, on clear, or when the Showcase unmounts.
-
-The parser and UI live only under `showcase/local-media/**`. They are not
-package exports or `tsup` entries. `pnpm build` scans every production
-JavaScript output for WP-06 markers and fails if the debug importer leaks into
-the package. See `docs/WP-06-DEBUG-MEDIA-IMPORT.md` for format coverage,
-limitations, and the manual checkpoint.
-
-## WP-05 background playback checkpoint
-
-The standalone Showcase now integrates Media Session metadata, playback and
-position state, and OS action handlers. Music exposes play, pause, stop,
-Previous, Next, and seek-to. Podcast additionally exposes configurable skip
-backward and forward actions. Every handler delegates to the existing
-`PlayerCommands`; initial queue load remains non-autoplay.
-
-`audioMode=auto` keeps Web Audio fades on non-iOS browsers and uses the native
-HTMLAudioElement path on iPhone/iPadOS, prioritizing background continuity over
-fades. Real-device comparison modes are:
-
-- `http://127.0.0.1:4274/?audioMode=web-audio`
-- `http://127.0.0.1:4274/?audioMode=html-media`
-
-Double-click `start-player-showcase-device.cmd` for same-LAN iPhone testing,
-then replace the host with this computer's private LAN IP. The original
-`start-player-showcase.cmd` remains the loopback-only desktop launcher.
-`start-player-showcase-mobile.cmd` is an equivalent mobile-review launcher.
-The Showcase also has a `Mobile preview` toggle; `?preview=mobile` opens the
-same constrained review shell directly on desktop.
-
-Automated verification and the accepted device observations are recorded in
-`docs/WP-05A-BACKGROUND-PLAYBACK-FOUNDATION.md`. Broader device/version,
-Bluetooth, and production-consumer claims still require their own acceptance
-record.
-
-## WP-03 runtime showcase
-
-Double-click `start-player-showcase.cmd` to open the standalone Showcase at
-`http://127.0.0.1:4274/`. The runtime keeps one Core store, one browser audio
-element, and one lazily-created Web Audio gain graph above the Compact, Wide,
-Detailed, Podcast, and Mini view switcher. Queue Panel and the fixed Global
-Mini also consume that same state. Switching views therefore does not stop
-playback or create another audio element.
-
-The Showcase uses generated music and podcast WAV tone fixtures. They are local,
-copyright-free integration media only and are not production assets. The
-runtime connects UI exclusively through `PlayerState` and `PlayerCommands`;
-the waveform remains visual-only and seeking is owned by the Seek Bar.
-
-Manual UX check:
-
-1. Start playback and confirm that Audio Context changes from `uninitialized`
-   to `running` only after the first user action.
-2. Check Play/Pause, Seek, Volume, Previous, and Next in Wide view. On desktop,
-   open the compact vertical Volume control from its icon in Compact and Mini;
-   narrow mobile layouts intentionally omit it.
-3. While playing, switch between Compact, Wide, Detailed, Podcast, and Mini and
-   confirm that the same track, time, and playback state continue.
-4. Open Queue Panel, select another item, and check the Podcast queue with
-   skip-back/forward controls.
-5. Toggle Global Mini and confirm that the page bottom inset is reserved only
-   while it is visible.
-6. In browser developer tools, confirm that
-   `document.querySelectorAll('audio[data-player-audio="true"]').length` is
-   always `1`.
-
-## WP-01 entry points
-
-- `@gentomiyano/optimized-web-audio-player/contracts`: immutable state, commands, lifecycle,
-  host adapter, config, preset, and debug-controller contracts
-- `@gentomiyano/optimized-web-audio-player/ports`: small media, gain, and persistence ports
-- `@gentomiyano/optimized-web-audio-player/config`: preview defaults, strict validation,
-  versioned Config JSON schema v2, and initial state
-- `@gentomiyano/optimized-web-audio-player/media-delivery`: WP-04 URL-free delivery
-  descriptors, ephemeral playback-lease and Host Adapter contracts, upload
-  evidence validation, and waveform validation
-- `@gentomiyano/optimized-web-audio-player/consumer`: ordered consumer-record to Core Queue
-  conversion for already-authorized directly playable media
-- `@gentomiyano/optimized-web-audio-player/react`: the single-audio React Runtime and hook
-- `@gentomiyano/optimized-web-audio-player/ui`: reusable Player views and primitives
-- `@gentomiyano/optimized-web-audio-player/styles.css`: production UI tokens and styles
-- `@gentomiyano/optimized-web-audio-player/testing`: privacy-safe fixtures and mock scenarios
-
-The root entry point exports production contracts, ports, config, and the
-provider-neutral media-delivery contract only. Runtime/UI are opt-in subpaths,
-and testing helpers are isolated behind `/testing`. No debug Runtime, Showcase,
-local importer, consumer-specific adapter, or production media URL is included
-in the package root.
-
-## Commands
-
-```text
-pnpm lint
-pnpm test
-pnpm typecheck
-pnpm build
-pnpm showcase:build
-```
-
-## Parallel ownership after the WP-01 checkpoint
-
-- Core: `src/core/**`, `tests/core/**`
-- WP-02B UI ownership explicitly includes `src/ui/**`, `src/icons/**`,
-  `src/debug/ui/**`, and `tests/ui/**`.
-- UI may also render its mock views inside the pre-created `showcase/**` shell.
-- Integration-owned files, including contracts, ports, package configuration,
-  adapters, and testing fixtures, must not be changed by Core or UI work.
+# Optimized Web Audio Player
+
+Consumer-neutral Music Player package published as
+`@gentomiyano/optimized-web-audio-player`.
+
+## MVP status
+
+The standalone Player MVP was accepted on 2026-08-01. The accepted scope
+includes the framework-independent Core, reusable React Runtime and UI,
+Compact / Wide / Detailed / Podcast / Mini views, Queue, Debug customization,
+local-media Showcase tooling, Media Session integration, responsive mobile
+review, and the media-delivery boundary contract.
+
+The tested iOS device continued playback in the background, during sleep, and
+on the Lock Screen. Lock Screen Previous / Next and Seek worked, and starting
+audio in another application interrupted the Player as expected. iOS uses the
+continuity-first native HTML media path by default; fade timing is not
+perceptible there and is an accepted MVP platform limitation. Narrow Compact
+and Mini layouts, including Global Mini, omit their in-player volume control
+because iOS owns device output volume.
+
+This acceptance does not connect a consumer application or production media
+origin, and it is not a claim of identical behavior across every iOS version,
+browser, Bluetooth route, or device.
+
+## WP-07 consumer integration foundation
+
+The production React Runtime, UI, CSS, and consumer queue builder now have
+explicit package entry points. A consumer can mount one empty
+`PlayerProvider` in its application shell, map authorized public media through
+its own Host Adapter, and build collection, selection, or page-order queues
+without copying Player source.
+
+Official Website and Timeline are not changed in this phase. Protected-URL
+refresh and the first consumer connection remain explicit checkpoints. See
+`docs/WP-07-CONSUMER-INTEGRATION-FOUNDATION.md`.
+
+The public npm registry, scoped package name, and release workflow are fixed.
+Initial npm publication still requires the scope owner's authentication.
+Release and consumer pinning rules are documented in `docs/RELEASING.md`.
+
+## PLAYER-UI-CONTRACT-01 Bound Compact
+
+Version 0.2.3 makes the occurrence-bound inline Player use the standard
+Compact visual implementation. `CompactPlayer` and `BoundCompactPlayerView`
+now share one surface, metadata grid, waveform signal, seek overlay, tokens,
+and container-query behavior; the former `player-bound-compact` surface and
+its separate active panel are removed.
+
+The React API and playback semantics are unchanged. An inactive occurrence
+shows its own metadata at zero and activates its context only on Play. The
+active occurrence exposes global Play / Pause, time, and seek while the
+existing Global Mini continues to use the same Store and audio element. See
+`docs/PLAYER-UI-CONTRACT-01-BOUND-COMPACT.md`.
+
+## WP-04.4 SSR-transparent Provider
+
+Version 0.2.2 renders consumer children inside the same Player Context from
+server rendering through hydration and Runtime readiness. `usePlayer()`
+exposes `runtimeStatus` as `pending` or `ready`; pending state uses an inert,
+SSR-safe Store bridge and never creates browser audio infrastructure.
+
+`BoundCompactPlayer` renders its occurrence metadata while pending. Runtime
+attachment updates the shared external Store without replacing or remounting
+the consumer subtree. The built-package smoke now performs server rendering,
+hydration, duplicate-ID, stable-sentinel, shared Mini Player, and single-audio
+checks. See `docs/WP-04.4-SSR-TRANSPARENT-PROVIDER.md`.
+
+## WP-04.3 React package boundary
+
+Version 0.2.1 keeps React Context consumers in the `/react` entrypoint and
+exports props-only views from `/ui`. Import `PlayerProvider`, `usePlayer`,
+`useBoundPlayer`, and `BoundCompactPlayer` from `/react`; import
+`BoundCompactPlayerView`, `MiniPlayer`, and the other pure views from `/ui`.
+
+The release check packs the built package, installs that tarball into an empty
+consumer, renders a bound inline Player with a shared Mini Player, and verifies
+one Store, one active item, and one audio element. See
+`docs/WP-04.3-REACT-BOUNDARY.md`.
+
+## WP-04.2 playback contexts and bound inline players
+
+Version 0.2.0 adds consumer-neutral `manual-history` and `ordered-queue`
+playback contexts. Contexts change only through an explicit
+`activateContext` command; rerendering or navigating while the application
+shell retains `PlayerProvider` does not replace the active context.
+
+`manual-history` records only explicitly played occurrences, never advances
+on natural end, and supports Previous / Next only inside the recorded session
+history. `ordered-queue` keeps normal queue navigation, natural advancement,
+shuffle, and repeat behavior. Queue updates preserve playback when the same
+`queueItemId` and source descriptor remain selected.
+
+Consumers can use `useBoundPlayer` or `BoundCompactPlayer` to bind an inline
+control to one queue occurrence without creating another audio element or
+store. See `docs/WP-04.2-PLAYBACK-CONTEXT.md` for contracts and integration
+examples.
+
+## FORNOW Release and Podcast content contexts
+
+Version 0.3.0 adds the Release and Podcast Program content surfaces.
+
+The package now exposes Player-side models and props-only views for intrinsic
+Release Tracklists and Podcast Programs. `ReleasePlayer` and
+`PodcastProgramPlayer` use the existing shared `PlayerCommands` and
+`PlayerProvider`; they do not mount another audio element or expose their
+ordered content as a visible generic Queue.
+
+Hosts keep access, publication, entitlement, and asset processing policy.
+They may render `processing`, `locked`, `unavailable`, and `failed` entries,
+but only an authorized `ready` entry carries a `QueueItem`. Player media uses
+an explicit `contentContext` with Release/Track or Program/Episode IDs so the
+shared Mini Player and Media Session retain the playing source identity.
+
+Podcast Episodes may provide timestamped chapters. Selecting an active
+chapter seeks the shared Player; selecting a chapter from another Episode
+activates that Episode first. See
+`docs/FORNOW-RELEASE-PODCAST-PLAYER.md` for the integration boundary.
+
+## WP-06 debug local media import
+
+The standalone Showcase has a dev-only Local Media panel for dropping WAV,
+MP3, JPG/JPEG, PNG, and WebP files. Multi-file audio drops become a temporary
+Queue in drop order. Metadata overrides, artwork switching, track-number
+sorting, duplicate policy, re-read, reorder, delete, clear, and cancellable
+waveform analysis remain in tab memory only.
+
+No local file, metadata, filename, or object URL is sent, logged, persisted, or
+written back. Reloading clears the import. Audio and artwork object URLs are
+reference-counted, reused for duplicate identities, and revoked after the last
+item is removed, on clear, or when the Showcase unmounts.
+
+The parser and UI live only under `showcase/local-media/**`. They are not
+package exports or `tsup` entries. `pnpm build` scans every production
+JavaScript output for WP-06 markers and fails if the debug importer leaks into
+the package. See `docs/WP-06-DEBUG-MEDIA-IMPORT.md` for format coverage,
+limitations, and the manual checkpoint.
+
+## WP-05 background playback checkpoint
+
+The standalone Showcase now integrates Media Session metadata, playback and
+position state, and OS action handlers. Music exposes play, pause, stop,
+Previous, Next, and seek-to. Podcast additionally exposes configurable skip
+backward and forward actions. Every handler delegates to the existing
+`PlayerCommands`; initial queue load remains non-autoplay.
+
+`audioMode=auto` keeps Web Audio fades on non-iOS browsers and uses the native
+HTMLAudioElement path on iPhone/iPadOS, prioritizing background continuity over
+fades. Real-device comparison modes are:
+
+- `http://127.0.0.1:4274/?audioMode=web-audio`
+- `http://127.0.0.1:4274/?audioMode=html-media`
+
+Double-click `start-player-showcase-device.cmd` for same-LAN iPhone testing,
+then replace the host with this computer's private LAN IP. The original
+`start-player-showcase.cmd` remains the loopback-only desktop launcher.
+`start-player-showcase-mobile.cmd` is an equivalent mobile-review launcher.
+The Showcase also has a `Mobile preview` toggle; `?preview=mobile` opens the
+same constrained review shell directly on desktop.
+
+Automated verification and the accepted device observations are recorded in
+`docs/WP-05A-BACKGROUND-PLAYBACK-FOUNDATION.md`. Broader device/version,
+Bluetooth, and production-consumer claims still require their own acceptance
+record.
+
+## WP-03 runtime showcase
+
+Double-click `start-player-showcase.cmd` to open the standalone Showcase at
+`http://127.0.0.1:4274/`. The runtime keeps one Core store, one browser audio
+element, and one lazily-created Web Audio gain graph above the Compact, Wide,
+Detailed, Podcast, and Mini view switcher. Queue Panel and the fixed Global
+Mini also consume that same state. Switching views therefore does not stop
+playback or create another audio element.
+
+The Showcase uses generated music and podcast WAV tone fixtures. They are local,
+copyright-free integration media only and are not production assets. The
+runtime connects UI exclusively through `PlayerState` and `PlayerCommands`;
+the waveform remains visual-only and seeking is owned by the Seek Bar.
+
+Manual UX check:
+
+1. Start playback and confirm that Audio Context changes from `uninitialized`
+   to `running` only after the first user action.
+2. Check Play/Pause, Seek, Volume, Previous, and Next in Wide view. On desktop,
+   open the compact vertical Volume control from its icon in Compact and Mini;
+   narrow mobile layouts intentionally omit it.
+3. While playing, switch between Compact, Wide, Detailed, Podcast, and Mini and
+   confirm that the same track, time, and playback state continue.
+4. Open Queue Panel, select another item, and check the Podcast queue with
+   skip-back/forward controls.
+5. Toggle Global Mini and confirm that the page bottom inset is reserved only
+   while it is visible.
+6. In browser developer tools, confirm that
+   `document.querySelectorAll('audio[data-player-audio="true"]').length` is
+   always `1`.
+
+## WP-01 entry points
+
+- `@gentomiyano/optimized-web-audio-player/contracts`: immutable state, commands, lifecycle,
+  host adapter, config, preset, and debug-controller contracts
+- `@gentomiyano/optimized-web-audio-player/ports`: small media, gain, and persistence ports
+- `@gentomiyano/optimized-web-audio-player/config`: preview defaults, strict validation,
+  versioned Config JSON schema v2, and initial state
+- `@gentomiyano/optimized-web-audio-player/media-delivery`: WP-04 URL-free delivery
+  descriptors, ephemeral playback-lease and Host Adapter contracts, upload
+  evidence validation, and waveform validation
+- `@gentomiyano/optimized-web-audio-player/consumer`: ordered consumer-record to Core Queue
+  conversion for already-authorized directly playable media
+- `@gentomiyano/optimized-web-audio-player/react`: the single-audio React Runtime and hook
+- `@gentomiyano/optimized-web-audio-player/ui`: reusable Player views and primitives
+- `@gentomiyano/optimized-web-audio-player/styles.css`: production UI tokens and styles
+- `@gentomiyano/optimized-web-audio-player/testing`: privacy-safe fixtures and mock scenarios
+
+The root entry point exports production contracts, ports, config, and the
+provider-neutral media-delivery contract only. Runtime/UI are opt-in subpaths,
+and testing helpers are isolated behind `/testing`. No debug Runtime, Showcase,
+local importer, consumer-specific adapter, or production media URL is included
+in the package root.
+
+## Commands
+
+```text
+pnpm lint
+pnpm test
+pnpm typecheck
+pnpm build
+pnpm showcase:build
+```
+
+## Parallel ownership after the WP-01 checkpoint
+
+- Core: `src/core/**`, `tests/core/**`
+- WP-02B UI ownership explicitly includes `src/ui/**`, `src/icons/**`,
+  `src/debug/ui/**`, and `tests/ui/**`.
+- UI may also render its mock views inside the pre-created `showcase/**` shell.
+- Integration-owned files, including contracts, ports, package configuration,
+  adapters, and testing fixtures, must not be changed by Core or UI work.

package/dist/config/index.d.ts

@@ -1,5 +1,5 @@
-import { p as PlayerExperienceConfig, z as PlayerState } from '../player-CE714iU_.js';
-import { PlayerExperienceConfigValidationResult } from '../contracts/index.js';
+import { q as PlayerExperienceConfig, C as PlayerState } from '../player-DRQO7SLs.js';
+import { P as PlayerExperienceConfigValidationResult } from '../config-Bhyo_y05.js';
 
 declare const PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION: 2;
 declare const PLAYER_EXPERIENCE_CONFIG_LIMITS: Readonly<{

package/dist/config/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/config/defaults.ts","../../src/config/validation.ts","../../src/config/initial-state.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { PlayerExperienceConfig } from \"../contracts/player\";\r\n\r\nexport const PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION = 2 as const;\r\n\r\nexport const PLAYER_EXPERIENCE_CONFIG_LIMITS = Object.freeze({\r\n  fadeMs: Object.freeze({ min: 0, max: 10_000 }),\r\n  previousRestartThresholdSec: Object.freeze({ min: 0, max: 60 }),\r\n  waveformOpacity: Object.freeze({ min: 0, max: 1 }),\r\n  initialVolume: Object.freeze({ min: 0, max: 1 }),\r\n  podcastSkipSec: Object.freeze({ minExclusive: 0, max: 3_600 }),\r\n});\r\n\r\nexport const PREVIEW_PLAYER_EXPERIENCE_CONFIG: Readonly<PlayerExperienceConfig> =\r\n  Object.freeze({\r\n    playFadeInMs: 300,\r\n    pauseFadeOutMs: 600,\r\n    trackChangeFadeOutMs: 300,\r\n    trackChangeFadeInMs: 300,\r\n    seekFadeMs: 120,\r\n    fadeCurve: \"ease-out\",\r\n    previousRestartThresholdSec: 3,\r\n    seekCommitMode: \"on-release\",\r\n    waveformPlayedStateEnabled: true,\r\n    waveformOpacity: 0.72,\r\n    initialShuffleEnabled: false,\r\n    initialRepeatMode: \"off\",\r\n    initialVolume: 0.8,\r\n    persistMode: \"none\",\r\n    podcastBackSec: 15,\r\n    podcastForwardSec: 30,\r\n    podcastPreviousMode: \"previous-episode\",\r\n  });\r\n","import type {\r\n  FadeCurve,\r\n  PersistMode,\r\n  PlayerExperienceConfig,\r\n  PodcastPreviousMode,\r\n  RepeatMode,\r\n  SeekCommitMode,\r\n} from \"../contracts/player\";\r\nimport type { PlayerExperienceConfigValidationResult } from \"../contracts/config\";\r\nimport {\r\n  PLAYER_EXPERIENCE_CONFIG_LIMITS,\r\n  PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION,\r\n  PREVIEW_PLAYER_EXPERIENCE_CONFIG,\r\n} from \"./defaults\";\r\n\r\nconst CONFIG_KEYS = [\r\n  \"playFadeInMs\",\r\n  \"pauseFadeOutMs\",\r\n  \"trackChangeFadeOutMs\",\r\n  \"trackChangeFadeInMs\",\r\n  \"seekFadeMs\",\r\n  \"fadeCurve\",\r\n  \"previousRestartThresholdSec\",\r\n  \"seekCommitMode\",\r\n  \"waveformPlayedStateEnabled\",\r\n  \"waveformOpacity\",\r\n  \"initialShuffleEnabled\",\r\n  \"initialRepeatMode\",\r\n  \"initialVolume\",\r\n  \"persistMode\",\r\n  \"podcastBackSec\",\r\n  \"podcastForwardSec\",\r\n  \"podcastPreviousMode\",\r\n] as const satisfies readonly (keyof PlayerExperienceConfig)[];\r\n\r\nconst FADE_CURVES = new Set<FadeCurve>([\r\n  \"linear\",\r\n  \"ease-in\",\r\n  \"ease-out\",\r\n  \"equal-power\",\r\n]);\r\nconst SEEK_COMMIT_MODES = new Set<SeekCommitMode>([\"live\", \"on-release\"]);\r\nconst REPEAT_MODES = new Set<RepeatMode>([\"off\", \"all\", \"one\"]);\r\nconst PERSIST_MODES = new Set<PersistMode>([\"none\", \"session\", \"local\"]);\r\nconst PODCAST_PREVIOUS_MODES = new Set<PodcastPreviousMode>([\r\n  \"previous-episode\",\r\n  \"restart-episode\",\r\n]);\r\n\r\nfunction isRecord(value: unknown): value is Record<string, unknown> {\r\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\r\n}\r\n\r\nfunction validateFiniteRange(\r\n  value: unknown,\r\n  path: string,\r\n  min: number,\r\n  max: number,\r\n  errors: string[],\r\n): value is number {\r\n  if (\r\n    typeof value !== \"number\" ||\r\n    !Number.isFinite(value) ||\r\n    value < min ||\r\n    value > max\r\n  ) {\r\n    errors.push(\r\n      `${path} must be a finite number between ${String(min)} and ${String(max)}.`,\r\n    );\r\n    return false;\r\n  }\r\n  return true;\r\n}\r\n\r\nfunction validateBoolean(\r\n  value: unknown,\r\n  path: string,\r\n  errors: string[],\r\n): value is boolean {\r\n  if (typeof value !== \"boolean\") {\r\n    errors.push(`${path} must be a boolean.`);\r\n    return false;\r\n  }\r\n  return true;\r\n}\r\n\r\nfunction validateConfigRecord(\r\n  value: unknown,\r\n  options: { readonly partial: boolean },\r\n): PlayerExperienceConfigValidationResult {\r\n  if (!isRecord(value)) {\r\n    return { ok: false, errors: [\"config must be an object.\"] };\r\n  }\r\n\r\n  const errors: string[] = [];\r\n  const allowedKeys = new Set<string>(CONFIG_KEYS);\r\n\r\n  for (const key of Object.keys(value)) {\r\n    if (!allowedKeys.has(key)) {\r\n      errors.push(`config.${key} is not supported.`);\r\n    }\r\n  }\r\n\r\n  if (!options.partial) {\r\n    for (const key of CONFIG_KEYS) {\r\n      if (!Object.hasOwn(value, key)) {\r\n        errors.push(`config.${key} is required.`);\r\n      }\r\n    }\r\n  }\r\n\r\n  const has = (key: keyof PlayerExperienceConfig): boolean =>\r\n    Object.hasOwn(value, key);\r\n  const fadeLimits = PLAYER_EXPERIENCE_CONFIG_LIMITS.fadeMs;\r\n\r\n  for (const key of [\r\n    \"playFadeInMs\",\r\n    \"pauseFadeOutMs\",\r\n    \"trackChangeFadeOutMs\",\r\n    \"trackChangeFadeInMs\",\r\n    \"seekFadeMs\",\r\n  ] as const) {\r\n    if (has(key)) {\r\n      validateFiniteRange(value[key], `config.${key}`, fadeLimits.min, fadeLimits.max, errors);\r\n    }\r\n  }\r\n\r\n  const thresholdLimits =\r\n    PLAYER_EXPERIENCE_CONFIG_LIMITS.previousRestartThresholdSec;\r\n  if (has(\"previousRestartThresholdSec\")) {\r\n    validateFiniteRange(\r\n      value.previousRestartThresholdSec,\r\n      \"config.previousRestartThresholdSec\",\r\n      thresholdLimits.min,\r\n      thresholdLimits.max,\r\n      errors,\r\n    );\r\n  }\r\n\r\n  const volumeLimits = PLAYER_EXPERIENCE_CONFIG_LIMITS.initialVolume;\r\n  if (has(\"initialVolume\")) {\r\n    validateFiniteRange(\r\n      value.initialVolume,\r\n      \"config.initialVolume\",\r\n      volumeLimits.min,\r\n      volumeLimits.max,\r\n      errors,\r\n    );\r\n  }\r\n\r\n  const waveformOpacityLimits =\r\n    PLAYER_EXPERIENCE_CONFIG_LIMITS.waveformOpacity;\r\n  if (has(\"waveformOpacity\")) {\r\n    validateFiniteRange(\r\n      value.waveformOpacity,\r\n      \"config.waveformOpacity\",\r\n      waveformOpacityLimits.min,\r\n      waveformOpacityLimits.max,\r\n      errors,\r\n    );\r\n  }\r\n\r\n  for (const key of [\r\n    \"waveformPlayedStateEnabled\",\r\n    \"initialShuffleEnabled\",\r\n  ] as const) {\r\n    if (has(key)) {\r\n      validateBoolean(value[key], `config.${key}`, errors);\r\n    }\r\n  }\r\n\r\n  const skipLimits = PLAYER_EXPERIENCE_CONFIG_LIMITS.podcastSkipSec;\r\n  for (const key of [\"podcastBackSec\", \"podcastForwardSec\"] as const) {\r\n    if (has(key)) {\r\n      const candidate = value[key];\r\n      const valid = validateFiniteRange(\r\n        candidate,\r\n        `config.${key}`,\r\n        skipLimits.minExclusive,\r\n        skipLimits.max,\r\n        errors,\r\n      );\r\n      if (valid && candidate <= skipLimits.minExclusive) {\r\n        errors.push(`config.${key} must be greater than 0.`);\r\n      }\r\n    }\r\n  }\r\n\r\n  if (has(\"fadeCurve\") && !FADE_CURVES.has(value.fadeCurve as FadeCurve)) {\r\n    errors.push(\"config.fadeCurve is not supported.\");\r\n  }\r\n  if (\r\n    has(\"seekCommitMode\") &&\r\n    !SEEK_COMMIT_MODES.has(value.seekCommitMode as SeekCommitMode)\r\n  ) {\r\n    errors.push(\"config.seekCommitMode is not supported.\");\r\n  }\r\n  if (\r\n    has(\"initialRepeatMode\") &&\r\n    !REPEAT_MODES.has(value.initialRepeatMode as RepeatMode)\r\n  ) {\r\n    errors.push(\"config.initialRepeatMode is not supported.\");\r\n  }\r\n  if (has(\"persistMode\") && !PERSIST_MODES.has(value.persistMode as PersistMode)) {\r\n    errors.push(\"config.persistMode is not supported.\");\r\n  }\r\n  if (\r\n    has(\"podcastPreviousMode\") &&\r\n    !PODCAST_PREVIOUS_MODES.has(\r\n      value.podcastPreviousMode as PodcastPreviousMode,\r\n    )\r\n  ) {\r\n    errors.push(\"config.podcastPreviousMode is not supported.\");\r\n  }\r\n\r\n  if (errors.length > 0) {\r\n    return { ok: false, errors: Object.freeze(errors) };\r\n  }\r\n\r\n  const merged = options.partial\r\n    ? { ...PREVIEW_PLAYER_EXPERIENCE_CONFIG, ...value }\r\n    : value;\r\n\r\n  return {\r\n    ok: true,\r\n    errors: [],\r\n    value: Object.freeze({ ...merged }) as Readonly<PlayerExperienceConfig>,\r\n  };\r\n}\r\n\r\nexport function validatePlayerExperienceConfig(\r\n  value: unknown,\r\n): PlayerExperienceConfigValidationResult {\r\n  return validateConfigRecord(value, { partial: false });\r\n}\r\n\r\nexport function validatePlayerExperienceConfigOverride(\r\n  value: unknown,\r\n): PlayerExperienceConfigValidationResult {\r\n  return validateConfigRecord(value, { partial: true });\r\n}\r\n\r\nexport function resolvePlayerExperienceConfig(\r\n  override?: Partial<PlayerExperienceConfig>,\r\n): PlayerExperienceConfigValidationResult {\r\n  return validatePlayerExperienceConfigOverride(override ?? {});\r\n}\r\n\r\nexport function parsePlayerExperienceConfigJson(\r\n  json: string,\r\n): PlayerExperienceConfigValidationResult {\r\n  let parsed: unknown;\r\n\r\n  try {\r\n    parsed = JSON.parse(json) as unknown;\r\n  } catch {\r\n    return { ok: false, errors: [\"Config JSON is not valid JSON.\"] };\r\n  }\r\n\r\n  if (!isRecord(parsed)) {\r\n    return { ok: false, errors: [\"Config JSON envelope must be an object.\"] };\r\n  }\r\n\r\n  const envelopeKeys = Object.keys(parsed);\r\n  const errors: string[] = [];\r\n\r\n  for (const key of envelopeKeys) {\r\n    if (key !== \"schemaVersion\" && key !== \"config\") {\r\n      errors.push(`envelope.${key} is not supported.`);\r\n    }\r\n  }\r\n  if (!Object.hasOwn(parsed, \"schemaVersion\")) {\r\n    errors.push(\"envelope.schemaVersion is required.\");\r\n  } else if (\r\n    parsed.schemaVersion !== PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION\r\n  ) {\r\n    errors.push(\"envelope.schemaVersion is not supported.\");\r\n  }\r\n  if (!Object.hasOwn(parsed, \"config\")) {\r\n    errors.push(\"envelope.config is required.\");\r\n  }\r\n\r\n  if (errors.length > 0) {\r\n    return { ok: false, errors: Object.freeze(errors) };\r\n  }\r\n\r\n  return validatePlayerExperienceConfig(parsed.config);\r\n}\r\n\r\nexport function serializePlayerExperienceConfig(\r\n  config: PlayerExperienceConfig,\r\n): string {\r\n  const result = validatePlayerExperienceConfig(config);\r\n\r\n  if (!result.ok) {\r\n    throw new TypeError(result.errors.join(\" \"));\r\n  }\r\n\r\n  return JSON.stringify(\r\n    {\r\n      schemaVersion: PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION,\r\n      config: result.value,\r\n    },\r\n    null,\r\n    2,\r\n  );\r\n}\r\n","import type {\r\n  PlayerExperienceConfig,\r\n  PlayerState,\r\n} from \"../contracts/player\";\r\nimport { resolvePlayerExperienceConfig } from \"./validation\";\r\n\r\nexport function createInitialPlayerState(\r\n  experienceConfig?: Partial<PlayerExperienceConfig>,\r\n): Readonly<PlayerState> {\r\n  const resolved = resolvePlayerExperienceConfig(experienceConfig);\r\n\r\n  if (!resolved.ok) {\r\n    throw new TypeError(resolved.errors.join(\" \"));\r\n  }\r\n\r\n  return Object.freeze({\r\n    currentItem: null,\r\n    currentItemId: null,\r\n    currentQueueItemId: null,\r\n    mediaKind: null,\r\n    status: \"idle\",\r\n    currentTimeSec: 0,\r\n    durationSec: null,\r\n    volume: resolved.value.initialVolume,\r\n    muted: false,\r\n    shuffleEnabled: resolved.value.initialShuffleEnabled,\r\n    repeatMode: resolved.value.initialRepeatMode,\r\n    queue: Object.freeze([]),\r\n    activeContext: null,\r\n    currentQueueIndex: null,\r\n    canSeek: false,\r\n    canGoPrevious: false,\r\n    canGoNext: false,\r\n    needsUserGesture: false,\r\n    lastTransitionCause: null,\r\n    error: null,\r\n    experienceConfig: resolved.value,\r\n  });\r\n}\r\n"]}
+{"version":3,"sources":["../../src/config/defaults.ts","../../src/config/validation.ts","../../src/config/initial-state.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { PlayerExperienceConfig } from \"../contracts/player\";\n\nexport const PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION = 2 as const;\n\nexport const PLAYER_EXPERIENCE_CONFIG_LIMITS = Object.freeze({\n  fadeMs: Object.freeze({ min: 0, max: 10_000 }),\n  previousRestartThresholdSec: Object.freeze({ min: 0, max: 60 }),\n  waveformOpacity: Object.freeze({ min: 0, max: 1 }),\n  initialVolume: Object.freeze({ min: 0, max: 1 }),\n  podcastSkipSec: Object.freeze({ minExclusive: 0, max: 3_600 }),\n});\n\nexport const PREVIEW_PLAYER_EXPERIENCE_CONFIG: Readonly<PlayerExperienceConfig> =\n  Object.freeze({\n    playFadeInMs: 300,\n    pauseFadeOutMs: 600,\n    trackChangeFadeOutMs: 300,\n    trackChangeFadeInMs: 300,\n    seekFadeMs: 120,\n    fadeCurve: \"ease-out\",\n    previousRestartThresholdSec: 3,\n    seekCommitMode: \"on-release\",\n    waveformPlayedStateEnabled: true,\n    waveformOpacity: 0.72,\n    initialShuffleEnabled: false,\n    initialRepeatMode: \"off\",\n    initialVolume: 0.8,\n    persistMode: \"none\",\n    podcastBackSec: 15,\n    podcastForwardSec: 30,\n    podcastPreviousMode: \"previous-episode\",\n  });\n","import type {\n  FadeCurve,\n  PersistMode,\n  PlayerExperienceConfig,\n  PodcastPreviousMode,\n  RepeatMode,\n  SeekCommitMode,\n} from \"../contracts/player\";\nimport type { PlayerExperienceConfigValidationResult } from \"../contracts/config\";\nimport {\n  PLAYER_EXPERIENCE_CONFIG_LIMITS,\n  PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION,\n  PREVIEW_PLAYER_EXPERIENCE_CONFIG,\n} from \"./defaults\";\n\nconst CONFIG_KEYS = [\n  \"playFadeInMs\",\n  \"pauseFadeOutMs\",\n  \"trackChangeFadeOutMs\",\n  \"trackChangeFadeInMs\",\n  \"seekFadeMs\",\n  \"fadeCurve\",\n  \"previousRestartThresholdSec\",\n  \"seekCommitMode\",\n  \"waveformPlayedStateEnabled\",\n  \"waveformOpacity\",\n  \"initialShuffleEnabled\",\n  \"initialRepeatMode\",\n  \"initialVolume\",\n  \"persistMode\",\n  \"podcastBackSec\",\n  \"podcastForwardSec\",\n  \"podcastPreviousMode\",\n] as const satisfies readonly (keyof PlayerExperienceConfig)[];\n\nconst FADE_CURVES = new Set<FadeCurve>([\n  \"linear\",\n  \"ease-in\",\n  \"ease-out\",\n  \"equal-power\",\n]);\nconst SEEK_COMMIT_MODES = new Set<SeekCommitMode>([\"live\", \"on-release\"]);\nconst REPEAT_MODES = new Set<RepeatMode>([\"off\", \"all\", \"one\"]);\nconst PERSIST_MODES = new Set<PersistMode>([\"none\", \"session\", \"local\"]);\nconst PODCAST_PREVIOUS_MODES = new Set<PodcastPreviousMode>([\n  \"previous-episode\",\n  \"restart-episode\",\n]);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction validateFiniteRange(\n  value: unknown,\n  path: string,\n  min: number,\n  max: number,\n  errors: string[],\n): value is number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isFinite(value) ||\n    value < min ||\n    value > max\n  ) {\n    errors.push(\n      `${path} must be a finite number between ${String(min)} and ${String(max)}.`,\n    );\n    return false;\n  }\n  return true;\n}\n\nfunction validateBoolean(\n  value: unknown,\n  path: string,\n  errors: string[],\n): value is boolean {\n  if (typeof value !== \"boolean\") {\n    errors.push(`${path} must be a boolean.`);\n    return false;\n  }\n  return true;\n}\n\nfunction validateConfigRecord(\n  value: unknown,\n  options: { readonly partial: boolean },\n): PlayerExperienceConfigValidationResult {\n  if (!isRecord(value)) {\n    return { ok: false, errors: [\"config must be an object.\"] };\n  }\n\n  const errors: string[] = [];\n  const allowedKeys = new Set<string>(CONFIG_KEYS);\n\n  for (const key of Object.keys(value)) {\n    if (!allowedKeys.has(key)) {\n      errors.push(`config.${key} is not supported.`);\n    }\n  }\n\n  if (!options.partial) {\n    for (const key of CONFIG_KEYS) {\n      if (!Object.hasOwn(value, key)) {\n        errors.push(`config.${key} is required.`);\n      }\n    }\n  }\n\n  const has = (key: keyof PlayerExperienceConfig): boolean =>\n    Object.hasOwn(value, key);\n  const fadeLimits = PLAYER_EXPERIENCE_CONFIG_LIMITS.fadeMs;\n\n  for (const key of [\n    \"playFadeInMs\",\n    \"pauseFadeOutMs\",\n    \"trackChangeFadeOutMs\",\n    \"trackChangeFadeInMs\",\n    \"seekFadeMs\",\n  ] as const) {\n    if (has(key)) {\n      validateFiniteRange(value[key], `config.${key}`, fadeLimits.min, fadeLimits.max, errors);\n    }\n  }\n\n  const thresholdLimits =\n    PLAYER_EXPERIENCE_CONFIG_LIMITS.previousRestartThresholdSec;\n  if (has(\"previousRestartThresholdSec\")) {\n    validateFiniteRange(\n      value.previousRestartThresholdSec,\n      \"config.previousRestartThresholdSec\",\n      thresholdLimits.min,\n      thresholdLimits.max,\n      errors,\n    );\n  }\n\n  const volumeLimits = PLAYER_EXPERIENCE_CONFIG_LIMITS.initialVolume;\n  if (has(\"initialVolume\")) {\n    validateFiniteRange(\n      value.initialVolume,\n      \"config.initialVolume\",\n      volumeLimits.min,\n      volumeLimits.max,\n      errors,\n    );\n  }\n\n  const waveformOpacityLimits =\n    PLAYER_EXPERIENCE_CONFIG_LIMITS.waveformOpacity;\n  if (has(\"waveformOpacity\")) {\n    validateFiniteRange(\n      value.waveformOpacity,\n      \"config.waveformOpacity\",\n      waveformOpacityLimits.min,\n      waveformOpacityLimits.max,\n      errors,\n    );\n  }\n\n  for (const key of [\n    \"waveformPlayedStateEnabled\",\n    \"initialShuffleEnabled\",\n  ] as const) {\n    if (has(key)) {\n      validateBoolean(value[key], `config.${key}`, errors);\n    }\n  }\n\n  const skipLimits = PLAYER_EXPERIENCE_CONFIG_LIMITS.podcastSkipSec;\n  for (const key of [\"podcastBackSec\", \"podcastForwardSec\"] as const) {\n    if (has(key)) {\n      const candidate = value[key];\n      const valid = validateFiniteRange(\n        candidate,\n        `config.${key}`,\n        skipLimits.minExclusive,\n        skipLimits.max,\n        errors,\n      );\n      if (valid && candidate <= skipLimits.minExclusive) {\n        errors.push(`config.${key} must be greater than 0.`);\n      }\n    }\n  }\n\n  if (has(\"fadeCurve\") && !FADE_CURVES.has(value.fadeCurve as FadeCurve)) {\n    errors.push(\"config.fadeCurve is not supported.\");\n  }\n  if (\n    has(\"seekCommitMode\") &&\n    !SEEK_COMMIT_MODES.has(value.seekCommitMode as SeekCommitMode)\n  ) {\n    errors.push(\"config.seekCommitMode is not supported.\");\n  }\n  if (\n    has(\"initialRepeatMode\") &&\n    !REPEAT_MODES.has(value.initialRepeatMode as RepeatMode)\n  ) {\n    errors.push(\"config.initialRepeatMode is not supported.\");\n  }\n  if (has(\"persistMode\") && !PERSIST_MODES.has(value.persistMode as PersistMode)) {\n    errors.push(\"config.persistMode is not supported.\");\n  }\n  if (\n    has(\"podcastPreviousMode\") &&\n    !PODCAST_PREVIOUS_MODES.has(\n      value.podcastPreviousMode as PodcastPreviousMode,\n    )\n  ) {\n    errors.push(\"config.podcastPreviousMode is not supported.\");\n  }\n\n  if (errors.length > 0) {\n    return { ok: false, errors: Object.freeze(errors) };\n  }\n\n  const merged = options.partial\n    ? { ...PREVIEW_PLAYER_EXPERIENCE_CONFIG, ...value }\n    : value;\n\n  return {\n    ok: true,\n    errors: [],\n    value: Object.freeze({ ...merged }) as Readonly<PlayerExperienceConfig>,\n  };\n}\n\nexport function validatePlayerExperienceConfig(\n  value: unknown,\n): PlayerExperienceConfigValidationResult {\n  return validateConfigRecord(value, { partial: false });\n}\n\nexport function validatePlayerExperienceConfigOverride(\n  value: unknown,\n): PlayerExperienceConfigValidationResult {\n  return validateConfigRecord(value, { partial: true });\n}\n\nexport function resolvePlayerExperienceConfig(\n  override?: Partial<PlayerExperienceConfig>,\n): PlayerExperienceConfigValidationResult {\n  return validatePlayerExperienceConfigOverride(override ?? {});\n}\n\nexport function parsePlayerExperienceConfigJson(\n  json: string,\n): PlayerExperienceConfigValidationResult {\n  let parsed: unknown;\n\n  try {\n    parsed = JSON.parse(json) as unknown;\n  } catch {\n    return { ok: false, errors: [\"Config JSON is not valid JSON.\"] };\n  }\n\n  if (!isRecord(parsed)) {\n    return { ok: false, errors: [\"Config JSON envelope must be an object.\"] };\n  }\n\n  const envelopeKeys = Object.keys(parsed);\n  const errors: string[] = [];\n\n  for (const key of envelopeKeys) {\n    if (key !== \"schemaVersion\" && key !== \"config\") {\n      errors.push(`envelope.${key} is not supported.`);\n    }\n  }\n  if (!Object.hasOwn(parsed, \"schemaVersion\")) {\n    errors.push(\"envelope.schemaVersion is required.\");\n  } else if (\n    parsed.schemaVersion !== PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION\n  ) {\n    errors.push(\"envelope.schemaVersion is not supported.\");\n  }\n  if (!Object.hasOwn(parsed, \"config\")) {\n    errors.push(\"envelope.config is required.\");\n  }\n\n  if (errors.length > 0) {\n    return { ok: false, errors: Object.freeze(errors) };\n  }\n\n  return validatePlayerExperienceConfig(parsed.config);\n}\n\nexport function serializePlayerExperienceConfig(\n  config: PlayerExperienceConfig,\n): string {\n  const result = validatePlayerExperienceConfig(config);\n\n  if (!result.ok) {\n    throw new TypeError(result.errors.join(\" \"));\n  }\n\n  return JSON.stringify(\n    {\n      schemaVersion: PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION,\n      config: result.value,\n    },\n    null,\n    2,\n  );\n}\n","import type {\n  PlayerExperienceConfig,\n  PlayerState,\n} from \"../contracts/player\";\nimport { resolvePlayerExperienceConfig } from \"./validation\";\n\nexport function createInitialPlayerState(\n  experienceConfig?: Partial<PlayerExperienceConfig>,\n): Readonly<PlayerState> {\n  const resolved = resolvePlayerExperienceConfig(experienceConfig);\n\n  if (!resolved.ok) {\n    throw new TypeError(resolved.errors.join(\" \"));\n  }\n\n  return Object.freeze({\n    currentItem: null,\n    currentItemId: null,\n    currentQueueItemId: null,\n    mediaKind: null,\n    status: \"idle\",\n    currentTimeSec: 0,\n    durationSec: null,\n    volume: resolved.value.initialVolume,\n    muted: false,\n    shuffleEnabled: resolved.value.initialShuffleEnabled,\n    repeatMode: resolved.value.initialRepeatMode,\n    queue: Object.freeze([]),\n    activeContext: null,\n    currentQueueIndex: null,\n    canSeek: false,\n    canGoPrevious: false,\n    canGoNext: false,\n    needsUserGesture: false,\n    lastTransitionCause: null,\n    error: null,\n    experienceConfig: resolved.value,\n  });\n}\n"]}

package/dist/config-Bhyo_y05.d.ts

@@ -0,0 +1,14 @@
+import { q as PlayerExperienceConfig } from './player-DRQO7SLs.js';
+
+interface ConfigValidationSuccess {
+    readonly ok: true;
+    readonly value: Readonly<PlayerExperienceConfig>;
+    readonly errors: readonly [];
+}
+interface ConfigValidationFailure {
+    readonly ok: false;
+    readonly errors: readonly string[];
+}
+type PlayerExperienceConfigValidationResult = ConfigValidationSuccess | ConfigValidationFailure;
+
+export type { ConfigValidationFailure as C, PlayerExperienceConfigValidationResult as P, ConfigValidationSuccess as a };

package/dist/consumer/index.d.ts

@@ -1,4 +1,21 @@
-import { Q as QueueItem, u as PlayerMediaAdapter } from '../player-CE714iU_.js';
+import { c as PlaybackContextInput, Q as QueueItem, v as PlayerMediaAdapter } from '../player-DRQO7SLs.js';
+import { e as PodcastProgramPlaybackModel, R as ReleasePlaybackModel, c as PodcastChapter } from '../content-CVe0cm0y.js';
+
+type PlayerContentContextRejectionReason = "duplicate-content-id" | "duplicate-queue-item-id" | "ready-without-queue-item" | "non-ready-with-queue-item" | "content-context-mismatch";
+interface PlayerContentContextRejection {
+    readonly entryId: string;
+    readonly entryIndex: number;
+    readonly reason: PlayerContentContextRejectionReason;
+}
+interface PlayerContentContextBuildResult {
+    readonly context: Extract<PlaybackContextInput, {
+        readonly mode: "ordered-queue";
+    }>;
+    readonly rejected: readonly PlayerContentContextRejection[];
+}
+declare function buildReleasePlaybackContext(release: ReleasePlaybackModel): PlayerContentContextBuildResult;
+declare function buildPodcastPlaybackContext(program: PodcastProgramPlaybackModel): PlayerContentContextBuildResult;
+declare function findActivePodcastChapter(chapters: readonly PodcastChapter[] | undefined, currentTimeSec: number): PodcastChapter | null;
 
 interface PlayerQueueCandidate<TSource> {
     /** Host-owned stable identity for this occurrence in a queue context. */
@@ -24,4 +41,4 @@ interface PlayerQueueBuildResult {
  */
 declare function buildPlayerQueue<TSource>(candidates: readonly PlayerQueueCandidate<TSource>[], adapter: PlayerMediaAdapter<TSource>): PlayerQueueBuildResult;
 
-export { type PlayerQueueBuildResult, type PlayerQueueCandidate, type PlayerQueueRejection, type PlayerQueueRejectionReason, buildPlayerQueue };
+export { type PlayerContentContextBuildResult, type PlayerContentContextRejection, type PlayerContentContextRejectionReason, type PlayerQueueBuildResult, type PlayerQueueCandidate, type PlayerQueueRejection, type PlayerQueueRejectionReason, buildPlayerQueue, buildPodcastPlaybackContext, buildReleasePlaybackContext, findActivePodcastChapter };