@gentomiyano/optimized-web-audio-player 0.1.0

package/README.md

@@ -0,0 +1,159 @@
+# 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`.
+
+## 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

@@ -0,0 +1,37 @@
+import { l as PlayerExperienceConfig, u as PlayerState } from '../player-DE9Vqztu.js';
+import { PlayerExperienceConfigValidationResult } from '../contracts/index.js';
+
+declare const PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION: 2;
+declare const PLAYER_EXPERIENCE_CONFIG_LIMITS: Readonly<{
+    fadeMs: Readonly<{
+        min: 0;
+        max: 10000;
+    }>;
+    previousRestartThresholdSec: Readonly<{
+        min: 0;
+        max: 60;
+    }>;
+    waveformOpacity: Readonly<{
+        min: 0;
+        max: 1;
+    }>;
+    initialVolume: Readonly<{
+        min: 0;
+        max: 1;
+    }>;
+    podcastSkipSec: Readonly<{
+        minExclusive: 0;
+        max: 3600;
+    }>;
+}>;
+declare const PREVIEW_PLAYER_EXPERIENCE_CONFIG: Readonly<PlayerExperienceConfig>;
+
+declare function createInitialPlayerState(experienceConfig?: Partial<PlayerExperienceConfig>): Readonly<PlayerState>;
+
+declare function validatePlayerExperienceConfig(value: unknown): PlayerExperienceConfigValidationResult;
+declare function validatePlayerExperienceConfigOverride(value: unknown): PlayerExperienceConfigValidationResult;
+declare function resolvePlayerExperienceConfig(override?: Partial<PlayerExperienceConfig>): PlayerExperienceConfigValidationResult;
+declare function parsePlayerExperienceConfigJson(json: string): PlayerExperienceConfigValidationResult;
+declare function serializePlayerExperienceConfig(config: PlayerExperienceConfig): string;
+
+export { PLAYER_EXPERIENCE_CONFIG_LIMITS, PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION, PREVIEW_PLAYER_EXPERIENCE_CONFIG, createInitialPlayerState, parsePlayerExperienceConfigJson, resolvePlayerExperienceConfig, serializePlayerExperienceConfig, validatePlayerExperienceConfig, validatePlayerExperienceConfigOverride };

package/dist/config/index.js

@@ -0,0 +1,280 @@
+// src/config/defaults.ts
+var PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION = 2;
+var PLAYER_EXPERIENCE_CONFIG_LIMITS = Object.freeze({
+  fadeMs: Object.freeze({ min: 0, max: 1e4 }),
+  previousRestartThresholdSec: Object.freeze({ min: 0, max: 60 }),
+  waveformOpacity: Object.freeze({ min: 0, max: 1 }),
+  initialVolume: Object.freeze({ min: 0, max: 1 }),
+  podcastSkipSec: Object.freeze({ minExclusive: 0, max: 3600 })
+});
+var PREVIEW_PLAYER_EXPERIENCE_CONFIG = Object.freeze({
+  playFadeInMs: 300,
+  pauseFadeOutMs: 600,
+  trackChangeFadeOutMs: 300,
+  trackChangeFadeInMs: 300,
+  seekFadeMs: 120,
+  fadeCurve: "ease-out",
+  previousRestartThresholdSec: 3,
+  seekCommitMode: "on-release",
+  waveformPlayedStateEnabled: true,
+  waveformOpacity: 0.72,
+  initialShuffleEnabled: false,
+  initialRepeatMode: "off",
+  initialVolume: 0.8,
+  persistMode: "none",
+  podcastBackSec: 15,
+  podcastForwardSec: 30,
+  podcastPreviousMode: "previous-episode"
+});
+
+// src/config/validation.ts
+var CONFIG_KEYS = [
+  "playFadeInMs",
+  "pauseFadeOutMs",
+  "trackChangeFadeOutMs",
+  "trackChangeFadeInMs",
+  "seekFadeMs",
+  "fadeCurve",
+  "previousRestartThresholdSec",
+  "seekCommitMode",
+  "waveformPlayedStateEnabled",
+  "waveformOpacity",
+  "initialShuffleEnabled",
+  "initialRepeatMode",
+  "initialVolume",
+  "persistMode",
+  "podcastBackSec",
+  "podcastForwardSec",
+  "podcastPreviousMode"
+];
+var FADE_CURVES = /* @__PURE__ */ new Set([
+  "linear",
+  "ease-in",
+  "ease-out",
+  "equal-power"
+]);
+var SEEK_COMMIT_MODES = /* @__PURE__ */ new Set(["live", "on-release"]);
+var REPEAT_MODES = /* @__PURE__ */ new Set(["off", "all", "one"]);
+var PERSIST_MODES = /* @__PURE__ */ new Set(["none", "session", "local"]);
+var PODCAST_PREVIOUS_MODES = /* @__PURE__ */ new Set([
+  "previous-episode",
+  "restart-episode"
+]);
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function validateFiniteRange(value, path, min, max, errors) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < min || value > max) {
+    errors.push(
+      `${path} must be a finite number between ${String(min)} and ${String(max)}.`
+    );
+    return false;
+  }
+  return true;
+}
+function validateBoolean(value, path, errors) {
+  if (typeof value !== "boolean") {
+    errors.push(`${path} must be a boolean.`);
+    return false;
+  }
+  return true;
+}
+function validateConfigRecord(value, options) {
+  if (!isRecord(value)) {
+    return { ok: false, errors: ["config must be an object."] };
+  }
+  const errors = [];
+  const allowedKeys = new Set(CONFIG_KEYS);
+  for (const key of Object.keys(value)) {
+    if (!allowedKeys.has(key)) {
+      errors.push(`config.${key} is not supported.`);
+    }
+  }
+  if (!options.partial) {
+    for (const key of CONFIG_KEYS) {
+      if (!Object.hasOwn(value, key)) {
+        errors.push(`config.${key} is required.`);
+      }
+    }
+  }
+  const has = (key) => Object.hasOwn(value, key);
+  const fadeLimits = PLAYER_EXPERIENCE_CONFIG_LIMITS.fadeMs;
+  for (const key of [
+    "playFadeInMs",
+    "pauseFadeOutMs",
+    "trackChangeFadeOutMs",
+    "trackChangeFadeInMs",
+    "seekFadeMs"
+  ]) {
+    if (has(key)) {
+      validateFiniteRange(value[key], `config.${key}`, fadeLimits.min, fadeLimits.max, errors);
+    }
+  }
+  const thresholdLimits = PLAYER_EXPERIENCE_CONFIG_LIMITS.previousRestartThresholdSec;
+  if (has("previousRestartThresholdSec")) {
+    validateFiniteRange(
+      value.previousRestartThresholdSec,
+      "config.previousRestartThresholdSec",
+      thresholdLimits.min,
+      thresholdLimits.max,
+      errors
+    );
+  }
+  const volumeLimits = PLAYER_EXPERIENCE_CONFIG_LIMITS.initialVolume;
+  if (has("initialVolume")) {
+    validateFiniteRange(
+      value.initialVolume,
+      "config.initialVolume",
+      volumeLimits.min,
+      volumeLimits.max,
+      errors
+    );
+  }
+  const waveformOpacityLimits = PLAYER_EXPERIENCE_CONFIG_LIMITS.waveformOpacity;
+  if (has("waveformOpacity")) {
+    validateFiniteRange(
+      value.waveformOpacity,
+      "config.waveformOpacity",
+      waveformOpacityLimits.min,
+      waveformOpacityLimits.max,
+      errors
+    );
+  }
+  for (const key of [
+    "waveformPlayedStateEnabled",
+    "initialShuffleEnabled"
+  ]) {
+    if (has(key)) {
+      validateBoolean(value[key], `config.${key}`, errors);
+    }
+  }
+  const skipLimits = PLAYER_EXPERIENCE_CONFIG_LIMITS.podcastSkipSec;
+  for (const key of ["podcastBackSec", "podcastForwardSec"]) {
+    if (has(key)) {
+      const candidate = value[key];
+      const valid = validateFiniteRange(
+        candidate,
+        `config.${key}`,
+        skipLimits.minExclusive,
+        skipLimits.max,
+        errors
+      );
+      if (valid && candidate <= skipLimits.minExclusive) {
+        errors.push(`config.${key} must be greater than 0.`);
+      }
+    }
+  }
+  if (has("fadeCurve") && !FADE_CURVES.has(value.fadeCurve)) {
+    errors.push("config.fadeCurve is not supported.");
+  }
+  if (has("seekCommitMode") && !SEEK_COMMIT_MODES.has(value.seekCommitMode)) {
+    errors.push("config.seekCommitMode is not supported.");
+  }
+  if (has("initialRepeatMode") && !REPEAT_MODES.has(value.initialRepeatMode)) {
+    errors.push("config.initialRepeatMode is not supported.");
+  }
+  if (has("persistMode") && !PERSIST_MODES.has(value.persistMode)) {
+    errors.push("config.persistMode is not supported.");
+  }
+  if (has("podcastPreviousMode") && !PODCAST_PREVIOUS_MODES.has(
+    value.podcastPreviousMode
+  )) {
+    errors.push("config.podcastPreviousMode is not supported.");
+  }
+  if (errors.length > 0) {
+    return { ok: false, errors: Object.freeze(errors) };
+  }
+  const merged = options.partial ? { ...PREVIEW_PLAYER_EXPERIENCE_CONFIG, ...value } : value;
+  return {
+    ok: true,
+    errors: [],
+    value: Object.freeze({ ...merged })
+  };
+}
+function validatePlayerExperienceConfig(value) {
+  return validateConfigRecord(value, { partial: false });
+}
+function validatePlayerExperienceConfigOverride(value) {
+  return validateConfigRecord(value, { partial: true });
+}
+function resolvePlayerExperienceConfig(override) {
+  return validatePlayerExperienceConfigOverride(override ?? {});
+}
+function parsePlayerExperienceConfigJson(json) {
+  let parsed;
+  try {
+    parsed = JSON.parse(json);
+  } catch {
+    return { ok: false, errors: ["Config JSON is not valid JSON."] };
+  }
+  if (!isRecord(parsed)) {
+    return { ok: false, errors: ["Config JSON envelope must be an object."] };
+  }
+  const envelopeKeys = Object.keys(parsed);
+  const errors = [];
+  for (const key of envelopeKeys) {
+    if (key !== "schemaVersion" && key !== "config") {
+      errors.push(`envelope.${key} is not supported.`);
+    }
+  }
+  if (!Object.hasOwn(parsed, "schemaVersion")) {
+    errors.push("envelope.schemaVersion is required.");
+  } else if (parsed.schemaVersion !== PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION) {
+    errors.push("envelope.schemaVersion is not supported.");
+  }
+  if (!Object.hasOwn(parsed, "config")) {
+    errors.push("envelope.config is required.");
+  }
+  if (errors.length > 0) {
+    return { ok: false, errors: Object.freeze(errors) };
+  }
+  return validatePlayerExperienceConfig(parsed.config);
+}
+function serializePlayerExperienceConfig(config) {
+  const result = validatePlayerExperienceConfig(config);
+  if (!result.ok) {
+    throw new TypeError(result.errors.join(" "));
+  }
+  return JSON.stringify(
+    {
+      schemaVersion: PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION,
+      config: result.value
+    },
+    null,
+    2
+  );
+}
+
+// src/config/initial-state.ts
+function createInitialPlayerState(experienceConfig) {
+  const resolved = resolvePlayerExperienceConfig(experienceConfig);
+  if (!resolved.ok) {
+    throw new TypeError(resolved.errors.join(" "));
+  }
+  return Object.freeze({
+    currentItem: null,
+    currentItemId: null,
+    currentQueueItemId: null,
+    mediaKind: null,
+    status: "idle",
+    currentTimeSec: 0,
+    durationSec: null,
+    volume: resolved.value.initialVolume,
+    muted: false,
+    shuffleEnabled: resolved.value.initialShuffleEnabled,
+    repeatMode: resolved.value.initialRepeatMode,
+    queue: Object.freeze([]),
+    currentQueueIndex: null,
+    canSeek: false,
+    canGoPrevious: false,
+    canGoNext: false,
+    needsUserGesture: false,
+    lastTransitionCause: null,
+    error: null,
+    experienceConfig: resolved.value
+  });
+}
+
+export { PLAYER_EXPERIENCE_CONFIG_LIMITS, PLAYER_EXPERIENCE_CONFIG_SCHEMA_VERSION, PREVIEW_PLAYER_EXPERIENCE_CONFIG, createInitialPlayerState, parsePlayerExperienceConfigJson, resolvePlayerExperienceConfig, serializePlayerExperienceConfig, validatePlayerExperienceConfig, validatePlayerExperienceConfigOverride };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +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\";\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    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/consumer/index.d.ts

@@ -0,0 +1,27 @@
+import { Q as QueueItem, q as PlayerMediaAdapter } from '../player-DE9Vqztu.js';
+
+interface PlayerQueueCandidate<TSource> {
+    /** Host-owned stable identity for this occurrence in a queue context. */
+    readonly queueItemId: string;
+    readonly source: TSource;
+}
+type PlayerQueueRejectionReason = "not-playable" | "duplicate-queue-item-id";
+interface PlayerQueueRejection {
+    readonly candidateIndex: number;
+    readonly queueItemId: string;
+    readonly reason: PlayerQueueRejectionReason;
+}
+interface PlayerQueueBuildResult {
+    readonly queue: readonly QueueItem[];
+    readonly rejected: readonly PlayerQueueRejection[];
+}
+/**
+ * Builds a Core queue from consumer records that already passed Host access
+ * policy. Candidate order is preserved. The same media item may occur more
+ * than once when each occurrence has a unique queueItemId.
+ *
+ * The result retains only Player items, never the consumer record itself.
+ */
+declare function buildPlayerQueue<TSource>(candidates: readonly PlayerQueueCandidate<TSource>[], adapter: PlayerMediaAdapter<TSource>): PlayerQueueBuildResult;
+
+export { type PlayerQueueBuildResult, type PlayerQueueCandidate, type PlayerQueueRejection, type PlayerQueueRejectionReason, buildPlayerQueue };

package/dist/consumer/index.js

@@ -0,0 +1,38 @@
+// src/consumer/queue.ts
+function buildPlayerQueue(candidates, adapter) {
+  const queue = [];
+  const rejected = [];
+  const seenQueueItemIds = /* @__PURE__ */ new Set();
+  candidates.forEach((candidate, candidateIndex) => {
+    if (seenQueueItemIds.has(candidate.queueItemId)) {
+      rejected.push(Object.freeze({
+        candidateIndex,
+        queueItemId: candidate.queueItemId,
+        reason: "duplicate-queue-item-id"
+      }));
+      return;
+    }
+    seenQueueItemIds.add(candidate.queueItemId);
+    const item = adapter.toPlayerMediaItem(candidate.source);
+    if (item === null) {
+      rejected.push(Object.freeze({
+        candidateIndex,
+        queueItemId: candidate.queueItemId,
+        reason: "not-playable"
+      }));
+      return;
+    }
+    queue.push(Object.freeze({
+      queueItemId: candidate.queueItemId,
+      item
+    }));
+  });
+  return Object.freeze({
+    queue: Object.freeze(queue),
+    rejected: Object.freeze(rejected)
+  });
+}
+
+export { buildPlayerQueue };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/consumer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/consumer/queue.ts"],"names":[],"mappings":";AAiCO,SAAS,gBAAA,CACd,YACA,OAAA,EACwB;AACxB,EAAA,MAAM,QAAqB,EAAC;AAC5B,EAAA,MAAM,WAAmC,EAAC;AAC1C,EAAA,MAAM,gBAAA,uBAAuB,GAAA,EAAY;AAEzC,EAAA,UAAA,CAAW,OAAA,CAAQ,CAAC,SAAA,EAAW,cAAA,KAAmB;AAChD,IAAA,IAAI,gBAAA,CAAiB,GAAA,CAAI,SAAA,CAAU,WAAW,CAAA,EAAG;AAC/C,MAAA,QAAA,CAAS,IAAA,CAAK,OAAO,MAAA,CAAO;AAAA,QAC1B,cAAA;AAAA,QACA,aAAa,SAAA,CAAU,WAAA;AAAA,QACvB,MAAA,EAAQ;AAAA,OACT,CAAC,CAAA;AACF,MAAA;AAAA,IACF;AACA,IAAA,gBAAA,CAAiB,GAAA,CAAI,UAAU,WAAW,CAAA;AAE1C,IAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,iBAAA,CAAkB,SAAA,CAAU,MAAM,CAAA;AACvD,IAAA,IAAI,SAAS,IAAA,EAAM;AACjB,MAAA,QAAA,CAAS,IAAA,CAAK,OAAO,MAAA,CAAO;AAAA,QAC1B,cAAA;AAAA,QACA,aAAa,SAAA,CAAU,WAAA;AAAA,QACvB,MAAA,EAAQ;AAAA,OACT,CAAC,CAAA;AACF,MAAA;AAAA,IACF;AAEA,IAAA,KAAA,CAAM,IAAA,CAAK,OAAO,MAAA,CAAO;AAAA,MACvB,aAAa,SAAA,CAAU,WAAA;AAAA,MACvB;AAAA,KACD,CAAC,CAAA;AAAA,EACJ,CAAC,CAAA;AAED,EAAA,OAAO,OAAO,MAAA,CAAO;AAAA,IACnB,KAAA,EAAO,MAAA,CAAO,MAAA,CAAO,KAAK,CAAA;AAAA,IAC1B,QAAA,EAAU,MAAA,CAAO,MAAA,CAAO,QAAQ;AAAA,GACjC,CAAA;AACH","file":"index.js","sourcesContent":["import type {\n  PlayerMediaAdapter,\n  QueueItem,\n} from \"../contracts/player\";\n\nexport interface PlayerQueueCandidate<TSource> {\n  /** Host-owned stable identity for this occurrence in a queue context. */\n  readonly queueItemId: string;\n  readonly source: TSource;\n}\n\nexport type PlayerQueueRejectionReason =\n  | \"not-playable\"\n  | \"duplicate-queue-item-id\";\n\nexport interface PlayerQueueRejection {\n  readonly candidateIndex: number;\n  readonly queueItemId: string;\n  readonly reason: PlayerQueueRejectionReason;\n}\n\nexport interface PlayerQueueBuildResult {\n  readonly queue: readonly QueueItem[];\n  readonly rejected: readonly PlayerQueueRejection[];\n}\n\n/**\n * Builds a Core queue from consumer records that already passed Host access\n * policy. Candidate order is preserved. The same media item may occur more\n * than once when each occurrence has a unique queueItemId.\n *\n * The result retains only Player items, never the consumer record itself.\n */\nexport function buildPlayerQueue<TSource>(\n  candidates: readonly PlayerQueueCandidate<TSource>[],\n  adapter: PlayerMediaAdapter<TSource>,\n): PlayerQueueBuildResult {\n  const queue: QueueItem[] = [];\n  const rejected: PlayerQueueRejection[] = [];\n  const seenQueueItemIds = new Set<string>();\n\n  candidates.forEach((candidate, candidateIndex) => {\n    if (seenQueueItemIds.has(candidate.queueItemId)) {\n      rejected.push(Object.freeze({\n        candidateIndex,\n        queueItemId: candidate.queueItemId,\n        reason: \"duplicate-queue-item-id\",\n      }));\n      return;\n    }\n    seenQueueItemIds.add(candidate.queueItemId);\n\n    const item = adapter.toPlayerMediaItem(candidate.source);\n    if (item === null) {\n      rejected.push(Object.freeze({\n        candidateIndex,\n        queueItemId: candidate.queueItemId,\n        reason: \"not-playable\",\n      }));\n      return;\n    }\n\n    queue.push(Object.freeze({\n      queueItemId: candidate.queueItemId,\n      item,\n    }));\n  });\n\n  return Object.freeze({\n    queue: Object.freeze(queue),\n    rejected: Object.freeze(rejected),\n  });\n}\n"]}

package/dist/consumer-smoke/node_modules/.modules.yaml

@@ -0,0 +1,30 @@
+{
+  "hoistedDependencies": {
+    "scheduler@0.27.0": {
+      "scheduler": "private"
+    }
+  },
+  "hoistPattern": [
+    "*"
+  ],
+  "included": {
+    "dependencies": true,
+    "devDependencies": true,
+    "optionalDependencies": true
+  },
+  "injectedDeps": {},
+  "layoutVersion": 5,
+  "nodeLinker": "isolated",
+  "packageManager": "pnpm@11.9.0",
+  "pendingBuilds": [],
+  "publicHoistPattern": [],
+  "prunedAt": "Sat, 01 Aug 2026 10:23:34 GMT",
+  "registries": {
+    "default": "https://registry.npmjs.org/",
+    "@jsr": "https://npm.jsr.io/"
+  },
+  "skipped": [],
+  "storeDir": "M:\\.pnpm-store\\v11",
+  "virtualStoreDir": "M:\\Codex Local\\optimized-web-audio-player\\dist\\consumer-smoke\\node_modules\\.pnpm",
+  "virtualStoreDirMaxLength": 60
+}

package/dist/consumer-smoke/node_modules/.package-map.json

@@ -0,0 +1 @@
+{"packages":{".":{"url":"..","dependencies":{"@gentomiyano/optimized-web-audio-player":"@gentomiyano/optimized-web-audio-player@file:../gentomiyano-optimized-web-audio-player-0.1.0.tgz(react-dom@19.2.8(react@19.2.8))(react@19.2.8)","player-release-consumer-smoke":".","react":"react@19.2.8","react-dom":"react-dom@19.2.8(react@19.2.8)"}},"@gentomiyano/optimized-web-audio-player@file:../gentomiyano-optimized-web-audio-player-0.1.0.tgz(react-dom@19.2.8(react@19.2.8))(react@19.2.8)":{"url":"./.pnpm/@gentomiyano+optimized-web-_ecc6545b5453980ce895c6698641da69/node_modules/@gentomiyano/optimized-web-audio-player","dependencies":{"@gentomiyano/optimized-web-audio-player":"@gentomiyano/optimized-web-audio-player@file:../gentomiyano-optimized-web-audio-player-0.1.0.tgz(react-dom@19.2.8(react@19.2.8))(react@19.2.8)","react":"react@19.2.8","react-dom":"react-dom@19.2.8(react@19.2.8)"}},"react-dom@19.2.8(react@19.2.8)":{"url":"./.pnpm/react-dom@19.2.8_react@19.2.8/node_modules/react-dom","dependencies":{"react":"react@19.2.8","react-dom":"react-dom@19.2.8(react@19.2.8)","scheduler":"scheduler@0.27.0"}},"react@19.2.8":{"url":"./.pnpm/react@19.2.8/node_modules/react","dependencies":{"react":"react@19.2.8"}},"scheduler@0.27.0":{"url":"./.pnpm/scheduler@0.27.0/node_modules/scheduler","dependencies":{"scheduler":"scheduler@0.27.0"}}}}