@chatlychat/world 0.0.0-stage → 0.2.0

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"}

package/dist/text.js

@@ -0,0 +1,100 @@
+/**
+ * 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 { CanvasTexture, Mesh, MeshStandardMaterial, PlaneGeometry, SRGBColorSpace } from 'three';
+/** Metres of cap-height-ish type at textScale 1: legible at arm's length. */
+export const BASE_FONT_METRES = 0.035;
+const ADVANCE = 0.5;
+const LINE_HEIGHT = 1.3;
+const MAX_CANVAS_PX = 2048;
+const FONT_FAMILY = 'cl3-font, system-ui, sans-serif';
+export function wrapText(text, maxChars) {
+    const lines = [];
+    for (const para of text.split('\n')) {
+        let line = '';
+        for (const word of para.split(/\s+/).filter(Boolean)) {
+            const w = word.length > maxChars ? word.slice(0, maxChars - 1) + '…' : word;
+            if (line !== '' && line.length + 1 + w.length > maxChars) {
+                lines.push(line);
+                line = w;
+            }
+            else {
+                line = line === '' ? w : `${line} ${w}`;
+            }
+        }
+        lines.push(line);
+    }
+    return lines;
+}
+/** Load the theme's font once; text drawn before it arrives uses the fallback. */
+const loadedFonts = new Set();
+export function ensureFont(url) {
+    const g = globalThis;
+    if (url === null ||
+        loadedFonts.has(url) ||
+        g.FontFace === undefined ||
+        g.document?.fonts === undefined) {
+        return;
+    }
+    loadedFonts.add(url);
+    const face = new g.FontFace('cl3-font', `url(${JSON.stringify(url)})`);
+    face.load().then(() => g.document?.fonts?.add(face), () => loadedFonts.delete(url));
+}
+export function createTextMesh(text, theme, opts) {
+    const font = BASE_FONT_METRES * theme.textScale * (opts.size ?? 1);
+    const maxChars = Math.max(4, Math.floor(opts.maxWidthMetres / (font * ADVANCE)));
+    const lines = wrapText(text, maxChars);
+    const longest = Math.max(1, ...lines.map((l) => l.length));
+    const width = Math.min(opts.maxWidthMetres, longest * font * ADVANCE + font);
+    const height = lines.length * font * LINE_HEIGHT + font * 0.4;
+    const color = opts.color ?? theme.textColor;
+    const material = new MeshStandardMaterial({
+        color: '#ffffff',
+        emissive: '#ffffff',
+        emissiveIntensity: theme.textEmissive,
+        transparent: true,
+        roughness: 1,
+        metalness: 0,
+    });
+    const mesh = new Mesh(new PlaneGeometry(width, height), material);
+    mesh.userData['text'] = text;
+    mesh.userData['lines'] = lines;
+    mesh.userData['size'] = [width, height];
+    const canvas = globalThis.document?.createElement('canvas');
+    const ctx = canvas?.getContext('2d') ?? null;
+    if (canvas !== undefined && ctx !== null) {
+        const pxPerMetre = Math.min(1200, MAX_CANVAS_PX / width);
+        canvas.width = Math.ceil(width * pxPerMetre);
+        canvas.height = Math.ceil(height * pxPerMetre);
+        const fontPx = font * pxPerMetre;
+        ctx.font = `${String(theme.fontWeight)} ${String(fontPx)}px ${FONT_FAMILY}`;
+        ctx.textBaseline = 'top';
+        ctx.lineJoin = 'round';
+        lines.forEach((l, i) => {
+            const y = fontPx * 0.2 + i * fontPx * LINE_HEIGHT;
+            if (theme.textOutlineWidth > 0) {
+                ctx.strokeStyle = theme.textOutlineColor;
+                ctx.lineWidth = theme.textOutlineWidth * pxPerMetre * 2;
+                ctx.strokeText(l, fontPx / 2, y);
+            }
+            ctx.fillStyle = color;
+            ctx.fillText(l, fontPx / 2, y);
+        });
+        const map = new CanvasTexture(canvas);
+        map.colorSpace = SRGBColorSpace;
+        material.map = map;
+        material.emissiveMap = map;
+        material.needsUpdate = true;
+    }
+    return mesh;
+}
+//# sourceMappingURL=text.js.map

package/dist/text.js.map

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

package/dist/theme-apply.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `worldTheme` tokens -> three.js materials and shapes. Every token a
+ * renderer needs comes through here, so a default renderer and a host's own
+ * override read the same look from one place.
+ */
+import { Mesh, MeshBasicMaterial, MeshPhysicalMaterial, MeshStandardMaterial, ShapeGeometry } from 'three';
+import type { ResolvedWorldTheme } from '@chatlychat/core';
+type Surface = MeshStandardMaterial | MeshPhysicalMaterial;
+/** The panel's fill, or null for `panelMaterial: 'none'` (text floats on nothing). */
+export declare function panelSurface(theme: ResolvedWorldTheme, color?: string): Surface | null;
+/** A rounded rectangle centred on the origin, in the xy plane. */
+export declare function roundedRect(width: number, height: number, radius: number): ShapeGeometry;
+/** The panel's backing plate, or null when the material is `none`. */
+export declare function panelBacking(theme: ResolvedWorldTheme, width: number, height: number): Mesh | null;
+/** A speech bubble's plate: `none` has no plate, `square` has no radius, `cloud` is extra round. */
+export declare function bubbleBacking(theme: ResolvedWorldTheme, width: number, height: number): Mesh | null;
+export declare function accentMaterial(theme: ResolvedWorldTheme, opacity?: number): MeshBasicMaterial;
+export {};
+//# sourceMappingURL=theme-apply.d.ts.map

package/dist/theme-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-apply.d.ts","sourceRoot":"","sources":["../src/theme-apply.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAEL,IAAI,EACJ,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EAGpB,aAAa,EACd,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,KAAK,OAAO,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAE3D,sFAAsF;AACtF,wBAAgB,YAAY,CAC1B,KAAK,EAAE,kBAAkB,EACzB,KAAK,GAAE,MAAyB,GAC/B,OAAO,GAAG,IAAI,CAyBhB;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAexF;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAC1B,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,GAAG,IAAI,CAQb;AAED,oGAAoG;AACpG,wBAAgB,aAAa,CAC3B,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,GAAG,IAAI,CAsBb;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,SAAI,GAAG,iBAAiB,CAOxF"}

package/dist/theme-apply.js

@@ -0,0 +1,88 @@
+/**
+ * `worldTheme` tokens -> three.js materials and shapes. Every token a
+ * renderer needs comes through here, so a default renderer and a host's own
+ * override read the same look from one place.
+ */
+import { DoubleSide, Mesh, MeshBasicMaterial, MeshPhysicalMaterial, MeshStandardMaterial, PlaneGeometry, Shape, ShapeGeometry, } from 'three';
+/** The panel's fill, or null for `panelMaterial: 'none'` (text floats on nothing). */
+export function panelSurface(theme, color = theme.panelColor) {
+    if (theme.panelMaterial === 'none') {
+        return null;
+    }
+    const common = {
+        color,
+        emissive: color,
+        emissiveIntensity: theme.panelEmissive,
+        side: DoubleSide,
+    };
+    if (theme.panelMaterial === 'glass') {
+        return new MeshPhysicalMaterial({
+            ...common,
+            transparent: true,
+            opacity: theme.panelOpacity,
+            transmission: 0.6,
+            roughness: 0.15,
+        });
+    }
+    return new MeshStandardMaterial({
+        ...common,
+        transparent: theme.panelMaterial !== 'solid' && theme.panelOpacity < 1,
+        opacity: theme.panelMaterial === 'solid' ? 1 : theme.panelOpacity,
+        roughness: theme.panelMaterial === 'matte' ? 1 : 0.4,
+    });
+}
+/** A rounded rectangle centred on the origin, in the xy plane. */
+export function roundedRect(width, height, radius) {
+    const r = Math.min(radius, width / 2, height / 2);
+    const x = -width / 2;
+    const y = -height / 2;
+    const s = new Shape();
+    s.moveTo(x + r, y);
+    s.lineTo(x + width - r, y);
+    s.quadraticCurveTo(x + width, y, x + width, y + r);
+    s.lineTo(x + width, y + height - r);
+    s.quadraticCurveTo(x + width, y + height, x + width - r, y + height);
+    s.lineTo(x + r, y + height);
+    s.quadraticCurveTo(x, y + height, x, y + height - r);
+    s.lineTo(x, y + r);
+    s.quadraticCurveTo(x, y, x + r, y);
+    return new ShapeGeometry(s);
+}
+/** The panel's backing plate, or null when the material is `none`. */
+export function panelBacking(theme, width, height) {
+    const mat = panelSurface(theme);
+    if (mat === null) {
+        return null;
+    }
+    const mesh = new Mesh(roundedRect(width, height, theme.panelRadiusMetres), mat);
+    mesh.name = 'cl3-panel-backing';
+    return mesh;
+}
+/** A speech bubble's plate: `none` has no plate, `square` has no radius, `cloud` is extra round. */
+export function bubbleBacking(theme, width, height) {
+    const shape = theme.bubbleShape;
+    if (shape === 'none') {
+        return null;
+    }
+    const mat = new MeshStandardMaterial({
+        color: theme.bubbleColor,
+        emissive: theme.bubbleColor,
+        emissiveIntensity: theme.panelEmissive,
+        side: DoubleSide,
+    });
+    const geometry = shape === 'square'
+        ? new PlaneGeometry(width, height)
+        : roundedRect(width, height, shape === 'cloud' ? height / 2 : Math.max(theme.panelRadiusMetres, 0.03));
+    const mesh = new Mesh(geometry, mat);
+    mesh.userData['shape'] = shape;
+    return mesh;
+}
+export function accentMaterial(theme, opacity = 1) {
+    return new MeshBasicMaterial({
+        color: theme.accentColor,
+        transparent: opacity < 1,
+        opacity,
+        side: DoubleSide,
+    });
+}
+//# sourceMappingURL=theme-apply.js.map

package/dist/theme-apply.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * The public contract: options, anchors, errors, and the renderer contract's
+ * names and version.
+ */
+import type { ModelLoader } from './model.js';
+import type { VrmModuleLoader } from './vrm.js';
+import type { AgentWorldPresence, Conversation, PresenceMap, WorldHostAbilities, WorldPlacementRequest, WorldRenderers, WorldTheme } from '@chatlychat/core';
+import type { Camera, Object3D, Vector3 } from 'three';
+/**
+ * The renderer contract, versioned like the widget's `cl-` class contract.
+ *
+ * `objects` are the `Object3D.name` every default renderer gives its output,
+ * and the world gives the same name to an override's output when the override
+ * left it blank, so `scene.getObjectByName('cl3-card')` finds the card
+ * whoever drew it. A name is part of the contract: renaming one is a major
+ * version, adding one is a minor. A host that pins `contract: 1` on its
+ * renderers is refused, loudly, by a world that no longer speaks it.
+ */
+export declare const WORLD_CONTRACT: {
+    readonly version: 1;
+    readonly renderers: readonly ["renderCard", "renderPick", "renderBubble", "renderPanel", "renderComposer", "renderAgent"];
+    readonly objects: {
+        readonly root: "cl3-world";
+        readonly grid: "cl3-grid";
+        readonly card: "cl3-card";
+        readonly pick: "cl3-pick";
+        readonly bubble: "cl3-bubble";
+        readonly typing: "cl3-typing";
+        readonly panel: "cl3-panel";
+        readonly composer: "cl3-composer";
+        readonly agent: "cl3-agent";
+    };
+};
+export type WorldObjectName = (typeof WORLD_CONTRACT.objects)[keyof typeof WORLD_CONTRACT.objects];
+export type WorldNodeRenderers = WorldRenderers<Object3D> & {
+    /** Pin the contract version these renderers were written against. */
+    readonly contract?: number;
+};
+export type WorldErrorCode = 'unsupported_contract' | 'disposed' | 'unknown_action' | 'unsupported_format' | 'missing_peer';
+export declare class WorldError extends Error {
+    readonly code: WorldErrorCode;
+    constructor(code: WorldErrorCode, message: string);
+}
+/** The slice of a `Conversation` the world uses, so a test or a proxy can stand in. */
+export type ConversationLike = Pick<Conversation, 'conversationId' | 'getSnapshot' | 'subscribe' | 'onCapability' | 'postback' | 'react' | 'send' | 'setTyping' | 'requestStep' | 'reportAction'>;
+/**
+ * Where things are in the HOST's scene. Every member optional: an absent one
+ * means the world falls back to something sensible (a bubble with no speaker
+ * anchor hangs over the agent; a pick with no hand floats where it was taken).
+ */
+export interface WorldAnchors {
+    /** The object a message's author stands for. `null` = the agent's body. */
+    readonly speaker?: (actorId: string | null) => Object3D | null;
+    /** The visitor's own avatar, for their bubbles. Without it they get none. */
+    readonly visitor?: Object3D | null;
+    /** A named place a `lookAt` or `scene.highlight` points at. */
+    readonly resolve?: (ref: string) => Object3D | Vector3 | null;
+    /** A controller grip or hand: the panel in `wrist` mode and a held pick attach here. */
+    readonly wrist?: Object3D | null;
+    readonly hand?: Object3D | null;
+}
+export type PanelFollow = 'fixed' | 'lazy' | 'wrist';
+export type SoundKind = 'send' | 'receive' | 'pick' | 'select';
+export interface SoundCue {
+    readonly kind: SoundKind;
+    readonly url: string;
+    readonly volume: number;
+    /** Play it from `position` (world space) rather than flat. */
+    readonly spatial: boolean;
+    readonly position: Vector3 | null;
+}
+export interface WorldOptions {
+    readonly conversation: ConversationLike;
+    /** The camera the visitor sees through (the XR camera in a headset). */
+    readonly camera: Camera;
+    /** The channel's `worldTheme` (`core.worldTheme`). */
+    readonly theme?: WorldTheme | null;
+    readonly themeLayers?: readonly WorldTheme[];
+    /** What the scene's light is; consulted when the theme's scheme is `auto`. */
+    readonly scene?: 'light' | 'dark';
+    /** The viewer's setting. A function is re-read every `update`. */
+    readonly reducedMotion?: boolean | (() => boolean);
+    readonly presences?: PresenceMap;
+    readonly placement?: WorldPlacementRequest;
+    readonly abilities?: WorldHostAbilities;
+    readonly follow?: PanelFollow;
+    readonly anchors?: WorldAnchors;
+    readonly renderers?: WorldNodeRenderers;
+    readonly loadModel?: ModelLoader;
+    /**
+     * Only for VRM avatars, and only if you bundle: `() => import('@pixiv/three-vrm')`.
+     * `@pixiv/three-vrm` is an optional peer dependency; a glTF-only host never needs it.
+     */
+    readonly loadVrm?: VrmModuleLoader;
+    readonly onSound?: (cue: SoundCue) => void;
+    /** Polite live-region text: the agent's state, new messages, an action's equivalent. */
+    readonly announce?: (text: string) => void;
+    /** The visitor pressed the composer's field: open your keyboard, mic or DOM input. */
+    readonly onComposeRequest?: () => void;
+    /** A `host_event` card action no registered capability claimed. */
+    readonly onHostEvent?: (event: string, data: Readonly<Record<string, unknown>>) => void;
+    /** A `url` card action. The world never navigates. */
+    readonly onOpenUrl?: (href: string) => void;
+    readonly onError?: (error: unknown) => void;
+    readonly now?: () => number;
+}
+export type { AgentWorldPresence };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,UAAU,EACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEvD;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;CAqBjB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;AAEnG,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG;IAC1D,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB,sBAAsB,GACtB,UAAU,GACV,gBAAgB,GAChB,oBAAoB,GACpB,cAAc,CAAC;AAEnB,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,IAAI,EAAE,cAAc,CAAC;gBAElB,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM;CAKzD;AAED,uFAAuF;AACvF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CACjC,YAAY,EACV,gBAAgB,GAChB,aAAa,GACb,WAAW,GACX,cAAc,GACd,UAAU,GACV,OAAO,GACP,MAAM,GACN,WAAW,GACX,aAAa,GACb,cAAc,CACjB,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,QAAQ,GAAG,IAAI,CAAC;IAC/D,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACnC,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;IAC9D,wFAAwF;IACxF,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAErD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE/D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7C,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,kEAAkE;IAClE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC3C,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,sFAAsF;IACtF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IACvC,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;IACxF,sDAAsD;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED,YAAY,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/types.js

@@ -0,0 +1,41 @@
+/**
+ * The renderer contract, versioned like the widget's `cl-` class contract.
+ *
+ * `objects` are the `Object3D.name` every default renderer gives its output,
+ * and the world gives the same name to an override's output when the override
+ * left it blank, so `scene.getObjectByName('cl3-card')` finds the card
+ * whoever drew it. A name is part of the contract: renaming one is a major
+ * version, adding one is a minor. A host that pins `contract: 1` on its
+ * renderers is refused, loudly, by a world that no longer speaks it.
+ */
+export const WORLD_CONTRACT = {
+    version: 1,
+    renderers: [
+        'renderCard',
+        'renderPick',
+        'renderBubble',
+        'renderPanel',
+        'renderComposer',
+        'renderAgent',
+    ],
+    objects: {
+        root: 'cl3-world',
+        grid: 'cl3-grid',
+        card: 'cl3-card',
+        pick: 'cl3-pick',
+        bubble: 'cl3-bubble',
+        typing: 'cl3-typing',
+        panel: 'cl3-panel',
+        composer: 'cl3-composer',
+        agent: 'cl3-agent',
+    },
+};
+export class WorldError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'WorldError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,CAAC;IACV,SAAS,EAAE;QACT,YAAY;QACZ,YAAY;QACZ,cAAc;QACd,aAAa;QACb,gBAAgB;QAChB,aAAa;KACd;IACD,OAAO,EAAE;QACP,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,WAAW;QAClB,QAAQ,EAAE,cAAc;QACxB,KAAK,EAAE,WAAW;KACnB;CACO,CAAC;AAgBX,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnB,IAAI,CAAiB;IAErC,YAAmB,IAAoB,EAAE,OAAe;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/visemes.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Viseme-driven mouth — optional input only.
+ *
+ * Voice is built in a parallel lane and its message fields are not final, so
+ * this reads ONE tolerant shape off `message.metadata.visemes`:
+ * `[{ t: <ms from the start of the utterance>, v: <viseme name>, w?: 0..1 }]`.
+ * Anything else — absent, malformed, unsorted garbage — is null, and a null
+ * track means the mouth is simply not driven. A mouth is ornament; the body of
+ * the message is the message.
+ */
+import type { ConversationMessage } from '@chatlychat/core';
+export interface Viseme {
+    readonly t: number;
+    readonly v: string;
+    readonly w: number;
+}
+export type VisemeTrack = readonly Viseme[];
+export declare function readVisemes(message: ConversationMessage): VisemeTrack | null;
+/** The viseme held at `tMs`, or null before the first and after the last has been held 250ms. */
+export declare function visemeAt(track: VisemeTrack, tMs: number): Viseme | null;
+/**
+ * Morph-target names to try for a viseme, in order. Covers the Oculus/ARKit
+ * `viseme_*` set and VRM's five vowels, because a VRM avatar is a glTF the
+ * loader can read and drive by morph target even though its bones are not
+ * ours to animate.
+ */
+export declare function morphNamesFor(v: string): readonly string[];
+//# sourceMappingURL=visemes.d.ts.map

package/dist/visemes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visemes.d.ts","sourceRoot":"","sources":["../src/visemes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,GAAG,SAAS,MAAM,EAAE,CAAC;AAE5C,wBAAgB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW,GAAG,IAAI,CAqB5E;AAED,iGAAiG;AACjG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUvE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAE1D"}

package/dist/visemes.js

@@ -0,0 +1,42 @@
+export function readVisemes(message) {
+    const raw = message.metadata['visemes'];
+    if (!Array.isArray(raw)) {
+        return null;
+    }
+    const out = [];
+    for (const e of raw) {
+        const r = (typeof e === 'object' && e !== null ? e : {});
+        const { t, v, w } = r;
+        if (typeof t !== 'number' ||
+            !Number.isFinite(t) ||
+            t < 0 ||
+            typeof v !== 'string' ||
+            v === '') {
+            continue;
+        }
+        out.push({ t, v, w: typeof w === 'number' && w >= 0 && w <= 1 ? w : 1 });
+    }
+    return out.length === 0 ? null : out.sort((a, b) => a.t - b.t);
+}
+/** The viseme held at `tMs`, or null before the first and after the last has been held 250ms. */
+export function visemeAt(track, tMs) {
+    let held = null;
+    for (const e of track) {
+        if (e.t > tMs) {
+            break;
+        }
+        held = e;
+    }
+    const last = track[track.length - 1];
+    return held === null || (held === last && tMs - held.t > 250) ? null : held;
+}
+/**
+ * Morph-target names to try for a viseme, in order. Covers the Oculus/ARKit
+ * `viseme_*` set and VRM's five vowels, because a VRM avatar is a glTF the
+ * loader can read and drive by morph target even though its bones are not
+ * ours to animate.
+ */
+export function morphNamesFor(v) {
+    return [v, `viseme_${v}`, `Viseme_${v}`];
+}
+//# sourceMappingURL=visemes.js.map

package/dist/visemes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visemes.js","sourceRoot":"","sources":["../src/visemes.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,WAAW,CAAC,OAA4B;IACtD,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,GAAgB,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAA4B,CAAC;QACpF,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QACtB,IACE,OAAO,CAAC,KAAK,QAAQ;YACrB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YACnB,CAAC,GAAG,CAAC;YACL,OAAO,CAAC,KAAK,QAAQ;YACrB,CAAC,KAAK,EAAE,EACR,CAAC;YACD,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,QAAQ,CAAC,KAAkB,EAAE,GAAW;IACtD,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC;YACd,MAAM;QACR,CAAC;QACD,IAAI,GAAG,CAAC,CAAC;IACX,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,OAAO,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,GAAG,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS;IACrC,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/vrm.d.ts

@@ -0,0 +1,97 @@
+/**
+ * VRM avatars — the optional half of the agent's body.
+ *
+ * `@pixiv/three-vrm` is an OPTIONAL peer dependency. This file never imports
+ * it statically, and the dynamic import below names it through a computed
+ * specifier, so no bundler resolves it while building a glTF-only host: that
+ * host neither installs it nor ships a byte of it. A host that does use VRM
+ * installs it and, if it bundles, hands the import over as `loadVrm`:
+ * `loadVrm: () => import('@pixiv/three-vrm')`. That one line is what lets ITS
+ * bundler see the package.
+ *
+ * API used (three-vrm v3, https://pixiv.github.io/three-vrm/packages/three-vrm/docs/):
+ * `VRMLoaderPlugin` registered on a `GLTFLoader` leaves the `VRM` on
+ * `gltf.userData.vrm`; `vrm.expressionManager.setValue(name, 0..1)`;
+ * `vrm.lookAt.target`; `vrm.humanoid.getNormalizedBoneNode(bone)`;
+ * `vrm.update(deltaSeconds)`; `VRMUtils.rotateVRM0(vrm)`.
+ */
+import { Vector3, type Camera, type Object3D } from 'three';
+import type { AgentExpression } from '@chatlychat/core';
+export declare const VRM_PEER = "@pixiv/three-vrm";
+/** The slice of three-vrm's `VRM` the SDK touches, so a spec can stand in. */
+export interface VrmLike {
+    readonly scene: Object3D;
+    readonly expressionManager?: {
+        setValue(name: string, weight: number): void;
+    } | null;
+    readonly lookAt?: {
+        target?: Object3D | null;
+    } | null;
+    readonly humanoid?: {
+        getNormalizedBoneNode(name: string): Object3D | null;
+    } | null;
+    update(deltaSeconds: number): void;
+}
+/** The slice of the `@pixiv/three-vrm` module the loader needs. */
+export interface VrmModule {
+    readonly VRMLoaderPlugin: new (parser: unknown) => unknown;
+    readonly VRMUtils?: {
+        rotateVRM0?(vrm: VrmLike): void;
+    };
+}
+/** What a host passes as `loadVrm`: `() => import('@pixiv/three-vrm')`. */
+export type VrmModuleLoader = () => Promise<VrmModule>;
+/** The module, or a typed error that names the missing peer and how to fix it. */
+export declare function loadVrmModule(custom?: VrmModuleLoader): Promise<VrmModule>;
+/** The glTF carries a VRM 0.x (`VRM`) or 1.0 (`VRMC_vrm`) extension. */
+export declare function hasVrmExtension(gltf: {
+    userData?: Record<string, unknown>;
+    parser?: {
+        json?: {
+            extensionsUsed?: unknown;
+        };
+    };
+}): boolean;
+/** Which loader an avatar needs: its declared format wins; the extension catches an unlabelled file. */
+export declare const wantsVrm: (format: string | undefined, gltf?: Parameters<typeof hasVrmExtension>[0]) => boolean;
+export type VrmVowel = 'aa' | 'ih' | 'ou' | 'ee' | 'oh';
+/**
+ * Chatly viseme -> one of VRM's five mouth expressions, and how far to open it.
+ * Keys are compared lower-case with any `viseme_` prefix removed. A viseme not
+ * listed, `sil` and `PP` (lips shut) all close the mouth.
+ */
+export declare const VISEME_TO_VRM: Readonly<Record<string, readonly [VrmVowel, number] | null>>;
+export declare const VRM_VOWELS: readonly VrmVowel[];
+export declare function vrmVisemeFor(v: string): readonly [VrmVowel, number] | null;
+/**
+ * Chatly `embodiment.expression` -> VRM preset and weight. The rest (`nod`,
+ * `shake_head`, `point`, `wave`, `shrug`, `think`) are gestures, not faces: they
+ * play only as the host's clip from `presence.expressions`. No Chatly expression
+ * is `angry` or `relaxed`, so those presets are never driven.
+ */
+export declare const EXPRESSION_TO_VRM: Readonly<Partial<Record<AgentExpression, readonly [string, number]>>>;
+/** Drives one loaded VRM: mouth, face, blink, gaze, and `vrm.update`. */
+export declare class VrmRig {
+    readonly vrm: VrmLike;
+    reduced: boolean;
+    private readonly target;
+    private face;
+    private mouth;
+    private clock;
+    private head;
+    constructor(vrm: VrmLike, reduced: boolean);
+    get gazeTarget(): Object3D;
+    private set;
+    /** Open one of the five vowels (or close the mouth with null). Always zeroes the other four. */
+    setMouth(v: string | null, w: number): void;
+    /** Show a face for a cue; false when the expression is a gesture with no VRM preset. */
+    express(e: AgentExpression | null): boolean;
+    /** Point the eyes and head at a world position (null = release the head). */
+    gazeAt(root: Object3D, at: Vector3 | null, dt: number): void;
+    /** Advance the face and blink, then `vrm.update`. Call after the mixer and the gaze. */
+    update(dt: number): void;
+    get openVowel(): VrmVowel | null;
+}
+/** Where the agent should look, as a world position, for `gazeAt`. */
+export declare function gazePoint(gaze: Object3D | Vector3 | 'visitor' | null, camera: Camera): Vector3 | null;
+//# sourceMappingURL=vrm.d.ts.map

package/dist/vrm.d.ts.map

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