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

package/README.md

@@ -39,6 +39,33 @@ 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

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, h as PlayerAppearance } 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;
@@ -102,4 +105,4 @@ interface BoundCompactPlayerProps {
 }
 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, type UseBoundPlayerOptions, type UseBoundPlayerResult, type UsePlayerResult, deriveBoundPlayerViewState, useBoundPlayer, usePlayer };
+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 };