@pie-players/pie-assessment-toolkit 0.2.7 → 0.2.10

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

@@ -1,131 +0,0 @@
-/**
- * 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.js";
-/**
- * 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

@@ -1 +0,0 @@
-{"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,kBAAkB,CAAC;AAElD;;;;;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

@@ -1,10 +0,0 @@
-/**
- * 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

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

package/src/components/PNPProfileTester.example.svelte

@@ -1,188 +0,0 @@
-<script lang="ts">
-	/**
-	 * Example usage of PNPProfileTester component
-	 *
-	 * This demonstrates how to use the PNP Profile Tester for development and testing.
-	 * Shows integration with PNPToolResolver and PNPProvenanceViewer.
-	 */
-	import PNPProfileTester from './PNPProfileTester.svelte';
-	import PNPProvenanceViewer from './PNPProvenanceViewer.svelte';
-	import { PNPToolResolver } from '../services/PNPToolResolver';
-	import { createDefaultToolRegistry } from '../services/createDefaultToolRegistry';
-	import type { PersonalNeedsProfile } from '@pie-players/pie-players-shared/types';
-	import type { PNPResolutionProvenance } from '../services/pnp-provenance';
-
-	// Mock assessment for testing
-	const mockAssessment = {
-		id: 'test-assessment-1',
-		name: 'Example Assessment',
-		personalNeedsProfile: undefined as PersonalNeedsProfile | undefined,
-		settings: {
-			// Example district policy
-			districtPolicy: {
-				blockedTools: [], // No blocks in this example
-				requiredTools: [], // No requirements in this example
-			},
-		},
-	};
-
-	// Create resolver with default tool registry
-	const toolRegistry = createDefaultToolRegistry();
-	const resolver = new PNPToolResolver(toolRegistry, true);
-
-	// State
-	let currentProfile = $state<PersonalNeedsProfile | null>(null);
-	let resolutionResult = $state<{
-		toolIds: string[];
-		provenance: PNPResolutionProvenance;
-	} | null>(null);
-	let showProvenance = $state(true);
-
-	// Update resolution when profile changes
-	function handleProfileChange(profile: PersonalNeedsProfile | null) {
-		currentProfile = profile;
-
-		// Use the override method to test with this profile
-		const result = resolver.resolveWithOverride(mockAssessment as any, profile);
-
-		resolutionResult = {
-			toolIds: result.tools.filter((t) => t.enabled).map((t) => t.id),
-			provenance: result.provenance,
-		};
-	}
-</script>
-
-<div class="container mx-auto p-4 max-w-6xl">
-	<div class="prose mb-6">
-		<h1>PNP Profile Tester - Example</h1>
-		<p>
-			This component allows developers and testers to experiment with different PNP
-			(Personal Needs Profile) configurations in real-time.
-		</p>
-	</div>
-
-	<div class="grid grid-cols-1 lg:grid-cols-2 gap-4">
-		<!-- Left: Profile Tester -->
-		<div>
-			<PNPProfileTester onProfileChange={handleProfileChange} />
-		</div>
-
-		<!-- Right: Resolution Results -->
-		<div class="space-y-4">
-			<!-- Enabled Tools -->
-			<div class="card bg-base-100 shadow-sm">
-				<div class="card-body">
-					<h3 class="card-title text-sm">Resolved Tools</h3>
-					{#if resolutionResult && resolutionResult.toolIds.length > 0}
-						<div class="space-y-2">
-							{#each resolutionResult.toolIds as toolId}
-								<div class="badge badge-primary">{toolId}</div>
-							{/each}
-						</div>
-					{:else}
-						<p class="text-sm text-base-content/50">
-							No tools enabled. Select a profile or add features to see results.
-						</p>
-					{/if}
-				</div>
-			</div>
-
-			<!-- Profile JSON -->
-			<div class="card bg-base-100 shadow-sm">
-				<div class="card-body">
-					<h3 class="card-title text-sm">Current Profile JSON</h3>
-					<div class="mockup-code">
-						<pre><code>{JSON.stringify(currentProfile, null, 2)}</code></pre>
-					</div>
-				</div>
-			</div>
-
-			<!-- Provenance Toggle -->
-			<div class="form-control">
-				<label class="label cursor-pointer">
-					<span class="label-text">Show Provenance</span>
-					<input
-						type="checkbox"
-						class="toggle toggle-primary"
-						bind:checked={showProvenance}
-					/>
-				</label>
-			</div>
-		</div>
-	</div>
-
-	<!-- Full-width Provenance Viewer -->
-	{#if showProvenance && resolutionResult}
-		<div class="mt-6">
-			<PNPProvenanceViewer provenance={resolutionResult.provenance} />
-		</div>
-	{/if}
-
-	<!-- Usage Examples -->
-	<div class="prose mt-8">
-		<h2>Integration Examples</h2>
-
-		<h3>Basic Usage</h3>
-		<pre><code>{`<script>
-  import { PNPProfileTester } from '@pie-players/pie-assessment-toolkit/components';
-
-  let currentProfile;
-</script>
-
-<PNPProfileTester
-  onProfileChange={(profile) => {
-    currentProfile = profile;
-    // Apply to your assessment player
-  }}
-/>`}</code></pre>
-
-		<h3>With PNPToolResolver Override</h3>
-		<pre><code>{`<script>
-  import { PNPProfileTester } from '@pie-players/pie-assessment-toolkit/components';
-  import { PNPToolResolver, createDefaultToolRegistry } from '@pie-players/pie-assessment-toolkit';
-
-  const registry = createDefaultToolRegistry();
-  const resolver = new PNPToolResolver(registry);
-
-  function handleProfileChange(profile) {
-    // Test with override profile
-    const result = resolver.resolveWithOverride(assessment, profile);
-
-    // Use resolved tools
-    const toolIds = result.tools.filter(t => t.enabled).map(t => t.id);
-
-    // Show provenance
-    console.log(result.provenance);
-  }
-</script>
-
-<PNPProfileTester onProfileChange={handleProfileChange} />`}</code></pre>
-
-		<h3>Compact Mode in Sidebar</h3>
-		<pre><code>{`<PNPProfileTester compact={true} onProfileChange={handleProfileChange} />`}</code></pre>
-
-		<h3>Without Custom Features</h3>
-		<pre><code>{`<PNPProfileTester
-  allowCustomFeatures={false}
-  onProfileChange={handleProfileChange}
-/>`}</code></pre>
-	</div>
-</div>
-
-<style>
-	.prose {
-		max-width: 100%;
-	}
-
-	.prose code {
-		background-color: hsl(var(--b2));
-		padding: 0.125rem 0.375rem;
-		border-radius: 0.25rem;
-		font-size: 0.875em;
-	}
-
-	.prose pre code {
-		background-color: transparent;
-		padding: 0;
-	}
-</style>