1681-engine 0.5.9 → 0.6.0

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/pixel/index.d.ts

@@ -24,6 +24,7 @@ export { spritePixels, NO_PIXELS, PackedPixels, type SpritePixel } from './sprit
 export { Darkness, WARM_LIGHT, LAMP_DIM, CARRIED_LIGHT, type DarknessOptions } from './Darkness.js';
 export { flashLight, carriedLight, liveLights, clearLights, type TransientLight } from './lights.js';
 export { NightShade, type NightShadeOptions } from './NightShade.js';
+export { paintLifeArt, puffPixels, LIFE_COLORS, PUFF_FRAMES, type LifeArt, type LifeColors, type LifePixel } from './lifeArt.js';
 export { paintWeatherArt, mistPixels, WEATHER_COLORS, type WeatherColors, type WeatherPixel } from './weatherArt.js';
 export { buildRig, trunkPivot, complement, tileHash, gustAt, swayOffset, type SwayDef, type SwayMode, type TuftRect, type SwayRig, type SwayStrip, type Rect as SwayRect } from './swayRig.js';
 export { SwayProp, opaqueRowWidths, type SwayPropOptions, type SwayWind } from './SwayProp.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pixel/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EACL,SAAS,EACT,WAAW,EACX,KAAK,EACL,IAAI,EACJ,GAAG,EACH,QAAQ,EACR,KAAK,EACL,GAAG,EACH,SAAS,EACT,KAAK,EACL,KAAK,EACL,UAAU,EACV,UAAU,EACV,SAAS,EACT,OAAO,EACP,KAAK,KAAK,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,CAAC,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAClF,OAAO,EACL,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,IAAI,GACV,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjH,OAAO,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjF,4FAA4F;AAC5F,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,wEAAwE;AACxE,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEzF,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAClG,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAClH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,IAAI,IAAI,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC5L,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pixel/index.ts"],"names":[],"mappings":"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"}

package/dist/types/pixel/lifeArt.d.ts

@@ -0,0 +1,63 @@
+import type { TextureRegistry } from '../core/TextureRegistry.js';
+/** A pixel of life art: x, y and a CSS colour. */
+export type LifePixel = readonly [x: number, y: number, color: string];
+/** The colours the life is painted in; every one may be replaced to suit a game's palette. */
+export interface LifeColors {
+    /** Each leaf tone, [lit, deep]. */
+    leaves: readonly (readonly [string, string])[];
+    /** A seed: the whole one, and the second pixel of the longer one. */
+    seed: readonly [string, string];
+    /** An ember from hot to cool. */
+    ember: readonly [string, string, string];
+    /** Two motes. */
+    mote: readonly [string, string];
+    /** Two flakes of ash: [lit, deep] each. */
+    ash: readonly (readonly [string, string])[];
+    /** Each butterfly tone, [wing, wing's edge]. */
+    butterflies: readonly (readonly [string, string])[];
+    butterflyBody: string;
+    bird: string;
+    /** Its shadow's middle and ends (translucent black suits any ground). */
+    birdShadow: readonly [middle: string, ends: string];
+    /** A firefly's glow and the dim pixels round it. */
+    firefly: readonly [lit: string, dim: string];
+    /** Smoke: light (up-left), middle, dark (down-right). */
+    smoke: readonly [string, string, string];
+}
+export declare const LIFE_COLORS: LifeColors;
+/** The texture keys painted, laid out the way the life classes take them. */
+export interface LifeArt {
+    /** `Drift` looks for each kind. */
+    leaves: string[][];
+    seeds: string[][];
+    embers: string[][];
+    motes: string[][];
+    ash: string[][];
+    /** `Butterflies` looks: [open, shut] per tone. */
+    butterflies: [string, string][];
+    /** `Birds` frames and shadow. */
+    bird: [string, string];
+    birdShadow: string;
+    /** `Fireflies` frames: [dim, lit]. */
+    firefly: [string, string];
+    /** `ChimneySmoke` frames. */
+    puffs: string[];
+}
+/** Frames a puff of smoke grows through. */
+export declare const PUFF_FRAMES = 6;
+/**
+ * One puff of smoke at `frame` (0..PUFF_FRAMES-1): a ragged blob, light on its up-left and dark on its down-right, that
+ * grows as it climbs. Its corner pixels come and go by a fixed hash, so it is no clean ellipse, and the last two
+ * frames lose every other pixel on a checkerboard, the way every effect dithers out. Pure.
+ */
+export declare function puffPixels(frame: number, colors?: readonly [string, string, string]): {
+    w: number;
+    h: number;
+    px: LifePixel[];
+};
+/**
+ * Paints the life's art under `prefix` (default `'life_'`) and returns its keys. A key already registered is kept, so
+ * calling it again (every map) costs nothing — and painting other colours needs another prefix.
+ */
+export declare function paintLifeArt(textures: TextureRegistry, colors?: Partial<LifeColors>, prefix?: string): LifeArt;
+//# sourceMappingURL=lifeArt.d.ts.map

package/dist/types/pixel/lifeArt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifeArt.d.ts","sourceRoot":"","sources":["../../../src/pixel/lifeArt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAS/D,kDAAkD;AAClD,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAEvE,8FAA8F;AAC9F,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IAC/C,qEAAqE;IACrE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,iCAAiC;IACjC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,iBAAiB;IACjB,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,2CAA2C;IAC3C,GAAG,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IAC5C,gDAAgD;IAChD,WAAW,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACpD,oDAAoD;IACpD,OAAO,EAAE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7C,yDAAyD;IACzD,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,eAAO,MAAM,WAAW,EAAE,UAuBzB,CAAC;AAEF,6EAA6E;AAC7E,MAAM,WAAW,OAAO;IACtB,mCAAmC;IACnC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC;IAChB,kDAAkD;IAClD,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAChC,iCAAiC;IACjC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,4CAA4C;AAC5C,eAAO,MAAM,WAAW,IAAI,CAAC;AAQ7B;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAqB,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,SAAS,EAAE,CAAA;CAAE,CAqBlJ;AAgBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,GAAE,OAAO,CAAC,UAAU,CAAM,EAAE,MAAM,SAAU,GAAG,OAAO,CA2CnH"}

package/dist/types/react/ConfirmButton.d.ts

@@ -0,0 +1,26 @@
+import { type ReactNode } from 'react';
+export interface ConfirmButtonProps {
+    /** What this button arms, among the ones sharing `armed` (a name, "disband"…). */
+    armKey?: string;
+    /**
+     * Which button of a group is armed now, kept by the parent so arming one disarms the others. Left out, the button
+     * keeps its own state.
+     */
+    armed?: string | null;
+    setArmed?: (key: string | null) => void;
+    onConfirm: () => void;
+    label: ReactNode;
+    /** Shown once armed: what the second click will do (default `UiLabels.confirmAgain`). */
+    armedLabel?: ReactNode;
+    title?: string;
+    /** Default `'small'`. */
+    className?: string;
+    disabled?: boolean;
+}
+/**
+ * A button asked twice: the first click arms it (it takes the `armed` look and says so), the second does the thing.
+ * For what cannot be undone from a list row — removing a friend, disbanding a group — where a dialog would be heavier
+ * than the choice.
+ */
+export declare function ConfirmButton({ armKey, armed, setArmed, onConfirm, label, armedLabel, title, className, disabled }: ConfirmButtonProps): import("react").JSX.Element;
+//# sourceMappingURL=ConfirmButton.d.ts.map

package/dist/types/react/ConfirmButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfirmButton.d.ts","sourceRoot":"","sources":["../../../src/react/ConfirmButton.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIjD,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACxC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,yFAAyF;IACzF,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,MAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,SAAmB,EAAE,QAAQ,EAAE,EAAE,kBAAkB,+BAuB1J"}

package/dist/types/react/baseCss.d.ts

@@ -18,7 +18,7 @@
  * A `-width` may have one to four lengths, like `border-width`. The pixel rules hold here: no `translate(-50%)` centring and no `zoom` (the components place in whole pixels), no
  * blurred shadow, no gradient. A frame's middle shows through only when its slice says `fill`.
  */
-export declare const baseCss = "\n:root {\n  --e1681-font: inherit;\n  --e1681-font-size: 16px;\n  --e1681-text: #ece6d6;\n  --e1681-muted: #9c968a;\n  --e1681-accent: #e8c060;\n  --e1681-bg: #1d242e;\n  --e1681-well: #131a24;\n  --e1681-control-bg: #2a323e;\n  --e1681-border: #6a5634;\n  --e1681-border-width: 2px;\n  --e1681-backdrop: rgba(0, 0, 0, 0.5);\n  --e1681-frame: none;\n  --e1681-frame-slice: 0;\n  --e1681-frame-width: var(--e1681-border-width);\n  --e1681-tip-frame: var(--e1681-frame);\n  --e1681-tip-frame-slice: var(--e1681-frame-slice);\n  --e1681-tip-frame-width: var(--e1681-frame-width);\n  --e1681-control-frame: none;\n  --e1681-control-frame-slice: 0;\n  --e1681-control-frame-width: var(--e1681-border-width);\n  --e1681-tab-frame: var(--e1681-control-frame);\n  --e1681-tab-active-frame: var(--e1681-tab-frame);\n  --e1681-tab-frame-slice: var(--e1681-control-frame-slice);\n  --e1681-tab-frame-width: var(--e1681-control-frame-width);\n  --e1681-well-frame: none;\n  --e1681-well-frame-slice: 0;\n  --e1681-well-frame-width: var(--e1681-border-width);\n}\n\n.e1681-frame {\n  color: var(--e1681-text);\n  font-family: var(--e1681-font);\n  font-size: var(--e1681-font-size);\n  background: var(--e1681-bg) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-frame-width);\n  border-image: var(--e1681-frame) var(--e1681-frame-slice) / var(--e1681-frame-width) stretch;\n  box-sizing: border-box;\n}\n.e1681-tip-frame {\n  color: var(--e1681-text);\n  font-family: var(--e1681-font);\n  font-size: var(--e1681-font-size);\n  background: var(--e1681-bg) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-tip-frame-width);\n  border-image: var(--e1681-tip-frame) var(--e1681-tip-frame-slice) / var(--e1681-tip-frame-width) stretch;\n  box-sizing: border-box;\n}\n\n/* windows: placed by useFitToViewport in whole pixels; header kept, body scrolls */\n.e1681-panel {\n  position: fixed;\n  z-index: 10;\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  overflow: hidden;\n  pointer-events: auto;\n}\n.e1681-panel-header { display: flex; align-items: center; gap: 8px; flex: none; padding: 2px 4px 6px; }\n.e1681-panel-title { flex: 1; min-width: 0; margin: 0; font-size: 1.25em; font-weight: normal; color: var(--e1681-accent); }\n.e1681-panel-body { flex: 1 1 auto; min-height: 0; overflow-y: auto; overflow-x: hidden; padding: 0 4px 4px; }\n.e1681-panel-footer { flex: none; display: flex; flex-wrap: wrap; gap: 6px; justify-content: flex-end; padding: 6px 4px 0; }\n.e1681-close {\n  flex: none; padding: 2px; border: 0; background: none; color: var(--e1681-text); cursor: pointer; line-height: 0;\n}\n.e1681-close:hover { color: var(--e1681-accent); }\n/* a touch screen's sheet: the whole screen inside the safe area */\n.e1681-panel.e1681-sheet {\n  inset: env(safe-area-inset-top, 0px) env(safe-area-inset-right, 0px) env(safe-area-inset-bottom, 0px) env(safe-area-inset-left, 0px);\n  width: auto;\n  height: auto;\n}\n.e1681-panel.e1681-sheet .e1681-panel-body { overscroll-behavior: contain; -webkit-overflow-scrolling: touch; }\n\n/* controls */\n.e1681-button, .e1681-input, .e1681-select {\n  color: var(--e1681-text);\n  font: inherit;\n  background: var(--e1681-control-bg) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-control-frame-width);\n  border-image: var(--e1681-control-frame) var(--e1681-control-frame-slice) / var(--e1681-control-frame-width) stretch;\n  box-shadow: none;\n}\n.e1681-button { padding: 2px 10px; cursor: pointer; min-height: 28px; }\n.e1681-button.small { padding: 0 6px; min-height: 22px; }\n.e1681-button.ghost { background-color: transparent; }\n.e1681-button:hover:not(:disabled) { color: var(--e1681-accent); }\n/* pressed: the same face a pixel lower, never a transform */\n.e1681-button:active:not(:disabled) { padding-top: 3px; padding-bottom: 1px; }\n.e1681-button:disabled { opacity: 0.55; cursor: default; }\n.e1681-input { padding: 2px 6px; min-width: 0; }\n.e1681-glyph { display: inline-block; flex: none; vertical-align: -1px; }\n\n/* tabs: a row that scrolls sideways, or wraps with .wrap */\n.e1681-tabs { display: flex; gap: 2px; align-items: flex-end; overflow-x: auto; overflow-y: hidden; scrollbar-width: none; margin-bottom: 8px; }\n.e1681-tabs::-webkit-scrollbar { display: none; }\n.e1681-tabs.wrap { flex-wrap: wrap; overflow-x: visible; row-gap: 4px; }\n.e1681-tab {\n  flex: 0 0 auto;\n  padding: 2px 10px;\n  color: var(--e1681-muted);\n  font: inherit;\n  cursor: pointer;\n  white-space: nowrap;\n  background: var(--e1681-control-bg) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-tab-frame-width);\n  border-image: var(--e1681-tab-frame) var(--e1681-tab-frame-slice) / var(--e1681-tab-frame-width) stretch;\n}\n.e1681-tab:hover:not(.active):not(:disabled) { color: var(--e1681-text); }\n.e1681-tab.active { color: var(--e1681-accent); padding-bottom: 6px; border-image-source: var(--e1681-tab-active-frame); }\n.e1681-tab:disabled { opacity: 0.55; cursor: default; }\n.e1681-tab:focus-visible { outline: 2px solid var(--e1681-accent); outline-offset: -4px; }\n.e1681-tabs.small { margin-bottom: 4px; }\n.e1681-tabs.small .e1681-tab { padding: 0 6px; }\n.e1681-tabs.small .e1681-tab.active { padding-bottom: 4px; }\n\n/* list beside detail */\n.e1681-split {\n  display: grid;\n  grid-template-columns: var(--e1681-split-list, minmax(0, 1fr)) minmax(0, 1fr);\n  gap: 12px;\n  height: min(58vh, 620px);\n}\n.e1681-split.fit { height: auto; max-height: min(58vh, 620px); }\n.e1681-split-list, .e1681-split-detail { min-height: 0; overflow-y: auto; overflow-x: hidden; }\n.e1681-split-list { padding-right: 4px; }\n.e1681-split-detail {\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n  padding: 8px 10px;\n  background: var(--e1681-well) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-well-frame-width);\n  border-image: var(--e1681-well-frame) var(--e1681-well-frame-slice) / var(--e1681-well-frame-width) stretch;\n}\n.e1681-split-empty { flex: 1; display: flex; align-items: center; justify-content: center; text-align: center; color: var(--e1681-muted); }\n.e1681-split.stack { grid-template-columns: minmax(0, 1fr); }\n.e1681-split.stack.show-list .e1681-split-detail, .e1681-split.stack.show-detail .e1681-split-list { display: none; }\n.e1681-split-back { align-self: flex-start; }\n.e1681-row { display: flex; align-items: center; gap: 8px; padding: 4px 6px; margin-bottom: 4px; border: var(--e1681-border-width) solid transparent; }\n.e1681-pickable { cursor: pointer; }\n.e1681-pickable:hover:not(.picked):not(.disabled) { border-color: var(--e1681-border); }\n.e1681-row.picked { border-color: var(--e1681-accent); color: var(--e1681-accent); }\n.e1681-row.disabled { opacity: 0.55; cursor: default; }\n\n/* the select: as wide as its longest label */\n.e1681-select { display: inline-flex; align-items: center; gap: 6px; flex: none; padding: 1px 4px; text-align: left; cursor: pointer; }\n.e1681-select:hover:not(:disabled), .e1681-select.open { color: var(--e1681-accent); }\n.e1681-select:disabled { opacity: 0.6; cursor: default; }\n.e1681-select.grow { flex: 1 1 auto; min-width: 0; }\n.e1681-select.grow .e1681-select-labels { flex: 1 1 auto; min-width: 0; overflow: hidden; }\n.e1681-select.grow .e1681-select-labels > span { overflow: hidden; text-overflow: ellipsis; }\n.e1681-select-labels { display: grid; white-space: nowrap; }\n.e1681-select-labels > span { grid-area: 1 / 1; visibility: hidden; }\n.e1681-select-labels > span.shown { visibility: visible; }\n.e1681-select-list {\n  position: fixed;\n  z-index: 10000;\n  box-sizing: border-box;\n  width: max-content;\n  padding: 2px;\n  overflow-y: auto;\n  pointer-events: auto;\n}\n.e1681-select-option { padding: 2px 6px; white-space: nowrap; cursor: pointer; }\n.e1681-select-list.measuring .e1681-select-option { width: max-content; }\n.e1681-select-option.hot { background: var(--e1681-control-bg); }\n.e1681-select-option.picked { color: var(--e1681-accent); }\n\n/* tooltips */\n.e1681-tooltip { position: fixed; z-index: 10001; max-width: 360px; padding: 4px 8px; overflow: hidden; pointer-events: none; }\n.e1681-title-tip { white-space: pre-line; }\n\n/* slider: a square knob, flat fills */\n.e1681-slider-row { display: flex; align-items: center; gap: 8px; flex: 1; min-width: 0; }\n.e1681-slider { flex: 1; min-width: 0; padding: 6px 7px; cursor: pointer; touch-action: none; user-select: none; pointer-events: auto; }\n.e1681-slider:focus { outline: none; }\n.e1681-slider:focus-visible { outline: 2px solid var(--e1681-accent); outline-offset: 2px; }\n.e1681-slider[aria-disabled='true'] { opacity: 0.55; cursor: default; }\n.e1681-slider-track {\n  position: relative;\n  height: 6px;\n  background: var(--e1681-well) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-well-frame-width);\n  border-image: var(--e1681-well-frame) var(--e1681-well-frame-slice) / var(--e1681-well-frame-width) stretch;\n}\n.e1681-slider-fill { position: absolute; left: 0; top: 0; bottom: 0; background: var(--e1681-accent); }\n/* the knob is offset by half its own whole-pixel width with a margin, so it stays on the pixel grid */\n.e1681-slider-knob { position: absolute; top: -6px; width: 10px; height: 14px; margin-left: -5px; background: var(--e1681-text); border: 2px solid var(--e1681-well); box-sizing: border-box; }\n.e1681-slider-value { min-width: 40px; text-align: right; font-variant-numeric: tabular-nums; }\n\n/* dialogs */\n.e1681-backdrop { position: fixed; inset: 0; z-index: 9000; background: var(--e1681-backdrop); pointer-events: auto; }\n.e1681-dialog { position: fixed; display: flex; flex-direction: column; overflow: hidden; padding: 8px 10px; }\n.e1681-dialog-body { flex: 1 1 auto; min-height: 0; overflow-y: auto; }\n.e1681-dialog-actions { flex: none; display: flex; flex-wrap: wrap; gap: 8px; justify-content: flex-end; padding-top: 10px; }\n.e1681-confirm-text { white-space: pre-line; }\n.e1681-confirm-qty { display: flex; align-items: center; gap: 6px; margin-top: 10px; }\n.e1681-confirm-qty-input { width: 56px; text-align: right; }\n.e1681-choice-list { margin-top: 8px; }\n.e1681-choice-icon { flex: none; line-height: 0; }\n.e1681-choice-label { flex: 1; min-width: 0; }\n.e1681-choice-note { flex: none; margin-left: auto; color: var(--e1681-muted); }\n\n/* sprites at whole multiples */\n.e1681-pixel-image { display: inline-flex; align-items: center; justify-content: center; flex: none; overflow: hidden; }\n.e1681-pixel-image > img { image-rendering: pixelated; flex: none; }\n";
+export declare const baseCss = "\n:root {\n  --e1681-font: inherit;\n  --e1681-font-size: 16px;\n  --e1681-text: #ece6d6;\n  --e1681-muted: #9c968a;\n  --e1681-accent: #e8c060;\n  --e1681-bg: #1d242e;\n  --e1681-well: #131a24;\n  --e1681-control-bg: #2a323e;\n  --e1681-border: #6a5634;\n  --e1681-border-width: 2px;\n  --e1681-backdrop: rgba(0, 0, 0, 0.5);\n  --e1681-frame: none;\n  --e1681-frame-slice: 0;\n  --e1681-frame-width: var(--e1681-border-width);\n  --e1681-tip-frame: var(--e1681-frame);\n  --e1681-tip-frame-slice: var(--e1681-frame-slice);\n  --e1681-tip-frame-width: var(--e1681-frame-width);\n  --e1681-control-frame: none;\n  --e1681-control-frame-slice: 0;\n  --e1681-control-frame-width: var(--e1681-border-width);\n  --e1681-tab-frame: var(--e1681-control-frame);\n  --e1681-tab-active-frame: var(--e1681-tab-frame);\n  --e1681-tab-frame-slice: var(--e1681-control-frame-slice);\n  --e1681-tab-frame-width: var(--e1681-control-frame-width);\n  --e1681-well-frame: none;\n  --e1681-well-frame-slice: 0;\n  --e1681-well-frame-width: var(--e1681-border-width);\n}\n\n.e1681-frame {\n  color: var(--e1681-text);\n  font-family: var(--e1681-font);\n  font-size: var(--e1681-font-size);\n  background: var(--e1681-bg) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-frame-width);\n  border-image: var(--e1681-frame) var(--e1681-frame-slice) / var(--e1681-frame-width) stretch;\n  box-sizing: border-box;\n}\n.e1681-tip-frame {\n  color: var(--e1681-text);\n  font-family: var(--e1681-font);\n  font-size: var(--e1681-font-size);\n  background: var(--e1681-bg) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-tip-frame-width);\n  border-image: var(--e1681-tip-frame) var(--e1681-tip-frame-slice) / var(--e1681-tip-frame-width) stretch;\n  box-sizing: border-box;\n}\n\n/* windows: placed by useFitToViewport in whole pixels; header kept, body scrolls */\n.e1681-panel {\n  position: fixed;\n  z-index: 10;\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  overflow: hidden;\n  pointer-events: auto;\n}\n.e1681-panel-header { display: flex; align-items: center; gap: 8px; flex: none; padding: 2px 4px 6px; }\n.e1681-panel-title { flex: 1; min-width: 0; margin: 0; font-size: 1.25em; font-weight: normal; color: var(--e1681-accent); }\n.e1681-panel-body { flex: 1 1 auto; min-height: 0; overflow-y: auto; overflow-x: hidden; padding: 0 4px 4px; }\n.e1681-panel-footer { flex: none; display: flex; flex-wrap: wrap; gap: 6px; justify-content: flex-end; padding: 6px 4px 0; }\n.e1681-close {\n  flex: none; padding: 2px; border: 0; background: none; color: var(--e1681-text); cursor: pointer; line-height: 0;\n}\n.e1681-close:hover { color: var(--e1681-accent); }\n/* a touch screen's sheet: the whole screen inside the safe area */\n.e1681-panel.e1681-sheet {\n  inset: env(safe-area-inset-top, 0px) env(safe-area-inset-right, 0px) env(safe-area-inset-bottom, 0px) env(safe-area-inset-left, 0px);\n  width: auto;\n  height: auto;\n}\n.e1681-panel.e1681-sheet .e1681-panel-body { overscroll-behavior: contain; -webkit-overflow-scrolling: touch; }\n\n/* controls */\n.e1681-button, .e1681-input, .e1681-select {\n  color: var(--e1681-text);\n  font: inherit;\n  background: var(--e1681-control-bg) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-control-frame-width);\n  border-image: var(--e1681-control-frame) var(--e1681-control-frame-slice) / var(--e1681-control-frame-width) stretch;\n  box-shadow: none;\n}\n.e1681-button { padding: 2px 10px; cursor: pointer; min-height: 28px; }\n.e1681-button.small { padding: 0 6px; min-height: 22px; }\n.e1681-button.ghost { background-color: transparent; }\n.e1681-button.e1681-armed { color: var(--e1681-accent); }\n.e1681-button:hover:not(:disabled) { color: var(--e1681-accent); }\n/* pressed: the same face a pixel lower, never a transform */\n.e1681-button:active:not(:disabled) { padding-top: 3px; padding-bottom: 1px; }\n.e1681-button:disabled { opacity: 0.55; cursor: default; }\n.e1681-input { padding: 2px 6px; min-width: 0; }\n.e1681-glyph { display: inline-block; flex: none; vertical-align: -1px; }\n\n/* tabs: a row that scrolls sideways, or wraps with .wrap */\n.e1681-tabs { display: flex; gap: 2px; align-items: flex-end; overflow-x: auto; overflow-y: hidden; scrollbar-width: none; margin-bottom: 8px; }\n.e1681-tabs::-webkit-scrollbar { display: none; }\n.e1681-tabs.wrap { flex-wrap: wrap; overflow-x: visible; row-gap: 4px; }\n.e1681-tab {\n  flex: 0 0 auto;\n  padding: 2px 10px;\n  color: var(--e1681-muted);\n  font: inherit;\n  cursor: pointer;\n  white-space: nowrap;\n  background: var(--e1681-control-bg) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-tab-frame-width);\n  border-image: var(--e1681-tab-frame) var(--e1681-tab-frame-slice) / var(--e1681-tab-frame-width) stretch;\n}\n.e1681-tab:hover:not(.active):not(:disabled) { color: var(--e1681-text); }\n.e1681-tab.active { color: var(--e1681-accent); padding-bottom: 6px; border-image-source: var(--e1681-tab-active-frame); }\n.e1681-tab:disabled { opacity: 0.55; cursor: default; }\n.e1681-tab:focus-visible { outline: 2px solid var(--e1681-accent); outline-offset: -4px; }\n.e1681-tabs.small { margin-bottom: 4px; }\n.e1681-tabs.small .e1681-tab { padding: 0 6px; }\n.e1681-tabs.small .e1681-tab.active { padding-bottom: 4px; }\n\n/* list beside detail */\n.e1681-split {\n  display: grid;\n  grid-template-columns: var(--e1681-split-list, minmax(0, 1fr)) minmax(0, 1fr);\n  gap: 12px;\n  height: min(58vh, 620px);\n}\n.e1681-split.fit { height: auto; max-height: min(58vh, 620px); }\n.e1681-split-list, .e1681-split-detail { min-height: 0; overflow-y: auto; overflow-x: hidden; }\n.e1681-split-list { padding-right: 4px; }\n.e1681-split-detail {\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n  padding: 8px 10px;\n  background: var(--e1681-well) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-well-frame-width);\n  border-image: var(--e1681-well-frame) var(--e1681-well-frame-slice) / var(--e1681-well-frame-width) stretch;\n}\n.e1681-split-empty { flex: 1; display: flex; align-items: center; justify-content: center; text-align: center; color: var(--e1681-muted); }\n.e1681-split.stack { grid-template-columns: minmax(0, 1fr); }\n.e1681-split.stack.show-list .e1681-split-detail, .e1681-split.stack.show-detail .e1681-split-list { display: none; }\n.e1681-split-back { align-self: flex-start; }\n.e1681-row { display: flex; align-items: center; gap: 8px; padding: 4px 6px; margin-bottom: 4px; border: var(--e1681-border-width) solid transparent; }\n.e1681-pickable { cursor: pointer; }\n.e1681-pickable:hover:not(.picked):not(.disabled) { border-color: var(--e1681-border); }\n.e1681-row.picked { border-color: var(--e1681-accent); color: var(--e1681-accent); }\n.e1681-row.disabled { opacity: 0.55; cursor: default; }\n\n/* the select: as wide as its longest label */\n.e1681-select { display: inline-flex; align-items: center; gap: 6px; flex: none; padding: 1px 4px; text-align: left; cursor: pointer; }\n.e1681-select:hover:not(:disabled), .e1681-select.open { color: var(--e1681-accent); }\n.e1681-select:disabled { opacity: 0.6; cursor: default; }\n.e1681-select.grow { flex: 1 1 auto; min-width: 0; }\n.e1681-select.grow .e1681-select-labels { flex: 1 1 auto; min-width: 0; overflow: hidden; }\n.e1681-select.grow .e1681-select-labels > span { overflow: hidden; text-overflow: ellipsis; }\n.e1681-select-labels { display: grid; white-space: nowrap; }\n.e1681-select-labels > span { grid-area: 1 / 1; visibility: hidden; }\n.e1681-select-labels > span.shown { visibility: visible; }\n.e1681-select-list {\n  position: fixed;\n  z-index: 10000;\n  box-sizing: border-box;\n  width: max-content;\n  padding: 2px;\n  overflow-y: auto;\n  pointer-events: auto;\n}\n.e1681-select-option { padding: 2px 6px; white-space: nowrap; cursor: pointer; }\n.e1681-select-list.measuring .e1681-select-option { width: max-content; }\n.e1681-select-option.hot { background: var(--e1681-control-bg); }\n.e1681-select-option.picked { color: var(--e1681-accent); }\n\n/* tooltips */\n.e1681-tooltip { position: fixed; z-index: 10001; max-width: 360px; padding: 4px 8px; overflow: hidden; pointer-events: none; }\n.e1681-title-tip { white-space: pre-line; }\n\n/* slider: a square knob, flat fills */\n.e1681-slider-row { display: flex; align-items: center; gap: 8px; flex: 1; min-width: 0; }\n.e1681-slider { flex: 1; min-width: 0; padding: 6px 7px; cursor: pointer; touch-action: none; user-select: none; pointer-events: auto; }\n.e1681-slider:focus { outline: none; }\n.e1681-slider:focus-visible { outline: 2px solid var(--e1681-accent); outline-offset: 2px; }\n.e1681-slider[aria-disabled='true'] { opacity: 0.55; cursor: default; }\n.e1681-slider-track {\n  position: relative;\n  height: 6px;\n  background: var(--e1681-well) padding-box;\n  border-style: solid; border-color: var(--e1681-border); border-width: var(--e1681-well-frame-width);\n  border-image: var(--e1681-well-frame) var(--e1681-well-frame-slice) / var(--e1681-well-frame-width) stretch;\n}\n.e1681-slider-fill { position: absolute; left: 0; top: 0; bottom: 0; background: var(--e1681-accent); }\n/* the knob is offset by half its own whole-pixel width with a margin, so it stays on the pixel grid */\n.e1681-slider-knob { position: absolute; top: -6px; width: 10px; height: 14px; margin-left: -5px; background: var(--e1681-text); border: 2px solid var(--e1681-well); box-sizing: border-box; }\n.e1681-slider-value { min-width: 40px; text-align: right; font-variant-numeric: tabular-nums; }\n\n/* dialogs */\n.e1681-backdrop { position: fixed; inset: 0; z-index: 9000; background: var(--e1681-backdrop); pointer-events: auto; }\n.e1681-dialog { position: fixed; display: flex; flex-direction: column; overflow: hidden; padding: 8px 10px; }\n.e1681-dialog-body { flex: 1 1 auto; min-height: 0; overflow-y: auto; }\n.e1681-dialog-actions { flex: none; display: flex; flex-wrap: wrap; gap: 8px; justify-content: flex-end; padding-top: 10px; }\n.e1681-confirm-text { white-space: pre-line; }\n.e1681-confirm-qty { display: flex; align-items: center; gap: 6px; margin-top: 10px; }\n.e1681-confirm-qty-input { width: 56px; text-align: right; }\n.e1681-choice-list { margin-top: 8px; }\n.e1681-choice-icon { flex: none; line-height: 0; }\n.e1681-choice-label { flex: 1; min-width: 0; }\n.e1681-choice-note { flex: none; margin-left: auto; color: var(--e1681-muted); }\n\n/* sprites at whole multiples */\n.e1681-pixel-image { display: inline-flex; align-items: center; justify-content: center; flex: none; overflow: hidden; }\n.e1681-pixel-image > img { image-rendering: pixelated; flex: none; }\n";
 /**
  * Puts `baseCss` into the page once, first in `<head>` so the game's own rules (and its custom properties) win
  * without needing more specific selectors. Returns the `<style>` element; nothing on a server.

package/dist/types/react/baseCss.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"baseCss.d.ts","sourceRoot":"","sources":["../../../src/react/baseCss.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,OAAO,giVAiNnB,CAAC;AAIF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,QAAQ,GAAG,SAAkE,GAAG,gBAAgB,GAAG,IAAI,CASzI"}
+{"version":3,"file":"baseCss.d.ts","sourceRoot":"","sources":["../../../src/react/baseCss.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,OAAO,2lVAkNnB,CAAC;AAIF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,QAAQ,GAAG,SAAkE,GAAG,gBAAgB,GAAG,IAAI,CASzI"}

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

@@ -11,6 +11,7 @@ export { classJoiner, type ClassJoiner } from './classNames.js';
 export { DEFAULT_LABELS, fillLabel, type UiLabels } from './labels.js';
 export { baseCss, injectBaseCss } from './baseCss.js';
 export { useStore } from './useStore.js';
+export { useJsonSelector, useStoreJson, type SelectingHook } from './useJsonSelector.js';
 export { useViewport } from './useViewport.js';
 export { useFitToViewport, SCROLL_CLASS, type FitTarget } from './useFitToViewport.js';
 export { useFillSheet } from './useFillSheet.js';
@@ -24,6 +25,7 @@ export { Tooltip, type TooltipProps } from './Tooltip.js';
 export { TitleTips, type TitleTipsProps } from './TitleTips.js';
 export { Modal, type ModalProps } from './Modal.js';
 export { ConfirmDialog } from './ConfirmDialog.js';
+export { ConfirmButton, type ConfirmButtonProps } from './ConfirmButton.js';
 export { askConfirm, askQuantity, answerConfirm, cancelConfirm, confirmStore, parseQuantity, type AskOptions, type ConfirmQuestion } from './confirmStore.js';
 export { ChoiceDialog } from './ChoiceDialog.js';
 export { askChoice, answerChoice, cancelChoice, choiceStore, firstChoice, type ChoiceOption, type ChoiceQuestion } from './choiceStore.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAClH,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EACL,WAAW,EACX,eAAe,EACf,SAAS,EACT,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,KAAK,GAAG,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3J,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACxI,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAClH,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EACL,WAAW,EACX,eAAe,EACf,SAAS,EACT,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,KAAK,GAAG,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3J,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACxI,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/types/react/labels.d.ts

@@ -17,6 +17,8 @@ export interface UiLabels {
     quantity: string;
     /** The choice dialog's confirm button. */
     choose: string;
+    /** What an armed `ConfirmButton` says when the game gives it no words of its own. */
+    confirmAgain?: string;
 }
 export declare const DEFAULT_LABELS: UiLabels;
 /** `{0}`, `{1}`… replaced by the arguments, in order. */

package/dist/types/react/labels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../src/react/labels.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,cAAc,EAAE,QAS5B,CAAC;AAEF,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE3E"}
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../src/react/labels.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,cAAc,EAAE,QAU5B,CAAC;AAEF,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE3E"}

package/dist/types/react/useJsonSelector.d.ts

@@ -0,0 +1,13 @@
+import type { Store } from '../ui/dom/createStore.js';
+/** A store hook that selects (zustand's `useStore`, or `(sel) => useStore(store, sel)`). */
+export type SelectingHook<S> = (select: (state: S) => string) => string;
+/**
+ * Selects a small, plain piece of a store by its content: the selector's result is compared as JSON, so a store that
+ * hands out a fresh array or object for unchanged content — a game's player state pushed several times a second in a
+ * fight — re-renders nothing that reads it, and the value returned keeps its reference until the content changes.
+ * Only for small data (a few ids, a list of buffs): the JSON is written once per store change.
+ */
+export declare function useJsonSelector<S, T>(useHook: SelectingHook<S>, select: (state: S) => T): T;
+/** `useJsonSelector` over an engine `Store` (`createStore`). */
+export declare function useStoreJson<S extends object, T>(store: Store<S>, select: (state: S) => T): T;
+//# sourceMappingURL=useJsonSelector.d.ts.map

package/dist/types/react/useJsonSelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useJsonSelector.d.ts","sourceRoot":"","sources":["../../../src/react/useJsonSelector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGnD,4FAA4F;AAC5F,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,KAAK,MAAM,CAAC;AAExE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAG3F;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAE7F"}

package/dist/types/tilemap/TilemapView.d.ts

@@ -16,6 +16,12 @@ export interface TilemapViewOptions {
     baseDepth?: number;
     /** Where the layers go (default the stage's world layer); a scene passes its `root` so they leave with it. */
     parent?: Container;
+    /**
+     * World position of the map's top-left corner (default 0, 0): an LDtk level's `worldX`/`worldY`, or any map laid
+     * beside another. Culling in `update` counts it.
+     */
+    x?: number;
+    y?: number;
 }
 /**
  * Draws a Tiled map's tile layers. Each layer is cut into chunks painted once into textures; a frame only toggles
@@ -30,9 +36,20 @@ export declare class TilemapView {
     readonly layers: Map<string, Container<import("pixi.js").ContainerChild>>;
     private readonly chunks;
     private readonly id;
+    private readonly chunkTiles;
+    private readonly textureFor;
+    private readonly drawn;
+    private readonly originX;
+    private readonly originY;
     constructor(stage: Stage, map: TileMap, options?: TilemapViewOptions);
     /** Shows only the chunks in the camera's view (plus a margin in world px). Call once a frame. */
     update(margin?: number): void;
+    /**
+     * Repaints the chunks holding these cells (row-major indices) of a drawn layer, after its `data` changed: a door
+     * opening, a wall dug out, a cell autotiled again (`updateAutotile` returns exactly the indices to pass). Costs one
+     * chunk's painting per chunk touched, so keep it out of every frame.
+     */
+    refreshTiles(layerName: string, cells: Iterable<number>): void;
     /** World size of the map in px. */
     get widthPx(): number;
     get heightPx(): number;

package/dist/types/tilemap/TilemapView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TilemapView.d.ts","sourceRoot":"","sources":["../../../src/tilemap/TilemapView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAU,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAA4D,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAE/G,MAAM,WAAW,kBAAkB;IACjC,wHAAwH;IACxH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;IAC1C,+FAA+F;IAC/F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8GAA8G;IAC9G,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAID;;;;;GAKG;AACH,qBAAa,WAAW;IAOpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,QAAQ,CAAC,GAAG,EAAE,OAAO;IAPvB,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,2DAAgC;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqF;IAC5G,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAc;gBAGd,KAAK,EAAE,KAAK,EACpB,GAAG,EAAE,OAAO,EACrB,OAAO,GAAE,kBAAuB;IA0BlC,iGAAiG;IACjG,MAAM,CAAC,MAAM,SAAK,GAAG,IAAI;IAOzB,mCAAmC;IACnC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,UAAU;CA0CnB"}
+{"version":3,"file":"TilemapView.d.ts","sourceRoot":"","sources":["../../../src/tilemap/TilemapView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAU,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAA4D,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAE/G,MAAM,WAAW,kBAAkB;IACjC,wHAAwH;IACxH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;IAC1C,+FAA+F;IAC/F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8GAA8G;IAC9G,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;OAGG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAID;;;;;GAKG;AACH,qBAAa,WAAW;IAYpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,QAAQ,CAAC,GAAG,EAAE,OAAO;IAZvB,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,2DAAgC;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqF;IAC5G,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAc;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAGd,KAAK,EAAE,KAAK,EACpB,GAAG,EAAE,OAAO,EACrB,OAAO,GAAE,kBAAuB;IA+BlC,iGAAiG;IACjG,MAAM,CAAC,MAAM,SAAK,GAAG,IAAI;IAOzB;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI;IAuB9D,mCAAmC;IACnC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,UAAU;CA2CnB"}

package/dist/types/tilemap/autotile.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Autotiling: picking each cell's tile from which of its neighbours share its terrain, so a painter only says "wall
+ * here, water there" and the borders draw themselves. Two bitmasks are offered:
+ *
+ * - **edges** (4-bit, 16 tiles): the four sides only. Enough for paths, fences and pipes, and for terrain whose
+ *   inner corners need no tile of their own.
+ * - **blob** (8-bit reduced to the 47-tile set): the sides and the corners, a corner counting only when both sides
+ *   beside it match. Without that reduction 256 masks would need 256 tiles; with it a full terrain (outer edges,
+ *   inner corners, thin bridges) needs 47.
+ *
+ * Pure: no Pixi, no DOM, so a server or a map tool can run the same rules.
+ */
+/** The edge bits, clockwise from the top. */
+export declare const EDGE_N = 1;
+export declare const EDGE_E = 2;
+export declare const EDGE_S = 4;
+export declare const EDGE_W = 8;
+/** The blob bits, clockwise from the top. */
+export declare const BLOB_N = 1;
+export declare const BLOB_NE = 2;
+export declare const BLOB_E = 4;
+export declare const BLOB_SE = 8;
+export declare const BLOB_S = 16;
+export declare const BLOB_SW = 32;
+export declare const BLOB_W = 64;
+export declare const BLOB_NW = 128;
+/** A grid of terrain ids, row-major. Any id is fine; the rules say what each one is. */
+export interface TerrainGrid {
+    width: number;
+    height: number;
+    cells: ArrayLike<number> & {
+        [i: number]: number;
+    };
+}
+export type AutotileMode = 'edges' | 'blob';
+export interface MaskOptions {
+    /**
+     * Whether a neighbour counts as "the same" for `terrain` (default: the same id). A rule's `connectsTo` builds one:
+     * grass that also joins flowers, a wall that also joins a door.
+     */
+    joins?: (terrain: number, neighbour: number) => boolean;
+    /**
+     * What lies outside the grid: `'same'` (default) joins the edge so a terrain running off the map shows no border;
+     * `'other'` closes it.
+     */
+    edge?: 'same' | 'other';
+}
+/** Drops each corner bit unless both sides beside it are set: what the 47-tile blob set is drawn for. */
+export declare function reduceBlobMask(mask: number): number;
+/** The 47 reduced blob masks in ascending order; a tileset laid out in that order is indexed by `blob47Index`. */
+export declare const BLOB47_MASKS: readonly number[];
+/** Where a blob mask (reduced or not) sits among the 47: 0…46. */
+export declare function blob47Index(mask: number): number;
+/** The 4-bit edge mask of cell (x, y): `EDGE_*` set for each side whose neighbour joins it. */
+export declare function edgeMask(grid: TerrainGrid, x: number, y: number, options?: MaskOptions): number;
+/** The reduced 8-bit blob mask of cell (x, y): one of `BLOB47_MASKS`. */
+export declare function blobMask(grid: TerrainGrid, x: number, y: number, options?: MaskOptions): number;
+/** How one terrain picks its tiles. */
+export interface AutotileRule {
+    /** The terrain id this rule draws. */
+    terrain: number;
+    /** Which mask picks the tile (default `'blob'`). */
+    mode?: AutotileMode;
+    /**
+     * The tile for a mask: a table by mask (a list picks one of several by the cell's position, the same every time),
+     * or a function of the mask (and the cell, for anything fancier). Blob masks are the reduced ones; to lay a
+     * 47-tile set out in `BLOB47_MASKS` order use `(m) => first + blob47Index(m)`. Edge masks run 0…15, so a 16-tile
+     * strip in mask order is `(m) => first + m`.
+     */
+    tiles: Readonly<Record<number, number | readonly number[]>> | ((mask: number, x: number, y: number) => number);
+    /** The tile when the table has no entry for a mask (default: the entry for the full mask, else `empty`). */
+    fallback?: number;
+    /** Other terrain ids this one joins as if they were its own (a road meeting a bridge). */
+    connectsTo?: readonly number[];
+}
+/** Read once, the first time it is used (compiled lookups are kept per object): build a new set to change the rules. */
+export interface AutotileRuleSet {
+    rules: readonly AutotileRule[];
+    /** The tile for a terrain no rule draws (default 0, an empty cell). */
+    empty?: number;
+    /** What lies outside the grid; see `MaskOptions.edge`. */
+    edge?: 'same' | 'other';
+}
+/** The tile cell (x, y) gets under `set`. */
+export declare function autotileAt(grid: TerrainGrid, set: AutotileRuleSet, x: number, y: number): number;
+/** Every cell's tile, row-major: the whole grid autotiled. */
+export declare function autotile(grid: TerrainGrid, set: AutotileRuleSet, out?: Uint32Array<ArrayBuffer>): Uint32Array;
+/**
+ * After cell (x, y) changed terrain, retiles it and its eight neighbours (the only cells whose masks can change)
+ * into `out`. Returns the indices whose tile actually changed, so a view repaints only those.
+ */
+export declare function updateAutotile(grid: TerrainGrid, set: AutotileRuleSet, out: Uint32Array, x: number, y: number): number[];
+/** Sets cell (x, y) to `terrain` and retiles around it; the changed indices, as `updateAutotile` returns them. */
+export declare function paintTerrain(grid: TerrainGrid, set: AutotileRuleSet, out: Uint32Array, x: number, y: number, terrain: number): number[];
+//# sourceMappingURL=autotile.d.ts.map

package/dist/types/tilemap/autotile.d.ts.map

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