@pie-players/pie-section-player 0.3.7 → 0.3.8

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pie-players/pie-section-player",
-	"version": "0.3.7",
+	"version": "0.3.8",
 	"type": "module",
 	"description": "Web component for rendering QTI 3.0 assessment sections with passages and items",
 	"license": "MIT",
@@ -89,7 +89,7 @@
 		"lint": "biome check ."
 	},
 	"peerDependencies": {
-		"@pie-players/pie-tool-annotation-toolbar": "0.3.7"
+		"@pie-players/pie-tool-annotation-toolbar": "0.3.8"
 	},
 	"peerDependenciesMeta": {
 		"@pie-players/pie-tool-annotation-toolbar": {
@@ -97,11 +97,11 @@
 		}
 	},
 	"dependencies": {
-		"@pie-players/pie-assessment-toolkit": "0.3.7",
-		"@pie-players/pie-item-player": "0.3.7",
-		"@pie-players/pie-context": "0.3.7",
-		"@pie-players/pie-players-shared": "0.3.7",
-		"@pie-players/pie-toolbars": "0.3.7"
+		"@pie-players/pie-assessment-toolkit": "0.3.8",
+		"@pie-players/pie-item-player": "0.3.8",
+		"@pie-players/pie-context": "0.3.8",
+		"@pie-players/pie-players-shared": "0.3.8",
+		"@pie-players/pie-toolbars": "0.3.8"
 	},
 	"devDependencies": {
 		"@axe-core/playwright": "^4.11.1",

package/dist/index-CGEKDUBQ-C-8EFMUk.js

@@ -1,216 +0,0 @@
-var v = Object.defineProperty, y = (h, t, i) => t in h ? v(h, t, { enumerable: !0, configurable: !0, writable: !0, value: i }) : h[t] = i, o = (h, t, i) => y(h, typeof t != "symbol" ? t + "" : t, i);
-class T {
-  constructor(t) {
-    o(this, "config"), o(this, "currentAudio", null), o(this, "pausedState", !1), o(this, "wordTimings", []), o(this, "highlightInterval", null), o(this, "intentionallyStopped", !1), o(this, "onWordBoundary"), this.config = t;
-  }
-  async speak(t) {
-    this.stop(), this.intentionallyStopped = !1;
-    const { audioUrl: i, wordTimings: e } = await this.synthesizeSpeech(t), r = this.config.rate || 1;
-    return this.wordTimings = e.map((n) => ({
-      ...n,
-      time: n.time / r
-    })), new Promise((n, a) => {
-      const s = new Audio(i);
-      this.currentAudio = s, this.config.rate && (s.playbackRate = Math.max(0.25, Math.min(4, this.config.rate))), this.config.volume !== void 0 && (s.volume = Math.max(0, Math.min(1, this.config.volume))), s.onplay = () => {
-        this.pausedState = !1, this.onWordBoundary && this.wordTimings.length > 0 && this.startWordHighlighting();
-      }, s.onended = () => {
-        this.stopWordHighlighting(), URL.revokeObjectURL(i), this.currentAudio = null, this.wordTimings = [], n();
-      }, s.onerror = (d) => {
-        this.stopWordHighlighting(), URL.revokeObjectURL(i), this.currentAudio = null, this.wordTimings = [], this.intentionallyStopped ? n() : a(new Error("Failed to play audio from server"));
-      }, s.onpause = () => {
-        this.stopWordHighlighting(), this.pausedState = !0;
-      }, s.play().catch(a);
-    });
-  }
-  /**
-   * Call server API to synthesize speech
-   */
-  async synthesizeSpeech(t) {
-    const i = {
-      "Content-Type": "application/json",
-      ...this.config.headers
-    };
-    this.config.authToken && (i.Authorization = `Bearer ${this.config.authToken}`);
-    const e = this.config.providerOptions || {}, r = typeof this.config.engine == "string" ? this.config.engine : typeof e.engine == "string" ? e.engine : void 0, n = typeof e.sampleRate == "number" && Number.isFinite(e.sampleRate) ? e.sampleRate : void 0, a = e.format === "mp3" || e.format === "ogg" || e.format === "pcm" ? e.format : void 0, s = Array.isArray(e.speechMarkTypes) ? e.speechMarkTypes.filter((u) => u === "word" || u === "sentence" || u === "ssml") : void 0, d = {
-      text: t,
-      provider: this.config.provider || "polly",
-      voice: this.config.voice,
-      language: this.config.language,
-      rate: this.config.rate,
-      engine: r,
-      sampleRate: n,
-      format: a,
-      speechMarkTypes: s,
-      includeSpeechMarks: !0
-    }, l = await fetch(`${this.config.apiEndpoint}/synthesize`, {
-      method: "POST",
-      headers: i,
-      body: JSON.stringify(d)
-    });
-    if (!l.ok) {
-      const u = await l.json().catch(() => ({})), m = u.message || u.error?.message || `Server returned ${l.status}`;
-      throw new Error(m);
-    }
-    const c = await l.json(), g = this.base64ToBlob(c.audio, c.contentType), p = URL.createObjectURL(g), f = this.parseSpeechMarks(c.speechMarks);
-    return { audioUrl: p, wordTimings: f };
-  }
-  /**
-   * Convert base64 to Blob
-   */
-  base64ToBlob(t, i) {
-    const e = atob(t), r = new Array(e.length);
-    for (let a = 0; a < e.length; a++)
-      r[a] = e.charCodeAt(a);
-    const n = new Uint8Array(r);
-    return new Blob([n], { type: i });
-  }
-  /**
-   * Parse speech marks into word timings
-   */
-  parseSpeechMarks(t) {
-    return t.filter((i) => i.type === "word").map((i, e) => ({
-      time: i.time,
-      wordIndex: e,
-      charIndex: i.start,
-      length: i.end - i.start
-    }));
-  }
-  /**
-   * Start word highlighting synchronized with audio playback
-   */
-  startWordHighlighting() {
-    if (this.stopWordHighlighting(), !this.currentAudio || !this.onWordBoundary || this.wordTimings.length === 0) {
-      console.log("[ServerTTSProvider] Cannot start highlighting:", {
-        hasAudio: !!this.currentAudio,
-        hasCallback: !!this.onWordBoundary,
-        wordTimingsCount: this.wordTimings.length
-      });
-      return;
-    }
-    console.log("[ServerTTSProvider] Starting word highlighting with", this.wordTimings.length, "word timings"), console.log("[ServerTTSProvider] Playback rate:", this.currentAudio.playbackRate), console.log("[ServerTTSProvider] First 3 timings:", this.wordTimings.slice(0, 3));
-    let t = -1;
-    this.highlightInterval = window.setInterval(() => {
-      if (!this.currentAudio) {
-        this.stopWordHighlighting();
-        return;
-      }
-      const i = this.currentAudio.currentTime * 1e3;
-      for (let e = 0; e < this.wordTimings.length; e++) {
-        const r = this.wordTimings[e];
-        if (i >= r.time && e > t) {
-          this.onWordBoundary && (console.log("[ServerTTSProvider] Highlighting word at charIndex:", r.charIndex, "length:", r.length, "time:", r.time, "currentTime:", i), this.onWordBoundary("", r.charIndex, r.length)), t = e;
-          break;
-        }
-      }
-    }, 50);
-  }
-  /**
-   * Stop word highlighting
-   */
-  stopWordHighlighting() {
-    this.highlightInterval !== null && (clearInterval(this.highlightInterval), this.highlightInterval = null);
-  }
-  pause() {
-    this.currentAudio && !this.pausedState && (this.currentAudio.pause(), this.stopWordHighlighting(), this.pausedState = !0);
-  }
-  resume() {
-    this.currentAudio && this.pausedState && (this.currentAudio.play(), this.pausedState = !1, this.onWordBoundary && this.wordTimings.length > 0 && this.startWordHighlighting());
-  }
-  stop() {
-    this.stopWordHighlighting(), this.currentAudio && (this.intentionallyStopped = !0, this.currentAudio.pause(), this.currentAudio.src && URL.revokeObjectURL(this.currentAudio.src), this.currentAudio.src = "", this.currentAudio = null), this.pausedState = !1, this.wordTimings = [];
-  }
-  isPlaying() {
-    return this.currentAudio !== null && !this.pausedState;
-  }
-  isPaused() {
-    return this.pausedState;
-  }
-  /**
-   * Update settings dynamically (rate, pitch, voice)
-   * Note: Voice changes require resynthesis, so voice updates are stored but
-   * take effect on the next speak() call. Rate can be applied to current playback.
-   */
-  updateSettings(t) {
-    t.rate !== void 0 && (this.config.rate = t.rate, this.currentAudio && (this.currentAudio.playbackRate = Math.max(0.25, Math.min(4, t.rate)))), t.pitch !== void 0 && (this.config.pitch = t.pitch), t.voice !== void 0 && (this.config.voice = t.voice);
-  }
-}
-class w {
-  constructor() {
-    o(this, "providerId", "server-tts"), o(this, "providerName", "Server TTS"), o(this, "version", "1.0.0"), o(this, "config", null);
-  }
-  /**
-   * Initialize the server TTS provider.
-   *
-   * This is designed to be fast by default (no API calls).
-   * Set validateEndpoint: true in config to test API availability during initialization.
-   *
-   * @performance Default: <10ms, With validation: 100-500ms
-   */
-  async initialize(t) {
-    const i = t;
-    if (!i.apiEndpoint)
-      throw new Error("apiEndpoint is required for ServerTTSProvider");
-    if (this.config = i, i.validateEndpoint && !await this.testAPIAvailability())
-      throw new Error(`Server TTS API not available at ${i.apiEndpoint}`);
-    return new T(i);
-  }
-  /**
-   * Test if API endpoint is available (with timeout).
-   *
-   * @performance 100-500ms depending on network
-   */
-  async testAPIAvailability() {
-    if (!this.config)
-      return !1;
-    try {
-      const t = { ...this.config.headers };
-      this.config.authToken && (t.Authorization = `Bearer ${this.config.authToken}`);
-      const i = new AbortController(), e = setTimeout(() => i.abort(), 5e3);
-      try {
-        const r = await fetch(`${this.config.apiEndpoint}/voices`, {
-          headers: t,
-          signal: i.signal
-        });
-        return clearTimeout(e), r.ok;
-      } catch {
-        return clearTimeout(e), !1;
-      }
-    } catch {
-      return !1;
-    }
-  }
-  supportsFeature(t) {
-    switch (t) {
-      case "pause":
-      case "resume":
-      case "wordBoundary":
-      case "voiceSelection":
-      case "rateControl":
-        return !0;
-      case "pitchControl":
-        return !1;
-      default:
-        return !1;
-    }
-  }
-  getCapabilities() {
-    return {
-      supportsPause: !0,
-      supportsResume: !0,
-      supportsWordBoundary: !0,
-      // ✅ Via speech marks from server
-      supportsVoiceSelection: !0,
-      supportsRateControl: !0,
-      supportsPitchControl: !1,
-      // Depends on server provider
-      maxTextLength: 3e3
-      // Conservative estimate
-    };
-  }
-  destroy() {
-    this.config = null;
-  }
-}
-export {
-  w as ServerTTSProvider
-};

package/dist/index-CGEKDUBQ.js

@@ -1,228 +0,0 @@
-var v = Object.defineProperty;
-var y = (h, t, e) => t in h ? v(h, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : h[t] = e;
-var o = (h, t, e) => y(h, typeof t != "symbol" ? t + "" : t, e);
-class T {
-  constructor(t) {
-    o(this, "config");
-    o(this, "currentAudio", null);
-    o(this, "pausedState", !1);
-    o(this, "wordTimings", []);
-    o(this, "highlightInterval", null);
-    o(this, "intentionallyStopped", !1);
-    o(this, "onWordBoundary");
-    this.config = t;
-  }
-  async speak(t) {
-    this.stop(), this.intentionallyStopped = !1;
-    const { audioUrl: e, wordTimings: i } = await this.synthesizeSpeech(t), r = this.config.rate || 1;
-    return this.wordTimings = i.map((s) => ({
-      ...s,
-      time: s.time / r
-    })), new Promise((s, a) => {
-      const n = new Audio(e);
-      this.currentAudio = n, this.config.rate && (n.playbackRate = Math.max(0.25, Math.min(4, this.config.rate))), this.config.volume !== void 0 && (n.volume = Math.max(0, Math.min(1, this.config.volume))), n.onplay = () => {
-        this.pausedState = !1, this.onWordBoundary && this.wordTimings.length > 0 && this.startWordHighlighting();
-      }, n.onended = () => {
-        this.stopWordHighlighting(), URL.revokeObjectURL(e), this.currentAudio = null, this.wordTimings = [], s();
-      }, n.onerror = (l) => {
-        this.stopWordHighlighting(), URL.revokeObjectURL(e), this.currentAudio = null, this.wordTimings = [], this.intentionallyStopped ? s() : a(new Error("Failed to play audio from server"));
-      }, n.onpause = () => {
-        this.stopWordHighlighting(), this.pausedState = !0;
-      }, n.play().catch(a);
-    });
-  }
-  /**
-   * Call server API to synthesize speech
-   */
-  async synthesizeSpeech(t) {
-    const e = {
-      "Content-Type": "application/json",
-      ...this.config.headers
-    };
-    this.config.authToken && (e.Authorization = `Bearer ${this.config.authToken}`);
-    const i = this.config.providerOptions || {}, r = typeof this.config.engine == "string" ? this.config.engine : typeof i.engine == "string" ? i.engine : void 0, s = typeof i.sampleRate == "number" && Number.isFinite(i.sampleRate) ? i.sampleRate : void 0, a = i.format === "mp3" || i.format === "ogg" || i.format === "pcm" ? i.format : void 0, n = Array.isArray(i.speechMarkTypes) ? i.speechMarkTypes.filter((c) => c === "word" || c === "sentence" || c === "ssml") : void 0, l = {
-      text: t,
-      provider: this.config.provider || "polly",
-      voice: this.config.voice,
-      language: this.config.language,
-      rate: this.config.rate,
-      engine: r,
-      sampleRate: s,
-      format: a,
-      speechMarkTypes: n,
-      includeSpeechMarks: !0
-    }, u = await fetch(`${this.config.apiEndpoint}/synthesize`, {
-      method: "POST",
-      headers: e,
-      body: JSON.stringify(l)
-    });
-    if (!u.ok) {
-      const c = await u.json().catch(() => ({})), m = c.message || c.error?.message || `Server returned ${u.status}`;
-      throw new Error(m);
-    }
-    const d = await u.json(), g = this.base64ToBlob(d.audio, d.contentType), p = URL.createObjectURL(g), f = this.parseSpeechMarks(d.speechMarks);
-    return { audioUrl: p, wordTimings: f };
-  }
-  /**
-   * Convert base64 to Blob
-   */
-  base64ToBlob(t, e) {
-    const i = atob(t), r = new Array(i.length);
-    for (let a = 0; a < i.length; a++)
-      r[a] = i.charCodeAt(a);
-    const s = new Uint8Array(r);
-    return new Blob([s], { type: e });
-  }
-  /**
-   * Parse speech marks into word timings
-   */
-  parseSpeechMarks(t) {
-    return t.filter((e) => e.type === "word").map((e, i) => ({
-      time: e.time,
-      wordIndex: i,
-      charIndex: e.start,
-      length: e.end - e.start
-    }));
-  }
-  /**
-   * Start word highlighting synchronized with audio playback
-   */
-  startWordHighlighting() {
-    if (this.stopWordHighlighting(), !this.currentAudio || !this.onWordBoundary || this.wordTimings.length === 0) {
-      console.log("[ServerTTSProvider] Cannot start highlighting:", {
-        hasAudio: !!this.currentAudio,
-        hasCallback: !!this.onWordBoundary,
-        wordTimingsCount: this.wordTimings.length
-      });
-      return;
-    }
-    console.log("[ServerTTSProvider] Starting word highlighting with", this.wordTimings.length, "word timings"), console.log("[ServerTTSProvider] Playback rate:", this.currentAudio.playbackRate), console.log("[ServerTTSProvider] First 3 timings:", this.wordTimings.slice(0, 3));
-    let t = -1;
-    this.highlightInterval = window.setInterval(() => {
-      if (!this.currentAudio) {
-        this.stopWordHighlighting();
-        return;
-      }
-      const e = this.currentAudio.currentTime * 1e3;
-      for (let i = 0; i < this.wordTimings.length; i++) {
-        const r = this.wordTimings[i];
-        if (e >= r.time && i > t) {
-          this.onWordBoundary && (console.log("[ServerTTSProvider] Highlighting word at charIndex:", r.charIndex, "length:", r.length, "time:", r.time, "currentTime:", e), this.onWordBoundary("", r.charIndex, r.length)), t = i;
-          break;
-        }
-      }
-    }, 50);
-  }
-  /**
-   * Stop word highlighting
-   */
-  stopWordHighlighting() {
-    this.highlightInterval !== null && (clearInterval(this.highlightInterval), this.highlightInterval = null);
-  }
-  pause() {
-    this.currentAudio && !this.pausedState && (this.currentAudio.pause(), this.stopWordHighlighting(), this.pausedState = !0);
-  }
-  resume() {
-    this.currentAudio && this.pausedState && (this.currentAudio.play(), this.pausedState = !1, this.onWordBoundary && this.wordTimings.length > 0 && this.startWordHighlighting());
-  }
-  stop() {
-    this.stopWordHighlighting(), this.currentAudio && (this.intentionallyStopped = !0, this.currentAudio.pause(), this.currentAudio.src && URL.revokeObjectURL(this.currentAudio.src), this.currentAudio.src = "", this.currentAudio = null), this.pausedState = !1, this.wordTimings = [];
-  }
-  isPlaying() {
-    return this.currentAudio !== null && !this.pausedState;
-  }
-  isPaused() {
-    return this.pausedState;
-  }
-  /**
-   * Update settings dynamically (rate, pitch, voice)
-   * Note: Voice changes require resynthesis, so voice updates are stored but
-   * take effect on the next speak() call. Rate can be applied to current playback.
-   */
-  updateSettings(t) {
-    t.rate !== void 0 && (this.config.rate = t.rate, this.currentAudio && (this.currentAudio.playbackRate = Math.max(0.25, Math.min(4, t.rate)))), t.pitch !== void 0 && (this.config.pitch = t.pitch), t.voice !== void 0 && (this.config.voice = t.voice);
-  }
-}
-class S {
-  constructor() {
-    o(this, "providerId", "server-tts");
-    o(this, "providerName", "Server TTS");
-    o(this, "version", "1.0.0");
-    o(this, "config", null);
-  }
-  /**
-   * Initialize the server TTS provider.
-   *
-   * This is designed to be fast by default (no API calls).
-   * Set validateEndpoint: true in config to test API availability during initialization.
-   *
-   * @performance Default: <10ms, With validation: 100-500ms
-   */
-  async initialize(t) {
-    const e = t;
-    if (!e.apiEndpoint)
-      throw new Error("apiEndpoint is required for ServerTTSProvider");
-    if (this.config = e, e.validateEndpoint && !await this.testAPIAvailability())
-      throw new Error(`Server TTS API not available at ${e.apiEndpoint}`);
-    return new T(e);
-  }
-  /**
-   * Test if API endpoint is available (with timeout).
-   *
-   * @performance 100-500ms depending on network
-   */
-  async testAPIAvailability() {
-    if (!this.config)
-      return !1;
-    try {
-      const t = { ...this.config.headers };
-      this.config.authToken && (t.Authorization = `Bearer ${this.config.authToken}`);
-      const e = new AbortController(), i = setTimeout(() => e.abort(), 5e3);
-      try {
-        const r = await fetch(`${this.config.apiEndpoint}/voices`, {
-          headers: t,
-          signal: e.signal
-        });
-        return clearTimeout(i), r.ok;
-      } catch {
-        return clearTimeout(i), !1;
-      }
-    } catch {
-      return !1;
-    }
-  }
-  supportsFeature(t) {
-    switch (t) {
-      case "pause":
-      case "resume":
-      case "wordBoundary":
-      case "voiceSelection":
-      case "rateControl":
-        return !0;
-      case "pitchControl":
-        return !1;
-      default:
-        return !1;
-    }
-  }
-  getCapabilities() {
-    return {
-      supportsPause: !0,
-      supportsResume: !0,
-      supportsWordBoundary: !0,
-      // ✅ Via speech marks from server
-      supportsVoiceSelection: !0,
-      supportsRateControl: !0,
-      supportsPitchControl: !1,
-      // Depends on server provider
-      maxTextLength: 3e3
-      // Conservative estimate
-    };
-  }
-  destroy() {
-    this.config = null;
-  }
-}
-export {
-  S as ServerTTSProvider
-};