1681-engine 0.5.10 → 0.6.1

package/dist/types/mobile/backButton.d.ts

@@ -0,0 +1,30 @@
+/** A back handler: true when it used the press (closed a dialog, went up a menu), false to let the next one try. */
+export type BackHandler = () => boolean;
+/**
+ * Who answers Android's back button (and the back gesture): the most recently pushed handler first, then the ones
+ * under it, then `onRoot` when none took it. A dialog pushes "close me" when it opens and pops it when it closes; a
+ * pause menu pushes "resume"; the title screen leaves the press to `onRoot`, which by default asks for a second press
+ * to quit, so a stray swipe never ends a run.
+ */
+export declare class BackStack {
+    private readonly onRoot;
+    private readonly handlers;
+    constructor(onRoot?: () => void);
+    /** Puts `handler` on top; the returned function takes it off (from anywhere in the stack). */
+    push(handler: BackHandler): () => void;
+    get size(): number;
+    /** A back press: offered from the top down; `onRoot` when none uses it. True when a handler used it. */
+    press(): boolean;
+}
+export interface DoubleBackOptions {
+    /** A second press within this (ms) quits (default 2000). */
+    withinMs?: number;
+    /** The first press: tell the player ("press back again to quit"). */
+    notify: () => void;
+    /** The second: leave (Capacitor's `App.exitApp`, or `minimizeApp` to keep the game alive in the background). */
+    exit: () => void;
+    now?: () => number;
+}
+/** An `onRoot` that quits on a second back press soon after the first, and tells the player after the first. */
+export declare function doubleBackToExit(options: DoubleBackOptions): () => void;
+//# sourceMappingURL=backButton.d.ts.map

package/dist/types/mobile/backButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backButton.d.ts","sourceRoot":"","sources":["../../../src/mobile/backButton.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC;AAExC;;;;;GAKG;AACH,qBAAa,SAAS;IAGR,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;gBAEjB,MAAM,GAAE,MAAM,IAAsB;IAEjE,8FAA8F;IAC9F,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,IAAI;IAQtC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,wGAAwG;IACxG,KAAK,IAAI,OAAO;CAOjB;AAED,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,gHAAgH;IAChH,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,gHAAgH;AAChH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,IAAI,CAcvE"}

package/dist/types/mobile/capacitor.d.ts

@@ -0,0 +1,62 @@
+import type { BackStack } from './backButton.js';
+/** What a plugin's `addListener` resolves to. */
+export interface ListenerHandle {
+    remove(): Promise<void> | void;
+}
+/** The slice of `@capacitor/app`'s `App` the engine uses. */
+export interface AppLike {
+    addListener(event: 'backButton', cb: (e: {
+        canGoBack: boolean;
+    }) => void): Promise<ListenerHandle> | ListenerHandle;
+    exitApp(): Promise<void> | void;
+    minimizeApp?(): Promise<void> | void;
+    getInfo?(): Promise<{
+        version: string;
+        build: string;
+    }>;
+}
+/**
+ * Sends Android's back button to a `BackStack`. Capacitor's own default (the web view going back in its history,
+ * then closing the app) is replaced as soon as a listener is added, so the stack decides everything. Resolves to
+ * the uninstall.
+ */
+export declare function installBackButton(app: AppLike, stack: BackStack): Promise<() => void>;
+/**
+ * The app's native build as a number, for `pickWebUpdate`'s `nativeBuild`: Android's versionCode, iOS's
+ * CFBundleVersion (its first number, for "508.1"). `Infinity` where there is no native layer (a browser), so every
+ * web update fits; 0 when the build cannot be read, so none that needs native code does.
+ */
+export declare function nativeBuildOf(app: Pick<AppLike, 'getInfo'> | null | undefined): Promise<number>;
+/** Options for `capacitorConfig`: what differs between games. */
+export interface MobileConfigOptions {
+    /** Reverse-domain id, as the stores know it ("com.example.mygame"). */
+    appId: string;
+    appName: string;
+    /** The built web, relative to the project (default 'dist'). */
+    webDir?: string;
+    /** Behind the web view while it loads, and under the safe-area bands (default black). */
+    backgroundColor?: string;
+    /** Let Chrome's and Safari's inspectors attach (default false: on for a debug build only). */
+    debug?: boolean;
+    /** Anything else, laid over the defaults (`plugins`, `server`, …). */
+    extra?: Record<string, unknown>;
+}
+/**
+ * A `capacitor.config.ts` for a game, with the defaults a game wants rather than a web page's:
+ *
+ * - the page is served from `https://localhost` (Android) so cookies, `crypto.subtle` and service workers behave as on
+ *   the web, and nothing is fetched over plain http;
+ * - the web view does not scroll, bounce or zoom on iOS, and draws edge to edge (`contentInset: 'never'`, mind the
+ *   safe area: `safeAreaInsets`);
+ * - the splash screen stays until the game hides it (`SplashScreen.hide()` once the first scene draws), so the player
+ *   never sees a blank web view;
+ * - `@capgo/capacitor-updater` does not update on its own: the engine's `pickWebUpdate` decides.
+ *
+ * ```ts
+ * // capacitor.config.ts
+ * import { capacitorConfig } from '1681-engine/mobile';
+ * export default capacitorConfig({ appId: 'com.example.mygame', appName: 'My Game', debug: process.env.DEBUG === '1' });
+ * ```
+ */
+export declare function capacitorConfig(options: MobileConfigOptions): Record<string, unknown>;
+//# sourceMappingURL=capacitor.d.ts.map

package/dist/types/mobile/capacitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacitor.d.ts","sourceRoot":"","sources":["../../../src/mobile/capacitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAQ9C,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChC;AAED,6DAA6D;AAC7D,MAAM,WAAW,OAAO;IACtB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC;IACpH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACrC,OAAO,CAAC,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAK3F;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CASrG;AAED,iEAAiE;AACjE,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8FAA8F;IAC9F,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBrF"}

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

@@ -0,0 +1,4 @@
+export { BackStack, doubleBackToExit, type BackHandler, type DoubleBackOptions } from './backButton.js';
+export { installBackButton, nativeBuildOf, capacitorConfig, type AppLike, type ListenerHandle, type MobileConfigOptions } from './capacitor.js';
+export { safeAreaInsets, keepScreenOn, type Insets, type WakeLockLike } from './screen.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobile/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACrG,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC7I,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/types/mobile/screen.d.ts

@@ -0,0 +1,27 @@
+/** Px kept clear at each edge: the notch, the rounded corners, the home bar. */
+export interface Insets {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/**
+ * The safe-area insets as the browser has them now (CSS `env(safe-area-inset-*)`), read through a hidden probe
+ * element: what a canvas HUD must keep its buttons out of when the web view is drawn edge to edge. Zeros where
+ * there is no document or no notch.
+ */
+export declare function safeAreaInsets(doc?: Document | undefined): Insets;
+/** The slice of the Screen Wake Lock API used, so a test can hand in its own. */
+export interface WakeLockLike {
+    request(type: 'screen'): Promise<{
+        release(): Promise<void>;
+        addEventListener?(type: 'release', cb: () => void): void;
+    }>;
+}
+/**
+ * Keeps the screen on while the game runs (a phone dims and locks during a cut scene or a long think otherwise),
+ * through the Screen Wake Lock API. The browser drops the lock whenever the page is hidden, so it is asked for again
+ * each time the page comes back. Resolves to the release; does nothing where the API is missing or refuses.
+ */
+export declare function keepScreenOn(wakeLock?: WakeLockLike | undefined, doc?: Pick<Document, 'visibilityState' | 'addEventListener' | 'removeEventListener'> | undefined): Promise<() => void>;
+//# sourceMappingURL=screen.d.ts.map

package/dist/types/mobile/screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../../../src/mobile/screen.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,QAAQ,GAAG,SAA+B,GAAG,MAAM,CAatF;AAED,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;QAAE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,gBAAgB,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAC1H;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,QAAQ,GAAE,YAAY,GAAG,SAAmG,EAC5H,GAAG,GAAE,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,kBAAkB,GAAG,qBAAqB,CAAC,GAAG,SAA+B,GACpH,OAAO,CAAC,MAAM,IAAI,CAAC,CA2BrB"}

package/dist/types/nav/flowField.d.ts

@@ -0,0 +1,31 @@
+import { type NavGrid, type NavOptions, type TilePoint } from './navGrid.js';
+/**
+ * Which way to step from every tile to reach the nearest goal: one search for a whole crowd. A hundred monsters
+ * chasing one player cost one flow field a re-plan, where a hundred `findPath`s would cost a hundred searches.
+ */
+export interface FlowField {
+    readonly width: number;
+    readonly height: number;
+    /** Walking cost from each tile (row-major) to its nearest goal, `Infinity` where none can be reached. */
+    readonly costs: Float32Array;
+    /** The step to take from each tile, an index into `NAV_STEPS`; -1 on a goal and where nothing is reached. */
+    readonly steps: Int8Array;
+    /** The step from tile (tx, ty) as [dx, dy], or null on a goal, a wall, outside the grid or out of reach. */
+    stepAt(tx: number, ty: number): readonly [number, number] | null;
+    /** The cost from (tx, ty) to its nearest goal (`Infinity` out of reach or outside the grid). */
+    costAt(tx: number, ty: number): number;
+}
+/**
+ * A flow field towards `goals` (any number: every door out of a burning house), by the same steps, corner rules,
+ * costs and end-only tiles `findPath` takes, so a body following it walks the route `findPath` would have found.
+ * `maxCost` stops the spread (bodies further off stand still or wander).
+ */
+export declare function flowField(g: NavGrid, goals: readonly TilePoint[], options?: NavOptions & {
+    maxCost?: number;
+}): FlowField;
+/**
+ * The tiles a body at `from` walks by following the field, to the goal (both ends included), or null when `from` is
+ * out of reach. For drawing the route, and for tests; a body steps one tile at a time with `stepAt`.
+ */
+export declare function followField(field: FlowField, from: TilePoint, maxSteps?: number): TilePoint[] | null;
+//# sourceMappingURL=flowField.d.ts.map

package/dist/types/nav/flowField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowField.d.ts","sourceRoot":"","sources":["../../../src/nav/flowField.ts"],"names":[],"mappings":"AACA,OAAO,EAA8B,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtG;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yGAAyG;IACzG,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,6GAA6G;IAC7G,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,4GAA4G;IAC5G,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACjE,gGAAgG;IAChG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CACxC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,OAAO,GAAE,UAAU,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,SAAS,CA0D7H;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,SAA6B,GAAG,SAAS,EAAE,GAAG,IAAI,CAaxH"}

package/dist/types/nav/steering.d.ts

@@ -0,0 +1,47 @@
+export interface SteerVec {
+    x: number;
+    y: number;
+}
+/** A body as steering sees it. */
+export interface SteerAgent {
+    x: number;
+    y: number;
+    vx: number;
+    vy: number;
+}
+/** Full speed straight at a point. */
+export declare function seek(agent: SteerAgent, tx: number, ty: number, maxSpeed: number): SteerVec;
+/** Full speed straight away from a point, within `panic` px of it (default always). */
+export declare function flee(agent: SteerAgent, tx: number, ty: number, maxSpeed: number, panic?: number): SteerVec;
+/** Like `seek`, but slowing inside `slowRadius` px so it stops on the point instead of overshooting. */
+export declare function arrive(agent: SteerAgent, tx: number, ty: number, maxSpeed: number, slowRadius: number): SteerVec;
+/**
+ * Away from neighbours closer than `radius` px, harder the closer they are: bodies of a crowd stop stacking on one
+ * tile. A neighbour exactly on top is pushed off along a direction picked from the pair's places, so two bodies
+ * spawned on one spot still part.
+ */
+export declare function separation(agent: SteerAgent, neighbours: Iterable<SteerAgent>, radius: number, strength: number): SteerVec;
+/** Towards the average heading of neighbours within `radius` (a flock turning together). */
+export declare function alignment(agent: SteerAgent, neighbours: Iterable<SteerAgent>, radius: number): SteerVec;
+/** Towards the middle of neighbours within `radius` (a flock keeping together). */
+export declare function cohesion(agent: SteerAgent, neighbours: Iterable<SteerAgent>, radius: number, maxSpeed: number): SteerVec;
+/** What `followFlow` reads: a flow field (`flowField.ts`). */
+export interface StepSource {
+    stepAt(tx: number, ty: number): readonly [number, number] | null;
+    costAt(tx: number, ty: number): number;
+}
+/**
+ * Full speed along a flow field from the tile the body stands on. On a goal it brakes to a stop, so a crowd gathers
+ * there rather than coasting past. Pushed off the field (into a wall, off the grid, by a crowd's shoving), it heads
+ * for the cheapest tile around it that is on the field, so it is never stranded; with none within two tiles, it
+ * brakes.
+ */
+export declare function followFlow(agent: SteerAgent, field: StepSource, tileSize: number, maxSpeed: number): SteerVec;
+/** Weighs steering forces, sums them and caps the sum at `maxForce` (px/s of change a step). */
+export declare function combineSteering(maxForce: number, ...weighted: [SteerVec, number][]): SteerVec;
+/**
+ * One step of steering applied to a body: velocity changed by `force × dt`, capped at `maxSpeed`, position moved.
+ * For bodies with no physics of their own (birds, a crowd of extras); a physics body takes the force instead.
+ */
+export declare function applySteering(agent: SteerAgent, force: SteerVec, maxSpeed: number, dt: number): void;
+//# sourceMappingURL=steering.d.ts.map

package/dist/types/nav/steering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steering.d.ts","sourceRoot":"","sources":["../../../src/nav/steering.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAUD,sCAAsC;AACtC,wBAAgB,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAE1F;AAED,uFAAuF;AACvF,wBAAgB,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAW,GAAG,QAAQ,CAK5G;AAED,wGAAwG;AACxG,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ,CAMhH;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CA0B1H;AAED,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAWvG;AAED,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAWxH;AAED,8DAA8D;AAC9D,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACjE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CACxC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAuB7G;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,GAAG,QAAQ,CAa7F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAUpG"}

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

@@ -26,6 +26,11 @@ export declare class InterpolationBuffer {
     delayMs?: number, maxExtrapolateMs?: number, keep?: number);
     /** Records every body of a snapshot taken at `time`. */
     push(time: number, updates: readonly EntityUpdate[]): void;
+    /**
+     * The server time bodies are drawn at when it is `now` (`serverNow()`): what a shot should carry, so a server with
+     * lag compensation judges it against the picture the player aimed at.
+     */
+    viewTime(now: number): number;
     /** Forgets a body (it left view). */
     remove(id: number): void;
     has(id: number): boolean;

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

@@ -1 +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"}
+{"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;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI7B,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"}

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

@@ -0,0 +1,70 @@
+/** A body's position at one recorded moment. */
+export interface RewoundBody {
+    id: number;
+    x: number;
+    y: number;
+}
+/** A body a ray passed through: `along` is how far from the ray's start it was met (px). */
+export interface RewoundHit extends RewoundBody {
+    along: number;
+}
+/**
+ * Lag compensation for a server: where every body was a moment ago, so a shot is judged against what the shooter saw.
+ * A client draws other bodies `delayMs` in the past between two snapshots (`InterpolationBuffer`); the server records
+ * the same positions at the same times, when each snapshot goes out, and blends between them the same way, so a
+ * rewind lands on the very picture the shooter aimed at, not on where the target has walked to since.
+ *
+ * How far back a client may ask is capped (`clampTime`): a client that claims an old time to shoot round a corner
+ * gets no further back than `maxRewindMs`.
+ *
+ * ```ts
+ * // when snapshots go out (RoomHost does this for a Room made with `rewindMs`)
+ * lag.record(now, players);
+ * // a client's shot, sent with `at: buffer.viewTime(serverNow())`
+ * const at = LagCompensator.clampTime(msg.at, now, 250);
+ * const hit = lag.alongRay(at, x, y, dx, dy, range, 6, shooterId)[0];
+ * ```
+ */
+export declare class LagCompensator {
+    readonly keepMs: number;
+    private readonly frames;
+    /** `keepMs`: how much history is kept; at least the longest rewind allowed plus a snapshot interval. */
+    constructor(keepMs?: number);
+    /** The latest recorded time, or -Infinity before any. */
+    get newest(): number;
+    get oldest(): number;
+    /** Records every body's position at `time`. A time not after the last one recorded replaces that frame. */
+    record(time: number, bodies: Iterable<{
+        readonly id: number;
+        readonly x: number;
+        readonly y: number;
+    }>): void;
+    /** Forgets a body everywhere in the history (it left the game, not just the view). */
+    forget(id: number): void;
+    clear(): void;
+    /**
+     * A time a client claims it saw, kept within `[now - maxRewindMs, now]`: the window a rewind is honoured in. A
+     * claim that is not a finite number is taken as `now` (no rewind).
+     */
+    static clampTime(claimed: unknown, now: number, maxRewindMs: number): number;
+    /**
+     * Where body `id` was at `time`, blended between the frames around it as `InterpolationBuffer` blends; null when
+     * the history has no frame of it. Before the oldest frame it is where it was then; after the newest, where it is.
+     */
+    at(id: number, time: number): {
+        x: number;
+        y: number;
+    } | null;
+    /** Every body in the history at `time`. */
+    all(time: number): RewoundBody[];
+    /** The bodies whose centre was within `radius` of (x, y) at `time`, nearest first; `except` (the shooter) left out. */
+    near(time: number, x: number, y: number, radius: number, except?: number): RewoundBody[];
+    /**
+     * A hitscan at `time`: the bodies a ray from (x, y) along (dx, dy) passed within `radius` of, before `range` px, in
+     * the order it met them. `except` (the shooter) is left out. Walls are the game's to check against the first hit.
+     */
+    alongRay(time: number, x: number, y: number, dx: number, dy: number, range: number, radius: number, except?: number): RewoundHit[];
+    /** The two frames around `time` and how far between them it is (0 at the first, 1 at the second). */
+    private around;
+}
+//# sourceMappingURL=LagCompensator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LagCompensator.d.ts","sourceRoot":"","sources":["../../../src/net/LagCompensator.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,4FAA4F;AAC5F,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,KAAK,EAAE,MAAM,CAAC;CACf;AAOD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAc;IAIb,QAAQ,CAAC,MAAM;IAH3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IAEtC,wGAAwG;gBACnF,MAAM,SAAO;IAElC,yDAAyD;IACzD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,2GAA2G;IAC3G,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAY7G,sFAAsF;IACtF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAK5E;;;OAGG;IACH,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAM7D,2CAA2C;IAC3C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE;IAahC,uHAAuH;IACvH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IAKxF;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAqBlI,qGAAqG;IACrG,OAAO,CAAC,MAAM;CAaf"}

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

@@ -1,7 +1,9 @@
 import type { InputStep, MovementParams } from './constants.js';
+import { LagCompensator } from './LagCompensator.js';
 import { type CollisionGrid, type MoverState } from './movement.js';
 import { type Snapshot } from './protocol.js';
 export interface RoomPlayer<D = unknown> {
+    readonly kind: 'player';
     readonly id: number;
     readonly mover: MoverState;
     /** The game's own data for this player (sent to others in `sp` when they first see it). */
@@ -19,7 +21,39 @@ export interface RoomPlayer<D = unknown> {
     /** Refused inputs (nonsense numbers, a flood): a game may kick past some count. */
     strikes: number;
 }
-export interface RoomOptions<D> {
+/**
+ * A body the server moves itself (a monster, a projectile, a crate): no input, no prediction, sent to players beside
+ * them in the same snapshots. The game writes `x`, `y` and the rest as its own simulation runs.
+ */
+export interface RoomBody<B = unknown> {
+    readonly kind: 'body';
+    readonly id: number;
+    x: number;
+    y: number;
+    aim: number;
+    anim: number;
+    hp: number;
+    flags: number;
+    /** The game's own description of it, sent in `sp` when a player first sees it. */
+    data: B;
+}
+/** Anything a snapshot carries: a player or a body the server moves. */
+export type RoomSeen<D = unknown, B = unknown> = RoomPlayer<D> | RoomBody<B>;
+/** Server bodies get ids from here up unless given one, far above the ids `RoomHost` hands players. */
+export declare const BODY_ID_BASE: number;
+/** Who a player is sent: the bodies near it, not the whole room. */
+export interface RoomInterest<D, B = unknown> {
+    /** A body comes into view within this many px of the player (centre to centre). */
+    radius: number;
+    /**
+     * And leaves only past `radius + leaveMargin` (default a quarter of `radius`), so a body walking along the edge is
+     * not spawned and removed on every snapshot.
+     */
+    leaveMargin?: number;
+    /** A further test, for what distance alone does not decide (a team's own always, a hidden enemy never). */
+    canSee?: (viewer: RoomPlayer<D>, other: RoomSeen<D, B>) => boolean;
+}
+export interface RoomOptions<D, B = unknown> {
     grid: CollisionGrid;
     /** Movement rules a new player starts with. */
     params: MovementParams;
@@ -35,6 +69,13 @@ export interface RoomOptions<D> {
     backlog?: number;
     /** Called after each step a player takes (set aim, anim, flags from it). */
     onStep?: (player: RoomPlayer<D>, step: InputStep) => void;
+    /** Send each player only the bodies near it (default: everyone to everyone). */
+    interest?: RoomInterest<D, B>;
+    /**
+     * Keep this many ms of positions for lag compensation (`history`), recorded as each round of snapshots goes out
+     * (`record`). Off by default.
+     */
+    rewindMs?: number;
 }
 /**
  * An authoritative room for a server: players send input steps, the room applies them with the same `stepMover` the
@@ -44,17 +85,38 @@ export interface RoomOptions<D> {
  * Every step a player sends is applied once, in order; a client cannot move faster by sending more (the queue is
  * capped and drained at most `maxStepsPerTick` a tick), and nonsense input is refused and counted.
  */
-export declare class Room<D = unknown> {
+export declare class Room<D = unknown, B = unknown> {
     private readonly options;
     readonly players: Map<number, RoomPlayer<D>>;
+    /** The bodies the server moves (`addBody`). */
+    readonly bodies: Map<number, RoomBody<B>>;
     tick: number;
+    /** Past positions for judging shots against what a client saw, when the room was made with `rewindMs`. */
+    readonly history: LagCompensator | null;
+    /** How far back a client's claimed view time is honoured (`rewindMs`, 0 when off). */
+    readonly rewindMs: number;
     private readonly known;
+    private readonly hash;
+    private readonly nearby;
     private readonly maxQueue;
     private readonly maxSteps;
     private readonly backlog;
-    constructor(options: RoomOptions<D>);
+    private nextBodyId;
+    constructor(options: RoomOptions<D, B>);
     join(id: number, data: D): RoomPlayer<D>;
     leave(id: number): void;
+    /**
+     * Records where every body is now, at server time `time`, into `history`; `RoomHost` calls it as each round of
+     * snapshots goes out, so the history holds exactly the positions clients interpolate between.
+     */
+    record(time: number): void;
+    /**
+     * Adds a body the server moves, at (x, y), with the game's `data` (what players are told it looks like). Its id
+     * is `id`, or the next from `BODY_ID_BASE` up; an id a player or body has is refused.
+     */
+    addBody(data: B, x: number, y: number, id?: number): RoomBody<B>;
+    /** Takes a body out: players who saw it get it in `rm` with their next snapshot. */
+    removeBody(id: number): void;
     /**
      * Input steps `seq`, `seq + 1`, … from a player. Steps already received are skipped (a resend), any step with
      * numbers no client sends refuses the whole message, and steps past a full queue are dropped. Returns false when
@@ -63,7 +125,14 @@ export declare class Room<D = unknown> {
     input(id: number, seq: number, steps: readonly InputStep[]): boolean;
     /** One simulation step for everyone. */
     step(): void;
+    /**
+     * Moves a player by hand (a teleport, a respawn), and files it in the interest grid at once. Writing `mover.x/y`
+     * directly also works; the room then finds it at its new place from the next step.
+     */
+    place(id: number, x: number, y: number): void;
     /** The snapshot player `id` should get now. `time` is the server's wall clock (ms). */
     snapshotFor(id: number, time: number): Snapshot | null;
+    /** What `me` is sent: itself always; with interest, the rest in range (a known one until past the margin). */
+    private visibleTo;
 }
 //# sourceMappingURL=Room.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Room.d.ts","sourceRoot":"","sources":["../../../src/net/Room.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAA0B,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,2FAA2F;IAC3F,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,cAAc,CAAC;IACvB,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;IAC5B,yFAAyF;IACzF,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,+CAA+C;IAC/C,MAAM,EAAE,cAAc,CAAC;IACvB,uCAAuC;IACvC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,iGAAiG;IACjG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qHAAqH;IACrH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CAC3D;AAED;;;;;;;GAOG;AACH,qBAAa,IAAI,CAAC,CAAC,GAAG,OAAO;IAQf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,QAAQ,CAAC,OAAO,6BAAoC;IACpD,IAAI,SAAK;IACT,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAEJ,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAMpD,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAqBxC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO;IAkCpE,wCAAwC;IACxC,IAAI,IAAI,IAAI;IAeZ,uFAAuF;IACvF,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;CA2BvD"}
+{"version":3,"file":"Room.d.ts","sourceRoot":"","sources":["../../../src/net/Room.ts"],"names":[],"mappings":"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"}

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

@@ -39,8 +39,8 @@ export interface RoomHostOptions<D> {
  * host.start();
  * ```
  */
-export declare class RoomHost<D = unknown> {
-    readonly room: Room<D>;
+export declare class RoomHost<D = unknown, B = unknown> {
+    readonly room: Room<D, B>;
     private readonly options;
     private readonly sockets;
     private readonly joined;
@@ -51,7 +51,7 @@ export declare class RoomHost<D = unknown> {
     private readonly stepMs;
     private readonly snapEvery;
     private readonly now;
-    constructor(room: Room<D>, options?: RoomHostOptions<D>);
+    constructor(room: Room<D, B>, options?: RoomHostOptions<D>);
     /** A socket connected; returns the id its messages and its close are reported under. */
     connect(socket: HostSocket): number;
     /** A message arrived from socket `id` (text as a string, binary as bytes). */
@@ -68,6 +68,11 @@ export declare class RoomHost<D = unknown> {
     stop(): void;
     /** One step, and the snapshots when they are due. Exposed for tests and for servers that drive their own loop. */
     stepOnce(): void;
+    /**
+     * The server time a client's claimed view time (`InterpolationBuffer.viewTime`, sent with a shot) is judged at:
+     * kept within the room's `rewindMs` of now, so no claim reaches further back. `now` with no history kept.
+     */
+    rewindTime(claimed: unknown): number;
     private strike;
     private checkStrikes;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"RoomHost.d.ts","sourceRoot":"","sources":["../../../src/net/RoomHost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,OAAO,KAAK,EAAiB,aAAa,EAAY,MAAM,YAAY,CAAC;AAEzE,uGAAuG;AACvG,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kGAAkG;IAClG,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,KAAK,CAAC,CAAC;IACzC,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC3E,4CAA4C;IAC5C,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,QAAQ,CAAC,CAAC,GAAG,OAAO;IAY7B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZ1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAGxB,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACL,OAAO,GAAE,eAAe,CAAC,CAAC,CAAM;IAOnD,wFAAwF;IACxF,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAMnC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI;IAyClE,0BAA0B;IAC1B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ5B,wDAAwD;IACxD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI;IAOlF,0GAA0G;IAC1G,KAAK,IAAI,IAAI;IAgBb,IAAI,IAAI,IAAI;IAKZ,kHAAkH;IAClH,QAAQ,IAAI,IAAI;IAUhB,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,YAAY;CAOrB"}
+{"version":3,"file":"RoomHost.d.ts","sourceRoot":"","sources":["../../../src/net/RoomHost.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,OAAO,KAAK,EAAiB,aAAa,EAAY,MAAM,YAAY,CAAC;AAEzE,uGAAuG;AACvG,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kGAAkG;IAClG,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,KAAK,CAAC,CAAC;IACzC,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC3E,4CAA4C;IAC5C,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IAY1C,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZ1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAGxB,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EACR,OAAO,GAAE,eAAe,CAAC,CAAC,CAAM;IAOnD,wFAAwF;IACxF,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAMnC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI;IAyClE,0BAA0B;IAC1B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ5B,wDAAwD;IACxD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI;IAOlF,0GAA0G;IAC1G,KAAK,IAAI,IAAI;IAgBb,IAAI,IAAI,IAAI;IAKZ,kHAAkH;IAClH,QAAQ,IAAI,IAAI;IAYhB;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAIpC,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,YAAY;CAOrB"}

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

@@ -0,0 +1,25 @@
+/**
+ * Points sorted into square cells, for asking who is near a spot without looking at everyone: a room's interest
+ * management, a server's hit test. Moving a point within its cell costs a write; across cells, a set delete and add.
+ * Pure and transport-free, so the same class serves the client.
+ */
+export declare class SpatialHash {
+    readonly cellSize: number;
+    private readonly cells;
+    private readonly entries;
+    /** `cellSize`: world px per cell. About the radius queries ask for keeps a query to a 3×3 block. */
+    constructor(cellSize: number);
+    get size(): number;
+    has(id: number): boolean;
+    /** Puts `id` at (x, y), or moves it there. */
+    set(id: number, x: number, y: number): void;
+    delete(id: number): void;
+    clear(): void;
+    /** The ids within `radius` of (x, y), edge included, pushed onto `out` in no set order. */
+    near(x: number, y: number, radius: number, out?: number[]): number[];
+    /** The ids inside the box from (x0, y0) to (x1, y1), edges included. */
+    inRect(x0: number, y0: number, x1: number, y1: number, out?: number[]): number[];
+    private visit;
+    private unlink;
+}
+//# sourceMappingURL=SpatialHash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SpatialHash.d.ts","sourceRoot":"","sources":["../../../src/net/SpatialHash.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,qBAAa,WAAW;IAKV,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAJrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,oGAAoG;gBAC/E,QAAQ,EAAE,MAAM;IAIrC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAe3C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOxB,KAAK,IAAI,IAAI;IAKb,2FAA2F;IAC3F,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE;IAUxE,wEAAwE;IACxE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE;IAOpF,OAAO,CAAC,KAAK;IAkBb,OAAO,CAAC,MAAM;CAMf"}

package/dist/types/ui/ScrollView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScrollView.d.ts","sourceRoot":"","sources":["../../../src/ui/ScrollView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA8F,MAAM,SAAS,CAAC;AAEhI,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,MAAO,YAAW,SAAS;IAmB7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAlBpC,QAAQ,CAAC,OAAO,8CAAmB;IACnC,uGAAuG;IACvG,cAAc,UAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkD;IACzE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;gBAEhB,OAAO,EAAE,iBAAiB;IAsBvD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,6EAA6E;IAC7E,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAOjC,kEAAkE;IAClE,OAAO,IAAI,IAAI;IAKf,yDAAyD;IACzD,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAQ5B,6FAA6F;IAC7F,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAO9B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQlB,OAAO,IAAI,IAAI;IAKxB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,OAAO;IAef,SAAS,CAAC,MAAM,IAAI,IAAI;CA0BzB"}
+{"version":3,"file":"ScrollView.d.ts","sourceRoot":"","sources":["../../../src/ui/ScrollView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA8F,MAAM,SAAS,CAAC;AAEhI,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,MAAO,YAAW,SAAS;IAmB7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAlBpC,QAAQ,CAAC,OAAO,8CAAmB;IACnC,uGAAuG;IACvG,cAAc,UAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkD;IACzE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;gBAEhB,OAAO,EAAE,iBAAiB;IAsBvD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,6EAA6E;IAC7E,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAOjC,kEAAkE;IAClE,OAAO,IAAI,IAAI;IAUf,yDAAyD;IACzD,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAQ5B,6FAA6F;IAC7F,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAO9B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQlB,OAAO,IAAI,IAAI;IAKxB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,OAAO;IAef,SAAS,CAAC,MAAM,IAAI,IAAI;CA0BzB"}

package/dist/ui/ScrollView.js

@@ -1,11 +1,11 @@
-import { Sprite as a, Texture as l, Rectangle as r, Container as c, Graphics as f } from "pixi.js";
+import { Sprite as a, Texture as l, Rectangle as n, Container as c, Graphics as f } from "pixi.js";
 import { clampScroll as p, scrollIntoView as d, stepFling as g, maxScroll as u } from "./layout/scroll.js";
-import { Widget as n } from "./Widget.js";
-class w extends n {
+import { Widget as r } from "./Widget.js";
+class w extends r {
   constructor(t) {
     super(), this.options = t, this.addChild(this.content, this.clip), this.content.mask = this.clip;
     const s = t.barColor === void 0 ? 16777215 : t.barColor;
-    this.bar = s === null ? null : new a(l.WHITE), this.bar && (this.bar.tint = s, this.bar.alpha = 0.4, this.addChild(this.bar)), this.makeInteractive(), this.hitArea = new r(0, 0, 0, 0), this.on("wheel", (i) => {
+    this.bar = s === null ? null : new a(l.WHITE), this.bar && (this.bar.tint = s, this.bar.alpha = 0.4, this.addChild(this.bar)), this.makeInteractive(), this.hitArea = new n(0, 0, 0, 0), this.on("wheel", (i) => {
       const o = t.wheelStep ?? 48, e = Math.max(-o, Math.min(o, i.deltaY));
       this.scrollTo(this.offset + e) && i.stopPropagation();
     }), this.on("pointerdown", (i) => this.dragStart(i)), this.resize(t.width, t.height);
@@ -40,8 +40,10 @@ class w extends n {
   }
   /** Measures the content's drawn height; call after filling it. */
   measure() {
-    const t = this.content.getLocalBounds();
-    return this.setContentHeight(t.maxY);
+    const t = this.content.mask;
+    this.content.mask = null;
+    const s = this.content.getLocalBounds();
+    return this.content.mask = t, this.setContentHeight(s.maxY);
   }
   /** Scrolls to `y`, kept in range; true when it moved. */
   scrollTo(t) {
@@ -50,7 +52,7 @@ class w extends n {
   }
   /** Brings a child into view (the focus manager calls it when a widget inside is focused). */
   reveal(t) {
-    const s = this.content.toLocal(t.getGlobalPosition()).y, i = t instanceof n ? t.boxHeight : t.getLocalBounds().maxY;
+    const s = this.content.toLocal(t.getGlobalPosition()).y, i = t instanceof r ? t.boxHeight : t.getLocalBounds().maxY;
     this.velocity = 0, this.scrollTo(d(this.offset, s, i, this.boxH, this.contentH));
   }
   tick(t) {
@@ -79,7 +81,7 @@ class w extends n {
   }
   redraw() {
     const t = this.boxW, s = this.boxH;
-    (t !== this.clipW || s !== this.clipH) && (this.clipW = t, this.clipH = s, this.clip.clear().rect(0, 0, t, s).fill(16777215)), this.hitArea instanceof r && (this.hitArea.width = t, this.hitArea.height = s);
+    (t !== this.clipW || s !== this.clipH) && (this.clipW = t, this.clipH = s, this.clip.clear().rect(0, 0, t, s).fill(16777215)), this.hitArea instanceof n && (this.hitArea.width = t, this.hitArea.height = s);
     const i = this.host?.pixelPerfect ?? !1;
     if (this.content.y = i ? -Math.round(this.offset) : -this.offset, this.bar) {
       const o = u(this.contentH, s);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "1681-engine",
-  "version": "0.5.10",
+  "version": "0.6.1",
   "description": "A 2D game engine on PixiJS 8 for any art style: scenes and a fast ECS, a fixed-step loop, asset loading, Tiled maps, sprite animation, input actions, camera follow, audio and deterministic, server-replayable movement, plus Dither, an optional pixel-art module (pixel-perfect effects, dithered lighting).",
   "type": "module",
   "types": "./dist/types/index.d.ts",
@@ -53,6 +53,10 @@
         "default": "./dist/cjs/electron/index.js"
       }
     },
+    "./mobile": {
+      "types": "./dist/types/mobile/index.d.ts",
+      "import": "./dist/mobile.js"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {