@voqalize/avatar 0.4.1 → 0.4.3

package/src/visemes.js

@@ -36,19 +36,50 @@
 import {
   CUE_TRACK_LEAD_MS,
   MIN_VISIBLE_CUE_MS,
+  ROUND_LEAD_MS,
   SPEECH_TRACK_TAIL_MS,
 } from './speech-timing.js';
 
+/**
+ * The mouth every face owes the server, at the loudest a cue can say (`i` 1).
+ *
+ * **The apertures are measured speech, not taste.** The anchor is the open
+ * vowel: Huber & Chandrasekaran 2006 (JSLHR 49:1368, Table 2; Optotrak, 30
+ * adults, a sentence read aloud) open "Bobby"'s [ɑ] by 7.84 mm of lower lip
+ * over the jaw, 7.32 of jaw and 2.49 of upper lip — 17.65 mm of inter-lip
+ * opening, pooled over one comfortable and three loud conditions. Their Table 1
+ * puts comfortable at 0.83 of that pool (4.86 mm against a loud 6.06–6.35), so
+ * ordinary speech opens an [ɑ] **14.6 mm**, and `D` is sized so that it does at
+ * `i` 0.5 — which is where PyGato puts an engine's ordinary speaking level
+ * (`pygato.lipsync.intensity`). The same paper is the check on the parts this
+ * does not set: the jaw's share comes out at 6.6 mm against their ~6.1, and the
+ * upper lip at 1.7 mm against ~2.1 — the upper lip is the stable one, a third
+ * of the lower's travel, and the rig already had it so.
+ *
+ * Millimetres are face units at **176.7 mm** a unit (chin to hairline): Lin &
+ * Chen 2017 (PLoS ONE 12:e0188638) give women's menton–sellion as 107.8 mm,
+ * and sellion sits at 0.61 of the unit on every character here. Their mouth
+ * width (44.9 mm) would say 157 — these faces are drawn with slightly wide
+ * mouths, and the vertical measure is the one an aperture is.
+ *
+ * No source reachable gave per-vowel apertures in millimetres, so the other
+ * letters keep the ratios to `D` they were authored with and are scaled by the
+ * same factor (0.617 of their excursion from rest). Upper-teeth show is part
+ * of the opening and scales with it — except on `G`, where teeth on the lip
+ * *is* the shape. A mouth this size is what "the mouth is moving a lot" was
+ * asking for: the table it replaced opened an ordinary [ɑ] 26 mm, as far as the
+ * loud speech in that study opens a shout.
+ */
 export const VISEME_SHAPES = {
   X: { mouthOpen: 0.02, mouthWidth: 0.42, mouthRound: 0.10, mouthPress: 0.15, mouthTuck: 0, teethUpper: 0.00, tongue: 0.0 },
   A: { mouthOpen: 0.00, mouthWidth: 0.40, mouthRound: 0.18, mouthPress: 0.55, mouthTuck: 0, teethUpper: 0.00, tongue: 0.0 },
-  B: { mouthOpen: 0.16, mouthWidth: 0.54, mouthRound: 0.05, mouthPress: 0.10, mouthTuck: 0, teethUpper: 0.75, tongue: 0.0 },
-  C: { mouthOpen: 0.45, mouthWidth: 0.58, mouthRound: 0.05, mouthPress: 0.00, mouthTuck: 0, teethUpper: 0.45, tongue: 0.0 },
-  D: { mouthOpen: 0.85, mouthWidth: 0.52, mouthRound: 0.02, mouthPress: 0.00, mouthTuck: 0, teethUpper: 0.25, tongue: 0.15 },
-  E: { mouthOpen: 0.34, mouthWidth: 0.28, mouthRound: 0.55, mouthPress: 0.00, mouthTuck: 0, teethUpper: 0.15, tongue: 0.0 },
-  F: { mouthOpen: 0.22, mouthWidth: 0.10, mouthRound: 0.95, mouthPress: 0.10, mouthTuck: 0, teethUpper: 0.00, tongue: 0.0 },
-  G: { mouthOpen: 0.20, mouthWidth: 0.46, mouthRound: 0.10, mouthPress: 0.40, mouthTuck: 1.00, teethUpper: 1.00, tongue: 0.0 },
-  H: { mouthOpen: 0.40, mouthWidth: 0.48, mouthRound: 0.05, mouthPress: 0.00, mouthTuck: 0, teethUpper: 0.35, tongue: 0.90 },
+  B: { mouthOpen: 0.11, mouthWidth: 0.54, mouthRound: 0.05, mouthPress: 0.10, mouthTuck: 0, teethUpper: 0.46, tongue: 0.0 },
+  C: { mouthOpen: 0.29, mouthWidth: 0.58, mouthRound: 0.05, mouthPress: 0.00, mouthTuck: 0, teethUpper: 0.28, tongue: 0.0 },
+  D: { mouthOpen: 0.53, mouthWidth: 0.52, mouthRound: 0.02, mouthPress: 0.00, mouthTuck: 0, teethUpper: 0.15, tongue: 0.15 },
+  E: { mouthOpen: 0.22, mouthWidth: 0.28, mouthRound: 0.55, mouthPress: 0.00, mouthTuck: 0, teethUpper: 0.09, tongue: 0.0 },
+  F: { mouthOpen: 0.14, mouthWidth: 0.10, mouthRound: 0.95, mouthPress: 0.10, mouthTuck: 0, teethUpper: 0.00, tongue: 0.0 },
+  G: { mouthOpen: 0.13, mouthWidth: 0.46, mouthRound: 0.10, mouthPress: 0.40, mouthTuck: 1.00, teethUpper: 1.00, tongue: 0.0 },
+  H: { mouthOpen: 0.25, mouthWidth: 0.48, mouthRound: 0.05, mouthPress: 0.00, mouthTuck: 0, teethUpper: 0.22, tongue: 0.90 },
 };
 
 export const VISEME_LETTERS = Object.keys(VISEME_SHAPES);
@@ -56,6 +87,40 @@ export const VISEME_LETTERS = Object.keys(VISEME_SHAPES);
 /** Resting mouth used when nothing is speaking. */
 export const SILENT = 'X';
 
+/** The shapes that are a contact, not an aperture: lips together, lip to teeth. */
+const CLOSURES = new Set(['A', 'G']);
+
+/**
+ * How far the mandible falls for a given aperture — `jaw` is "follows
+ * mouthOpen but slower" (`params.js`) and this is the slower.
+ *
+ * It is exported because it is not a preference: **every amplitude behind the
+ * lips was calibrated at this ratio**, so a driver that picks its own moves the
+ * mandible relative to the lip that hides it. The lower arch is the surface
+ * that shows it, because it rides `jaw` alone while the lip peels off it on
+ * `mouthOpen`: what is seen of the arch is the difference between two much
+ * larger travels (`avatar-3d/scripts/morphs.ARCH_DROP`), so it goes to nothing
+ * at a ratio only a little above this one. A face driven at 1:1 opens wide and
+ * shows no lower teeth at any aperture — the arch descends as fast as the lip
+ * uncovering it, which is what mocap did until it read this number instead of
+ * ARKit's `jawOpen` directly.
+ */
+export const JAW_OF_OPEN = 0.7;
+
+/**
+ * How much of a shape's excursion a cue's loudness buys, as `k = LOUDNESS_FLOOR
+ * + (1 - LOUDNESS_FLOOR) * i`.
+ *
+ * Louder speech is the same movement made bigger, and not by much: +10 dB
+ * opens the lips and jaw 1.28x as far (Huber & Chandrasekaran 2006, Table 1:
+ * 4.86 mm comfortable, 6.06–6.35 loud; Schulman 1989 calls it "amplification
+ * of normal movement patterns"). `i` spans 16 dB with ordinary speech at 0.5,
+ * so 0.5 either side is 8 dB and 1.22x — k runs 0.776 : 1 : 1.224 across it,
+ * which normalised to the loud end is this floor. The quiet side is the loud
+ * side's slope extended; nothing measured it.
+ */
+const LOUDNESS_FLOOR = 0.634;
+
 /**
  * Scale a shape by loudness. Only the "effortful" channels scale — a quiet 'D'
  * is a small D, not a different shape.
@@ -63,7 +128,7 @@ export const SILENT = 'X';
 export function shapeFor(letter, intensity = 1) {
   const base = VISEME_SHAPES[letter] || VISEME_SHAPES[SILENT];
   const rest = VISEME_SHAPES.X;
-  const k = 0.45 + 0.55 * Math.max(0, Math.min(1, intensity));
+  const k = LOUDNESS_FLOOR + (1 - LOUDNESS_FLOOR) * Math.max(0, Math.min(1, intensity));
   return {
     mouthOpen: rest.mouthOpen + (base.mouthOpen - rest.mouthOpen) * k,
     mouthWidth: rest.mouthWidth + (base.mouthWidth - rest.mouthWidth) * k,
@@ -72,7 +137,7 @@ export function shapeFor(letter, intensity = 1) {
     mouthTuck: base.mouthTuck,
     teethUpper: base.teethUpper * k,
     tongue: base.tongue,
-    jaw: (rest.mouthOpen + (base.mouthOpen - rest.mouthOpen) * k) * 0.7,
+    jaw: (rest.mouthOpen + (base.mouthOpen - rest.mouthOpen) * k) * JAW_OF_OPEN,
   };
 }
 
@@ -127,7 +192,7 @@ export function normalizeCues(cues) {
     if (prev && head.t - prev.t < MIN_VISIBLE_CUE_MS) {
       // Too short to read. Keep whichever is more visually salient: a closure
       // (A/G) carries more lip-reading information than a mid-open vowel.
-      if (v === 'A' || v === 'G') {
+      if (CLOSURES.has(v)) {
         // The short cue can sit between two identical closures (G → F → G).
         // Its replacement would otherwise create a duplicate visible shape;
         // preserving the first G is both the stable wire form and the face the
@@ -209,6 +274,14 @@ export class VisemeTrack {
     this.cues = merged;
     // Re-seek rather than trusting the old index against a re-normalized array.
     this._idx = 0;
+    // A sentence can arrive after the one before it has played out — a TTS
+    // whose next sentence lags its own audio does this routinely — and the
+    // track had stopped at that sentence's tail. Resume on the same clock, or
+    // the face holds still through audio the user can hear.
+    if (!this.playing && this.clock && merged.length) {
+      const last = merged[merged.length - 1];
+      this.playing = last.v !== SILENT || this.clock() + LEAD_MS <= last.t + this.tailMs;
+    }
   }
 
   stop() {
@@ -218,7 +291,19 @@ export class VisemeTrack {
     this._idx = 0;
   }
 
-  /** @returns {{letter: string, intensity: number, phone: string | null} | null} */
+  /**
+   * The shape to aim at now, which is not always the cue under the clock.
+   *
+   * Rounding starts before its sound, because it is the kind of gesture a
+   * viewer reads a word by (speech-timing.js has the measurements): `round`
+   * carries the pucker of a rounded vowel coming up within `ROUND_LEAD_MS`, for
+   * the mixer to hold against the current shape's own. It does not reach
+   * across a rest. A closure's early onset is not drawn here — the server
+   * already starts every closure cue ahead of its phone, and a second lead on
+   * top of that closed the lips a whole vowel early.
+   *
+   * @returns {{letter: string, intensity: number, phone: string | null, round: number} | null}
+   */
   sample() {
     if (!this.playing || !this.cues.length || !this.clock) return null;
     const now = this.clock() + LEAD_MS;
@@ -237,8 +322,17 @@ export class VisemeTrack {
     }
 
     const cue = this.cues[this._idx];
-    if (cue.t > now) return { letter: SILENT, intensity: 1, phone: null };
-    return { letter: cue.v, intensity: cue.i == null ? 1 : cue.i, phone: cue.p ?? null };
+    if (cue.t > now) return { letter: SILENT, intensity: 1, phone: null, round: 0 };
+    let round = 0;
+    for (let j = this._idx + 1; j < this.cues.length; j++) {
+      const ahead = this.cues[j];
+      if (ahead.v === SILENT || ahead.t - now > ROUND_LEAD_MS) break;
+      // Across consonants too: protrusion before a rounded vowel grows with the
+      // consonants in front of it (Noiray et al. 2011, JASA 129:340), so the
+      // lips of "sm-" in "smooth" are already on their way.
+      round = Math.max(round, VISEME_SHAPES[ahead.v].mouthRound);
+    }
+    return { letter: cue.v, intensity: cue.i == null ? 1 : cue.i, phone: cue.p ?? null, round };
   }
 }
 

package/client/arjun.ts

@@ -1,26 +0,0 @@
-/** Professional Indian male interviewer, authored to read at call-tile size. */
-
-import { createCanvasAvatar } from './createCanvasAvatar.js';
-import type { CanvasAvatarOptions } from './createCanvasAvatar.js';
-import type { AvatarInstance } from './createAvatar.js';
-
-const RIG_URL = new URL('../src/canvas/data/interviewer-male.rig.json', import.meta.url);
-const IMAGES = {
-  'round-m3-hair-back.webp': new URL('../src/canvas/data/img/round-m3-hair-back.webp', import.meta.url),
-  'round-m3-top-body.webp': new URL('../src/canvas/data/img/round-m3-top-body.webp', import.meta.url),
-  'round-m3-hair-front.webp': new URL('../src/canvas/data/img/round-m3-hair-front.webp', import.meta.url),
-} as const;
-const FACE = () => import('../src/canvas/avatars/round/face.mjs');
-
-export type { CanvasAvatarOptions };
-// Same mixer, same clip library, so the same declaration (`supports.ts`).
-export { supports } from './supports.js';
-
-export function createAvatar(options: CanvasAvatarOptions): AvatarInstance {
-  return createCanvasAvatar(options, {
-    rigUrl: RIG_URL,
-    images: IMAGES,
-    face: FACE,
-    label: 'Arjun — professional male interviewer avatar',
-  });
-}

package/client/createCanvasAvatar.ts

@@ -1,72 +0,0 @@
-/** Shared private constructor for the code-authored canvas avatars. */
-
-import type { PipecatClient } from '@pipecat-ai/client-js';
-import { createAvatar as createMixer, STATES } from '../src/avatar.js';
-import type { Gain } from '../src/avatar.js';
-import { createCanvasRig } from '../src/canvas/create-rig.js';
-import { AvatarClient } from './AvatarClient.js';
-import type { AvatarInstance, AvatarOptions } from './createAvatar.js';
-
-export interface CanvasAvatarOptions extends AvatarOptions {
-  /** Viseme amplitude, 0..2. `1` is as authored. */
-  readonly mouthGain?: Gain;
-  /** Gesture-clip amplitude, 0..2. */
-  readonly gestureGain?: Gain;
-  /** Idle/liveness amplitude, 0..2. */
-  readonly motionGain?: Gain;
-}
-
-/** @deprecated Use `CanvasAvatarOptions`; kept for the original entry points. */
-export type InterviewerAvatarOptions = CanvasAvatarOptions;
-
-interface CanvasAvatarConfig {
-  readonly rigUrl: URL;
-  readonly images: Readonly<Record<string, URL>>;
-  readonly face: () => Promise<unknown>;
-  readonly label: string;
-}
-
-const GAINS = ['mouthGain', 'gestureGain', 'motionGain'] as const;
-const PRESENCE_FILTERS: Readonly<Record<string, string>> = {
-  DEGRADED: String(STATES.DEGRADED.filter ?? ''),
-  OFFLINE: String(STATES.OFFLINE.filter ?? ''),
-};
-
-export function createCanvasAvatar(
-  options: CanvasAvatarOptions,
-  config: CanvasAvatarConfig,
-): AvatarInstance {
-  const { mount, client, ...gains } = options;
-  if (!mount) throw new TypeError('createAvatar: `mount` is required');
-  if (!client) throw new TypeError('createAvatar: `client` is required');
-  for (const key of GAINS) {
-    const gain = gains[key];
-    if (gain === undefined) continue;
-    if (!Number.isFinite(gain) || gain < 0 || gain > 2) {
-      throw new RangeError(`createAvatar: \`${key}\` must be 0..2, got ${String(gain)}`);
-    }
-  }
-
-  const canvas = createCanvasRig({
-    url: config.rigUrl,
-    images: config.images,
-    face: config.face,
-    label: config.label,
-  });
-  const widget = createMixer({ mount, rig: canvas.factory, ...gains });
-  const driver = new AvatarClient(widget, {
-    onPresenceChange: (state) => canvas.setPresenceFilter(PRESENCE_FILTERS[state] ?? ''),
-  });
-  const detach = driver.attach(client as PipecatClient);
-
-  let destroyed = false;
-  return {
-    destroy() {
-      if (destroyed) return;
-      destroyed = true;
-      detach();
-      driver.destroy();
-      widget.destroy();
-    },
-  };
-}

package/client/interviewer-female.ts

@@ -1,4 +0,0 @@
-/** @deprecated Renamed to `meera`; kept as an alias so existing imports keep working. */
-
-export { createAvatar } from './meera.js';
-export type { CanvasAvatarOptions, CanvasAvatarOptions as InterviewerAvatarOptions } from './createCanvasAvatar.js';

package/client/interviewer-male.ts

@@ -1,4 +0,0 @@
-/** @deprecated Renamed to `arjun`; kept as an alias so existing imports keep working. */
-
-export { createAvatar } from './arjun.js';
-export type { CanvasAvatarOptions, CanvasAvatarOptions as InterviewerAvatarOptions } from './createCanvasAvatar.js';

package/client/ishita.ts

@@ -1,26 +0,0 @@
-/** Polished professional female avatar, authored to read at call-tile size. */
-
-import { createCanvasAvatar } from './createCanvasAvatar.js';
-import type { CanvasAvatarOptions } from './createCanvasAvatar.js';
-import type { AvatarInstance } from './createAvatar.js';
-
-const RIG_URL = new URL('../src/canvas/data/professional-female-a.rig.json', import.meta.url);
-const IMAGES = {
-  'professional-female-a-top-body.webp': new URL('../src/canvas/data/img/professional-female-a-top-body.webp', import.meta.url),
-  'professional-female-a-hair-back.webp': new URL('../src/canvas/data/img/professional-female-a-hair-back.webp', import.meta.url),
-  'professional-female-a-hair-front.webp': new URL('../src/canvas/data/img/professional-female-a-hair-front.webp', import.meta.url),
-} as const;
-const FACE = () => import('../src/canvas/avatars/round/face.mjs');
-
-export type { CanvasAvatarOptions };
-// Same mixer, same clip library, so the same declaration (`supports.ts`).
-export { supports } from './supports.js';
-
-export function createAvatar(options: CanvasAvatarOptions): AvatarInstance {
-  return createCanvasAvatar(options, {
-    rigUrl: RIG_URL,
-    images: IMAGES,
-    face: FACE,
-    label: 'Ishita — polished professional female avatar',
-  });
-}

package/client/kabir.ts

@@ -1,26 +0,0 @@
-/** Relaxed professional male avatar, authored to read at call-tile size. */
-
-import { createCanvasAvatar } from './createCanvasAvatar.js';
-import type { CanvasAvatarOptions } from './createCanvasAvatar.js';
-import type { AvatarInstance } from './createAvatar.js';
-
-const RIG_URL = new URL('../src/canvas/data/professional-male-b.rig.json', import.meta.url);
-const IMAGES = {
-  'professional-male-b-top-body.webp': new URL('../src/canvas/data/img/professional-male-b-top-body.webp', import.meta.url),
-  'professional-male-b-hair-back.webp': new URL('../src/canvas/data/img/professional-male-b-hair-back.webp', import.meta.url),
-  'professional-male-b-hair-front.webp': new URL('../src/canvas/data/img/professional-male-b-hair-front.webp', import.meta.url),
-} as const;
-const FACE = () => import('../src/canvas/avatars/round/face.mjs');
-
-export type { CanvasAvatarOptions };
-// Same mixer, same clip library, so the same declaration (`supports.ts`).
-export { supports } from './supports.js';
-
-export function createAvatar(options: CanvasAvatarOptions): AvatarInstance {
-  return createCanvasAvatar(options, {
-    rigUrl: RIG_URL,
-    images: IMAGES,
-    face: FACE,
-    label: 'Kabir — relaxed professional male avatar',
-  });
-}

package/client/meera.ts

@@ -1,26 +0,0 @@
-/** Professional Indian female interviewer, authored to read at call-tile size. */
-
-import { createCanvasAvatar } from './createCanvasAvatar.js';
-import type { CanvasAvatarOptions } from './createCanvasAvatar.js';
-import type { AvatarInstance } from './createAvatar.js';
-
-const RIG_URL = new URL('../src/canvas/data/interviewer-female.rig.json', import.meta.url);
-const IMAGES = {
-  'round-w1-hair-back.webp': new URL('../src/canvas/data/img/round-w1-hair-back.webp', import.meta.url),
-  'round-w1-top-body.webp': new URL('../src/canvas/data/img/round-w1-top-body.webp', import.meta.url),
-  'round-w1-hair-front.webp': new URL('../src/canvas/data/img/round-w1-hair-front.webp', import.meta.url),
-} as const;
-const FACE = () => import('../src/canvas/avatars/round/face.mjs');
-
-export type { CanvasAvatarOptions };
-// Same mixer, same clip library, so the same declaration (`supports.ts`).
-export { supports } from './supports.js';
-
-export function createAvatar(options: CanvasAvatarOptions): AvatarInstance {
-  return createCanvasAvatar(options, {
-    rigUrl: RIG_URL,
-    images: IMAGES,
-    face: FACE,
-    label: 'Meera — professional female interviewer avatar',
-  });
-}

package/client/naina.ts

@@ -1,26 +0,0 @@
-/** Relaxed professional female avatar, authored to read at call-tile size. */
-
-import { createCanvasAvatar } from './createCanvasAvatar.js';
-import type { CanvasAvatarOptions } from './createCanvasAvatar.js';
-import type { AvatarInstance } from './createAvatar.js';
-
-const RIG_URL = new URL('../src/canvas/data/professional-female-b.rig.json', import.meta.url);
-const IMAGES = {
-  'professional-female-b-top-body.webp': new URL('../src/canvas/data/img/professional-female-b-top-body.webp', import.meta.url),
-  'professional-female-b-hair-back.webp': new URL('../src/canvas/data/img/professional-female-b-hair-back.webp', import.meta.url),
-  'professional-female-b-hair-front.webp': new URL('../src/canvas/data/img/professional-female-b-hair-front.webp', import.meta.url),
-} as const;
-const FACE = () => import('../src/canvas/avatars/round/face.mjs');
-
-export type { CanvasAvatarOptions };
-// Same mixer, same clip library, so the same declaration (`supports.ts`).
-export { supports } from './supports.js';
-
-export function createAvatar(options: CanvasAvatarOptions): AvatarInstance {
-  return createCanvasAvatar(options, {
-    rigUrl: RIG_URL,
-    images: IMAGES,
-    face: FACE,
-    label: 'Naina — relaxed professional female avatar',
-  });
-}

package/client/professional-female-a.ts

@@ -1,4 +0,0 @@
-/** @deprecated Renamed to `ishita`; kept as an alias so existing imports keep working. */
-
-export { createAvatar } from './ishita.js';
-export type { CanvasAvatarOptions } from './createCanvasAvatar.js';

package/client/professional-female-b.ts

@@ -1,4 +0,0 @@
-/** @deprecated Renamed to `naina`; kept as an alias so existing imports keep working. */
-
-export { createAvatar } from './naina.js';
-export type { CanvasAvatarOptions } from './createCanvasAvatar.js';

package/client/professional-male-a.ts

@@ -1,4 +0,0 @@
-/** @deprecated Renamed to `vikram`; kept as an alias so existing imports keep working. */
-
-export { createAvatar } from './vikram.js';
-export type { CanvasAvatarOptions } from './createCanvasAvatar.js';

package/client/professional-male-b.ts

@@ -1,4 +0,0 @@
-/** @deprecated Renamed to `kabir`; kept as an alias so existing imports keep working. */
-
-export { createAvatar } from './kabir.js';
-export type { CanvasAvatarOptions } from './createCanvasAvatar.js';

package/client/vikram.ts

@@ -1,26 +0,0 @@
-/** Polished professional male avatar, authored to read at call-tile size. */
-
-import { createCanvasAvatar } from './createCanvasAvatar.js';
-import type { CanvasAvatarOptions } from './createCanvasAvatar.js';
-import type { AvatarInstance } from './createAvatar.js';
-
-const RIG_URL = new URL('../src/canvas/data/professional-male-a.rig.json', import.meta.url);
-const IMAGES = {
-  'professional-male-a-top-body.webp': new URL('../src/canvas/data/img/professional-male-a-top-body.webp', import.meta.url),
-  'professional-male-a-hair-back.webp': new URL('../src/canvas/data/img/professional-male-a-hair-back.webp', import.meta.url),
-  'professional-male-a-hair-front.webp': new URL('../src/canvas/data/img/professional-male-a-hair-front.webp', import.meta.url),
-} as const;
-const FACE = () => import('../src/canvas/avatars/round/face.mjs');
-
-export type { CanvasAvatarOptions };
-// Same mixer, same clip library, so the same declaration (`supports.ts`).
-export { supports } from './supports.js';
-
-export function createAvatar(options: CanvasAvatarOptions): AvatarInstance {
-  return createCanvasAvatar(options, {
-    rigUrl: RIG_URL,
-    images: IMAGES,
-    face: FACE,
-    label: 'Vikram — polished professional male avatar',
-  });
-}

package/dist/arjun.d.ts

@@ -1,7 +0,0 @@
-/** Professional Indian male interviewer, authored to read at call-tile size. */
-import type { CanvasAvatarOptions } from './createCanvasAvatar.js';
-import type { AvatarInstance } from './createAvatar.js';
-export type { CanvasAvatarOptions };
-export { supports } from './supports.js';
-export declare function createAvatar(options: CanvasAvatarOptions): AvatarInstance;
-//# sourceMappingURL=arjun.d.ts.map

package/dist/arjun.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"arjun.d.ts","sourceRoot":"","sources":["../client/arjun.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAGhF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAUxD,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,cAAc,CAOzE"}

package/dist/arjun.js

@@ -1,20 +0,0 @@
-/** Professional Indian male interviewer, authored to read at call-tile size. */
-import { createCanvasAvatar } from './createCanvasAvatar.js';
-const RIG_URL = new URL('../src/canvas/data/interviewer-male.rig.json', import.meta.url);
-const IMAGES = {
-    'round-m3-hair-back.webp': new URL('../src/canvas/data/img/round-m3-hair-back.webp', import.meta.url),
-    'round-m3-top-body.webp': new URL('../src/canvas/data/img/round-m3-top-body.webp', import.meta.url),
-    'round-m3-hair-front.webp': new URL('../src/canvas/data/img/round-m3-hair-front.webp', import.meta.url),
-};
-const FACE = () => import('../src/canvas/avatars/round/face.mjs');
-// Same mixer, same clip library, so the same declaration (`supports.ts`).
-export { supports } from './supports.js';
-export function createAvatar(options) {
-    return createCanvasAvatar(options, {
-        rigUrl: RIG_URL,
-        images: IMAGES,
-        face: FACE,
-        label: 'Arjun — professional male interviewer avatar',
-    });
-}
-//# sourceMappingURL=arjun.js.map

package/dist/arjun.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"arjun.js","sourceRoot":"","sources":["../client/arjun.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAI7D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,8CAA8C,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzF,MAAM,MAAM,GAAG;IACb,yBAAyB,EAAE,IAAI,GAAG,CAAC,gDAAgD,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IACrG,wBAAwB,EAAE,IAAI,GAAG,CAAC,+CAA+C,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IACnG,0BAA0B,EAAE,IAAI,GAAG,CAAC,iDAAiD,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;CAC/F,CAAC;AACX,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,sCAAsC,CAAC,CAAC;AAGlE,0EAA0E;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,OAAO,kBAAkB,CAAC,OAAO,EAAE;QACjC,MAAM,EAAE,OAAO;QACf,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,8CAA8C;KACtD,CAAC,CAAC;AACL,CAAC"}

package/dist/createCanvasAvatar.d.ts

@@ -1,22 +0,0 @@
-/** Shared private constructor for the code-authored canvas avatars. */
-import type { Gain } from '../src/avatar.js';
-import type { AvatarInstance, AvatarOptions } from './createAvatar.js';
-export interface CanvasAvatarOptions extends AvatarOptions {
-    /** Viseme amplitude, 0..2. `1` is as authored. */
-    readonly mouthGain?: Gain;
-    /** Gesture-clip amplitude, 0..2. */
-    readonly gestureGain?: Gain;
-    /** Idle/liveness amplitude, 0..2. */
-    readonly motionGain?: Gain;
-}
-/** @deprecated Use `CanvasAvatarOptions`; kept for the original entry points. */
-export type InterviewerAvatarOptions = CanvasAvatarOptions;
-interface CanvasAvatarConfig {
-    readonly rigUrl: URL;
-    readonly images: Readonly<Record<string, URL>>;
-    readonly face: () => Promise<unknown>;
-    readonly label: string;
-}
-export declare function createCanvasAvatar(options: CanvasAvatarOptions, config: CanvasAvatarConfig): AvatarInstance;
-export {};
-//# sourceMappingURL=createCanvasAvatar.d.ts.map

package/dist/createCanvasAvatar.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createCanvasAvatar.d.ts","sourceRoot":"","sources":["../client/createCanvasAvatar.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAIvE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvE,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC;CAC5B;AAED,iFAAiF;AACjF,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,CAAC;AAE3D,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAQD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,kBAAkB,GACzB,cAAc,CAkChB"}

package/dist/createCanvasAvatar.js

@@ -1,47 +0,0 @@
-/** Shared private constructor for the code-authored canvas avatars. */
-import { createAvatar as createMixer, STATES } from '../src/avatar.js';
-import { createCanvasRig } from '../src/canvas/create-rig.js';
-import { AvatarClient } from './AvatarClient.js';
-const GAINS = ['mouthGain', 'gestureGain', 'motionGain'];
-const PRESENCE_FILTERS = {
-    DEGRADED: String(STATES.DEGRADED.filter ?? ''),
-    OFFLINE: String(STATES.OFFLINE.filter ?? ''),
-};
-export function createCanvasAvatar(options, config) {
-    const { mount, client, ...gains } = options;
-    if (!mount)
-        throw new TypeError('createAvatar: `mount` is required');
-    if (!client)
-        throw new TypeError('createAvatar: `client` is required');
-    for (const key of GAINS) {
-        const gain = gains[key];
-        if (gain === undefined)
-            continue;
-        if (!Number.isFinite(gain) || gain < 0 || gain > 2) {
-            throw new RangeError(`createAvatar: \`${key}\` must be 0..2, got ${String(gain)}`);
-        }
-    }
-    const canvas = createCanvasRig({
-        url: config.rigUrl,
-        images: config.images,
-        face: config.face,
-        label: config.label,
-    });
-    const widget = createMixer({ mount, rig: canvas.factory, ...gains });
-    const driver = new AvatarClient(widget, {
-        onPresenceChange: (state) => canvas.setPresenceFilter(PRESENCE_FILTERS[state] ?? ''),
-    });
-    const detach = driver.attach(client);
-    let destroyed = false;
-    return {
-        destroy() {
-            if (destroyed)
-                return;
-            destroyed = true;
-            detach();
-            driver.destroy();
-            widget.destroy();
-        },
-    };
-}
-//# sourceMappingURL=createCanvasAvatar.js.map

package/dist/createCanvasAvatar.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createCanvasAvatar.js","sourceRoot":"","sources":["../client/createCanvasAvatar.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAGvE,OAAO,EAAE,YAAY,IAAI,WAAW,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAsBjD,MAAM,KAAK,GAAG,CAAC,WAAW,EAAE,aAAa,EAAE,YAAY,CAAU,CAAC;AAClE,MAAM,gBAAgB,GAAqC;IACzD,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;IAC9C,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;CAC7C,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAChC,OAA4B,EAC5B,MAA0B;IAE1B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAC5C,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;IACrE,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;IACvE,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS;QACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,UAAU,CAAC,mBAAmB,GAAG,wBAAwB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC;QAC7B,GAAG,EAAE,MAAM,CAAC,MAAM;QAClB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE;QACtC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;KACrF,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAuB,CAAC,CAAC;IAEtD,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,OAAO;QACL,OAAO;YACL,IAAI,SAAS;gBAAE,OAAO;YACtB,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM,EAAE,CAAC;YACT,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/interviewer-female.d.ts

@@ -1,4 +0,0 @@
-/** @deprecated Renamed to `meera`; kept as an alias so existing imports keep working. */
-export { createAvatar } from './meera.js';
-export type { CanvasAvatarOptions, CanvasAvatarOptions as InterviewerAvatarOptions } from './createCanvasAvatar.js';
-//# sourceMappingURL=interviewer-female.d.ts.map

package/dist/interviewer-female.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"interviewer-female.d.ts","sourceRoot":"","sources":["../client/interviewer-female.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAEzF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,IAAI,wBAAwB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/interviewer-female.js

@@ -1,3 +0,0 @@
-/** @deprecated Renamed to `meera`; kept as an alias so existing imports keep working. */
-export { createAvatar } from './meera.js';
-//# sourceMappingURL=interviewer-female.js.map

package/dist/interviewer-female.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"interviewer-female.js","sourceRoot":"","sources":["../client/interviewer-female.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAEzF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/interviewer-male.d.ts

@@ -1,4 +0,0 @@
-/** @deprecated Renamed to `arjun`; kept as an alias so existing imports keep working. */
-export { createAvatar } from './arjun.js';
-export type { CanvasAvatarOptions, CanvasAvatarOptions as InterviewerAvatarOptions } from './createCanvasAvatar.js';
-//# sourceMappingURL=interviewer-male.d.ts.map

package/dist/interviewer-male.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"interviewer-male.d.ts","sourceRoot":"","sources":["../client/interviewer-male.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAEzF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,IAAI,wBAAwB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/interviewer-male.js

@@ -1,3 +0,0 @@
-/** @deprecated Renamed to `arjun`; kept as an alias so existing imports keep working. */
-export { createAvatar } from './arjun.js';
-//# sourceMappingURL=interviewer-male.js.map

package/dist/interviewer-male.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"interviewer-male.js","sourceRoot":"","sources":["../client/interviewer-male.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAEzF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/ishita.d.ts

@@ -1,7 +0,0 @@
-/** Polished professional female avatar, authored to read at call-tile size. */
-import type { CanvasAvatarOptions } from './createCanvasAvatar.js';
-import type { AvatarInstance } from './createAvatar.js';
-export type { CanvasAvatarOptions };
-export { supports } from './supports.js';
-export declare function createAvatar(options: CanvasAvatarOptions): AvatarInstance;
-//# sourceMappingURL=ishita.d.ts.map

package/dist/ishita.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ishita.d.ts","sourceRoot":"","sources":["../client/ishita.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAG/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAUxD,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,cAAc,CAOzE"}