@liforma/client 0.4.1 → 0.4.3

package/dist/svelte/Experience.svelte

@@ -55,15 +55,16 @@
 		learningLocale,
 		language,
 		mode,
-		responseMode,
 		speechInputMode,
 		startButton,
+		showFeedback,
 		closeButton,
 		conversationProcessor,
 		speechOnly = false,
 		fit,
 		avatarId,
 		locationId,
+		castSize,
 		embedBaseUrl,
 		debug = false,
 		returnUrl,
@@ -74,11 +75,13 @@
 		onUserSpeechEnded,
 		onCharacterSpeechStarted,
 		onCharacterSpeechEnded,
+		onCharacterFocusChanged,
 		onConversationUpdate,
 		onMessage,
 		onListeningState,
 		onActivityChange,
-		onModeChange,
+		onFeedback,
+		onFeedbackFailed,
 		onConversationProcessorError,
 		onPlayerStatusChange,
 		onStateUpdate,
@@ -103,12 +106,12 @@
 			locale ?? language,
 			secondaryLocale ?? learningLocale,
 			mode,
-			responseMode,
 			speechInputMode,
 			conversationProcessor ? identityKey(conversationProcessor) : 0,
 			speechOnly,
 			avatarId,
 			locationId,
+			castSize,
 			embedBaseUrl,
 			debug
 		])
@@ -266,13 +269,17 @@
 		subscribe(generation, session, 'characterSpeechEnded', (event) =>
 			onCharacterSpeechEnded?.(event)
 		);
+		subscribe(generation, session, 'characterFocusChanged', (event) =>
+			onCharacterFocusChanged?.(event)
+		);
 		subscribe(generation, session, 'conversationUpdate', (event) =>
 			onConversationUpdate?.(event)
 		);
 		subscribe(generation, session, 'message', (event) => onMessage?.(event));
 		subscribe(generation, session, 'listeningState', (event) => onListeningState?.(event));
 		subscribe(generation, session, 'activityChange', (event) => onActivityChange?.(event));
-		subscribe(generation, session, 'modeChange', (event) => onModeChange?.(event));
+		subscribe(generation, session, 'feedback', (event) => onFeedback?.(event));
+		subscribe(generation, session, 'feedbackFailed', (event) => onFeedbackFailed?.(event));
 		subscribe(generation, session, 'conversationProcessorError', (event) =>
 			onConversationProcessorError?.(event)
 		);
@@ -308,10 +315,10 @@
 				language,
 				locationId,
 				avatarId,
+				castSize,
 				embedBaseUrl,
 				debug,
 				mode,
-				responseMode,
 				speechInputMode,
 				speechOnly,
 				conversationProcessor
@@ -326,10 +333,10 @@
 				language,
 				locationId,
 				avatarId,
+				castSize,
 				embedBaseUrl,
 				debug,
 				mode,
-				responseMode,
 				speechInputMode,
 				speechOnly,
 				conversationProcessor
@@ -364,6 +371,7 @@
 				container,
 				fit: untrack(() => fit),
 				startButton: untrack(() => startButton),
+				showFeedback: untrack(() => showFeedback),
 				closeButton: untrack(() => closeButton),
 				returnUrl: untrack(() => returnUrl),
 				showClose: Boolean(onClose || returnUrl?.trim() || closeButton),
@@ -461,6 +469,14 @@
 		return activeGeneration?.instance?.getConversation() ?? [];
 	}
 
+	export function focusCharacter(characterId: string): Promise<void> {
+		return withSession((session) => session.focusCharacter(characterId));
+	}
+
+	export function setFit(nextFit: NonNullable<ExperienceProps['fit']>): Promise<void> {
+		return withSession((session) => session.setFit(nextFit));
+	}
+
 	export function end(): Promise<void> {
 		return withSession((session) => session.end());
 	}
@@ -508,6 +524,13 @@
 
 	$effect(restartSession);
 
+	$effect(() => {
+		const nextFit = fit ?? 'full';
+		const session = untrack(() => activeGeneration?.instance ?? null);
+		if (!session) return;
+		void session.setFit(nextFit);
+	});
+
 	$effect(() => {
 		const container = errorHost;
 		const presentation = loadError;

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

@@ -15,6 +15,8 @@ declare const Experience: import("svelte").Component<ExperienceProps, {
     getSession: () => Session | null;
     getManifest: () => SessionManifest | null;
     getConversation: () => ReturnType<ExperienceSession["getConversation"]>;
+    focusCharacter: (characterId: string) => Promise<void>;
+    setFit: (nextFit: NonNullable<ExperienceProps["fit"]>) => Promise<void>;
     end: () => Promise<void>;
 }, "">;
 type Experience = ReturnType<typeof Experience>;

package/dist/svelte/ExperienceThumbnail.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-	import { onMount } from 'svelte';
+	import { onMount, untrack } from 'svelte';
 	import type { Attachment } from 'svelte/attachments';
 
 	import {
@@ -12,6 +12,7 @@
 		resolveThumbnailHref,
 		resolveThumbnailInteraction,
 		resolveThumbnailLayers,
+		thumbnailFitClass,
 		type GalleryThumb
 	} from '@liforma/client';
 
@@ -29,6 +30,7 @@
 		returnUrl,
 		playerBaseUrl,
 		parallax = true,
+		fit = 'full',
 		lazy = true,
 		class: className = '',
 		fallbackImage
@@ -46,6 +48,7 @@
 		returnUrl?: string;
 		playerBaseUrl?: string;
 		parallax?: boolean;
+		fit?: 'full' | 'face' | 'medium';
 		lazy?: boolean;
 		class?: string;
 		fallbackImage?: string;
@@ -126,6 +129,10 @@
 		void layers?.backgroundImage;
 		void layers?.foregroundImage;
 		void resolvedAvatarImage;
+		const alreadyShown = untrack(
+			() => backgroundReady || avatarReady || foregroundReady
+		);
+		if (alreadyShown) return;
 		backgroundReady = false;
 		avatarReady = false;
 		foregroundReady = false;
@@ -257,6 +264,7 @@
 		[
 			'liforma-et',
 			hasScene ? 'liforma-et--scene' : '',
+			thumbnailFitClass(fit),
 			parallaxLayersActive ? 'liforma-et--parallax' : '',
 			scrollParallax ? 'liforma-et--scroll-parallax' : '',
 			shouldLoad && !revealThumb ? 'liforma-et--loading' : '',

package/dist/svelte/ExperienceThumbnail.svelte.d.ts

@@ -13,6 +13,7 @@ type $$ComponentProps = {
     returnUrl?: string;
     playerBaseUrl?: string;
     parallax?: boolean;
+    fit?: 'full' | 'face' | 'medium';
     lazy?: boolean;
     class?: string;
     fallbackImage?: string;

package/dist/svelte/ExperienceWidget.svelte

@@ -35,13 +35,16 @@
 		expandedMaxHeight,
 		startButtonLabel,
 		startButton,
+		showFeedback,
 		class: className = '',
 		onExpanded,
 		onCollapsed,
 		onStarted,
 		onClose,
 		onError,
-		onPrefetchReady
+		onPrefetchReady,
+		onFeedback,
+		onFeedbackFailed
 	}: {
 		experienceId: string;
 		alt: string;
@@ -65,6 +68,7 @@
 		expandedMaxHeight?: string;
 		startButtonLabel?: string;
 		startButton?: StartButtonOptions;
+		showFeedback?: boolean;
 		class?: string;
 		onExpanded?: () => void;
 		onCollapsed?: () => void;
@@ -72,6 +76,10 @@
 		onClose?: () => void;
 		onError?: (error: Error) => void;
 		onPrefetchReady?: () => void;
+		onFeedback?: (event: import('@liforma/client').ExperienceEvents['feedback']) => void;
+		onFeedbackFailed?: (
+			event: import('@liforma/client').ExperienceEvents['feedbackFailed']
+		) => void;
 	} = $props();
 
 	let hostEl: HTMLDivElement | undefined = $state();
@@ -107,6 +115,9 @@
 			expandedMaxHeight,
 			startButtonLabel,
 			startButton,
+			showFeedback,
+			onFeedback,
+			onFeedbackFailed,
 			onExpanded,
 			onCollapsed,
 			onStarted,

package/dist/svelte/ExperienceWidget.svelte.d.ts

@@ -22,6 +22,7 @@ type $$ComponentProps = {
     expandedMaxHeight?: string;
     startButtonLabel?: string;
     startButton?: StartButtonOptions;
+    showFeedback?: boolean;
     class?: string;
     onExpanded?: () => void;
     onCollapsed?: () => void;
@@ -29,6 +30,8 @@ type $$ComponentProps = {
     onClose?: () => void;
     onError?: (error: Error) => void;
     onPrefetchReady?: () => void;
+    onFeedback?: (event: import('@liforma/client').ExperienceEvents['feedback']) => void;
+    onFeedbackFailed?: (event: import('@liforma/client').ExperienceEvents['feedbackFailed']) => void;
 };
 declare const ExperienceWidget: import("svelte").Component<$$ComponentProps, {}, "">;
 type ExperienceWidget = ReturnType<typeof ExperienceWidget>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@liforma/client",
-	"version": "0.4.1",
+	"version": "0.4.3",
 	"type": "module",
 	"description": "Liforma browser SDK — Experience sessions, speech API, and Svelte embed component.",
 	"license": "MIT",
@@ -137,7 +137,11 @@
 		"test:parse-composite-filename": "node scripts/test-parse-composite-filename.mjs",
 		"test:avatar-composite-rendered-path": "node scripts/test-avatar-composite-rendered-path.mjs",
 		"test:avatar-compose-worker-cors": "node scripts/test-avatar-compose-worker-cors.mjs",
+		"test:experience-thumb-url": "node scripts/test-experience-thumb-url.mjs",
+		"test:compose-experience-thumb": "node scripts/test-compose-experience-thumb.mjs",
 		"test:location-depth-paths": "node scripts/test-location-depth-paths.mjs",
+		"test:location-binary-assets": "node scripts/test-location-binary-assets.mjs",
+		"test:location-da3-depth": "node scripts/test-location-da3-depth.mjs",
 		"test:location-interactions": "node scripts/test-location-interactions.mjs",
 		"test:render-plate-chroma-key": "node scripts/test-render-plate-chroma-key.mjs",
 		"test:sparse-plate": "node scripts/test-sparse-plate.mjs",
@@ -149,25 +153,34 @@
 		"catalogue:locations": "node scripts/catalogue-locations.mjs",
 		"generate:location-interactions": "node scripts/generate-location-interactions.mjs",
 		"generate:location-depth": "node scripts/generate-location-depth.mjs",
+		"generate:location-depth16-da3": "node scripts/generate-location-depth16-da3.mjs",
+		"generate:location-discontinuities": "node scripts/generate-location-discontinuities.mjs",
 		"build:locations": "node scripts/build-locations.mjs",
 		"publish:locations": "node scripts/publish-locations.mjs",
 		"verify:locations": "node scripts/verify-location-sources.mjs",
 		"publish:models": "node scripts/publish-models.mjs",
+		"publish:models:krea-int8": "node scripts/_upload-model-prefix.mjs text-to-image/lf-t2i-turbo-int8",
+		"publish:models:ltx-int8": "node scripts/_upload-model-prefix.mjs text-to-video/lf-t2v-distill-int8",
+		"publish:models:video-omni": "node scripts/_upload-model-prefix.mjs text-to-video/lf-video-omni-v1",
 		"fetch:depth-anything-v2": "node scripts/fetch-depth-anything-v2.mjs",
 		"fetch:video-depth-anything": "node scripts/fetch-video-depth-anything.mjs",
 		"fetch:depth-pro": "node scripts/fetch-depth-pro.mjs",
 		"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:vitmatte": "node scripts/fetch-vitmatte.mjs",
+		"fetch:liveportrait-mlx": "node scripts/fetch-liveportrait-mlx.mjs",
 		"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",
+		"fetch:lf-t2i-turbo": "python3 ../tools/krea-2-salad/scripts/fetch_cdn_snapshot.py",
+		"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:vitmatte && 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",
 		"deploy:worker:avatar-compose": "node scripts/deploy-avatar-compose-worker.mjs",
+		"deploy:worker:experience-thumb": "node scripts/deploy-experience-thumb-worker.mjs",
 		"deploy": "npm run build && npm run publish:sdk",
 		"verify": "npm run build && node scripts/check-sdk-size.mjs && node scripts/test-embed-protocol.mjs && node scripts/test-manifest-embed-url.mjs && node scripts/test-player-reachability.mjs && node scripts/test-session-endpoint.mjs && node scripts/verify-package.mjs",
 		"preview:test": "npm run build && npm run preview"
@@ -178,6 +191,7 @@
 	},
 	"devDependencies": {
 		"@aws-sdk/client-s3": "^3.1000.0",
+		"@aws-sdk/lib-storage": "^3.1110.0",
 		"@elevenlabs/client": "^1.17.0",
 		"@sveltejs/package": "^2.5.8",
 		"@sveltejs/vite-plugin-svelte": "^7.0.0",