@gentomiyano/optimized-web-audio-player 0.1.0

package/dist/testing/index.js

@@ -0,0 +1,365 @@
+// src/adapters/mock/mock-player-adapter.ts
+var MOCK_RECORDS = Object.freeze([
+  Object.freeze({
+    id: "sample-track-alpha",
+    playable: true,
+    title: "Sample Track Alpha",
+    creatorName: "Sample Creator",
+    collectionTitle: "Sample Collection",
+    sourceUrl: "/mock-audio/sample-track-alpha.mp3",
+    durationHintSec: 185,
+    waveformPeaks: Object.freeze([0.18, 0.42, 0.7, 0.54, 0.82, 0.33])
+  }),
+  Object.freeze({
+    id: "sample-track-beta",
+    playable: true,
+    title: "Sample Track Beta",
+    creatorName: "Sample Creator",
+    collectionTitle: "Sample Collection",
+    sourceUrl: "/mock-audio/sample-track-beta.mp3",
+    durationHintSec: 212,
+    waveformPeaks: Object.freeze([0.28, 0.5, 0.36, 0.76, 0.61, 0.24])
+  })
+]);
+var RECOVERABLE_ERROR = Object.freeze({
+  code: "network",
+  recoverable: true,
+  messageKey: "player.error.network"
+});
+var FATAL_ERROR = Object.freeze({
+  code: "unsupported",
+  recoverable: false,
+  messageKey: "player.error.unsupported"
+});
+var MOCK_PLAYER_SCENARIOS = /* @__PURE__ */ new Set([
+  "success",
+  "loading",
+  "duration-unknown",
+  "missing-waveform",
+  "recoverable-error",
+  "fatal-error"
+]);
+function wait(delayMs) {
+  if (delayMs <= 0) {
+    return Promise.resolve();
+  }
+  return new Promise((resolve) => {
+    setTimeout(resolve, delayMs);
+  });
+}
+var MockPlayerAdapter = class {
+  #scenario;
+  #delayMs;
+  constructor(options = {}) {
+    this.#scenario = options.scenario ?? "success";
+    this.#delayMs = options.delayMs ?? 0;
+    if (!MOCK_PLAYER_SCENARIOS.has(this.#scenario)) {
+      throw new TypeError("Mock scenario is not supported.");
+    }
+    if (!Number.isFinite(this.#delayMs) || this.#delayMs < 0 || this.#delayMs > 3e4) {
+      throw new RangeError("Mock delayMs must be between 0 and 30000.");
+    }
+  }
+  toPlayerMediaItem(source) {
+    if (!source.playable || typeof source.sourceUrl !== "string" || source.sourceUrl.length === 0) {
+      return null;
+    }
+    const base = {
+      id: source.id,
+      kind: "track",
+      title: source.title,
+      source: {
+        url: source.sourceUrl,
+        crossOrigin: "anonymous",
+        mimeType: "audio/mpeg"
+      },
+      ...source.creatorName === void 0 ? {} : { creatorName: source.creatorName },
+      ...source.collectionTitle === void 0 ? {} : { collectionTitle: source.collectionTitle },
+      ...this.#scenario === "duration-unknown" || source.durationHintSec === void 0 ? {} : { durationHintSec: source.durationHintSec }
+    };
+    return {
+      ...base,
+      ...this.#scenario === "missing-waveform" || source.waveformPeaks === void 0 ? {} : {
+        waveform: {
+          version: 1,
+          peaks: source.waveformPeaks
+        }
+      }
+    };
+  }
+  async loadScenario() {
+    await wait(this.#delayMs);
+    const queue = MOCK_RECORDS.flatMap((record, index) => {
+      const item = this.toPlayerMediaItem(record);
+      return item === null ? [] : [{ queueItemId: `sample-queue-${String(index + 1)}`, item }];
+    });
+    return Object.freeze({
+      scenario: this.#scenario,
+      queue: Object.freeze(queue),
+      initialError: this.#scenario === "recoverable-error" ? RECOVERABLE_ERROR : this.#scenario === "fatal-error" ? FATAL_ERROR : null,
+      remainsLoading: this.#scenario === "loading"
+    });
+  }
+};
+var mockMediaRecords = MOCK_RECORDS;
+
+// src/config/defaults.ts
+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.`);
+    }
+  }
+  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 = { ...PREVIEW_PLAYER_EXPERIENCE_CONFIG, ...value } ;
+  return {
+    ok: true,
+    errors: [],
+    value: Object.freeze({ ...merged })
+  };
+}
+function validatePlayerExperienceConfigOverride(value) {
+  return validateConfigRecord(value);
+}
+function resolvePlayerExperienceConfig(override) {
+  return validatePlayerExperienceConfigOverride(override ?? {});
+}
+
+// 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
+  });
+}
+
+// src/testing/fixtures.ts
+function createPlayerMediaItemFixture(overrides = {}) {
+  return {
+    id: "fixture-track",
+    kind: "track",
+    title: "Fixture Track",
+    creatorName: "Fixture Creator",
+    source: {
+      url: "/mock-audio/fixture-track.mp3",
+      mimeType: "audio/mpeg",
+      crossOrigin: "anonymous"
+    },
+    durationHintSec: 180,
+    waveform: {
+      version: 1,
+      peaks: [0.2, 0.6, 0.4, 0.8]
+    },
+    ...overrides
+  };
+}
+function createQueueItemFixture(overrides = {}) {
+  return {
+    queueItemId: "fixture-queue-item",
+    item: createPlayerMediaItemFixture(),
+    ...overrides
+  };
+}
+function createPlayerStateFixture(overrides = {}, experienceConfig) {
+  const initial = createInitialPlayerState(experienceConfig);
+  return Object.freeze({
+    ...initial,
+    ...overrides
+  });
+}
+
+export { MockPlayerAdapter, createPlayerMediaItemFixture, createPlayerStateFixture, createQueueItemFixture, mockMediaRecords };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/mock/mock-player-adapter.ts","../../src/config/defaults.ts","../../src/config/validation.ts","../../src/config/initial-state.ts","../../src/testing/fixtures.ts"],"names":[],"mappings":";AAsCA,IAAM,YAAA,GAA2C,OAAO,MAAA,CAAO;AAAA,EAC7D,OAAO,MAAA,CAAO;AAAA,IACZ,EAAA,EAAI,oBAAA;AAAA,IACJ,QAAA,EAAU,IAAA;AAAA,IACV,KAAA,EAAO,oBAAA;AAAA,IACP,WAAA,EAAa,gBAAA;AAAA,IACb,eAAA,EAAiB,mBAAA;AAAA,IACjB,SAAA,EAAW,oCAAA;AAAA,IACX,eAAA,EAAiB,GAAA;AAAA,IACjB,aAAA,EAAe,MAAA,CAAO,MAAA,CAAO,CAAC,IAAA,EAAM,MAAM,GAAA,EAAK,IAAA,EAAM,IAAA,EAAM,IAAI,CAAC;AAAA,GACjE,CAAA;AAAA,EACD,OAAO,MAAA,CAAO;AAAA,IACZ,EAAA,EAAI,mBAAA;AAAA,IACJ,QAAA,EAAU,IAAA;AAAA,IACV,KAAA,EAAO,mBAAA;AAAA,IACP,WAAA,EAAa,gBAAA;AAAA,IACb,eAAA,EAAiB,mBAAA;AAAA,IACjB,SAAA,EAAW,mCAAA;AAAA,IACX,eAAA,EAAiB,GAAA;AAAA,IACjB,aAAA,EAAe,MAAA,CAAO,MAAA,CAAO,CAAC,IAAA,EAAM,KAAK,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAI,CAAC;AAAA,GACjE;AACH,CAAC,CAAA;AAED,IAAM,iBAAA,GAAiC,OAAO,MAAA,CAAO;AAAA,EACnD,IAAA,EAAM,SAAA;AAAA,EACN,WAAA,EAAa,IAAA;AAAA,EACb,UAAA,EAAY;AACd,CAAC,CAAA;AAED,IAAM,WAAA,GAA2B,OAAO,MAAA,CAAO;AAAA,EAC7C,IAAA,EAAM,aAAA;AAAA,EACN,WAAA,EAAa,KAAA;AAAA,EACb,UAAA,EAAY;AACd,CAAC,CAAA;AAED,IAAM,qBAAA,uBAA4B,GAAA,CAAwB;AAAA,EACxD,SAAA;AAAA,EACA,SAAA;AAAA,EACA,kBAAA;AAAA,EACA,kBAAA;AAAA,EACA,mBAAA;AAAA,EACA;AACF,CAAC,CAAA;AAED,SAAS,KAAK,OAAA,EAAgC;AAC5C,EAAA,IAAI,WAAW,CAAA,EAAG;AAChB,IAAA,OAAO,QAAQ,OAAA,EAAQ;AAAA,EACzB;AAEA,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,KAAY;AAC9B,IAAA,UAAA,CAAW,SAAS,OAAO,CAAA;AAAA,EAC7B,CAAC,CAAA;AACH;AAEO,IAAM,oBAAN,MAEP;AAAA,EACW,SAAA;AAAA,EACA,QAAA;AAAA,EAET,WAAA,CAAY,OAAA,GAAoC,EAAC,EAAG;AAClD,IAAA,IAAA,CAAK,SAAA,GAAY,QAAQ,QAAA,IAAY,SAAA;AACrC,IAAA,IAAA,CAAK,QAAA,GAAW,QAAQ,OAAA,IAAW,CAAA;AAEnC,IAAA,IAAI,CAAC,qBAAA,CAAsB,GAAA,CAAI,IAAA,CAAK,SAAS,CAAA,EAAG;AAC9C,MAAA,MAAM,IAAI,UAAU,iCAAiC,CAAA;AAAA,IACvD;AAEA,IAAA,IACE,CAAC,MAAA,CAAO,QAAA,CAAS,IAAA,CAAK,QAAQ,CAAA,IAC9B,IAAA,CAAK,QAAA,GAAW,CAAA,IAChB,IAAA,CAAK,QAAA,GAAW,GAAA,EAChB;AACA,MAAA,MAAM,IAAI,WAAW,2CAA2C,CAAA;AAAA,IAClE;AAAA,EACF;AAAA,EAEA,kBAAkB,MAAA,EAAiD;AACjE,IAAA,IACE,CAAC,MAAA,CAAO,QAAA,IACR,OAAO,MAAA,CAAO,cAAc,QAAA,IAC5B,MAAA,CAAO,SAAA,CAAU,MAAA,KAAW,CAAA,EAC5B;AACA,MAAA,OAAO,IAAA;AAAA,IACT;AAEA,IAAA,MAAM,IAAA,GAAwB;AAAA,MAC5B,IAAI,MAAA,CAAO,EAAA;AAAA,MACX,IAAA,EAAM,OAAA;AAAA,MACN,OAAO,MAAA,CAAO,KAAA;AAAA,MACd,MAAA,EAAQ;AAAA,QACN,KAAK,MAAA,CAAO,SAAA;AAAA,QACZ,WAAA,EAAa,WAAA;AAAA,QACb,QAAA,EAAU;AAAA,OACZ;AAAA,MACA,GAAI,OAAO,WAAA,KAAgB,MAAA,GACvB,EAAC,GACD,EAAE,WAAA,EAAa,MAAA,CAAO,WAAA,EAAY;AAAA,MACtC,GAAI,OAAO,eAAA,KAAoB,MAAA,GAC3B,EAAC,GACD,EAAE,eAAA,EAAiB,MAAA,CAAO,eAAA,EAAgB;AAAA,MAC9C,GAAI,IAAA,CAAK,SAAA,KAAc,kBAAA,IACvB,MAAA,CAAO,eAAA,KAAoB,MAAA,GACvB,EAAC,GACD,EAAE,eAAA,EAAiB,MAAA,CAAO,eAAA;AAAgB,KAChD;AAEA,IAAA,OAAO;AAAA,MACL,GAAG,IAAA;AAAA,MACH,GAAI,KAAK,SAAA,KAAc,kBAAA,IACvB,OAAO,aAAA,KAAkB,MAAA,GACrB,EAAC,GACD;AAAA,QACE,QAAA,EAAU;AAAA,UACR,OAAA,EAAS,CAAA;AAAA,UACT,OAAO,MAAA,CAAO;AAAA;AAChB;AACF,KACN;AAAA,EACF;AAAA,EAEA,MAAM,YAAA,GAAkD;AACtD,IAAA,MAAM,IAAA,CAAK,KAAK,QAAQ,CAAA;AAExB,IAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,OAAA,CAAQ,CAAC,QAAQ,KAAA,KAAU;AACpD,MAAA,MAAM,IAAA,GAAO,IAAA,CAAK,iBAAA,CAAkB,MAAM,CAAA;AAC1C,MAAA,OAAO,IAAA,KAAS,IAAA,GACZ,EAAC,GACD,CAAC,EAAE,WAAA,EAAa,CAAA,aAAA,EAAgB,MAAA,CAAO,KAAA,GAAQ,CAAC,CAAC,CAAA,CAAA,EAAI,MAAM,CAAA;AAAA,IACjE,CAAC,CAAA;AAED,IAAA,OAAO,OAAO,MAAA,CAAO;AAAA,MACnB,UAAU,IAAA,CAAK,SAAA;AAAA,MACf,KAAA,EAAO,MAAA,CAAO,MAAA,CAAO,KAAK,CAAA;AAAA,MAC1B,YAAA,EACE,KAAK,SAAA,KAAc,mBAAA,GACf,oBACA,IAAA,CAAK,SAAA,KAAc,gBACjB,WAAA,GACA,IAAA;AAAA,MACR,cAAA,EAAgB,KAAK,SAAA,KAAc;AAAA,KACpC,CAAA;AAAA,EACH;AACF;AAEO,IAAM,gBAAA,GAAmB;;;ACnLzB,IAAM,+BAAA,GAAkC,OAAO,MAAA,CAAO;AAAA,EAC3D,MAAA,EAAQ,OAAO,MAAA,CAAO,EAAE,KAAK,CAAA,EAAG,GAAA,EAAK,KAAQ,CAAA;AAAA,EAC7C,2BAAA,EAA6B,OAAO,MAAA,CAAO,EAAE,KAAK,CAAA,EAAG,GAAA,EAAK,IAAI,CAAA;AAAA,EAC9D,eAAA,EAAiB,OAAO,MAAA,CAAO,EAAE,KAAK,CAAA,EAAG,GAAA,EAAK,GAAG,CAAA;AAAA,EACjD,aAAA,EAAe,OAAO,MAAA,CAAO,EAAE,KAAK,CAAA,EAAG,GAAA,EAAK,GAAG,CAAA;AAAA,EAC/C,cAAA,EAAgB,OAAO,MAAA,CAAO,EAAE,cAAc,CAAA,EAAG,GAAA,EAAK,MAAO;AAC/D,CAAC,CAAA;AAEM,IAAM,gCAAA,GACX,OAAO,MAAA,CAAO;AAAA,EACZ,YAAA,EAAc,GAAA;AAAA,EACd,cAAA,EAAgB,GAAA;AAAA,EAChB,oBAAA,EAAsB,GAAA;AAAA,EACtB,mBAAA,EAAqB,GAAA;AAAA,EACrB,UAAA,EAAY,GAAA;AAAA,EACZ,SAAA,EAAW,UAAA;AAAA,EACX,2BAAA,EAA6B,CAAA;AAAA,EAC7B,cAAA,EAAgB,YAAA;AAAA,EAChB,0BAAA,EAA4B,IAAA;AAAA,EAC5B,eAAA,EAAiB,IAAA;AAAA,EACjB,qBAAA,EAAuB,KAAA;AAAA,EACvB,iBAAA,EAAmB,KAAA;AAAA,EACnB,aAAA,EAAe,GAAA;AAAA,EACf,WAAA,EAAa,MAAA;AAAA,EACb,cAAA,EAAgB,EAAA;AAAA,EAChB,iBAAA,EAAmB,EAAA;AAAA,EACnB,mBAAA,EAAqB;AACvB,CAAC,CAAA;;;AChBH,IAAM,WAAA,GAAc;AAAA,EAClB,cAAA;AAAA,EACA,gBAAA;AAAA,EACA,sBAAA;AAAA,EACA,qBAAA;AAAA,EACA,YAAA;AAAA,EACA,WAAA;AAAA,EACA,6BAAA;AAAA,EACA,gBAAA;AAAA,EACA,4BAAA;AAAA,EACA,iBAAA;AAAA,EACA,uBAAA;AAAA,EACA,mBAAA;AAAA,EACA,eAAA;AAAA,EACA,aAAA;AAAA,EACA,gBAAA;AAAA,EACA,mBAAA;AAAA,EACA;AACF,CAAA;AAEA,IAAM,WAAA,uBAAkB,GAAA,CAAe;AAAA,EACrC,QAAA;AAAA,EACA,SAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF,CAAC,CAAA;AACD,IAAM,oCAAoB,IAAI,GAAA,CAAoB,CAAC,MAAA,EAAQ,YAAY,CAAC,CAAA;AACxE,IAAM,+BAAe,IAAI,GAAA,CAAgB,CAAC,KAAA,EAAO,KAAA,EAAO,KAAK,CAAC,CAAA;AAC9D,IAAM,gCAAgB,IAAI,GAAA,CAAiB,CAAC,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAC,CAAA;AACvE,IAAM,sBAAA,uBAA6B,GAAA,CAAyB;AAAA,EAC1D,kBAAA;AAAA,EACA;AACF,CAAC,CAAA;AAED,SAAS,SAAS,KAAA,EAAkD;AAClE,EAAA,OAAO,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,CAAC,KAAA,CAAM,QAAQ,KAAK,CAAA;AAC5E;AAEA,SAAS,mBAAA,CACP,KAAA,EACA,IAAA,EACA,GAAA,EACA,KACA,MAAA,EACiB;AACjB,EAAA,IACE,OAAO,KAAA,KAAU,QAAA,IACjB,CAAC,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,IACtB,KAAA,GAAQ,GAAA,IACR,KAAA,GAAQ,GAAA,EACR;AACA,IAAA,MAAA,CAAO,IAAA;AAAA,MACL,CAAA,EAAG,IAAI,CAAA,iCAAA,EAAoC,MAAA,CAAO,GAAG,CAAC,CAAA,KAAA,EAAQ,MAAA,CAAO,GAAG,CAAC,CAAA,CAAA;AAAA,KAC3E;AACA,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,IAAA;AACT;AAEA,SAAS,eAAA,CACP,KAAA,EACA,IAAA,EACA,MAAA,EACkB;AAClB,EAAA,IAAI,OAAO,UAAU,SAAA,EAAW;AAC9B,IAAA,MAAA,CAAO,IAAA,CAAK,CAAA,EAAG,IAAI,CAAA,mBAAA,CAAqB,CAAA;AACxC,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,IAAA;AACT;AAEA,SAAS,oBAAA,CACP,OACA,OAAA,EACwC;AACxC,EAAA,IAAI,CAAC,QAAA,CAAS,KAAK,CAAA,EAAG;AACpB,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,MAAA,EAAQ,CAAC,2BAA2B,CAAA,EAAE;AAAA,EAC5D;AAEA,EAAA,MAAM,SAAmB,EAAC;AAC1B,EAAA,MAAM,WAAA,GAAc,IAAI,GAAA,CAAY,WAAW,CAAA;AAE/C,EAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA,EAAG;AACpC,IAAA,IAAI,CAAC,WAAA,CAAY,GAAA,CAAI,GAAG,CAAA,EAAG;AACzB,MAAA,MAAA,CAAO,IAAA,CAAK,CAAA,OAAA,EAAU,GAAG,CAAA,kBAAA,CAAoB,CAAA;AAAA,IAC/C;AAAA,EACF;AAUA,EAAA,MAAM,MAAM,CAAC,GAAA,KACX,MAAA,CAAO,MAAA,CAAO,OAAO,GAAG,CAAA;AAC1B,EAAA,MAAM,aAAa,+BAAA,CAAgC,MAAA;AAEnD,EAAA,KAAA,MAAW,GAAA,IAAO;AAAA,IAChB,cAAA;AAAA,IACA,gBAAA;AAAA,IACA,sBAAA;AAAA,IACA,qBAAA;AAAA,IACA;AAAA,GACF,EAAY;AACV,IAAA,IAAI,GAAA,CAAI,GAAG,CAAA,EAAG;AACZ,MAAA,mBAAA,CAAoB,KAAA,CAAM,GAAG,CAAA,EAAG,CAAA,OAAA,EAAU,GAAG,IAAI,UAAA,CAAW,GAAA,EAAK,UAAA,CAAW,GAAA,EAAK,MAAM,CAAA;AAAA,IACzF;AAAA,EACF;AAEA,EAAA,MAAM,kBACJ,+BAAA,CAAgC,2BAAA;AAClC,EAAA,IAAI,GAAA,CAAI,6BAA6B,CAAA,EAAG;AACtC,IAAA,mBAAA;AAAA,MACE,KAAA,CAAM,2BAAA;AAAA,MACN,oCAAA;AAAA,MACA,eAAA,CAAgB,GAAA;AAAA,MAChB,eAAA,CAAgB,GAAA;AAAA,MAChB;AAAA,KACF;AAAA,EACF;AAEA,EAAA,MAAM,eAAe,+BAAA,CAAgC,aAAA;AACrD,EAAA,IAAI,GAAA,CAAI,eAAe,CAAA,EAAG;AACxB,IAAA,mBAAA;AAAA,MACE,KAAA,CAAM,aAAA;AAAA,MACN,sBAAA;AAAA,MACA,YAAA,CAAa,GAAA;AAAA,MACb,YAAA,CAAa,GAAA;AAAA,MACb;AAAA,KACF;AAAA,EACF;AAEA,EAAA,MAAM,wBACJ,+BAAA,CAAgC,eAAA;AAClC,EAAA,IAAI,GAAA,CAAI,iBAAiB,CAAA,EAAG;AAC1B,IAAA,mBAAA;AAAA,MACE,KAAA,CAAM,eAAA;AAAA,MACN,wBAAA;AAAA,MACA,qBAAA,CAAsB,GAAA;AAAA,MACtB,qBAAA,CAAsB,GAAA;AAAA,MACtB;AAAA,KACF;AAAA,EACF;AAEA,EAAA,KAAA,MAAW,GAAA,IAAO;AAAA,IAChB,4BAAA;AAAA,IACA;AAAA,GACF,EAAY;AACV,IAAA,IAAI,GAAA,CAAI,GAAG,CAAA,EAAG;AACZ,MAAA,eAAA,CAAgB,MAAM,GAAG,CAAA,EAAG,CAAA,OAAA,EAAU,GAAG,IAAI,MAAM,CAAA;AAAA,IACrD;AAAA,EACF;AAEA,EAAA,MAAM,aAAa,+BAAA,CAAgC,cAAA;AACnD,EAAA,KAAA,MAAW,GAAA,IAAO,CAAC,gBAAA,EAAkB,mBAAmB,CAAA,EAAY;AAClE,IAAA,IAAI,GAAA,CAAI,GAAG,CAAA,EAAG;AACZ,MAAA,MAAM,SAAA,GAAY,MAAM,GAAG,CAAA;AAC3B,MAAA,MAAM,KAAA,GAAQ,mBAAA;AAAA,QACZ,SAAA;AAAA,QACA,UAAU,GAAG,CAAA,CAAA;AAAA,QACb,UAAA,CAAW,YAAA;AAAA,QACX,UAAA,CAAW,GAAA;AAAA,QACX;AAAA,OACF;AACA,MAAA,IAAI,KAAA,IAAS,SAAA,IAAa,UAAA,CAAW,YAAA,EAAc;AACjD,QAAA,MAAA,CAAO,IAAA,CAAK,CAAA,OAAA,EAAU,GAAG,CAAA,wBAAA,CAA0B,CAAA;AAAA,MACrD;AAAA,IACF;AAAA,EACF;AAEA,EAAA,IAAI,GAAA,CAAI,WAAW,CAAA,IAAK,CAAC,YAAY,GAAA,CAAI,KAAA,CAAM,SAAsB,CAAA,EAAG;AACtE,IAAA,MAAA,CAAO,KAAK,oCAAoC,CAAA;AAAA,EAClD;AACA,EAAA,IACE,GAAA,CAAI,gBAAgB,CAAA,IACpB,CAAC,kBAAkB,GAAA,CAAI,KAAA,CAAM,cAAgC,CAAA,EAC7D;AACA,IAAA,MAAA,CAAO,KAAK,yCAAyC,CAAA;AAAA,EACvD;AACA,EAAA,IACE,GAAA,CAAI,mBAAmB,CAAA,IACvB,CAAC,aAAa,GAAA,CAAI,KAAA,CAAM,iBAA+B,CAAA,EACvD;AACA,IAAA,MAAA,CAAO,KAAK,4CAA4C,CAAA;AAAA,EAC1D;AACA,EAAA,IAAI,GAAA,CAAI,aAAa,CAAA,IAAK,CAAC,cAAc,GAAA,CAAI,KAAA,CAAM,WAA0B,CAAA,EAAG;AAC9E,IAAA,MAAA,CAAO,KAAK,sCAAsC,CAAA;AAAA,EACpD;AACA,EAAA,IACE,GAAA,CAAI,qBAAqB,CAAA,IACzB,CAAC,sBAAA,CAAuB,GAAA;AAAA,IACtB,KAAA,CAAM;AAAA,GACR,EACA;AACA,IAAA,MAAA,CAAO,KAAK,8CAA8C,CAAA;AAAA,EAC5D;AAEA,EAAA,IAAI,MAAA,CAAO,SAAS,CAAA,EAAG;AACrB,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,QAAQ,MAAA,CAAO,MAAA,CAAO,MAAM,CAAA,EAAE;AAAA,EACpD;AAEA,EAAA,MAAM,MAAA,GACF,EAAE,GAAG,gCAAA,EAAkC,GAAG,OAAM,CAChD;AAEJ,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,IAAA;AAAA,IACJ,QAAQ,EAAC;AAAA,IACT,OAAO,MAAA,CAAO,MAAA,CAAO,EAAE,GAAG,QAAQ;AAAA,GACpC;AACF;AAQO,SAAS,uCACd,KAAA,EACwC;AACxC,EAAA,OAAO,oBAAA,CAAqB,KAAwB,CAAA;AACtD;AAEO,SAAS,8BACd,QAAA,EACwC;AACxC,EAAA,OAAO,sCAAA,CAAuC,QAAA,IAAY,EAAE,CAAA;AAC9D;;;AChPO,SAAS,yBACd,gBAAA,EACuB;AACvB,EAAA,MAAM,QAAA,GAAW,8BAA8B,gBAAgB,CAAA;AAE/D,EAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,IAAA,MAAM,IAAI,SAAA,CAAU,QAAA,CAAS,MAAA,CAAO,IAAA,CAAK,GAAG,CAAC,CAAA;AAAA,EAC/C;AAEA,EAAA,OAAO,OAAO,MAAA,CAAO;AAAA,IACnB,WAAA,EAAa,IAAA;AAAA,IACb,aAAA,EAAe,IAAA;AAAA,IACf,kBAAA,EAAoB,IAAA;AAAA,IACpB,SAAA,EAAW,IAAA;AAAA,IACX,MAAA,EAAQ,MAAA;AAAA,IACR,cAAA,EAAgB,CAAA;AAAA,IAChB,WAAA,EAAa,IAAA;AAAA,IACb,MAAA,EAAQ,SAAS,KAAA,CAAM,aAAA;AAAA,IACvB,KAAA,EAAO,KAAA;AAAA,IACP,cAAA,EAAgB,SAAS,KAAA,CAAM,qBAAA;AAAA,IAC/B,UAAA,EAAY,SAAS,KAAA,CAAM,iBAAA;AAAA,IAC3B,KAAA,EAAO,MAAA,CAAO,MAAA,CAAO,EAAE,CAAA;AAAA,IACvB,iBAAA,EAAmB,IAAA;AAAA,IACnB,OAAA,EAAS,KAAA;AAAA,IACT,aAAA,EAAe,KAAA;AAAA,IACf,SAAA,EAAW,KAAA;AAAA,IACX,gBAAA,EAAkB,KAAA;AAAA,IAClB,mBAAA,EAAqB,IAAA;AAAA,IACrB,KAAA,EAAO,IAAA;AAAA,IACP,kBAAkB,QAAA,CAAS;AAAA,GAC5B,CAAA;AACH;;;AC7BO,SAAS,4BAAA,CACd,SAAA,GAAsC,EAAC,EACtB;AACjB,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,eAAA;AAAA,IACJ,IAAA,EAAM,OAAA;AAAA,IACN,KAAA,EAAO,eAAA;AAAA,IACP,WAAA,EAAa,iBAAA;AAAA,IACb,MAAA,EAAQ;AAAA,MACN,GAAA,EAAK,+BAAA;AAAA,MACL,QAAA,EAAU,YAAA;AAAA,MACV,WAAA,EAAa;AAAA,KACf;AAAA,IACA,eAAA,EAAiB,GAAA;AAAA,IACjB,QAAA,EAAU;AAAA,MACR,OAAA,EAAS,CAAA;AAAA,MACT,KAAA,EAAO,CAAC,GAAA,EAAK,GAAA,EAAK,KAAK,GAAG;AAAA,KAC5B;AAAA,IACA,GAAG;AAAA,GACL;AACF;AAEO,SAAS,sBAAA,CACd,SAAA,GAAgC,EAAC,EACtB;AACX,EAAA,OAAO;AAAA,IACL,WAAA,EAAa,oBAAA;AAAA,IACb,MAAM,4BAAA,EAA6B;AAAA,IACnC,GAAG;AAAA,GACL;AACF;AAEO,SAAS,wBAAA,CACd,SAAA,GAAkC,EAAC,EACnC,gBAAA,EACuB;AACvB,EAAA,MAAM,OAAA,GAAU,yBAAyB,gBAAgB,CAAA;AACzD,EAAA,OAAO,OAAO,MAAA,CAAO;AAAA,IACnB,GAAG,OAAA;AAAA,IACH,GAAG;AAAA,GACJ,CAAA;AACH","file":"index.js","sourcesContent":["import type {\n  PlayerError,\n  PlayerMediaAdapter,\n  PlayerMediaItem,\n  QueueItem,\n} from \"../../contracts/player\";\n\nexport type MockPlayerScenario =\n  | \"success\"\n  | \"loading\"\n  | \"duration-unknown\"\n  | \"missing-waveform\"\n  | \"recoverable-error\"\n  | \"fatal-error\";\n\nexport interface MockMediaRecord {\n  readonly id: string;\n  readonly playable: boolean;\n  readonly title: string;\n  readonly creatorName?: string;\n  readonly collectionTitle?: string;\n  readonly sourceUrl?: string;\n  readonly durationHintSec?: number;\n  readonly waveformPeaks?: readonly number[];\n}\n\nexport interface MockPlayerAdapterOptions {\n  readonly scenario?: MockPlayerScenario;\n  readonly delayMs?: number;\n}\n\nexport interface MockPlayerScenarioResult {\n  readonly scenario: MockPlayerScenario;\n  readonly queue: readonly QueueItem[];\n  readonly initialError: PlayerError | null;\n  readonly remainsLoading: boolean;\n}\n\nconst MOCK_RECORDS: readonly MockMediaRecord[] = Object.freeze([\n  Object.freeze({\n    id: \"sample-track-alpha\",\n    playable: true,\n    title: \"Sample Track Alpha\",\n    creatorName: \"Sample Creator\",\n    collectionTitle: \"Sample Collection\",\n    sourceUrl: \"/mock-audio/sample-track-alpha.mp3\",\n    durationHintSec: 185,\n    waveformPeaks: Object.freeze([0.18, 0.42, 0.7, 0.54, 0.82, 0.33]),\n  }),\n  Object.freeze({\n    id: \"sample-track-beta\",\n    playable: true,\n    title: \"Sample Track Beta\",\n    creatorName: \"Sample Creator\",\n    collectionTitle: \"Sample Collection\",\n    sourceUrl: \"/mock-audio/sample-track-beta.mp3\",\n    durationHintSec: 212,\n    waveformPeaks: Object.freeze([0.28, 0.5, 0.36, 0.76, 0.61, 0.24]),\n  }),\n]);\n\nconst RECOVERABLE_ERROR: PlayerError = Object.freeze({\n  code: \"network\",\n  recoverable: true,\n  messageKey: \"player.error.network\",\n});\n\nconst FATAL_ERROR: PlayerError = Object.freeze({\n  code: \"unsupported\",\n  recoverable: false,\n  messageKey: \"player.error.unsupported\",\n});\n\nconst MOCK_PLAYER_SCENARIOS = new Set<MockPlayerScenario>([\n  \"success\",\n  \"loading\",\n  \"duration-unknown\",\n  \"missing-waveform\",\n  \"recoverable-error\",\n  \"fatal-error\",\n]);\n\nfunction wait(delayMs: number): Promise<void> {\n  if (delayMs <= 0) {\n    return Promise.resolve();\n  }\n\n  return new Promise((resolve) => {\n    setTimeout(resolve, delayMs);\n  });\n}\n\nexport class MockPlayerAdapter\n  implements PlayerMediaAdapter<MockMediaRecord>\n{\n  readonly #scenario: MockPlayerScenario;\n  readonly #delayMs: number;\n\n  constructor(options: MockPlayerAdapterOptions = {}) {\n    this.#scenario = options.scenario ?? \"success\";\n    this.#delayMs = options.delayMs ?? 0;\n\n    if (!MOCK_PLAYER_SCENARIOS.has(this.#scenario)) {\n      throw new TypeError(\"Mock scenario is not supported.\");\n    }\n\n    if (\n      !Number.isFinite(this.#delayMs) ||\n      this.#delayMs < 0 ||\n      this.#delayMs > 30_000\n    ) {\n      throw new RangeError(\"Mock delayMs must be between 0 and 30000.\");\n    }\n  }\n\n  toPlayerMediaItem(source: MockMediaRecord): PlayerMediaItem | null {\n    if (\n      !source.playable ||\n      typeof source.sourceUrl !== \"string\" ||\n      source.sourceUrl.length === 0\n    ) {\n      return null;\n    }\n\n    const base: PlayerMediaItem = {\n      id: source.id,\n      kind: \"track\",\n      title: source.title,\n      source: {\n        url: source.sourceUrl,\n        crossOrigin: \"anonymous\",\n        mimeType: \"audio/mpeg\",\n      },\n      ...(source.creatorName === undefined\n        ? {}\n        : { creatorName: source.creatorName }),\n      ...(source.collectionTitle === undefined\n        ? {}\n        : { collectionTitle: source.collectionTitle }),\n      ...(this.#scenario === \"duration-unknown\" ||\n      source.durationHintSec === undefined\n        ? {}\n        : { durationHintSec: source.durationHintSec }),\n    };\n\n    return {\n      ...base,\n      ...(this.#scenario === \"missing-waveform\" ||\n      source.waveformPeaks === undefined\n        ? {}\n        : {\n            waveform: {\n              version: 1,\n              peaks: source.waveformPeaks,\n            },\n          }),\n    };\n  }\n\n  async loadScenario(): Promise<MockPlayerScenarioResult> {\n    await wait(this.#delayMs);\n\n    const queue = MOCK_RECORDS.flatMap((record, index) => {\n      const item = this.toPlayerMediaItem(record);\n      return item === null\n        ? []\n        : [{ queueItemId: `sample-queue-${String(index + 1)}`, item }];\n    });\n\n    return Object.freeze({\n      scenario: this.#scenario,\n      queue: Object.freeze(queue),\n      initialError:\n        this.#scenario === \"recoverable-error\"\n          ? RECOVERABLE_ERROR\n          : this.#scenario === \"fatal-error\"\n            ? FATAL_ERROR\n            : null,\n      remainsLoading: this.#scenario === \"loading\",\n    });\n  }\n}\n\nexport const mockMediaRecords = MOCK_RECORDS;\n","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","import type {\n  PlayerExperienceConfig,\n  PlayerMediaItem,\n  PlayerState,\n  QueueItem,\n} from \"../contracts/player\";\nimport { createInitialPlayerState } from \"../config/initial-state\";\n\nexport function createPlayerMediaItemFixture(\n  overrides: Partial<PlayerMediaItem> = {},\n): PlayerMediaItem {\n  return {\n    id: \"fixture-track\",\n    kind: \"track\",\n    title: \"Fixture Track\",\n    creatorName: \"Fixture Creator\",\n    source: {\n      url: \"/mock-audio/fixture-track.mp3\",\n      mimeType: \"audio/mpeg\",\n      crossOrigin: \"anonymous\",\n    },\n    durationHintSec: 180,\n    waveform: {\n      version: 1,\n      peaks: [0.2, 0.6, 0.4, 0.8],\n    },\n    ...overrides,\n  };\n}\n\nexport function createQueueItemFixture(\n  overrides: Partial<QueueItem> = {},\n): QueueItem {\n  return {\n    queueItemId: \"fixture-queue-item\",\n    item: createPlayerMediaItemFixture(),\n    ...overrides,\n  };\n}\n\nexport function createPlayerStateFixture(\n  overrides: Partial<PlayerState> = {},\n  experienceConfig?: Partial<PlayerExperienceConfig>,\n): Readonly<PlayerState> {\n  const initial = createInitialPlayerState(experienceConfig);\n  return Object.freeze({\n    ...initial,\n    ...overrides,\n  });\n}\n"]}

package/dist/ui/index.d.ts

@@ -0,0 +1,143 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { w as PlayerViewProps, r as PlayerMediaItem, u as PlayerState, f as PlayerCommands, d as PlayerAppearance, j as PlayerError, R as RepeatMode, b as PlaybackStatus, S as SeekCommitMode, x as PlayerWaveform } from '../player-DE9Vqztu.js';
+
+interface CompactPlayerProps extends PlayerViewProps {
+    readonly className?: string;
+}
+declare function CompactPlayer({ appearance, className, commands, state, }: CompactPlayerProps): react.JSX.Element;
+
+interface DetailedPlayerProps extends PlayerViewProps {
+    readonly className?: string;
+    readonly queueLimit?: number;
+}
+declare function DetailedPlayer({ appearance, className, commands, queueLimit, state, }: DetailedPlayerProps): react.JSX.Element;
+
+interface MiniPlayerProps extends PlayerViewProps {
+    readonly className?: string;
+}
+declare function MiniPlayer({ appearance, className, commands, state, }: MiniPlayerProps): react.JSX.Element | null;
+
+interface PlayerSurfaceProps {
+    readonly appearance: PlayerAppearance;
+    readonly children: ReactNode;
+    readonly className?: string;
+    readonly label: string;
+}
+declare function PlayerSurface({ appearance, children, className, label, }: PlayerSurfaceProps): react.JSX.Element;
+interface ArtworkProps {
+    readonly item: PlayerMediaItem | null;
+    readonly className?: string;
+}
+declare function Artwork({ className, item }: ArtworkProps): react.JSX.Element;
+interface TrackMetadataProps {
+    readonly item: PlayerMediaItem | null;
+    readonly status?: string;
+    readonly className?: string;
+    readonly scrollTitle?: boolean;
+}
+declare function TrackMetadata({ className, item, scrollTitle, status, }: TrackMetadataProps): react.JSX.Element;
+interface TimeReadoutProps {
+    readonly currentTimeSec: number;
+    readonly durationSec: number | null;
+    readonly className?: string;
+}
+declare function TimeReadout({ className, currentTimeSec, durationSec, }: TimeReadoutProps): react.JSX.Element;
+interface IconButtonProps {
+    readonly label: string;
+    readonly children: ReactNode;
+    readonly onClick: () => void;
+    readonly disabled?: boolean;
+    readonly pressed?: boolean;
+    readonly className?: string;
+}
+declare function IconButton({ children, className, disabled, label, onClick, pressed, }: IconButtonProps): react.JSX.Element;
+interface PrimaryPlaybackButtonProps {
+    readonly state: Readonly<PlayerState>;
+    readonly commands: PlayerCommands;
+    readonly className?: string;
+}
+declare function PrimaryPlaybackButton({ className, commands, state, }: PrimaryPlaybackButtonProps): react.JSX.Element;
+interface TransportControlsProps {
+    readonly state: Readonly<PlayerState>;
+    readonly commands: PlayerCommands;
+    readonly compact?: boolean;
+    readonly showModes?: boolean;
+    readonly className?: string;
+}
+declare function TransportControls({ className, commands, compact, showModes, state, }: TransportControlsProps): react.JSX.Element;
+interface VolumeControlProps {
+    readonly state: Readonly<PlayerState>;
+    readonly commands: PlayerCommands;
+    readonly className?: string;
+}
+declare function VolumeControl({ className, commands, state, }: VolumeControlProps): react.JSX.Element;
+interface PopoverVolumeControlProps {
+    readonly state: Readonly<PlayerState>;
+    readonly commands: PlayerCommands;
+    readonly label: string;
+    readonly className?: string;
+}
+declare function PopoverVolumeControl({ className, commands, label, state, }: PopoverVolumeControlProps): react.JSX.Element;
+interface QueueToggleProps {
+    readonly onClick: () => void;
+    readonly expanded?: boolean;
+}
+declare function QueueToggle({ expanded, onClick, }: QueueToggleProps): react.JSX.Element;
+interface PlayerStatusProps {
+    readonly state: Readonly<PlayerState>;
+}
+declare function PlayerStatus({ state }: PlayerStatusProps): react.JSX.Element;
+interface PlayerErrorNoticeProps {
+    readonly state: Readonly<PlayerState>;
+    readonly commands: PlayerCommands;
+}
+declare function PlayerErrorNotice({ commands, state, }: PlayerErrorNoticeProps): react.JSX.Element | null;
+
+declare function clamp(value: number, min: number, max: number): number;
+declare function formatTime(seconds: number | null): string;
+declare function formatTimeAria(seconds: number): string;
+declare function getRepeatLabel(mode: RepeatMode): string;
+declare function getNextRepeatMode(mode: RepeatMode): RepeatMode;
+declare function getStatusLabel(state: Readonly<PlayerState>): string;
+declare function getErrorMessage(error: PlayerError): string;
+
+interface PodcastPlayerProps extends PlayerViewProps {
+    readonly className?: string;
+}
+declare function PodcastPlayer({ appearance, className, commands, state, }: PodcastPlayerProps): react.JSX.Element;
+
+interface QueuePanelProps extends PlayerViewProps {
+    readonly className?: string;
+    readonly label?: string;
+    readonly onClose?: () => void;
+}
+declare function QueuePanel({ appearance, className, commands, label, onClose, state, }: QueuePanelProps): react.JSX.Element;
+
+interface SeekBarProps {
+    readonly currentTimeSec: number;
+    readonly durationSec: number | null;
+    readonly canSeek: boolean;
+    readonly status: PlaybackStatus;
+    readonly commitMode: SeekCommitMode;
+    readonly onSeek: (seconds: number) => void;
+    readonly label?: string;
+    readonly className?: string;
+}
+declare function SeekBar({ canSeek, className, commitMode, currentTimeSec, durationSec, label, onSeek, status, }: SeekBarProps): react.JSX.Element;
+
+interface WaveformProps {
+    readonly waveform?: PlayerWaveform | undefined;
+    readonly progress?: number;
+    readonly playedStateEnabled?: boolean;
+    readonly opacity?: number;
+    readonly className?: string;
+}
+declare function Waveform({ className, opacity, playedStateEnabled, progress, waveform, }: WaveformProps): react.JSX.Element;
+
+interface WidePlayerProps extends PlayerViewProps {
+    readonly className?: string;
+}
+declare function WidePlayer({ appearance, className, commands, state, }: WidePlayerProps): react.JSX.Element;
+
+export { Artwork, type ArtworkProps, CompactPlayer, type CompactPlayerProps, DetailedPlayer, type DetailedPlayerProps, IconButton, type IconButtonProps, MiniPlayer, type MiniPlayerProps, PlayerErrorNotice, type PlayerErrorNoticeProps, PlayerStatus, type PlayerStatusProps, PlayerSurface, type PlayerSurfaceProps, PodcastPlayer, type PodcastPlayerProps, PopoverVolumeControl, type PopoverVolumeControlProps, PrimaryPlaybackButton, type PrimaryPlaybackButtonProps, QueuePanel, type QueuePanelProps, QueueToggle, type QueueToggleProps, SeekBar, type SeekBarProps, TimeReadout, type TimeReadoutProps, TrackMetadata, type TrackMetadataProps, TransportControls, type TransportControlsProps, VolumeControl, type VolumeControlProps, Waveform, type WaveformProps, WidePlayer, type WidePlayerProps, clamp, formatTime, formatTimeAria, getErrorMessage, getNextRepeatMode, getRepeatLabel, getStatusLabel };