1681-engine 0.5.8 → 0.5.10

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

@@ -1,11 +1,16 @@
-/** World and movement constants. A game that needs other numbers forks these; client and server must agree. */
+/**
+ * The movement defaults. Every one of them can be changed without forking: the tile size and the body's half extents
+ * are fields of the `CollisionGrid` (`createCollisionGrid`'s `tileSize` and options), the dash bit and the step length
+ * are optional fields of `MovementParams`. Client and server must agree on whichever numbers a game picks.
+ */
+/** The default tile size, px; a grid carries its own (`CollisionGrid.tileSize`). */
 export declare const TILE_SIZE = 16;
-/** Fixed input steps a second; movement is simulated per step on both sides. */
+/** The default fixed input steps a second (`MovementParams.stepDt` overrides the step's length). */
 export declare const INPUT_STEP_RATE = 60;
 export declare const INPUT_STEP_DT: number;
-/** Bit of an input step's flags that asks for a dodge roll. */
+/** The default bit of an input step's flags that asks for a dash (`MovementParams.dashFlag` overrides it). */
 export declare const INPUT_FLAG_DASH = 1;
-/** The body's collision box, half extents (px). */
+/** The default collision box, half extents (px); `createCollisionGrid`'s `bodyHalfWidth`/`bodyHalfHeight` override them. */
 export declare const BODY_HALF_WIDTH = 5;
 export declare const BODY_HALF_HEIGHT = 3;
 export declare const COLLISION_EPSILON = 0.01;
@@ -18,6 +23,10 @@ export interface MovementParams {
     dashCooldownSteps: number;
     canMove: boolean;
     canDash: boolean;
+    /** The bit of an input step's flags that starts a dash (default `INPUT_FLAG_DASH`). */
+    dashFlag?: number;
+    /** Seconds one input step lasts (default `INPUT_STEP_DT`); speeds are px a second. */
+    stepDt?: number;
 }
 /** One body's state in a snapshot: [id, x, y, aim, anim, hp, flags]. */
 export type EntityUpdate = [number, number, number, number, number, number, number];

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/net/constants.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAE/G,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,gFAAgF;AAChF,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,aAAa,QAAsB,CAAC;AAEjD,+DAA+D;AAC/D,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,mDAAmD;AACnD,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,mDAAmD;AACnD,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wEAAwE;AACxE,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/net/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oFAAoF;AACpF,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,oGAAoG;AACpG,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,aAAa,QAAsB,CAAC;AAEjD,8GAA8G;AAC9G,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,4HAA4H;AAC5H,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,mDAAmD;AACnD,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wEAAwE;AACxE,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"movement.d.ts","sourceRoot":"","sources":["../../../src/net/movement.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAUrB,gFAAgF;AAChF,eAAO,MAAM,QAAQ,qBAAqB,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,6GAA6G;IAC7G,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,qGAAqG;IACrG,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,kHAAkH;IAClH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAgBrJ;AAED,8GAA8G;AAC9G,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAG/E;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,CAE5D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAGhF;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAY/E;AAED,+EAA+E;AAC/E,wBAAgB,KAAK,CAAC,IAAI,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAkBnF;AAED,4EAA4E;AAC5E,wBAAgB,KAAK,CAAC,IAAI,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAkBnF;AAMD,+DAA+D;AAC/D,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAoCtG"}
+{"version":3,"file":"movement.d.ts","sourceRoot":"","sources":["../../../src/net/movement.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAUrB,gFAAgF;AAChF,eAAO,MAAM,QAAQ,qBAAqB,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,6GAA6G;IAC7G,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,qGAAqG;IACrG,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,kHAAkH;IAClH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAgBrJ;AAED,8GAA8G;AAC9G,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAG/E;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,CAE5D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAGhF;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAY/E;AAED,+EAA+E;AAC/E,wBAAgB,KAAK,CAAC,IAAI,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAkBnF;AAED,4EAA4E;AAC5E,wBAAgB,KAAK,CAAC,IAAI,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAkBnF;AAMD,+DAA+D;AAC/D,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAqCtG"}

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

@@ -0,0 +1,14 @@
+/** The pure decisions behind `Connection`'s reconnecting, apart so they are tested without a socket. */
+/** The wait before reconnect attempt `attempt` (0 first): doubling from `baseMs`, never past `maxMs`. */
+export declare function reconnectDelay(attempt: number, maxMs?: number, baseMs?: number): number;
+/**
+ * Whether a socket that closed with `code` should reconnect by itself: not when we closed it, not when reconnecting is
+ * off, and not on a code the server uses to say "do not come back" (kicked, banned, an outdated client) — retrying
+ * those only loops.
+ */
+export declare function shouldReconnect(code: number, o: {
+    closedByUs: boolean;
+    reconnect?: boolean;
+    fatalCloseCodes?: readonly number[];
+}): boolean;
+//# sourceMappingURL=reconnect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect.d.ts","sourceRoot":"","sources":["../../../src/net/reconnect.ts"],"names":[],"mappings":"AAAA,wGAAwG;AAExG,yGAAyG;AACzG,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAS,EAAE,MAAM,SAAM,GAAG,MAAM,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,OAAO,CAG3I"}

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

@@ -43,7 +43,9 @@ export declare class Darkness {
     private dimLamps;
     /** A phone redraws the night at most `PHONE_MS` apart, whatever moves (`isTouchUi`). */
     private readonly phone;
-    constructor(stage: Stage, color: number, alpha: number);
+    /** The radius `update` uses when it is given none (`DarknessOptions.carriedLight`). */
+    readonly carriedLight: number;
+    constructor(stage: Stage, color: number, alpha: number, options?: DarknessOptions);
     /** A hole and its colour, added to the night's layers. */
     private light;
     /** A lamp fixed in the world: a torch on a wall, the seep in its chamber, a crystal in a seam, in its own colour. */
@@ -64,8 +66,11 @@ export declare class Darkness {
      * at zoom 2 or 3 it is a quarter or a ninth of the screen's pixels. True when it was remade.
      */
     private fit;
-    /** Redraws the night with this frame's holes in it, when anything in it changed. `px`/`py` is where the player stands. */
-    update(now: number, px: number, py: number, carriedRadius: number): void;
+    /**
+     * Redraws the night with this frame's holes in it, when anything in it changed. `px`/`py` is where the player stands;
+     * `carriedRadius` is the light they carry (default the `carriedLight` option, 0 for none).
+     */
+    update(now: number, px: number, py: number, carriedRadius?: number): void;
     private hide;
     /** Lays light `l` at world (wx, wy), `r` px across its radius, in the night's world-pixel grid. */
     private place;
@@ -73,6 +78,13 @@ export declare class Darkness {
 }
 /** What is left of a lamp's glow and colour while lamps are dimmed (`setLampsDimmed`). */
 export declare const LAMP_DIM = 0.35;
-/** World units of light the player carries underground — about five tiles of certainty in any direction. */
-export declare const CARRIED_LIGHT: number;
+/**
+ * The default radius of light the player carries underground, world px: five 16-px tiles of certainty in any
+ * direction. A game with other tiles passes its own as `DarknessOptions.carriedLight`.
+ */
+export declare const CARRIED_LIGHT = 80;
+export interface DarknessOptions {
+    /** The light the player carries when `update` is given no radius, world px (default `CARRIED_LIGHT`, 80). */
+    carriedLight?: number;
+}
 //# sourceMappingURL=Darkness.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Darkness.d.ts","sourceRoot":"","sources":["../../../src/pixel/Darkness.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AA2C3C,yGAAyG;AACzG,eAAO,MAAM,UAAU,WAAW,CAAC;AAsEnC,qBAAa,QAAQ;IAyCjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,KAAK;IA1Cf,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,iHAAiH;IACjH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqF;IAC3G,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,EAAE,CAAgB;IAC1B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,gGAAgG;IAChG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAa;IAC/C,8FAA8F;IAC9F,OAAO,CAAC,UAAU,CAAK;IACvB,oHAAoH;IACpH,OAAO,CAAC,KAAK,CAAQ;IACrB,+FAA+F;IAC/F,OAAO,CAAC,KAAK,CAAM;IACnB,0EAA0E;IAC1E,OAAO,CAAC,SAAS,CAAM;IACvB,uCAAuC;IACvC,OAAO,CAAC,OAAO,CAAa;IAC5B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,CAAK;IACf,OAAO,CAAC,EAAE,CAAK;IACf,8EAA8E;IAC9E,OAAO,CAAC,KAAK,CAAM;IACnB,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAAS;IACzB,wFAAwF;IACxF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAGlB,KAAK,EAAE,KAAK,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM;IAgBvB,0DAA0D;IAC1D,OAAO,CAAC,KAAK;IAUb,qHAAqH;IACrH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,SAAI,EAAE,KAAK,SAAa,GAAG,IAAI;IAMpF;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM5C;;;OAGG;IACH,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAMlC;;;;OAIG;IACH,OAAO,CAAC,GAAG;IAaX,0HAA0H;IAC1H,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAiExE,OAAO,CAAC,IAAI;IAKZ,mGAAmG;IACnG,OAAO,CAAC,KAAK;IAmBb,OAAO,IAAI,IAAI;CAOhB;AAED,0FAA0F;AAC1F,eAAO,MAAM,QAAQ,OAAO,CAAC;AAE7B,4GAA4G;AAC5G,eAAO,MAAM,aAAa,QAAgB,CAAC"}
+{"version":3,"file":"Darkness.d.ts","sourceRoot":"","sources":["../../../src/pixel/Darkness.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AA2C3C,yGAAyG;AACzG,eAAO,MAAM,UAAU,WAAW,CAAC;AAsEnC,qBAAa,QAAQ;IA4CjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,KAAK;IA7Cf,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,iHAAiH;IACjH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqF;IAC3G,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,EAAE,CAAgB;IAC1B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,gGAAgG;IAChG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAa;IAC/C,8FAA8F;IAC9F,OAAO,CAAC,UAAU,CAAK;IACvB,oHAAoH;IACpH,OAAO,CAAC,KAAK,CAAQ;IACrB,+FAA+F;IAC/F,OAAO,CAAC,KAAK,CAAM;IACnB,0EAA0E;IAC1E,OAAO,CAAC,SAAS,CAAM;IACvB,uCAAuC;IACvC,OAAO,CAAC,OAAO,CAAa;IAC5B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,CAAK;IACf,OAAO,CAAC,EAAE,CAAK;IACf,8EAA8E;IAC9E,OAAO,CAAC,KAAK,CAAM;IACnB,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAAS;IACzB,wFAAwF;IACxF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IAErC,uFAAuF;IACvF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAGX,KAAK,EAAE,KAAK,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACrB,OAAO,GAAE,eAAoB;IAiB/B,0DAA0D;IAC1D,OAAO,CAAC,KAAK;IAUb,qHAAqH;IACrH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,SAAI,EAAE,KAAK,SAAa,GAAG,IAAI;IAMpF;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM5C;;;OAGG;IACH,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAMlC;;;;OAIG;IACH,OAAO,CAAC,GAAG;IAaX;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,aAAa,SAAoB,GAAG,IAAI;IAiEpF,OAAO,CAAC,IAAI;IAKZ,mGAAmG;IACnG,OAAO,CAAC,KAAK;IAmBb,OAAO,IAAI,IAAI;CAOhB;AAED,0FAA0F;AAC1F,eAAO,MAAM,QAAQ,OAAO,CAAC;AAE7B;;;GAGG;AACH,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,MAAM,WAAW,eAAe;IAC9B,6GAA6G;IAC7G,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

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

@@ -0,0 +1,68 @@
+import type { Stage } from '../core/Stage.js';
+/** A mark's look: the bright stroke, the rim/edge tone, the dark pixels round it, and a fill for discs. */
+export interface MarkTone {
+    light: number;
+    rim: number;
+    dark: number;
+    fill: number;
+}
+export interface PixelMarksOptions<T extends string> {
+    /** The looks marks are drawn in, by name (`aim`, `cancel`, `lock`…); every mark names one. */
+    tones: Record<T, MarkTone>;
+    /** Depth of every mark (default 0): usually just over the effects that lie on the ground. */
+    depth?: number;
+    /** Headings a chevron is painted for (default 32, 11.25° apart): each is painted once per size and tone. */
+    headings?: number;
+    /** World pixels between two chevrons of an aim line (default 10). */
+    spacing?: number;
+    /** How fast the chevrons creep along a line, px per ms (default 0.02), so it reads as a direction. */
+    creep?: number;
+    /** Opacity of a disc's fill (default 0.28). */
+    fillAlpha?: number;
+}
+/**
+ * Aim and target marks in the world's own pixels: rings, discs and ground ellipses painted once per size and tone and
+ * only moved after that, and aim lines as a row of chevrons from a pool — a chevron is repainted only when its heading,
+ * size or tone changes. Lines are chevrons, never a solid lane: a solid line of world pixels at most angles is a
+ * staircase and reads as broken, while each chevron is crisp at any angle. The drawing side of `AimGesture` and
+ * `TargetLock`. Each frame: `begin`, place what the frame needs, then `end`, which hides whatever was shown last frame
+ * and not this one.
+ */
+export declare class PixelMarks<T extends string = string> {
+    private readonly stage;
+    private readonly tones;
+    private readonly depth;
+    private readonly headings;
+    private readonly spacing;
+    private readonly creep;
+    private readonly fillAlpha;
+    private readonly cache;
+    private readonly pool;
+    private used;
+    private shown;
+    private next;
+    constructor(stage: Stage, options: PixelMarksOptions<T>);
+    begin(): void;
+    /** A ring of radius `r` round (x, y): the bright line with dark pixels just inside and outside it. */
+    ring(x: number, y: number, r: number, tone: T): void;
+    /** A filled disc of radius `r` with a bright rim and a cross at its middle: where a skill aimed at a spot lands. */
+    disc(x: number, y: number, r: number, tone: T): void;
+    /** A ring on the ground in three-quarter view, `rx` wide and `ry` deep, centred on (x, y) — a body's feet. */
+    groundRing(x: number, y: number, rx: number, ry: number, tone: T): void;
+    /**
+     * An aim line from (x, y) along `angle`, from `start` to `end` px out: chevrons `size` px across every `spacing`,
+     * creeping forward with `now`, and a larger one at the end.
+     */
+    chevrons(now: number, x: number, y: number, angle: number, start: number, end: number, size: number, tone: T): void;
+    /**
+     * One still chevron `dist` px out from (x, y) along `angle`: the way the next blow goes. Unlike `chevrons` it does
+     * not creep, so an arrow always under the feet does not keep catching the eye.
+     */
+    pointer(x: number, y: number, angle: number, dist: number, size: number, tone: T): void;
+    end(): void;
+    destroy(): void;
+    private heading;
+    private chevron;
+    private place;
+}
+//# sourceMappingURL=PixelMarks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PixelMarks.d.ts","sourceRoot":"","sources":["../../../src/pixel/PixelMarks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAG3C,2GAA2G;AAC3G,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM;IACjD,8FAA8F;IAC9F,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC3B,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4GAA4G;IAC5G,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sGAAsG;IACtG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD;;;;;;;GAOG;AACH,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAc7C,OAAO,CAAC,QAAQ,CAAC,KAAK;IAbxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsC;IAC3D,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,IAAI,CAAuB;gBAGhB,KAAK,EAAE,KAAK,EAC7B,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAU/B,KAAK,IAAI,IAAI;IAMb,sGAAsG;IACtG,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAUpD,oHAAoH;IACpH,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAYpD,8GAA8G;IAC9G,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAYvE;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAWnH;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAKvF,GAAG,IAAI,IAAI;IASX,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,OAAO;IAmBf,OAAO,CAAC,KAAK;CAWd"}

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

@@ -0,0 +1,23 @@
+export type PixelPoint = readonly [number, number];
+/** One horizontal run of pixels: row y, from x0 to x1 inclusive. */
+export type PixelRun = readonly [number, number, number];
+/** The outline of a circle of radius `r` round (0, 0), each pixel once (midpoint algorithm, 8-way symmetric). */
+export declare function ringPixels(r: number): PixelPoint[];
+/** A filled disc of radius `r` round (0, 0), one run per row. */
+export declare function discRuns(r: number): PixelRun[];
+/**
+ * The outline of an ellipse `rx` wide and `ry` deep round (0, 0), each pixel once (midpoint algorithm) — a circle on
+ * the ground as a three-quarter view shows it, so a body can stand in the middle of it.
+ */
+export declare function ellipsePixels(rx: number, ry: number): PixelPoint[];
+/**
+ * A chevron (›) pointing along `angle`, its arms `size` px out from the line either side, round (0, 0): the bright
+ * stroke and the dark pixels that rim it. A row of these, evenly spaced, is how an aim line is drawn: each one is
+ * crisp at any angle, and with no continuous edge between them there is no staircase to see — a solid line of world
+ * pixels at, say, 20° is one, and read as broken.
+ */
+export declare function chevronPixels(angle: number, size: number): {
+    lit: PixelPoint[];
+    rim: PixelPoint[];
+};
+//# sourceMappingURL=aimPixels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aimPixels.d.ts","sourceRoot":"","sources":["../../../src/pixel/aimPixels.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACnD,oEAAoE;AACpE,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEzD,iHAAiH;AACjH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CAuBlD;AAED,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE,CAQ9C;AAGD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,EAAE,CA8ClE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,UAAU,EAAE,CAAC;IAAC,GAAG,EAAE,UAAU,EAAE,CAAA;CAAE,CA+BnG"}

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

@@ -11,6 +11,8 @@ export { P as PALETTE } from './palette.js';
 export { art, litOutline, groundShadow, shadeBox, type PropArt } from './propKit.js';
 export { ramp, rampTones, hueShade, outlineOf, registerMaterial, MATERIALS, RAMP_FACTOR_SET, type Material, type BuiltinMaterial, type MaterialLight, type RampFactors, type Ramp, } from './ramp.js';
 export { selectiveOutline } from './selout.js';
+export { ringPixels, discRuns, ellipsePixels, chevronPixels, type PixelPoint, type PixelRun } from './aimPixels.js';
+export { PixelMarks, type MarkTone, type PixelMarksOptions } from './PixelMarks.js';
 /** Pixel shapes on the 1-px world grid: `pixelPaint.ring(g, …)`, `pixelPaint.arc(g, …)`… */
 export * as pixelPaint from './pixelPaint.js';
 /** Colour ramps, grading, dithering and batching under `pixelPaint`. */
@@ -19,9 +21,10 @@ export { registerHandRamps } from './pixelTone.js';
 export { paintLayer, type PaintLayerOptions } from './paintLayer.js';
 export { Evaporation, type DeathPixels } from './Evaporation.js';
 export { spritePixels, NO_PIXELS, PackedPixels, type SpritePixel } from './spritePixels.js';
-export { Darkness, WARM_LIGHT, LAMP_DIM, CARRIED_LIGHT } from './Darkness.js';
+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;AAE5C,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,MAAM,YAAY,CAAC;AAC3E,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/pixel/pixelPaint.d.ts

@@ -40,4 +40,5 @@ export declare function arc(g: Graphics, x: number, y: number, r: number, a0: nu
 export declare function dust(g: Graphics, x: number, y: number, t: number, spread?: number, color?: number): void;
 /** Pixel chunks flung out of (x, y) under gravity (rock, splinters): `ms` after the blow. */
 export declare function debris(g: Graphics, x: number, y: number, count: number, speed: number, ms: number, colors: number[]): void;
+export { spark, tail, pixelOn, type FlightPixel } from './pixelParticles.js';
 //# sourceMappingURL=pixelPaint.d.ts.map

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

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

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

@@ -0,0 +1,21 @@
+import type { Graphics } from '../core/Graphics.js';
+/**
+ * A spark of `size` 1 (one pixel, glinting every third `frame`), 2 (a plus with a lit centre) or 3 (a four-point star
+ * whose arms twinkle with `frame`), shaded from `color`'s ramp, on the 1-px world grid.
+ */
+export declare function spark(g: Graphics, x: number, y: number, color: number, size: 1 | 2 | 3, frame?: number): void;
+/**
+ * A particle's trail: `len` px back from its head (x, y) against its velocity (vx, vy), glint to shade, its far half
+ * broken into every other pixel. `thick` 2 lays a second row under it on the shaded side (down, or right for a trail
+ * running straight up or down) a tone deeper, so the trail has a body; 3 adds a lit row on the up-left side over its
+ * near half. Light comes from the up-left, as on the rest of the art.
+ */
+export declare function tail(g: Graphics, x: number, y: number, vx: number, vy: number, len: number, color: number, thick?: number): void;
+/** Paints one art pixel at (along, across) in the frame of a line through a point, heading an angle. */
+export type FlightPixel = (along: number, across: number, color: number) => void;
+/**
+ * A painter for a projectile drawn the size it really hits at: pixels are given along its heading and across it
+ * (positive across is to the right of the heading), rotated onto the world grid at (x, y). Make one per frame painted.
+ */
+export declare function pixelOn(g: Graphics, x: number, y: number, angle: number): FlightPixel;
+//# sourceMappingURL=pixelParticles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pixelParticles.d.ts","sourceRoot":"","sources":["../../../src/pixel/pixelParticles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAUjD;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,SAAI,GAAG,IAAI,CAYxG;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,IAAI,CAyB3H;AAED,wGAAwG;AACxG,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAEjF;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAIrF"}

package/dist/types/platform/appResume.d.ts

@@ -0,0 +1,25 @@
+/** What `onAppResume` listens on: `document` and `window` in a browser; a test passes its own. */
+export interface ResumeEnv {
+    document?: {
+        readonly visibilityState?: string;
+        addEventListener(type: string, cb: () => void): void;
+        removeEventListener(type: string, cb: () => void): void;
+    };
+    window?: {
+        addEventListener(type: string, cb: (e: {
+            persisted?: boolean;
+        }) => void): void;
+        removeEventListener(type: string, cb: (e: {
+            persisted?: boolean;
+        }) => void): void;
+    };
+    now?: () => number;
+}
+/**
+ * Calls `cb` when the app comes back to the foreground: the tab shown again (`visibilitychange`) or the page restored
+ * from the back/forward cache (`pageshow` with `persisted`). A phone freezes a background tab — timers stop, a socket
+ * may be dead without having closed — so this is the moment to check what survived. `cb` gets how long the app was
+ * hidden, ms (0 when the hiding was not seen). Returns the unsubscribe; does nothing where there is no document.
+ */
+export declare function onAppResume(cb: (hiddenMs: number) => void, env?: ResumeEnv): () => void;
+//# sourceMappingURL=appResume.d.ts.map

package/dist/types/platform/appResume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appResume.d.ts","sourceRoot":"","sources":["../../../src/platform/appResume.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;QAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC;IAChK,MAAM,CAAC,EAAE;QAAE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,KAAK,IAAI,GAAG,IAAI,CAAC;QAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,KAAK,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC;IAC/K,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EAAE,GAAG,GAAE,SAAmC,GAAG,MAAM,IAAI,CAwBhH"}

package/dist/types/platform/fullscreen.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Fullscreen through the standard API, with the `webkit` names older Safari (and iPadOS before 16.4) still use. Where
+ * neither exists (iPhone Safari never offers an element fullscreen) every call is a safe no-op: `enterFullscreen`
+ * resolves false and `isFullscreen` stays false, so a game can show its button only when `fullscreenSupported()`.
+ */
+/** The slice of `Document` the helpers read; tests pass their own. */
+export interface FullscreenDocument {
+    readonly fullscreenElement?: Element | null;
+    readonly webkitFullscreenElement?: Element | null;
+    readonly fullscreenEnabled?: boolean;
+    readonly webkitFullscreenEnabled?: boolean;
+    readonly documentElement?: Element;
+    exitFullscreen?(): Promise<void>;
+    webkitExitFullscreen?(): void;
+    addEventListener(type: string, fn: () => void): void;
+    removeEventListener(type: string, fn: () => void): void;
+}
+/** True when this page may put an element in fullscreen at all. */
+export declare function fullscreenSupported(doc?: FullscreenDocument | null): boolean;
+/** True while something is in fullscreen. */
+export declare function isFullscreen(doc?: FullscreenDocument | null): boolean;
+/**
+ * Puts `element` (default the whole page) in fullscreen; resolves true once it is. Browsers allow it only inside a
+ * user gesture, so call it from a click or key handler. A refusal resolves false instead of throwing: a game's
+ * fullscreen button should never take the frame down with it.
+ */
+export declare function enterFullscreen(element?: Element, doc?: FullscreenDocument | null): Promise<boolean>;
+/** Leaves fullscreen; resolves false when nothing was in it or the browser refused. */
+export declare function exitFullscreen(doc?: FullscreenDocument | null): Promise<boolean>;
+/** Enters or leaves; resolves whether the page is in fullscreen afterwards (as far as the call could tell). */
+export declare function toggleFullscreen(element?: Element, doc?: FullscreenDocument | null): Promise<boolean>;
+/**
+ * Calls `fn(isFullscreen)` whenever the page enters or leaves fullscreen — by the game or by the player pressing Esc,
+ * which no game code sees otherwise. Returns the unsubscribe.
+ */
+export declare function onFullscreenChange(fn: (fullscreen: boolean) => void, doc?: FullscreenDocument | null): () => void;
+//# sourceMappingURL=fullscreen.d.ts.map

package/dist/types/platform/fullscreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fullscreen.d.ts","sourceRoot":"","sources":["../../../src/platform/fullscreen.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,cAAc,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,oBAAoB,CAAC,IAAI,IAAI,CAAC;IAC9B,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACrD,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACzD;AAWD,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,kBAAkB,GAAG,IAAwB,GAAG,OAAO,CAE/F;AAED,6CAA6C;AAC7C,wBAAgB,YAAY,CAAC,GAAG,GAAE,kBAAkB,GAAG,IAAwB,GAAG,OAAO,CAGxF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,GAAE,kBAAkB,GAAG,IAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,CAY7H;AAED,uFAAuF;AACvF,wBAAsB,cAAc,CAAC,GAAG,GAAE,kBAAkB,GAAG,IAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,CAUzG;AAED,+GAA+G;AAC/G,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,GAAE,kBAAkB,GAAG,IAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,CAG9H;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,EAAE,GAAG,GAAE,kBAAkB,GAAG,IAAwB,GAAG,MAAM,IAAI,CASpI"}

package/dist/types/platform/orientation.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Locks the screen's orientation where the platform allows it: Android Chrome in fullscreen or as an installed app,
+ * Electron and Capacitor shells. Desktop browsers and iPhone Safari refuse or lack the API; then `lockOrientation`
+ * resolves false, so a game asks once and falls back to a "turn your phone" hint without try/catch of its own.
+ */
+export type OrientationLock = 'any' | 'natural' | 'landscape' | 'portrait' | 'portrait-primary' | 'portrait-secondary' | 'landscape-primary' | 'landscape-secondary';
+/** The slice of `ScreenOrientation` used here (`lock` is missing from some DOM typings); tests pass their own. */
+export interface OrientationTarget {
+    readonly type?: string;
+    lock?(orientation: OrientationLock): Promise<void>;
+    unlock?(): void;
+}
+/** Resolves true once the screen is locked to `orientation`, false where the platform refuses or cannot. */
+export declare function lockOrientation(orientation: OrientationLock, target?: OrientationTarget | null): Promise<boolean>;
+/** Lets the screen turn freely again; a no-op where nothing could be locked. */
+export declare function unlockOrientation(target?: OrientationTarget | null): void;
+/** 'landscape', 'portrait', or null where the platform does not say. */
+export declare function currentOrientationKind(target?: OrientationTarget | null): 'landscape' | 'portrait' | null;
+//# sourceMappingURL=orientation.d.ts.map

package/dist/types/platform/orientation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orientation.d.ts","sourceRoot":"","sources":["../../../src/platform/orientation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,kBAAkB,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,qBAAqB,CAAC;AAErK,kHAAkH;AAClH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,CAAC,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,CAAC,IAAI,IAAI,CAAC;CACjB;AAOD,4GAA4G;AAC5G,wBAAsB,eAAe,CAAC,WAAW,EAAE,eAAe,EAAE,MAAM,GAAE,iBAAiB,GAAG,IAA2B,GAAG,OAAO,CAAC,OAAO,CAAC,CAS7I;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,iBAAiB,GAAG,IAA2B,GAAG,IAAI,CAM/F;AAED,wEAAwE;AACxE,wBAAgB,sBAAsB,CAAC,MAAM,GAAE,iBAAiB,GAAG,IAA2B,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,CAK/H"}

package/dist/types/platform/pointerLock.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Pointer lock for mouse-look and twin-stick aiming with the mouse: the cursor hides and movement comes as
+ * `movementX`/`movementY` deltas. Browsers grant it only inside a user gesture and the player can always leave it with
+ * Esc, so a game listens with `onPointerLockChange` rather than assuming it holds.
+ */
+/** The slice of `Document` used here; tests pass their own. */
+export interface PointerLockDocument {
+    readonly pointerLockElement?: Element | null;
+    exitPointerLock?(): void;
+    addEventListener(type: string, fn: () => void): void;
+    removeEventListener(type: string, fn: () => void): void;
+}
+/** True while `element` (or, with none named, anything) holds the pointer. */
+export declare function isPointerLocked(element?: Element, doc?: PointerLockDocument | null): boolean;
+/**
+ * Asks to lock the pointer to `element` (the game canvas); resolves whether it holds afterwards. `raw` asks for
+ * unaccelerated movement where the browser offers it, and falls back to the plain lock where it refuses that option.
+ */
+export declare function requestPointerLock(element: Element, options?: {
+    raw?: boolean;
+}, doc?: PointerLockDocument | null): Promise<boolean>;
+/** Releases the pointer; a no-op when nothing holds it. */
+export declare function exitPointerLock(doc?: PointerLockDocument | null): void;
+/** Calls `fn(locked)` whenever the lock is taken or lost (Esc included). Returns the unsubscribe. */
+export declare function onPointerLockChange(fn: (locked: boolean) => void, doc?: PointerLockDocument | null): () => void;
+//# sourceMappingURL=pointerLock.d.ts.map

package/dist/types/platform/pointerLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointerLock.d.ts","sourceRoot":"","sources":["../../../src/platform/pointerLock.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+DAA+D;AAC/D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C,eAAe,CAAC,IAAI,IAAI,CAAC;IACzB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACrD,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACzD;AAUD,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,GAAE,mBAAmB,GAAG,IAAwB,GAAG,OAAO,CAG/G;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,EAAE,GAAG,GAAE,mBAAmB,GAAG,IAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,CAcjK;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,GAAG,GAAE,mBAAmB,GAAG,IAAwB,GAAG,IAAI,CAEzF;AAED,qGAAqG;AACrG,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,GAAG,GAAE,mBAAmB,GAAG,IAAwB,GAAG,MAAM,IAAI,CAKlI"}

package/dist/types/platform/reducedMotion.d.ts

@@ -0,0 +1,20 @@
+/** The slice of `MediaQueryList` used here; tests pass their own. */
+export interface MotionQuery {
+    readonly matches: boolean;
+    addEventListener?(type: 'change', fn: () => void): void;
+    removeEventListener?(type: 'change', fn: () => void): void;
+    /** Safari before 14 only has the old names. */
+    addListener?(fn: () => void): void;
+    removeListener?(fn: () => void): void;
+}
+/** True when the system asks for reduced motion; false where it cannot be read. */
+export declare function prefersReducedMotion(query?: MotionQuery | null): boolean;
+/** Calls `fn(reduced)` when the system setting changes (not at once). Returns the unsubscribe. */
+export declare function onReducedMotionChange(fn: (reduced: boolean) => void, query?: MotionQuery | null): () => void;
+/**
+ * Sets `engineSettings.reducedFx` from the system setting now and whenever it changes. Returns the unsubscribe; the
+ * setting keeps its last value afterwards. A game with its own "reduced effects" toggle should not call this, or
+ * the system would overwrite the player's choice — mirror its own store instead.
+ */
+export declare function followReducedMotion(query?: MotionQuery | null): () => void;
+//# sourceMappingURL=reducedMotion.d.ts.map

package/dist/types/platform/reducedMotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducedMotion.d.ts","sourceRoot":"","sources":["../../../src/platform/reducedMotion.ts"],"names":[],"mappings":"AAUA,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACxD,mBAAmB,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC3D,+CAA+C;IAC/C,WAAW,CAAC,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACnC,cAAc,CAAC,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACvC;AAMD,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,KAAK,GAAE,WAAW,GAAG,IAAqB,GAAG,OAAO,CAExF;AAED,kGAAkG;AAClG,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,EAAE,KAAK,GAAE,WAAW,GAAG,IAAqB,GAAG,MAAM,IAAI,CAS5H;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,GAAE,WAAW,GAAG,IAAqB,GAAG,MAAM,IAAI,CAI1F"}

package/dist/types/platform/timeoutSignal.d.ts

@@ -0,0 +1,6 @@
+/**
+ * An `AbortSignal` that aborts after `ms` — `AbortSignal.timeout`, which iOS Safari only has from 16 and older
+ * WebViews not at all: there an `AbortController` and a timer stand in, aborting with the same `TimeoutError`.
+ */
+export declare function timeoutSignal(ms: number): AbortSignal;
+//# sourceMappingURL=timeoutSignal.d.ts.map

package/dist/types/platform/timeoutSignal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeoutSignal.d.ts","sourceRoot":"","sources":["../../../src/platform/timeoutSignal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAQrD"}

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"}