@chatlychat/world 0.0.0-stage → 0.2.0

package/dist/vrm.js

@@ -0,0 +1,212 @@
+/**
+ * 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 { Group, Vector3 } from 'three';
+import { WorldError } from './types.js';
+export const VRM_PEER = '@pixiv/three-vrm';
+/** The module, or a typed error that names the missing peer and how to fix it. */
+export async function loadVrmModule(custom) {
+    try {
+        // A computed specifier on purpose: see the header.
+        const spec = ['@pixiv', 'three-vrm'].join('/');
+        const mod = await (custom ??
+            (() => import(/* @vite-ignore */ /* webpackIgnore: true */ spec)))();
+        if (typeof mod.VRMLoaderPlugin !== 'function') {
+            throw new Error('no VRMLoaderPlugin export');
+        }
+        return mod;
+    }
+    catch (cause) {
+        const e = new WorldError('missing_peer', `VRM avatars need the optional peer dependency ${VRM_PEER}. Run \`npm install ${VRM_PEER}\`; ` +
+            `if you bundle, also pass \`loadVrm\` (a function returning import(...) of it) to createWorld.`);
+        e.cause = cause;
+        throw e;
+    }
+}
+/** The glTF carries a VRM 0.x (`VRM`) or 1.0 (`VRMC_vrm`) extension. */
+export function hasVrmExtension(gltf) {
+    const ext = gltf.userData?.['gltfExtensions'];
+    if (typeof ext === 'object' && ext !== null && ('VRM' in ext || 'VRMC_vrm' in ext)) {
+        return true;
+    }
+    const used = gltf.parser?.json?.extensionsUsed;
+    return Array.isArray(used) && used.some((x) => x === 'VRM' || x === 'VRMC_vrm');
+}
+/** Which loader an avatar needs: its declared format wins; the extension catches an unlabelled file. */
+export const wantsVrm = (format, gltf) => format === 'vrm' || (gltf !== undefined && hasVrmExtension(gltf));
+/**
+ * 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 const VISEME_TO_VRM = {
+    // VRM's own vowels, and the Oculus vowels.
+    aa: ['aa', 1],
+    ih: ['ih', 1],
+    ou: ['ou', 1],
+    ee: ['ee', 1],
+    oh: ['oh', 1],
+    e: ['ee', 1],
+    i: ['ih', 1],
+    o: ['oh', 1],
+    u: ['ou', 1],
+    // Oculus consonants: the nearest vowel shape, held shallower.
+    ff: ['ih', 0.4],
+    th: ['ih', 0.5],
+    dd: ['aa', 0.4],
+    kk: ['aa', 0.4],
+    ch: ['ou', 0.5],
+    ss: ['ih', 0.5],
+    nn: ['ih', 0.3],
+    rr: ['ou', 0.5],
+    pp: null,
+    sil: null,
+};
+export const VRM_VOWELS = ['aa', 'ih', 'ou', 'ee', 'oh'];
+export function vrmVisemeFor(v) {
+    return VISEME_TO_VRM[v.toLowerCase().replace(/^viseme_/, '')] ?? 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 const EXPRESSION_TO_VRM = {
+    smile: ['happy', 0.7],
+    laugh: ['happy', 1],
+    surprised: ['surprised', 1],
+    concerned: ['sad', 0.6],
+};
+const HOLD_S = 2.5;
+const FADE_OUT_S = 0.5;
+const EASE_IN_S = 0.12;
+const BLINK_EVERY_S = 4;
+const BLINK_S = 0.15;
+const HEAD_YAW = 0.6;
+const HEAD_PITCH = 0.35;
+const HEAD_RATE = 8;
+/** Drives one loaded VRM: mouth, face, blink, gaze, and `vrm.update`. */
+export class VrmRig {
+    vrm;
+    reduced;
+    target = new Group();
+    face = null;
+    mouth = null;
+    clock = 0;
+    head = { yaw: 0, pitch: 0 };
+    constructor(vrm, reduced) {
+        this.vrm = vrm;
+        this.reduced = reduced;
+        this.target.name = 'cl3-agent-gaze';
+        if (vrm.lookAt != null) {
+            vrm.lookAt.target = this.target;
+        }
+    }
+    get gazeTarget() {
+        return this.target;
+    }
+    set(name, w) {
+        this.vrm.expressionManager?.setValue(name, w);
+    }
+    /** Open one of the five vowels (or close the mouth with null). Always zeroes the other four. */
+    setMouth(v, w) {
+        const hit = v === null ? null : vrmVisemeFor(v);
+        const vowel = hit === null ? null : hit[0];
+        for (const name of VRM_VOWELS) {
+            this.set(name, name === vowel ? Math.min(1, w * (hit?.[1] ?? 0)) : 0);
+        }
+        this.mouth = vowel;
+    }
+    /** Show a face for a cue; false when the expression is a gesture with no VRM preset. */
+    express(e) {
+        const p = e === null ? undefined : EXPRESSION_TO_VRM[e];
+        if (p === undefined) {
+            return false;
+        }
+        if (this.face !== null && this.face.name !== p[0]) {
+            this.set(this.face.name, 0);
+        }
+        this.face = { name: p[0], weight: p[1], age: 0 };
+        return true;
+    }
+    /** Point the eyes and head at a world position (null = release the head). */
+    gazeAt(root, at, dt) {
+        const bone = this.vrm.humanoid?.getNormalizedBoneNode('head');
+        const k = this.reduced ? 1 : 1 - Math.exp(-HEAD_RATE * dt);
+        let yaw = 0;
+        let pitch = 0;
+        if (at !== null && bone != null) {
+            this.target.position.copy(at);
+            this.target.updateMatrixWorld(true);
+            const from = root.worldToLocal(bone.getWorldPosition(new Vector3()));
+            const to = root.worldToLocal(at.clone());
+            const dx = to.x - from.x;
+            const dz = to.z - from.z;
+            yaw = Math.max(-HEAD_YAW, Math.min(HEAD_YAW, Math.atan2(dx, dz)));
+            pitch = Math.max(-HEAD_PITCH, Math.min(HEAD_PITCH, -Math.atan2(to.y - from.y, Math.hypot(dx, dz))));
+        }
+        this.head = {
+            yaw: this.head.yaw + (yaw - this.head.yaw) * k,
+            pitch: this.head.pitch + (pitch - this.head.pitch) * k,
+        };
+        // A head never driven is left to the clips; one released is eased home, then left alone.
+        if (bone != null &&
+            (at !== null || Math.abs(this.head.yaw) + Math.abs(this.head.pitch) > 1e-3)) {
+            bone.rotation.set(this.head.pitch, this.head.yaw, 0);
+        }
+    }
+    /** Advance the face and blink, then `vrm.update`. Call after the mixer and the gaze. */
+    update(dt) {
+        this.clock += dt;
+        const f = this.face;
+        if (f !== null) {
+            f.age += dt;
+            const fade = this.reduced ? 0 : FADE_OUT_S;
+            const k = this.reduced
+                ? Number(f.age <= HOLD_S)
+                : f.age < EASE_IN_S
+                    ? f.age / EASE_IN_S
+                    : f.age <= HOLD_S
+                        ? 1
+                        : 1 - (f.age - HOLD_S) / fade;
+            this.set(f.name, f.weight * Math.max(0, Math.min(1, k)));
+            if (f.age >= HOLD_S + fade) {
+                this.set(f.name, 0);
+                this.face = null;
+            }
+        }
+        // A held, motionless blink would read as a fault, so reduced motion has none.
+        const phase = this.clock % BLINK_EVERY_S;
+        this.set('blink', this.reduced || phase > BLINK_S ? 0 : 1 - Math.abs(1 - (2 * phase) / BLINK_S));
+        this.vrm.update(dt);
+    }
+    get openVowel() {
+        return this.mouth;
+    }
+}
+/** Where the agent should look, as a world position, for `gazeAt`. */
+export function gazePoint(gaze, camera) {
+    if (gaze === null) {
+        return null;
+    }
+    if (gaze === 'visitor') {
+        return camera.getWorldPosition(new Vector3());
+    }
+    return gaze instanceof Vector3 ? gaze : gaze.getWorldPosition(new Vector3());
+}
+//# sourceMappingURL=vrm.js.map

package/dist/vrm.js.map

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

package/dist/world-api.d.ts

@@ -0,0 +1,39 @@
+import type { AgentBody } from './agent.js';
+import type { CapabilityRegistry } from './capabilities.js';
+import type { Composer } from './composer.js';
+import type { Gaze, Hit } from './input.js';
+import type { Selection } from './selection.js';
+import type { ResolvedWorldPlacement, ResolvedWorldTheme, WorldTheme } from '@chatlychat/core';
+import type { Group, Object3D, Vector3 } from 'three';
+/** What `createWorld` returns. */
+export interface ChatlyWorld {
+    /** Add this to your scene. */
+    readonly root: Group;
+    readonly capabilities: CapabilityRegistry;
+    readonly selection: Selection;
+    readonly agent: AgentBody;
+    readonly composer: Composer;
+    readonly theme: ResolvedWorldTheme;
+    readonly placement: ResolvedWorldPlacement;
+    readonly reducedMotion: boolean;
+    /** Call every frame with the frame time in SECONDS. */
+    update(dtSeconds: number): void;
+    /** What a ray from `origin` along `direction` strikes, or null. Does not activate it. */
+    pick(origin: Vector3, direction: Vector3): Hit | null;
+    /** Normalised device coordinates (-1..1), for a mouse or touch. */
+    pickAtPointer(x: number, y: number): Hit | null;
+    activate(hit: Hit): void;
+    attachController(controller: Object3D): () => void;
+    attachGaze(opts?: {
+        dwellMs?: number;
+    }): Gaze;
+    setReducedMotion(reduced: boolean): void;
+    setTheme(theme: WorldTheme | null, layers?: readonly WorldTheme[]): void;
+    setScene(scene: 'light' | 'dark'): void;
+    /** Select a card by key (`cardKeys()`); the same as the visitor tapping it. */
+    select(key: string): Promise<void>;
+    release(): void;
+    cardKeys(): readonly string[];
+    dispose(): void;
+}
+//# sourceMappingURL=world-api.d.ts.map

package/dist/world-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-api.d.ts","sourceRoot":"","sources":["../src/world-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEtD,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,uDAAuD;IACvD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,yFAAyF;IACzF,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC;IACtD,mEAAmE;IACnE,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IACzB,gBAAgB,CAAC,UAAU,EAAE,QAAQ,GAAG,MAAM,IAAI,CAAC;IACnD,UAAU,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI,CAAC;IACzE,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,+EAA+E;IAC/E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,IAAI,SAAS,MAAM,EAAE,CAAC;IAC9B,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/world-api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=world-api.js.map

package/dist/world-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-api.js","sourceRoot":"","sources":["../src/world-api.ts"],"names":[],"mappings":""}

package/dist/world.d.ts

@@ -0,0 +1,5 @@
+import { type WorldOptions } from './types.js';
+import type { ChatlyWorld } from './world-api.js';
+export type { ChatlyWorld } from './world-api.js';
+export declare function createWorld(opts: WorldOptions): ChatlyWorld;
+//# sourceMappingURL=world.d.ts.map

package/dist/world.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../src/world.ts"],"names":[],"mappings":"AAmDA,OAAO,EAA8C,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAG3F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAKlD,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,CA2a3D"}