@chatlychat/world 0.0.0-stage → 0.2.0

package/dist/handlers.d.ts

@@ -0,0 +1,26 @@
+import type { ConversationLike } from './types.js';
+import type { BlockHandlers, ConversationMessage } from '@chatlychat/core';
+export interface CardAction {
+    readonly kind: string;
+    readonly id?: string;
+    readonly value?: string;
+    readonly payload?: Readonly<Record<string, unknown>>;
+    readonly silent?: boolean;
+    readonly event?: string;
+    readonly data?: Readonly<Record<string, unknown>>;
+    readonly href?: string;
+    readonly canvasId?: string;
+    readonly params?: Record<string, unknown>;
+}
+export interface HandlerHooks {
+    /** A host_event press. Resolves to whether something claimed it. */
+    readonly hostEvent: (event: string, data: Readonly<Record<string, unknown>>, action: {
+        readonly messageId: string;
+        readonly actionId: string;
+    }) => Promise<boolean>;
+    readonly openUrl: (href: string) => void;
+}
+/** A card's own actions, by explicit `id` or by position (`a0`, `a1`…). */
+export declare function cardActions(block: Readonly<Record<string, unknown>>): readonly CardAction[];
+export declare function makeHandlers(conversation: ConversationLike, message: ConversationMessage, title: string, actions: readonly CardAction[], hooks: HandlerHooks): BlockHandlers;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,CAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACvC,MAAM,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAC9D,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,UAAU,EAAE,CAE3F;AAED,wBAAgB,YAAY,CAC1B,YAAY,EAAE,gBAAgB,EAC9B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,KAAK,EAAE,YAAY,GAClB,aAAa,CA2Bf"}

package/dist/handlers.js

@@ -0,0 +1,41 @@
+/**
+ * The three things a visitor can do to a block, as the calls the core already
+ * makes. Handed to every renderer — default or override — unchanged.
+ */
+import { WorldError } from './types.js';
+/** A card's own actions, by explicit `id` or by position (`a0`, `a1`…). */
+export function cardActions(block) {
+    return Array.isArray(block['actions']) ? block['actions'] : [];
+}
+export function makeHandlers(conversation, message, title, actions, hooks) {
+    return {
+        select: (payload) => conversation.postback({ body: title, payload: { ...payload } }),
+        react: async (emoji) => {
+            await conversation.react(message.id, emoji);
+        },
+        press: async (actionId) => {
+            const idx = actions.findIndex((a, i) => (a.id ?? `a${String(i)}`) === actionId);
+            const a = idx < 0 ? undefined : actions[idx];
+            if (a === undefined) {
+                throw new WorldError('unknown_action', `no action "${actionId}" on this block`);
+            }
+            if (a.kind === 'postback' && a.value !== undefined) {
+                await conversation.postback({
+                    body: a.value,
+                    ...(a.payload === undefined ? {} : { payload: { ...a.payload } }),
+                    ...(a.silent === true ? { silent: true } : {}),
+                });
+            }
+            else if (a.kind === 'host_event' && a.event !== undefined) {
+                await hooks.hostEvent(a.event, a.data ?? {}, { messageId: message.id, actionId });
+            }
+            else if (a.kind === 'url' && a.href !== undefined) {
+                hooks.openUrl(a.href);
+            }
+            else if (a.kind === 'step' && a.canvasId !== undefined) {
+                await conversation.requestStep(a.canvasId, a.params);
+            }
+        },
+    };
+}
+//# sourceMappingURL=handlers.js.map

package/dist/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA4BxC,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CAAC,KAAwC;IAClE,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,SAAS,CAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,YAA8B,EAC9B,OAA4B,EAC5B,KAAa,EACb,OAA8B,EAC9B,KAAmB;IAEnB,OAAO;QACL,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC;QACpF,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACrB,MAAM,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC;QACD,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;YACxB,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,QAAQ,CAAC,CAAC;YAChF,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBACpB,MAAM,IAAI,UAAU,CAAC,gBAAgB,EAAE,cAAc,QAAQ,iBAAiB,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACnD,MAAM,YAAY,CAAC,QAAQ,CAAC;oBAC1B,IAAI,EAAE,CAAC,CAAC,KAAK;oBACb,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;oBACjE,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC/C,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC5D,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YACpF,CAAC;iBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACpD,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;iBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACzD,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `@chatlychat/world` — a Chatly conversation in a three.js scene.
+ *
+ *   const world = createWorld({ conversation, camera, theme: core.worldTheme });
+ *   scene.add(world.root);
+ *   renderer.setAnimationLoop(() => world.update(clock.getDelta()));
+ *
+ * `three` and `@chatlychat/core` are peer dependencies. `@pixiv/three-vrm` is an
+ * OPTIONAL peer, needed only for VRM avatars (see `vrm.ts`).
+ */
+export { createWorld } from './world.js';
+export type { ChatlyWorld } from './world-api.js';
+export type { Composer } from './composer.js';
+export { WORLD_CONTRACT, WorldError, type ConversationLike, type PanelFollow, type SoundCue, type SoundKind, type WorldAnchors, type WorldErrorCode, type WorldNodeRenderers, type WorldObjectName, type WorldOptions, } from './types.js';
+export { CapabilityRegistry, type ActionContext, type ActionHandler, type ActionOutcome, type ActionReport, type RegisterOptions, type StandardAction, type WorldActionMap, } from './capabilities.js';
+export { GRID_PLACEMENTS, layoutCards, type GridLayout, type GridPlacement, type Mount, type Pose, } from './layout.js';
+export { bubbleScale } from './bubble.js';
+export { DEAD_METRES, DEAD_YAW, lazyStep, type FollowPose, type FollowState } from './panel.js';
+export { buildGrid, defaultCard, formatPrice, isHighlighted, readCard, type CardData, } from './cards.js';
+export { anchorOffset, fitModel, gltfLoader, type GltfLoaderLike, type GltfLoaderOptions, type LoadedModel, type ModelAnchor, type ModelLoader, } from './model.js';
+export { readVisemes, visemeAt, type Viseme, type VisemeTrack } from './visemes.js';
+export { Selection } from './selection.js';
+export { Motion } from './motion.js';
+export { AgentBody, type GazeTarget } from './agent.js';
+export { interactive, pickRay, type Hit, type Interactive, type InteractiveKind } from './input.js';
+export { EXPRESSION_TO_VRM, VISEME_TO_VRM, VRM_PEER, VrmRig, hasVrmExtension, loadVrmModule, vrmVisemeFor, wantsVrm, type VrmLike, type VrmModule, type VrmModuleLoader, type VrmVowel, } from './vrm.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EACL,cAAc,EACd,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,eAAe,EACf,WAAW,EACX,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,KAAK,EACV,KAAK,IAAI,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAChG,OAAO,EACL,SAAS,EACT,WAAW,EACX,WAAW,EACX,aAAa,EACb,QAAQ,EACR,KAAK,QAAQ,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AACpG,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,QAAQ,EACR,MAAM,EACN,eAAe,EACf,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,QAAQ,GACd,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * `@chatlychat/world` — a Chatly conversation in a three.js scene.
+ *
+ *   const world = createWorld({ conversation, camera, theme: core.worldTheme });
+ *   scene.add(world.root);
+ *   renderer.setAnimationLoop(() => world.update(clock.getDelta()));
+ *
+ * `three` and `@chatlychat/core` are peer dependencies. `@pixiv/three-vrm` is an
+ * OPTIONAL peer, needed only for VRM avatars (see `vrm.ts`).
+ */
+export { createWorld } from './world.js';
+export { WORLD_CONTRACT, WorldError, } from './types.js';
+export { CapabilityRegistry, } from './capabilities.js';
+export { GRID_PLACEMENTS, layoutCards, } from './layout.js';
+export { bubbleScale } from './bubble.js';
+export { DEAD_METRES, DEAD_YAW, lazyStep } from './panel.js';
+export { buildGrid, defaultCard, formatPrice, isHighlighted, readCard, } from './cards.js';
+export { anchorOffset, fitModel, gltfLoader, } from './model.js';
+export { readVisemes, visemeAt } from './visemes.js';
+export { Selection } from './selection.js';
+export { Motion } from './motion.js';
+export { AgentBody } from './agent.js';
+export { interactive, pickRay } from './input.js';
+export { EXPRESSION_TO_VRM, VISEME_TO_VRM, VRM_PEER, VrmRig, hasVrmExtension, loadVrmModule, vrmVisemeFor, wantsVrm, } from './vrm.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,OAAO,EACL,cAAc,EACd,UAAU,GAUX,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,GAQnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,eAAe,EACf,WAAW,GAKZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAqC,MAAM,YAAY,CAAC;AAChG,OAAO,EACL,SAAS,EACT,WAAW,EACX,WAAW,EACX,aAAa,EACb,QAAQ,GAET,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,UAAU,GAMX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAiC,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAmB,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAoD,MAAM,YAAY,CAAC;AACpG,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,QAAQ,EACR,MAAM,EACN,eAAe,EACf,aAAa,EACb,YAAY,EACZ,QAAQ,GAKT,MAAM,UAAU,CAAC"}

package/dist/input.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Picking: a ray in, an interactive thing out. The host owns input — its
+ * controllers, hands, gaze and mouse — so this is only the part that knows
+ * which of OUR objects a ray hit.
+ *
+ * Anything a renderer wants tappable is marked with `interactive(obj, kind,
+ * activate)`; `pick` walks up from whatever mesh the ray struck to the first
+ * marked ancestor, so a renderer marks the root of its node and every child
+ * works. An override can opt out of the world's default tap by setting
+ * `userData.cl3Handled`.
+ */
+import { Vector3, type Camera, type Object3D } from 'three';
+export type InteractiveKind = 'card' | 'release' | 'send' | 'field';
+export interface Interactive {
+    readonly kind: InteractiveKind;
+    readonly activate: () => void;
+}
+export interface Hit extends Interactive {
+    readonly object: Object3D;
+    readonly distance: number;
+}
+export declare function interactive(obj: Object3D, kind: InteractiveKind, activate: () => void): void;
+export declare function pickRay(root: Object3D, origin: Vector3, direction: Vector3, maxMetres?: number): Hit | null;
+/** The pointing ray of a controller or hand: its world position, along its -z. */
+export declare function rayOf(source: Object3D): {
+    origin: Vector3;
+    direction: Vector3;
+};
+/** Listen for `select` on a three XR controller (a trigger or a hand pinch). */
+export declare function attachController(root: Object3D, controller: Object3D, onHit: (h: Hit) => void): () => void;
+/**
+ * Gaze with dwell: looking at one thing for `dwellMs` activates it. Returns a
+ * stepper to call each frame; its result is progress 0..1 for a reticle.
+ */
+export declare class Gaze {
+    private readonly root;
+    private readonly camera;
+    private readonly dwellMs;
+    private readonly onHit;
+    private target;
+    private elapsed;
+    progress: number;
+    constructor(root: Object3D, camera: Camera, dwellMs: number, onHit: (h: Hit) => void);
+    update(dtMs: number): void;
+}
+//# sourceMappingURL=input.d.ts.map

package/dist/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAyB,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEnF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,GAAI,SAAQ,WAAW;IACtC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAE5F;AAKD,wBAAgB,OAAO,CACrB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,OAAO,EAClB,SAAS,SAAK,GACb,GAAG,GAAG,IAAI,CAYZ;AAID,kFAAkF;AAClF,wBAAgB,KAAK,CAAC,MAAM,EAAE,QAAQ,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAO/E;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,QAAQ,EACpB,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,GACtB,MAAM,IAAI,CAcZ;AAED;;;GAGG;AACH,qBAAa,IAAI;IAMb,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IARxB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,OAAO,CAAK;IACb,QAAQ,SAAK;gBAGD,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI;IAGnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAiBlC"}

package/dist/input.js

@@ -0,0 +1,89 @@
+/**
+ * Picking: a ray in, an interactive thing out. The host owns input — its
+ * controllers, hands, gaze and mouse — so this is only the part that knows
+ * which of OUR objects a ray hit.
+ *
+ * Anything a renderer wants tappable is marked with `interactive(obj, kind,
+ * activate)`; `pick` walks up from whatever mesh the ray struck to the first
+ * marked ancestor, so a renderer marks the root of its node and every child
+ * works. An override can opt out of the world's default tap by setting
+ * `userData.cl3Handled`.
+ */
+import { Quaternion, Raycaster, Vector3 } from 'three';
+export function interactive(obj, kind, activate) {
+    obj.userData['cl3'] = { kind, activate };
+}
+const marked = (o) => o.userData['cl3'];
+export function pickRay(root, origin, direction, maxMetres = 10) {
+    const ray = new Raycaster(origin, direction.clone().normalize(), 0, maxMetres);
+    root.updateMatrixWorld(true);
+    for (const h of ray.intersectObject(root, true)) {
+        for (let o = h.object; o !== null; o = o.parent) {
+            const m = marked(o);
+            if (m !== undefined) {
+                return { ...m, object: o, distance: h.distance };
+            }
+        }
+    }
+    return null;
+}
+const FORWARD = new Vector3(0, 0, -1);
+/** The pointing ray of a controller or hand: its world position, along its -z. */
+export function rayOf(source) {
+    source.updateWorldMatrix(true, false);
+    const q = source.getWorldQuaternion(new Quaternion());
+    return {
+        origin: source.getWorldPosition(new Vector3()),
+        direction: FORWARD.clone().applyQuaternion(q),
+    };
+}
+/** Listen for `select` on a three XR controller (a trigger or a hand pinch). */
+export function attachController(root, controller, onHit) {
+    const listener = () => {
+        const { origin, direction } = rayOf(controller);
+        const h = pickRay(root, origin, direction);
+        if (h !== null) {
+            onHit(h);
+        }
+    };
+    const c = controller;
+    c.addEventListener('select', listener);
+    return () => c.removeEventListener('select', listener);
+}
+/**
+ * Gaze with dwell: looking at one thing for `dwellMs` activates it. Returns a
+ * stepper to call each frame; its result is progress 0..1 for a reticle.
+ */
+export class Gaze {
+    root;
+    camera;
+    dwellMs;
+    onHit;
+    target = null;
+    elapsed = 0;
+    progress = 0;
+    constructor(root, camera, dwellMs, onHit) {
+        this.root = root;
+        this.camera = camera;
+        this.dwellMs = dwellMs;
+        this.onHit = onHit;
+    }
+    update(dtMs) {
+        const { origin, direction } = rayOf(this.camera);
+        const h = pickRay(this.root, origin, direction);
+        if (h === null || h.object !== this.target) {
+            this.target = h?.object ?? null;
+            this.elapsed = 0;
+            this.progress = 0;
+            return;
+        }
+        this.elapsed += dtMs;
+        this.progress = Math.min(1, this.elapsed / this.dwellMs);
+        if (this.progress >= 1) {
+            this.elapsed = 0;
+            this.progress = 0;
+            this.onHit(h);
+        }
+    }
+}
+//# sourceMappingURL=input.js.map

package/dist/input.js.map

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

package/dist/layout.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Where a `card_grid` puts its cards — pure math, no three.js.
+ *
+ * Frame: the grid's own origin, the viewer standing at (0, 0, 0) looking down
+ * -z, +y up. A card's FRONT is its local +z, so `yaw` rotates it about y to
+ * face the viewer and `pitch` tips it onto its back (a table). The world
+ * parents the result wherever the resolved placement says; none of this knows
+ * about the scene it ends up in.
+ */
+export declare const GRID_PLACEMENTS: readonly ["arc", "shelf", "wall", "table"];
+export type GridPlacement = (typeof GRID_PLACEMENTS)[number];
+/** `stand` objects need a pedestal, `hang` ones a hanger, `lay` ones a surface. */
+export type Mount = 'stand' | 'hang' | 'lay';
+export interface Pose {
+    readonly position: readonly [number, number, number];
+    readonly yaw: number;
+    readonly pitch: number;
+}
+export interface GridLayout {
+    readonly poses: readonly Pose[];
+    readonly mount: Mount;
+}
+export declare function layoutCards(placement: GridPlacement, count: number, spacing: number): GridLayout;
+//# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,4CAA6C,CAAC;AAC1E,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,mFAAmF;AACnF,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7C,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAYD,wBAAgB,WAAW,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAiDhG"}

package/dist/layout.js

@@ -0,0 +1,69 @@
+/**
+ * Where a `card_grid` puts its cards — pure math, no three.js.
+ *
+ * Frame: the grid's own origin, the viewer standing at (0, 0, 0) looking down
+ * -z, +y up. A card's FRONT is its local +z, so `yaw` rotates it about y to
+ * face the viewer and `pitch` tips it onto its back (a table). The world
+ * parents the result wherever the resolved placement says; none of this knows
+ * about the scene it ends up in.
+ */
+export const GRID_PLACEMENTS = ['arc', 'shelf', 'wall', 'table'];
+const ARC_RADIUS = 1.2;
+/** 160 degrees: past that the outer cards are behind the viewer's shoulders. */
+const ARC_MAX_SPAN = (160 * Math.PI) / 180;
+const SHELF_COLUMNS = 4;
+const WALL_COLUMNS = 5;
+const ROW_HEIGHT = 0.4;
+/** Index `i` of `n` as an offset from the centre, in steps. */
+const centred = (i, n) => i - (n - 1) / 2;
+export function layoutCards(placement, count, spacing) {
+    const n = Math.max(0, Math.floor(count));
+    const poses = [];
+    if (placement === 'arc') {
+        // Widen the circle rather than overshoot the span, so spacing is honoured.
+        const radius = Math.max(ARC_RADIUS, n > 1 ? ((n - 1) * spacing) / ARC_MAX_SPAN : 0);
+        const step = spacing / radius;
+        for (let i = 0; i < n; i += 1) {
+            const a = centred(i, n) * step;
+            const x = radius * Math.sin(a);
+            const z = -radius * Math.cos(a);
+            poses.push({ position: [x, 0, z], yaw: Math.atan2(-x, -z), pitch: 0 });
+        }
+        return { poses, mount: 'stand' };
+    }
+    if (placement === 'table') {
+        // Flat on a surface below eye height, rows coming toward the viewer.
+        const cols = Math.max(1, Math.ceil(Math.sqrt(n)));
+        const rows = Math.ceil(n / cols);
+        for (let i = 0; i < n; i += 1) {
+            const c = i % cols;
+            const r = Math.floor(i / cols);
+            poses.push({
+                position: [
+                    centred(c, Math.min(cols, n - r * cols)) * spacing,
+                    -0.4,
+                    -0.7 - (rows - 1 - r) * spacing,
+                ],
+                yaw: 0,
+                pitch: -Math.PI / 2,
+            });
+        }
+        return { poses, mount: 'lay' };
+    }
+    const cols = placement === 'shelf' ? SHELF_COLUMNS : WALL_COLUMNS;
+    const rows = Math.ceil(n / cols);
+    for (let i = 0; i < n; i += 1) {
+        const c = i % cols;
+        const r = Math.floor(i / cols);
+        const inRow = Math.min(cols, n - r * cols);
+        // A shelf fills from the bottom; a wall reads top-left to bottom-right.
+        const y = placement === 'shelf' ? r * ROW_HEIGHT : 0.3 + (rows - 1 - r) * ROW_HEIGHT;
+        poses.push({
+            position: [centred(c, inRow) * spacing, y, placement === 'shelf' ? -1.4 : -1.8],
+            yaw: 0,
+            pitch: 0,
+        });
+    }
+    return { poses, mount: placement === 'shelf' ? 'stand' : 'hang' };
+}
+//# sourceMappingURL=layout.js.map

package/dist/layout.js.map

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

package/dist/model.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 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, type AnimationClip, type Object3D } from 'three';
+import { type VrmLike, type VrmModuleLoader } from './vrm.js';
+export declare const MODEL_ANCHORS: readonly ["center", "base", "top", "back"];
+export type ModelAnchor = (typeof MODEL_ANCHORS)[number];
+export interface LoadedModel {
+    readonly scene: Object3D;
+    readonly animations: readonly AnimationClip[];
+    /** Present when the file was loaded through three-vrm. */
+    readonly vrm?: VrmLike | null;
+}
+/** `hint.format` is the avatar's declared format; a loader may use it to pick a plugin. */
+export type ModelLoader = (url: string, hint?: {
+    format?: string;
+}) => Promise<LoadedModel>;
+interface GltfResult extends LoadedModel {
+    readonly userData?: Record<string, unknown>;
+    readonly parser?: {
+        json?: {
+            extensionsUsed?: unknown;
+        };
+    };
+}
+/** The slice of three's `GLTFLoader` used here. */
+export interface GltfLoaderLike {
+    register(plugin: (parser: unknown) => unknown): unknown;
+    loadAsync(url: string): Promise<GltfResult>;
+}
+export interface GltfLoaderOptions {
+    /** `() => import('@pixiv/three-vrm')` — needed only to load VRM avatars through a bundler. */
+    readonly loadVrm?: VrmModuleLoader;
+    /** Test seam: a fresh loader. Defaults to three's own `GLTFLoader`, imported lazily. */
+    readonly createLoader?: () => Promise<GltfLoaderLike>;
+}
+/**
+ * three's GLTFLoader, plus VRM when the avatar is one: by its declared
+ * `format: 'vrm'`, or because the loaded file carries the VRM extension.
+ * `@pixiv/three-vrm` is only touched on those two paths; a plain glTF never
+ * asks for it.
+ */
+export declare const gltfLoader: (opts?: GltfLoaderOptions) => ModelLoader;
+/** Load each URL once; every caller gets its own clone, because a scene can have one parent. */
+export declare const cachedLoader: (load: ModelLoader) => ModelLoader;
+/** The translation that moves `anchor` of `box` to the origin. */
+export declare function anchorOffset(box: Box3, anchor: ModelAnchor): Vector3;
+/** Wrap a loaded scene so its scale and anchor are applied and the wrapper sits at the origin. */
+export declare function fitModel(model: Object3D, scale?: number, anchor?: ModelAnchor): Group;
+export {};
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEhF,OAAO,EAA2B,KAAK,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAEvF,eAAO,MAAM,aAAa,4CAA6C,CAAC;AACxE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B;AACD,2FAA2F;AAC3F,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAE5F,UAAU,UAAW,SAAQ,WAAW;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE;YAAE,cAAc,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC;CAC3D;AACD,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC;IACxD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAChC,8FAA8F;IAC9F,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,wFAAwF;IACxF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;CACvD;AAOD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,UAAU,iBAAiB,KAAQ,WAwBzD,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,YAAY,SAAU,WAAW,KAAG,WAahD,CAAC;AAEF,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAWpE;AAED,kGAAkG;AAClG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,SAAI,EAAE,MAAM,GAAE,WAAsB,GAAG,KAAK,CAS1F"}

package/dist/model.js

@@ -0,0 +1,86 @@
+/**
+ * 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';
+import { loadVrmModule, wantsVrm } from './vrm.js';
+export const MODEL_ANCHORS = ['center', 'base', 'top', 'back'];
+const threeLoader = async () => {
+    const { GLTFLoader } = await import('three/examples/jsm/loaders/GLTFLoader.js');
+    return new GLTFLoader();
+};
+/**
+ * three's GLTFLoader, plus VRM when the avatar is one: by its declared
+ * `format: 'vrm'`, or because the loaded file carries the VRM extension.
+ * `@pixiv/three-vrm` is only touched on those two paths; a plain glTF never
+ * asks for it.
+ */
+export const gltfLoader = (opts = {}) => {
+    const create = opts.createLoader ?? threeLoader;
+    let plain = null;
+    const withVrm = async (url) => {
+        const mod = await loadVrmModule(opts.loadVrm);
+        const loader = await create();
+        loader.register((parser) => new mod.VRMLoaderPlugin(parser));
+        const gltf = await loader.loadAsync(url);
+        const vrm = (gltf.userData?.['vrm'] ?? null);
+        if (vrm === null) {
+            // Declared VRM but the file has no VRM data: it is a plain glTF after all.
+            return gltf;
+        }
+        mod.VRMUtils?.rotateVRM0?.(vrm); // VRM 0.x faces -Z; this turns it to +Z, and ignores 1.0
+        return { scene: vrm.scene, animations: gltf.animations, vrm };
+    };
+    return async (url, hint) => {
+        if (wantsVrm(hint?.format)) {
+            return withVrm(url);
+        }
+        plain ??= await create();
+        const gltf = await plain.loadAsync(url);
+        return wantsVrm(undefined, gltf) ? withVrm(url) : gltf;
+    };
+};
+/** 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, hint) => {
+        let p = cache.get(url);
+        if (p === undefined) {
+            p = hint === undefined ? load(url) : load(url, hint);
+            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"}