@pie-players/pie-assessment-toolkit 0.2.0

package/dist/services/interfaces.d.ts

@@ -0,0 +1,391 @@
+/**
+ * Service Interfaces
+ *
+ * Public interfaces for all core assessment toolkit services.
+ * These interfaces define the contracts that service implementations must fulfill,
+ * enabling dependency injection, testing, and custom implementations.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+import type { II18nService } from "@pie-players/pie-players-shared/i18n";
+import type { AccessibilityCatalogResolver, CatalogLookupOptions, CatalogStatistics, CatalogType, ResolvedCatalog } from "./AccessibilityCatalogResolver";
+import type { HighlightColor, HighlightType } from "./HighlightCoordinator";
+import type { ThemeConfig } from "./ThemeProvider";
+import type { ZIndexLayer } from "./ToolCoordinator";
+import type { PlaybackState, TTSConfig } from "./TTSService";
+import type { ITTSProvider, TTSProviderCapabilities } from "./tts/provider-interface";
+export type { II18nService };
+/**
+ * Theme provider interface
+ *
+ * Applies consistent accessibility theming across items and tools.
+ */
+export interface IThemeProvider {
+    /**
+     * Apply theme configuration
+     */
+    applyTheme(config: ThemeConfig): void;
+    /**
+     * Get current theme configuration
+     */
+    getCurrentTheme(): Required<ThemeConfig>;
+    /**
+     * Reset to default theme
+     */
+    reset(): void;
+    /**
+     * Clean up and remove theme styles
+     */
+    destroy(): void;
+}
+/**
+ * Highlight coordinator interface
+ *
+ * Manages content highlighting for TTS, annotations, and selections.
+ */
+export interface IHighlightCoordinator {
+    /**
+     * Highlight a text range
+     */
+    highlightRange(range: Range, type: HighlightType, color: HighlightColor): void;
+    /**
+     * Highlight a word for TTS (temporary)
+     */
+    highlightTTSWord(textNode: Text, startOffset: number, endOffset: number): void;
+    /**
+     * Highlight sentence(s) for TTS (background layer)
+     */
+    highlightTTSSentence(ranges: Range[]): void;
+    /**
+     * Clear all TTS highlights (word and sentence)
+     */
+    clearTTS(): void;
+    /**
+     * Clear highlights of a specific type
+     */
+    clearHighlights(type: HighlightType): void;
+    /**
+     * Clear all highlights
+     */
+    clearAll(): void;
+    /**
+     * Check if highlighting is supported in current environment
+     */
+    isSupported(): boolean;
+    /**
+     * Update TTS highlight style dynamically
+     */
+    updateTTSHighlightStyle(color: string, opacity: number): void;
+}
+/**
+ * Tool state interface
+ */
+export interface ToolState {
+    id: string;
+    name: string;
+    isVisible: boolean;
+    element: HTMLElement | null;
+    layer: ZIndexLayer;
+}
+/**
+ * Tool coordinator interface
+ *
+ * Manages z-index layering and visibility for floating tools.
+ */
+export interface IToolCoordinator {
+    /**
+     * Register a tool with the coordinator
+     */
+    registerTool(id: string, name: string, element?: HTMLElement, layer?: ZIndexLayer): void;
+    /**
+     * Unregister a tool
+     */
+    unregisterTool(id: string): void;
+    /**
+     * Show a tool
+     */
+    showTool(id: string): void;
+    /**
+     * Hide a tool
+     */
+    hideTool(id: string): void;
+    /**
+     * Bring an element to the front of its layer
+     */
+    bringToFront(element: HTMLElement): void;
+    /**
+     * Update the element reference for a tool
+     */
+    updateToolElement(id: string, element: HTMLElement): void;
+    /**
+     * Get state for a specific tool
+     */
+    getToolState(id: string): ToolState | undefined;
+    /**
+     * Get all visible tools
+     */
+    getVisibleTools(): ToolState[];
+    /**
+     * Subscribe to tool state changes
+     */
+    subscribe(listener: () => void): () => void;
+}
+/**
+ * TTS service interface
+ *
+ * Provides text-to-speech functionality with provider-based architecture.
+ * Supports QTI 3.0 accessibility catalogs for pre-authored spoken content.
+ */
+export interface ITTSService {
+    /**
+     * Initialize TTS with a provider
+     */
+    initialize(provider: ITTSProvider, config?: Partial<TTSConfig>): Promise<void>;
+    /**
+     * Speak text with optional catalog support
+     */
+    speak(text: string, options?: {
+        catalogId?: string;
+        language?: string;
+    }): Promise<void>;
+    /**
+     * Speak a text range
+     */
+    speakRange(range: Range): 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;
+    /**
+     * Get current playback state
+     */
+    getState(): PlaybackState;
+    /**
+     * Get currently speaking text
+     */
+    getCurrentText(): string | null;
+    /**
+     * Subscribe to state changes
+     */
+    onStateChange(id: string, callback: (state: PlaybackState) => void): void;
+    /**
+     * Unsubscribe from state changes
+     */
+    offStateChange(id: string, callback: (state: PlaybackState) => void): void;
+    /**
+     * Get capabilities of current provider
+     */
+    getCapabilities(): TTSProviderCapabilities | null;
+    /**
+     * Update TTS settings dynamically (rate, pitch, voice)
+     */
+    updateSettings(settings: Partial<TTSConfig>): Promise<void>;
+    /**
+     * Set highlight coordinator for word highlighting
+     */
+    setHighlightCoordinator(coordinator: IHighlightCoordinator): void;
+    /**
+     * Set accessibility catalog resolver for spoken content
+     */
+    setCatalogResolver(resolver: AccessibilityCatalogResolver): void;
+}
+/**
+ * Accessibility catalog resolver interface
+ *
+ * Manages QTI 3.0 accessibility catalogs at assessment and item levels.
+ * Provides lookup and resolution services for alternative content representations.
+ */
+export interface IAccessibilityCatalogResolver {
+    /**
+     * Set the default language for fallback resolution
+     */
+    setDefaultLanguage(language: string): void;
+    /**
+     * Get the default language
+     */
+    getDefaultLanguage(): string;
+    /**
+     * Add item-level catalogs (called when rendering a new item)
+     */
+    addItemCatalogs(catalogs: any[]): void;
+    /**
+     * Clear item-level catalogs (called when leaving an item)
+     */
+    clearItemCatalogs(): void;
+    /**
+     * Check if a catalog exists
+     */
+    hasCatalog(catalogId: string): boolean;
+    /**
+     * Get alternative content for a catalog identifier
+     */
+    getAlternative(catalogId: string, options: CatalogLookupOptions): ResolvedCatalog | null;
+    /**
+     * Get all available alternatives for a catalog identifier
+     */
+    getAllAlternatives(catalogId: string): ResolvedCatalog[];
+    /**
+     * Get all catalog identifiers available
+     */
+    getAllCatalogIds(): string[];
+    /**
+     * Get statistics about available catalogs
+     */
+    getStatistics(): CatalogStatistics;
+    /**
+     * Check if a specific catalog type is available
+     */
+    hasAlternativeType(catalogId: string, type: CatalogType): boolean;
+    /**
+     * Get all catalog IDs that have a specific type of alternative
+     */
+    getCatalogsByType(type: CatalogType): string[];
+    /**
+     * Reset all catalogs
+     */
+    reset(): void;
+    /**
+     * Destroy and cleanup
+     */
+    destroy(): void;
+}
+/**
+ * Element tool state store interface
+ *
+ * Manages element-level ephemeral tool state using composite keys for global uniqueness.
+ * Tool state is client-only and separate from PIE session data (which is sent to server for scoring).
+ */
+export interface IElementToolStateStore {
+    /**
+     * Generate a globally unique element ID from components
+     */
+    getGlobalElementId(assessmentId: string, sectionId: string, itemId: string, elementId: string): string;
+    /**
+     * Parse a global element ID into its components
+     */
+    parseGlobalElementId(globalElementId: string): {
+        assessmentId: string;
+        sectionId: string;
+        itemId: string;
+        elementId: string;
+    } | null;
+    /**
+     * Set state for a specific tool on an element
+     */
+    setState(globalElementId: string, toolId: string, state: any): void;
+    /**
+     * Get state for a specific tool on an element
+     */
+    getState(globalElementId: string, toolId: string): any | undefined;
+    /**
+     * Get all tool states for a specific element
+     */
+    getElementState(globalElementId: string): Record<string, any>;
+    /**
+     * Get all element states
+     */
+    getAllState(): Record<string, Record<string, any>>;
+    /**
+     * Subscribe to state changes
+     */
+    subscribe(callback: (state: Map<string, Map<string, any>>) => void): () => void;
+    /**
+     * Set callback for persistence integration
+     */
+    setOnStateChange(callback: (state: Record<string, Record<string, any>>) => void): void;
+    /**
+     * Load state from persistence
+     */
+    loadState(state: Record<string, Record<string, any>>): void;
+    /**
+     * Clear state for a specific element
+     */
+    clearElement(globalElementId: string): void;
+    /**
+     * Clear state for a specific tool across all elements
+     */
+    clearTool(toolId: string): void;
+    /**
+     * Clear all elements in a specific section
+     */
+    clearSection(assessmentId: string, sectionId: string): void;
+    /**
+     * Clear all state
+     */
+    clearAll(): void;
+}
+/**
+ * Toolkit coordinator interface
+ *
+ * Orchestrates all toolkit services (TTS, tools, accessibility, state management) from a single entry point.
+ * Provides centralized configuration for tool availability and settings.
+ */
+export interface IToolkitCoordinator {
+    /**
+     * Assessment identifier
+     */
+    readonly assessmentId: string;
+    /**
+     * Configuration
+     */
+    readonly config: any;
+    /**
+     * TTS service
+     */
+    readonly ttsService: ITTSService;
+    /**
+     * Tool coordinator
+     */
+    readonly toolCoordinator: IToolCoordinator;
+    /**
+     * Highlight coordinator
+     */
+    readonly highlightCoordinator: IHighlightCoordinator;
+    /**
+     * Element tool state store
+     */
+    readonly elementToolStateStore: IElementToolStateStore;
+    /**
+     * Catalog resolver
+     */
+    readonly catalogResolver: IAccessibilityCatalogResolver;
+    /**
+     * Get all services as a bundle
+     */
+    getServiceBundle(): {
+        ttsService: ITTSService;
+        toolCoordinator: IToolCoordinator;
+        highlightCoordinator: IHighlightCoordinator;
+        elementToolStateStore: IElementToolStateStore;
+        catalogResolver: IAccessibilityCatalogResolver;
+    };
+    /**
+     * Check if a tool is enabled
+     */
+    isToolEnabled(toolId: string): boolean;
+    /**
+     * Get tool configuration
+     */
+    getToolConfig(toolId: string): any | null;
+    /**
+     * Update tool configuration
+     */
+    updateToolConfig(toolId: string, updates: any): void;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/services/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/services/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EACX,4BAA4B,EAC5B,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAY,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,KAAK,EACX,YAAY,EACZ,uBAAuB,EACvB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAEtC;;OAEG;IACH,eAAe,IAAI,QAAQ,CAAC,WAAW,CAAC,CAAC;IAEzC;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACrC;;OAEG;IACH,cAAc,CACb,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,cAAc,GACnB,IAAI,CAAC;IAER;;OAEG;IACH,gBAAgB,CACf,QAAQ,EAAE,IAAI,EACd,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GACf,IAAI,CAAC;IAER;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAE5C;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;IAEjB;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAE3C;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;IAEjB;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,WAAW,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,YAAY,CACX,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,EACrB,KAAK,CAAC,EAAE,WAAW,GACjB,IAAI,CAAC;IAER;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAE1D;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAEhD;;OAEG;IACH,eAAe,IAAI,SAAS,EAAE,CAAC;IAE/B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC3B;;OAEG;IACH,UAAU,CACT,QAAQ,EAAE,YAAY,EACtB,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GACzB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;OAEG;IACH,KAAK,CACJ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GACjD,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;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;;OAEG;IACH,QAAQ,IAAI,aAAa,CAAC;IAE1B;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI,CAAC;IAEhC;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAAC;IAE1E;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAAC;IAE3E;;OAEG;IACH,eAAe,IAAI,uBAAuB,GAAG,IAAI,CAAC;IAElD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;OAEG;IACH,uBAAuB,CAAC,WAAW,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAElE;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,4BAA4B,GAAG,IAAI,CAAC;CACjE;AAED;;;;;GAKG;AACH,MAAM,WAAW,6BAA6B;IAC7C;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3C;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC;IAE7B;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEvC;;OAEG;IACH,iBAAiB,IAAI,IAAI,CAAC;IAE1B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAEvC;;OAEG;IACH,cAAc,CACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,oBAAoB,GAC3B,eAAe,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;IAEzD;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE,CAAC;IAE7B;;OAEG;IACH,aAAa,IAAI,iBAAiB,CAAC;IAEnC;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;IAElE;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,EAAE,CAAC;IAE/C;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACtC;;OAEG;IACH,kBAAkB,CACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GACf,MAAM,CAAC;IAEV;;OAEG;IACH,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG;QAC9C,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI,CAAC;IAET;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IAEpE;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC;IAEnE;;OAEG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9D;;OAEG;IACH,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAEnD;;OAEG;IACH,SAAS,CACR,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI,GACtD,MAAM,IAAI,CAAC;IAEd;;OAEG;IACH,gBAAgB,CACf,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI,GAC5D,IAAI,CAAC;IAER;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;IAE5D;;OAEG;IACH,YAAY,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5D;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IACnC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,oBAAoB,EAAE,qBAAqB,CAAC;IAErD;;OAEG;IACH,QAAQ,CAAC,qBAAqB,EAAE,sBAAsB,CAAC;IAEvD;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,6BAA6B,CAAC;IAExD;;OAEG;IACH,gBAAgB,IAAI;QACnB,UAAU,EAAE,WAAW,CAAC;QACxB,eAAe,EAAE,gBAAgB,CAAC;QAClC,oBAAoB,EAAE,qBAAqB,CAAC;QAC5C,qBAAqB,EAAE,sBAAsB,CAAC;QAC9C,eAAe,EAAE,6BAA6B,CAAC;KAC/C,CAAC;IAEF;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAEvC;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC;IAE1C;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI,CAAC;CACrD"}

package/dist/services/interfaces.js

@@ -0,0 +1,12 @@
+/**
+ * Service Interfaces
+ *
+ * Public interfaces for all core assessment toolkit services.
+ * These interfaces define the contracts that service implementations must fulfill,
+ * enabling dependency injection, testing, and custom implementations.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+export {};
+// II18nService is re-exported from @pie-players/pie-players-shared/i18n
+//# sourceMappingURL=interfaces.js.map

package/dist/services/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/services/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;;AAkfH,wEAAwE"}

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

@@ -0,0 +1,103 @@
+/**
+ * Desmos Calculator Tool Provider
+ *
+ * Provides Desmos calculators (basic, scientific, graphing)
+ * with authentication and proxy support.
+ *
+ * SECURITY BEST PRACTICE:
+ * - Development: Pass apiKey directly for local testing
+ * - Production: Use proxyEndpoint or authFetcher to keep API key server-side
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+import type { CalculatorProvider, DesmosCalculatorConfig } from "@pie-players/pie-calculator";
+import type { IToolProvider, ToolProviderCapabilities } from "./IToolProvider";
+/**
+ * Desmos tool provider configuration
+ */
+export interface DesmosToolProviderConfig {
+    /**
+     * Desmos API key (DEVELOPMENT ONLY)
+     * Never expose in production client code!
+     *
+     * Obtain from: https://www.desmos.com/api
+     */
+    apiKey?: string;
+    /**
+     * Server proxy endpoint (PRODUCTION RECOMMENDED)
+     * Backend handles API key securely
+     *
+     * @example '/api/desmos/token'
+     * @example 'https://api.myapp.com/tools/desmos/auth'
+     */
+    proxyEndpoint?: string;
+    /**
+     * Default calculator configuration applied to all instances
+     */
+    defaultConfig?: DesmosCalculatorConfig;
+}
+/**
+ * Desmos Calculator Tool Provider
+ *
+ * Wraps DesmosCalculatorProvider with the IToolProvider interface
+ * for use in the ToolProviderRegistry.
+ *
+ * @example
+ * ```typescript
+ * const provider = new DesmosToolProvider();
+ *
+ * await provider.initialize({
+ *   apiKey: 'your-api-key', // Development only
+ *   proxyEndpoint: '/api/desmos/token', // Production
+ * });
+ *
+ * const calculatorProvider = await provider.createInstance();
+ * ```
+ */
+export declare class DesmosToolProvider implements IToolProvider<DesmosToolProviderConfig, CalculatorProvider> {
+    readonly providerId = "desmos-calculator";
+    readonly providerName = "Desmos Calculator";
+    readonly category: "calculator";
+    readonly version = "1.10";
+    readonly requiresAuth = true;
+    private desmosProvider;
+    private config;
+    /**
+     * Initialize Desmos calculator provider
+     *
+     * Loads the Desmos API library and authenticates with provided credentials.
+     *
+     * @param config Configuration with API key or proxy endpoint
+     * @throws Error if initialization fails
+     */
+    initialize(config: DesmosToolProviderConfig): Promise<void>;
+    /**
+     * Create a calculator provider instance
+     *
+     * Returns the initialized Desmos calculator provider.
+     *
+     * @param config Optional instance-specific configuration (currently unused)
+     * @returns Desmos calculator provider
+     * @throws Error if provider not initialized
+     */
+    createInstance(config?: Partial<DesmosToolProviderConfig>): Promise<CalculatorProvider>;
+    /**
+     * Get provider capabilities
+     *
+     * @returns Desmos calculator capabilities
+     */
+    getCapabilities(): ToolProviderCapabilities;
+    /**
+     * Check if provider is ready
+     *
+     * @returns true if provider is initialized
+     */
+    isReady(): boolean;
+    /**
+     * Clean up provider resources
+     *
+     * Destroys the Desmos calculator provider and releases resources.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=DesmosToolProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DesmosToolProvider.d.ts","sourceRoot":"","sources":["../../../src/services/tool-providers/DesmosToolProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACX,kBAAkB,EAClB,sBAAsB,EACtB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACxC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,sBAAsB,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBACZ,YAAW,aAAa,CAAC,wBAAwB,EAAE,kBAAkB,CAAC;IAEtE,QAAQ,CAAC,UAAU,uBAAuB;IAC1C,QAAQ,CAAC,YAAY,uBAAuB;IAC5C,QAAQ,CAAC,QAAQ,EAAG,YAAY,CAAU;IAC1C,QAAQ,CAAC,OAAO,UAAU;IAC1B,QAAQ,CAAC,YAAY,QAAQ;IAE7B,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,MAAM,CAAyC;IAEvD;;;;;;;OAOG;IACG,UAAU,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCjE;;;;;;;;OAQG;IACG,cAAc,CACnB,MAAM,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GACxC,OAAO,CAAC,kBAAkB,CAAC;IAU9B;;;;OAIG;IACH,eAAe,IAAI,wBAAwB;IAc3C;;;;OAIG;IACH,OAAO,IAAI,OAAO;IAIlB;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAQf"}

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

@@ -0,0 +1,127 @@
+/**
+ * Desmos Calculator Tool Provider
+ *
+ * Provides Desmos calculators (basic, scientific, graphing)
+ * with authentication and proxy support.
+ *
+ * SECURITY BEST PRACTICE:
+ * - Development: Pass apiKey directly for local testing
+ * - Production: Use proxyEndpoint or authFetcher to keep API key server-side
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+import { DesmosCalculatorProvider } from "@pie-players/pie-calculator-desmos";
+/**
+ * Desmos Calculator Tool Provider
+ *
+ * Wraps DesmosCalculatorProvider with the IToolProvider interface
+ * for use in the ToolProviderRegistry.
+ *
+ * @example
+ * ```typescript
+ * const provider = new DesmosToolProvider();
+ *
+ * await provider.initialize({
+ *   apiKey: 'your-api-key', // Development only
+ *   proxyEndpoint: '/api/desmos/token', // Production
+ * });
+ *
+ * const calculatorProvider = await provider.createInstance();
+ * ```
+ */
+export class DesmosToolProvider {
+    providerId = "desmos-calculator";
+    providerName = "Desmos Calculator";
+    category = "calculator";
+    version = "1.10";
+    requiresAuth = true;
+    desmosProvider = null;
+    config = null;
+    /**
+     * Initialize Desmos calculator provider
+     *
+     * Loads the Desmos API library and authenticates with provided credentials.
+     *
+     * @param config Configuration with API key or proxy endpoint
+     * @throws Error if initialization fails
+     */
+    async initialize(config) {
+        if (this.desmosProvider) {
+            console.warn("[DesmosToolProvider] Already initialized, skipping reinitialization");
+            return;
+        }
+        this.config = config;
+        this.desmosProvider = new DesmosCalculatorProvider();
+        // Initialize with API key or proxy
+        try {
+            await this.desmosProvider.initialize({
+                apiKey: config.apiKey,
+                proxyEndpoint: config.proxyEndpoint,
+            });
+            console.log(`[DesmosToolProvider] Initialized successfully ${config.proxyEndpoint
+                ? "(using proxy)"
+                : config.apiKey
+                    ? "(direct API key)"
+                    : "(no auth)"}`);
+        }
+        catch (error) {
+            console.error("[DesmosToolProvider] Initialization failed:", error);
+            throw new Error("Failed to initialize Desmos calculator provider. Check API key or proxy endpoint.");
+        }
+    }
+    /**
+     * Create a calculator provider instance
+     *
+     * Returns the initialized Desmos calculator provider.
+     *
+     * @param config Optional instance-specific configuration (currently unused)
+     * @returns Desmos calculator provider
+     * @throws Error if provider not initialized
+     */
+    async createInstance(config) {
+        if (!this.desmosProvider) {
+            throw new Error("[DesmosToolProvider] Provider not initialized. Call initialize() first.");
+        }
+        return this.desmosProvider;
+    }
+    /**
+     * Get provider capabilities
+     *
+     * @returns Desmos calculator capabilities
+     */
+    getCapabilities() {
+        return {
+            supportsOffline: false, // Requires Desmos CDN
+            requiresAuth: true,
+            maxInstances: null, // Unlimited calculator instances
+            features: {
+                basic: true,
+                scientific: true,
+                graphing: true,
+                fourFunction: true,
+            },
+        };
+    }
+    /**
+     * Check if provider is ready
+     *
+     * @returns true if provider is initialized
+     */
+    isReady() {
+        return this.desmosProvider !== null;
+    }
+    /**
+     * Clean up provider resources
+     *
+     * Destroys the Desmos calculator provider and releases resources.
+     */
+    destroy() {
+        if (this.desmosProvider) {
+            this.desmosProvider.destroy();
+            this.desmosProvider = null;
+        }
+        this.config = null;
+        console.log("[DesmosToolProvider] Destroyed");
+    }
+}
+//# sourceMappingURL=DesmosToolProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DesmosToolProvider.js","sourceRoot":"","sources":["../../../src/services/tool-providers/DesmosToolProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AA8B9E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,kBAAkB;IAGrB,UAAU,GAAG,mBAAmB,CAAC;IACjC,YAAY,GAAG,mBAAmB,CAAC;IACnC,QAAQ,GAAG,YAAqB,CAAC;IACjC,OAAO,GAAG,MAAM,CAAC;IACjB,YAAY,GAAG,IAAI,CAAC;IAErB,cAAc,GAAoC,IAAI,CAAC;IACvD,MAAM,GAAoC,IAAI,CAAC;IAEvD;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,CAAC,MAAgC;QAChD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CACX,qEAAqE,CACrE,CAAC;YACF,OAAO;QACR,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,cAAc,GAAG,IAAI,wBAAwB,EAAE,CAAC;QAErD,mCAAmC;QACnC,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC;gBACpC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,aAAa,EAAE,MAAM,CAAC,aAAa;aACnC,CAAC,CAAC;YAEH,OAAO,CAAC,GAAG,CACV,iDACC,MAAM,CAAC,aAAa;gBACnB,CAAC,CAAC,eAAe;gBACjB,CAAC,CAAC,MAAM,CAAC,MAAM;oBACd,CAAC,CAAC,kBAAkB;oBACpB,CAAC,CAAC,WACL,EAAE,CACF,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;YACpE,MAAM,IAAI,KAAK,CACd,mFAAmF,CACnF,CAAC;QACH,CAAC;IACF,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,cAAc,CACnB,MAA0C;QAE1C,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACd,yEAAyE,CACzE,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,cAAc,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,eAAe;QACd,OAAO;YACN,eAAe,EAAE,KAAK,EAAE,sBAAsB;YAC9C,YAAY,EAAE,IAAI;YAClB,YAAY,EAAE,IAAI,EAAE,iCAAiC;YACrD,QAAQ,EAAE;gBACT,KAAK,EAAE,IAAI;gBACX,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,IAAI;aAClB;SACD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,OAAO;QACN,OAAO,IAAI,CAAC,cAAc,KAAK,IAAI,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,OAAO;QACN,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAC/C,CAAC;CACD"}