@chatlychat/world 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# @chatlychat/world
+
+## 0.1.0 — 2026-10-25
+
+Unpublished. The first version: a Chatly conversation rendered into your three.js scene.
+
+- `createWorld({ conversation, camera, … })` → `world.root` (add it to your scene) and `world.update(dt)` (call it from your loop).
+- Picks: a `card_grid` laid out as `arc`, `shelf`, `wall` or `table`; `card.model` loaded with three's `GLTFLoader` (scale and anchor honoured); pedestal, beam, price label and selection ring from `worldTheme`. Tapping a pick selects it in the conversation (a postback) and the selection is shared with the host.
+- Speech bubbles anchored to a speaker (never head-locked), scaled by distance, with a typing indicator.
+- A world-space panel and composer; `fixed`, `lazy` and `wrist` follow; a `locked` placement is honoured as `lazy`.
+- Hand, controller (`attachController`), gaze-dwell (`attachGaze`) and pointer (`pickAtPointer`) picking. The host keeps input.
+- An embodied agent body: avatar model, `idle`/`listening`/`thinking`/`speaking` clips, expression and `lookAt` cues, viseme-driven mouth when a message carries `metadata.visemes`.
+- Host capabilities: `world.walk_to`, `avatar.try_on`, `scene.highlight`, `scene.spawn` and custom names, dispatched to handlers you register; bot-fired invocations are answered into the thread; every action keeps its `equivalent`.
+- Replaceable `renderCard`, `renderPick`, `renderBubble`, `renderPanel`, `renderComposer`, `renderAgent`, with a named, versioned object contract (`WORLD_CONTRACT`).
+- `worldTheme` applied to panel, type, cards, speech, agent, sound cues and motion; reduced motion always wins.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chatly Engineering
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,121 @@
-# Temporary Holding Version
+# @chatlychat/world
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A Chatly conversation, rendered into **your** three.js scene. You keep the scene,
+the avatars, the input and the wayfinding; this draws what the conversation
+contains and sends the visitor's taps back.
+
+```bash
+pnpm add @chatlychat/world @chatlychat/core three
+```
+
+`three` (>= 0.160) and `@chatlychat/core` are peer dependencies. There are no
+others, and nothing here touches the web widget.
+
+> `@chatlychat/world` is **not yet published to npm**; the install above will 404
+> until it is.
+
+```ts
+import { createChatlyCore } from '@chatlychat/core';
+import { createWorld } from '@chatlychat/world';
+import { Clock } from 'three';
+
+const core = createChatlyCore({ publicId: 'pub_xxx', socket: io });
+const conversation = await core.startConversation('Do you have this in blue?');
+
+const world = createWorld({
+  conversation,
+  camera, // the camera (or XR camera) the visitor sees through
+  theme: core.worldTheme, // the channel's worldTheme
+  scene: 'light', // what your scene's light is, for colorScheme "auto"
+  reducedMotion: () => false, // return your viewer's reduced-motion setting
+  presences: { '*': { name: 'Mia', avatar: { url: 'https://cdn.example/mia.glb' } } },
+});
+scene.add(world.root);
+
+const clock = new Clock();
+renderer.setAnimationLoop(() => {
+  world.update(clock.getDelta()); // seconds
+  renderer.render(scene, camera);
+});
+```
+
+## What it draws
+
+- **Picks.** A `card_grid` with `placement` `arc`, `shelf`, `wall` or `table`;
+  a card with a `model` becomes a glTF object (`scale` and `anchor` honoured)
+  with the theme's pedestal, beam, price label and selection ring. Tapping one
+  selects it: a postback to the conversation, a ring on the card, the object in
+  hand. `world.selection` is shared — selecting from your own UI is the same event
+  (`await world.select(key)`; keys from `world.cardKeys()`).
+- **Speech bubbles** over a speaker, turned to the viewer and scaled by distance —
+  positioned from the speaker, never from the camera. Typing indicator per
+  `typingLook`. History is not replayed as speech.
+- **A world-space panel and composer.** Never head-locked: `fixed`, `lazy` (an
+  eased follow with a dead zone) or `wrist` (carried on a controller you pass).
+  `follow: 'locked'` in a placement is honoured as `lazy`.
+  Typing is yours: fill `world.composer.setDraft(text)` from your keyboard, mic or
+  overlay (`onComposeRequest` fires when the field is pressed), then it sends.
+- **An agent body**: avatar model (glTF; `usdz` is refused with a typed error),
+  `idle`/`listening`/`thinking`/`speaking` clips from `presence.clips`, one-shot
+  `expressions`, `lookAt` cues resolved through `anchors.resolve(ref)`, and a mouth
+  driven by `message.metadata.visemes` (`[{ t: ms, v: 'aa', w?: 0..1 }]`) when
+  present. `presence.idle` and `personalSpaceMetres` are yours to honour.
+
+## Input
+
+The host owns input; the world only knows which of its objects a ray hit.
+
+```ts
+world.attachController(xrController); // your XR controller object: trigger or hand pinch
+const gaze = world.attachGaze({ dwellMs: 1500 }); // call gaze.update(ms) per frame
+const hit = world.pickAtPointer(ndcX, ndcY); // mouse / touch
+if (hit) world.activate(hit);
+```
+
+## Host capabilities
+
+```ts
+world.capabilities.register(
+  'world.walk_to', // also: avatar.try_on, scene.highlight, scene.spawn, or your own
+  async () => true, // do your own movement here; return false or throw to refuse
+  { equivalent: { kind: 'text', text: 'The shop is on level 2.' }, unprompted: true },
+);
+await core.setSurface(world.capabilities.surface({ room: 'atrium' }));
+```
+
+A bot-fired invocation reaches your handler and is answered into the thread
+(`done`, or `failed` + `refused: true`). The `equivalent` is required and is
+announced (`announce`) whenever the handler is missing, refuses or throws.
+
+## Replaceable renderers
+
+`renderCard`, `renderPick`, `renderBubble`, `renderPanel`, `renderComposer`,
+`renderAgent` — each receives the typed block (or message, or agent view), the
+resolved `theme` and `placement`, `reducedMotion`, and for blocks the Chatly
+handlers `select`, `press` and `react`. Return any `Object3D`.
+
+```ts
+createWorld({ …, renderers: { contract: 1, renderCard: (p) => yourShelfMesh } });
+```
+
+The world names an override's node `cl3-card` etc. if you did not, and routes
+taps on it to selection (set `userData.cl3Handled = true` to take taps yourself).
+Object names and the renderer set are versioned in `WORLD_CONTRACT`; pinning
+`contract: N` fails loudly on a world that speaks another N.
+
+## Theme and reduced motion
+
+Every `worldTheme` token is applied: panel material/colour/emissive, type
+(`fontUrl`, weight, outline, `textScale`), cards, speech, agent, sound (as
+`onSound` cues — you play them) and motion. `world.setTheme`, `setScene` and
+`setReducedMotion` re-apply live. **Reduced motion always wins:** entrances and
+trails off, lazy follow and gaze snap, expression clips skipped, clips held on
+their first frame.
+
+## Tests without WebGL
+
+three builds a scene graph with no GL context, so you can test your integration in
+Node: see `src/world.spec.ts` for a fake conversation and the assertions.
+`pnpm --filter @chatlychat/world example` runs a scripted demo.
+
+MIT.

package/dist/agent.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The embodied agent's body: a model, four state clips, one-shot expressions,
+ * a gaze and a mouth.
+ *
+ * What it does NOT do is walk. `presence.idle` (`stand`/`wander`/`follow`) and
+ * `personalSpaceMetres` are facts about where the agent may go, and wayfinding
+ * is the host's — they are readable on `presence` and honoured by nobody here.
+ *
+ * Reduced motion always wins: state clips are held on their first frame (a
+ * pose, not a loop), expression one-shots are not played, gaze snaps rather
+ * than turns, and there is no crossfade. The mouth still follows visemes —
+ * speech is not decorative motion, and a mouth that never moves on a speaking
+ * agent would read as a broken one.
+ */
+import { Group, Vector3, type Camera, type Object3D } from 'three';
+import { type ModelLoader } from './model.js';
+import { type VisemeTrack } from './visemes.js';
+import type { AgentPresenceState, AgentWorldPresence } from '@chatlychat/core';
+import type { ResolvedWorldTheme } from '@chatlychat/core';
+export type GazeTarget = Object3D | Vector3 | 'visitor' | null;
+export declare class AgentBody {
+    private theme;
+    private readonly loadModel;
+    private readonly onError;
+    readonly root: Group;
+    presence: AgentWorldPresence | null;
+    reduced: boolean;
+    private model;
+    private mixer;
+    private clips;
+    private current;
+    private avatarUrl;
+    private tag;
+    private gaze;
+    private track;
+    private trackStart;
+    private morphs;
+    private lastState;
+    private refused;
+    constructor(theme: ResolvedWorldTheme, loadModel: ModelLoader, onError: (e: unknown) => void, reduced: boolean);
+    get hasModel(): boolean;
+    get activeClip(): string | null;
+    setTheme(theme: ResolvedWorldTheme): void;
+    private placeholder;
+    setPresence(presence: AgentWorldPresence | null): void;
+    private setTag;
+    private swapModel;
+    private action;
+    /** Move to the state's clip — the host's own name for it, from `presence.clips`. */
+    setState(state: AgentPresenceState): void;
+    /** Play a one-shot expression clip. Skipped entirely under reduced motion. */
+    playExpression(clipName: string | null): boolean;
+    lookAt(target: GazeTarget): void;
+    setVisemes(track: VisemeTrack | null, nowMs: number): void;
+    private applyViseme;
+    update(dtMs: number, nowMs: number, camera: Camera): void;
+    dispose(): void;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAIL,KAAK,EAIL,OAAO,EAEP,KAAK,MAAM,EACX,KAAK,QAAQ,EACd,MAAM,OAAO,CAAC;AAEf,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAKxD,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAK3D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;AAO/D,qBAAa,SAAS;IAkBlB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAnB1B,SAAgB,IAAI,QAAe;IAC5B,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAQ;IAC3C,OAAO,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,GAAG,CAAyB;IACpC,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,OAAO,CAAuB;gBAG5B,KAAK,EAAE,kBAAkB,EAChB,SAAS,EAAE,WAAW,EACtB,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,EAC9C,OAAO,EAAE,OAAO;IAOlB,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,IAAW,UAAU,IAAI,MAAM,GAAG,IAAI,CAErC;IAEM,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAIhD,OAAO,CAAC,WAAW;IAWZ,WAAW,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI;IA6B7D,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,SAAS;IA6BjB,OAAO,CAAC,MAAM;IAQd,oFAAoF;IAC7E,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAiBhD,8EAA8E;IACvE,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;IAYhD,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAIhC,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQjE,OAAO,CAAC,WAAW;IAsBZ,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA4BzD,OAAO,IAAI,IAAI;CAIvB"}

package/dist/agent.js

@@ -0,0 +1,232 @@
+/**
+ * The embodied agent's body: a model, four state clips, one-shot expressions,
+ * a gaze and a mouth.
+ *
+ * What it does NOT do is walk. `presence.idle` (`stand`/`wander`/`follow`) and
+ * `personalSpaceMetres` are facts about where the agent may go, and wayfinding
+ * is the host's — they are readable on `presence` and honoured by nobody here.
+ *
+ * Reduced motion always wins: state clips are held on their first frame (a
+ * pose, not a loop), expression one-shots are not played, gaze snaps rather
+ * than turns, and there is no crossfade. The mouth still follows visemes —
+ * speech is not decorative motion, and a mouth that never moves on a speaking
+ * agent would read as a broken one.
+ */
+import { AnimationClip, AnimationMixer, CapsuleGeometry, Group, LoopOnce, Mesh, SphereGeometry, Vector3, } from 'three';
+import { fitModel } from './model.js';
+import { wrapAngle } from './panel.js';
+import { createTextMesh } from './text.js';
+import { accentMaterial } from './theme-apply.js';
+import { WORLD_CONTRACT, WorldError } from './types.js';
+import { morphNamesFor, visemeAt } from './visemes.js';
+const TURN_RATE = 6;
+const FADE_S = 0.25;
+export class AgentBody {
+    theme;
+    loadModel;
+    onError;
+    root = new Group();
+    presence = null;
+    reduced;
+    model = null;
+    mixer = null;
+    clips = [];
+    current = null;
+    avatarUrl = null;
+    tag = null;
+    gaze = null;
+    track = null;
+    trackStart = 0;
+    morphs = [];
+    lastState = null;
+    refused = null;
+    constructor(theme, loadModel, onError, reduced) {
+        this.theme = theme;
+        this.loadModel = loadModel;
+        this.onError = onError;
+        this.reduced = reduced;
+        this.root.name = WORLD_CONTRACT.objects.agent;
+        this.root.add(this.placeholder());
+    }
+    get hasModel() {
+        return this.model !== null;
+    }
+    get activeClip() {
+        return this.current?.getClip().name ?? null;
+    }
+    setTheme(theme) {
+        this.theme = theme;
+    }
+    placeholder() {
+        const g = new Group();
+        g.name = 'cl3-agent-placeholder';
+        const body = new Mesh(new CapsuleGeometry(0.2, 0.7, 4, 12), accentMaterial(this.theme));
+        body.position.y = 0.55;
+        const head = new Mesh(new SphereGeometry(0.17, 16, 12), accentMaterial(this.theme));
+        head.position.y = 1.3;
+        g.add(body, head);
+        return g;
+    }
+    setPresence(presence) {
+        this.presence = presence;
+        this.setTag(presence === null ? null : (presence.nameTag ?? presence.name));
+        const a = presence?.avatar;
+        if (a?.format === 'usdz' && this.refused !== a.url) {
+            this.refused = a.url;
+            this.onError(new WorldError('unsupported_format', 'usdz avatars are not loadable by three.js; showing the placeholder'));
+        }
+        const url = a !== undefined && a.format !== 'usdz' ? a.url : null;
+        if (url === this.avatarUrl) {
+            return;
+        }
+        this.avatarUrl = url;
+        if (url === null || a === undefined) {
+            this.swapModel(null, []);
+            return;
+        }
+        this.loadModel(url).then((m) => {
+            if (this.avatarUrl === url) {
+                this.swapModel(fitModel(m.scene, a.scale ?? 1, a.anchor ?? 'base'), m.animations);
+            }
+        }, this.onError);
+    }
+    setTag(text) {
+        if (this.tag !== null) {
+            this.root.remove(this.tag);
+            this.tag = null;
+        }
+        if (text !== null) {
+            this.tag = createTextMesh(text, this.theme, { maxWidthMetres: 0.8, size: 0.8 });
+            this.tag.name = 'cl3-agent-nametag';
+            this.tag.position.y = 1.75;
+            this.root.add(this.tag);
+        }
+    }
+    swapModel(model, clips) {
+        this.mixer?.stopAllAction();
+        this.mixer = null;
+        this.current = null;
+        for (const c of [...this.root.children]) {
+            if (c !== this.tag) {
+                this.root.remove(c);
+            }
+        }
+        this.model = model;
+        this.clips = clips;
+        this.morphs = [];
+        if (model === null) {
+            this.root.add(this.placeholder());
+            return;
+        }
+        this.root.add(model);
+        model.traverse((o) => {
+            if (o.morphTargetDictionary !== undefined) {
+                this.morphs.push(o);
+            }
+        });
+        this.mixer = new AnimationMixer(model);
+        // The state was set before the model arrived; its clip could not play then.
+        if (this.lastState !== null) {
+            this.setState(this.lastState);
+        }
+    }
+    action(name) {
+        if (this.mixer === null || name === null || name === undefined) {
+            return null;
+        }
+        const clip = AnimationClip.findByName([...this.clips], name);
+        return clip === null ? null : this.mixer.clipAction(clip);
+    }
+    /** Move to the state's clip — the host's own name for it, from `presence.clips`. */
+    setState(state) {
+        this.lastState = state;
+        const next = this.action(this.presence?.clips?.[state]);
+        if (next === null || next === this.current) {
+            return;
+        }
+        next.reset();
+        next.play();
+        if (this.reduced) {
+            next.paused = true; // a held pose, not a loop
+            this.current?.stop();
+        }
+        else if (this.current !== null) {
+            next.crossFadeFrom(this.current, FADE_S, false);
+        }
+        this.current = next;
+    }
+    /** Play a one-shot expression clip. Skipped entirely under reduced motion. */
+    playExpression(clipName) {
+        const a = this.reduced ? null : this.action(clipName);
+        if (a === null) {
+            return false;
+        }
+        a.reset();
+        a.setLoop(LoopOnce, 1);
+        a.clampWhenFinished = true;
+        a.play();
+        return true;
+    }
+    lookAt(target) {
+        this.gaze = target;
+    }
+    setVisemes(track, nowMs) {
+        this.track = track;
+        this.trackStart = nowMs;
+        if (track === null) {
+            this.applyViseme(null, 0);
+        }
+    }
+    applyViseme(v, w) {
+        for (const m of this.morphs) {
+            const dict = m.morphTargetDictionary;
+            const inf = m.morphTargetInfluences;
+            if (dict === undefined || inf === undefined) {
+                continue;
+            }
+            // Zero every viseme-ish target first so a released mouth closes.
+            for (const [name, idx] of Object.entries(dict)) {
+                if (/^(viseme_|Viseme_)/.test(name) || ['aa', 'ih', 'ou', 'ee', 'oh'].includes(name)) {
+                    inf[idx] = 0;
+                }
+            }
+            if (v !== null) {
+                const hit = morphNamesFor(v).find((n) => dict[n] !== undefined);
+                if (hit !== undefined) {
+                    inf[dict[hit]] = w;
+                }
+            }
+        }
+    }
+    update(dtMs, nowMs, camera) {
+        this.mixer?.update(dtMs / 1000);
+        if (this.track !== null) {
+            const e = visemeAt(this.track, nowMs - this.trackStart);
+            this.applyViseme(e?.v ?? null, e?.w ?? 0);
+        }
+        if (this.gaze !== null) {
+            const here = this.root.getWorldPosition(new Vector3());
+            const at = this.gaze === 'visitor'
+                ? camera.getWorldPosition(new Vector3())
+                : this.gaze instanceof Vector3
+                    ? this.gaze
+                    : this.gaze.getWorldPosition(new Vector3());
+            const want = Math.atan2(at.x - here.x, at.z - here.z);
+            const err = wrapAngle(want - this.root.rotation.y);
+            const step = TURN_RATE * (dtMs / 1000);
+            this.root.rotation.y =
+                this.reduced || Math.abs(err) <= step ? want : this.root.rotation.y + Math.sign(err) * step;
+        }
+        if (this.tag !== null) {
+            // The tag turns to the viewer regardless of where the body faces.
+            const cam = camera.getWorldPosition(new Vector3());
+            const t = this.tag.getWorldPosition(new Vector3());
+            this.tag.rotation.y = Math.atan2(cam.x - t.x, cam.z - t.z) - this.root.rotation.y;
+        }
+    }
+    dispose() {
+        this.mixer?.stopAllAction();
+        this.root.removeFromParent();
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/bubble.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Speech bubbles, anchored to a speaker in space.
+ *
+ * A bubble is positioned from its SPEAKER'S world position — never from the
+ * camera, so it cannot be head-locked — and only turned to face the viewer.
+ * Its size grows with distance (clamped) so type stays legible across a room,
+ * which is why the text itself is built at one size and the whole bubble is
+ * scaled.
+ */
+import { Group, Vector3, type Camera, type Object3D } from 'three';
+import type { BubbleRenderProps, ConversationMessage, ResolvedWorldTheme } from '@chatlychat/core';
+export declare const MAX_BUBBLES = 3;
+/** Uniform scale for a bubble `distance` metres from the viewer. */
+export declare const bubbleScale: (distance: number) => number;
+export declare function defaultBubble(props: BubbleRenderProps): Object3D;
+/** The typing indicator: three dots, one pulsing dot, or nothing (`avatar`/`none` live on the body). */
+export declare function createTyping(theme: ResolvedWorldTheme): Group;
+/** Bob or pulse the dots. With reduced motion they sit still: a static ellipsis still says "typing". */
+export declare function animateTyping(typing: Object3D, nowMs: number, reduced: boolean): void;
+/** World-space point above a speaker's head. */
+export declare function headPoint(speaker: Object3D): Vector3;
+export interface LiveBubble {
+    readonly messageId: string;
+    readonly speaker: Object3D;
+    node: Object3D;
+    body: string;
+    readonly bornAt: number;
+}
+/**
+ * Re-anchor `node` over `speaker`: stack slot `slot` above the head, turned to
+ * the camera, scaled by distance. Called every frame, so a walking speaker
+ * carries its bubble.
+ */
+export declare function anchorBubble(node: Object3D, speaker: Object3D, camera: Camera, slot: number, parent: Object3D): void;
+export declare const speakerKind: (m: ConversationMessage) => "visitor" | "agent" | null;
+//# sourceMappingURL=bubble.d.ts.map

package/dist/bubble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bubble.d.ts","sourceRoot":"","sources":["../src/bubble.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAGL,KAAK,EAGL,OAAO,EACP,KAAK,MAAM,EACX,KAAK,QAAQ,EACd,MAAM,OAAO,CAAC;AAMf,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAOnG,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B,oEAAoE;AACpE,eAAO,MAAM,WAAW,aAAc,MAAM,KAAG,MACwB,CAAC;AAExE,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,QAAQ,CAwBhE;AAED,wGAAwG;AACxG,wBAAgB,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,KAAK,CAW7D;AAED,wGAAwG;AACxG,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAiBrF;AAED,gDAAgD;AAChD,wBAAgB,SAAS,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAKpD;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,QAAQ,GACf,IAAI,CAUN;AAED,eAAO,MAAM,WAAW,MAAO,mBAAmB,KAAG,SAAS,GAAG,OAAO,GAAG,IAK/D,CAAC"}

package/dist/bubble.js

@@ -0,0 +1,108 @@
+/**
+ * Speech bubbles, anchored to a speaker in space.
+ *
+ * A bubble is positioned from its SPEAKER'S world position — never from the
+ * camera, so it cannot be head-locked — and only turned to face the viewer.
+ * Its size grows with distance (clamped) so type stays legible across a room,
+ * which is why the text itself is built at one size and the whole bubble is
+ * scaled.
+ */
+import { Box3, ConeGeometry, Group, Mesh, SphereGeometry, Vector3, } from 'three';
+import { createTextMesh } from './text.js';
+import { accentMaterial, bubbleBacking } from './theme-apply.js';
+import { WORLD_CONTRACT } from './types.js';
+const REFERENCE_METRES = 2;
+const SCALE_MIN = 0.6;
+const SCALE_MAX = 2.5;
+const HEAD_FALLBACK = 1.9;
+const STACK_STEP = 0.22;
+export const MAX_BUBBLES = 3;
+/** Uniform scale for a bubble `distance` metres from the viewer. */
+export const bubbleScale = (distance) => Math.min(SCALE_MAX, Math.max(SCALE_MIN, distance / REFERENCE_METRES));
+export function defaultBubble(props) {
+    const { theme } = props;
+    const g = new Group();
+    g.name = WORLD_CONTRACT.objects.bubble;
+    const text = createTextMesh(props.message.body, theme, {
+        maxWidthMetres: theme.bubbleMaxWidthMetres,
+    });
+    const [w, h] = text.userData['size'];
+    const pad = 0.03;
+    const plate = bubbleBacking(theme, w + pad * 2, h + pad * 2);
+    if (plate !== null) {
+        g.add(plate);
+        if (theme.bubbleTail && theme.bubbleShape !== 'cloud') {
+            const tail = new Mesh(new ConeGeometry(0.025, 0.05, 3), plate.material);
+            tail.name = 'cl3-bubble-tail';
+            tail.position.set(0, -(h / 2 + pad + 0.02), 0);
+            tail.rotation.set(0, 0, Math.PI);
+            g.add(tail);
+        }
+    }
+    text.position.z = 0.002;
+    g.add(text);
+    g.userData['size'] = [w + pad * 2, h + pad * 2];
+    return g;
+}
+/** The typing indicator: three dots, one pulsing dot, or nothing (`avatar`/`none` live on the body). */
+export function createTyping(theme) {
+    const g = new Group();
+    g.name = WORLD_CONTRACT.objects.typing;
+    g.userData['look'] = theme.typingLook;
+    const dots = theme.typingLook === 'dots' ? 3 : theme.typingLook === 'pulse' ? 1 : 0;
+    for (let i = 0; i < dots; i += 1) {
+        const d = new Mesh(new SphereGeometry(0.02, 12, 8), accentMaterial(theme));
+        d.position.x = (i - (dots - 1) / 2) * 0.06;
+        g.add(d);
+    }
+    return g;
+}
+/** Bob or pulse the dots. With reduced motion they sit still: a static ellipsis still says "typing". */
+export function animateTyping(typing, nowMs, reduced) {
+    if (reduced) {
+        typing.children.forEach((c) => {
+            c.position.y = 0;
+            c.scale.setScalar(1);
+        });
+        return;
+    }
+    const pulse = typing.userData['look'] === 'pulse';
+    typing.children.forEach((c, i) => {
+        const phase = nowMs / 300 - i * 0.6;
+        if (pulse) {
+            c.scale.setScalar(1 + 0.4 * Math.sin(phase));
+        }
+        else {
+            c.position.y = 0.015 * Math.sin(phase);
+        }
+    });
+}
+/** World-space point above a speaker's head. */
+export function headPoint(speaker) {
+    speaker.updateWorldMatrix(true, true);
+    const box = new Box3().setFromObject(speaker);
+    const p = speaker.getWorldPosition(new Vector3());
+    return box.isEmpty() ? p.setY(p.y + HEAD_FALLBACK) : new Vector3(p.x, box.max.y + 0.2, p.z);
+}
+/**
+ * Re-anchor `node` over `speaker`: stack slot `slot` above the head, turned to
+ * the camera, scaled by distance. Called every frame, so a walking speaker
+ * carries its bubble.
+ */
+export function anchorBubble(node, speaker, camera, slot, parent) {
+    const head = headPoint(speaker);
+    const cam = camera.getWorldPosition(new Vector3());
+    const scale = bubbleScale(head.distanceTo(cam));
+    head.y += (slot * STACK_STEP + 0.1) * scale;
+    parent.worldToLocal(head);
+    node.position.copy(head);
+    const camLocal = parent.worldToLocal(cam.clone());
+    node.rotation.set(0, Math.atan2(camLocal.x - head.x, camLocal.z - head.z), 0);
+    node.scale.setScalar(scale);
+}
+export const speakerKind = (m) => m.authorType === 'contact'
+    ? 'visitor'
+    : m.authorType === 'agent' || m.authorType === 'bot'
+        ? 'agent'
+        : null;
+//# sourceMappingURL=bubble.js.map

package/dist/bubble.js.map

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