@diffenderfer-games/hub 2.0.0-next.5 → 2.0.0-next.6

package/dist/shared/animator.d.ts

@@ -0,0 +1,104 @@
+import { _ as FaceParams, a as LookDir, c as Pose, h as Expression, n as BodyPose, o as LookLike, s as Point, u as StatusProp } from "./types.js";
+//#region src/avatar/animator/reactions.d.ts
+/** A reaction name. */
+type Reaction = 'nod' | 'shake' | 'bounce' | 'cheer' | 'gasp' | 'flinch' | 'shrug' | 'sleep' | 'wave';
+/** What a reaction adds at a moment. */
+interface ReactionFrame {
+  readonly bob: Point;
+  readonly tilt: number;
+  readonly squash: number;
+}
+/** A reaction's track. */
+interface ReactionTrack {
+  readonly ms: number;
+  readonly expression?: Expression;
+  readonly body?: BodyPose;
+  readonly at: (u: number) => ReactionFrame;
+}
+/** Every reaction's track; `u` runs 0 … 1 over `ms`. */
+declare const REACTIONS: Readonly<Record<Reaction, ReactionTrack>>;
+//#endregion
+//#region src/avatar/animator/animator.d.ts
+/** Options for {@link animator}. */
+interface AnimatorOptions {
+  /** Seeds blinks and idle motion (a user id is ideal). */
+  readonly seed?: string | number;
+  /** `'auto'` reads `prefers-reduced-motion`; `true` forces it. */
+  readonly reducedMotion?: 'auto' | boolean;
+  /** Idle bob, sway, wandering gaze and micro expressions (default on). */
+  readonly idle?: boolean;
+  /** The resting expression (default `neutral`). */
+  readonly base?: Expression;
+  /** The time source for calls without `at` (default `performance.now()`). */
+  readonly clock?: () => number;
+}
+/** When a call happens; defaults to the animator's clock. */
+interface At {
+  readonly at?: number;
+}
+/** Game events mapped to tuned faces, so every game feels the same. */
+type Feeling = 'win' | 'lose' | 'bigPlay' | 'victim' | 'waiting' | 'yourTurn' | 'idle';
+/** A face and body driver for one avatar. */
+declare class Animator {
+  /** Reduced motion: no idle bob, sway or reaction movement; quick cross-fades; a static open mouth when talking. */
+  readonly reducedMotion: boolean;
+  private readonly seed;
+  private readonly idle;
+  private readonly clock;
+  private readonly bases;
+  private readonly expresses;
+  private readonly looks;
+  private readonly talks;
+  private readonly reacts;
+  private readonly bodies;
+  private readonly statuses;
+  private current;
+  constructor(look: LookLike, opts?: AnimatorOptions);
+  /** The look this animator drives (adapters render it with each pose). */
+  get look(): LookLike;
+  /** Swaps the look (an `ev:avatar` change) without resetting the schedule. */
+  setLook(look: LookLike): this;
+  private now;
+  private fade;
+  /** Shows an expression (or raw parameters), then returns to the base. */
+  express(e: Expression | FaceParams, o?: At & {
+    readonly fadeMs?: number;
+    readonly holdMs?: number;
+  }): this;
+  /** Sets the resting expression. */
+  setBase(e: Expression | FaceParams, o?: At & {
+    readonly fadeMs?: number;
+  }): this;
+  /** Eases the gaze toward a direction; `null` goes back to wandering (or the centre with `idle: false`). */
+  lookAt(target: LookDir | null, o?: At & {
+    readonly speed?: number;
+  }): this;
+  /** Flaps the mouth until `talk(false)`. */
+  talk(isOn: boolean, o?: At): this;
+  /** Talks for a duration. */
+  talkFor(ms: number, o?: At): this;
+  /** Drives the mouth from audio amplitude (0 … 1). */
+  talkLevel(level: number, o?: At): this;
+  /** Plays a one-shot reaction. */
+  react(reaction: Reaction, o?: At): this;
+  /** Sets the body pose; cycle poses (`walk`, `run`, `dance`) loop every `cycleMs`. */
+  setBody(body: BodyPose, o?: At & {
+    readonly cycleMs?: number;
+  }): this;
+  /** Sets or clears the status prop. */
+  setStatus(status: StatusProp | null, o?: At): this;
+  /** Plays the tuned face and reaction for a game event. */
+  feel(feeling: Feeling, o?: At): this;
+  private faceAt;
+  private gazeAt;
+  private approach;
+  private talkAt;
+  private reactionAt;
+  /** The pose at time `t` (same clock as the calls). Pure: the same schedule and `t` give the same pose. */
+  pose(t?: number): Pose;
+}
+/** A new animator for a look: `animator(look, { seed: userId })`. */
+declare function animator(look: LookLike, opts?: AnimatorOptions): Animator;
+//#endregion
+export { animator as a, Feeling as i, AnimatorOptions as n, REACTIONS as o, At as r, Reaction as s, Animator as t };
+//# sourceMappingURL=animator.d.ts.map

package/dist/shared/animator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animator.d.ts","names":[],"sources":["../../src/avatar/animator/reactions.ts","../../src/avatar/animator/animator.ts"],"mappings":";;;KASY;;UAGK;WACN,KAAK;WACL;WACA;;;UAIM;WACN;WACA,aAAa;WACb,OAAO;WACP,KAAK,cAAc;;;cAOjB,WAAW,SAAS,OAAO,UAAU;;;;UChBjC;;WAEN;;WAEA;;WAEA;;WAEA,OAAO;;WAEP;;;UAIM;WACN;;;KAIC;;cAkCC;;WAEF;mBACQ;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;UACT;EAEI,YAAA,MAAM,UAAU,OAAM;;MAU9B,QAAQ;;EAKZ,QAAQ,MAAM;UAKN;UAIA;;EAKR,QAAQ,GAAG,aAAa,YAAY,IAAG;aAAgB;aAA0B;;;EAMjF,QAAQ,GAAG,aAAa,YAAY,IAAG;aAAgB;;;EAMvD,OAAO,QAAQ,gBAAgB,IAAG;aAAgB;;;EAMlD,KAAK,eAAe,IAAG;;EAOvB,QAAQ,YAAY,IAAG;;EAOvB,UAAU,eAAe,IAAG;;EAM5B,MAAM,UAAU,UAAU,IAAG;;EAM7B,QAAQ,MAAM,UAAU,IAAG;aAAgB;;;EAM3C,UAAU,QAAQ,mBAAmB,IAAG;;EAMxC,KAAK,SAAS,SAAS,IAAG;UAalB;UA2BA;UAmBA;UAMA;UAYA;;EAcR,KAAK,aAA2B;;;iBAwBlB,SAAS,MAAM,UAAU,OAAM,kBAAuB"}