@liforma/client 0.2.1 → 0.3.0

package/dist/svelte/Experience.svelte

@@ -12,8 +12,6 @@
 		type ExperienceSession,
 		type ListenOnceOptions,
 		type SessionManifest,
-		type SpeakOptions,
-		type SpeechResult,
 		type StartSessionOptions,
 		type UtteranceResult
 	} from '@liforma/client';
@@ -408,9 +406,24 @@
 		return requireGeneration().started.promise;
 	}
 
-	export function speak(options: SpeakOptions): Promise<SpeechResult> {
-		return withSession((session) => session.speak(options));
-	}
+	/** Public speech API (`speak` / `play` / `createUtterance` / `interrupt`). */
+	export const speech = {
+		speak: (options: Parameters<ExperienceSession['speech']['speak']>[0]) =>
+			withSession((session) => session.speech.speak(options)),
+		play: (options: Parameters<ExperienceSession['speech']['play']>[0]) =>
+			withSession((session) => session.speech.play(options)),
+		createUtterance: (options: Parameters<ExperienceSession['speech']['createUtterance']>[0]) => {
+			const session = activeGeneration?.instance;
+			if (!session) {
+				throw new Error(
+					'Session has not started. Wait for the player start button and the started event before using speech APIs.'
+				);
+			}
+			return session.speech.createUtterance(options);
+		},
+		interrupt: (options?: Parameters<ExperienceSession['speech']['interrupt']>[0]) =>
+			withSession((session) => session.speech.interrupt(options))
+	};
 
 	export function startListening(): Promise<void> {
 		return withSession((session) => session.startListening());

package/dist/svelte/Experience.svelte.d.ts

@@ -1,9 +1,14 @@
-import { type ExperienceEvents, type ExperienceSession, type ListenOnceOptions, type SessionManifest, type SpeakOptions, type SpeechResult, type UtteranceResult } from '@liforma/client';
+import { type ExperienceEvents, type ExperienceSession, type ListenOnceOptions, type SessionManifest, type UtteranceResult } from '@liforma/client';
 import type { ExperienceProps } from './types';
 declare const Experience: import("svelte").Component<ExperienceProps, {
     ready: () => Promise<ExperienceEvents["ready"]>;
     started: () => Promise<ExperienceEvents["started"]>;
-    speak: (options: SpeakOptions) => Promise<SpeechResult>;
+    /** Public speech API (`speak` / `play` / `createUtterance` / `interrupt`). */ speech: {
+        speak: (options: Parameters<ExperienceSession["speech"]["speak"]>[0]) => Promise<import("@liforma/client").SpeechResult>;
+        play: (options: Parameters<ExperienceSession["speech"]["play"]>[0]) => Promise<import("@liforma/client").SpeechResult>;
+        createUtterance: (options: Parameters<ExperienceSession["speech"]["createUtterance"]>[0]) => import("@liforma/client").SpeechUtterance;
+        interrupt: (options?: Parameters<ExperienceSession["speech"]["interrupt"]>[0]) => Promise<readonly import("@liforma/client").SpeechResult[]>;
+    };
     startListening: () => Promise<void>;
     stopListening: () => Promise<UtteranceResult>;
     listenOnce: (options?: ListenOnceOptions) => Promise<UtteranceResult>;

package/dist/svelte/ExperienceThumbnail.svelte

@@ -94,13 +94,10 @@
 				: layers.avatarImage
 			: ''
 	);
-	const sceneLayersReady = $derived(
-		Boolean(layers) &&
-			(!layers?.backgroundImage || backgroundReady) &&
-			avatarReady &&
-			(!layers?.foregroundImage || foregroundReady)
+	/** Fade placeholder as soon as any layer can paint — don't wait for the slowest plate. */
+	const revealThumb = $derived(
+		shouldLoad && (avatarReady || backgroundReady || foregroundReady)
 	);
-	const revealThumb = $derived(shouldLoad && sceneLayersReady);
 
 	$effect(() => {
 		if (lazy === false) shouldLoad = true;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@liforma/client",
-	"version": "0.2.1",
+	"version": "0.3.0",
 	"type": "module",
 	"description": "Liforma browser SDK — Experience sessions, speech API, and Svelte embed component.",
 	"license": "MIT",
@@ -115,7 +115,9 @@
 		"fetch:face-landmarker": "node scripts/fetch-face-landmarker.mjs",
 		"fetch:anime-face-detector": "node scripts/fetch-anime-face-detector.mjs",
 		"fetch:face-parsing": "node scripts/fetch-face-parsing.mjs",
-		"fetch:models": "npm run fetch:depth-anything-v2 && npm run fetch:video-depth-anything && npm run fetch:depth-pro && npm run fetch:face-landmarker && npm run fetch:anime-face-detector && npm run fetch:face-parsing",
+		"fetch:wav2vec-phoneme-ctc": "node scripts/fetch-wav2vec-phoneme-ctc.mjs",
+		"fetch:supertonic-3": "node scripts/fetch-supertonic-3.mjs",
+		"fetch:models": "npm run fetch:depth-anything-v2 && npm run fetch:video-depth-anything && npm run fetch:depth-pro && npm run fetch:face-landmarker && npm run fetch:anime-face-detector && npm run fetch:face-parsing && npm run fetch:wav2vec-phoneme-ctc && npm run fetch:supertonic-3",
 		"locations": "npm run catalogue:locations && npm run build:locations",
 		"configure:cors": "node scripts/configure-r2-cors.mjs",
 		"verify:cors": "node scripts/verify-cdn-cors.mjs",