lantern-engine 0.0.0-stage → 0.4.0

package/dist/types/engine/Scene.d.ts

@@ -0,0 +1,37 @@
+import { Container } from 'pixi.js';
+import { World } from '../ecs/World.js';
+import type { Engine } from './Engine.js';
+/**
+ * One screen of the game: a title, a level, a pause menu. A scene owns a `World` of entities and systems and a
+ * `root` container in the engine's world layer; both are cleared when it leaves, so nothing it made outlives it.
+ *
+ * Override the hooks you need. `fixedUpdate` runs once per simulation step, `update` once per rendered frame, both
+ * after the world's own systems of that phase.
+ */
+export declare abstract class Scene {
+    readonly world: World;
+    /** Everything the scene draws in the world goes under this (the camera moves it). */
+    readonly root: Container<import("pixi.js").ContainerChild>;
+    /** Everything the scene draws on the screen (HUD) goes under this. */
+    readonly hud: Container<import("pixi.js").ContainerChild>;
+    private bound;
+    /** The engine running this scene; only valid between `enter` and `exit`. */
+    get engine(): Engine;
+    /** Called once when the scene becomes active. May be async: the scene starts updating when it resolves. */
+    onEnter(): void | Promise<void>;
+    /** Called when the scene is removed. The world and containers are cleared after it returns. */
+    onExit(): void;
+    /** Called when another scene is pushed over this one. */
+    onPause(): void;
+    /** Called when the scene over this one is popped. */
+    onResume(): void;
+    /** Once per simulation step, `dt` in seconds. */
+    fixedUpdate(_dt: number): void;
+    /** Once per rendered frame, `dt` in seconds; `alpha` is the share of a step since the last one (0–1). */
+    update(_dt: number, _alpha: number): void;
+    /** @internal Engine-side wiring; games call `engine.scenes`. */
+    attach(engine: Engine): void;
+    /** @internal Clears what the scene made but keeps its containers, so the same scene may be entered again. */
+    detach(): void;
+}
+//# sourceMappingURL=Scene.d.ts.map

package/dist/types/engine/Scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scene.d.ts","sourceRoot":"","sources":["../../../src/engine/Scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;;;GAMG;AACH,8BAAsB,KAAK;IACzB,QAAQ,CAAC,KAAK,QAAe;IAC7B,qFAAqF;IACrF,QAAQ,CAAC,IAAI,8CAA6C;IAC1D,sEAAsE;IACtE,QAAQ,CAAC,GAAG,8CAAmB;IAC/B,OAAO,CAAC,KAAK,CAAuB;IAEpC,4EAA4E;IAC5E,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED,2GAA2G;IAC3G,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC/B,+FAA+F;IAC/F,MAAM,IAAI,IAAI;IACd,yDAAyD;IACzD,OAAO,IAAI,IAAI;IACf,qDAAqD;IACrD,QAAQ,IAAI,IAAI;IAChB,iDAAiD;IACjD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAC9B,yGAAyG;IACzG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAEzC,gEAAgE;IAChE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAM5B,6GAA6G;IAC7G,MAAM,IAAI,IAAI;CAQf"}

package/dist/types/engine/SceneManager.d.ts

@@ -0,0 +1,31 @@
+import type { Engine } from './Engine.js';
+import type { Scene } from './Scene.js';
+/**
+ * A stack of scenes. Only the top one updates; the ones under it are paused but still drawn (a pause menu over the
+ * level). Changes are queued and applied one at a time, so a scene that replaces itself from inside its own update,
+ * or an async `onEnter` still loading, never leaves two scenes half entered.
+ */
+export declare class SceneManager {
+    private readonly engine;
+    private readonly stack;
+    private queue;
+    /** True while an async `onEnter` is running: nothing updates until it is done. */
+    private entering;
+    constructor(engine: Engine);
+    /** The scene that updates, if any. */
+    get current(): Scene | undefined;
+    /** Every scene on the stack, bottom first. */
+    get all(): readonly Scene[];
+    /** Removes every scene and enters `scene`. */
+    replace(scene: Scene): Promise<void>;
+    /** Pauses the current scene and enters `scene` over it. */
+    push(scene: Scene): Promise<void>;
+    /** Leaves the current scene and resumes the one under it. */
+    pop(): Promise<void>;
+    /** Leaves every scene (the engine is shutting down). */
+    clear(): Promise<void>;
+    private enter;
+    private exitTop;
+    private enqueue;
+}
+//# sourceMappingURL=SceneManager.d.ts.map

package/dist/types/engine/SceneManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneManager.d.ts","sourceRoot":"","sources":["../../../src/engine/SceneManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;;;GAIG;AACH,qBAAa,YAAY;IAMX,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,KAAK,CAAoC;IACjD,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAS;gBAEI,MAAM,EAAE,MAAM;IAE3C,sCAAsC;IACtC,IAAI,OAAO,IAAI,KAAK,GAAG,SAAS,CAE/B;IAED,8CAA8C;IAC9C,IAAI,GAAG,IAAI,SAAS,KAAK,EAAE,CAE1B;IAED,8CAA8C;IAC9C,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpC,2DAA2D;IAC3D,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjC,6DAA6D;IAC7D,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAQpB,wDAAwD;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAMR,KAAK;IAanB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,OAAO;CAMhB"}

package/dist/types/events/EventBus.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Typed observer: listeners subscribe per event name and run in subscription order.
+ * `Events` maps each event name to its payload, e.g. `EventBus<{ enemyKilled: { id: number } }>`.
+ *
+ * A listener that throws does not stop the ones after it; the error is handed to `onError` (the console by default).
+ */
+export declare class EventBus<Events extends object> {
+    private readonly onError;
+    private readonly listeners;
+    constructor(onError?: (type: keyof Events, err: unknown) => void);
+    /** Subscribes to `type`; returns the unsubscribe function. */
+    on<K extends keyof Events>(type: K, fn: (payload: Events[K]) => void): () => void;
+    /** Subscribes for the next `type` only. */
+    once<K extends keyof Events>(type: K, fn: (payload: Events[K]) => void): () => void;
+    off<K extends keyof Events>(type: K, fn: (payload: Events[K]) => void): void;
+    emit<K extends keyof Events>(type: K, payload: Events[K]): void;
+    listenerCount(type: keyof Events): number;
+    clear(): void;
+}
+//# sourceMappingURL=EventBus.d.ts.map

package/dist/types/events/EventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../../src/events/EventBus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,QAAQ,CAAC,MAAM,SAAS,MAAM;IAG7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyD;gBAEtD,OAAO,GAAE,CAAC,IAAI,EAAE,MAAM,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAoF;IAEhK,8DAA8D;IAC9D,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAKjF,2CAA2C;IAC3C,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAQnF,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAQ5E,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAW/D,aAAa,CAAC,IAAI,EAAE,MAAM,MAAM,GAAG,MAAM;IAIzC,KAAK,IAAI,IAAI;CAGd"}

package/dist/types/fx/hitStop.d.ts

@@ -0,0 +1,20 @@
+/** The freeze-frame of a blow (ms): 40 for a scratch, up to 140 for one that took a third of the body; a crit +40. */
+export declare function hitStopMs(share: number, crit: boolean): number;
+/** How far the body struck recoils away from the blow (whole world px): a heavy body barely, a crit a pixel further. */
+export declare function recoilPx(heavy: boolean, share: number, crit: boolean): number;
+/** How long a recoil takes to settle back (ms). */
+export declare const RECOIL_MS = 120;
+/** The recoil left at `t` (0 the blow, 1 settled): out at once, eased back, whole pixels only. */
+export declare function recoilAt(px: number, t: number): number;
+/** The least time between two white flashes on a heavy body (ms). */
+export declare const HEAVY_FLASH_GAP_MS = 400;
+/**
+ * How long the body struck flashes white (ms), 0 for none: 70, a crit of one's own 140 (the impact frame), nothing with
+ * `reduce` (a "reduce flashes" setting). A heavy body (a boss, anything drawn large) flashes only for the local
+ * player's own crit, 60 ms, `HEAVY_FLASH_GAP_MS` apart: a sheet covering most of the screen turning white on every
+ * blow, beat and tick is a strobe. Sparks, numbers and the recoil still mark every blow.
+ */
+export declare function hurtFlashMs(heavy: boolean, impact: boolean, reduce: boolean): number;
+/** The gap a body keeps between two flashes (ms). */
+export declare function hurtFlashGapMs(heavy: boolean): number;
+//# sourceMappingURL=hitStop.d.ts.map

package/dist/types/fx/hitStop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hitStop.d.ts","sourceRoot":"","sources":["../../../src/fx/hitStop.ts"],"names":[],"mappings":"AAMA,sHAAsH;AACtH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAG9D;AAED,wHAAwH;AACxH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAG7E;AAED,mDAAmD;AACnD,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B,kGAAkG;AAClG,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAIpF;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAErD"}

package/dist/types/fx/viewCull.d.ts

@@ -0,0 +1,14 @@
+/** What `inView` reads off the main camera (Camera's own fields; a fake stage may lack them). */
+export interface CameraLike {
+    zoom: number;
+    scrollX?: number;
+    scrollY?: number;
+    width?: number;
+    height?: number;
+}
+/**
+ * Whether the world point (x, y) lies within `margin` world pixels of the screen. Effects use it to skip painting what
+ * nobody can see. A camera that has no size yet (a tool's fake stage, before the first resize) counts everything in.
+ */
+export declare function inView(cam: CameraLike, x: number, y: number, margin: number): boolean;
+//# sourceMappingURL=viewCull.d.ts.map

package/dist/types/fx/viewCull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewCull.d.ts","sourceRoot":"","sources":["../../../src/fx/viewCull.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAOrF"}

package/dist/types/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Lantern Engine: the core's public API, for 2D games in any art style. Pixel-art tools are `lantern-engine/pixel`.
+ * Anything not exported here or there is internal and may change in any release.
+ */
+export { Engine, type EngineOptions, type EngineEvents } from './engine/Engine.js';
+export { Scene } from './engine/Scene.js';
+export { SceneManager } from './engine/SceneManager.js';
+export { FixedLoop, type FixedLoopOptions } from './engine/FixedLoop.js';
+export { World, defineComponent, defineFields, entityIndex, system, type Entity, type ComponentType, type System, type SystemContext, type SystemPhase, type ComponentValues, } from './ecs/World.js';
+export type { FieldKind, FieldSpec, FieldsType, FieldValues, Columns, ArrayOf } from './ecs/fields.js';
+export { EventBus } from './events/EventBus.js';
+export { engineSettings, type EngineSettings, type SettingsListener } from './settings.js';
+export { Stage } from './core/Stage.js';
+export { Camera, type ViewRect, type TrackOptions } from './core/Camera.js';
+export { Clock } from './core/Clock.js';
+export { Tweener, Tween, type TweenConfig, type TweenTarget } from './core/Tweener.js';
+export { easeByName, type EaseFn } from './core/eases.js';
+export { ObjectFactory } from './core/ObjectFactory.js';
+export { Graphics, type Vec2 } from './core/Graphics.js';
+export { Image } from './core/Image.js';
+export { Group } from './core/Group.js';
+export { Rectangle } from './core/Rectangle.js';
+export { Text, type TextStyle } from './core/Text.js';
+export { BitmapLabel, installLabelFont, addLabelGlyphs } from './core/BitmapLabel.js';
+export { Pointer } from './core/Pointer.js';
+export { TextureRegistry, CanvasTexture } from './core/TextureRegistry.js';
+export { AtlasBuilder } from './core/atlas.js';
+export { planAtlas, atlasPageLimit, type AtlasSize, type AtlasPlan, type AtlasPage } from './core/atlasPlan.js';
+export type { WorldObject } from './core/types.js';
+export { AssetLoader, resolveUrl, type AssetLoaderOptions, type TilemapAssetOptions, type LoadProgress, type TextureSink } from './assets/AssetLoader.js';
+export { Animator, type AnimationClip, type AnimationClips } from './anim/Animator.js';
+export { animationSystem, SpriteComponent, AnimationComponent } from './anim/animationSystem.js';
+export { parseTiled, tileAt, tileRect, gidOf, layerByName, objectsOf, FLIP_H, FLIP_V, FLIP_D, type TileMap, type TileLayer, type ObjectLayer, type MapLayer, type MapObject, type Tileset, type Properties, type TiledPropertyValue, } from './tilemap/tiled.js';
+export { collisionFromTiled, type TiledCollisionOptions } from './tilemap/collision.js';
+export { TilemapView, type TilemapViewOptions } from './tilemap/TilemapView.js';
+export { Skeleton } from './rig/Skeleton.js';
+export { HUMANOID_RIG } from './rig/humanoid.js';
+export { blendPose, overlay, upperOver } from './rig/poseMath.js';
+export type { RigDef, RigPose, Limb, Face, Joints, Point as RigPoint } from './rig/rigTypes.js';
+export { HUMANOID_POSES, HUMANOID_CLIPS, type HumanoidClip } from './rig/humanoidPoses.js';
+export { PosePlayer, type PoseClip } from './rig/PosePlayer.js';
+export { RigView, RIG_PARTS, type RigPart, type PartSkin, type RigSkin, type RigViewOptions } from './rig/RigView.js';
+export { LightLayer, type Light, type LightLayerOptions } from './light/LightLayer.js';
+export { hitStopMs, recoilPx, recoilAt, RECOIL_MS, hurtFlashMs, hurtFlashGapMs, HEAVY_FLASH_GAP_MS } from './fx/hitStop.js';
+export { inView, type CameraLike } from './fx/viewCull.js';
+export { sound, SoundEngine, type SoundOptions } from './audio/SoundEngine.js';
+export { music, MusicPlayer, type PlayOptions as MusicOptions } from './audio/MusicPlayer.js';
+export { registerSounds, type SoundTable } from './audio/soundTable.js';
+export { registerTakes, hasTakes } from './audio/sampleBank.js';
+export { renderRecipe, SYNTH_RATE, type SynthRecipe, type SynthLayer } from './audio/synth.js';
+export { Keyboard } from './input/Keyboard.js';
+export { Actions, PAD_BUTTONS, type Bindings, type ActionsOptions, type PadState } from './input/Actions.js';
+export { aimAxis } from './input/aimAxis.js';
+export { stickVector, stickActive, stickToAxis, STICK_DEAD_ZONE, type StickVector } from './input/stickAxis.js';
+export { LongPress } from './input/longPress.js';
+export { isTouchUi, setNativeShell } from './platform/touch.js';
+export { TILE_SIZE, INPUT_STEP_RATE, INPUT_STEP_DT, INPUT_FLAG_DASH, BODY_HALF_WIDTH, BODY_HALF_HEIGHT, type InputStep, type MovementParams, type EntityUpdate, } from './net/constants.js';
+export { createCollisionGrid, createMover, stepMover, moveX, moveY, bodyCollides, isSolidTile, blocksShot, DIAGONAL, type CollisionGrid, type CollisionGridOptions, type MoverState, } from './net/movement.js';
+export { encodeSnapshotFrame, decodeSnapshotFrame, encodeUpdates, decodeUpdates, quantizeUpdates, UPDATE_RECORD_BYTES, type SnapshotLike, } from './net/snapshotCodec.js';
+export { CADENCE, cadenceEarly, cadenceNext } from './net/cadence.js';
+export { serverNow, serverOffset, noteServerTime, resetServerClock } from './net/serverClock.js';
+export { PredictedMover } from './net/PredictedMover.js';
+export { InterpolationBuffer, type InterpolatedState } from './net/InterpolationBuffer.js';
+export { Room, type RoomPlayer, type RoomOptions } from './net/Room.js';
+export { RoomHost, type HostSocket, type RoomHostOptions } from './net/RoomHost.js';
+export { Connection, type ConnectionEvents, type ConnectionOptions } from './net/Connection.js';
+export { moverToWire, moverFromWire, type ClientMessage, type ServerMessage, type Snapshot, type SpawnInfo, type MoverWire } from './net/protocol.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/input/Actions.d.ts

@@ -0,0 +1,75 @@
+import type { Keyboard } from './Keyboard.js';
+/**
+ * Named actions bound to any input: keys, gamepad buttons and sticks, and virtual buttons a touch UI presses. Game
+ * code asks for `'jump'`, never for `Space`, so players can rebind and every device works the same.
+ *
+ * ```ts
+ * const input = new Actions(keyboard, {
+ *   left: ['KeyA', 'ArrowLeft', 'pad:left', 'pad:lx-'],
+ *   right: ['KeyD', 'ArrowRight', 'pad:right', 'pad:lx+'],
+ *   jump: ['Space', 'pad:a'],
+ * });
+ * // in a fixed system:
+ * input.poll();
+ * if (input.pressed('jump')) …
+ * const [x, y] = input.vector('left', 'right', 'up', 'down');
+ * input.endStep();
+ * ```
+ *
+ * Bindings: a `KeyboardEvent.code` (`KeyW`, `Space`, `ArrowUp`), `pad:<button>` (standard mapping names below),
+ * `pad:<axis>+` / `pad:<axis>-` for a stick half (`lx`, `ly`, `rx`, `ry`), or `touch:<name>` for a virtual button
+ * (`press`/`release`).
+ */
+export type Bindings<A extends string> = Record<A, readonly string[]>;
+/** Button names of the browser's standard gamepad mapping, in index order. */
+export declare const PAD_BUTTONS: readonly ["a", "b", "x", "y", "lb", "rb", "lt", "rt", "select", "start", "ls", "rs", "up", "down", "left", "right", "home"];
+/** What the actions read from a gamepad; `navigator.getGamepads()` entries satisfy it. */
+export interface PadState {
+    readonly buttons: readonly {
+        readonly pressed: boolean;
+        readonly value: number;
+    }[];
+    readonly axes: readonly number[];
+}
+export interface ActionsOptions {
+    /** Stick values under this count as 0 (default 0.25). */
+    deadZone?: number;
+    /** Where gamepads come from (default `navigator.getGamepads`); tests pass their own. */
+    gamepads?: () => readonly (PadState | null)[];
+}
+export declare class Actions<A extends string> {
+    private readonly keyboard;
+    private bindings;
+    private readonly virtual;
+    private readonly virtualDown;
+    /** Analog value of each action this step (0–1), and last step's, for edges. */
+    private now;
+    private before;
+    private readonly deadZone;
+    private readonly gamepads;
+    constructor(keyboard: Keyboard | null, bindings: Bindings<A>, options?: ActionsOptions);
+    /** Replaces one action's bindings (a player's rebinding). */
+    bind(action: A, inputs: readonly string[]): void;
+    bindingsOf(action: A): readonly string[];
+    /** A touch UI's virtual button went down: `touch:<name>` bindings read it. */
+    press(name: string): void;
+    release(name: string): void;
+    /** Reads every device once; call at the start of each simulation step. */
+    poll(): void;
+    /** Held this step. */
+    down(action: A): boolean;
+    /** How far it is held (0–1): 1 for a key, the trigger or stick amount for analog input. */
+    value(action: A): number;
+    /** Went down this step. */
+    pressed(action: A): boolean;
+    /** Came up this step. */
+    released(action: A): boolean;
+    /** `value(positive) - value(negative)`, in −1…1. */
+    axis(negative: A, positive: A): number;
+    /** A 2D direction from four actions, never longer than 1 (a diagonal is not faster). */
+    vector(left: A, right: A, up: A, down: A): [number, number];
+    /** Ends the step: the keyboard forgets its edges; virtual taps shorter than a step have now been seen. */
+    endStep(): void;
+    private read;
+}
+//# sourceMappingURL=Actions.d.ts.map

package/dist/types/input/Actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Actions.d.ts","sourceRoot":"","sources":["../../../src/input/Actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;AAEtE,8EAA8E;AAC9E,eAAO,MAAM,WAAW,6HAA8H,CAAC;AAGvJ,0FAA0F;AAC1F,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnF,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,MAAM,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC;CAC/C;AAED,qBAAa,OAAO,CAAC,CAAC,SAAS,MAAM;IAWjC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAV3B,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,+EAA+E;IAC/E,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;gBAG3C,QAAQ,EAAE,QAAQ,GAAG,IAAI,EAC1C,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,OAAO,GAAE,cAAmB;IAQ9B,6DAA6D;IAC7D,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAIhD,UAAU,CAAC,MAAM,EAAE,CAAC,GAAG,SAAS,MAAM,EAAE;IAIxC,8EAA8E;IAC9E,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKzB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,0EAA0E;IAC1E,IAAI,IAAI,IAAI;IAWZ,sBAAsB;IACtB,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO;IAIxB,2FAA2F;IAC3F,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM;IAIxB,2BAA2B;IAC3B,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO;IAI3B,yBAAyB;IACzB,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO;IAI5B,oDAAoD;IACpD,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM;IAItC,wFAAwF;IACxF,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAO3D,0GAA0G;IAC1G,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,IAAI;CA6Bb"}

package/dist/types/input/Keyboard.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Which keys are held, by `KeyboardEvent.code` (the physical key, so WASD stays WASD on any layout). `pressed` and
+ * `released` report edges since the last `endStep`; call that once per simulation step so a tap shorter than a frame
+ * is still seen by exactly one step.
+ */
+export declare class Keyboard {
+    private readonly held;
+    private readonly down;
+    private readonly up;
+    private readonly cleanup;
+    constructor(target?: Window | HTMLElement);
+    isDown(code: string): boolean;
+    /** Any of these keys is held. */
+    anyDown(...codes: string[]): boolean;
+    /** Went down since the last `endStep`. */
+    pressed(code: string): boolean;
+    /** Came up since the last `endStep`. */
+    released(code: string): boolean;
+    /** -1, 0 or 1 from two sets of keys: `axis(['KeyA', 'ArrowLeft'], ['KeyD', 'ArrowRight'])`. */
+    axis(negative: string[], positive: string[]): number;
+    /** Forgets this step's edges; held keys stay held. */
+    endStep(): void;
+    destroy(): void;
+}
+//# sourceMappingURL=Keyboard.d.ts.map

package/dist/types/input/Keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Keyboard.d.ts","sourceRoot":"","sources":["../../../src/input/Keyboard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;gBAElC,MAAM,GAAE,MAAM,GAAG,WAAoB;IA2BjD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI7B,iCAAiC;IACjC,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO;IAIpC,0CAA0C;IAC1C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B,+FAA+F;IAC/F,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAIpD,sDAAsD;IACtD,OAAO,IAAI,IAAI;IAKf,OAAO,IAAI,IAAI;CAKhB"}

package/dist/types/input/aimAxis.d.ts

@@ -0,0 +1,9 @@
+/**
+ * An aim turned into the eight-way axis the keyboard makes (each part -1, 0 or 1; `stepMover` scales a diagonal),
+ * so a step sent along it is one a key could have sent. A part counts once the aim leans past 22.5° towards it.
+ */
+export declare function aimAxis(aim: number): {
+    dx: number;
+    dy: number;
+};
+//# sourceMappingURL=aimAxis.d.ts.map

package/dist/types/input/aimAxis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aimAxis.d.ts","sourceRoot":"","sources":["../../../src/input/aimAxis.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAK/D"}

package/dist/types/input/longPress.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A long press, as pure timing so it can be tested: a finger that stays down `ms` without moving more than `slop`
+ * CSS px fires once, where it went down. A second finger, a move past the slop or a lift before the time is up is
+ * not a long press — a tap stays a tap. The caller owns the clock (`fire(now)` from a timer or a frame).
+ */
+export declare class LongPress {
+    readonly ms: number;
+    readonly slop: number;
+    private finger;
+    private done;
+    constructor(ms?: number, slop?: number);
+    down(id: number, x: number, y: number, now: number): void;
+    move(id: number, x: number, y: number): void;
+    up(id: number): void;
+    /** Where the press is, the first time this is asked at or after `ms`; null otherwise. */
+    fire(now: number): {
+        x: number;
+        y: number;
+    } | null;
+}
+//# sourceMappingURL=longPress.d.ts.map

package/dist/types/input/longPress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"longPress.d.ts","sourceRoot":"","sources":["../../../src/input/longPress.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,SAAS;IAKlB,QAAQ,CAAC,EAAE;IACX,QAAQ,CAAC,IAAI;IALf,OAAO,CAAC,MAAM,CAAiE;IAC/E,OAAO,CAAC,IAAI,CAAS;gBAGV,EAAE,SAAM,EACR,IAAI,SAAK;IAGpB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAWzD,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAK5C,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKpB,yFAAyF;IACzF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAMnD"}

package/dist/types/input/stickAxis.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The virtual joystick's arithmetic, kept pure so it can be tested. The stick hands the game the **same** axis
+ * the keyboard does — `stepMover` clamps every step to -1/0/1 on each axis (movement is eight-way, and the server
+ * reads it the same way), so an analog stick would only be rounded there anyway. The rounding happens here instead,
+ * by eight 45° sectors, so a thumb held a little off the horizontal walks straight rather than flickering between
+ * east and north-east.
+ */
+/** Below this share of the stick's radius the thumb is resting: no movement, and the aim falls back (touchAim.ts). */
+export declare const STICK_DEAD_ZONE = 0.28;
+export interface StickVector {
+    x: number;
+    y: number;
+}
+/** The thumb's offset from where the stick was planted, as a vector of length at most 1 (radius = full tilt). */
+export declare function stickVector(dx: number, dy: number, radius: number): StickVector;
+/** True when the stick is tilted past the dead zone. */
+export declare function stickActive(v: StickVector, deadZone?: number): boolean;
+/**
+ * The keyboard-shaped axis for a stick vector: each of dx, dy is -1, 0 or 1 (screen y grows downward, as the
+ * keyboard's "down" does), nothing inside the dead zone, and the nearest of the eight directions otherwise.
+ */
+export declare function stickToAxis(v: StickVector, deadZone?: number): {
+    dx: number;
+    dy: number;
+};
+//# sourceMappingURL=stickAxis.d.ts.map

package/dist/types/input/stickAxis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stickAxis.d.ts","sourceRoot":"","sources":["../../../src/input/stickAxis.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sHAAsH;AACtH,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,iHAAiH;AACjH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAM/E;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,SAAkB,GAAG,OAAO,CAE/E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,SAAkB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAMlG"}

package/dist/types/input/touchDetect.d.ts

@@ -0,0 +1,18 @@
+/** What decides whether the touch controls are shown; read off the browser by `touchDevice.ts`. */
+export interface TouchEnv {
+    /** Running inside the native shell (Capacitor iOS). */
+    native: boolean;
+    /** `(pointer: coarse)` matches: the **primary** pointer is a finger. */
+    coarse: boolean;
+    /** `navigator.maxTouchPoints`. */
+    touchPoints: number;
+    /** `?touch=1|0` in the URL or `localStorage['engine.touch']`, for trying the controls on a desktop browser. */
+    override: string | null;
+}
+/**
+ * Touch controls only where a finger is the main way in: the native app always, a browser whose primary pointer
+ * is coarse and that reports touch points (a phone or tablet), never a desktop — a laptop with a touch screen
+ * still has a fine primary pointer and keeps its mouse and keyboard.
+ */
+export declare function detectTouch(env: TouchEnv): boolean;
+//# sourceMappingURL=touchDetect.d.ts.map

package/dist/types/input/touchDetect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"touchDetect.d.ts","sourceRoot":"","sources":["../../../src/input/touchDetect.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,MAAM,WAAW,QAAQ;IACvB,uDAAuD;IACvD,MAAM,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,MAAM,EAAE,OAAO,CAAC;IAChB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,+GAA+G;IAC/G,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAKlD"}

package/dist/types/light/LightLayer.d.ts

@@ -0,0 +1,65 @@
+import type { Stage } from '../core/Stage.js';
+/** A light in the world. Change its fields any time (follow a body by writing `x`/`y` each frame). */
+export interface Light {
+    x: number;
+    y: number;
+    /** World px. */
+    radius: number;
+    /** The colour it casts on what it lights (default warm white). */
+    color?: number;
+    /** 0–1: how much of the dark it takes away, and how strong its colour (default 1). */
+    intensity?: number;
+    /** Radius wobble, 0–1 (a torch ≈ 0.08). */
+    flicker?: number;
+    /** A light off is kept but not drawn. */
+    on?: boolean;
+}
+export interface LightLayerOptions {
+    /** Colour of the dark (default deep blue). */
+    ambient?: number;
+    /** 0 no dark at all, 1 black where nothing is lit (default 0.85). */
+    darkness?: number;
+    /** How strongly lights tint what they light, 0–1 (default 0.35). */
+    tint?: number;
+    /** A light's height over its width: the ground is seen at a slant (default 1, round; a 3/4 view ≈ 0.85). */
+    squash?: number;
+}
+/**
+ * Smooth darkness with lights cut out of it, for art that is not pixel art (the pixel module has its own dithered
+ * `Darkness`). The dark is a screen-sized texture: each light erases a soft hole in it, and lays its colour over what
+ * shows through. It sits on the screen layer, over the world and under the HUD you add after it.
+ *
+ * ```ts
+ * const night = new LightLayer(stage, { darkness: 0.9 });
+ * const torch = night.add({ x: 100, y: 80, radius: 90, color: 0xffb060, flicker: 0.08 });
+ * // each frame: torch.x = hero.x; night.update(now);
+ * ```
+ */
+export declare class LightLayer {
+    private readonly stage;
+    private readonly lights;
+    private readonly scratch;
+    private readonly sheet;
+    private readonly holes;
+    private readonly washes;
+    private readonly view;
+    private rt;
+    private readonly pool;
+    private ambient;
+    private darkness;
+    private readonly tint;
+    private readonly squash;
+    private readonly unsubscribe;
+    constructor(stage: Stage, options?: LightLayerOptions);
+    add(light: Light): Light;
+    remove(light: Light): void;
+    clear(): void;
+    /** Changes the dark: its colour and how dark (a day/night cycle eases these). */
+    setAmbient(color: number, darkness: number): void;
+    /** Redraws the dark with this frame's lights. Call once a frame, after the camera moved. */
+    update(now?: number): void;
+    destroy(): void;
+    private sprites;
+    private fit;
+}
+//# sourceMappingURL=LightLayer.d.ts.map

package/dist/types/light/LightLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LightLayer.d.ts","sourceRoot":"","sources":["../../../src/light/LightLayer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,sGAAsG;AACtG,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,EAAE,CAAC,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4GAA4G;IAC5G,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAyBD;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IAgBnB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAfxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwC;IAC7D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;gBAGtB,KAAK,EAAE,KAAK,EAC7B,OAAO,GAAE,iBAAsB;IAgBjC,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK;IAKxB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI1B,KAAK,IAAI,IAAI;IAIb,iFAAiF;IACjF,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKjD,4FAA4F;IAC5F,MAAM,CAAC,GAAG,SAAoB,GAAG,IAAI;IAqCrC,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,OAAO;IAgBf,OAAO,CAAC,GAAG;CAOZ"}

package/dist/types/net/Connection.d.ts

@@ -0,0 +1,66 @@
+import { EventBus } from '../events/EventBus.js';
+import type { InputStep } from './constants.js';
+import type { ClientMessage, ServerMessage, Snapshot } from './protocol.js';
+export interface ConnectionEvents {
+    open: undefined;
+    /** The socket closed; `willRetry` when it will reconnect by itself. */
+    close: {
+        code: number;
+        reason: string;
+        willRetry: boolean;
+    };
+    welcome: Extract<ServerMessage, {
+        t: 'welcome';
+    }>;
+    snapshot: Snapshot;
+    /** Any message the engine does not handle: the game's own. */
+    message: {
+        t: string;
+        [k: string]: unknown;
+    };
+}
+export interface ConnectionOptions {
+    /** Reconnect after the socket drops (default true), waiting longer each time up to `maxBackoffMs`. */
+    reconnect?: boolean;
+    maxBackoffMs?: number;
+    /** Ping interval for the server clock and the round-trip time (default 1000 ms). */
+    pingMs?: number;
+    /** Sent on every (re)connect as `hello.data`. */
+    hello?: () => unknown;
+    /** The WebSocket class (default the global one; Node 22+ and browsers have it). */
+    WebSocket?: typeof WebSocket;
+}
+/**
+ * The client side of the engine's netcode over a WebSocket: hello on open, input steps batched and sent once a frame
+ * (`queueInput` then `flush`), snapshots decoded (binary or JSON) onto `events`, pings that keep the server clock
+ * (`serverNow`) and `rtt` up to date, and reconnection with backoff.
+ */
+export declare class Connection {
+    readonly url: string;
+    private readonly options;
+    readonly events: EventBus<ConnectionEvents>;
+    /** The last measured round trip, ms. */
+    rtt: number;
+    private socket;
+    private batch;
+    private closedByUs;
+    private attempt;
+    private pingTimer;
+    private retryTimer;
+    constructor(url: string, options?: ConnectionOptions);
+    get open(): boolean;
+    connect(): this;
+    /** Sends a message now (dropped while closed: input is resent by the prediction's own state, not by the socket). */
+    send(msg: ClientMessage | {
+        t: string;
+        [k: string]: unknown;
+    }): void;
+    /** Adds one input step to this frame's batch; `flush` sends it. Steps must come in sequence order. */
+    queueInput(seq: number, step: InputStep): void;
+    /** Sends this frame's input steps as one message. Call once a frame. */
+    flush(): void;
+    close(): void;
+    private ping;
+    private receive;
+}
+//# sourceMappingURL=Connection.d.ts.map

package/dist/types/net/Connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Connection.d.ts","sourceRoot":"","sources":["../../../src/net/Connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,uEAAuE;IACvE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5D,OAAO,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAClD,QAAQ,EAAE,QAAQ,CAAC;IACnB,8DAA8D;IAC9D,OAAO,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,WAAW,iBAAiB;IAChC,sGAAsG;IACtG,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC;IACtB,mFAAmF;IACnF,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;CAC9B;AAED;;;;GAIG;AACH,qBAAa,UAAU;IAYnB,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZ1B,QAAQ,CAAC,MAAM,6BAAoC;IACnD,wCAAwC;IACxC,GAAG,SAAK;IACR,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,KAAK,CAAoD;IACjE,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,UAAU,CAA8C;gBAGrD,GAAG,EAAE,MAAM,EACH,OAAO,GAAE,iBAAsB;IAGlD,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,OAAO,IAAI,IAAI;IA6Bf,oHAAoH;IACpH,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI;IAIpE,sGAAsG;IACtG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAK9C,wEAAwE;IACxE,KAAK,IAAI,IAAI;IAMb,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,OAAO;CAyBhB"}

package/dist/types/net/InterpolationBuffer.d.ts

@@ -0,0 +1,36 @@
+import type { EntityUpdate } from './constants.js';
+export interface InterpolatedState {
+    x: number;
+    y: number;
+    aim: number;
+    /** Discrete fields come from the older of the two samples until the newer one is reached. */
+    anim: number;
+    hp: number;
+    flags: number;
+}
+/**
+ * Smooth motion for bodies the server moves (other players, monsters): snapshots arrive 10–30 times a second and
+ * jittered, so each body is drawn a little in the past (`delayMs`) between the two snapshots around that moment.
+ * Past the newest snapshot it extrapolates for at most `maxExtrapolateMs`, then holds.
+ *
+ * Times are server times (`Snapshot.time`); render at `serverNow()`.
+ */
+export declare class InterpolationBuffer {
+    /** How far in the past bodies are drawn (default 100 ms: two snapshots at 20 Hz, so one may be late). */
+    readonly delayMs: number;
+    private readonly maxExtrapolateMs;
+    private readonly keep;
+    private readonly samples;
+    constructor(
+    /** How far in the past bodies are drawn (default 100 ms: two snapshots at 20 Hz, so one may be late). */
+    delayMs?: number, maxExtrapolateMs?: number, keep?: number);
+    /** Records every body of a snapshot taken at `time`. */
+    push(time: number, updates: readonly EntityUpdate[]): void;
+    /** Forgets a body (it left view). */
+    remove(id: number): void;
+    has(id: number): boolean;
+    ids(): IterableIterator<number>;
+    /** Where body `id` should be drawn at server time `now`, or null if nothing is known of it. */
+    sample(id: number, now: number): InterpolatedState | null;
+}
+//# sourceMappingURL=InterpolationBuffer.d.ts.map

package/dist/types/net/InterpolationBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InterpolationBuffer.d.ts","sourceRoot":"","sources":["../../../src/net/InterpolationBuffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAahD,MAAM,WAAW,iBAAiB;IAChC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAI5B,yGAAyG;IACzG,QAAQ,CAAC,OAAO;IAChB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI;IANvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;;IAGrD,yGAAyG;IAChG,OAAO,SAAM,EACL,gBAAgB,SAAM,EACtB,IAAI,SAAK;IAG5B,wDAAwD;IACxD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI;IAe1D,qCAAqC;IACrC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC;IAI/B,+FAA+F;IAC/F,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;CAqB1D"}