@liforma/client 0.2.1

package/dist/react/v2/types/sessionManifestSchema.d.ts

@@ -0,0 +1,183 @@
+import { z } from 'zod';
+import type { SessionManifest } from './sessionManifest';
+export declare const sessionManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    sessionId: z.ZodString;
+    experienceId: z.ZodString;
+    expiresAt: z.ZodString;
+    sessionToken: z.ZodString;
+    experience: z.ZodObject<{
+        title: z.ZodString;
+        slug: z.ZodString;
+        mode: z.ZodEnum<{
+            conversation: "conversation";
+            presenter: "presenter";
+        }>;
+        responseMode: z.ZodEnum<{
+            managed: "managed";
+            custom: "custom";
+            manual: "manual";
+        }>;
+        speechInputMode: z.ZodEnum<{
+            manual: "manual";
+            auto: "auto";
+            off: "off";
+        }>;
+        startButton: z.ZodOptional<z.ZodObject<{
+            label: z.ZodOptional<z.ZodString>;
+            ariaLabel: z.ZodOptional<z.ZodString>;
+            placement: z.ZodOptional<z.ZodEnum<{
+                center: "center";
+                "bottom-center": "bottom-center";
+                "bottom-left": "bottom-left";
+                "bottom-right": "bottom-right";
+            }>>;
+            variant: z.ZodOptional<z.ZodEnum<{
+                primary: "primary";
+                secondary: "secondary";
+                minimal: "minimal";
+            }>>;
+            appearance: z.ZodOptional<z.ZodObject<{
+                backgroundColor: z.ZodOptional<z.ZodString>;
+                textColor: z.ZodOptional<z.ZodString>;
+                borderColor: z.ZodOptional<z.ZodString>;
+                borderRadiusPx: z.ZodOptional<z.ZodNumber>;
+                size: z.ZodOptional<z.ZodEnum<{
+                    small: "small";
+                    medium: "medium";
+                    large: "large";
+                }>>;
+                shadow: z.ZodOptional<z.ZodEnum<{
+                    strong: "strong";
+                    none: "none";
+                    soft: "soft";
+                }>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        openingMessage: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    transport: z.ZodObject<{
+        type: z.ZodLiteral<"http">;
+        config: z.ZodObject<{
+            apiBaseUrl: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    runtime: z.ZodObject<{
+        cdnBaseUrl: z.ZodString;
+        input: z.ZodLiteral<"browserStt">;
+        renderer: z.ZodLiteral<"morph2d">;
+    }, z.core.$strip>;
+    pipeline: z.ZodOptional<z.ZodObject<{
+        stt: z.ZodObject<{
+            placement: z.ZodEnum<{
+                browser: "browser";
+                cloud: "cloud";
+            }>;
+            provider: z.ZodString;
+            model: z.ZodOptional<z.ZodString>;
+            config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>;
+        llm: z.ZodObject<{
+            placement: z.ZodEnum<{
+                browser: "browser";
+                cloud: "cloud";
+            }>;
+            provider: z.ZodString;
+            model: z.ZodOptional<z.ZodString>;
+            config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>;
+        tts: z.ZodObject<{
+            placement: z.ZodEnum<{
+                browser: "browser";
+                cloud: "cloud";
+            }>;
+            provider: z.ZodString;
+            model: z.ZodOptional<z.ZodString>;
+            config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>;
+        animation: z.ZodObject<{
+            enabled: z.ZodBoolean;
+            placement: z.ZodOptional<z.ZodEnum<{
+                browser: "browser";
+                cloud: "cloud";
+            }>>;
+            source: z.ZodEnum<{
+                none: "none";
+                azureViseme: "azureViseme";
+                speechToAnimation: "speechToAnimation";
+            }>;
+            provider: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    capabilities: z.ZodArray<z.ZodString>;
+    characters: z.ZodArray<z.ZodObject<{
+        characterId: z.ZodString;
+        displayName: z.ZodString;
+        avatarId: z.ZodString;
+        voiceId: z.ZodString;
+        sttLang: z.ZodString;
+        agentId: z.ZodString;
+        appearance: z.ZodOptional<z.ZodObject<{
+            costume: z.ZodOptional<z.ZodString>;
+            costumeClothes: z.ZodOptional<z.ZodString>;
+            hair: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    activeCharacterId: z.ZodString;
+    location: z.ZodOptional<z.ZodObject<{
+        locationId: z.ZodString;
+        title: z.ZodString;
+        scene: z.ZodOptional<z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            layers: z.ZodArray<z.ZodString>;
+            assets: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strip>>;
+        placement: z.ZodOptional<z.ZodObject<{
+            cx: z.ZodNumber;
+            cy: z.ZodNumber;
+            scale: z.ZodNumber;
+            distanceM: z.ZodNumber;
+        }, z.core.$strip>>;
+        metersPerDepth: z.ZodOptional<z.ZodNumber>;
+        hasZoomVariant: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    world: z.ZodOptional<z.ZodObject<{
+        worldId: z.ZodString;
+        rulesetVersion: z.ZodNumber;
+    }, z.core.$strip>>;
+    state: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        values: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>;
+    tools: z.ZodArray<z.ZodUnknown>;
+    integration: z.ZodOptional<z.ZodObject<{
+        returnUrl: z.ZodOptional<z.ZodString>;
+        navigateOnClose: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    closeButton: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        visible: z.ZodOptional<z.ZodBoolean>;
+        style: z.ZodOptional<z.ZodEnum<{
+            text: "text";
+            icon: "icon";
+        }>>;
+        label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        position: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    billing: z.ZodOptional<z.ZodObject<{
+        payer: z.ZodLiteral<"creator">;
+        meterId: z.ZodString;
+    }, z.core.$strip>>;
+    language: z.ZodOptional<z.ZodEnum<{
+        en: "en";
+        es: "es";
+    }>>;
+    languagePackRevision: z.ZodOptional<z.ZodString>;
+    processorId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Apply API defaults for interaction modes omitted by older mint paths. */
+export declare function normalizeSessionManifestInput(data: unknown): unknown;
+export declare function parseSessionManifest(data: unknown): SessionManifest;
+export declare function manifestHasSessionCredential(manifest: SessionManifest): boolean;
+//# sourceMappingURL=sessionManifestSchema.d.ts.map

package/dist/react/v2/types/sessionManifestSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionManifestSchema.d.ts","sourceRoot":"","sources":["../../../../src/v2/types/sessionManifestSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AA0FzD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwEhC,CAAC;AAEH,4EAA4E;AAC5E,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAgBpE;AAWD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,CAMnE;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAE/E"}

package/dist/react/v2/types/sessionPipeline.d.ts

@@ -0,0 +1,23 @@
+export type PipelinePlacement = 'browser' | 'cloud';
+export type PipelineStageConfig = {
+    readonly placement: PipelinePlacement;
+    readonly provider: string;
+    readonly model?: string;
+    readonly config: Record<string, unknown>;
+};
+export type PipelineAnimationSource = 'azureViseme' | 'speechToAnimation' | 'none';
+export type PipelineAnimationStage = {
+    readonly enabled: boolean;
+    readonly placement?: PipelinePlacement;
+    readonly source: PipelineAnimationSource;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly config: Record<string, unknown>;
+};
+export type SessionPipeline = {
+    readonly stt: PipelineStageConfig;
+    readonly llm: PipelineStageConfig;
+    readonly tts: PipelineStageConfig;
+    readonly animation: PipelineAnimationStage;
+};
+//# sourceMappingURL=sessionPipeline.d.ts.map

package/dist/react/v2/types/sessionPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionPipeline.d.ts","sourceRoot":"","sources":["../../../../src/v2/types/sessionPipeline.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpD,MAAM,MAAM,mBAAmB,GAAG;IACjC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,aAAa,GAAG,mBAAmB,GAAG,MAAM,CAAC;AAEnF,MAAM,MAAM,sBAAsB,GAAG;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC7B,QAAQ,CAAC,GAAG,EAAE,mBAAmB,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,mBAAmB,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,mBAAmB,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;CAC3C,CAAC"}

package/dist/react/widget/dockGeometry.d.ts

@@ -0,0 +1,26 @@
+/** Desktop breakpoint for reduce / dock chrome (matches CSS). */
+export declare const WIDGET_DESKTOP_MEDIA = "(min-width: 768px)";
+/** Fraction of the device screen height (not the browser chrome box). */
+export declare const DOCK_HEIGHT_FRAC = 0.5;
+export declare const DOCK_HEIGHT_MAX = 1200;
+/** Portrait width / height. */
+export declare const DOCK_ASPECT: number;
+export type DockSize = {
+    readonly width: number;
+    readonly height: number;
+};
+export type DockPoint = {
+    readonly left: number;
+    readonly top: number;
+};
+/**
+ * Docked panel size: ~50% of device screen height (cap 1200), 9:16 portrait,
+ * then clamped to fit the browser viewport with margin.
+ */
+export declare function computeDockSize(viewportWidth?: number, viewportHeight?: number, margin?: number, screenHeight?: number): DockSize;
+/** Default bottom-right placement for a docked panel. */
+export declare function defaultDockOrigin(size: DockSize, viewportWidth?: number, viewportHeight?: number, margin?: number): DockPoint;
+/** Keep a docked panel fully inside the viewport. */
+export declare function clampDockOrigin(left: number, top: number, size: DockSize, viewportWidth?: number, viewportHeight?: number, margin?: number): DockPoint;
+export declare function isDesktopViewport(matchMediaFn?: (query: string) => MediaQueryList): boolean;
+//# sourceMappingURL=dockGeometry.d.ts.map

package/dist/react/widget/dockGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dockGeometry.d.ts","sourceRoot":"","sources":["../../../src/widget/dockGeometry.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAGzD,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,eAAe,OAAO,CAAC;AAGpC,+BAA+B;AAC/B,eAAO,MAAM,WAAW,QAAS,CAAC;AAElC,MAAM,MAAM,QAAQ,GAAG;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACrB,CAAC;AAQF;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,aAAa,SAA2D,EACxE,cAAc,SAA2D,EACzE,MAAM,SAAc,EACpB,YAAY,SAA2D,GACrE,QAAQ,CAoBV;AAED,yDAAyD;AACzD,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,QAAQ,EACd,aAAa,SAA2D,EACxE,cAAc,SAA2D,EACzE,MAAM,SAAc,GAClB,SAAS,CAKX;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAC9B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,QAAQ,EACd,aAAa,SAA2D,EACxE,cAAc,SAA2D,EACzE,MAAM,SAAc,GAClB,SAAS,CAOX;AAED,wBAAgB,iBAAiB,CAChC,YAAY,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,cAEa,GAC5C,OAAO,CAET"}

package/dist/react/widget/index.d.ts

@@ -0,0 +1,5 @@
+export type { ExperienceWidgetController, ExperienceWidgetOptions, ExperienceWidgetPosition, ExperienceWidgetPrefetch } from './types';
+export type { GalleryThumb } from '../thumbnail/types';
+export { EXPERIENCE_WIDGET_CSS, ensureExperienceWidgetStyles } from './styles';
+export { mountExperienceWidget } from './mountExperienceWidget';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/widget/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/widget/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/react/widget/mountExperienceWidget.d.ts

@@ -0,0 +1,13 @@
+import type { ExperienceWidgetController, ExperienceWidgetOptions } from './types';
+/** Normalize offset to a CSS length (default 16px). */
+export declare function resolveWidgetOffsetCss(offset?: number | string): string;
+/**
+ * Mount a light collapsed widget that expands an Experience overlay on click.
+ * Default `prefetch="onExpand"` is cold (second tap unlocks audio).
+ * `idle` / `eager` warm a transparent iframe so one in-iframe click unlocks + expands.
+ *
+ * When gallery thumb layers are not provided, fetches
+ * `GET /v1/experiences/{id}/preview` (no auth / allowlist).
+ */
+export declare function mountExperienceWidget(host: HTMLElement, options: ExperienceWidgetOptions): ExperienceWidgetController;
+//# sourceMappingURL=mountExperienceWidget.d.ts.map

package/dist/react/widget/mountExperienceWidget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mountExperienceWidget.d.ts","sourceRoot":"","sources":["../../../src/widget/mountExperienceWidget.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACX,0BAA0B,EAC1B,uBAAuB,EAGvB,MAAM,SAAS,CAAC;AAMjB,uDAAuD;AACvD,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAQvE;AA+JD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,uBAAuB,GAC9B,0BAA0B,CAq1B5B"}

package/dist/react/widget/styles.d.ts

@@ -0,0 +1,4 @@
+/** Styles for ExperienceWidget (class prefix `liforma-ew`). */
+export declare const EXPERIENCE_WIDGET_CSS = "\n.liforma-ew {\n\tbox-sizing: border-box;\n\tposition: relative;\n\tdisplay: block;\n\twidth: 100%;\n\theight: 100%;\n\tmin-height: 0;\n\tmargin: 0;\n\tpadding: 0;\n\tborder: 0;\n}\n\n/* Optional self-positioned FAB (position=bottom-right|bottom-left).\n * Cap at 50vmin so small phones don't get an oversized thumb (desktop 224px stays). */\n.liforma-ew[data-position='bottom-right'],\n.liforma-ew[data-position='bottom-left'] {\n\tposition: fixed;\n\twidth: min(var(--liforma-ew-fab-size, 224px), 50vmin);\n\theight: min(var(--liforma-ew-fab-size, 224px), 50vmin);\n\tbottom: var(--liforma-ew-offset, 16px);\n\tz-index: 2147482900;\n}\n\n.liforma-ew[data-position='bottom-right'] {\n\tright: var(--liforma-ew-offset, 16px);\n\tleft: auto;\n}\n\n.liforma-ew[data-position='bottom-left'] {\n\tleft: var(--liforma-ew-offset, 16px);\n\tright: auto;\n}\n\n/* While open, collapse the FAB box so a corner hole / thumb never remains. */\n.liforma-ew[data-position='bottom-right'][data-state='expanded'],\n.liforma-ew[data-position='bottom-right'][data-state='docked'],\n.liforma-ew[data-position='bottom-left'][data-state='expanded'],\n.liforma-ew[data-position='bottom-left'][data-state='docked'] {\n\twidth: 0;\n\theight: 0;\n\tmin-width: 0;\n\tmin-height: 0;\n\toverflow: visible;\n\tpointer-events: none;\n}\n\n.liforma-ew[data-state='expanded'] .liforma-ew__warm,\n.liforma-ew[data-state='docked'] .liforma-ew__warm,\n.liforma-ew[data-state='expanded'] .liforma-ew__overlay,\n.liforma-ew[data-state='expanded'] .liforma-ew__toolbar,\n.liforma-ew[data-state='docked'] .liforma-ew__toolbar {\n\tpointer-events: auto;\n}\n\n.liforma-ew[data-state='docked'] .liforma-ew__overlay {\n\tpointer-events: none;\n}\n\n.liforma-ew[data-state='docked'] .liforma-ew__panel {\n\tpointer-events: auto;\n}\n\n.liforma-ew__hit {\n\tbox-sizing: border-box;\n\tdisplay: block;\n\twidth: 100%;\n\theight: 100%;\n\tmargin: 0;\n\tpadding: 0;\n\tborder: 0;\n\tbackground: transparent;\n\tcursor: pointer;\n\tfont: inherit;\n\tappearance: none;\n\t-webkit-tap-highlight-color: transparent;\n\ttransform: scale(1);\n\ttransform-origin: center center;\n\ttransition:\n\t\ttransform 180ms ease,\n\t\tfilter 180ms ease;\n\twill-change: transform;\n}\n\n/* Author display must not defeat the HTML hidden attribute. */\n.liforma-ew__hit[hidden] {\n\tdisplay: none !important;\n}\n\n.liforma-ew__hit:focus-visible {\n\toutline: 2px solid #5b8def;\n\toutline-offset: 3px;\n\tborder-radius: 0.75rem;\n}\n\n@media (hover: hover) and (pointer: fine) {\n\t/* Scale the thumb whenever the collapsed FAB is hovered \u2014 including via the warm iframe hit layer. */\n\t.liforma-ew[data-state='collapsed'] .liforma-ew__hit:not(:disabled):hover,\n\t.liforma-ew[data-state='collapsed']:has(.liforma-ew__warm:hover) .liforma-ew__hit {\n\t\ttransform: scale(1.06);\n\t}\n\n\t.liforma-ew[data-state='collapsed'] .liforma-ew__hit:not(:disabled):hover .liforma-et,\n\t.liforma-ew[data-state='collapsed']:has(.liforma-ew__warm:hover) .liforma-et {\n\t\tbox-shadow: 0 12px 36px rgba(0, 0, 0, 0.34);\n\t}\n}\n\n.liforma-ew__face {\n\twidth: 100%;\n\theight: 100%;\n\tmin-height: 0;\n\tposition: relative;\n}\n\n.liforma-ew__face-status {\n\tposition: absolute;\n\tinset: 0;\n\tz-index: 1;\n\tdisplay: grid;\n\tplace-items: center;\n\tpadding: 0.5rem;\n\ttext-align: center;\n\tfont: 600 0.75rem/1.3 system-ui, sans-serif;\n\tcolor: #e8ecf4;\n\tbackground: rgba(10, 12, 18, 0.72);\n\tborder-radius: 0.75rem;\n\tpointer-events: none;\n}\n\n.liforma-ew__face-status[hidden] {\n\tdisplay: none !important;\n}\n\n.liforma-ew__hit:disabled {\n\tcursor: default;\n\topacity: 0.85;\n}\n\n.liforma-ew__face .liforma-et {\n\tborder-radius: 0.75rem;\n\tbox-shadow: 0 8px 28px rgba(0, 0, 0, 0.28);\n\ttransition: box-shadow 180ms ease;\n}\n\n.liforma-ew__warm {\n\tbox-sizing: border-box;\n\tposition: absolute;\n\tinset: 0;\n\tz-index: 2;\n\tborder-radius: 0.75rem;\n\toverflow: hidden;\n\tbackground: transparent;\n\tpointer-events: none;\n\topacity: 1;\n\ttransition: opacity 1000ms ease;\n}\n\n/*\n * Collapsed: keep the warm iframe as an invisible hit target only.\n * Painting it over the thumb causes a \u201Cghost enlarge\u201D (face scales under a static iframe).\n */\n.liforma-ew[data-state='collapsed'] .liforma-ew__warm {\n\topacity: 0;\n\ttransition: none;\n}\n\n.liforma-ew[data-warm='true'] .liforma-ew__warm {\n\tpointer-events: auto;\n}\n\n.liforma-ew[data-warm='true']:not([data-live='true']) .liforma-ew__hit {\n\tpointer-events: none;\n}\n\n.liforma-ew[data-live='true'][data-state='collapsed'] .liforma-ew__hit {\n\tpointer-events: auto;\n}\n\n.liforma-ew[data-live='true'] .liforma-ew__warm,\n.liforma-ew[data-live='true'] .liforma-ew__stage {\n\t/* Hidden under the thumb / until post-resize fade-in (matches cold avatar reveal). */\n\topacity: 0;\n}\n\n.liforma-ew[data-live='true'].liforma-ew--session-revealed[data-state='expanded'] .liforma-ew__warm,\n.liforma-ew[data-live='true'].liforma-ew--session-revealed[data-state='expanded'] .liforma-ew__stage,\n.liforma-ew[data-live='true'].liforma-ew--session-revealed[data-state='docked'] .liforma-ew__warm,\n.liforma-ew[data-live='true'].liforma-ew--session-revealed[data-state='docked'] .liforma-ew__stage {\n\topacity: 1;\n}\n\n.liforma-ew--session-concealing .liforma-ew__warm,\n.liforma-ew--session-concealing .liforma-ew__stage {\n\ttransition-duration: 280ms;\n}\n\n/* Instant hide while dock/maximize geometry settles (player morph resize ~160ms). */\n.liforma-ew--layout-settling .liforma-ew__warm,\n.liforma-ew--layout-settling .liforma-ew__stage {\n\topacity: 0 !important;\n\ttransition: none !important;\n}\n\n.liforma-ew[data-live='true'][data-state='collapsed'] .liforma-ew__warm {\n\t/* Keep the live iframe under the thumb; FAB click resumes the shell. */\n\tpointer-events: none;\n\topacity: 0;\n\t/* Instant hide when collapsed so the FAB never shows a resized live mesh. */\n\ttransition: none;\n}\n\n.liforma-ew[data-state='expanded'] .liforma-ew__warm {\n\tposition: fixed;\n\t/* Match overlay panel inset so the warm iframe fills the conversation shell. */\n\tinset: clamp(12px, 3vw, 28px);\n\tz-index: 2147483001;\n\twidth: auto;\n\theight: auto;\n\tborder-radius: 16px;\n\tpointer-events: auto;\n}\n\n.liforma-ew[data-state='docked'] .liforma-ew__warm {\n\tposition: fixed;\n\tinset: auto;\n\tz-index: 2147483001;\n\tborder-radius: 16px;\n\tpointer-events: auto;\n\t/* left/top/width/height set inline from dock geometry */\n}\n\n.liforma-ew__toolbar {\n\tdisplay: none;\n\tposition: fixed;\n\tz-index: 2147483002;\n\tpointer-events: auto;\n\tbox-sizing: border-box;\n\talign-items: center;\n\tgap: 0.35rem;\n\tpadding: 0.35rem 0.4rem;\n\tborder-radius: 999px;\n\tbackground: rgba(12, 14, 20, 0.72);\n\tbackdrop-filter: blur(8px);\n\t-webkit-backdrop-filter: blur(8px);\n\tbox-shadow: 0 8px 24px rgba(0, 0, 0, 0.28);\n}\n\n.liforma-ew[data-state='expanded'] .liforma-ew__toolbar {\n\tdisplay: flex;\n\ttop: calc(clamp(12px, 3vw, 28px) + 10px);\n\tright: calc(clamp(12px, 3vw, 28px) + 10px);\n\tleft: auto;\n\tcursor: default;\n}\n\n.liforma-ew[data-state='docked'] .liforma-ew__toolbar {\n\tdisplay: flex;\n\t/* left/top set inline to track the panel; strip is the drag handle */\n\tcursor: grab;\n\ttouch-action: none;\n\tuser-select: none;\n}\n\n.liforma-ew[data-state='docked'] .liforma-ew__toolbar.liforma-ew__toolbar--dragging {\n\tcursor: grabbing;\n}\n\n.liforma-ew__toolbar[hidden] {\n\tdisplay: none !important;\n}\n\n.liforma-ew__icon-btn {\n\tappearance: none;\n\tbox-sizing: border-box;\n\tdisplay: inline-grid;\n\tplace-items: center;\n\twidth: 2rem;\n\theight: 2rem;\n\tmargin: 0;\n\tpadding: 0;\n\tborder: 0;\n\tborder-radius: 999px;\n\tcolor: #f5f7fb;\n\tbackground: transparent;\n\tcursor: pointer;\n}\n\n.liforma-ew__icon-btn:hover {\n\tbackground: rgba(255, 255, 255, 0.12);\n}\n\n.liforma-ew__icon-btn[aria-pressed='true'] {\n\tbackground: rgba(255, 255, 255, 0.2);\n}\n\n.liforma-ew__icon-btn:focus-visible {\n\toutline: 2px solid #5b8def;\n\toutline-offset: 2px;\n}\n\n.liforma-ew__icon-btn svg {\n\twidth: 1.05rem;\n\theight: 1.05rem;\n\tdisplay: block;\n}\n\n.liforma-ew__drag-grip {\n\tdisplay: none;\n\twidth: 0.85rem;\n\theight: 1.25rem;\n\tmargin: 0 0.15rem 0 0.25rem;\n\tbackground:\n\t\tradial-gradient(circle, currentColor 1.1px, transparent 1.2px) 0 0 / 0.35rem 0.35rem,\n\t\tradial-gradient(circle, currentColor 1.1px, transparent 1.2px) 0.35rem 0 / 0.35rem 0.35rem;\n\tbackground-repeat: repeat-y;\n\topacity: 0.55;\n\tcolor: #f5f7fb;\n\tpointer-events: none;\n}\n\n.liforma-ew[data-state='docked'] .liforma-ew__drag-grip {\n\tdisplay: block;\n}\n\n.liforma-ew__dock-toggle[hidden] {\n\tdisplay: none !important;\n}\n\n.liforma-ew__overlay {\n\tposition: fixed;\n\tinset: 0;\n\tz-index: 2147483000;\n\tdisplay: flex;\n\talign-items: center;\n\tjustify-content: center;\n\tpadding: clamp(12px, 3vw, 28px);\n\tbox-sizing: border-box;\n}\n\n.liforma-ew[data-state='docked'] .liforma-ew__overlay {\n\tpadding: 0;\n\talign-items: stretch;\n\tjustify-content: stretch;\n\tpointer-events: none;\n\tbackground: transparent;\n}\n\n.liforma-ew__overlay[hidden] {\n\tdisplay: none !important;\n}\n\n.liforma-ew__backdrop {\n\tposition: absolute;\n\tinset: 0;\n\tborder: 0;\n\tpadding: 0;\n\tmargin: 0;\n\tbackground: rgba(6, 8, 14, 0.62);\n\tcursor: pointer;\n}\n\n.liforma-ew[data-state='docked'] .liforma-ew__backdrop {\n\tdisplay: none !important;\n}\n\n.liforma-ew__panel {\n\tposition: relative;\n\tz-index: 1;\n\tdisplay: flex;\n\tflex-direction: column;\n\t/* Fill the overlay so player loading / start UI centers in the visible window. */\n\twidth: var(--liforma-ew-max-w, 100%);\n\theight: var(--liforma-ew-max-h, 100%);\n\tmax-width: 100%;\n\tmax-height: 100%;\n\tborder-radius: 16px;\n\toverflow: hidden;\n\tbackground: #030508;\n\tbox-shadow: 0 24px 80px rgba(0, 0, 0, 0.45);\n\t/* Warm iframe sits above as a sibling; keep panel as chrome shell. */\n\tpointer-events: none;\n}\n\n.liforma-ew[data-state='docked'] .liforma-ew__panel {\n\tposition: fixed;\n\tinset: auto;\n\tmax-width: none;\n\tmax-height: none;\n\tpointer-events: auto;\n\t/* left/top/width/height set inline from dock geometry */\n}\n\n.liforma-ew:not([data-warm='true']) .liforma-ew__panel {\n\tpointer-events: auto;\n}\n\n.liforma-ew__stage {\n\tposition: relative;\n\tflex: 1;\n\tmin-height: 0;\n\twidth: 100%;\n\theight: 100%;\n\tbackground: #030508;\n\topacity: 1;\n\ttransition: opacity 1000ms ease;\n}\n\n.liforma-ew__status {\n\tposition: absolute;\n\tinset: 0;\n\tz-index: 1;\n\tdisplay: grid;\n\tplace-items: center;\n\tpadding: 1.5rem;\n\ttext-align: center;\n\tcolor: #d7dde8;\n\tfont: 500 0.9375rem/1.45 system-ui, sans-serif;\n\tbackground: rgba(3, 5, 8, 0.92);\n\tpointer-events: none;\n}\n\n.liforma-ew__status[hidden] {\n\tdisplay: none !important;\n}\n\n/* Mobile expanded: ~90% viewport, no reduce control. */\n@media (max-width: 767px) {\n\t.liforma-ew[data-state='expanded'] .liforma-ew__overlay {\n\t\tpadding: 5vh 5vw;\n\t}\n\n\t.liforma-ew[data-state='expanded'] .liforma-ew__panel {\n\t\twidth: 90vw;\n\t\theight: 90vh;\n\t\tmax-width: 90vw;\n\t\tmax-height: 90vh;\n\t}\n\n\t.liforma-ew[data-state='expanded'] .liforma-ew__warm {\n\t\tinset: 5vh 5vw;\n\t}\n\n\t.liforma-ew[data-state='expanded'] .liforma-ew__toolbar {\n\t\ttop: calc(5vh + 10px);\n\t\tright: calc(5vw + 10px);\n\t}\n\n\t.liforma-ew__dock-toggle {\n\t\tdisplay: none !important;\n\t}\n}\n\n@media (prefers-reduced-motion: reduce) {\n\t.liforma-ew__hit {\n\t\ttransition: none;\n\t\twill-change: auto;\n\t}\n\n\t.liforma-ew[data-state='collapsed'] .liforma-ew__hit:not(:disabled):hover,\n\t.liforma-ew[data-state='collapsed']:has(.liforma-ew__warm:hover) .liforma-ew__hit {\n\t\ttransform: none;\n\t}\n\n\t.liforma-ew__face .liforma-et {\n\t\tbox-shadow: none;\n\t\ttransition: none;\n\t}\n\n\t.liforma-ew__warm,\n\t.liforma-ew__stage {\n\t\ttransition: none;\n\t}\n}\n";
+export declare function ensureExperienceWidgetStyles(css?: string): void;
+//# sourceMappingURL=styles.d.ts.map

package/dist/react/widget/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/widget/styles.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,eAAO,MAAM,qBAAqB,koXA0djC,CAAC;AAIF,wBAAgB,4BAA4B,CAAC,GAAG,GAAE,MAA8B,GAAG,IAAI,CAYtF"}

package/dist/react/widget/types.d.ts

@@ -0,0 +1,62 @@
+import type { GalleryThumb } from '../thumbnail/types';
+import type { ExperienceFit, ExperienceMode, SpeechInputMode, StartButtonOptions } from '../v2/types/sessionInteraction';
+export type ExperienceWidgetPrefetch = 'onExpand' | 'idle' | 'eager';
+/**
+ * Collapsed FAB placement.
+ * - `static` (default): fill the host; developer CSS owns corner layout.
+ * - `bottom-right` / `bottom-left`: fixed corner launch (WordPress / paste-snippet friendly).
+ */
+export type ExperienceWidgetPosition = 'static' | 'bottom-right' | 'bottom-left';
+export type ExperienceWidgetOptions = {
+    readonly experienceId: string;
+    readonly alt: string;
+    readonly galleryThumb?: GalleryThumb;
+    readonly avatarImage?: string;
+    readonly backgroundImage?: string;
+    readonly foregroundImage?: string;
+    readonly fallbackImage?: string;
+    readonly prefetch?: ExperienceWidgetPrefetch;
+    readonly parallax?: boolean;
+    /** Default `static`. Corner values pin a 224×224 FAB without host CSS. */
+    readonly position?: ExperienceWidgetPosition;
+    /**
+     * Inset from the chosen corner when `position` is not `static`.
+     * Number = pixels; string may be `16`, `16px`, or any CSS length. Default `16`.
+     */
+    readonly offset?: number | string;
+    /** Optional authenticated / same-origin mint endpoint (same as Experience). */
+    readonly sessionEndpoint?: string;
+    readonly language?: 'en' | 'es';
+    readonly mode?: ExperienceMode;
+    readonly speechInputMode?: SpeechInputMode;
+    readonly speechOnly?: boolean;
+    readonly fit?: ExperienceFit;
+    readonly embedBaseUrl?: string;
+    readonly expandedMaxWidth?: string;
+    readonly expandedMaxHeight?: string;
+    /** Convenience: sets startButton.label when startButton is omitted. */
+    readonly startButtonLabel?: string;
+    readonly startButton?: StartButtonOptions;
+    readonly onExpanded?: () => void;
+    readonly onCollapsed?: () => void;
+    readonly onStarted?: () => void;
+    readonly onClose?: () => void;
+    readonly onError?: (error: Error) => void;
+    /**
+     * Cold (`onExpand`): thumbs painted.
+     * Warm (`idle`/`eager`): transparent iframe hit is armed (`widgetReady`).
+     */
+    readonly onPrefetchReady?: () => void;
+};
+export type ExperienceWidgetController = {
+    readonly root: HTMLElement;
+    expand(): void;
+    collapse(): void;
+    /** Desktop: shrink the open shell to a draggable portrait dock. */
+    dock(): void;
+    /** Restore a docked shell to near-fullscreen expanded. */
+    maximize(): void;
+    prefetch(): void;
+    destroy(): void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/react/widget/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/widget/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EACX,aAAa,EACb,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,MAAM,gCAAgC,CAAC;AAExC,MAAM,MAAM,wBAAwB,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,cAAc,GAAG,aAAa,CAAC;AAEjF,MAAM,MAAM,uBAAuB,GAAG;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IAC7C;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,+EAA+E;IAC/E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,uEAAuE;IACvE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC1C;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACxC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,MAAM,IAAI,IAAI,CAAC;IACf,QAAQ,IAAI,IAAI,CAAC;IACjB,mEAAmE;IACnE,IAAI,IAAI,IAAI,CAAC;IACb,0DAA0D;IAC1D,QAAQ,IAAI,IAAI,CAAC;IACjB,QAAQ,IAAI,IAAI,CAAC;IACjB,OAAO,IAAI,IAAI,CAAC;CAChB,CAAC"}