@pinecall/dot 0.0.0-stage → 0.11.22

package/dist/face/ear.js

@@ -0,0 +1,111 @@
+/** The face's ear: an analyser on the element the agent's voice plays in, read once a frame. */
+//
+// The analyser is never connected to the speakers: the element already plays the voice, and the
+// ear only measures it. So the mouth moves with the sound the visitor hears, frame by frame, and
+// is in time with it by construction. An AudioContext may only start inside a click, so the ear
+// is deaf until `wake()` is called from one. A recording (an element with a `src`, not a stream)
+// is routed through the ear to the speakers, as Web Audio requires of an element it reads; it must
+// be fetched with CORS (`crossOrigin = "anonymous"`), or the ear hears silence.
+import { BANDS, levelOf, peakAfter } from "./mouth.js";
+const FFT = 1024;
+export class Ear {
+    #context = null;
+    #analyser = null;
+    #source = null;
+    /** An element's own source node: Web Audio makes one per element, once. */
+    #played = new WeakMap();
+    #element = null;
+    #time = new Float32Array(FFT);
+    #spectrum = new Float32Array(FFT / 2);
+    #peak = -18;
+    /** Start listening. Call it from the click that starts the call; a page with no Web Audio stays deaf. */
+    wake() {
+        if (this.#context === null) {
+            if (typeof AudioContext === "undefined")
+                return;
+            this.#context = new AudioContext();
+            this.#analyser = this.#context.createAnalyser();
+            this.#analyser.fftSize = FFT;
+            this.#analyser.smoothingTimeConstant = 0;
+        }
+        void this.#context.resume();
+    }
+    // The voice's track in a stream of the ear's own, as livekit-client's createAudioAnalyser takes it:
+    // the element's own stream, the one it plays, gave an analyser that heard nothing on a live call.
+    /** Listen to the voice this element plays, or to nothing. The same element twice is nothing new. */
+    hear(element) {
+        const listening = this.#source !== null || element === null;
+        if (element === this.#element && listening)
+            return;
+        // From the analyser alone: a recording's source also plays to the speakers, and keeps doing so.
+        if (this.#analyser !== null)
+            this.#source?.disconnect(this.#analyser);
+        this.#source = null;
+        this.#element = element;
+        if (this.#context === null || this.#analyser === null || element === null)
+            return;
+        const stream = element.srcObject;
+        if (stream === null && element.src !== "") {
+            this.#source = this.#recording(this.#context, element);
+            this.#source.connect(this.#analyser);
+            return;
+        }
+        const track = stream instanceof MediaStream ? stream.getAudioTracks()[0] : undefined;
+        if (track === undefined)
+            return;
+        this.#source = this.#context.createMediaStreamSource(new MediaStream([track]));
+        this.#source.connect(this.#analyser);
+    }
+    /** A recording's source, made once, playing to the speakers whether or not the ear reads it now. */
+    #recording(context, element) {
+        let made = this.#played.get(element);
+        if (made === undefined) {
+            made = context.createMediaElementSource(element);
+            made.connect(context.destination);
+            this.#played.set(element, made);
+        }
+        return made;
+    }
+    /** Where the ear stands now. */
+    get hearing() {
+        if (this.#context === null)
+            return "asleep";
+        if (this.#element === null)
+            return "no voice";
+        return this.#source === null ? "no track" : "listening";
+    }
+    /** This frame of the voice, `dt` seconds after the last; null while the ear hears nothing. */
+    listen(dt) {
+        const analyser = this.#analyser;
+        if (analyser === null || this.#source === null || this.#context === null)
+            return null;
+        analyser.getFloatTimeDomainData(this.#time);
+        let sum = 0;
+        for (const sample of this.#time)
+            sum += sample * sample;
+        const db = 20 * Math.log10(Math.sqrt(sum / this.#time.length) + 1e-9);
+        this.#peak = peakAfter(this.#peak, db, dt);
+        analyser.getFloatFrequencyData(this.#spectrum);
+        const hz = this.#context.sampleRate / FFT;
+        const power = ([low, high]) => {
+            let sum = 0;
+            const last = Math.min(this.#spectrum.length - 1, Math.ceil(high / hz));
+            for (let bin = Math.floor(low / hz); bin <= last; bin += 1)
+                sum += Math.pow(10, (this.#spectrum[bin] ?? -200) / 10);
+            return sum;
+        };
+        return {
+            level: levelOf(db, this.#peak),
+            bands: { low: power(BANDS.low), mid: power(BANDS.mid), high: power(BANDS.high), sib: power(BANDS.sib) },
+        };
+    }
+    /** Stop listening for good. */
+    close() {
+        this.#source?.disconnect();
+        this.#source = null;
+        void this.#context?.close();
+        this.#context = null;
+        this.#analyser = null;
+    }
+}
+//# sourceMappingURL=ear.js.map

package/dist/face/ear.js.map

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

package/dist/face/index.d.ts

@@ -0,0 +1,23 @@
+/** The face: a dot that speaks with the agent's voice, drawn into any element of the page. */
+import type { RoomStore } from "@pinecall/room";
+import { type Shape } from "./shape.js";
+/** A face on the page. */
+export interface Face {
+    /** Let the face hear the voice. Call it from the click that starts the call: a browser starts audio only inside one. */
+    wake(): void;
+    /** Change the body's shape: it eases into the new one. */
+    reshape(shape: Shape): void;
+    /** Speak with this element's audio instead of the call's voice, a recording the page plays; null gives the call back. */
+    listen(element: HTMLMediaElement | null): void;
+    /** Take the face off the page and stop listening. */
+    close(): void;
+}
+export interface FaceOptions {
+    /** The body's shape: `circle` (the default), `squircle` or `blob`. */
+    shape?: Shape | undefined;
+    /** The body's colour, any CSS colour; the page's `--pc-face` when left out. */
+    color?: string | undefined;
+}
+/** Draw a face into `host`, filling it, moving with `call`. The host sets its size. */
+export declare function face(host: Element, call: RoomStore, options?: FaceOptions): Face;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/face/index.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAS9F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhD,OAAO,EAAsC,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAE5E,0BAA0B;AAC1B,MAAM,WAAW,IAAI;IACnB,wHAAwH;IACxH,IAAI,IAAI,IAAI,CAAC;IACb,0DAA0D;IAC1D,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC5B,yHAAyH;IACzH,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/C,qDAAqD;IACrD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAC1B,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAcD,uFAAuF;AACvF,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,WAAgB,GAAG,IAAI,CAiHpF"}

package/dist/face/index.js

@@ -0,0 +1,138 @@
+/** The face: a dot that speaks with the agent's voice, drawn into any element of the page. */
+//
+// It reads the room it is given and nothing else: the phase and the agent's own state set its mood
+// (resting, listening, hearing the caller, thinking), and while the agent's voice sounds, its mouth
+// is read from that voice frame by frame. Its body is one of a few shapes, in the page's colour, and
+// moves whole with the mood, its outline never bent: it bobs and leans in while it listens, nods with
+// its head cocked and its eyes wide while the caller speaks, looks up from side to side with its
+// mouth pursed while it thinks, and squashes with the voice. Nothing is sent anywhere and nothing is asked of the server.
+import { drawn, painted } from "./draw.js";
+import { Ear } from "./ear.js";
+import { BLINK_S, POSES, SOUNDING, eased, easedMouth, lidAt, moodOf, nextBlink } from "./motion.js";
+import { spoken } from "./mouth.js";
+import { morphed, outlineOf, radii, shapeOf } from "./shape.js";
+/** How high the body bobs in each mood, in the box's units, and how often, per second. */
+const BOB = {
+    idle: { high: 0, often: 0 },
+    listening: { high: 1.5, often: 0.8 },
+    hearing: { high: 1.3, often: 1.7 },
+    thinking: { high: 0.6, often: 0.4 },
+    speaking: { high: 0, often: 0 },
+};
+// Without an ear (never woken, or no Web Audio) the mouth opens with the room's own level, in no shape.
+const NO_SHAPE = { low: 1, mid: 1, high: 0, sib: 0 };
+/** Draw a face into `host`, filling it, moving with `call`. The host sets its size. */
+export function face(host, call, options = {}) {
+    const drawing = drawn(host, `pc-face-${Math.random().toString(36).slice(2, 10)}`);
+    if (options.color !== undefined && host instanceof HTMLElement)
+        host.style.setProperty("--pc-face", options.color);
+    let rest = radii(shapeOf(options.shape));
+    let rim = rest;
+    let bob = 0;
+    let own = null;
+    const ear = new Ear();
+    const still = typeof matchMedia === "function" && matchMedia("(prefers-reduced-motion: reduce)").matches;
+    let mouth = { ...POSES.idle };
+    let level = 0;
+    let last = performance.now();
+    let blinking = null;
+    let blinkIn = nextBlink(Math.random());
+    const gaze = { x: 0, y: 0 };
+    const glance = { x: 0, y: 0 };
+    let glanceIn = 2;
+    let frame = 0;
+    let closed = false;
+    const tick = (at) => {
+        const dt = Math.min(0.05, Math.max(0, (at - last) / 1000));
+        last = at;
+        const state = call.state;
+        ear.hear(own ?? state.voice);
+        const heard = ear.listen(dt);
+        const loud = heard?.level ?? (state.speaking.agent ? state.speaking.level : 0);
+        // What the mouth reads, on the host, for a page that wants to know: the voice itself, or the room's coarse level.
+        if (host instanceof HTMLElement) {
+            host.dataset["pcEar"] = ear.hearing;
+            host.dataset["pcLevel"] = loud.toFixed(2);
+        }
+        const mood = (state.phase === "live" || own !== null) && loud > SOUNDING ? "speaking" : moodOf(state);
+        const seconds = at / 1000;
+        // Thinking purses its mouth and slides it from side to side, "hmm".
+        const hmm = still ? 1 : Math.sin(seconds * Math.PI * 2 * 0.32);
+        const target = mood === "speaking" ? spoken(loud, heard?.bands ?? NO_SHAPE) : mood === "thinking" ? { ...POSES.thinking, shift: 3.2 * hmm } : POSES[mood];
+        mouth = easedMouth(mouth, target, dt);
+        level = eased(level, mood === "speaking" ? loud : 0, dt, 0.03, 0.12);
+        blinkIn -= dt;
+        if (blinking === null && blinkIn <= 0)
+            blinking = 0;
+        let lid = 1;
+        if (blinking !== null) {
+            blinking += dt;
+            lid = lidAt(blinking);
+            if (blinking >= BLINK_S) {
+                blinking = null;
+                blinkIn = nextBlink(Math.random());
+            }
+        }
+        // Thinking looks up, from side to side; hearing looks at the caller, toward the page; otherwise a
+        // small glance now and then, smaller while speaking.
+        glanceIn -= dt;
+        if (mood === "thinking") {
+            glance.x = 2.6 * hmm;
+            glance.y = -3.2;
+            glanceIn = 0.4;
+        }
+        else if (mood === "hearing") {
+            glance.x = -1.2;
+            glance.y = 0.6;
+            glanceIn = 0.4;
+        }
+        else if (glanceIn <= 0) {
+            glanceIn = 1.5 + Math.random() * 3;
+            const wander = mood === "speaking" ? 0.8 : 1.6;
+            glance.x = (Math.random() - 0.5) * 2 * wander;
+            glance.y = (Math.random() - 0.5) * wander;
+        }
+        gaze.x = eased(gaze.x, glance.x, dt, 0.12, 0.12);
+        gaze.y = eased(gaze.y, glance.y, dt, 0.12, 0.12);
+        const breath = still ? 0 : Math.sin(seconds * Math.PI * 2 * 0.22) * 0.018;
+        rim = morphed(rim, rest, dt);
+        bob = eased(bob, still ? 0 : BOB[mood].high, dt, 0.3, 0.4);
+        const wave = Math.sin(seconds * Math.PI * 2 * (BOB[mood].often || 0.8));
+        // A bob is a little hop: up a touch taller and narrower, down a touch wider, as a soft body does.
+        const hop = bob * wave;
+        // Hearing cocks its head, as a person does who is following; thinking sways slowly.
+        const lean = { idle: 0, listening: -5, hearing: -9, thinking: 4 + 2.5 * hmm, speaking: 0 }[mood];
+        painted(drawing, {
+            mouth,
+            lid,
+            eyes: mood === "hearing" ? 1.16 : mood === "listening" ? 1.08 : 1,
+            gaze,
+            tilt: still ? 0 : lean + Math.sin(seconds * 0.7) * 1.2,
+            lift: hop,
+            scale: { x: 1 + breath + level * 0.025 - mouth.open * 0.012 - hop * 0.008, y: 1 + breath + level * 0.02 + mouth.open * 0.03 + hop * 0.01 },
+            body: outlineOf(rim),
+        });
+        frame = requestAnimationFrame(tick);
+    };
+    tick(performance.now());
+    return {
+        wake() {
+            ear.wake();
+        },
+        reshape(shape) {
+            rest = radii(shape);
+        },
+        listen(element) {
+            own = element;
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            cancelAnimationFrame(frame);
+            ear.close();
+            drawing.svg.remove();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/face/index.js.map

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

package/dist/face/motion.d.ts

@@ -0,0 +1,25 @@
+/** How the face moves between frames: the mood a call is in, the mouth each quiet mood holds, the easing, the blink. Pure. */
+import type { RoomState } from "@pinecall/room";
+import type { Mouth } from "./mouth.js";
+/** What the face is doing. Speaking is the voice's; the others are poses: listening waits in a call, hearing is the caller speaking. */
+export type Mood = "idle" | "listening" | "hearing" | "thinking" | "speaking";
+/** The mouth each quiet mood holds. */
+export declare const POSES: Record<Exclude<Mood, "speaking">, Mouth>;
+/** A frame louder than this is the agent speaking, whatever its state says: the log's word comes later than the sound. */
+export declare const SOUNDING = 0.06;
+/**
+ * The mood a call is in: opening thinks, a live call follows the agent's own state and hears while
+ * the caller speaks, anything else rests.
+ */
+export declare function moodOf(state: RoomState): Mood;
+/** One number moved toward its target over `dt` seconds: `rise` seconds to open, `fall` to close. */
+export declare function eased(now: number, target: number, dt: number, rise: number, fall: number): number;
+/** The whole mouth moved toward its target: quick to open, slower to close, so it never shivers. */
+export declare function easedMouth(now: Mouth, target: Mouth, dt: number): Mouth;
+/** How long a blink takes, in seconds. */
+export declare const BLINK_S = 0.16;
+/** How open the eyes are `since` seconds into a blink: 1 open, down to 0.1, and back. */
+export declare function lidAt(since: number): number;
+/** Seconds to the next blink, from a random draw in [0, 1): now and then twice in a row, else every 2.5 to 6 s. */
+export declare function nextBlink(draw: number): number;
+//# sourceMappingURL=motion.d.ts.map

package/dist/face/motion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.d.ts","sourceRoot":"","sources":["../../src/face/motion.ts"],"names":[],"mappings":"AAAA,8HAA8H;AAE9H,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,wIAAwI;AACxI,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE9E,uCAAuC;AACvC,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,KAAK,CAK1D,CAAC;AAEF,0HAA0H;AAC1H,eAAO,MAAM,QAAQ,OAAO,CAAC;AAE7B;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAW7C;AAED,qGAAqG;AACrG,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjG;AAED,oGAAoG;AACpG,wBAAgB,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CASvE;AAED,0CAA0C;AAC1C,eAAO,MAAM,OAAO,OAAO,CAAC;AAE5B,yFAAyF;AACzF,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI3C;AAED,mHAAmH;AACnH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/face/motion.js

@@ -0,0 +1,58 @@
+/** How the face moves between frames: the mood a call is in, the mouth each quiet mood holds, the easing, the blink. Pure. */
+/** The mouth each quiet mood holds. */
+export const POSES = {
+    idle: { open: 0, width: 0.5, round: 0, teeth: 0, smile: 0.85, shift: 0 },
+    listening: { open: 0.04, width: 0.55, round: 0, teeth: 0, smile: 0.55, shift: 0 },
+    hearing: { open: 0.1, width: 0.36, round: 0.45, teeth: 0, smile: 0.3, shift: 0 },
+    thinking: { open: 0.14, width: 0.2, round: 0.75, teeth: 0, smile: 0, shift: 3.2 },
+};
+/** A frame louder than this is the agent speaking, whatever its state says: the log's word comes later than the sound. */
+export const SOUNDING = 0.06;
+/**
+ * The mood a call is in: opening thinks, a live call follows the agent's own state and hears while
+ * the caller speaks, anything else rests.
+ */
+export function moodOf(state) {
+    if (state.phase === "opening")
+        return "thinking";
+    if (state.phase !== "live")
+        return "idle";
+    switch (state.log.agent_state) {
+        case "speaking":
+            return "speaking";
+        case "thinking":
+            return "thinking";
+        default:
+            return state.speaking.user || (state.log.live.user ?? "") !== "" ? "hearing" : "listening";
+    }
+}
+/** One number moved toward its target over `dt` seconds: `rise` seconds to open, `fall` to close. */
+export function eased(now, target, dt, rise, fall) {
+    const tau = target > now ? rise : fall;
+    return now + (target - now) * (1 - Math.exp(-dt / tau));
+}
+/** The whole mouth moved toward its target: quick to open, slower to close, so it never shivers. */
+export function easedMouth(now, target, dt) {
+    return {
+        open: eased(now.open, target.open, dt, 0.035, 0.075),
+        width: eased(now.width, target.width, dt, 0.05, 0.09),
+        round: eased(now.round, target.round, dt, 0.05, 0.09),
+        teeth: eased(now.teeth, target.teeth, dt, 0.03, 0.07),
+        smile: eased(now.smile, target.smile, dt, 0.15, 0.15),
+        shift: eased(now.shift, target.shift, dt, 0.2, 0.2),
+    };
+}
+/** How long a blink takes, in seconds. */
+export const BLINK_S = 0.16;
+/** How open the eyes are `since` seconds into a blink: 1 open, down to 0.1, and back. */
+export function lidAt(since) {
+    const p = since / BLINK_S;
+    if (p >= 1)
+        return 1;
+    return p < 0.5 ? 1 - p * 1.8 : Math.min(1, 0.1 + (p - 0.5) * 1.8);
+}
+/** Seconds to the next blink, from a random draw in [0, 1): now and then twice in a row, else every 2.5 to 6 s. */
+export function nextBlink(draw) {
+    return draw < 0.18 ? 0.18 : 2.5 + ((draw - 0.18) / 0.82) * 3.5;
+}
+//# sourceMappingURL=motion.js.map

package/dist/face/motion.js.map

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

package/dist/face/mouth.d.ts

@@ -0,0 +1,45 @@
+/** The mouth, as numbers: what the voice makes of it, and its outline. Pure: no DOM, no audio. */
+/** Every number 0 to 1, but `shift`, which moves the mouth sideways in the face's own units. */
+export interface Mouth {
+    open: number;
+    width: number;
+    round: number;
+    teeth: number;
+    smile: number;
+    shift: number;
+}
+/** The voice's power in four bands, in any linear unit: only their proportions are read. */
+export interface Bands {
+    low: number;
+    mid: number;
+    high: number;
+    sib: number;
+}
+/** Where the bands are cut, in Hz. */
+export declare const BANDS: {
+    readonly low: readonly [90, 500];
+    readonly mid: readonly [500, 1500];
+    readonly high: readonly [1500, 3500];
+    readonly sib: readonly [4000, 9000];
+};
+export declare function clamp(value: number, low?: number, high?: number): number;
+/** The loudest recent frame after `dt` seconds: a slow automatic gain, so any voice opens fully. */
+export declare function peakAfter(peak: number, db: number, dt: number): number;
+/** How loud a frame is, 0 (silence) to 1 (the loudest recent frame). */
+export declare function levelOf(db: number, peak: number): number;
+/** The mouth a frame of voice asks for: the jaw from `level`, the lips from where the energy is. */
+export declare function spoken(level: number, bands: Bands): Mouth;
+/** The mouth drawn in a 100 × 100 face: a lens between two cubic curves, and where its lips are. */
+export interface Outline {
+    d: string;
+    cx: number;
+    cy: number;
+    /** Half its width. */
+    half: number;
+    /** How far the upper lip rises, and the lower one drops, from the line between the corners. */
+    up: number;
+    down: number;
+}
+/** Corners in for round, out for wide; the lower lip drops with `open`; the corners lift with `smile`. */
+export declare function outline(mouth: Mouth): Outline;
+//# sourceMappingURL=mouth.d.ts.map

package/dist/face/mouth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mouth.d.ts","sourceRoot":"","sources":["../../src/face/mouth.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAOlG,gGAAgG;AAChG,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4FAA4F;AAC5F,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,sCAAsC;AACtC,eAAO,MAAM,KAAK;aAAK,GAAG,YAAG,EAAE,EAAE,GAAG;aAAG,GAAG,YAAG,GAAG,EAAE,IAAI;aAAG,IAAI,YAAG,IAAI,EAAE,IAAI;aAAG,GAAG,YAAG,IAAI,EAAE,IAAI;CAAY,CAAC;AAQ1G,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAI,EAAE,IAAI,SAAI,GAAG,MAAM,CAE9D;AAED,oGAAoG;AACpG,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,oGAAoG;AACpG,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAkBzD;AAED,oGAAoG;AACpG,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,+FAA+F;IAC/F,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0GAA0G;AAC1G,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAe7C"}

package/dist/face/mouth.js

@@ -0,0 +1,61 @@
+/** The mouth, as numbers: what the voice makes of it, and its outline. Pure: no DOM, no audio. */
+//
+// Loudness opens the jaw. Where the energy sits in the spectrum shapes the lips: strong highs over
+// 4 kHz are S and T (teeth showing, little opening); strong 1.5–3.5 kHz is a front vowel, EE or EH
+// (wide); energy held under 500 Hz with no highs is a back vowel, OO or O (round). Six numbers, not
+// a set of drawings, so any face can be drawn from them.
+/** Where the bands are cut, in Hz. */
+export const BANDS = { low: [90, 500], mid: [500, 1500], high: [1500, 3500], sib: [4000, 9000] };
+/** Below this the voice is silence, in dBFS. */
+const FLOOR_DB = -52;
+/** The loudest recent frame decays this fast, in dB a second, and never below this. */
+const PEAK_DECAY = 4;
+const PEAK_LOWEST = -30;
+export function clamp(value, low = 0, high = 1) {
+    return Math.min(high, Math.max(low, value));
+}
+/** The loudest recent frame after `dt` seconds: a slow automatic gain, so any voice opens fully. */
+export function peakAfter(peak, db, dt) {
+    return Math.max(db, peak - PEAK_DECAY * dt, PEAK_LOWEST);
+}
+/** How loud a frame is, 0 (silence) to 1 (the loudest recent frame). */
+export function levelOf(db, peak) {
+    return clamp((db - FLOOR_DB) / (peak - FLOOR_DB));
+}
+/** The mouth a frame of voice asks for: the jaw from `level`, the lips from where the energy is. */
+export function spoken(level, bands) {
+    const total = bands.low + bands.mid + bands.high + bands.sib + 1e-12;
+    const low = bands.low / total;
+    const mid = bands.mid / total;
+    const high = bands.high / total;
+    const sib = bands.sib / total;
+    const voiced = clamp((level - 0.06) * 4);
+    const hiss = clamp((sib - 0.06) / 0.22) * voiced;
+    const front = clamp((high - 0.06) / 0.22) * voiced;
+    const round = clamp((low - 0.6) / 0.3) * (1 - front) * (1 - hiss) * voiced;
+    return {
+        open: clamp(Math.pow(level, 0.85) * (0.6 + 0.7 * mid) * (1 - 0.6 * hiss) * (1 - 0.25 * round)),
+        width: clamp(0.35 + 0.65 * front - 0.3 * round),
+        round,
+        teeth: clamp(hiss * 1.2 + front * 0.45),
+        smile: 0.3,
+        shift: 0,
+    };
+}
+/** Corners in for round, out for wide; the lower lip drops with `open`; the corners lift with `smile`. */
+export function outline(mouth) {
+    const cx = 50 + mouth.shift;
+    const cy = 64;
+    const half = 11 * (0.78 + 0.4 * mouth.width) * (1 - 0.45 * mouth.round);
+    const lift = mouth.smile * 3.4 * (1 - 0.75 * mouth.open);
+    const up = 0.5 + mouth.open * 4.2 + mouth.round * mouth.open * 2.2;
+    const down = 0.9 + mouth.open * 12.5;
+    const k = 0.42 + 0.38 * mouth.round;
+    const y = cy - lift;
+    const at = (n) => n.toFixed(2);
+    const d = `M ${at(cx - half)} ${at(y)}` +
+        ` C ${at(cx - half * k)} ${at(cy - up)}, ${at(cx + half * k)} ${at(cy - up)}, ${at(cx + half)} ${at(y)}` +
+        ` C ${at(cx + half * k)} ${at(cy + down)}, ${at(cx - half * k)} ${at(cy + down)}, ${at(cx - half)} ${at(y)} Z`;
+    return { d, cx, cy, half, up, down };
+}
+//# sourceMappingURL=mouth.js.map

package/dist/face/mouth.js.map

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

package/dist/face/shape.d.ts

@@ -0,0 +1,15 @@
+/** The face's body: one of a few shapes, as a radius at each of a ring of angles. Pure. */
+/** The shapes a face's body takes. */
+export declare const SHAPES: readonly ["circle", "squircle", "blob"];
+export type Shape = (typeof SHAPES)[number];
+/** The farthest a point may reach from the middle: the box's half, less what the head's bob and squash take (7 % and 1.5 units). */
+export declare const REACH = 44;
+/** `value` when it names a shape, else the circle. */
+export declare function shapeOf(value: unknown): Shape;
+/** The shape at rest: its radius at each angle of the ring. */
+export declare function radii(shape: Shape): number[];
+/** Each point moved toward the shape it is becoming over `dt` seconds, about a third of a second to arrive. */
+export declare function morphed(now: readonly number[], target: readonly number[], dt: number): number[];
+/** The rim as one smooth closed SVG path round (50, 50): a Catmull-Rom curve through its points. */
+export declare function outlineOf(rim: readonly number[]): string;
+//# sourceMappingURL=shape.d.ts.map

package/dist/face/shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.d.ts","sourceRoot":"","sources":["../../src/face/shape.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAO3F,sCAAsC;AACtC,eAAO,MAAM,MAAM,YAAI,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAU,CAAC;AAC9D,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAI5C,oIAAoI;AACpI,eAAO,MAAM,KAAK,KAAK,CAAC;AAExB,sDAAsD;AACtD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAE7C;AAID,+DAA+D;AAC/D,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAW5C;AAED,+GAA+G;AAC/G,wBAAgB,OAAO,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAG/F;AAED,oGAAoG;AACpG,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAYxD"}

package/dist/face/shape.js

@@ -0,0 +1,50 @@
+/** The face's body: one of a few shapes, as a radius at each of a ring of angles. Pure. */
+//
+// A shape is its radius at every angle around the middle, so any two shapes ease into each other
+// point by point. The outline never bends while the face moves: the whole body bobs, leans and
+// squashes instead. Every point stays inside the face's 100-unit box with room for that motion, so
+// nothing of the body is drawn past the element the page gave it.
+/** The shapes a face's body takes. */
+export const SHAPES = ["circle", "squircle", "blob"];
+/** How many points go round the rim. */
+const POINTS = 48;
+/** The farthest a point may reach from the middle: the box's half, less what the head's bob and squash take (7 % and 1.5 units). */
+export const REACH = 44;
+/** `value` when it names a shape, else the circle. */
+export function shapeOf(value) {
+    return SHAPES.find((one) => one === value) ?? "circle";
+}
+const angles = Array.from({ length: POINTS }, (_, at) => (at / POINTS) * Math.PI * 2);
+/** The shape at rest: its radius at each angle of the ring. */
+export function radii(shape) {
+    switch (shape) {
+        case "circle":
+            return angles.map(() => 44);
+        case "squircle":
+            // A superellipse, flat on its four sides and round at its corners, which reach farther: 36 is 43.6 there.
+            return angles.map((a) => 36 / (Math.abs(Math.cos(a)) ** 4.5 + Math.abs(Math.sin(a)) ** 4.5) ** (1 / 4.5));
+        case "blob":
+            // A soft egg leaning a little to one side: one gentle swell, nothing a viewer reads as a dent.
+            return angles.map((a) => 41 * (1 + 0.055 * Math.sin(2 * a + 0.6) + 0.015 * Math.sin(3 * a + 1.9)));
+    }
+}
+/** Each point moved toward the shape it is becoming over `dt` seconds, about a third of a second to arrive. */
+export function morphed(now, target, dt) {
+    const step = 1 - Math.exp(-dt / 0.12);
+    return now.map((radius, at) => radius + ((target[at] ?? radius) - radius) * step);
+}
+/** The rim as one smooth closed SVG path round (50, 50): a Catmull-Rom curve through its points. */
+export function outlineOf(rim) {
+    const points = rim.map((radius, at) => ({ x: 50 + radius * Math.cos(angles[at] ?? 0), y: 50 + radius * Math.sin(angles[at] ?? 0) }));
+    const at = (index) => points[(index + points.length) % points.length] ?? { x: 50, y: 50 };
+    const n = (value) => value.toFixed(2);
+    let d = `M ${n(at(0).x)} ${n(at(0).y)}`;
+    for (let index = 0; index < points.length; index++) {
+        const [before, from, to, after] = [at(index - 1), at(index), at(index + 1), at(index + 2)];
+        const c1 = { x: from.x + (to.x - before.x) / 6, y: from.y + (to.y - before.y) / 6 };
+        const c2 = { x: to.x - (after.x - from.x) / 6, y: to.y - (after.y - from.y) / 6 };
+        d += ` C ${n(c1.x)} ${n(c1.y)}, ${n(c2.x)} ${n(c2.y)}, ${n(to.x)} ${n(to.y)}`;
+    }
+    return `${d} Z`;
+}
+//# sourceMappingURL=shape.js.map

package/dist/face/shape.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/** @pinecall/dot: the talking dot for a page — its face, and the tutor that walks the page with a pointer of its own. */
+export { face, type Face, type FaceOptions } from "./face/index.js";
+export type { Shape } from "./face/shape.js";
+export { Page, type Seen } from "./page/page.js";
+export { tutor, type Tutor, type TutorOptions } from "./tutor/tutor.js";
+export type { ViewRenderer, ViewTools, Views } from "./tutor/views.js";
+export type { Action, Beat, Cursor, Macro, MacroStep, Step } from "./wire/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yHAAyH;AAEzH,OAAO,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACpE,YAAY,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,KAAK,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACxE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+/** @pinecall/dot: the talking dot for a page — its face, and the tutor that walks the page with a pointer of its own. */
+export { face } from "./face/index.js";
+export { Page } from "./page/page.js";
+export { tutor } from "./tutor/tutor.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yHAAyH;AAEzH,OAAO,EAAE,IAAI,EAA+B,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,IAAI,EAAa,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAiC,MAAM,kBAAkB,CAAC"}