@liforma/client 0.2.1 → 0.4.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.4.0",
 	"type": "module",
 	"description": "Liforma browser SDK — Experience sessions, speech API, and Svelte embed component.",
 	"license": "MIT",
@@ -32,6 +32,30 @@
 		"./next": {
 			"types": "./dist/next/next/index.d.ts",
 			"import": "./dist/next/index.js"
+		},
+		"./byo": {
+			"types": "./dist/byo/index.d.ts",
+			"import": "./dist/byo/index.js"
+		},
+		"./elevenlabs": {
+			"types": "./dist/elevenlabs/index.d.ts",
+			"import": "./dist/elevenlabs/index.js"
+		},
+		"./openai": {
+			"types": "./dist/openai/index.d.ts",
+			"import": "./dist/openai/index.js"
+		},
+		"./deepgram": {
+			"types": "./dist/deepgram/index.d.ts",
+			"import": "./dist/deepgram/index.js"
+		},
+		"./google": {
+			"types": "./dist/google/index.d.ts",
+			"import": "./dist/google/index.js"
+		},
+		"./livekit": {
+			"types": "./dist/livekit/index.d.ts",
+			"import": "./dist/livekit/index.js"
 		}
 	},
 	"files": [
@@ -39,15 +63,23 @@
 		"dist/svelte",
 		"dist/react",
 		"dist/next",
+		"dist/byo",
+		"dist/elevenlabs",
+		"dist/openai",
+		"dist/deepgram",
+		"dist/google",
+		"dist/livekit",
 		"dist/sdk",
 		"README.md",
 		"CHANGELOG.md",
 		"LICENSE"
 	],
 	"peerDependencies": {
-		"svelte": "^5.0.0",
+		"@elevenlabs/client": ">=1.0.0",
+		"livekit-client": ">=2.0.0",
 		"react": "^18.0.0 || ^19.0.0",
-		"react-dom": "^18.0.0 || ^19.0.0"
+		"react-dom": "^18.0.0 || ^19.0.0",
+		"svelte": "^5.0.0"
 	},
 	"peerDependenciesMeta": {
 		"svelte": {
@@ -58,12 +90,24 @@
 		},
 		"react-dom": {
 			"optional": true
+		},
+		"@elevenlabs/client": {
+			"optional": true
+		},
+		"livekit-client": {
+			"optional": true
 		}
 	},
 	"scripts": {
-		"build": "npm run build:v2 && npm run build:npm && npm run build:svelte && npm run build:react && npm run build:next && npm run copy:preview",
+		"build": "npm run build:v2 && npm run build:npm && npm run build:svelte && npm run build:react && npm run build:next && npm run build:byo && npm run build:elevenlabs && npm run build:openai && npm run build:deepgram && npm run build:google && npm run build:livekit && npm run copy:preview",
 		"build:react": "vite build --config vite.config.react.ts && tsc -p tsconfig.react.json",
 		"build:next": "vite build --config vite.config.next.ts && tsc -p tsconfig.next.json",
+		"build:byo": "vite build --config vite.config.byo.ts && tsc -p tsconfig.byo.json",
+		"build:elevenlabs": "vite build --config vite.config.elevenlabs.ts && tsc -p tsconfig.elevenlabs.json",
+		"build:openai": "vite build --config vite.config.openai.ts && tsc -p tsconfig.openai.json",
+		"build:deepgram": "vite build --config vite.config.deepgram.ts && tsc -p tsconfig.deepgram.json",
+		"build:google": "vite build --config vite.config.google.ts && tsc -p tsconfig.google.json",
+		"build:livekit": "vite build --config vite.config.livekit.ts && tsc -p tsconfig.livekit.json",
 		"copy:preview": "mkdir -p dist/preview && cp preview/v2-embed-test.html dist/preview/ && cp preview/v2-embed-test-redirect.html dist/preview/",
 		"build:v2": "vite build --config vite.config.v2.ts",
 		"build:npm": "vite build --config vite.config.npm.ts && tsc -p tsconfig.npm.json",
@@ -115,7 +159,11 @@
 		"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:lf-sta": "node scripts/fetch-wav2vec-phoneme-ctc.mjs",
+		"fetch:supertonic-3": "node scripts/fetch-supertonic-3.mjs",
+		"fetch:lf-tts": "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:lf-sta && npm run fetch:lf-tts",
 		"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",
@@ -130,20 +178,22 @@
 	},
 	"devDependencies": {
 		"@aws-sdk/client-s3": "^3.1000.0",
+		"@elevenlabs/client": "^1.17.0",
 		"@sveltejs/package": "^2.5.8",
 		"@sveltejs/vite-plugin-svelte": "^7.0.0",
 		"@testing-library/react": "^16.3.0",
 		"@testing-library/svelte": "^5.4.2",
+		"@types/node": "^25.9.3",
 		"@types/react": "^19.1.12",
 		"@types/react-dom": "^19.1.9",
 		"@vitejs/plugin-react": "^5.0.2",
-		"@types/node": "^25.9.3",
 		"@webgpu/types": "^0.1.70",
 		"dotenv": "^17.2.3",
 		"jsdom": "^30.0.1",
-		"sharp": "^0.34.2",
+		"livekit-client": "^2.21.0",
 		"react": "^19.1.1",
 		"react-dom": "^19.1.1",
+		"sharp": "^0.34.2",
 		"svelte": "^5.55.2",
 		"svelte-check": "^4.7.4",
 		"typescript": "^6.0.3",