@happyvertical/smrt-chat 0.55.9 → 0.55.11

package/dist/svelte/components/helper/HelperControlPanel.svelte

@@ -0,0 +1,401 @@
+<script lang="ts">
+import { Input, Select, Switch } from '@happyvertical/smrt-ui/forms';
+import { useI18n } from '@happyvertical/smrt-ui/i18n';
+import { Button } from '@happyvertical/smrt-ui/ui';
+import { tick } from 'svelte';
+import type {
+  HelperClient,
+  HelperOffering,
+  HelperPreferences,
+  HelperSnapshot,
+} from '../../../helper-preferences.js';
+import { M } from '../../i18n.messages.js';
+import type { HelperRendererHandle, HelperStyleRegistry } from './registry.js';
+
+export interface Props {
+  /** Authenticated browser transport; only server snapshots become applied state. */
+  client: HelperClient;
+  /** Trusted style implementations available to this host. */
+  registry: HelperStyleRegistry;
+  /** Optional host-owned current snapshot. Absent snapshots load on mount. */
+  snapshot?: HelperSnapshot;
+  /**
+   * Authenticated bridge for a selected offering's runtime payload. The
+   * payload is deliberately never persisted by this panel or preferences.
+   */
+  loadPayload?: (offering: HelperOffering) => Promise<unknown>;
+  /** Receives each successful server-returned snapshot. */
+  onchanged?: (snapshot: HelperSnapshot) => void;
+  /** Notifies the host after an authenticated custom setup creates an offering. */
+  oncustomsaved?: (offering: HelperOffering) => void;
+}
+const { t } = useI18n();
+const panelInstanceId = $props.id();
+let {
+  client,
+  registry,
+  snapshot = $bindable(),
+  loadPayload,
+  onchanged,
+  oncustomsaved,
+}: Props = $props();
+let loading = $state(!snapshot);
+let saving = $state(false);
+let message = $state<string | null>(null);
+let messageIsError = $state(false);
+let draft = $state<HelperPreferences | null>(
+  snapshot?.preferences
+    ? { ...snapshot.preferences }
+    : snapshot?.recoveryDraft
+      ? { ...snapshot.recoveryDraft }
+      : null,
+);
+// A server refresh after custom setup is reported through `onchanged`. Keep
+// the intentionally staged local choice until a materially different server
+// snapshot arrives, so a host echo cannot turn it into applied preferences.
+let pendingDraft: HelperPreferences | null = null;
+let pendingSnapshotFingerprint: string | null = null;
+let setupStyleId = $state<string | null>(null);
+let setupTarget = $state<HTMLElement>();
+let previewTarget = $state<HTMLElement>();
+let previewError = $state<string | null>(null);
+
+$effect(() => {
+  if (!snapshot) return;
+  // `recoveryDraft` is a server-issued candidate only. Keeping it separate
+  // from `preferences` prevents an unavailable helper from being rendered as
+  // applied while still allowing permitted replacement fields to be saved.
+  const staged =
+    pendingSnapshotFingerprint === snapshotFingerprint(snapshot)
+      ? pendingDraft
+      : null;
+  if (!staged) {
+    pendingDraft = null;
+    pendingSnapshotFingerprint = null;
+  }
+  draft =
+    staged ??
+    (snapshot.preferences
+      ? { ...snapshot.preferences }
+      : snapshot.recoveryDraft
+        ? { ...snapshot.recoveryDraft }
+        : null);
+});
+$effect(() => {
+  if (snapshot) {
+    loading = false;
+    return;
+  }
+  let active = true;
+  void client
+    .load()
+    .then((next) => {
+      if (!active) return;
+      snapshot = next;
+      draft = next.preferences
+        ? { ...next.preferences }
+        : next.recoveryDraft
+          ? { ...next.recoveryDraft }
+          : null;
+    })
+    .catch((error: unknown) => {
+      if (active)
+        message =
+          error instanceof Error
+            ? error.message
+            : t(M['chat.helper.load_failed']);
+    })
+    .finally(() => {
+      if (active) loading = false;
+    });
+  return () => {
+    active = false;
+  };
+});
+
+const editable = (field: keyof Omit<HelperPreferences, 'version'>) =>
+  !!snapshot?.permissions.editableFields.includes(field);
+const canSave = $derived(
+  !!draft && (snapshot?.permissions.editableFields.length ?? 0) > 0,
+);
+const savedPreferences = $derived(snapshot?.preferences ?? null);
+const dirty = $derived(
+  !!draft &&
+    (!savedPreferences ||
+      draft.offeringId !== savedPreferences.offeringId ||
+      draft.name !== savedPreferences.name ||
+      draft.voiceId !== savedPreferences.voiceId ||
+      draft.placement !== savedPreferences.placement ||
+      draft.heardSubtitles !== savedPreferences.heardSubtitles ||
+      draft.spokenSubtitles !== savedPreferences.spokenSubtitles),
+);
+const availableOfferings = $derived(
+  (snapshot?.offerings ?? []).filter((offering) =>
+    registry.get(offering.styleId),
+  ),
+);
+// A recovery draft may name an offering that no longer appears in the
+// gallery. In that case retain a single keyboard entry point on the first
+// editable offering instead of leaving every radio outside the tab order.
+const galleryTabStopIndex = $derived(
+  !editable('offeringId')
+    ? -1
+    : Math.max(
+        0,
+        availableOfferings.findIndex(
+          (offering) => offering.id === draft?.offeringId,
+        ),
+      ),
+);
+const availableSetups = $derived(
+  registry
+    .list()
+    .filter(
+      (style) =>
+        style.Setup && snapshot?.permissions.customStyleIds.includes(style.id),
+    ),
+);
+const previewOffering = $derived(
+  draft
+    ? (availableOfferings.find(
+        (offering) => offering.id === draft?.offeringId,
+      ) ?? null)
+    : (snapshot?.offering ?? null),
+);
+
+$effect(() => {
+  const offering = previewOffering;
+  const style = offering ? registry.get(offering.styleId) : undefined;
+  const target = previewTarget;
+  let disposed = false;
+  let handle: HelperRendererHandle | null = null;
+  previewError = null;
+  if (!offering || !style || !target) return;
+  void (async () => {
+    try {
+      const payload = loadPayload ? await loadPayload(offering) : null;
+      const mounted = await style.mount({ target, offering, payload });
+      if (disposed) mounted.destroy();
+      else handle = mounted;
+    } catch (error) {
+      if (!disposed)
+        previewError =
+          error instanceof Error
+            ? error.message
+            : t(M['chat.helper.preview_failed']);
+    }
+  })();
+  return () => {
+    disposed = true;
+    handle?.destroy();
+    handle = null;
+  };
+});
+
+function update<K extends keyof HelperPreferences>(
+  key: K,
+  value: HelperPreferences[K],
+) {
+  if (!draft) return;
+  draft = { ...draft, [key]: value };
+  if (!messageIsError) message = null;
+}
+function snapshotFingerprint(next: HelperSnapshot) {
+  return JSON.stringify({
+    preferences: next.preferences,
+    offering: next.offering,
+    offerings: next.offerings,
+    voices: next.voices,
+    permissions: next.permissions,
+    selection: next.selection,
+    source: next.source,
+    recovery: next.recovery,
+    recoveryDraft: next.recoveryDraft,
+  });
+}
+function focusOffering(offeringId: string) {
+  const index = availableOfferings.findIndex(
+    (offering) => offering.id === offeringId,
+  );
+  void tick().then(() =>
+    document.getElementById(`${panelInstanceId}-offering-${index}`)?.focus(),
+  );
+}
+function closeSetup() {
+  const styleId = setupStyleId;
+  setupStyleId = null;
+  if (styleId)
+    void tick().then(() =>
+      document.getElementById(`${panelInstanceId}-setup-${styleId}`)?.focus(),
+    );
+}
+function openSetup(styleId: string) {
+  setupStyleId = styleId;
+  void tick().then(() =>
+    setupTarget?.querySelector<HTMLElement>('button')?.focus(),
+  );
+}
+function moveGallerySelection(event: KeyboardEvent) {
+  if (!draft || !editable('offeringId')) return;
+  const offerings = availableOfferings;
+  if (!offerings.length) return;
+  const current = Math.max(
+    0,
+    offerings.findIndex((offering) => offering.id === draft?.offeringId),
+  );
+  let index: number | null = null;
+  if (event.key === 'ArrowRight' || event.key === 'ArrowDown')
+    index = (current + 1) % offerings.length;
+  if (event.key === 'ArrowLeft' || event.key === 'ArrowUp')
+    index = (current - 1 + offerings.length) % offerings.length;
+  if (event.key === 'Home') index = 0;
+  if (event.key === 'End') index = offerings.length - 1;
+  if (index === null) return;
+  event.preventDefault();
+  update('offeringId', offerings[index].id);
+  focusOffering(offerings[index].id);
+}
+async function save() {
+  if (!draft || saving) return;
+  saving = true;
+  message = null;
+  messageIsError = false;
+  try {
+    apply(await client.save(draft));
+    message = t(M['chat.helper.saved']);
+  } catch (error) {
+    message =
+      error instanceof Error ? error.message : t(M['chat.helper.save_failed']);
+    messageIsError = true;
+  } finally {
+    saving = false;
+  }
+}
+async function reset() {
+  if (saving || !snapshot?.permissions.canReset) return;
+  saving = true;
+  message = null;
+  messageIsError = false;
+  try {
+    apply(await client.reset());
+    message = t(M['chat.helper.reset']);
+  } catch (error) {
+    message =
+      error instanceof Error ? error.message : t(M['chat.helper.reset_failed']);
+    messageIsError = true;
+  } finally {
+    saving = false;
+  }
+}
+function apply(next: HelperSnapshot) {
+  pendingDraft = null;
+  pendingSnapshotFingerprint = null;
+  snapshot = next;
+  draft = next.preferences
+    ? { ...next.preferences }
+    : next.recoveryDraft
+      ? { ...next.recoveryDraft }
+      : null;
+  onchanged?.(next);
+}
+async function customSaved(offering: HelperOffering) {
+  oncustomsaved?.(offering);
+  try {
+    const priorDraft = draft;
+    const next = await client.load();
+    snapshot = next;
+    const baseline = next.preferences ?? next.recoveryDraft ?? null;
+    const savedOffering = next.offerings.find(
+      (candidate) =>
+        candidate.id === offering.id && !!registry.get(candidate.styleId),
+    );
+    if (
+      baseline &&
+      savedOffering &&
+      next.permissions.editableFields.includes('offeringId')
+    ) {
+      const retained = { ...baseline };
+      for (const field of next.permissions.editableFields) {
+        if (priorDraft) retained[field] = priorDraft[field] as never;
+      }
+      pendingDraft = { ...retained, offeringId: savedOffering.id };
+      pendingSnapshotFingerprint = snapshotFingerprint(next);
+    } else {
+      pendingDraft = null;
+      pendingSnapshotFingerprint = null;
+    }
+    draft = pendingDraft ?? (baseline ? { ...baseline } : null);
+    onchanged?.(next);
+    setupStyleId = null;
+    message = t(M['chat.helper.photo_saved_apply']);
+    messageIsError = false;
+    if (savedOffering) focusOffering(savedOffering.id);
+  } catch (error) {
+    message =
+      error instanceof Error ? error.message : t(M['chat.helper.load_failed']);
+    messageIsError = true;
+  }
+}
+</script>
+
+<section class="helper-panel" aria-busy={loading || saving} aria-labelledby="helper-panel-title">
+  <h2 id="helper-panel-title">{t(M['chat.helper.title'])}</h2>
+  {#if message}<p class="message" role={messageIsError ? 'alert' : 'status'} aria-live={messageIsError ? 'assertive' : 'polite'}>{message}</p>{/if}
+  {#if snapshot?.recovery}<p class="message" role="status">{snapshot.recovery.message}</p>{/if}
+  {#if loading}<p>{t(M['chat.helper.loading'])}</p>
+  {:else if !snapshot}<p>{t(M['chat.helper.unavailable'])}</p>
+  {:else}
+    <fieldset disabled={saving}>
+      <legend>{t(M['chat.helper.gallery'])}</legend>
+      <div class="gallery" role="radiogroup" tabindex="-1" aria-label={t(M['chat.helper.gallery'])} onkeydown={moveGallerySelection}>
+        {#each availableOfferings as offering, index (offering.id)}
+          <Button id={`${panelInstanceId}-offering-${index}`} tabindex={galleryTabStopIndex === index ? 0 : -1} type="button" variant="secondary" class={draft?.offeringId === offering.id ? 'selected' : ''} role="radio" aria-checked={draft?.offeringId === offering.id}
+            disabled={!draft || !editable('offeringId')} onclick={() => update('offeringId', offering.id)}>{offering.label}</Button>
+        {/each}
+      </div>
+      {#if previewOffering}
+        <div class="preview" aria-label={t(M['chat.helper.preview'])} bind:this={previewTarget}></div>
+      {/if}
+      {#if previewError}<p class="message" role="status">{previewError}</p>{/if}
+      {#if availableSetups.length}
+        <div class="setup-actions">
+          {#each availableSetups as style (style.id)}
+            <Button id={`${panelInstanceId}-setup-${style.id}`} type="button" variant="secondary" disabled={!editable('offeringId')} onclick={() => openSetup(style.id)}>{t(M['chat.helper.add_style'], { style: style.label })}</Button>
+          {/each}
+        </div>
+      {/if}
+      {#if setupStyleId && registry.get(setupStyleId)?.Setup}
+        {@const Setup = registry.get(setupStyleId)?.Setup}
+        <section bind:this={setupTarget} class="custom-setup" aria-label={t(M['chat.helper.custom_setup'])}>
+          <Button type="button" variant="secondary" onclick={closeSetup}>{t(M['chat.helper.back_to_settings'])}</Button>
+          {#if Setup}<Setup onsaved={customSaved} oncancel={closeSetup} />{/if}
+        </section>
+      {/if}
+      {#if draft}
+        <label>{t(M['chat.helper.name'])}<Input value={draft.name} disabled={!editable('name')} oninput={(event) => update('name', event.currentTarget.value)} /></label>
+        <label>{t(M['chat.helper.voice'])}<Select value={draft.voiceId} disabled={!editable('voiceId')} onchange={(event) => update('voiceId', event.currentTarget.value)}>{#each snapshot.voices as voice (voice.id)}<option value={voice.id}>{voice.label}</option>{/each}</Select></label>
+        <label>{t(M['chat.helper.placement'])}<Select value={draft.placement} disabled={!editable('placement')} onchange={(event) => update('placement', event.currentTarget.value as HelperPreferences['placement'])}><option value="bottom-left">{t(M['chat.helper.bottom_left'])}</option><option value="bottom-right">{t(M['chat.helper.bottom_right'])}</option></Select></label>
+        <Switch label={t(M['chat.helper.heard_subtitles'])} checked={draft.heardSubtitles} disabled={!editable('heardSubtitles')} onchange={(event) => update('heardSubtitles', event.currentTarget.checked)} />
+        <Switch label={t(M['chat.helper.spoken_subtitles'])} checked={draft.spokenSubtitles} disabled={!editable('spokenSubtitles')} onchange={(event) => update('spokenSubtitles', event.currentTarget.checked)} />
+      {:else}
+        <p class="message">{t(M['chat.helper.unavailable'])}</p>
+      {/if}
+    </fieldset>
+    {#if dirty}<p class="message" role="status">{t(M['chat.helper.unsaved_changes'])}</p>{/if}
+    <div class="actions">{#if canSave}<Button type="button" onclick={save} disabled={saving || !dirty}>{saving ? t(M['chat.helper.saving']) : t(M['chat.helper.save_changes'])}</Button>{/if}{#if snapshot.permissions.canReset}<Button type="button" variant="secondary" onclick={reset} disabled={saving}>{t(M['chat.helper.reset_button'])}</Button>{/if}</div>
+  {/if}
+</section>
+
+<style>
+  .helper-panel { display: grid; gap: var(--smrt-spacing-4); max-width: 42rem; padding: var(--smrt-spacing-4); color: var(--smrt-color-on-surface); }
+  fieldset { display: grid; gap: var(--smrt-spacing-3); border: 0; margin: 0; padding: 0; }
+  label { display: grid; gap: var(--smrt-spacing-1); font: var(--smrt-typography-label-large-font); }
+  .gallery { display: grid; grid-template-columns: repeat(auto-fit, minmax(9rem, 1fr)); gap: var(--smrt-spacing-2); }
+  .gallery :global(.button) { min-height: 3rem; border-color: var(--smrt-color-outline); background: var(--smrt-color-surface); color: inherit; }
+  .gallery :global(.button.selected) { border-color: var(--smrt-color-primary); background: var(--smrt-color-primary-container); }
+  .preview { min-height: 5rem; display: grid; place-items: center; overflow: hidden; border: 1px solid var(--smrt-color-outline-variant); border-radius: var(--smrt-radius-small); background: var(--smrt-color-surface-container-low); }
+  .preview :global(svg), .preview :global(img) { max-width: 100%; max-height: 12rem; }
+  .setup-actions, .actions { display: flex; flex-wrap: wrap; gap: var(--smrt-spacing-2); }
+  .custom-setup { display: grid; gap: var(--smrt-spacing-3); padding: var(--smrt-spacing-3); border: 1px solid var(--smrt-color-outline-variant); border-radius: var(--smrt-radius-small); }
+  .message { margin: 0; color: var(--smrt-color-on-surface-variant); }
+</style>

package/dist/svelte/components/helper/HelperControlPanel.svelte.d.ts

@@ -0,0 +1,23 @@
+import type { HelperClient, HelperOffering, HelperSnapshot } from '../../../helper-preferences.js';
+import type { HelperStyleRegistry } from './registry.js';
+export interface Props {
+    /** Authenticated browser transport; only server snapshots become applied state. */
+    client: HelperClient;
+    /** Trusted style implementations available to this host. */
+    registry: HelperStyleRegistry;
+    /** Optional host-owned current snapshot. Absent snapshots load on mount. */
+    snapshot?: HelperSnapshot;
+    /**
+     * Authenticated bridge for a selected offering's runtime payload. The
+     * payload is deliberately never persisted by this panel or preferences.
+     */
+    loadPayload?: (offering: HelperOffering) => Promise<unknown>;
+    /** Receives each successful server-returned snapshot. */
+    onchanged?: (snapshot: HelperSnapshot) => void;
+    /** Notifies the host after an authenticated custom setup creates an offering. */
+    oncustomsaved?: (offering: HelperOffering) => void;
+}
+declare const HelperControlPanel: import("svelte").Component<Props, {}, "snapshot">;
+type HelperControlPanel = ReturnType<typeof HelperControlPanel>;
+export default HelperControlPanel;
+//# sourceMappingURL=HelperControlPanel.svelte.d.ts.map

package/dist/svelte/components/helper/HelperControlPanel.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelperControlPanel.svelte.d.ts","sourceRoot":"","sources":["../../../../src/svelte/components/helper/HelperControlPanel.svelte.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EAEd,cAAc,EACf,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAwB,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAG/E,MAAM,WAAW,KAAK;IACpB,mFAAmF;IACnF,MAAM,EAAE,YAAY,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,yDAAyD;IACzD,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAC/C,iFAAiF;IACjF,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;CACpD;AAkXD,QAAA,MAAM,kBAAkB,mDAAwC,CAAC;AACjE,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAChE,eAAe,kBAAkB,CAAC"}

package/dist/svelte/components/helper/registry.d.ts

@@ -0,0 +1,53 @@
+import { type PhotoCutoutRig } from '@happyvertical/animation';
+import type { Component } from 'svelte';
+import type { HelperOffering } from '../../../helper-preferences.js';
+export interface HelperRendererHandle {
+    destroy(): void;
+    setMouthOpen(value: number): void;
+    setSpeaking?(speaking: boolean): void;
+}
+export interface HelperStyleSetupProps {
+    onsaved: (offering: HelperOffering) => void;
+    oncancel: () => void;
+}
+export interface HelperStyleMountInput {
+    target: HTMLElement;
+    offering: HelperOffering;
+    /** Resolved by an authenticated host bridge; never persist a URL here. */
+    payload: unknown;
+}
+export interface HelperStyleDefinition {
+    id: string;
+    label: string;
+    Setup?: Component<HelperStyleSetupProps>;
+    mount(input: HelperStyleMountInput): HelperRendererHandle | Promise<HelperRendererHandle>;
+}
+export interface HelperStyleRegistry {
+    get(id: string): HelperStyleDefinition | undefined;
+    list(): readonly HelperStyleDefinition[];
+}
+export interface HappyRuntime {
+    gsap: unknown;
+    morphSVG?: object;
+}
+export interface HappyHelperStyleOptions {
+    gsap?: unknown;
+    morphSVG?: object;
+    /** Called only while mounting Happy, so GSAP remains a host-owned lazy chunk. */
+    loadRuntime?: () => Promise<HappyRuntime>;
+}
+export declare const HAPPY_HELPER_OFFERING: HelperOffering;
+export declare function createHelperStyleRegistry(styles: readonly HelperStyleDefinition[]): HelperStyleRegistry;
+/**
+ * The animation package owns Happy's SVG geometry.  This adapter never starts
+ * speech: host playback can signal `setSpeaking`, while voice remains host-owned.
+ */
+export declare function createHappyHelperStyle(options?: HappyHelperStyleOptions): HelperStyleDefinition;
+export interface PhotoCutoutPayload {
+    rig: PhotoCutoutRig;
+    image: Blob;
+}
+export declare function createPhotoCutoutHelperStyle(options?: {
+    Setup?: Component<HelperStyleSetupProps>;
+}): HelperStyleDefinition;
+//# sourceMappingURL=registry.d.ts.map

package/dist/svelte/components/helper/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/svelte/components/helper/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,OAAO,IAAI,IAAI,CAAC;IAChB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,WAAW,CAAC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAC5C,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,0EAA0E;IAC1E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC,qBAAqB,CAAC,CAAC;IACzC,KAAK,CACH,KAAK,EAAE,qBAAqB,GAC3B,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAAC;IACnD,IAAI,IAAI,SAAS,qBAAqB,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;CAC3C;AAED,eAAO,MAAM,qBAAqB,EAAE,cAKnC,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,qBAAqB,EAAE,GACvC,mBAAmB,CAUrB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,uBAA4B,GACpC,qBAAqB,CAgCvB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,IAAI,CAAC;CACb;AAYD,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,SAAS,CAAC,qBAAqB,CAAC,CAAA;CAAO,GACzD,qBAAqB,CAkCvB"}

package/dist/svelte/components/helper/registry.js

@@ -0,0 +1,100 @@
+import { createHappy, mountPhotoCutout, } from '@happyvertical/animation';
+export const HAPPY_HELPER_OFFERING = {
+    id: 'happy',
+    label: 'Happy',
+    styleId: 'happy',
+    source: 'ready-made',
+};
+export function createHelperStyleRegistry(styles) {
+    const byId = new Map();
+    for (const style of styles) {
+        if (!style.id.trim())
+            throw new Error('Helper style ids must not be blank.');
+        if (byId.has(style.id))
+            throw new Error(`Duplicate helper style id: ${style.id}`);
+        byId.set(style.id, style);
+    }
+    return { get: (id) => byId.get(id), list: () => [...byId.values()] };
+}
+/**
+ * The animation package owns Happy's SVG geometry.  This adapter never starts
+ * speech: host playback can signal `setSpeaking`, while voice remains host-owned.
+ */
+export function createHappyHelperStyle(options = {}) {
+    return {
+        id: 'happy',
+        label: 'Happy',
+        async mount({ target, payload }) {
+            if (payload !== null && payload !== undefined)
+                throw new Error('Happy does not accept an asset payload.');
+            const runtime = options.loadRuntime
+                ? await options.loadRuntime()
+                : { gsap: options.gsap, morphSVG: options.morphSVG };
+            if (!runtime.gsap)
+                throw new Error('Happy requires a trusted GSAP runtime.');
+            const happy = createHappy({
+                target,
+                gsap: runtime.gsap,
+                morphSVG: runtime.morphSVG,
+                breathe: !prefersReducedMotion(),
+            });
+            let speaking = false;
+            return {
+                destroy: () => happy.destroy(),
+                // Happy's public character API does not expose a raw mouth amount.
+                // Do not call `say()`: it owns browser speech and would autoplay audio.
+                setMouthOpen: (amount) => happy.setSpeaking(amount > 0.05),
+                setSpeaking: (next) => {
+                    if (speaking === next)
+                        return;
+                    speaking = next;
+                    happy.setSpeaking(next);
+                },
+            };
+        },
+    };
+}
+function isPhotoPayload(payload) {
+    return (!!payload &&
+        typeof payload === 'object' &&
+        'rig' in payload &&
+        'image' in payload &&
+        payload.image instanceof Blob);
+}
+export function createPhotoCutoutHelperStyle(options = {}) {
+    return {
+        id: 'photo-cutout',
+        label: 'Canadian split-head photo',
+        ...(options.Setup ? { Setup: options.Setup } : {}),
+        mount({ target, payload }) {
+            if (!isPhotoPayload(payload))
+                throw new Error('Photographic helper requires a validated rig and image.');
+            const handle = mountPhotoCutout(payload.rig, {
+                target,
+                resolveAsset: async () => new File([payload.image], 'helper-cutout.png', {
+                    type: payload.image.type || 'image/png',
+                }),
+            });
+            let mouthOpen = 0;
+            const setMouthOpen = (value) => {
+                mouthOpen = Math.max(0, Math.min(1, value));
+                handle.setMouthOpen(mouthOpen);
+            };
+            return {
+                destroy: () => handle.destroy(),
+                setMouthOpen,
+                // CharacterConversation supplies the raw playback envelope first, then
+                // this boolean state. Keep that amplitude; only an explicit stop closes
+                // the mouth so cleanup stays deterministic.
+                setSpeaking: (speaking) => {
+                    if (!speaking)
+                        setMouthOpen(0);
+                },
+            };
+        },
+    };
+}
+function prefersReducedMotion() {
+    return (typeof matchMedia === 'function' &&
+        matchMedia('(prefers-reduced-motion: reduce)').matches);
+}

package/dist/svelte/i18n.d.ts

@@ -1,4 +1,16 @@
 export declare const M: {
+    readonly 'chat.character_conversation.saved_conversation': "chat.character_conversation.saved_conversation";
+    readonly 'chat.character_conversation.saved_character': "chat.character_conversation.saved_character";
+    readonly 'chat.character_conversation.listening_notice': "chat.character_conversation.listening_notice";
+    readonly 'chat.character_conversation.voice_input': "chat.character_conversation.voice_input";
+    readonly 'chat.character_conversation.speak': "chat.character_conversation.speak";
+    readonly 'chat.character_conversation.unavailable': "chat.character_conversation.unavailable";
+    readonly 'chat.character_conversation.message': "chat.character_conversation.message";
+    readonly 'chat.character_conversation.send': "chat.character_conversation.send";
+    readonly 'chat.character_conversation.assistant_reply': "chat.character_conversation.assistant_reply";
+    readonly 'chat.character_conversation.speech_failed': "chat.character_conversation.speech_failed";
+    readonly 'chat.caption_overlay.scroll_up': "chat.caption_overlay.scroll_up";
+    readonly 'chat.caption_overlay.scroll_down': "chat.caption_overlay.scroll_down";
     readonly 'chat.agent_chat.conversation': "chat.agent_chat.conversation";
     readonly 'chat.agent_chat.inactive_notice': "chat.agent_chat.inactive_notice";
     readonly 'chat.agent_chat.input_placeholder': "chat.agent_chat.input_placeholder";
@@ -33,6 +45,8 @@ export declare const M: {
     readonly 'chat.assistant_thread_list.conversations_label': "chat.assistant_thread_list.conversations_label";
     readonly 'chat.assistant_thread_list.new_conversation': "chat.assistant_thread_list.new_conversation";
     readonly 'chat.assistant_thread_list.untitled': "chat.assistant_thread_list.untitled";
+    readonly 'chat.floating_assistant.collapse': "chat.floating_assistant.collapse";
+    readonly 'chat.floating_assistant.close': "chat.floating_assistant.close";
     readonly 'chat.assistant_dock.no_surfaces': "chat.assistant_dock.no_surfaces";
     readonly 'chat.assistant_dock.loading_conversations': "chat.assistant_dock.loading_conversations";
     readonly 'chat.assistant_dock.choose_conversation': "chat.assistant_dock.choose_conversation";

package/dist/svelte/i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/svelte/i18n.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2IZ,CAAC"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/svelte/i18n.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiKZ,CAAC"}

package/dist/svelte/i18n.js

@@ -11,6 +11,20 @@
  */
 import { defineMessages } from '@happyvertical/smrt-ui/i18n';
 export const M = defineMessages({
+    // Character conversation workbench
+    'chat.character_conversation.saved_conversation': 'Saved character conversation',
+    'chat.character_conversation.saved_character': 'Saved photographic character',
+    'chat.character_conversation.listening_notice': 'Listening mode keeps the conversation and confirmations active while hiding message history.',
+    'chat.character_conversation.voice_input': 'Voice input',
+    'chat.character_conversation.speak': 'Speak to your assistant',
+    'chat.character_conversation.unavailable': 'Speech input is unavailable. Type your message below.',
+    'chat.character_conversation.message': 'Type your message',
+    'chat.character_conversation.send': 'Send message',
+    'chat.character_conversation.assistant_reply': 'Assistant reply',
+    'chat.character_conversation.speech_failed': 'Could not play the spoken reply. The reply is shown below.',
+    // CaptionOverlay
+    'chat.caption_overlay.scroll_up': 'Scroll captions up',
+    'chat.caption_overlay.scroll_down': 'Scroll captions down',
     // AgentChat
     'chat.agent_chat.conversation': 'Agent conversation',
     'chat.agent_chat.inactive_notice': 'Session {status}. Cannot send messages.',
@@ -52,6 +66,9 @@ export const M = defineMessages({
     'chat.assistant_thread_list.conversations_label': 'Assistant conversations',
     'chat.assistant_thread_list.new_conversation': '+ New conversation',
     'chat.assistant_thread_list.untitled': 'Untitled',
+    // FloatingAssistant (#3642)
+    'chat.floating_assistant.collapse': 'Collapse assistant',
+    'chat.floating_assistant.close': 'Close',
     // AssistantDock (#2904)
     'chat.assistant_dock.no_surfaces': 'Nothing on this page can be changed from the chat. You can still ask questions.',
     'chat.assistant_dock.loading_conversations': 'Loading conversations…',