mochi-avatar 1.0.0

package/dist/core/spring.js

@@ -0,0 +1,68 @@
+/**
+ * A second-order spring.
+ *
+ * The reason this exists rather than the one-pole filter used elsewhere: a
+ * first-order system approaches its target and stops. It CANNOT overshoot, and
+ * overshoot is what reads as mass. A mochi that gets squashed should wobble
+ * past centre and settle; one that eases back looks like a scaling picture.
+ *
+ * Pure arithmetic, no clock. The caller owns time, which is what lets the same
+ * code run in a render loop and in a test that advances a number.
+ */
+export const DEFAULT_SPRING = { stiffness: 190, damping: 20 };
+/**
+ * Longest step the integrator will take, in seconds.
+ *
+ * Semi-implicit Euler is only conditionally stable: past roughly 2/sqrt(k) the
+ * correction overshoots further than the error it was correcting and the value
+ * diverges to infinity within a few frames. A backgrounded window, a breakpoint
+ * or a laptop waking from sleep all deliver exactly that -- a dt of seconds.
+ *
+ * Clamping means a long gap is under-integrated (she resumes from where she
+ * was, a little behind) rather than exploding. Under-integration is invisible;
+ * divergence paints a mochi the size of the screen and then NaN, after which
+ * every subsequent frame is blank with nothing in the log to say why.
+ */
+export const MAX_STEP_SECONDS = 1 / 30;
+export class Spring {
+    position;
+    velocity = 0;
+    constructor(initial = 0) {
+        this.position = Number.isFinite(initial) ? initial : 0;
+    }
+    /** The current value, without advancing time. */
+    get value() {
+        return this.position;
+    }
+    /**
+     * Advance by `dtSeconds` toward `target` and return the new value.
+     *
+     * Non-finite inputs are ignored rather than propagated: one NaN reaching the
+     * velocity would poison the spring permanently, and the symptom -- she simply
+     * stops moving, forever, from an arbitrary later frame -- points nowhere near
+     * the frame that caused it.
+     */
+    step(dtSeconds, target, config = DEFAULT_SPRING) {
+        if (!Number.isFinite(dtSeconds) || dtSeconds <= 0)
+            return this.position;
+        if (!Number.isFinite(target))
+            return this.position;
+        const dt = Math.min(dtSeconds, MAX_STEP_SECONDS);
+        const acceleration = -config.stiffness * (this.position - target) - config.damping * this.velocity;
+        this.velocity += acceleration * dt;
+        this.position += this.velocity * dt;
+        return this.position;
+    }
+    /** Jump to a value and kill the velocity. For teleports, not for animation. */
+    snap(value) {
+        if (!Number.isFinite(value))
+            return;
+        this.position = value;
+        this.velocity = 0;
+    }
+    /** True once the spring has effectively stopped, so a caller can skip work. */
+    isAtRest(target, epsilon = 1e-3) {
+        return Math.abs(this.position - target) < epsilon && Math.abs(this.velocity) < epsilon;
+    }
+}
+//# sourceMappingURL=spring.js.map

package/dist/core/spring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring.js","sourceRoot":"","sources":["../../src/core/spring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,MAAM,CAAC,MAAM,cAAc,GAAiB,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;AAE3E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,CAAA;AAEtC,MAAM,OAAO,MAAM;IACT,QAAQ,CAAQ;IAChB,QAAQ,GAAG,CAAC,CAAA;IAEpB,YAAY,OAAO,GAAG,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;IACxD,CAAC;IAED,iDAAiD;IACjD,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,SAAiB,EAAE,MAAc,EAAE,MAAM,GAAiB,cAAc;QAC3E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAA;QACvE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAA;QAElD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA;QAChD,MAAM,YAAY,GAChB,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAA;QAE/E,IAAI,CAAC,QAAQ,IAAI,YAAY,GAAG,EAAE,CAAA;QAClC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAA;QACnC,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED,+EAA+E;IAC/E,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAM;QACnC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;QACrB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;IACnB,CAAC;IAED,+EAA+E;IAC/E,QAAQ,CAAC,MAAc,EAAE,OAAO,GAAG,IAAI;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAA;IACxF,CAAC;CACF"}

package/dist/core/vocabulary.d.ts

@@ -0,0 +1,182 @@
+/**
+ * The rendering contract.
+ *
+ * Implementations live in the renderer. There is exactly one, and the enum says
+ * so: a value nothing will ever return is a promise the type system keeps
+ * forcing call sites to honour. mochi used that argument to refuse a `live2d`
+ * member, then shipped a `vrm` one with no VRM backend behind it -- and this
+ * file inherited it. Removed. It comes back the day something returns it.
+ *
+ * There is no `placeholder` member either, and that absence is the decision.
+ * In the previous codebase the placeholder outlived the "real"
+ * backend it stood in for, because a third-party VRM cannot be redistributed
+ * and so no model ever shipped. A stand-in that is the only thing anyone ever
+ * sees is not a stand-in; naming it `mochi` is what stops it being treated as
+ * disposable.
+ */
+export type AvatarKind = 'mochi';
+/**
+ * The canonical emotion list.
+ *
+ * A tuple, not a bare union, because the tool schema in voice.ts needs the same
+ * values at runtime. Deriving both from here means adding an emotion cannot
+ * leave the schema stale -- which a hand-written array plus `satisfies` would
+ * allow, since `satisfies` rejects wrong entries but never notices missing ones.
+ */
+export declare const EMOTIONS: readonly ['neutral', 'happy', 'shy', 'sad', 'angry', 'surprised', 'thinking', 'sleepy'];
+export type Emotion = (typeof EMOTIONS)[number];
+/**
+ * The canonical viseme set: VRM 1.0's five vowel presets.
+ *
+ * A tuple for the same reason EMOTIONS is one -- both the avatar contract and
+ * the provider's VisemeFrame need these values, and a bare string union would
+ * let a provider emit `ah` or `A` and have it silently ignored while every
+ * capability flag still claimed the precise lip-sync path was working.
+ *
+ * Consonants are deliberately absent. VRM defines no consonant presets, and
+ * inventing some would produce a set no model can render.
+ */
+declare const VISEMES: readonly ['aa', 'ih', 'ou', 'ee', 'oh'];
+export type Viseme = (typeof VISEMES)[number];
+/** A complete snapshot. Coarticulation genuinely overlaps vowels, so these do not sum to 1. */
+export type VisemeWeights = Readonly<Record<Viseme, number>>;
+export interface EmotionSignal {
+    readonly emotion: Emotion;
+    /** 0..1, normalised through clamp01 -- non-finite becomes 0. */
+    readonly intensity: number;
+    /**
+     * Drift back to neutral after this many milliseconds. Finite and >= 0.
+     * Omitted means hold until the next signal.
+     *
+     * Each setEmotion() supersedes any pending reset, so a newer signal is never
+     * cut short by an older signal's timer.
+     */
+    readonly holdMs?: number;
+}
+/** Clamp to 0..1 with an explicit non-finite policy, so every backend agrees. */
+export declare function clamp01(value: number): number;
+/**
+ * Clamp to -1..1, for a signed OFFSET rather than a magnitude.
+ *
+ * Beside `clamp01` and deliberately not derived from it: the two answer
+ * different questions, and using the 0..1 one on a position is the whole of the
+ * gaze bug `AvatarBackend.lookAt` describes — centre came out as the top-left
+ * corner and half the input range collapsed onto it.
+ *
+ * Non-finite returns 0 here, which is CENTRE for a signed offset. Callers that
+ * must not move on a bad sample check finiteness before calling, as `lookAt`
+ * does; this is the floor rather than that policy.
+ */
+export declare function clampSigned(value: number): number;
+/**
+ * Differences a call site would otherwise have to branch on. Nothing goes in
+ * here speculatively -- each field marks a divergence that is already known.
+ *
+ * These describe the BACKEND, not whichever model happens to be loaded.
+ */
+export interface AvatarBackendCaps {
+    /** Fixed expression names the format defines (VRM's Joy/Angry/...). */
+    readonly presetExpressions: boolean;
+    /** Arbitrary expression identifiers authored into the model. */
+    readonly customExpressions: boolean;
+    /** Whether load() can return non-null licence metadata. */
+    readonly licenseMetadata: boolean;
+    /** Whether the backend can run physics at all; a given model may still carry none. */
+    readonly supportsPhysics: boolean;
+    /** Whether playMotion() does anything. A backend with no motion library reports false. */
+    readonly supportsMotions: boolean;
+    /**
+     * Whether setVisemes() can drive anything at all.
+     *
+     * Independent of the provider's caps.phonemeTimings: timings are useless
+     * without a backend that can render them, and a backend that can render them
+     * sits idle behind a provider that emits none.
+     */
+    readonly visemes: boolean;
+}
+/**
+ * Milliseconds from a monotonic clock with the animation-frame time origin --
+ * i.e. what requestAnimationFrame passes and performance.now() returns. Never
+ * Date.now(), which can jump backwards.
+ */
+export type MonotonicMs = number;
+export interface AvatarBackend {
+    readonly kind: AvatarKind;
+    readonly caps: AvatarBackendCaps;
+    /**
+     * 0 = closed, 1 = fully open. Called every frame. Non-finite input is
+     * treated as 0 (see clamp01) rather than left to each backend to invent.
+     *
+     * The coarse path, and the only one available behind cloud
+     * speech-to-speech: an audio stream carries no phoneme timings, so the RMS
+     * envelope is not a shortcut there.
+     *
+     * Supersedes any viseme weights still applied. The two paths write the same
+     * mouth, so the last caller wins outright rather than blending -- a provider
+     * switch mid-session must not leave a stale vowel held open underneath.
+     */
+    setMouthOpen(value: number): void;
+    /**
+     * The precise path: a complete weight per canonical viseme, each clamped
+     * through clamp01.
+     *
+     * Total rather than partial: an omitted key would have to mean either "hold
+     * the previous value" or "zero", and a caller cannot tell which from the
+     * type. No-op when caps.visemes is false.
+     */
+    setVisemes(weights: VisemeWeights): void;
+    setEmotion(signal: EmotionSignal): void;
+    /** No-op when caps.supportsMotions is false. */
+    playMotion(name: string): void;
+    /**
+     * Gaze target as a SIGNED offset from centre: -1..1 on each axis, origin in
+     * the middle. Finite values are clamped to that range.
+     *
+     * ## The range is -1..1 because that is what every caller has always sent
+     *
+     * This said 0..1 with the origin at the top-left, and `MochiAvatar.lookAt`
+     * implemented it — `(clamp01(n) - 0.5) * 2` — while `face.ts` passed
+     * `(clientX / width) * 2 - 1` from every `mousemove`, `lookAt(0, 0)` to
+     * recentre on `mouseleave`, and `lookAt(0.35, -0.5)` for the thinking pose.
+     *
+     * Measured against the implementation, the whole left and top half of the
+     * pointer range collapsed onto one point:
+     *
+     * | caller meant | backend stored |
+     * | --- | --- |
+     * | centre `0` | **-1** — hard up-left |
+     * | left edge `-1` | -1, identical to centre |
+     * | right edge `1` | 1 |
+     *
+     * So she tracked the cursor only across the right and bottom half, and the
+     * `mouseleave` recentre — whose entire job is to put her eyes back to the
+     * middle — pinned them to the corner instead.
+     *
+     * The interface moved rather than the callers, because -1..1 is what the rest
+     * of the backend already used: `setAsleep` and the reset path both assign
+     * `gazeTarget = { x: 0, y: 0 }` DIRECTLY and mean centre by it, and the
+     * per-frame sum adds `look.gazeX` offsets that are signed. 0..1 was the only
+     * dissenting statement, and it was in the one place nothing executed.
+     *
+     * A non-finite coordinate leaves the previous target in place rather than
+     * being coerced to 0 -- clamp01's policy is right for a magnitude like mouth
+     * openness, but applying it to a position would snap her gaze to the corner
+     * on a single bad sample.
+     */
+    lookAt(nx: number, ny: number): void;
+    /** Idle animation: breathing, blinking, micro-motion. All of it stops when off. */
+    setIdle(on: boolean): void;
+    /**
+     * Is this point on the avatar? CSS pixels from the window's top-left.
+     *
+     * Drives per-region click-through, so it must agree with what is actually
+     * drawn. A backend that reports hits on pixels it does not paint makes the
+     * window swallow clicks over apparently empty space.
+     */
+    hitTest(x: number, y: number): boolean;
+    render(now: MonotonicMs): void;
+    /** Idempotent. Clears what was drawn and stops responding to hit tests. */
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=vocabulary.d.ts.map

package/dist/core/vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../../src/core/vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAA;AAEhC;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,YACnB,SAAS,EACT,OAAO,EACP,KAAK,EACL,KAAK,EACL,OAAO,EACP,WAAW,EACX,UAAU,EACV,QAAQ,CACA,CAAA;AAEV,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/C;;;;;;;;;;GAUG;AACH,QAAA,MAAM,OAAO,YAAI,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAA;AAEvD,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7C,+FAA+F;AAC/F,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAE5D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,iFAAiF;AACjF,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAA;IACnC,gEAAgE;IAChE,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAA;IACnC,2DAA2D;IAC3D,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC,sFAAsF;IACtF,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC,0FAA0F;IAC1F,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAA;AAEhC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;IAEhC;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAEjC;;;;;;;OAOG;IACH,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;IAExC,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IAEvC,gDAAgD;IAChD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IAEpC,mFAAmF;IACnF,OAAO,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAA;IAE1B;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IAEtC,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAA;IAE9B,2EAA2E;IAC3E,OAAO,IAAI,IAAI,CAAA;CAChB"}

package/dist/core/vocabulary.js

@@ -0,0 +1,66 @@
+/**
+ * The rendering contract.
+ *
+ * Implementations live in the renderer. There is exactly one, and the enum says
+ * so: a value nothing will ever return is a promise the type system keeps
+ * forcing call sites to honour. mochi used that argument to refuse a `live2d`
+ * member, then shipped a `vrm` one with no VRM backend behind it -- and this
+ * file inherited it. Removed. It comes back the day something returns it.
+ *
+ * There is no `placeholder` member either, and that absence is the decision.
+ * In the previous codebase the placeholder outlived the "real"
+ * backend it stood in for, because a third-party VRM cannot be redistributed
+ * and so no model ever shipped. A stand-in that is the only thing anyone ever
+ * sees is not a stand-in; naming it `mochi` is what stops it being treated as
+ * disposable.
+ */
+/**
+ * The canonical emotion list.
+ *
+ * A tuple, not a bare union, because the tool schema in voice.ts needs the same
+ * values at runtime. Deriving both from here means adding an emotion cannot
+ * leave the schema stale -- which a hand-written array plus `satisfies` would
+ * allow, since `satisfies` rejects wrong entries but never notices missing ones.
+ */
+export const EMOTIONS = [
+    'neutral',
+    'happy',
+    'shy',
+    'sad',
+    'angry',
+    'surprised',
+    'thinking',
+    'sleepy',
+];
+/**
+ * The canonical viseme set: VRM 1.0's five vowel presets.
+ *
+ * A tuple for the same reason EMOTIONS is one -- both the avatar contract and
+ * the provider's VisemeFrame need these values, and a bare string union would
+ * let a provider emit `ah` or `A` and have it silently ignored while every
+ * capability flag still claimed the precise lip-sync path was working.
+ *
+ * Consonants are deliberately absent. VRM defines no consonant presets, and
+ * inventing some would produce a set no model can render.
+ */
+const VISEMES = ['aa', 'ih', 'ou', 'ee', 'oh'];
+/** Clamp to 0..1 with an explicit non-finite policy, so every backend agrees. */
+export function clamp01(value) {
+    return Number.isFinite(value) ? Math.min(1, Math.max(0, value)) : 0;
+}
+/**
+ * Clamp to -1..1, for a signed OFFSET rather than a magnitude.
+ *
+ * Beside `clamp01` and deliberately not derived from it: the two answer
+ * different questions, and using the 0..1 one on a position is the whole of the
+ * gaze bug `AvatarBackend.lookAt` describes — centre came out as the top-left
+ * corner and half the input range collapsed onto it.
+ *
+ * Non-finite returns 0 here, which is CENTRE for a signed offset. Callers that
+ * must not move on a bad sample check finiteness before calling, as `lookAt`
+ * does; this is the floor rather than that policy.
+ */
+export function clampSigned(value) {
+    return Number.isFinite(value) ? Math.min(1, Math.max(-1, value)) : 0;
+}
+//# sourceMappingURL=vocabulary.js.map

package/dist/core/vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.js","sourceRoot":"","sources":["../../src/core/vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,SAAS;IACT,OAAO;IACP,KAAK;IACL,KAAK;IACL,OAAO;IACP,WAAW;IACX,UAAU;IACV,QAAQ;CACA,CAAA;AAIV;;;;;;;;;;GAUG;AACH,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAA;AAqBvD,iFAAiF;AACjF,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACrE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACtE,CAAC"}

package/dist/element/dough-avatar.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `<dough-avatar>` — the engine as a custom element.
+ *
+ * The point of this file is that using the character engine from a plain HTML
+ * page should not require a bundler, a framework, or knowing that a render loop
+ * exists. Everything below is the boilerplate a host would otherwise write:
+ * a canvas sized to the element at device resolution, a rAF loop that stops
+ * when the element leaves the document, and attributes wired to the backend.
+ *
+ * **Browser only.** Importing this module evaluates `class ... extends
+ * HTMLElement`, which throws in a bare Node process — so it is a SEPARATE entry
+ * point (`@hando/dough/element`) that server-side code must not import. The
+ * core is meant to run under Node and does; this is not.
+ */
+import { type FaceSpec } from '../core/spec.js';
+export declare class DoughAvatarElement extends HTMLElement {
+    static observedAttributes: string[];
+    private canvas;
+    private avatar;
+    private frame;
+    private observer;
+    private face;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string): void;
+    /** The face, as a `FaceSpec`. Set this instead of the attribute when you have one. */
+    set faceSpec(face: FaceSpec | undefined);
+    get faceSpec(): FaceSpec | undefined;
+    private applyFace;
+    private applyEmotion;
+    private applySize;
+    private fitToElement;
+}
+//# sourceMappingURL=dough-avatar.d.ts.map

package/dist/element/dough-avatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dough-avatar.d.ts","sourceRoot":"","sources":["../../src/element/dough-avatar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAmB9D,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,MAAM,CAAC,kBAAkB,WAA8B;IAEvD,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,IAAI,CAAsB;IAElC,iBAAiB,IAAI,IAAI,CAsDxB;IAED,oBAAoB,IAAI,IAAI,CAS3B;IAED,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAO3C;IAED,sFAAsF;IACtF,IAAI,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,EAQtC;IAED,IAAI,QAAQ,IAAI,QAAQ,GAAG,SAAS,CAEnC;IAED,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,YAAY;CA2BrB"}

package/dist/element/dough-avatar.js

@@ -0,0 +1,189 @@
+/**
+ * `<dough-avatar>` — the engine as a custom element.
+ *
+ * The point of this file is that using the character engine from a plain HTML
+ * page should not require a bundler, a framework, or knowing that a render loop
+ * exists. Everything below is the boilerplate a host would otherwise write:
+ * a canvas sized to the element at device resolution, a rAF loop that stops
+ * when the element leaves the document, and attributes wired to the backend.
+ *
+ * **Browser only.** Importing this module evaluates `class ... extends
+ * HTMLElement`, which throws in a bare Node process — so it is a SEPARATE entry
+ * point (`@hando/dough/element`) that server-side code must not import. The
+ * core is meant to run under Node and does; this is not.
+ */
+import { DoughAvatar } from '../canvas2d/avatar.js';
+import { parseFaceSpec } from '../core/spec.js';
+import { PLAIN } from '../core/plain.js';
+import { EMOTIONS } from '../core/vocabulary.js';
+function isEmotion(value) {
+    return value !== null && EMOTIONS.includes(value);
+}
+/**
+ * `size`, as the backend takes it: a percentage, or the string that means
+ * "fill whatever canvas you were given". Anything unparseable is the latter,
+ * which is also what an absent attribute means.
+ */
+function sizeFrom(raw) {
+    if (raw === null || raw.trim() === '' || raw.trim() === 'fit-canvas')
+        return 'fit-canvas';
+    const percent = Number(raw);
+    return Number.isFinite(percent) ? percent : 'fit-canvas';
+}
+export class DoughAvatarElement extends HTMLElement {
+    static observedAttributes = ['emotion', 'size', 'face'];
+    canvas = null;
+    avatar = null;
+    frame = 0;
+    observer = null;
+    face;
+    connectedCallback() {
+        /*
+          Capabilities FIRST, before anything is created or appended.
+    
+          Checked up front rather than discovered halfway through: initialising in
+          order meant a missing `ResizeObserver` threw after the avatar existed and
+          a missing `requestAnimationFrame` threw after the observer was attached,
+          each leaving a half-built element with no teardown path. Nothing is built
+          until everything needed to tear it down is known to exist.
+        */
+        if (typeof ResizeObserver === 'undefined' ||
+            typeof requestAnimationFrame !== 'function' ||
+            typeof cancelAnimationFrame !== 'function') {
+            return;
+        }
+        if (this.canvas === null) {
+            const canvas = document.createElement('canvas');
+            canvas.style.width = '100%';
+            canvas.style.height = '100%';
+            canvas.style.display = 'block';
+            this.canvas = canvas;
+        }
+        // A 2D context can genuinely be refused — a lost GPU, or too many live
+        // canvases. Returning before the canvas is appended leaves the element
+        // empty rather than showing a blank rectangle that looks like a bug.
+        const ctx = this.canvas.getContext('2d');
+        if (ctx === null)
+            return;
+        if (this.style.display === '')
+            this.style.display = 'block';
+        if (!this.canvas.isConnected)
+            this.append(this.canvas);
+        this.avatar = new DoughAvatar(ctx, {
+            // Spread rather than `face: this.face`: under `exactOptionalPropertyTypes`
+            // an explicit `undefined` is not the same as an absent key, and the
+            // engine's default only applies to the absent one.
+            ...(this.face === undefined ? {} : { face: this.face }),
+            size: sizeFrom(this.getAttribute('size')),
+        });
+        this.applyEmotion();
+        this.fitToElement();
+        // Re-measure on layout change rather than on window resize: the element can be
+        // resized by its container without the window changing at all.
+        this.observer = new ResizeObserver(() => this.fitToElement());
+        this.observer.observe(this);
+        const tick = (now) => {
+            this.avatar?.render(now);
+            this.frame = requestAnimationFrame(tick);
+        };
+        this.frame = requestAnimationFrame(tick);
+    }
+    disconnectedCallback() {
+        // Both, and neither is optional: a live rAF loop keeps the element and its
+        // canvas reachable, so an element removed from the document would go on
+        // painting into a detached canvas forever.
+        if (typeof cancelAnimationFrame === 'function')
+            cancelAnimationFrame(this.frame);
+        this.frame = 0;
+        this.observer?.disconnect();
+        this.observer = null;
+        this.avatar = null;
+    }
+    attributeChangedCallback(name) {
+        // Read back through `getAttribute` rather than taking the new value: that
+        // makes removal — which arrives as null — the same code path as a change,
+        // and every one of these has a defined meaning for "absent".
+        if (name === 'emotion')
+            this.applyEmotion();
+        if (name === 'face')
+            this.applyFace();
+        if (name === 'size')
+            this.applySize();
+    }
+    /** The face, as a `FaceSpec`. Set this instead of the attribute when you have one. */
+    set faceSpec(face) {
+        this.face = face;
+        // Cleared means "back to the engine default", applied to the LIVE avatar
+        // too. Clearing only the stored copy left the current face on screen until
+        // the next reconnect, at which point it silently changed — the same input
+        // producing two different results depending on DOM history.
+        if (this.avatar === null)
+            return;
+        this.avatar.setFace(face ?? PLAIN);
+    }
+    get faceSpec() {
+        return this.face;
+    }
+    applyFace() {
+        const raw = this.getAttribute('face');
+        if (raw === null) {
+            this.faceSpec = undefined;
+            return;
+        }
+        let value;
+        try {
+            value = JSON.parse(raw);
+        }
+        catch {
+            // A malformed attribute leaves the current face alone rather than
+            // throwing inside a lifecycle callback, where nothing can catch it.
+            return;
+        }
+        const result = parseFaceSpec(value);
+        if (result.ok)
+            this.faceSpec = result.face;
+    }
+    applyEmotion() {
+        const wanted = this.getAttribute('emotion');
+        // Absent, or a word this engine does not have, both mean neutral. Leaving
+        // the previous emotion running would make `removeAttribute` do nothing.
+        this.avatar?.setEmotion({
+            emotion: isEmotion(wanted) ? wanted : 'neutral',
+            intensity: isEmotion(wanted) ? 1 : 0,
+        });
+    }
+    applySize() {
+        this.avatar?.setSizePercent(sizeFrom(this.getAttribute('size')));
+        this.fitToElement();
+    }
+    fitToElement() {
+        const canvas = this.canvas;
+        if (canvas === null || this.avatar === null)
+            return;
+        const rect = this.getBoundingClientRect();
+        if (rect.width === 0 || rect.height === 0)
+            return;
+        const ratio = window.devicePixelRatio || 1;
+        /*
+          The BACKING STORE, not only the geometry.
+    
+          `resize` tells the avatar how big she is in CSS pixels; nothing in the
+          engine touches `canvas.width`, because the engine does not own the canvas.
+          Without these two lines the bitmap stays at its 300x150 default forever —
+          a 200x200 element at ratio 2 asked for 400x400 and got a 300x150 buffer,
+          so she was drawn clipped and then stretched by the browser to fit.
+    
+          Assigned only on change: writing `canvas.width` clears the canvas and
+          resets the context state even when the value is identical, which would
+          throw away the frame on every single resize callback.
+        */
+        const width = Math.max(1, Math.round(rect.width * ratio));
+        const height = Math.max(1, Math.round(rect.height * ratio));
+        if (canvas.width !== width)
+            canvas.width = width;
+        if (canvas.height !== height)
+            canvas.height = height;
+        this.avatar.resize(rect.width, rect.height, ratio);
+    }
+}
+//# sourceMappingURL=dough-avatar.js.map

package/dist/element/dough-avatar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dough-avatar.js","sourceRoot":"","sources":["../../src/element/dough-avatar.ts"],"names":[],"mappings":"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"}

package/dist/element/index.d.ts

@@ -0,0 +1,3 @@
+export { DoughAvatarElement } from './dough-avatar.js';
+export declare function defineDoughAvatar(tag?: string): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/element/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/element/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAatD,wBAAgB,iBAAiB,CAAC,GAAG,SAAiB,GAAG,IAAI,CAS5D"}

package/dist/element/index.js

@@ -0,0 +1,35 @@
+/**
+ * Drop-in registration. `import '@hando/dough/element'` and the tag works.
+ *
+ * **Browser only** — see the note in `./dough-avatar`. This module is listed in
+ * the package's `sideEffects` array precisely because it has one: importing it
+ * registers the element, and a blanket `"sideEffects": false` let bundlers drop
+ * the documented bare import entirely and emit nothing.
+ */
+import { DoughAvatarElement } from './dough-avatar.js';
+export { DoughAvatarElement } from './dough-avatar.js';
+/**
+ * Whether the base class has been handed to `customElements` yet.
+ *
+ * A constructor may be registered exactly ONCE. Registering the same class
+ * under a second tag throws `NotSupportedError`, so checking only whether the
+ * requested NAME is free is not enough — after the automatic registration
+ * below, every explicit `defineDoughAvatar('my-avatar')` hit that error.
+ * Additional names therefore get their own trivial subclass.
+ */
+let baseRegistered = false;
+export function defineDoughAvatar(tag = 'dough-avatar') {
+    if (typeof customElements === 'undefined')
+        return;
+    if (customElements.get(tag) !== undefined)
+        return;
+    if (baseRegistered) {
+        customElements.define(tag, class extends DoughAvatarElement {
+        });
+        return;
+    }
+    customElements.define(tag, DoughAvatarElement);
+    baseRegistered = true;
+}
+defineDoughAvatar();
+//# sourceMappingURL=index.js.map

package/dist/element/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/element/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEtD;;;;;;;;GAQG;AACH,IAAI,cAAc,GAAG,KAAK,CAAA;AAE1B,MAAM,UAAU,iBAAiB,CAAC,GAAG,GAAG,cAAc;IACpD,IAAI,OAAO,cAAc,KAAK,WAAW;QAAE,OAAM;IACjD,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;QAAE,OAAM;IACjD,IAAI,cAAc,EAAE,CAAC;QACnB,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,KAAM,SAAQ,kBAAkB;SAAG,CAAC,CAAA;QAC/D,OAAM;IACR,CAAC;IACD,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAA;IAC9C,cAAc,GAAG,IAAI,CAAA;AACvB,CAAC;AAED,iBAAiB,EAAE,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * A soft-body companion character engine.
+ *
+ * The shape is a superellipse ovoid with independent exponents above and below
+ * its widest point; it squashes area-preservingly, leans by a shear pinned at
+ * its contact point, breathes on a one-sided curve and settles on a
+ * second-order spring. A face rides on it at a configurable grip, so it deforms
+ * with the body without being printed on it.
+ *
+ * Everything in `core` is pure arithmetic returning points and numbers. Nothing
+ * there imports a canvas, a document, or a platform. `canvas2d` turns those
+ * points into fills on any 2D context — a browser canvas, an OffscreenCanvas in
+ * a worker, or `@napi-rs/canvas` under Node. `svg` emits the same silhouette as
+ * a vector, so an icon pipeline and the running app cannot disagree about the
+ * shape.
+ *
+ * A face is DATA — see `FaceSpec` — so a design is a JSON file rather than a
+ * fork. `PLAIN` is the default; it is intended to be replaced.
+ */
+export * from './core/spec.js';
+export * from './core/plain.js';
+export * from './core/vocabulary.js';
+export * from './core/layout.js';
+export * from './core/geometry.js';
+export * from './core/lens.js';
+export * from './core/looks.js';
+export * from './core/idle.js';
+export * from './core/spring.js';
+export * from './core/motion.js';
+export * from './core/envelope.js';
+export * from './core/mouth.js';
+export * from './core/colour.js';
+export * from './canvas2d/avatar.js';
+export * from './canvas2d/face.js';
+export * from './canvas2d/paths.js';
+export * from './svg/silhouette.js';
+export * from './characters/index.js';
+//# sourceMappingURL=index.d.ts.map