@pie-players/pie-assessment-toolkit 0.2.0

package/dist/services/tool-providers/TTSToolProvider.js

@@ -0,0 +1,168 @@
+/**
+ * TTS Tool Provider
+ *
+ * Unified provider for all TTS backends:
+ * - Browser Web Speech API (no auth)
+ * - AWS Polly (requires auth via server proxy)
+ * - Google Cloud TTS (requires auth via server proxy)
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+import { BrowserTTSProvider } from "../../services/tts/browser-provider";
+/**
+ * TTS Tool Provider
+ *
+ * Wraps TTS providers (Browser, Polly, Google) with the IToolProvider interface
+ * for use in the ToolProviderRegistry.
+ *
+ * @example Browser TTS (no auth)
+ * ```typescript
+ * const provider = new TTSToolProvider();
+ * await provider.initialize({ backend: 'browser' });
+ * const ttsProvider = await provider.createInstance();
+ * ```
+ *
+ * @example Server TTS (with auth)
+ * ```typescript
+ * const provider = new TTSToolProvider();
+ * await provider.initialize({
+ *   backend: 'polly',
+ *   apiEndpoint: '/api/tts/synthesize',
+ *   authToken: 'bearer-token', // Fetched via authFetcher
+ * });
+ * const ttsProvider = await provider.createInstance();
+ * ```
+ */
+export class TTSToolProvider {
+    providerId = "tts-service";
+    providerName = "Text-to-Speech";
+    category = "tts";
+    version = "1.0";
+    requiresAuth;
+    ttsProvider = null;
+    config = null;
+    /**
+     * Create TTS tool provider
+     *
+     * @param backend TTS backend to use (default: 'browser')
+     */
+    constructor(backend = "browser") {
+        this.requiresAuth = backend !== "browser";
+    }
+    /**
+     * Initialize TTS provider
+     *
+     * Sets up the appropriate TTS backend.
+     *
+     * @param config Configuration with backend type and credentials
+     * @throws Error if initialization fails or required config missing
+     */
+    async initialize(config) {
+        if (this.ttsProvider) {
+            console.warn("[TTSToolProvider] Already initialized, skipping reinitialization");
+            return;
+        }
+        this.config = config;
+        switch (config.backend) {
+            case "browser":
+                await this._initializeBrowserTTS(config);
+                break;
+            case "polly":
+            case "google":
+            case "server":
+                await this._initializeServerTTS(config);
+                break;
+            default:
+                throw new Error(`[TTSToolProvider] Unknown backend: ${config.backend}`);
+        }
+        console.log(`[TTSToolProvider] Initialized successfully (backend: ${config.backend})`);
+    }
+    /**
+     * Initialize browser TTS (Web Speech API)
+     */
+    async _initializeBrowserTTS(config) {
+        // Check if Web Speech API is available
+        if (typeof window === "undefined" || !("speechSynthesis" in window)) {
+            throw new Error("[TTSToolProvider] Browser TTS not supported (Web Speech API not available)");
+        }
+        this.ttsProvider = new BrowserTTSProvider();
+        console.log("[TTSToolProvider] Browser TTS initialized (Web Speech API)");
+    }
+    /**
+     * Initialize server-based TTS (Polly, Google)
+     */
+    async _initializeServerTTS(config) {
+        if (!config.apiEndpoint) {
+            throw new Error("[TTSToolProvider] apiEndpoint required for server-based TTS backends");
+        }
+        // Lazy-load ServerTTSProvider to avoid bundling if not needed
+        try {
+            const { ServerTTSProvider } = await import("@pie-players/tts-client-server");
+            // Create provider instance (no constructor args, will be initialized on first use)
+            this.ttsProvider = new ServerTTSProvider();
+            console.log(`[TTSToolProvider] Server TTS initialized (provider: ${config.serverProvider || config.backend})`);
+        }
+        catch (error) {
+            console.error("[TTSToolProvider] Failed to load ServerTTSProvider:", error);
+            throw new Error("Failed to load server TTS provider. Ensure @pie-players/tts-client-server is installed.");
+        }
+    }
+    /**
+     * Create a TTS provider instance
+     *
+     * Returns the initialized TTS provider.
+     *
+     * @param config Optional instance-specific configuration (currently unused)
+     * @returns TTS provider
+     * @throws Error if provider not initialized
+     */
+    async createInstance(config) {
+        if (!this.ttsProvider) {
+            throw new Error("[TTSToolProvider] Provider not initialized. Call initialize() first.");
+        }
+        return this.ttsProvider;
+    }
+    /**
+     * Get provider capabilities
+     *
+     * @returns TTS capabilities based on backend
+     */
+    getCapabilities() {
+        const isBrowser = this.config?.backend === "browser";
+        return {
+            supportsOffline: isBrowser,
+            requiresAuth: !isBrowser,
+            maxInstances: 1, // Single TTS instance (playback is sequential)
+            features: {
+                wordBoundary: true, // All backends support word highlighting
+                pause: true,
+                resume: true,
+                rateControl: true,
+                pitchControl: isBrowser, // Only browser supports pitch
+                voiceSelection: true,
+            },
+        };
+    }
+    /**
+     * Check if provider is ready
+     *
+     * @returns true if provider is initialized
+     */
+    isReady() {
+        return this.ttsProvider !== null;
+    }
+    /**
+     * Clean up provider resources
+     *
+     * Destroys the TTS provider and releases resources.
+     */
+    destroy() {
+        if (this.ttsProvider) {
+            this.ttsProvider.destroy();
+            this.ttsProvider = null;
+        }
+        this.config = null;
+        console.log("[TTSToolProvider] Destroyed");
+    }
+}
+//# sourceMappingURL=TTSToolProvider.js.map

package/dist/services/tool-providers/TTSToolProvider.js.map

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

package/dist/services/tool-providers/ToolProviderRegistry.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Tool Provider Registry
+ *
+ * Centralized registry for managing tool providers.
+ * Handles initialization, authentication, and lazy loading.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+import type { IToolProvider, ToolCategory } from "./IToolProvider";
+/**
+ * Configuration for registering a tool provider
+ */
+export interface ToolProviderConfig<TConfig = any> {
+    /**
+     * Provider instance to register
+     */
+    provider: IToolProvider<TConfig>;
+    /**
+     * Configuration for this provider
+     * (may include auth credentials, endpoints, etc.)
+     */
+    config: TConfig;
+    /**
+     * Lazy initialization - don't initialize until first use
+     *
+     * @default true
+     * @note Set to false for providers that must be ready immediately
+     */
+    lazy?: boolean;
+    /**
+     * Auth fetcher - function to retrieve auth credentials from backend
+     *
+     * Called during initialization if the provider requires auth.
+     * The returned data is merged with the config before initialization.
+     *
+     * @example
+     * ```typescript
+     * authFetcher: async () => {
+     *   const response = await fetch('/api/desmos/token');
+     *   return response.json(); // { apiKey: '...' }
+     * }
+     * ```
+     */
+    authFetcher?: () => Promise<Partial<TConfig>>;
+}
+/**
+ * Tool Provider Registry
+ *
+ * Manages the lifecycle of tool providers:
+ * - Registration
+ * - Lazy initialization
+ * - Auth credential fetching
+ * - Provider lookup by ID or category
+ *
+ * @example
+ * ```typescript
+ * const registry = new ToolProviderRegistry();
+ *
+ * // Register a provider with auth fetcher
+ * registry.register('desmos-calculator', {
+ *   provider: new DesmosToolProvider(),
+ *   config: {},
+ *   lazy: true,
+ *   authFetcher: async () => {
+ *     const response = await fetch('/api/desmos/token');
+ *     return response.json();
+ *   },
+ * });
+ *
+ * // Get provider (auto-initializes if lazy)
+ * const desmosProvider = await registry.getProvider('desmos-calculator');
+ * ```
+ */
+export declare class ToolProviderRegistry {
+    private providers;
+    private configs;
+    private initialized;
+    private initializationPromises;
+    /**
+     * Register a tool provider
+     *
+     * Adds a provider to the registry. If lazy is false, initializes immediately.
+     *
+     * @param providerId Unique provider identifier
+     * @param config Provider configuration
+     * @throws Error if provider with same ID already registered
+     */
+    register(providerId: string, config: ToolProviderConfig): void;
+    /**
+     * Initialize a provider
+     *
+     * Fetches auth if needed and initializes the provider.
+     * Safe to call multiple times - subsequent calls wait for first initialization.
+     *
+     * @param providerId Provider to initialize
+     * @returns Promise that resolves when initialization complete
+     * @throws Error if provider not registered or initialization fails
+     */
+    initialize(providerId: string): Promise<void>;
+    /**
+     * Internal initialization logic
+     */
+    private _doInitialize;
+    /**
+     * Get a provider instance
+     *
+     * Retrieves a registered provider. If autoInitialize is true and provider
+     * is not initialized, initializes it first.
+     *
+     * @param providerId Provider identifier
+     * @param autoInitialize Auto-initialize if not ready (default: true)
+     * @returns Provider instance
+     * @throws Error if provider not registered
+     */
+    getProvider<T extends IToolProvider = IToolProvider>(providerId: string, autoInitialize?: boolean): Promise<T>;
+    /**
+     * Get all providers in a category
+     *
+     * @param category Tool category to filter by
+     * @returns Array of provider IDs in the category
+     */
+    getProvidersByCategory(category: ToolCategory): string[];
+    /**
+     * Get all registered provider IDs
+     *
+     * @returns Array of all provider IDs
+     */
+    getProviderIds(): string[];
+    /**
+     * Check if provider is registered
+     *
+     * @param providerId Provider identifier
+     * @returns true if provider is registered
+     */
+    has(providerId: string): boolean;
+    /**
+     * Check if provider is initialized
+     *
+     * @param providerId Provider identifier
+     * @returns true if provider is initialized
+     */
+    isInitialized(providerId: string): boolean;
+    /**
+     * Check if provider is currently initializing
+     *
+     * @param providerId Provider identifier
+     * @returns true if initialization in progress
+     */
+    isInitializing(providerId: string): boolean;
+    /**
+     * Unregister and destroy a provider
+     *
+     * Removes the provider from the registry and calls its destroy method.
+     *
+     * @param providerId Provider to unregister
+     */
+    unregister(providerId: string): Promise<void>;
+    /**
+     * Clean up all providers
+     *
+     * Unregisters and destroys all providers in the registry.
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=ToolProviderRegistry.d.ts.map

package/dist/services/tool-providers/ToolProviderRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolProviderRegistry.d.ts","sourceRoot":"","sources":["../../../src/services/tool-providers/ToolProviderRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,OAAO,GAAG,GAAG;IAChD;;OAEG;IACH,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAEjC;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,oBAAoB;IAChC,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,sBAAsB,CAAoC;IAElE;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IA2B9D;;;;;;;;;OASG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBnD;;OAEG;YACW,aAAa;IAgD3B;;;;;;;;;;OAUG;IACG,WAAW,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,EACxD,UAAU,EAAE,MAAM,EAClB,cAAc,UAAO,GACnB,OAAO,CAAC,CAAC,CAAC;IAgBb;;;;;OAKG;IACH,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE;IAMxD;;;;OAIG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;;;;OAKG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIhC;;;;;OAKG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI1C;;;;;OAKG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI3C;;;;;;OAMG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BnD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAK9B"}

package/dist/services/tool-providers/ToolProviderRegistry.js

@@ -0,0 +1,240 @@
+/**
+ * Tool Provider Registry
+ *
+ * Centralized registry for managing tool providers.
+ * Handles initialization, authentication, and lazy loading.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+/**
+ * Tool Provider Registry
+ *
+ * Manages the lifecycle of tool providers:
+ * - Registration
+ * - Lazy initialization
+ * - Auth credential fetching
+ * - Provider lookup by ID or category
+ *
+ * @example
+ * ```typescript
+ * const registry = new ToolProviderRegistry();
+ *
+ * // Register a provider with auth fetcher
+ * registry.register('desmos-calculator', {
+ *   provider: new DesmosToolProvider(),
+ *   config: {},
+ *   lazy: true,
+ *   authFetcher: async () => {
+ *     const response = await fetch('/api/desmos/token');
+ *     return response.json();
+ *   },
+ * });
+ *
+ * // Get provider (auto-initializes if lazy)
+ * const desmosProvider = await registry.getProvider('desmos-calculator');
+ * ```
+ */
+export class ToolProviderRegistry {
+    providers = new Map();
+    configs = new Map();
+    initialized = new Map();
+    initializationPromises = new Map();
+    /**
+     * Register a tool provider
+     *
+     * Adds a provider to the registry. If lazy is false, initializes immediately.
+     *
+     * @param providerId Unique provider identifier
+     * @param config Provider configuration
+     * @throws Error if provider with same ID already registered
+     */
+    register(providerId, config) {
+        if (this.providers.has(providerId)) {
+            console.warn(`[ToolProviderRegistry] Provider "${providerId}" already registered, skipping`);
+            return;
+        }
+        this.providers.set(providerId, config.provider);
+        this.configs.set(providerId, config);
+        this.initialized.set(providerId, false);
+        console.log(`[ToolProviderRegistry] Registered provider "${providerId}" (${config.provider.providerName})`);
+        // Initialize immediately if not lazy
+        if (config.lazy === false) {
+            this.initialize(providerId).catch((error) => {
+                console.error(`[ToolProviderRegistry] Failed to initialize provider "${providerId}":`, error);
+            });
+        }
+    }
+    /**
+     * Initialize a provider
+     *
+     * Fetches auth if needed and initializes the provider.
+     * Safe to call multiple times - subsequent calls wait for first initialization.
+     *
+     * @param providerId Provider to initialize
+     * @returns Promise that resolves when initialization complete
+     * @throws Error if provider not registered or initialization fails
+     */
+    async initialize(providerId) {
+        // Already initialized
+        if (this.initialized.get(providerId)) {
+            return;
+        }
+        // Initialization in progress - wait for it
+        const existingPromise = this.initializationPromises.get(providerId);
+        if (existingPromise) {
+            return existingPromise;
+        }
+        // Start new initialization
+        const initPromise = this._doInitialize(providerId);
+        this.initializationPromises.set(providerId, initPromise);
+        try {
+            await initPromise;
+        }
+        finally {
+            this.initializationPromises.delete(providerId);
+        }
+    }
+    /**
+     * Internal initialization logic
+     */
+    async _doInitialize(providerId) {
+        const provider = this.providers.get(providerId);
+        const config = this.configs.get(providerId);
+        if (!provider || !config) {
+            throw new Error(`[ToolProviderRegistry] Provider "${providerId}" not registered`);
+        }
+        // Start with base config
+        let providerConfig = { ...config.config };
+        // Fetch auth if needed
+        if (provider.requiresAuth && config.authFetcher) {
+            console.log(`[ToolProviderRegistry] Fetching auth for "${providerId}"...`);
+            try {
+                const authData = await config.authFetcher();
+                providerConfig = { ...providerConfig, ...authData };
+            }
+            catch (error) {
+                console.error(`[ToolProviderRegistry] Auth fetch failed for "${providerId}":`, error);
+                throw new Error(`Failed to fetch auth credentials for provider "${providerId}"`);
+            }
+        }
+        // Initialize provider
+        try {
+            await provider.initialize(providerConfig);
+            this.initialized.set(providerId, true);
+            console.log(`[ToolProviderRegistry] Provider "${providerId}" initialized`);
+        }
+        catch (error) {
+            console.error(`[ToolProviderRegistry] Initialization failed for "${providerId}":`, error);
+            throw error;
+        }
+    }
+    /**
+     * Get a provider instance
+     *
+     * Retrieves a registered provider. If autoInitialize is true and provider
+     * is not initialized, initializes it first.
+     *
+     * @param providerId Provider identifier
+     * @param autoInitialize Auto-initialize if not ready (default: true)
+     * @returns Provider instance
+     * @throws Error if provider not registered
+     */
+    async getProvider(providerId, autoInitialize = true) {
+        const provider = this.providers.get(providerId);
+        if (!provider) {
+            throw new Error(`[ToolProviderRegistry] Provider "${providerId}" not registered`);
+        }
+        // Auto-initialize if needed
+        if (autoInitialize && !this.initialized.get(providerId)) {
+            await this.initialize(providerId);
+        }
+        return provider;
+    }
+    /**
+     * Get all providers in a category
+     *
+     * @param category Tool category to filter by
+     * @returns Array of provider IDs in the category
+     */
+    getProvidersByCategory(category) {
+        return Array.from(this.providers.entries())
+            .filter(([_, provider]) => provider.category === category)
+            .map(([id]) => id);
+    }
+    /**
+     * Get all registered provider IDs
+     *
+     * @returns Array of all provider IDs
+     */
+    getProviderIds() {
+        return Array.from(this.providers.keys());
+    }
+    /**
+     * Check if provider is registered
+     *
+     * @param providerId Provider identifier
+     * @returns true if provider is registered
+     */
+    has(providerId) {
+        return this.providers.has(providerId);
+    }
+    /**
+     * Check if provider is initialized
+     *
+     * @param providerId Provider identifier
+     * @returns true if provider is initialized
+     */
+    isInitialized(providerId) {
+        return this.initialized.get(providerId) === true;
+    }
+    /**
+     * Check if provider is currently initializing
+     *
+     * @param providerId Provider identifier
+     * @returns true if initialization in progress
+     */
+    isInitializing(providerId) {
+        return this.initializationPromises.has(providerId);
+    }
+    /**
+     * Unregister and destroy a provider
+     *
+     * Removes the provider from the registry and calls its destroy method.
+     *
+     * @param providerId Provider to unregister
+     */
+    async unregister(providerId) {
+        const provider = this.providers.get(providerId);
+        if (provider) {
+            // Wait for any pending initialization
+            const initPromise = this.initializationPromises.get(providerId);
+            if (initPromise) {
+                try {
+                    await initPromise;
+                }
+                catch {
+                    // Ignore initialization errors during unregister
+                }
+            }
+            // Destroy provider
+            provider.destroy();
+            // Remove from registry
+            this.providers.delete(providerId);
+            this.configs.delete(providerId);
+            this.initialized.delete(providerId);
+            this.initializationPromises.delete(providerId);
+            console.log(`[ToolProviderRegistry] Unregistered provider "${providerId}"`);
+        }
+    }
+    /**
+     * Clean up all providers
+     *
+     * Unregisters and destroys all providers in the registry.
+     */
+    async destroy() {
+        const providerIds = Array.from(this.providers.keys());
+        await Promise.all(providerIds.map((id) => this.unregister(id)));
+        console.log("[ToolProviderRegistry] Registry destroyed");
+    }
+}
+//# sourceMappingURL=ToolProviderRegistry.js.map

package/dist/services/tool-providers/ToolProviderRegistry.js.map

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

package/dist/services/tool-providers/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Tool Provider System
+ *
+ * Unified framework for managing assessment tools with authentication,
+ * configuration, and lifecycle management.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+export type { IToolProvider, ToolCategory, ToolProviderCapabilities, } from "./IToolProvider";
+export { ToolProviderRegistry } from "./ToolProviderRegistry";
+export type { ToolProviderConfig } from "./ToolProviderRegistry";
+export { DesmosToolProvider } from "./DesmosToolProvider";
+export type { DesmosToolProviderConfig } from "./DesmosToolProvider";
+export { TIToolProvider } from "./TIToolProvider";
+export type { TIToolProviderConfig } from "./TIToolProvider";
+export { TTSToolProvider } from "./TTSToolProvider";
+export type { TTSToolProviderConfig, TTSBackend, } from "./TTSToolProvider";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/tool-providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/tool-providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACX,aAAa,EACb,YAAY,EACZ,wBAAwB,GACxB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAErE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACX,qBAAqB,EACrB,UAAU,GACV,MAAM,mBAAmB,CAAC"}

package/dist/services/tool-providers/index.js

@@ -0,0 +1,15 @@
+/**
+ * Tool Provider System
+ *
+ * Unified framework for managing assessment tools with authentication,
+ * configuration, and lifecycle management.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+// Registry
+export { ToolProviderRegistry } from "./ToolProviderRegistry";
+// Concrete providers
+export { DesmosToolProvider } from "./DesmosToolProvider";
+export { TIToolProvider } from "./TIToolProvider";
+export { TTSToolProvider } from "./TTSToolProvider";
+//# sourceMappingURL=index.js.map

package/dist/services/tool-providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/tool-providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,WAAW;AACX,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,qBAAqB;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,24 @@
+/**
+ * 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.
+ */
+import type { ITTSProvider, ITTSProviderImplementation, TTSConfig, TTSFeature, TTSProviderCapabilities } from "@pie-players/pie-tts";
+/**
+ * Browser TTS Provider
+ *
+ * Stateless factory for creating browser-based TTS implementations.
+ */
+export declare class BrowserTTSProvider implements ITTSProvider {
+    readonly providerId = "browser";
+    readonly providerName = "Browser Speech Synthesis";
+    readonly version = "1.0.0";
+    initialize(config: TTSConfig): Promise<ITTSProviderImplementation>;
+    supportsFeature(feature: TTSFeature): boolean;
+    getCapabilities(): TTSProviderCapabilities;
+    destroy(): void;
+}
+//# sourceMappingURL=browser-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-provider.d.ts","sourceRoot":"","sources":["../../../src/services/tts/browser-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACX,YAAY,EACZ,0BAA0B,EAC1B,SAAS,EACT,UAAU,EACV,uBAAuB,EACvB,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACtD,QAAQ,CAAC,UAAU,aAAa;IAChC,QAAQ,CAAC,YAAY,8BAA8B;IACnD,QAAQ,CAAC,OAAO,WAAW;IAErB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAcxE,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO;IAK7C,eAAe,IAAI,uBAAuB;IAW1C,OAAO,IAAI,IAAI;CAGf"}