@worldmesh/runtime 0.1.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,79 @@
+# @worldmesh/runtime
+
+The shared [WorldMesh](https://github.com/eliaswillnat/worldmesh) navigation
+runtime: controls, movement, camera, player, abilities and portals.
+
+WorldMesh is a lightweight open network for independently hosted 3D worlds. It
+supplies the one thing separately hosted worlds need in common — a navigation
+standard — so that moving through an unfamiliar world feels like moving through
+a familiar one. This package is that standard, as code.
+
+## Install
+
+```bash
+npm i @worldmesh/runtime three
+```
+
+`three` is a peer dependency (`>=0.160.0`): the runtime drives your renderer,
+your scene and your camera, so it must use the same copy of Three.js you do.
+
+The package is ESM only and targets ES2022 browsers. It touches `window` and
+`document` when you create a world, so call it from the browser, not during SSR.
+
+## Use it
+
+If you already have a scene, a camera and a renderer, this is the whole job:
+
+```js
+import { createWorldMesh } from '@worldmesh/runtime';
+
+const world = createWorldMesh({
+  scene,
+  camera,
+  renderer,
+  spawn: [0, 2, 0],
+  colliders,                    // things to stand on and bump into
+  abilities: { doubleJump: true },
+  portals: [{ url: 'https://someone-elses-world.example', position: [6, 0, -6] }],
+});
+```
+
+You get WASD + arrow keys, mouse look, jump, sprint, interact, first/third
+person with a consistent toggle, pointer-lock handling, touch controls on touch
+devices, the shared overlay and portals between worlds.
+
+Removing the `createWorldMesh` call leaves you with the Three.js project you
+started with.
+
+## What is exported
+
+| | |
+| --- | --- |
+| `createWorldMesh` | the one call a world needs |
+| `Input`, `TouchControls`, `DEFAULT_KEYMAP`, `resolveKeymap` | the control convention |
+| `MovementController`, `CollisionWorld`, `DEFAULT_TUNING` | movement and collision |
+| `CameraRig`, `Player`, `createDefaultAvatar`, `AVATAR_EXPRESSIONS` | camera and figure |
+| `PortalManager`, `buildTravelUrl`, `getReferringWorld` | travel between worlds |
+| `Overlay`, `Emitter` | the shared overlay, a tiny typed emitter |
+| `serializePlayerState`, `deserializePlayerState`, `NetworkAdapter` | the multiplayer seam |
+| `WORLDMESH_VERSION`, `WORLDMESH_PROTOCOL` | what your world is speaking |
+
+Full option, handle and event reference:
+[docs/compatibility.md](https://github.com/eliaswillnat/worldmesh/blob/main/docs/compatibility.md).
+Control convention:
+[docs/controls.md](https://github.com/eliaswillnat/worldmesh/blob/main/docs/controls.md).
+
+## Versions
+
+`WORLDMESH_VERSION` tracks this package's version. `WORLDMESH_PROTOCOL` is a
+separate integer that only changes when the world-facing contract changes in a
+way a world would have to react to — see
+[docs/publishing.md](https://github.com/eliaswillnat/worldmesh/blob/main/docs/publishing.md).
+
+```js
+import { WORLDMESH_PROTOCOL } from '@worldmesh/runtime';
+```
+
+## License
+
+MIT

package/dist/abilities/abilities.d.ts

@@ -0,0 +1,9 @@
+import type { Abilities } from '../types.js';
+export declare const DEFAULT_ABILITIES: Abilities;
+/**
+ * Merge a world's declared abilities over the defaults. Abilities are pure
+ * configuration: the shared controller reads these flags, so a world never
+ * has to fork the movement code to add one.
+ */
+export declare function resolveAbilities(declared?: Partial<Abilities>): Abilities;
+//# sourceMappingURL=abilities.d.ts.map

package/dist/abilities/abilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abilities.d.ts","sourceRoot":"","sources":["../../src/abilities/abilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,eAAO,MAAM,iBAAiB,EAAE,SAQ/B,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,GAAE,OAAO,CAAC,SAAS,CAAM,GAAG,SAAS,CAU7E"}

package/dist/abilities/abilities.js

@@ -0,0 +1,25 @@
+export const DEFAULT_ABILITIES = {
+    doubleJump: false,
+    flying: false,
+    crouching: false,
+    dash: false,
+    climbing: false,
+    swimming: false,
+    vehicles: false,
+};
+const RESERVED = ['climbing', 'swimming', 'vehicles'];
+/**
+ * Merge a world's declared abilities over the defaults. Abilities are pure
+ * configuration: the shared controller reads these flags, so a world never
+ * has to fork the movement code to add one.
+ */
+export function resolveAbilities(declared = {}) {
+    const abilities = { ...DEFAULT_ABILITIES, ...declared };
+    for (const key of RESERVED) {
+        if (abilities[key]) {
+            console.warn(`[worldmesh] ability "${key}" is reserved in the standard but not implemented yet; it will have no effect.`);
+        }
+    }
+    return abilities;
+}
+//# sourceMappingURL=abilities.js.map

package/dist/abilities/abilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abilities.js","sourceRoot":"","sources":["../../src/abilities/abilities.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAc;IAC1C,UAAU,EAAE,KAAK;IACjB,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,KAAK;IAChB,IAAI,EAAE,KAAK;IACX,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,KAAK;CAChB,CAAC;AAEF,MAAM,QAAQ,GAAwB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAE3E;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAA+B,EAAE;IAChE,MAAM,SAAS,GAAc,EAAE,GAAG,iBAAiB,EAAE,GAAG,QAAQ,EAAE,CAAC;IACnE,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CACV,wBAAwB,GAAG,gFAAgF,CAC5G,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/camera/cameraRig.d.ts

@@ -0,0 +1,39 @@
+import { Vector3, type Camera } from 'three';
+import type { CollisionWorld } from '../movement/collision.js';
+import type { ViewMode, ViewOptions } from '../types.js';
+export interface CameraRigOptions extends ViewOptions {
+    camera: Camera;
+    collision: CollisionWorld;
+}
+/**
+ * Owns yaw/pitch and both camera modes. Worlds get first- and third-person
+ * for free, with the same toggle key everywhere, because this lives in the
+ * runtime rather than in each world's main.ts.
+ */
+export declare class CameraRig {
+    yaw: number;
+    pitch: number;
+    mode: ViewMode;
+    distance: number;
+    sensitivity: number;
+    private camera;
+    private collision;
+    private minDistance;
+    private maxDistance;
+    private euler;
+    private target;
+    private offset;
+    /** Smoothed boom length so the camera does not pop when it clears a wall. */
+    private currentBoom;
+    constructor(options: CameraRigOptions);
+    look(dx: number, dy: number): void;
+    zoom(wheel: number): void;
+    setMode(mode: ViewMode): void;
+    toggleMode(): ViewMode;
+    /** Point the camera at the player. `feet` is the player's base position. */
+    update(dt: number, feet: Vector3, eyeHeight: number): void;
+    /** Horizontal forward vector, for spawn orientation helpers. */
+    getForward(out?: Vector3): Vector3;
+    resize(width: number, height: number): void;
+}
+//# sourceMappingURL=cameraRig.d.ts.map

package/dist/camera/cameraRig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraRig.d.ts","sourceRoot":"","sources":["../../src/camera/cameraRig.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,OAAO,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAKzD,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,cAAc,CAAC;CAC3B;AAED;;;;GAIG;AACH,qBAAa,SAAS;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAiB;IAC/B,6EAA6E;IAC7E,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,gBAAgB;IAarC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAMlC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKzB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAK7B,UAAU,IAAI,QAAQ;IAKtB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAqB1D,gEAAgE;IAChE,UAAU,CAAC,GAAG,UAAgB,GAAG,OAAO;IAIxC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAM5C"}

package/dist/camera/cameraRig.js

@@ -0,0 +1,88 @@
+import { Euler, PerspectiveCamera, Vector3 } from 'three';
+const HALF_PI = Math.PI / 2;
+const PITCH_LIMIT = HALF_PI - 0.01;
+/**
+ * Owns yaw/pitch and both camera modes. Worlds get first- and third-person
+ * for free, with the same toggle key everywhere, because this lives in the
+ * runtime rather than in each world's main.ts.
+ */
+export class CameraRig {
+    yaw;
+    pitch;
+    mode;
+    distance;
+    sensitivity;
+    camera;
+    collision;
+    minDistance;
+    maxDistance;
+    euler = new Euler(0, 0, 0, 'YXZ');
+    target = new Vector3();
+    offset = new Vector3();
+    /** Smoothed boom length so the camera does not pop when it clears a wall. */
+    currentBoom;
+    constructor(options) {
+        this.camera = options.camera;
+        this.collision = options.collision;
+        this.mode = options.mode ?? 'first';
+        this.distance = options.distance ?? 5;
+        this.currentBoom = this.distance;
+        this.minDistance = options.minDistance ?? 2;
+        this.maxDistance = options.maxDistance ?? 12;
+        this.sensitivity = options.sensitivity ?? 0.0022;
+        this.yaw = options.yaw ?? 0;
+        this.pitch = options.pitch ?? 0;
+    }
+    look(dx, dy) {
+        this.yaw -= dx * this.sensitivity;
+        this.pitch -= dy * this.sensitivity;
+        this.pitch = Math.max(-PITCH_LIMIT, Math.min(PITCH_LIMIT, this.pitch));
+    }
+    zoom(wheel) {
+        if (this.mode !== 'third' || wheel === 0)
+            return;
+        this.distance = clamp(this.distance + wheel * 0.01, this.minDistance, this.maxDistance);
+    }
+    setMode(mode) {
+        this.mode = mode;
+        if (mode === 'third')
+            this.currentBoom = this.distance;
+    }
+    toggleMode() {
+        this.setMode(this.mode === 'first' ? 'third' : 'first');
+        return this.mode;
+    }
+    /** Point the camera at the player. `feet` is the player's base position. */
+    update(dt, feet, eyeHeight) {
+        this.euler.set(this.pitch, this.yaw, 0);
+        this.camera.quaternion.setFromEuler(this.euler);
+        this.target.set(feet.x, feet.y + eyeHeight, feet.z);
+        if (this.mode === 'first') {
+            this.camera.position.copy(this.target);
+            this.currentBoom = this.distance;
+            return;
+        }
+        // Boom backwards along the view direction, pulled in by anything in the way.
+        this.offset.set(0, 0, 1).applyQuaternion(this.camera.quaternion);
+        const wanted = this.collision.castDistance(this.target, this.offset, this.distance + 0.3) - 0.3;
+        const boom = clamp(wanted, 0.4, this.distance);
+        // Snap in fast, ease out slowly: popping into geometry is worse than lag.
+        const rate = boom < this.currentBoom ? 1 : 1 - Math.exp(-8 * dt);
+        this.currentBoom += (boom - this.currentBoom) * rate;
+        this.camera.position.copy(this.target).addScaledVector(this.offset, this.currentBoom);
+    }
+    /** Horizontal forward vector, for spawn orientation helpers. */
+    getForward(out = new Vector3()) {
+        return out.set(-Math.sin(this.yaw), 0, -Math.cos(this.yaw));
+    }
+    resize(width, height) {
+        if (this.camera instanceof PerspectiveCamera) {
+            this.camera.aspect = width / height;
+            this.camera.updateProjectionMatrix();
+        }
+    }
+}
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+//# sourceMappingURL=cameraRig.js.map

package/dist/camera/cameraRig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraRig.js","sourceRoot":"","sources":["../../src/camera/cameraRig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAe,MAAM,OAAO,CAAC;AAIvE,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;AAC5B,MAAM,WAAW,GAAG,OAAO,GAAG,IAAI,CAAC;AAOnC;;;;GAIG;AACH,MAAM,OAAO,SAAS;IACpB,GAAG,CAAS;IACZ,KAAK,CAAS;IACd,IAAI,CAAW;IACf,QAAQ,CAAS;IACjB,WAAW,CAAS;IAEZ,MAAM,CAAS;IACf,SAAS,CAAiB;IAC1B,WAAW,CAAS;IACpB,WAAW,CAAS;IACpB,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IAClC,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;IACvB,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;IAC/B,6EAA6E;IACrE,WAAW,CAAS;IAE5B,YAAY,OAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;QAC7C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,MAAM,CAAC;QACjD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,CAAC,EAAU,EAAE,EAAU;QACzB,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;QAClC,IAAI,CAAC,KAAK,IAAI,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,CAAC,KAAa;QAChB,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO;QACjD,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,GAAG,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1F,CAAC;IAED,OAAO,CAAC,IAAc;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,IAAI,KAAK,OAAO;YAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC;IACzD,CAAC;IAED,UAAU;QACR,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,EAAU,EAAE,IAAa,EAAE,SAAiB;QACjD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpD,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC;YACjC,OAAO;QACT,CAAC;QAED,6EAA6E;QAC7E,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAChG,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/C,0EAA0E;QAC1E,MAAM,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACxF,CAAC;IAED,gEAAgE;IAChE,UAAU,CAAC,GAAG,GAAG,IAAI,OAAO,EAAE;QAC5B,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,MAAc;QAClC,IAAI,IAAI,CAAC,MAAM,YAAY,iBAAiB,EAAE,CAAC;YAC7C,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,sBAAsB,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;CACF;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/controls/input.d.ts

@@ -0,0 +1,64 @@
+import type { InputAction, Keymap } from '../types.js';
+export interface InputOptions {
+    /** The element that receives pointer lock. */
+    element: HTMLElement;
+    keymap?: Partial<Keymap>;
+    onPointerLockChange?: (locked: boolean) => void;
+}
+/**
+ * Keyboard + pointer-lock mouse input with mobile touch controls support.
+ * This is the only place in WorldMesh that reads raw browser events, so the
+ * control convention lives in one file instead of being copy-pasted into every world.
+ */
+export declare class Input {
+    readonly keymap: Keymap;
+    /** Accumulated mouse movement since the last read, in pixels. */
+    mouseDeltaX: number;
+    mouseDeltaY: number;
+    /** Accumulated wheel movement since the last read. */
+    wheelDelta: number;
+    locked: boolean;
+    private element;
+    private pressed;
+    /** Actions that went down this frame and have not been consumed yet. */
+    private justPressed;
+    /** The last number key pressed this frame, if any. */
+    private pendingDigit;
+    private codeToActions;
+    private onPointerLockChange?;
+    private touch?;
+    private disposed;
+    constructor(options: InputOptions);
+    requestPointerLock(touchTriggered?: boolean): void;
+    setLocked(locked: boolean): void;
+    exitPointerLock(): void;
+    triggerAction(action: InputAction): void;
+    isDown(action: InputAction): boolean;
+    /** True once per key press. Reading it clears the flag. */
+    consume(action: InputAction): boolean;
+    /** The number key (0–9) pressed this frame, once. Reading it clears it. */
+    consumeDigit(): number | null;
+    /** Movement intent on the local XZ plane, already normalized. */
+    getMoveAxis(): {
+        x: number;
+        z: number;
+    };
+    /** Read and reset the mouse/wheel/touch accumulators. Call once per frame. */
+    readLook(): {
+        dx: number;
+        dy: number;
+        wheel: number;
+    };
+    /** Drop stale edge-triggers at the end of a frame. */
+    endFrame(): void;
+    dispose(): void;
+    private handleKeyDown;
+    private handleKeyUp;
+    /** Losing focus must not leave a key stuck down. */
+    private handleBlur;
+    private handleMouseMove;
+    private handleWheel;
+    private handlePointerLockChange;
+    private handlePointerLockError;
+}
+//# sourceMappingURL=input.d.ts.map

package/dist/controls/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/controls/input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIvD,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACjD;AAED;;;;GAIG;AACH,qBAAa,KAAK;IAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,WAAW,SAAK;IAChB,WAAW,SAAK;IAChB,sDAAsD;IACtD,UAAU,SAAK;IACf,MAAM,UAAS;IAEf,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,OAAO,CAAqB;IACpC,wEAAwE;IACxE,OAAO,CAAC,WAAW,CAA0B;IAC7C,sDAAsD;IACtD,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,mBAAmB,CAAC,CAA4B;IACxD,OAAO,CAAC,KAAK,CAAC,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,YAAY;IA+BjC,kBAAkB,CAAC,cAAc,UAAQ,GAAG,IAAI;IA4BhD,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAYhC,eAAe,IAAI,IAAI;IAOvB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIxC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAMpC,2DAA2D;IAC3D,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAOrC,2EAA2E;IAC3E,YAAY,IAAI,MAAM,GAAG,IAAI;IAM7B,iEAAiE;IACjE,WAAW,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAgBvC,8EAA8E;IAC9E,QAAQ,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAerD,sDAAsD;IACtD,QAAQ,IAAI,IAAI;IAKhB,OAAO,IAAI,IAAI;IAcf,OAAO,CAAC,aAAa,CAcnB;IAEF,OAAO,CAAC,WAAW,CAEjB;IAEF,oDAAoD;IACpD,OAAO,CAAC,UAAU,CAGhB;IAEF,OAAO,CAAC,eAAe,CAIrB;IAEF,OAAO,CAAC,WAAW,CAGjB;IAEF,OAAO,CAAC,uBAAuB,CAQ7B;IAEF,OAAO,CAAC,sBAAsB,CAK5B;CACH"}

package/dist/controls/input.js

@@ -0,0 +1,236 @@
+import { resolveKeymap } from './keymap.js';
+import { TouchControls, isTouchDevice } from './touch.js';
+/**
+ * Keyboard + pointer-lock mouse input with mobile touch controls support.
+ * This is the only place in WorldMesh that reads raw browser events, so the
+ * control convention lives in one file instead of being copy-pasted into every world.
+ */
+export class Input {
+    keymap;
+    /** Accumulated mouse movement since the last read, in pixels. */
+    mouseDeltaX = 0;
+    mouseDeltaY = 0;
+    /** Accumulated wheel movement since the last read. */
+    wheelDelta = 0;
+    locked = false;
+    element;
+    pressed = new Set();
+    /** Actions that went down this frame and have not been consumed yet. */
+    justPressed = new Set();
+    /** The last number key pressed this frame, if any. */
+    pendingDigit = null;
+    codeToActions = new Map();
+    onPointerLockChange;
+    touch;
+    disposed = false;
+    constructor(options) {
+        this.element = options.element;
+        this.keymap = resolveKeymap(options.keymap);
+        this.onPointerLockChange = options.onPointerLockChange;
+        for (const action of Object.keys(this.keymap)) {
+            for (const code of this.keymap[action]) {
+                const list = this.codeToActions.get(code) ?? [];
+                list.push(action);
+                this.codeToActions.set(code, list);
+            }
+        }
+        // Touch controls on mobile / touchscreens
+        this.element.style.touchAction = 'none';
+        if (typeof window !== 'undefined') {
+            this.touch = new TouchControls({
+                element: this.element,
+                onExit: () => this.exitPointerLock(),
+            });
+        }
+        window.addEventListener('keydown', this.handleKeyDown);
+        window.addEventListener('keyup', this.handleKeyUp);
+        window.addEventListener('blur', this.handleBlur);
+        document.addEventListener('pointerlockchange', this.handlePointerLockChange);
+        document.addEventListener('pointerlockerror', this.handlePointerLockError);
+        this.element.addEventListener('mousemove', this.handleMouseMove);
+        this.element.addEventListener('wheel', this.handleWheel, { passive: true });
+    }
+    requestPointerLock(touchTriggered = false) {
+        if (this.disposed || this.locked)
+            return;
+        // Mobile / touch devices do not support pointer lock. Enter directly.
+        if (touchTriggered || isTouchDevice()) {
+            this.setLocked(true);
+            return;
+        }
+        if (typeof this.element.requestPointerLock === 'function') {
+            try {
+                const promise = this.element.requestPointerLock();
+                if (promise && typeof promise.then === 'function') {
+                    promise.catch(() => {
+                        // Pointer lock rejected (e.g. mobile Safari, tablet, iframe restrictions)
+                        this.setLocked(true);
+                    });
+                    return;
+                }
+            }
+            catch {
+                this.setLocked(true);
+                return;
+            }
+        }
+        else {
+            this.setLocked(true);
+        }
+    }
+    setLocked(locked) {
+        if (this.locked === locked)
+            return;
+        this.locked = locked;
+        if (!locked) {
+            this.pressed.clear();
+            this.justPressed.clear();
+            this.touch?.reset();
+        }
+        this.touch?.setVisible(locked && isTouchDevice());
+        this.onPointerLockChange?.(this.locked);
+    }
+    exitPointerLock() {
+        if (document.pointerLockElement === this.element) {
+            document.exitPointerLock();
+        }
+        this.setLocked(false);
+    }
+    triggerAction(action) {
+        this.justPressed.add(action);
+    }
+    isDown(action) {
+        if (this.touch?.isDown(action))
+            return true;
+        for (const code of this.keymap[action])
+            if (this.pressed.has(code))
+                return true;
+        return false;
+    }
+    /** True once per key press. Reading it clears the flag. */
+    consume(action) {
+        if (this.touch?.consume(action))
+            return true;
+        if (!this.justPressed.has(action))
+            return false;
+        this.justPressed.delete(action);
+        return true;
+    }
+    /** The number key (0–9) pressed this frame, once. Reading it clears it. */
+    consumeDigit() {
+        const digit = this.pendingDigit;
+        this.pendingDigit = null;
+        return digit;
+    }
+    /** Movement intent on the local XZ plane, already normalized. */
+    getMoveAxis() {
+        let x = (this.isDown('right') ? 1 : 0) - (this.isDown('left') ? 1 : 0);
+        let z = (this.isDown('backward') ? 1 : 0) - (this.isDown('forward') ? 1 : 0);
+        if (this.touch) {
+            const touchAxis = this.touch.getMoveAxis();
+            x += touchAxis.x;
+            z += touchAxis.z;
+        }
+        const length = Math.hypot(x, z);
+        if (length === 0)
+            return { x: 0, z: 0 };
+        if (length > 1)
+            return { x: x / length, z: z / length };
+        return { x, z };
+    }
+    /** Read and reset the mouse/wheel/touch accumulators. Call once per frame. */
+    readLook() {
+        let dx = this.mouseDeltaX;
+        let dy = this.mouseDeltaY;
+        if (this.touch) {
+            const touchLook = this.touch.readLook();
+            dx += touchLook.dx;
+            dy += touchLook.dy;
+        }
+        const look = { dx, dy, wheel: this.wheelDelta };
+        this.mouseDeltaX = 0;
+        this.mouseDeltaY = 0;
+        this.wheelDelta = 0;
+        return look;
+    }
+    /** Drop stale edge-triggers at the end of a frame. */
+    endFrame() {
+        this.justPressed.clear();
+        this.pendingDigit = null;
+    }
+    dispose() {
+        this.disposed = true;
+        this.touch?.dispose();
+        window.removeEventListener('keydown', this.handleKeyDown);
+        window.removeEventListener('keyup', this.handleKeyUp);
+        window.removeEventListener('blur', this.handleBlur);
+        document.removeEventListener('pointerlockchange', this.handlePointerLockChange);
+        document.removeEventListener('pointerlockerror', this.handlePointerLockError);
+        this.element.removeEventListener('mousemove', this.handleMouseMove);
+        this.element.removeEventListener('wheel', this.handleWheel);
+        this.pressed.clear();
+        this.justPressed.clear();
+    }
+    handleKeyDown = (event) => {
+        if (event.repeat)
+            return;
+        if (isTypingTarget(event.target))
+            return;
+        const actions = this.codeToActions.get(event.code);
+        if (!actions) {
+            // Unbound number keys pick a face for the avatar.
+            const digit = /^(?:Digit|Numpad)(\d)$/.exec(event.code);
+            if (digit)
+                this.pendingDigit = Number(digit[1]);
+            return;
+        }
+        // Space and the arrow keys scroll the page otherwise.
+        if (event.code === 'Space' || event.code.startsWith('Arrow'))
+            event.preventDefault();
+        this.pressed.add(event.code);
+        for (const action of actions)
+            this.justPressed.add(action);
+    };
+    handleKeyUp = (event) => {
+        this.pressed.delete(event.code);
+    };
+    /** Losing focus must not leave a key stuck down. */
+    handleBlur = () => {
+        this.pressed.clear();
+        this.justPressed.clear();
+    };
+    handleMouseMove = (event) => {
+        if (!this.locked)
+            return;
+        this.mouseDeltaX += event.movementX;
+        this.mouseDeltaY += event.movementY;
+    };
+    handleWheel = (event) => {
+        if (!this.locked)
+            return;
+        this.wheelDelta += event.deltaY;
+    };
+    handlePointerLockChange = () => {
+        const isLocked = document.pointerLockElement === this.element;
+        if (isLocked) {
+            this.setLocked(true);
+        }
+        else if (!isTouchDevice()) {
+            // On non-touch desktop, losing pointer lock releases controls
+            this.setLocked(false);
+        }
+    };
+    handlePointerLockError = () => {
+        // If pointer lock failed on desktop / iframe, still let the user enter
+        if (!this.locked) {
+            this.setLocked(true);
+        }
+    };
+}
+function isTypingTarget(target) {
+    if (!(target instanceof HTMLElement))
+        return false;
+    const tag = target.tagName;
+    return tag === 'INPUT' || tag === 'TEXTAREA' || target.isContentEditable;
+}
+//# sourceMappingURL=input.js.map

package/dist/controls/input.js.map

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

package/dist/controls/keymap.d.ts

@@ -0,0 +1,8 @@
+import type { Keymap } from '../types.js';
+/**
+ * The WorldMesh control convention. Every world ships these bindings so that
+ * moving through an unfamiliar world feels like moving through a familiar one.
+ */
+export declare const DEFAULT_KEYMAP: Keymap;
+export declare function resolveKeymap(overrides?: Partial<Keymap>): Keymap;
+//# sourceMappingURL=keymap.d.ts.map

package/dist/controls/keymap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keymap.d.ts","sourceRoot":"","sources":["../../src/controls/keymap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAY5B,CAAC;AAEF,wBAAgB,aAAa,CAAC,SAAS,GAAE,OAAO,CAAC,MAAM,CAAM,GAAG,MAAM,CAErE"}

package/dist/controls/keymap.js

@@ -0,0 +1,21 @@
+/**
+ * The WorldMesh control convention. Every world ships these bindings so that
+ * moving through an unfamiliar world feels like moving through a familiar one.
+ */
+export const DEFAULT_KEYMAP = {
+    forward: ['KeyW', 'ArrowUp'],
+    backward: ['KeyS', 'ArrowDown'],
+    left: ['KeyA', 'ArrowLeft'],
+    right: ['KeyD', 'ArrowRight'],
+    jump: ['Space'],
+    sprint: ['ShiftLeft', 'ShiftRight'],
+    interact: ['KeyE'],
+    toggleView: ['KeyV'],
+    crouch: ['KeyC'],
+    fly: ['KeyF'],
+    dash: ['KeyQ'],
+};
+export function resolveKeymap(overrides = {}) {
+    return { ...DEFAULT_KEYMAP, ...overrides };
+}
+//# sourceMappingURL=keymap.js.map

package/dist/controls/keymap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keymap.js","sourceRoot":"","sources":["../../src/controls/keymap.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAW;IACpC,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;IAC5B,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;IAC/B,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;IAC3B,KAAK,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC;IAC7B,IAAI,EAAE,CAAC,OAAO,CAAC;IACf,MAAM,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;IACnC,QAAQ,EAAE,CAAC,MAAM,CAAC;IAClB,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,MAAM,CAAC;IAChB,GAAG,EAAE,CAAC,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,YAA6B,EAAE;IAC3D,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,SAAS,EAAE,CAAC;AAC7C,CAAC"}