@chatlychat/world 0.0.0-stage → 0.1.0

package/dist/model.js

@@ -0,0 +1,60 @@
+/**
+ * glTF loading and the `anchor` a model asks for.
+ *
+ * Chatly references a model and never fetches, validates or sizes one, so
+ * this is where the host's world does: three's own GLTFLoader (imported
+ * lazily, so a conversation with no models never pays for it), the block's
+ * `scale` as a multiplier on the file's own size, and `anchor` as the named
+ * point of the model that sits at the placement's origin.
+ */
+import { Box3, Group, Vector3 } from 'three';
+export const MODEL_ANCHORS = ['center', 'base', 'top', 'back'];
+export const gltfLoader = () => {
+    let loader = null;
+    return async (url) => {
+        if (loader === null) {
+            const { GLTFLoader } = await import('three/examples/jsm/loaders/GLTFLoader.js');
+            loader = new GLTFLoader();
+        }
+        return loader.loadAsync(url);
+    };
+};
+/** Load each URL once; every caller gets its own clone, because a scene can have one parent. */
+export const cachedLoader = (load) => {
+    const cache = new Map();
+    return async (url) => {
+        let p = cache.get(url);
+        if (p === undefined) {
+            p = load(url);
+            cache.set(url, p);
+            // A failure is not cached: the next card gets a fresh attempt.
+            p.catch(() => cache.delete(url));
+        }
+        const m = await p;
+        return { scene: m.scene.clone(true), animations: m.animations };
+    };
+};
+/** The translation that moves `anchor` of `box` to the origin. */
+export function anchorOffset(box, anchor) {
+    const c = box.getCenter(new Vector3());
+    const p = anchor === 'base'
+        ? new Vector3(c.x, box.min.y, c.z)
+        : anchor === 'top'
+            ? new Vector3(c.x, box.max.y, c.z)
+            : anchor === 'back'
+                ? new Vector3(c.x, c.y, box.min.z)
+                : c;
+    return p.negate();
+}
+/** Wrap a loaded scene so its scale and anchor are applied and the wrapper sits at the origin. */
+export function fitModel(model, scale = 1, anchor = 'center') {
+    const inner = new Group();
+    inner.add(model);
+    inner.scale.setScalar(scale);
+    inner.updateMatrixWorld(true);
+    model.position.copy(anchorOffset(new Box3().setFromObject(inner), anchor).divideScalar(scale));
+    const outer = new Group();
+    outer.add(inner);
+    return outer;
+}
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

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

package/dist/motion.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Entrance and pick animation, and the one switch that stops all of it.
+ *
+ * Reduced motion is a viewer's accessibility setting, so it is enforced HERE
+ * rather than asked of each caller: with it on, `run` applies the final frame
+ * synchronously and schedules nothing. A renderer that animates through this
+ * cannot forget to honour it.
+ */
+import type { Object3D } from 'three';
+export type Easing = (t: number) => number;
+export declare const easeOut: Easing;
+export declare class Motion {
+    private readonly tweens;
+    reduced: boolean;
+    constructor(reduced: boolean);
+    /** `apply(0..1)`; always ends with `apply(1)`. */
+    run(durationMs: number, apply: (t: number) => void): void;
+    update(dtMs: number): void;
+    get running(): number;
+    clear(): void;
+}
+/** Set opacity on every material under `obj`. Materials are made transparent first. */
+export declare function setOpacity(obj: Object3D, k: number): void;
+export type Entrance = 'fade' | 'scale' | 'slide' | 'none';
+/** The theme's `motionEntrance` applied to a freshly built object. */
+export declare function enter(motion: Motion, obj: Object3D, kind: Entrance, durationMs?: number): void;
+//# sourceMappingURL=motion.d.ts.map

package/dist/motion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.d.ts","sourceRoot":"","sources":["../src/motion.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAC3C,eAAO,MAAM,OAAO,EAAE,MAAgC,CAAC;AAQvD,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IACpC,OAAO,EAAE,OAAO,CAAC;gBAEL,OAAO,EAAE,OAAO;IAInC,kDAAkD;IAC3C,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IASzD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAWjC,IAAW,OAAO,IAAI,MAAM,CAE3B;IAEM,KAAK,IAAI,IAAI;CAGrB;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAUzD;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3D,sEAAsE;AACtE,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,SAAM,GAAG,IAAI,CAe3F"}

package/dist/motion.js

@@ -0,0 +1,65 @@
+export const easeOut = (t) => 1 - (1 - t) ** 3;
+export class Motion {
+    tweens = new Set();
+    reduced;
+    constructor(reduced) {
+        this.reduced = reduced;
+    }
+    /** `apply(0..1)`; always ends with `apply(1)`. */
+    run(durationMs, apply) {
+        if (this.reduced || durationMs <= 0) {
+            apply(1);
+            return;
+        }
+        apply(0);
+        this.tweens.add({ elapsed: 0, duration: durationMs, apply });
+    }
+    update(dtMs) {
+        for (const tw of [...this.tweens]) {
+            tw.elapsed += dtMs;
+            const t = Math.min(1, tw.elapsed / tw.duration);
+            tw.apply(easeOut(t));
+            if (t >= 1) {
+                this.tweens.delete(tw);
+            }
+        }
+    }
+    get running() {
+        return this.tweens.size;
+    }
+    clear() {
+        this.tweens.clear();
+    }
+}
+/** Set opacity on every material under `obj`. Materials are made transparent first. */
+export function setOpacity(obj, k) {
+    obj.traverse((o) => {
+        const mats = o.material;
+        for (const m of Array.isArray(mats) ? mats : mats === undefined ? [] : [mats]) {
+            const mat = m;
+            mat.userData.base ??= mat.opacity;
+            mat.transparent = true;
+            mat.opacity = mat.userData.base * k;
+        }
+    });
+}
+/** The theme's `motionEntrance` applied to a freshly built object. */
+export function enter(motion, obj, kind, durationMs = 250) {
+    if (kind === 'none') {
+        return;
+    }
+    const y = obj.position.y;
+    const s = obj.scale.x;
+    motion.run(durationMs, (t) => {
+        if (kind === 'fade') {
+            setOpacity(obj, t);
+        }
+        else if (kind === 'scale') {
+            obj.scale.setScalar(Math.max(0.001, s * t));
+        }
+        else {
+            obj.position.y = y - 0.1 * (1 - t);
+        }
+    });
+}
+//# sourceMappingURL=motion.js.map

package/dist/motion.js.map

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

package/dist/panel.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The world-space panel and its composer, and how they follow the viewer.
+ *
+ * A panel is NEVER head-locked. A surface welded to the head is nauseating
+ * within seconds, so a `locked` placement is honoured as `lazy` — the host
+ * abilities the world resolves against simply do not offer it. The three
+ * modes are:
+ *
+ *  - `fixed`: placed once, where the viewer was looking, and left there;
+ *  - `lazy`: left alone until the viewer turns or walks past a dead zone, then
+ *    eased into place (snapped, with reduced motion);
+ *  - `wrist`: carried on a host-supplied controller or hand.
+ */
+import { Group, Vector3, type Camera, type Object3D } from 'three';
+import type { PanelFollow } from './types.js';
+import type { ComposerRenderProps, PanelRenderProps, ResolvedWorldPlacement } from '@chatlychat/core';
+/** ─────────────────────────── follow math (pure) ─────────────────────────── */
+export interface FollowPose {
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+    readonly yaw: number;
+}
+export interface FollowState extends FollowPose {
+    readonly chasing: boolean;
+}
+export declare const DEAD_YAW: number;
+export declare const DEAD_METRES = 0.5;
+export declare const wrapAngle: (a: number) => number;
+/**
+ * One step of lazy follow, with hysteresis: the panel stays put until the
+ * viewer leaves the dead zone, then chases until it has all but arrived, so it
+ * never creeps on every small head movement.
+ */
+export declare function lazyStep(cur: FollowState, want: FollowPose, dtMs: number, reduced: boolean): FollowState;
+/** The follow mode a resolved placement means. `locked` never survives resolution, but be sure. */
+export declare function followMode(placement: ResolvedWorldPlacement, override?: PanelFollow): PanelFollow;
+export interface RigContext {
+    readonly camera: Camera;
+    readonly reduced: boolean;
+    readonly agent: Object3D | null;
+    readonly place: Object3D | Vector3 | null;
+    readonly wrist: Object3D | null;
+}
+/** Holds the panel + composer group and moves it per the follow mode. */
+export declare class PanelRig {
+    private readonly parent;
+    private readonly placement;
+    private mode;
+    readonly group: Group;
+    private state;
+    private placed;
+    private wristed;
+    constructor(parent: Object3D, placement: ResolvedWorldPlacement, mode: PanelFollow);
+    get follow(): PanelFollow;
+    /** Where the placement wants the panel, in parent-local space. */
+    private want;
+    update(dtMs: number, ctx: RigContext): void;
+}
+export declare const PANEL_LABELS: {
+    readonly you: "You";
+    readonly agent: "Agent";
+    readonly typing: "is typing…";
+};
+export declare function defaultPanel(props: PanelRenderProps): Object3D;
+/** What the default composer reads and calls. The world owns one; an override uses `props.send`. */
+export interface ComposerState {
+    readonly draft: string;
+    readonly submit: () => void;
+    readonly requestInput: () => void;
+}
+export declare const COMPOSER_LABELS: {
+    readonly placeholder: "Reply…";
+    readonly send: "Send";
+};
+export declare function defaultComposer(props: ComposerRenderProps, state: ComposerState, width: number): Object3D;
+//# sourceMappingURL=panel.d.ts.map

package/dist/panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../src/panel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,KAAK,EAIL,OAAO,EACP,KAAK,MAAM,EACX,KAAK,QAAQ,EACd,MAAM,OAAO,CAAC;AAOf,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,kBAAkB,CAAC;AAE1B,iFAAiF;AAEjF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,QAAQ,QAAuB,CAAC;AAC7C,eAAO,MAAM,WAAW,MAAM,CAAC;AAK/B,eAAO,MAAM,SAAS,MAAO,MAAM,KAAG,MAA8C,CAAC;AAErF;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACf,WAAW,CAiBb;AAED,mGAAmG;AACnG,wBAAgB,UAAU,CAAC,SAAS,EAAE,sBAAsB,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,WAAW,CAEjG;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CACjC;AAID,yEAAyE;AACzE,qBAAa,QAAQ;IAOjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,IAAI;IARd,SAAgB,KAAK,QAAe;IACpC,OAAO,CAAC,KAAK,CAA6D;IAC1E,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAyB;gBAGrB,MAAM,EAAE,QAAQ,EAChB,SAAS,EAAE,sBAAsB,EAC1C,IAAI,EAAE,WAAW;IAM3B,IAAW,MAAM,IAAI,WAAW,CAE/B;IAED,kEAAkE;IAClE,OAAO,CAAC,IAAI;IAqCL,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI;CA6BnD;AAKD,eAAO,MAAM,YAAY;;;;CAAgE,CAAC;AAE1F,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,QAAQ,CA0B9D;AAED,oGAAoG;AACpG,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC;CACnC;AAED,eAAO,MAAM,eAAe;;;CAAmD,CAAC;AAIhF,wBAAgB,eAAe,CAC7B,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,GACZ,QAAQ,CAiDV"}

package/dist/panel.js

@@ -0,0 +1,214 @@
+/**
+ * The world-space panel and its composer, and how they follow the viewer.
+ *
+ * A panel is NEVER head-locked. A surface welded to the head is nauseating
+ * within seconds, so a `locked` placement is honoured as `lazy` — the host
+ * abilities the world resolves against simply do not offer it. The three
+ * modes are:
+ *
+ *  - `fixed`: placed once, where the viewer was looking, and left there;
+ *  - `lazy`: left alone until the viewer turns or walks past a dead zone, then
+ *    eased into place (snapped, with reduced motion);
+ *  - `wrist`: carried on a host-supplied controller or hand.
+ */
+import { Group, Mesh, MeshBasicMaterial, PlaneGeometry, Vector3, } from 'three';
+import { interactive } from './input.js';
+import { createTextMesh } from './text.js';
+import { panelBacking } from './theme-apply.js';
+import { WORLD_CONTRACT } from './types.js';
+export const DEAD_YAW = (35 * Math.PI) / 180;
+export const DEAD_METRES = 0.5;
+const STOP_YAW = (2 * Math.PI) / 180;
+const STOP_METRES = 0.03;
+const RATE_PER_S = 4;
+export const wrapAngle = (a) => Math.atan2(Math.sin(a), Math.cos(a));
+/**
+ * One step of lazy follow, with hysteresis: the panel stays put until the
+ * viewer leaves the dead zone, then chases until it has all but arrived, so it
+ * never creeps on every small head movement.
+ */
+export function lazyStep(cur, want, dtMs, reduced) {
+    const dx = want.x - cur.x;
+    const dy = want.y - cur.y;
+    const dz = want.z - cur.z;
+    const dist = Math.hypot(dx, dy, dz);
+    const dyaw = wrapAngle(want.yaw - cur.yaw);
+    const chasing = cur.chasing || Math.abs(dyaw) > DEAD_YAW || dist > DEAD_METRES;
+    if (!chasing) {
+        return cur;
+    }
+    if (reduced) {
+        return { ...want, chasing: false };
+    }
+    const k = 1 - Math.exp((-RATE_PER_S * dtMs) / 1000);
+    const next = { x: cur.x + dx * k, y: cur.y + dy * k, z: cur.z + dz * k, yaw: cur.yaw + dyaw * k };
+    const arrived = dist * (1 - k) < STOP_METRES && Math.abs(dyaw) * (1 - k) < STOP_YAW;
+    return { ...next, chasing: !arrived };
+}
+/** The follow mode a resolved placement means. `locked` never survives resolution, but be sure. */
+export function followMode(placement, override) {
+    return override ?? (placement.follow === 'none' ? 'fixed' : 'lazy');
+}
+const WRIST_WIDTH = 0.3;
+/** Holds the panel + composer group and moves it per the follow mode. */
+export class PanelRig {
+    parent;
+    placement;
+    mode;
+    group = new Group();
+    state = { x: 0, y: 0, z: 0, yaw: 0, chasing: false };
+    placed = false;
+    wristed = null;
+    constructor(parent, placement, mode) {
+        this.parent = parent;
+        this.placement = placement;
+        this.mode = mode;
+        this.group.name = 'cl3-panel-rig';
+        parent.add(this.group);
+    }
+    get follow() {
+        return this.mode;
+    }
+    /** Where the placement wants the panel, in parent-local space. */
+    want(ctx) {
+        const p = this.placement;
+        const cam = ctx.camera.getWorldPosition(new Vector3());
+        const dir = ctx.camera.getWorldDirection(new Vector3());
+        const fwd = new Vector3(dir.x, 0, dir.z);
+        if (fwd.lengthSq() < 1e-6) {
+            fwd.set(0, 0, -1);
+        }
+        fwd.normalize();
+        let pos;
+        if (p.anchor === 'agent' && ctx.agent !== null) {
+            const a = ctx.agent.getWorldPosition(new Vector3());
+            const toCam = new Vector3(cam.x - a.x, 0, cam.z - a.z).normalize();
+            pos = a.add(toCam.multiplyScalar(p.distanceMetres)).setY(a.y + 1.4 + p.heightMetres);
+        }
+        else if (p.anchor === 'place' && ctx.place !== null) {
+            const o = ctx.place instanceof Vector3
+                ? ctx.place.clone()
+                : ctx.place.getWorldPosition(new Vector3());
+            pos = o.setY(o.y + 1.2 + p.heightMetres);
+        }
+        else if (p.anchor === 'world') {
+            pos = this.parent.getWorldPosition(new Vector3());
+            pos.y += 1.4 + p.heightMetres;
+            pos.z -= p.distanceMetres;
+        }
+        else {
+            pos = cam.clone().addScaledVector(fwd, p.distanceMetres);
+            pos.y = cam.y + p.heightMetres;
+        }
+        this.parent.worldToLocal(pos);
+        const camLocal = this.parent.worldToLocal(cam.clone());
+        const yaw = p.billboard === 'none' && this.placed
+            ? this.state.yaw
+            : Math.atan2(camLocal.x - pos.x, camLocal.z - pos.z);
+        return { x: pos.x, y: pos.y, z: pos.z, yaw };
+    }
+    update(dtMs, ctx) {
+        if (this.mode === 'wrist' && ctx.wrist !== null) {
+            if (this.wristed !== ctx.wrist) {
+                ctx.wrist.add(this.group);
+                this.wristed = ctx.wrist;
+                this.group.position.set(0, 0.12, -0.05);
+                this.group.rotation.set(-Math.PI / 3, 0, 0);
+                this.group.scale.setScalar(WRIST_WIDTH / this.placement.widthMetres);
+            }
+            return;
+        }
+        if (this.wristed !== null) {
+            // The wrist went away: come back into the scene rather than vanish with it.
+            this.parent.add(this.group);
+            this.group.scale.setScalar(1);
+            this.group.rotation.set(0, 0, 0);
+            this.wristed = null;
+            this.placed = false;
+        }
+        const want = this.want(ctx);
+        if (!this.placed) {
+            this.state = { ...want, chasing: false };
+            this.placed = true;
+        }
+        else if (this.mode === 'lazy') {
+            this.state = lazyStep(this.state, want, dtMs, ctx.reduced);
+        }
+        this.group.position.set(this.state.x, this.state.y, this.state.z);
+        this.group.rotation.set(0, this.state.yaw, 0);
+    }
+}
+/** ─────────────────────────── default renderers ─────────────────────────── */
+const MAX_LINES = 6;
+export const PANEL_LABELS = { you: 'You', agent: 'Agent', typing: 'is typing…' };
+export function defaultPanel(props) {
+    const { theme, placement } = props;
+    const width = placement.widthMetres;
+    const lines = props.messages
+        .filter((m) => m.deletedAt === null && !m.hiddenFromContact && m.kind !== 'system_event' && m.body !== '')
+        .slice(-MAX_LINES)
+        .map((m) => `${m.authorType === 'contact' ? PANEL_LABELS.you : PANEL_LABELS.agent}: ${m.body}`);
+    if (props.typing !== null) {
+        lines.push(`${props.typing.displayName ?? PANEL_LABELS.agent} ${PANEL_LABELS.typing}`);
+    }
+    const g = new Group();
+    g.name = WORLD_CONTRACT.objects.panel;
+    const text = createTextMesh(lines.join('\n'), theme, { maxWidthMetres: width - 0.04 });
+    const [, th] = text.userData['size'];
+    const height = th + 0.04;
+    const back = panelBacking(theme, width, height);
+    if (back !== null) {
+        g.add(back);
+    }
+    text.position.z = 0.002;
+    g.add(text);
+    g.userData['size'] = [width, height];
+    return g;
+}
+export const COMPOSER_LABELS = { placeholder: 'Reply…', send: 'Send' };
+const FIELD_H = 0.07;
+const SEND_W = 0.12;
+export function defaultComposer(props, state, width) {
+    const { theme } = props;
+    const g = new Group();
+    g.name = WORLD_CONTRACT.objects.composer;
+    const fieldW = width - SEND_W - 0.01;
+    const field = new Group();
+    field.position.x = -(width - fieldW) / 2;
+    const fb = panelBacking(theme, fieldW, FIELD_H);
+    if (fb !== null) {
+        field.add(fb);
+    }
+    else {
+        field.add(new Mesh(new PlaneGeometry(fieldW, FIELD_H), new MeshBasicMaterial({ visible: false })));
+    }
+    const shown = state.draft === '' ? COMPOSER_LABELS.placeholder : state.draft;
+    const label = createTextMesh(shown, theme, {
+        maxWidthMetres: fieldW - 0.02,
+        size: 0.8,
+    });
+    label.position.z = 0.002;
+    field.add(label);
+    interactive(field, 'field', state.requestInput);
+    g.add(field);
+    const send = new Group();
+    send.position.x = (width - SEND_W) / 2;
+    const sb = panelBacking({ ...theme, panelColor: theme.accentColor, panelMaterial: 'solid' }, SEND_W, FIELD_H);
+    if (sb !== null) {
+        send.add(sb);
+    }
+    const sl = createTextMesh(COMPOSER_LABELS.send, theme, {
+        maxWidthMetres: SEND_W,
+        size: 0.8,
+        color: theme.accentTextColor,
+    });
+    sl.position.z = 0.002;
+    send.add(sl);
+    if (!props.disabled) {
+        interactive(send, 'send', state.submit);
+    }
+    g.add(send);
+    g.userData['size'] = [width, FIELD_H];
+    return g;
+}
+//# sourceMappingURL=panel.js.map

package/dist/panel.js.map

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

package/dist/selection.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The shared selection: one picked card, visible to every renderer and to the
+ * host. A pick the visitor taps and a pick the host selects from its own
+ * inventory UI are the same event.
+ */
+export type SelectionListener = (id: string | null) => void;
+export declare class Selection {
+    private current;
+    private readonly listeners;
+    get id(): string | null;
+    set(id: string | null): void;
+    subscribe: (l: SelectionListener) => (() => void);
+}
+//# sourceMappingURL=selection.d.ts.map

package/dist/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../src/selection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;AAE5D,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAE1D,IAAW,EAAE,IAAI,MAAM,GAAG,IAAI,CAE7B;IAEM,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAU5B,SAAS,MAAO,iBAAiB,KAAG,CAAC,MAAM,IAAI,CAAC,CAGrD;CACH"}

package/dist/selection.js

@@ -0,0 +1,21 @@
+export class Selection {
+    current = null;
+    listeners = new Set();
+    get id() {
+        return this.current;
+    }
+    set(id) {
+        if (id === this.current) {
+            return;
+        }
+        this.current = id;
+        for (const l of [...this.listeners]) {
+            l(id);
+        }
+    }
+    subscribe = (l) => {
+        this.listeners.add(l);
+        return () => this.listeners.delete(l);
+    };
+}
+//# sourceMappingURL=selection.js.map

package/dist/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../src/selection.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,SAAS;IACZ,OAAO,GAAkB,IAAI,CAAC;IACrB,SAAS,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE1D,IAAW,EAAE;QACX,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAEM,GAAG,CAAC,EAAiB;QAC1B,IAAI,EAAE,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACpC,CAAC,CAAC,EAAE,CAAC,CAAC;QACR,CAAC;IACH,CAAC;IAEM,SAAS,GAAG,CAAC,CAAoB,EAAgB,EAAE;QACxD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACtB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC;CACH"}

package/dist/text.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Text on a plane, styled by the resolved `worldTheme`.
+ *
+ * Text is drawn to a canvas texture when a canvas exists. Without one (a
+ * Node test, a worker) the mesh is still built — same geometry, same
+ * material, `userData.text` set — just with no map, which is what lets the
+ * scene-graph specs run with no GL and no DOM.
+ *
+ * Layout is measured by a fixed advance (half an em per character) rather
+ * than by the canvas, so a plane's size is the same in a browser and in a
+ * test, and wrapping never depends on which font happened to load.
+ */
+import { Mesh } from 'three';
+import type { ResolvedWorldTheme } from '@chatlychat/core';
+/** Metres of cap-height-ish type at textScale 1: legible at arm's length. */
+export declare const BASE_FONT_METRES = 0.035;
+export interface TextOptions {
+    readonly maxWidthMetres: number;
+    /** Multiplier on `BASE_FONT_METRES`, on top of the theme's `textScale`. */
+    readonly size?: number;
+    readonly color?: string;
+}
+export declare function wrapText(text: string, maxChars: number): string[];
+export declare function ensureFont(url: string | null): void;
+export declare function createTextMesh(text: string, theme: ResolvedWorldTheme, opts: TextOptions): Mesh;
+//# sourceMappingURL=text.d.ts.map

package/dist/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAiB,IAAI,EAAuD,MAAM,OAAO,CAAC;AAEjG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAMtC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBjE;AAID,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAmBnD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAmD/F"}