@pie-players/pie-assessment-toolkit 0.2.0

package/dist/services/tts/browser-provider.js

@@ -0,0 +1,177 @@
+/**
+ * Browser TTS Provider
+ *
+ * Text-to-speech provider using the browser's Web Speech API.
+ * Works in all modern browsers that support SpeechSynthesis.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+/**
+ * Browser TTS Provider
+ *
+ * Stateless factory for creating browser-based TTS implementations.
+ */
+export class BrowserTTSProvider {
+    providerId = "browser";
+    providerName = "Browser Speech Synthesis";
+    version = "1.0.0";
+    async initialize(config) {
+        // SSR guard
+        if (typeof window === "undefined") {
+            throw new Error("BrowserTTSProvider requires browser environment");
+        }
+        // Check browser support
+        if (!("speechSynthesis" in window)) {
+            throw new Error("Browser does not support Speech Synthesis API");
+        }
+        return new BrowserTTSProviderImpl(config);
+    }
+    supportsFeature(feature) {
+        // Browser supports all TTS features
+        return true;
+    }
+    getCapabilities() {
+        return {
+            supportsPause: true,
+            supportsResume: true,
+            supportsWordBoundary: true,
+            supportsVoiceSelection: true,
+            supportsRateControl: true,
+            supportsPitchControl: true,
+        };
+    }
+    destroy() {
+        // No cleanup needed for browser provider
+    }
+}
+/**
+ * Browser TTS Provider Implementation
+ *
+ * Handles actual speech synthesis using the Web Speech API.
+ */
+class BrowserTTSProviderImpl {
+    utterance = null;
+    config = null;
+    _isPlaying = false;
+    _isPaused = false;
+    constructor(config) {
+        this.config = config;
+    }
+    async speak(text) {
+        return new Promise((resolve, reject) => {
+            if (!this.config) {
+                reject(new Error("TTS not initialized"));
+                return;
+            }
+            this.stop(); // Stop any ongoing speech
+            this.utterance = new SpeechSynthesisUtterance(text);
+            // Track for word boundary fallback
+            let lastBoundaryIndex = -1;
+            let boundaryCount = 0;
+            // Apply config
+            if (this.config.voice) {
+                const voices = speechSynthesis.getVoices();
+                const voice = voices.find((v) => v.name === this.config.voice);
+                if (voice)
+                    this.utterance.voice = voice;
+            }
+            if (this.config.rate)
+                this.utterance.rate = this.config.rate;
+            if (this.config.pitch)
+                this.utterance.pitch = this.config.pitch;
+            // Set up event handlers
+            this.utterance.onstart = () => {
+                this._isPlaying = true;
+                this._isPaused = false;
+            };
+            this.utterance.onend = () => {
+                this._isPlaying = false;
+                this._isPaused = false;
+                resolve();
+            };
+            this.utterance.onerror = (event) => {
+                this._isPlaying = false;
+                this._isPaused = false;
+                // Ignore "interrupted" errors (expected when user stops TTS)
+                if (event.error === "interrupted" || event.error === "canceled") {
+                    resolve(); // Treat interruption as successful completion
+                    return;
+                }
+                reject(new Error(`Speech synthesis error: ${event.error}`));
+            };
+            this.utterance.onpause = () => {
+                this._isPaused = true;
+            };
+            this.utterance.onresume = () => {
+                this._isPaused = false;
+            };
+            // Word boundary events (if supported)
+            this.utterance.onboundary = (event) => {
+                console.log("[BrowserProvider] Boundary event:", event.name, "charIndex:", event.charIndex, "charLength:", event.charLength);
+                if (event.name === "word" && this.onWordBoundary) {
+                    boundaryCount++;
+                    // Detect if browser word boundaries are broken (Safari bug)
+                    // If we get multiple events at the same position, boundaries don't work
+                    if (event.charIndex === lastBoundaryIndex && boundaryCount > 2) {
+                        console.warn("[BrowserProvider] Browser word boundaries broken - disabling word highlighting");
+                        if (this.utterance) {
+                            this.utterance.onboundary = null; // Stop listening
+                        }
+                        return;
+                    }
+                    lastBoundaryIndex = event.charIndex;
+                    // Extract word from text
+                    const word = text.substring(event.charIndex, event.charIndex + (event.charLength || 0));
+                    console.log("[BrowserProvider] Calling onWordBoundary with word:", word, "at position:", event.charIndex);
+                    this.onWordBoundary(word, event.charIndex);
+                }
+            };
+            // Start speaking
+            speechSynthesis.speak(this.utterance);
+        });
+    }
+    pause() {
+        if (this._isPlaying && !this._isPaused) {
+            speechSynthesis.pause();
+        }
+    }
+    resume() {
+        if (this._isPlaying && this._isPaused) {
+            speechSynthesis.resume();
+        }
+    }
+    stop() {
+        if (this._isPlaying) {
+            speechSynthesis.cancel();
+            this._isPlaying = false;
+            this._isPaused = false;
+        }
+    }
+    isPlaying() {
+        return this._isPlaying && !this._isPaused;
+    }
+    isPaused() {
+        return this._isPaused;
+    }
+    /**
+     * Update settings dynamically (rate, pitch, voice)
+     * Changes take effect on the next speak() call
+     */
+    updateSettings(settings) {
+        if (!this.config) {
+            this.config = {};
+        }
+        // Update config with new settings
+        if (settings.rate !== undefined) {
+            this.config.rate = settings.rate;
+        }
+        if (settings.pitch !== undefined) {
+            this.config.pitch = settings.pitch;
+        }
+        if (settings.voice !== undefined) {
+            this.config.voice = settings.voice;
+        }
+    }
+    onWordBoundary;
+}
+//# sourceMappingURL=browser-provider.js.map

package/dist/services/tts/browser-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-provider.js","sourceRoot":"","sources":["../../../src/services/tts/browser-provider.ts"],"names":[],"mappings":"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"}

package/dist/services/tts/provider-interface.d.ts

@@ -0,0 +1,131 @@
+/**
+ * TTS Provider Interfaces
+ *
+ * Defines the contract for text-to-speech providers.
+ * Providers are stateless factories that create configured TTS implementations.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+import type { TTSConfig } from "../TTSService";
+/**
+ * TTS Provider interface
+ *
+ * Providers are stateless factories that create TTS implementations.
+ * They describe capabilities and create configured instances.
+ */
+export interface ITTSProvider {
+    /**
+     * Unique identifier for this provider
+     */
+    readonly providerId: string;
+    /**
+     * Human-readable provider name
+     */
+    readonly providerName: string;
+    /**
+     * Provider version
+     */
+    readonly version: string;
+    /**
+     * Initialize and create a configured TTS implementation
+     */
+    initialize(config: TTSConfig): Promise<ITTSProviderImplementation>;
+    /**
+     * Check if a specific feature is supported
+     */
+    supportsFeature(feature: TTSFeature): boolean;
+    /**
+     * Get provider capabilities
+     */
+    getCapabilities(): TTSProviderCapabilities;
+    /**
+     * Clean up provider resources
+     */
+    destroy(): void;
+}
+/**
+ * TTS Provider Implementation interface
+ *
+ * The actual TTS implementation that handles playback.
+ * Created by ITTSProvider.initialize()
+ */
+export interface ITTSProviderImplementation {
+    /**
+     * Speak text
+     */
+    speak(text: string): Promise<void>;
+    /**
+     * Pause playback
+     */
+    pause(): void;
+    /**
+     * Resume playback
+     */
+    resume(): void;
+    /**
+     * Stop playback
+     */
+    stop(): void;
+    /**
+     * Check if currently playing
+     */
+    isPlaying(): boolean;
+    /**
+     * Check if paused
+     */
+    isPaused(): boolean;
+    /**
+     * Update settings dynamically (optional)
+     * Allows changing rate, pitch, and voice without full reinitialization.
+     * Changes take effect on the next speak() call.
+     */
+    updateSettings?(settings: Partial<TTSConfig>): void | Promise<void>;
+    /**
+     * Word boundary callback (optional)
+     * Called during speech for word highlighting
+     * @param word - The word being spoken (may be empty for server providers)
+     * @param position - Character position in the text
+     * @param length - Optional word length (for server providers with speech marks)
+     */
+    onWordBoundary?: (word: string, position: number, length?: number) => void;
+}
+/**
+ * TTS Provider capabilities
+ *
+ * Describes which features a provider supports
+ */
+export interface TTSProviderCapabilities {
+    /**
+     * Supports pause/resume
+     */
+    supportsPause: boolean;
+    /**
+     * Supports resume after pause
+     */
+    supportsResume: boolean;
+    /**
+     * Supports word boundary events for highlighting
+     */
+    supportsWordBoundary: boolean;
+    /**
+     * Supports voice selection
+     */
+    supportsVoiceSelection: boolean;
+    /**
+     * Supports rate control (speed)
+     */
+    supportsRateControl: boolean;
+    /**
+     * Supports pitch control
+     */
+    supportsPitchControl: boolean;
+    /**
+     * Maximum text length (if limited)
+     */
+    maxTextLength?: number;
+}
+/**
+ * TTS features for capability checking
+ */
+export type TTSFeature = "pause" | "resume" | "wordBoundary" | "voiceSelection" | "rateControl" | "pitchControl";
+//# sourceMappingURL=provider-interface.d.ts.map

package/dist/services/tts/provider-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-interface.d.ts","sourceRoot":"","sources":["../../../src/services/tts/provider-interface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAEnE;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC;IAE9C;;OAEG;IACH,eAAe,IAAI,uBAAuB,CAAC;IAE3C;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IAC1C;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,MAAM,IAAI,IAAI,CAAC;IAEf;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC;IAErB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC;IAEpB;;;;OAIG;IACH,cAAc,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3E;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACvC;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,oBAAoB,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAEhC;;OAEG;IACH,mBAAmB,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,oBAAoB,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GACnB,OAAO,GACP,QAAQ,GACR,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,cAAc,CAAC"}

package/dist/services/tts/provider-interface.js

@@ -0,0 +1,10 @@
+/**
+ * TTS Provider Interfaces
+ *
+ * Defines the contract for text-to-speech providers.
+ * Providers are stateless factories that create configured TTS implementations.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+export {};
+//# sourceMappingURL=provider-interface.js.map

package/dist/services/tts/provider-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-interface.js","sourceRoot":"","sources":["../../../src/services/tts/provider-interface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/tools/calculators/desmos-provider.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Desmos Calculator Provider
+ * Implementation of CalculatorProvider for Desmos calculators
+ *
+ * Supports: Basic, Scientific, and Graphing calculators
+ * Based on Desmos API v1.10+
+ */
+import type { Calculator, CalculatorProvider, CalculatorProviderCapabilities, CalculatorProviderConfig, CalculatorType } from "@pie-players/pie-calculator";
+/**
+ * Desmos Calculator Provider Implementation
+ */
+export declare class DesmosCalculatorProvider implements CalculatorProvider {
+    readonly providerId = "desmos";
+    readonly providerName = "Desmos";
+    readonly supportedTypes: CalculatorType[];
+    readonly version = "1.10";
+    private initialized;
+    private apiKey?;
+    /**
+     * Get the configured API key
+     */
+    getApiKey(): string | undefined;
+    /**
+     * Initialize Desmos library
+     * @param config Optional configuration including API key
+     */
+    initialize(config?: {
+        apiKey?: string;
+    }): Promise<void>;
+    /**
+     * Create a calculator instance
+     */
+    createCalculator(type: CalculatorType, container: HTMLElement, config?: CalculatorProviderConfig): Promise<Calculator>;
+    /**
+     * Check if type is supported
+     */
+    supportsType(type: CalculatorType): boolean;
+    /**
+     * Cleanup (no-op for Desmos)
+     */
+    destroy(): void;
+    /**
+     * Get provider capabilities
+     */
+    getCapabilities(): CalculatorProviderCapabilities;
+}
+/**
+ * Singleton provider instance (deprecated)
+ * @deprecated Instantiate DesmosCalculatorProvider directly instead:
+ *   const provider = new DesmosCalculatorProvider();
+ *   await provider.initialize();
+ */
+export declare const desmosProvider: DesmosCalculatorProvider;
+//# sourceMappingURL=desmos-provider.d.ts.map

package/dist/tools/calculators/desmos-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desmos-provider.d.ts","sourceRoot":"","sources":["../../../src/tools/calculators/desmos-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAEX,UAAU,EACV,kBAAkB,EAClB,8BAA8B,EAC9B,wBAAwB,EAExB,cAAc,EAEd,MAAM,6BAA6B,CAAC;AAGrC;;GAEG;AACH,qBAAa,wBAAyB,YAAW,kBAAkB;IAClE,QAAQ,CAAC,UAAU,YAAY;IAC/B,QAAQ,CAAC,YAAY,YAAY;IACjC,QAAQ,CAAC,cAAc,EAAE,cAAc,EAAE,CAIvC;IACF,QAAQ,CAAC,OAAO,UAAU;IAE1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAS;IAExB;;OAEG;IACH,SAAS,IAAI,MAAM,GAAG,SAAS;IAI/B;;;OAGG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC7D;;OAEG;IACG,gBAAgB,CACrB,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,WAAW,EACtB,MAAM,CAAC,EAAE,wBAAwB,GAC/B,OAAO,CAAC,UAAU,CAAC;IAYtB;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAI3C;;OAEG;IACH,OAAO,IAAI,IAAI;IAKf;;OAEG;IACH,eAAe,IAAI,8BAA8B;CAUjD;AA6UD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,0BAAiC,CAAC"}