@voqalize/avatar 0.4.2 → 0.4.3

package/dist/three/tara.d.ts

@@ -4,32 +4,27 @@
  * Structurally this is the canvas avatars' shape, one layer down: the mixer
  * (`@voqalize/avatar/internal`) does states, layers, gaze, idle, blinks, clips
  * and per-channel smoothing exactly as it does for every SVG face, and the only
- * thing tara replaces is the renderer at the end of it. That is the whole
- * argument for authoring her morph targets under the library's pose-channel
- * names: nothing above this line knows there is a GPU involved, and every clip,
- * viseme and co-articulation rule the SVG faces have works here unmodified.
+ * thing a Blender character replaces is the renderer at the end of it. That is
+ * the whole argument for authoring her morph targets under the library's pose
+ * channel names: nothing above this line knows there is a GPU involved, and
+ * every clip, viseme and co-articulation rule the SVG faces have works here
+ * unmodified.
+ *
+ * How a Blender character is driven is `createCharacter.ts`, and it is the same
+ * for all of them. What is hers is the mesh — and, until 2026-09-23, rather
+ * more than that: this file was the original, the others were copies of it, and
+ * the performance every character inherits was measured on her face. It is the
+ * house performance now (`CHARACTER_TUNING`), which changes nothing about how
+ * she looks and everything about where it is decided.
  *
  * The Three.js import lives behind this module rather than in the barrel so an
  * SVG or Canvas consumer never downloads it.
  */
-import type { PipecatClient } from "@pipecat-ai/client-js";
-export interface AvatarOptions {
-    readonly mount: HTMLElement;
-    readonly client: PipecatClient;
-    /** Viseme amplitude, 0..2. `1` is as authored. */
-    readonly mouthGain?: number;
-    /** Gesture-clip amplitude, 0..2. */
-    readonly gestureGain?: number;
-    /** Idle/liveness amplitude, 0..2. */
-    readonly motionGain?: number;
-    /** Fires when the GLB is in the scene — for a capture tool, not a consumer. */
-    readonly onReady?: () => void;
-}
-export interface AvatarInstance {
-    destroy(): void;
-}
-/** The optional driving-UI declaration; one list for all three characters
+import type { CharacterAvatarOptions } from "./createCharacter.js";
+export type { CharacterAvatarOptions as AvatarOptions };
+export type { AvatarInstance } from "./createCharacter.js";
+/** The optional driving-UI declaration; one list for every Blender character
  *  (`sequences.ts`), because they are one rig. */
 export declare const supports: import("../createAvatar.js").AvatarSupport;
-export declare function createAvatar(options: AvatarOptions): AvatarInstance;
+export declare const createAvatar: import("../createAvatar.js").AvatarFactory<CharacterAvatarOptions>;
 //# sourceMappingURL=tara.d.ts.map

package/dist/three/tara.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tara.d.ts","sourceRoot":"","sources":["../../client/three/tara.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAQ3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAAG,OAAO,IAAI,IAAI,CAAC;CAAE;AAEpD;kDACkD;AAClD,eAAO,MAAM,QAAQ,4CAAmB,CAAC;AAEzC,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAkCnE"}
+{"version":3,"file":"tara.d.ts","sourceRoot":"","sources":["../../client/three/tara.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAInE,YAAY,EAAE,sBAAsB,IAAI,aAAa,EAAE,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;kDACkD;AAClD,eAAO,MAAM,QAAQ,4CAAmB,CAAC;AAEzC,eAAO,MAAM,YAAY,oEAA8B,CAAC"}

package/dist/three/tara.js

@@ -4,56 +4,27 @@
  * Structurally this is the canvas avatars' shape, one layer down: the mixer
  * (`@voqalize/avatar/internal`) does states, layers, gaze, idle, blinks, clips
  * and per-channel smoothing exactly as it does for every SVG face, and the only
- * thing tara replaces is the renderer at the end of it. That is the whole
- * argument for authoring her morph targets under the library's pose-channel
- * names: nothing above this line knows there is a GPU involved, and every clip,
- * viseme and co-articulation rule the SVG faces have works here unmodified.
+ * thing a Blender character replaces is the renderer at the end of it. That is
+ * the whole argument for authoring her morph targets under the library's pose
+ * channel names: nothing above this line knows there is a GPU involved, and
+ * every clip, viseme and co-articulation rule the SVG faces have works here
+ * unmodified.
+ *
+ * How a Blender character is driven is `createCharacter.ts`, and it is the same
+ * for all of them. What is hers is the mesh — and, until 2026-09-23, rather
+ * more than that: this file was the original, the others were copies of it, and
+ * the performance every character inherits was measured on her face. It is the
+ * house performance now (`CHARACTER_TUNING`), which changes nothing about how
+ * she looks and everything about where it is decided.
  *
  * The Three.js import lives behind this module rather than in the barrel so an
  * SVG or Canvas consumer never downloads it.
  */
-import { AvatarClient, createSvgAvatar } from "../internal.js";
-import { BLENDER_ACTIONS, BLENDER_SEQUENCES, BLENDER_SUPPORTS } from "./sequences.js";
+import { character } from "./createCharacter.js";
+import { BLENDER_SUPPORTS } from "./sequences.js";
 import { TARA_GLB } from "./tara-asset.js";
-import { headHold } from "./holds.js";
-import { createTaraRig, TARA_TUNING } from "./tara-rig.js";
-/** The optional driving-UI declaration; one list for all three characters
+/** The optional driving-UI declaration; one list for every Blender character
  *  (`sequences.ts`), because they are one rig. */
 export const supports = BLENDER_SUPPORTS;
-export function createAvatar(options) {
-    const { mount, client, onReady, ...gains } = options;
-    if (!mount)
-        throw new TypeError("createAvatar: `mount` is required");
-    if (!client)
-        throw new TypeError("createAvatar: `client` is required");
-    const rigOptions = { onReady, url: TARA_GLB };
-    // `hand: false` disables the bundled SVG hand renderer only; the semantic
-    // hand frame still reaches the rig, which ignores it — tara has no arms, and
-    // that is the library's oldest standing constraint rather than an omission.
-    // `sequences` is what a server can address on *this* avatar beyond the two
-    // ids every avatar owes it — the three nod types the listening research
-    // separates, and a head shake sized for a rig whose pose unit is a degree.
-    // The wire's action id is open, so nothing here needed promoting; a server
-    // that does not know tara is mounted sends `ACKNOWLEDGE` and is never wrong.
-    // `actions` is the other half: her own shape for an id the mixer already has,
-    // whose shared keys land outside what it means on a head that turns in degrees.
-    const widget = createSvgAvatar({
-        mount, rig: createTaraRig, rigOptions, hand: false,
-        sequences: BLENDER_SEQUENCES, actions: BLENDER_ACTIONS, ...TARA_TUNING,
-        headHold: headHold("tara"), ...gains,
-    });
-    const driver = new AvatarClient(widget);
-    const detach = driver.attach(client);
-    let destroyed = false;
-    return {
-        destroy() {
-            if (destroyed)
-                return;
-            destroyed = true;
-            detach();
-            driver.destroy();
-            widget.destroy();
-        },
-    };
-}
+export const createAvatar = character("tara", TARA_GLB);
 //# sourceMappingURL=tara.js.map

package/dist/three/tara.js.map

@@ -1 +1 @@
-{"version":3,"file":"tara.js","sourceRoot":"","sources":["../../client/three/tara.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAkB3D;kDACkD;AAClD,MAAM,CAAC,MAAM,QAAQ,GAAG,gBAAgB,CAAC;AAEzC,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACrD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;IACrE,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAEvE,MAAM,UAAU,GAAmB,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAC9D,0EAA0E;IAC1E,6EAA6E;IAC7E,4EAA4E;IAC5E,2EAA2E;IAC3E,wEAAwE;IACxE,2EAA2E;IAC3E,2EAA2E;IAC3E,6EAA6E;IAC7E,8EAA8E;IAC9E,gFAAgF;IAChF,MAAM,MAAM,GAAG,eAAe,CAAC;QAC7B,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK;QAClD,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,WAAW;QACtE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK;KACrC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAErC,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"}
+{"version":3,"file":"tara.js","sourceRoot":"","sources":["../../client/three/tara.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAK3C;kDACkD;AAClD,MAAM,CAAC,MAAM,QAAQ,GAAG,gBAAgB,CAAC;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC"}

package/dist/three/tess.d.ts

@@ -1,38 +1,24 @@
 /**
- * tess — American, and like `tushar.ts` and `tanya.ts` a copy of `tara.ts`.
+ * tess — American, and the leanest character in the forge.
  *
- * Her GLB is tara's scripts run with her landmarks in place of tara's
- * (`characters/tess/`, whose README has the provenance and the commands), so
- * the rig, the mixer, the sequences and her tuning are all hers, unmodified;
- * the one seam is `TaraRigOptions.url`.
- *
- * She is back inside tara's atlas window — her hair is drawn into a low tail
- * that clears both ears and reaches |u| 0.492 against a window that stops at
- * 0.64 — so unlike tanya she needs no `face_texture.py` of her own, and her
- * `Hair` shell gives up no roll: nothing of hers hangs past the jaw to lag.
+ * Her GLB is the shared scripts run with her landmarks (`characters/tess/`,
+ * whose README has the provenance and the commands). She is back inside tara's
+ * atlas window — her hair is drawn into a low tail that clears both ears and
+ * reaches |u| 0.492 against a window that stops at 0.64 — so unlike tanya she
+ * needs no `face_texture.py` of her own, and her `Hair` shell gives up no roll:
+ * nothing of hers hangs past the jaw to lag. One supplied sheet, no paid edit,
+ * no module of her own; she is what a new character costs at the floor, which
+ * is why the README builds its template from her.
  *
  * Her head angles have not been read off her yet. `motion-limits.json` says so
  * rather than guessing, and `headHold` gives her the tightest budget any face
  * is still vouched for until the owner drives her.
  */
-import type { PipecatClient } from "@pipecat-ai/client-js";
-export interface AvatarOptions {
-    readonly mount: HTMLElement;
-    readonly client: PipecatClient;
-    /** Viseme amplitude, 0..2. `1` is as authored. */
-    readonly mouthGain?: number;
-    /** Gesture-clip amplitude, 0..2. */
-    readonly gestureGain?: number;
-    /** Idle/liveness amplitude, 0..2. */
-    readonly motionGain?: number;
-    /** Fires when the GLB is in the scene — for a capture tool, not a consumer. */
-    readonly onReady?: () => void;
-}
-export interface AvatarInstance {
-    destroy(): void;
-}
-/** The optional driving-UI declaration; one list for every character built on
- *  this rig (`sequences.ts`), because they are one rig. */
+import type { CharacterAvatarOptions } from "./createCharacter.js";
+export type { CharacterAvatarOptions as AvatarOptions };
+export type { AvatarInstance } from "./createCharacter.js";
+/** The optional driving-UI declaration; one list for every Blender character
+ *  (`sequences.ts`), because they are one rig. */
 export declare const supports: import("../createAvatar.js").AvatarSupport;
-export declare function createAvatar(options: AvatarOptions): AvatarInstance;
+export declare const createAvatar: import("../createAvatar.js").AvatarFactory<CharacterAvatarOptions>;
 //# sourceMappingURL=tess.d.ts.map

package/dist/three/tess.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tess.d.ts","sourceRoot":"","sources":["../../client/three/tess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAQ3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAAG,OAAO,IAAI,IAAI,CAAC;CAAE;AAEpD;2DAC2D;AAC3D,eAAO,MAAM,QAAQ,4CAAmB,CAAC;AAEzC,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CA0BnE"}
+{"version":3,"file":"tess.d.ts","sourceRoot":"","sources":["../../client/three/tess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAInE,YAAY,EAAE,sBAAsB,IAAI,aAAa,EAAE,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;kDACkD;AAClD,eAAO,MAAM,QAAQ,4CAAmB,CAAC;AAEzC,eAAO,MAAM,YAAY,oEAA8B,CAAC"}

package/dist/three/tess.js

@@ -1,54 +1,24 @@
 /**
- * tess — American, and like `tushar.ts` and `tanya.ts` a copy of `tara.ts`.
+ * tess — American, and the leanest character in the forge.
  *
- * Her GLB is tara's scripts run with her landmarks in place of tara's
- * (`characters/tess/`, whose README has the provenance and the commands), so
- * the rig, the mixer, the sequences and her tuning are all hers, unmodified;
- * the one seam is `TaraRigOptions.url`.
- *
- * She is back inside tara's atlas window — her hair is drawn into a low tail
- * that clears both ears and reaches |u| 0.492 against a window that stops at
- * 0.64 — so unlike tanya she needs no `face_texture.py` of her own, and her
- * `Hair` shell gives up no roll: nothing of hers hangs past the jaw to lag.
+ * Her GLB is the shared scripts run with her landmarks (`characters/tess/`,
+ * whose README has the provenance and the commands). She is back inside tara's
+ * atlas window — her hair is drawn into a low tail that clears both ears and
+ * reaches |u| 0.492 against a window that stops at 0.64 — so unlike tanya she
+ * needs no `face_texture.py` of her own, and her `Hair` shell gives up no roll:
+ * nothing of hers hangs past the jaw to lag. One supplied sheet, no paid edit,
+ * no module of her own; she is what a new character costs at the floor, which
+ * is why the README builds its template from her.
  *
  * Her head angles have not been read off her yet. `motion-limits.json` says so
  * rather than guessing, and `headHold` gives her the tightest budget any face
  * is still vouched for until the owner drives her.
  */
-import { AvatarClient, createSvgAvatar } from "../internal.js";
+import { character } from "./createCharacter.js";
+import { BLENDER_SUPPORTS } from "./sequences.js";
 import { TESS_GLB } from "./tess-asset.js";
-import { BLENDER_ACTIONS, BLENDER_SEQUENCES, BLENDER_SUPPORTS } from "./sequences.js";
-import { headHold } from "./holds.js";
-import { createTaraRig, TARA_TUNING } from "./tara-rig.js";
-/** The optional driving-UI declaration; one list for every character built on
- *  this rig (`sequences.ts`), because they are one rig. */
+/** The optional driving-UI declaration; one list for every Blender character
+ *  (`sequences.ts`), because they are one rig. */
 export const supports = BLENDER_SUPPORTS;
-export function createAvatar(options) {
-    const { mount, client, onReady, ...gains } = options;
-    if (!mount)
-        throw new TypeError("createAvatar: `mount` is required");
-    if (!client)
-        throw new TypeError("createAvatar: `client` is required");
-    const rigOptions = { onReady, url: TESS_GLB };
-    // TARA-SPECIFIC, kept on purpose: `TARA_TUNING` (her mouth and motion gains)
-    // is the first thing to question if she reads wrong in a call.
-    const widget = createSvgAvatar({
-        mount, rig: createTaraRig, rigOptions, hand: false,
-        sequences: BLENDER_SEQUENCES, actions: BLENDER_ACTIONS, ...TARA_TUNING,
-        headHold: headHold("tess"), ...gains,
-    });
-    const driver = new AvatarClient(widget);
-    const detach = driver.attach(client);
-    let destroyed = false;
-    return {
-        destroy() {
-            if (destroyed)
-                return;
-            destroyed = true;
-            detach();
-            driver.destroy();
-            widget.destroy();
-        },
-    };
-}
+export const createAvatar = character("tess", TESS_GLB);
 //# sourceMappingURL=tess.js.map

package/dist/three/tess.js.map

@@ -1 +1 @@
-{"version":3,"file":"tess.js","sourceRoot":"","sources":["../../client/three/tess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAkB3D;2DAC2D;AAC3D,MAAM,CAAC,MAAM,QAAQ,GAAG,gBAAgB,CAAC;AAEzC,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACrD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;IACrE,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAEvE,MAAM,UAAU,GAAmB,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAC9D,6EAA6E;IAC7E,+DAA+D;IAC/D,MAAM,MAAM,GAAG,eAAe,CAAC;QAC7B,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK;QAClD,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,WAAW;QACtE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK;KACrC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAErC,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"}
+{"version":3,"file":"tess.js","sourceRoot":"","sources":["../../client/three/tess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAK3C;kDACkD;AAClD,MAAM,CAAC,MAAM,QAAQ,GAAG,gBAAgB,CAAC;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC"}

package/dist/three/tushar.d.ts

@@ -1,31 +1,22 @@
 /**
- * tushar — the second 3-D character, and deliberately a copy of `tara.ts`.
+ * tushar — the second 3-D character, and the one who proved the factory.
  *
- * His GLB is tara's scripts run with his landmarks and atlas layout in place of
- * hers (`characters/tushar/`, whose README has the provenance and the commands),
- * so the rig, the mixer, the sequences and her tuning are all hers, unmodified;
- * the one seam is `TaraRigOptions.url`. What turns out to be hers rather than
- * general is marked TARA-SPECIFIC where it lives, and generalised only once a
- * third character agrees.
+ * His GLB is the shared scripts run with his landmarks and atlas layout in
+ * place of tara's (`characters/tushar/`, whose README has the provenance and
+ * the commands). He was a deliberate copy of `tara.ts` for as long as there was
+ * a `tara.ts` to copy; since 2026-09-23 there is one Blender entry point and he
+ * is its second caller rather than her second draft (`createCharacter.ts`).
+ *
+ * He is also the face that turned the ledger from a question into a decision.
+ * What was marked TARA-SPECIFIC was marked that way because one face cannot
+ * tell a convention from a coincidence; he agreed with her, and so did the two
+ * after him.
  */
-import type { PipecatClient } from "@pipecat-ai/client-js";
-export interface AvatarOptions {
-    readonly mount: HTMLElement;
-    readonly client: PipecatClient;
-    /** Viseme amplitude, 0..2. `1` is as authored. */
-    readonly mouthGain?: number;
-    /** Gesture-clip amplitude, 0..2. */
-    readonly gestureGain?: number;
-    /** Idle/liveness amplitude, 0..2. */
-    readonly motionGain?: number;
-    /** Fires when the GLB is in the scene — for a capture tool, not a consumer. */
-    readonly onReady?: () => void;
-}
-export interface AvatarInstance {
-    destroy(): void;
-}
-/** The optional driving-UI declaration; one list for all three characters
+import type { CharacterAvatarOptions } from "./createCharacter.js";
+export type { CharacterAvatarOptions as AvatarOptions };
+export type { AvatarInstance } from "./createCharacter.js";
+/** The optional driving-UI declaration; one list for every Blender character
  *  (`sequences.ts`), because they are one rig. */
 export declare const supports: import("../createAvatar.js").AvatarSupport;
-export declare function createAvatar(options: AvatarOptions): AvatarInstance;
+export declare const createAvatar: import("../createAvatar.js").AvatarFactory<CharacterAvatarOptions>;
 //# sourceMappingURL=tushar.d.ts.map

package/dist/three/tushar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tushar.d.ts","sourceRoot":"","sources":["../../client/three/tushar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAQ3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAAG,OAAO,IAAI,IAAI,CAAC;CAAE;AAEpD;kDACkD;AAClD,eAAO,MAAM,QAAQ,4CAAmB,CAAC;AAEzC,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CA0BnE"}
+{"version":3,"file":"tushar.d.ts","sourceRoot":"","sources":["../../client/three/tushar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAInE,YAAY,EAAE,sBAAsB,IAAI,aAAa,EAAE,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;kDACkD;AAClD,eAAO,MAAM,QAAQ,4CAAmB,CAAC;AAEzC,eAAO,MAAM,YAAY,oEAAkC,CAAC"}

package/dist/three/tushar.js

@@ -1,47 +1,22 @@
 /**
- * tushar — the second 3-D character, and deliberately a copy of `tara.ts`.
+ * tushar — the second 3-D character, and the one who proved the factory.
  *
- * His GLB is tara's scripts run with his landmarks and atlas layout in place of
- * hers (`characters/tushar/`, whose README has the provenance and the commands),
- * so the rig, the mixer, the sequences and her tuning are all hers, unmodified;
- * the one seam is `TaraRigOptions.url`. What turns out to be hers rather than
- * general is marked TARA-SPECIFIC where it lives, and generalised only once a
- * third character agrees.
+ * His GLB is the shared scripts run with his landmarks and atlas layout in
+ * place of tara's (`characters/tushar/`, whose README has the provenance and
+ * the commands). He was a deliberate copy of `tara.ts` for as long as there was
+ * a `tara.ts` to copy; since 2026-09-23 there is one Blender entry point and he
+ * is its second caller rather than her second draft (`createCharacter.ts`).
+ *
+ * He is also the face that turned the ledger from a question into a decision.
+ * What was marked TARA-SPECIFIC was marked that way because one face cannot
+ * tell a convention from a coincidence; he agreed with her, and so did the two
+ * after him.
  */
-import { AvatarClient, createSvgAvatar } from "../internal.js";
+import { character } from "./createCharacter.js";
+import { BLENDER_SUPPORTS } from "./sequences.js";
 import { TUSHAR_GLB } from "./tushar-asset.js";
-import { BLENDER_ACTIONS, BLENDER_SEQUENCES, BLENDER_SUPPORTS } from "./sequences.js";
-import { headHold } from "./holds.js";
-import { createTaraRig, TARA_TUNING } from "./tara-rig.js";
-/** The optional driving-UI declaration; one list for all three characters
+/** The optional driving-UI declaration; one list for every Blender character
  *  (`sequences.ts`), because they are one rig. */
 export const supports = BLENDER_SUPPORTS;
-export function createAvatar(options) {
-    const { mount, client, onReady, ...gains } = options;
-    if (!mount)
-        throw new TypeError("createAvatar: `mount` is required");
-    if (!client)
-        throw new TypeError("createAvatar: `client` is required");
-    const rigOptions = { onReady, url: TUSHAR_GLB };
-    // TARA-SPECIFIC, kept on purpose: `TARA_TUNING` (her mouth and motion gains)
-    // is the first thing to question if he reads wrong in a call.
-    const widget = createSvgAvatar({
-        mount, rig: createTaraRig, rigOptions, hand: false,
-        sequences: BLENDER_SEQUENCES, actions: BLENDER_ACTIONS, ...TARA_TUNING,
-        headHold: headHold("tushar"), ...gains,
-    });
-    const driver = new AvatarClient(widget);
-    const detach = driver.attach(client);
-    let destroyed = false;
-    return {
-        destroy() {
-            if (destroyed)
-                return;
-            destroyed = true;
-            detach();
-            driver.destroy();
-            widget.destroy();
-        },
-    };
-}
+export const createAvatar = character("tushar", TUSHAR_GLB);
 //# sourceMappingURL=tushar.js.map

package/dist/three/tushar.js.map

@@ -1 +1 @@
-{"version":3,"file":"tushar.js","sourceRoot":"","sources":["../../client/three/tushar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAkB3D;kDACkD;AAClD,MAAM,CAAC,MAAM,QAAQ,GAAG,gBAAgB,CAAC;AAEzC,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACrD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;IACrE,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAEvE,MAAM,UAAU,GAAmB,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;IAChE,6EAA6E;IAC7E,8DAA8D;IAC9D,MAAM,MAAM,GAAG,eAAe,CAAC;QAC7B,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK;QAClD,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,WAAW;QACtE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,KAAK;KACvC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAErC,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"}
+{"version":3,"file":"tushar.js","sourceRoot":"","sources":["../../client/three/tushar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAK/C;kDACkD;AAClD,MAAM,CAAC,MAAM,QAAQ,GAAG,gBAAgB,CAAC;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@voqalize/avatar",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "A JavaScript-programmable talking head for AI voice calls: line-art or 2.5-D faces, server-synced lipsync, state through motion, no runtime dependencies.",
-  "license": "MIT AND CC-BY-4.0",
+  "license": "MIT AND CC-BY-4.0 AND Apache-2.0",
   "author": "Voqalize",
   "homepage": "https://github.com/voqalize/avatar#readme",
   "repository": {
@@ -81,53 +81,9 @@
       "types": "./dist/three/tess.d.ts",
       "default": "./dist/three/tess.js"
     },
-    "./avatars/arjun": {
-      "types": "./dist/arjun.d.ts",
-      "default": "./dist/arjun.js"
-    },
-    "./avatars/meera": {
-      "types": "./dist/meera.d.ts",
-      "default": "./dist/meera.js"
-    },
-    "./avatars/vikram": {
-      "types": "./dist/vikram.d.ts",
-      "default": "./dist/vikram.js"
-    },
-    "./avatars/ishita": {
-      "types": "./dist/ishita.d.ts",
-      "default": "./dist/ishita.js"
-    },
-    "./avatars/kabir": {
-      "types": "./dist/kabir.d.ts",
-      "default": "./dist/kabir.js"
-    },
-    "./avatars/naina": {
-      "types": "./dist/naina.d.ts",
-      "default": "./dist/naina.js"
-    },
-    "./avatars/interviewer-male": {
-      "types": "./dist/interviewer-male.d.ts",
-      "default": "./dist/interviewer-male.js"
-    },
-    "./avatars/interviewer-female": {
-      "types": "./dist/interviewer-female.d.ts",
-      "default": "./dist/interviewer-female.js"
-    },
-    "./avatars/professional-male-a": {
-      "types": "./dist/professional-male-a.d.ts",
-      "default": "./dist/professional-male-a.js"
-    },
-    "./avatars/professional-female-a": {
-      "types": "./dist/professional-female-a.d.ts",
-      "default": "./dist/professional-female-a.js"
-    },
-    "./avatars/professional-male-b": {
-      "types": "./dist/professional-male-b.d.ts",
-      "default": "./dist/professional-male-b.js"
-    },
-    "./avatars/professional-female-b": {
-      "types": "./dist/professional-female-b.d.ts",
-      "default": "./dist/professional-female-b.js"
+    "./avatars/tanvi": {
+      "types": "./dist/three/tanvi.d.ts",
+      "default": "./dist/three/tanvi.js"
     },
     "./package.json": "./package.json"
   },
@@ -136,7 +92,8 @@
     "client",
     "dist",
     "assets",
-    "LICENSE-CC-BY-4.0"
+    "LICENSE-CC-BY-4.0",
+    "LICENSE-APACHE-2.0"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/src/avatar.d.ts

@@ -364,6 +364,8 @@ export const AZURE_VISEME_TO_LETTER: Readonly<Record<number, VisemeLetter>>;
 export const SILENT: VisemeLetter;
 /** Pose channels for one letter at `intensity` (0..1), ready to merge into a frame. */
 export function shapeFor(letter: VisemeLetter, intensity?: number): PoseOverrides;
+/** `jaw` per unit of `mouthOpen`, the ratio the mouth's interior is calibrated at. */
+export const JAW_OF_OPEN: number;
 
 /**
  * The mouth clock. Someone has to turn a cue array plus a clock into "which