@gentomiyano/optimized-web-audio-player 0.2.0 → 0.2.2

package/README.md

@@ -39,6 +39,31 @@ 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`.
 
+## 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`

package/dist/config/index.d.ts

@@ -1,4 +1,4 @@
-import { p as PlayerExperienceConfig, y as PlayerState } from '../player-BxNFzRq4.js';
+import { p as PlayerExperienceConfig, z as PlayerState } from '../player-CE714iU_.js';
 import { PlayerExperienceConfigValidationResult } from '../contracts/index.js';
 
 declare const PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION: 2;

package/dist/consumer/index.d.ts

@@ -1,4 +1,4 @@
-import { Q as QueueItem, u as PlayerMediaAdapter } from '../player-BxNFzRq4.js';
+import { Q as QueueItem, u as PlayerMediaAdapter } from '../player-CE714iU_.js';
 
 interface PlayerQueueCandidate<TSource> {
     /** Host-owned stable identity for this occurrence in a queue context. */

package/dist/contracts/index.d.ts

@@ -1,5 +1,5 @@
-import { p as PlayerExperienceConfig } from '../player-BxNFzRq4.js';
-export { A as ActivatePlaybackContextOptions, B as BoundPlayerCommands, a as BoundPlayerViewState, F as FadeCurve, M as MediaKind, P as PauseOptions, b as PersistMode, c as PlaybackContextInput, d as PlaybackContextMode, e as PlaybackContextState, f as PlaybackStatus, g as PlaybackTransitionCause, h as PlayerAppearance, i as PlayerCommandResult, j as PlayerCommands, k as PlayerConfigImportResult, l as PlayerDebugController, m as PlayerDebugSnapshot, n as PlayerError, o as PlayerErrorCode, q as PlayerExperienceConfigEnvelope, r as PlayerExperienceConfigStore, s as PlayerExperiencePreset, t as PlayerHostConfig, u as PlayerMediaAdapter, v as PlayerMediaItem, w as PlayerMediaSource, x as PlayerMediaSyncReason, y as PlayerState, z as PlayerStore, C as PlayerViewProps, D as PlayerWaveform, E as PodcastPreviousMode, Q as QueueItem, R as RepeatMode, S as SeekCommitMode, G as SetQueueOptions, H as StopOptions } from '../player-BxNFzRq4.js';
+import { p as PlayerExperienceConfig } from '../player-CE714iU_.js';
+export { A as ActivatePlaybackContextOptions, B as BoundPlayerCommands, a as BoundPlayerViewState, F as FadeCurve, M as MediaKind, P as PauseOptions, b as PersistMode, c as PlaybackContextInput, d as PlaybackContextMode, e as PlaybackContextState, f as PlaybackStatus, g as PlaybackTransitionCause, h as PlayerAppearance, i as PlayerCommandResult, j as PlayerCommands, k as PlayerConfigImportResult, l as PlayerDebugController, m as PlayerDebugSnapshot, n as PlayerError, o as PlayerErrorCode, q as PlayerExperienceConfigEnvelope, r as PlayerExperienceConfigStore, s as PlayerExperiencePreset, t as PlayerHostConfig, u as PlayerMediaAdapter, v as PlayerMediaItem, w as PlayerMediaSource, x as PlayerMediaSyncReason, y as PlayerRuntimeStatus, z as PlayerState, C as PlayerStore, D as PlayerViewProps, E as PlayerWaveform, G as PodcastPreviousMode, Q as QueueItem, R as RepeatMode, S as SeekCommitMode, H as SetQueueOptions, I as StopOptions } from '../player-CE714iU_.js';
 
 interface ConfigValidationSuccess {
     readonly ok: true;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { ConfigValidationFailure, ConfigValidationSuccess, PlayerExperienceConfigValidationResult } from './contracts/index.js';
-export { A as ActivatePlaybackContextOptions, B as BoundPlayerCommands, a as BoundPlayerViewState, F as FadeCurve, M as MediaKind, P as PauseOptions, b as PersistMode, c as PlaybackContextInput, d as PlaybackContextMode, e as PlaybackContextState, f as PlaybackStatus, g as PlaybackTransitionCause, h as PlayerAppearance, i as PlayerCommandResult, j as PlayerCommands, k as PlayerConfigImportResult, l as PlayerDebugController, m as PlayerDebugSnapshot, n as PlayerError, o as PlayerErrorCode, p as PlayerExperienceConfig, q as PlayerExperienceConfigEnvelope, r as PlayerExperienceConfigStore, s as PlayerExperiencePreset, t as PlayerHostConfig, u as PlayerMediaAdapter, v as PlayerMediaItem, w as PlayerMediaSource, x as PlayerMediaSyncReason, y as PlayerState, z as PlayerStore, C as PlayerViewProps, D as PlayerWaveform, E as PodcastPreviousMode, Q as QueueItem, R as RepeatMode, S as SeekCommitMode, G as SetQueueOptions, H as StopOptions } from './player-BxNFzRq4.js';
+export { A as ActivatePlaybackContextOptions, B as BoundPlayerCommands, a as BoundPlayerViewState, F as FadeCurve, M as MediaKind, P as PauseOptions, b as PersistMode, c as PlaybackContextInput, d as PlaybackContextMode, e as PlaybackContextState, f as PlaybackStatus, g as PlaybackTransitionCause, h as PlayerAppearance, i as PlayerCommandResult, j as PlayerCommands, k as PlayerConfigImportResult, l as PlayerDebugController, m as PlayerDebugSnapshot, n as PlayerError, o as PlayerErrorCode, p as PlayerExperienceConfig, q as PlayerExperienceConfigEnvelope, r as PlayerExperienceConfigStore, s as PlayerExperiencePreset, t as PlayerHostConfig, u as PlayerMediaAdapter, v as PlayerMediaItem, w as PlayerMediaSource, x as PlayerMediaSyncReason, y as PlayerRuntimeStatus, z as PlayerState, C as PlayerStore, D as PlayerViewProps, E as PlayerWaveform, G as PodcastPreviousMode, Q as QueueItem, R as RepeatMode, S as SeekCommitMode, H as SetQueueOptions, I as StopOptions } from './player-CE714iU_.js';
 export { PLAYER_EXPERIENCE_CONFIG_LIMITS, PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION, PREVIEW_PLAYER_EXPERIENCE_CONFIG, createInitialPlayerState, parsePlayerExperienceConfigJson, resolvePlayerExperienceConfig, serializePlayerExperienceConfig, validatePlayerExperienceConfig, validatePlayerExperienceConfigOverride } from './config/index.js';
 export { AudioSampleEncoding, FutureUploadFormat, MEDIA_DELIVERY_CONTRACT_VERSION, MediaAccessClass, MediaDeliveryDescriptor, MediaDeliverySourceReference, MediaLoudnessMetadata, MediaSourceRole, MediaStorageReferences, MediaUploadEvidence, MediaUploadValidationResult, NormalizedUploadIdentity, PlaybackSourceResolveErrorCode, PlaybackSourceResolveReason, PlaybackSourceResolveRequest, PlaybackSourceResolveResult, PlayerDeliveryHostAdapter, PlayerMediaDescriptor, ProcessedMediaMetadata, ResolvedPlaybackSource, SupportedUploadFormat, UploadHeaderFormat, UploadValidationError, UploadValidationErrorCode, WaveformPeaksV1, validateMediaUploadEvidence, validateWaveformPeaks } from './media-delivery/index.js';
 export { GainPort, GainTransition, PlayerPersistencePort, PodcastProgress, PodcastProgressPort } from './ports/index.js';
-export { M as MediaElementPort, a as MediaElementStateSnapshot, P as PlayerMediaEvent, b as PlayerMediaEventListener, c as PlayerMediaEventType } from './media-element-DyMO-PhK.js';
+export { M as MediaElementPort, a as MediaElementStateSnapshot, P as PlayerMediaEvent, b as PlayerMediaEventListener, c as PlayerMediaEventType } from './media-element-vFtmw4mQ.js';

package/dist/media-delivery/index.d.ts

@@ -1,4 +1,4 @@
-import { w as PlayerMediaSource, v as PlayerMediaItem } from '../player-BxNFzRq4.js';
+import { w as PlayerMediaSource, v as PlayerMediaItem } from '../player-CE714iU_.js';
 
 declare const MEDIA_DELIVERY_CONTRACT_VERSION: 1;
 type SupportedUploadFormat = "wav" | "mp3";

package/dist/{media-element-DyMO-PhK.d.ts → media-element-vFtmw4mQ.d.ts}

@@ -1,4 +1,4 @@
-import { n as PlayerError, w as PlayerMediaSource } from './player-BxNFzRq4.js';
+import { n as PlayerError, w as PlayerMediaSource } from './player-CE714iU_.js';
 
 type PlayerMediaEventType = "loadstart" | "loadedmetadata" | "canplay" | "play" | "playing" | "pause" | "waiting" | "stalled" | "seeking" | "seeked" | "timeupdate" | "ended" | "error" | "durationchange" | "volumechange";
 interface PlayerMediaEvent {

package/dist/{player-BxNFzRq4.d.ts → player-CE714iU_.d.ts}

@@ -1,4 +1,5 @@
 type PlaybackStatus = "idle" | "loading" | "playing" | "paused" | "seeking" | "ended" | "error";
+type PlayerRuntimeStatus = "pending" | "ready";
 type PlaybackTransitionCause = "user-play" | "user-pause" | "user-stop" | "natural-end" | "os-interruption" | "background-suspension" | "autoplay-blocked" | "source-error";
 type PlayerMediaSyncReason = "visibilitychange" | "pageshow" | "focus" | "audio-context-statechange" | "manual";
 type RepeatMode = "off" | "all" | "one";
@@ -261,4 +262,4 @@ interface PlayerDebugController {
     exportProductionConfigJson(): string;
 }
 
-export type { ActivatePlaybackContextOptions as A, BoundPlayerCommands as B, PlayerViewProps as C, PlayerWaveform as D, PodcastPreviousMode as E, FadeCurve as F, SetQueueOptions as G, StopOptions as H, MediaKind as M, PauseOptions as P, QueueItem as Q, RepeatMode as R, SeekCommitMode as S, BoundPlayerViewState as a, PersistMode as b, PlaybackContextInput as c, PlaybackContextMode as d, PlaybackContextState as e, PlaybackStatus as f, PlaybackTransitionCause as g, PlayerAppearance as h, PlayerCommandResult as i, PlayerCommands as j, PlayerConfigImportResult as k, PlayerDebugController as l, PlayerDebugSnapshot as m, PlayerError as n, PlayerErrorCode as o, PlayerExperienceConfig as p, PlayerExperienceConfigEnvelope as q, PlayerExperienceConfigStore as r, PlayerExperiencePreset as s, PlayerHostConfig as t, PlayerMediaAdapter as u, PlayerMediaItem as v, PlayerMediaSource as w, PlayerMediaSyncReason as x, PlayerState as y, PlayerStore as z };
+export type { ActivatePlaybackContextOptions as A, BoundPlayerCommands as B, PlayerStore as C, PlayerViewProps as D, PlayerWaveform as E, FadeCurve as F, PodcastPreviousMode as G, SetQueueOptions as H, StopOptions as I, MediaKind as M, PauseOptions as P, QueueItem as Q, RepeatMode as R, SeekCommitMode as S, BoundPlayerViewState as a, PersistMode as b, PlaybackContextInput as c, PlaybackContextMode as d, PlaybackContextState as e, PlaybackStatus as f, PlaybackTransitionCause as g, PlayerAppearance as h, PlayerCommandResult as i, PlayerCommands as j, PlayerConfigImportResult as k, PlayerDebugController as l, PlayerDebugSnapshot as m, PlayerError as n, PlayerErrorCode as o, PlayerExperienceConfig as p, PlayerExperienceConfigEnvelope as q, PlayerExperienceConfigStore as r, PlayerExperiencePreset as s, PlayerHostConfig as t, PlayerMediaAdapter as u, PlayerMediaItem as v, PlayerMediaSource as w, PlayerMediaSyncReason as x, PlayerRuntimeStatus as y, PlayerState as z };

package/dist/ports/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FadeCurve } from '../player-BxNFzRq4.js';
-export { M as MediaElementPort, a as MediaElementStateSnapshot, P as PlayerMediaEvent, b as PlayerMediaEventListener, c as PlayerMediaEventType } from '../media-element-DyMO-PhK.js';
+import { F as FadeCurve } from '../player-CE714iU_.js';
+export { M as MediaElementPort, a as MediaElementStateSnapshot, P as PlayerMediaEvent, b as PlayerMediaEventListener, c as PlayerMediaEventType } from '../media-element-vFtmw4mQ.js';
 
 interface GainTransition {
     readonly durationMs: number;

package/dist/react/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { j as PlayerCommands, x as PlayerMediaSyncReason, Q as QueueItem, p as PlayerExperienceConfig, z as PlayerStore, r as PlayerExperienceConfigStore, y as PlayerState, c as PlaybackContextInput, a as BoundPlayerViewState, B as BoundPlayerCommands } from '../player-BxNFzRq4.js';
-import { c as PlayerMediaEventType, a as MediaElementStateSnapshot } from '../media-element-DyMO-PhK.js';
+import { j as PlayerCommands, x as PlayerMediaSyncReason, Q as QueueItem, p as PlayerExperienceConfig, y as PlayerRuntimeStatus, C as PlayerStore, r as PlayerExperienceConfigStore, z as PlayerState, c as PlaybackContextInput, a as BoundPlayerViewState, B as BoundPlayerCommands, h as PlayerAppearance } from '../player-CE714iU_.js';
+import { c as PlayerMediaEventType, a as MediaElementStateSnapshot } from '../media-element-vFtmw4mQ.js';
 
 type PlayerAudioMode = "auto" | "web-audio" | "html-media";
 type ResolvedPlayerAudioMode = "web-audio" | "html-media";
@@ -44,6 +44,7 @@ interface PlayerProviderProps {
     readonly initialQueue?: readonly QueueItem[];
     readonly initialQueueItemId?: string;
     readonly experienceConfig?: Partial<PlayerExperienceConfig>;
+    /** Used only when children is null or undefined while Runtime is pending. */
     readonly loadingFallback?: ReactNode;
     /**
      * auto uses native HTML audio on iOS/iPadOS and Web Audio elsewhere.
@@ -54,6 +55,7 @@ interface PlayerProviderProps {
     readonly onDiagnosticEvent?: PlayerRuntimeDiagnosticListener;
 }
 interface PlayerRuntimeContextValue {
+    readonly runtimeStatus: PlayerRuntimeStatus;
     readonly store: PlayerStore;
     readonly commands: PlayerCommands;
     readonly experience: PlayerExperienceConfigStore;
@@ -73,6 +75,7 @@ interface MiniPlayerHostProps {
 declare function MiniPlayerHost({ children, className, onInsetChange, visible, }: MiniPlayerHostProps): react.JSX.Element | null;
 
 interface UsePlayerResult {
+    readonly runtimeStatus: PlayerRuntimeStatus;
     readonly state: Readonly<PlayerState>;
     readonly commands: PlayerCommands;
     readonly experience: PlayerExperienceConfigStore;
@@ -94,4 +97,12 @@ interface UseBoundPlayerResult {
 declare function deriveBoundPlayerViewState(playerState: Readonly<PlayerState>, contextId: string, queueItem: QueueItem): Readonly<BoundPlayerViewState>;
 declare function useBoundPlayer({ context, queueItem, }: UseBoundPlayerOptions): UseBoundPlayerResult;
 
-export { MiniPlayerHost, type MiniPlayerHostProps, PlayerProvider, type PlayerProviderProps, type PlayerRuntimeContextValue, type PlayerRuntimeDiagnosticEvent, type PlayerRuntimeDiagnosticListener, type PlayerRuntimeDiagnosticPayload, type UseBoundPlayerOptions, type UseBoundPlayerResult, type UsePlayerResult, deriveBoundPlayerViewState, useBoundPlayer, usePlayer };
+interface BoundCompactPlayerProps {
+    readonly appearance: PlayerAppearance;
+    readonly context: PlaybackContextInput;
+    readonly queueItem: QueueItem;
+    readonly className?: string;
+}
+declare function BoundCompactPlayer({ appearance, className, context, queueItem, }: BoundCompactPlayerProps): react.JSX.Element;
+
+export { BoundCompactPlayer, type BoundCompactPlayerProps, MiniPlayerHost, type MiniPlayerHostProps, PlayerProvider, type PlayerProviderProps, type PlayerRuntimeContextValue, type PlayerRuntimeDiagnosticEvent, type PlayerRuntimeDiagnosticListener, type PlayerRuntimeDiagnosticPayload, PlayerRuntimeStatus, type UseBoundPlayerOptions, type UseBoundPlayerResult, type UsePlayerResult, deriveBoundPlayerViewState, useBoundPlayer, usePlayer };