1681-engine 0.5.9 → 0.6.0

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

@@ -1,4 +1,5 @@
 import { type CollisionGrid, type CollisionGridOptions } from '../net/movement.js';
+import type { LdtkIntGrid } from './ldtk.js';
 import { type TileMap } from './tiled.js';
 export interface TiledCollisionOptions extends Omit<CollisionGridOptions, 'ground'> {
     /**
@@ -13,4 +14,11 @@ export interface TiledCollisionOptions extends Omit<CollisionGridOptions, 'groun
 }
 /** The `CollisionGrid` of a Tiled map, for `stepMover`; cells are the map's tiles. */
 export declare function collisionFromTiled(map: TileMap, options?: TiledCollisionOptions): CollisionGrid;
+/** Which IntGrid cells are solid: a list of values, or a test given the value and the name LDtk gives it. */
+export type IntGridSolid = readonly number[] | ((value: number, name: string | undefined) => boolean);
+/**
+ * The `CollisionGrid` of an LDtk IntGrid layer, for `stepMover`: the same grid `collisionFromTiled` builds, so movement,
+ * `navGridFromCollision` and `tileBodiesFromGrid` treat both editors' maps alike. `solid` says which values block.
+ */
+export declare function collisionFromIntGrid(grid: LdtkIntGrid, solid: IntGridSolid, options?: Omit<CollisionGridOptions, 'ground'>): CollisionGrid;
 //# sourceMappingURL=collision.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"collision.d.ts","sourceRoot":"","sources":["../../../src/tilemap/collision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACrG,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAEtD,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC;IACjF;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,qBAA0B,GAAG,aAAa,CAsBnG"}
+{"version":3,"file":"collision.d.ts","sourceRoot":"","sources":["../../../src/tilemap/collision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACrG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAEtD,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC;IACjF;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,qBAA0B,GAAG,aAAa,CAsBnG;AAED,6GAA6G;AAC7G,MAAM,MAAM,YAAY,GAAG,SAAS,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,CAAC;AAEtG;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAM,GAAG,aAAa,CAW9I"}

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

@@ -0,0 +1,97 @@
+/**
+ * Projects made in LDtk (https://ldtk.io), read into the same `TileMap` a Tiled map becomes, so `TilemapView` draws
+ * an LDtk level and `collisionFromTiled` / `objectsOf` work on it unchanged. What LDtk has and Tiled has not —
+ * IntGrid values, entity fields with their full JSON, world positions — rides beside the map on `LdtkLevel`.
+ *
+ * Pure: no Pixi, no DOM. The parser is `parseLdtk` (in `ldtkParse.ts`); this file holds the model and its helpers.
+ */
+import type { TileMap, Tileset } from './tiled.js';
+/** A field's value as LDtk exports it: a number, string, boolean, null, a point `{ cx, cy }`, an entity ref, an array… */
+export type LdtkFieldValue = unknown;
+/** `Free` and `GridVania` place levels by hand; the `Linear*` layouts line them up in order. */
+export type LdtkWorldLayout = 'Free' | 'GridVania' | 'LinearHorizontal' | 'LinearVertical';
+/** One IntGrid layer's values: what a level says each cell is (wall, water, ladder…), drawn or not. */
+export interface LdtkIntGrid {
+    name: string;
+    width: number;
+    height: number;
+    gridSize: number;
+    /** Row-major values, 0 = empty. */
+    values: Int32Array;
+    /** The identifier LDtk gives each value (`1 → "wall"`); values named nothing are absent. */
+    names: Map<number, string>;
+    offsetX: number;
+    offsetY: number;
+}
+export interface LdtkEntity {
+    iid: string;
+    /** The entity definition's identifier (`Player`, `Chest`…). */
+    identifier: string;
+    /** The pivot point in level px (the layer's offset included): where LDtk shows the entity standing. */
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    pivotX: number;
+    pivotY: number;
+    /** The grid cell it stands in. */
+    cx: number;
+    cy: number;
+    tags: string[];
+    /** Every field instance by identifier, as exported (`Point`s, arrays and entity refs included). */
+    fields: Record<string, LdtkFieldValue>;
+    /** The layer it was placed on. */
+    layer: string;
+}
+export interface LdtkLevel {
+    identifier: string;
+    iid: string;
+    uid: number;
+    /** The level's top-left corner in world px (worked out for the `Linear*` layouts, which store -1). */
+    worldX: number;
+    worldY: number;
+    worldDepth: number;
+    pxWidth: number;
+    pxHeight: number;
+    bgColor: string;
+    fields: Record<string, LdtkFieldValue>;
+    /**
+     * The level as a `TileMap`: one tile layer per Tiles, AutoLayer and auto-tiled IntGrid layer (a layer stacking
+     * several tiles in a cell is split into `name`, `name#1`… drawn above it), one object layer per Entities layer, in
+     * draw order (LDtk lists its layers top first; here the bottom comes first, as in Tiled).
+     */
+    map: TileMap;
+    intGrids: Map<string, LdtkIntGrid>;
+    entities: LdtkEntity[];
+    /** The separate `.ldtkl` file this level lives in, relative to the project, when the project saves levels apart. */
+    externalRelPath?: string;
+    /** False for an external level whose file was not handed to `parseLdtk`: everything but its layers is known. */
+    loaded: boolean;
+}
+export interface LdtkWorld {
+    identifier: string;
+    iid: string;
+    layout: LdtkWorldLayout;
+    gridWidth: number;
+    gridHeight: number;
+    levels: LdtkLevel[];
+}
+export interface LdtkProject {
+    jsonVersion: string;
+    defaultGridSize: number;
+    bgColor: string;
+    /** Every tileset with an image, gids allotted in definition order (the same in every level's `map`). */
+    tilesets: Tileset[];
+    /** One world, or several in a multi-worlds project. */
+    worlds: LdtkWorld[];
+    /** Every level of every world. */
+    levels: LdtkLevel[];
+}
+export declare function levelByName(project: LdtkProject, identifier: string): LdtkLevel | undefined;
+/** The level whose rectangle holds world point (x, y), the deepest-listed first; null between levels. */
+export declare function levelAt(levels: readonly LdtkLevel[], x: number, y: number, depth?: number): LdtkLevel | null;
+/** An IntGrid cell's value; 0 outside the grid. */
+export declare function intGridAt(grid: LdtkIntGrid, cx: number, cy: number): number;
+/** Every entity of a level (optionally only one identifier). */
+export declare function entitiesOf(level: LdtkLevel, identifier?: string): LdtkEntity[];
+//# sourceMappingURL=ldtk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ldtk.d.ts","sourceRoot":"","sources":["../../../src/tilemap/ldtk.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEhD,0HAA0H;AAC1H,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC;AAErC,gGAAgG;AAChG,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,kBAAkB,GAAG,gBAAgB,CAAC;AAE3F,uGAAuG;AACvG,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,4FAA4F;IAC5F,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,uGAAuG;IACvG,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,mGAAmG;IACnG,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,sGAAsG;IACtG,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC;;;;OAIG;IACH,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,oHAAoH;IACpH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gHAAgH;IAChH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,wGAAwG;IACxG,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,uDAAuD;IACvD,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,kCAAkC;IAClC,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE3F;AAED,yGAAyG;AACzG,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAM5G;AAED,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAG3E;AAED,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CAE9E"}

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

@@ -0,0 +1,26 @@
+/**
+ * The LDtk reader: a project's JSON (and its `.ldtkl` level files, when it saves levels apart) into `LdtkProject`.
+ * Supported: IntGrid, AutoLayer, Tiles and Entities layers; tilesets with an image; tile custom data and enum tags
+ * (as tile properties); entity and level fields; Free, GridVania and Linear world layouts; multi-worlds projects.
+ * Not drawn: the IntGrid colours of a layer with no tileset, the embedded icon atlas, level backgrounds.
+ *
+ * Pure: no Pixi, no DOM.
+ */
+import type { LdtkLevel, LdtkProject } from './ldtk.js';
+/** The `.ldtkl` files a project saves its levels in, relative to the project file; empty when levels are inline. */
+export declare function ldtkExternalLevels(json: unknown): string[];
+export interface LdtkParseOptions {
+    /**
+     * The parsed JSON of each external level file, by the `externalRelPath` the project names it with
+     * (`ldtkExternalLevels` lists them). A level left out stays `loaded: false`, so levels can be streamed in later.
+     */
+    levels?: Record<string, unknown> | ((relPath: string) => unknown);
+}
+/** Reads an LDtk project (already `JSON.parse`d). Throws an `LDtk project: …` error saying what is wrong. */
+export declare function parseLdtk(json: unknown, options?: LdtkParseOptions): LdtkProject;
+/**
+ * Reads one external level file into a level `parseLdtk` left unloaded (`loaded: false`), for projects that stream
+ * their levels. Returns the same level, now loaded.
+ */
+export declare function loadLdtkLevel(project: LdtkProject, projectJson: unknown, level: LdtkLevel, levelJson: unknown): LdtkLevel;
+//# sourceMappingURL=ldtkParse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ldtkParse.d.ts","sourceRoot":"","sources":["../../../src/tilemap/ldtkParse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAA2C,SAAS,EAAE,WAAW,EAA8B,MAAM,QAAQ,CAAC;AAoC1H,oHAAoH;AACpH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAM1D;AAwMD,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;CACnE;AAED,6GAA6G;AAC7G,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,WAAW,CA6BpF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,GAAG,SAAS,CAMzH"}

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * `1681-engine/updates`: file-by-file web updates from a release store, the pure half — the feed's shapes, which web
+ * to take, and what to copy or download to build it. No Node, DOM or Electron: shared by the desktop shell
+ * (`1681-engine/electron`), a browser build and the phone apps.
+ */
+export { isNewer, safePath, isSha256, validManifest, fileUrl, type WebFile, type WebManifest, type LatestJson, type ReleaseFile, } from './manifest.js';
+export { planWeb, type WebPlan } from './webPlan.js';
+export { pickWebUpdate, apkUpdateOf, pluginEntries, heldBundle, type WebBundle, type NewerRelease, type PluginEntry } from './pickUpdate.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/updates/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,OAAO,EACP,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/updates/manifest.d.ts

@@ -0,0 +1,74 @@
+/**
+ * The shapes of a release store's feed for file-by-file web updates, and the rules for trusting one. One definition
+ * for every client that reads it: the desktop shell's patcher (`1681-engine/electron`), a browser build and the phone
+ * apps' over-the-air updater. A publish script writes, per channel:
+ *
+ * - `<channel>/latest.json` ({@link LatestJson}): the newest build and where its pieces lie, as paths under the channel,
+ *   written last so a client never reads a release that is half up;
+ * - `<channel>/web/<version>.json` ({@link WebManifest}): every file of the built web with its sha256;
+ * - `<channel>/files/<sha256>`: each content once, so a release uploads and a client downloads only what is new.
+ *
+ * Kept pure (no Node, no DOM, no Electron) so a phone's web view and an Electron main process share it.
+ */
+/** One file of a built web, as the manifest lists it. */
+export interface WebFile {
+    /** Relative to the web's root, forward slashes (`assets/index-3f2a.js`). */
+    path: string;
+    /** Lower-case hex sha256 of the content; also its name under `<channel>/files/`. */
+    sha256: string;
+    size: number;
+}
+/** `<channel>/web/<version>.json`. */
+export interface WebManifest {
+    version: string;
+    /**
+     * The desktop shell this web needs (`shellId` in `1681-engine/electron`): a web talks to its shell through a
+     * preload script and may need what a newer shell adds, so any other shell takes the installer instead.
+     */
+    shell: string;
+    /** The lowest native build of the phone apps this web needs: a web calling a plugin the app lacks must never reach it. */
+    minNative: number;
+    files: WebFile[];
+}
+/** A packaged download listed in `latest.json` (an APK, an installer). */
+export interface ReleaseFile {
+    file: string;
+    size: number;
+    sha256?: string;
+}
+/** `<channel>/latest.json`. */
+export interface LatestJson {
+    version: string;
+    date?: string;
+    /** The build's web: its manifest's path under the channel, the shell and native build it needs. */
+    web?: {
+        manifest: string;
+        shell: string;
+        minNative: number;
+    };
+    /** The Android package, when the channel publishes one. */
+    apk?: {
+        file: string;
+        size: number;
+        sha256: string;
+    };
+    /** Desktop installers by platform key (the publisher names the keys, e.g. `win`, `macArm`, `macX64`). */
+    desktop?: Record<string, ReleaseFile | undefined>;
+}
+/** Whether version `a` ("0.5.23", "v0.5.23") is newer than `b`, number by number; a missing part counts 0. */
+export declare function isNewer(a: string, b: string): boolean;
+/**
+ * A path a manifest may name: relative, forward slashes, no `.` or `..` segment, no NUL — nothing that could write
+ * outside the web's own folder once joined to it.
+ */
+export declare function safePath(p: string): boolean;
+/** Whether `s` is a lower-case hex sha256. */
+export declare function isSha256(s: unknown): s is string;
+/**
+ * A manifest whose shape may be trusted: every path safe and listed once, every hash a sha256, every size a number,
+ * and an `index.html` (a web without one cannot be loaded, and a truncated upload is the usual way to get one).
+ */
+export declare function validManifest(m: unknown): m is WebManifest;
+/** Where a content lies in the store: `<channelUrl>/files/<sha256>`. */
+export declare function fileUrl(channelUrl: string, sha256: string): string;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/types/updates/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/updates/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,yDAAyD;AACzD,MAAM,WAAW,OAAO;IACtB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,0HAA0H;IAC1H,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mGAAmG;IACnG,GAAG,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,2DAA2D;IAC3D,GAAG,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,yGAAyG;IACzG,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC,CAAC;CACnD;AAED,8GAA8G;AAC9G,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CASrD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAG3C;AAID,8CAA8C;AAC9C,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAU1D;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAElE"}

package/dist/types/updates/pickUpdate.d.ts

@@ -0,0 +1,43 @@
+import { type LatestJson } from './manifest.js';
+/** A web a client may take: its version, its manifest's full URL and the native build it needs. */
+export interface WebBundle {
+    version: string;
+    manifestUrl: string;
+    minNative: number;
+}
+/**
+ * The web to take from `latest`: newer than the web running (`webVersion`), and needing no native code this app lacks
+ * (`nativeBuild` ≥ the web's `minNative`). A browser or desktop build with no native layer passes `Infinity`.
+ */
+export declare function pickWebUpdate(latest: LatestJson, channelUrl: string, webVersion: string, nativeBuild: number): WebBundle | null;
+/** A newer build than this one, and where its Android package downloads from. */
+export interface NewerRelease {
+    version: string;
+    apkUrl: string;
+}
+/**
+ * The build's APK, when it is newer than this client and its web cannot come over the air instead (`webBundle` is
+ * what {@link pickWebUpdate} found): the package is the slow road, for native changes.
+ */
+export declare function apkUpdateOf(latest: LatestJson, channelUrl: string, clientVersion: string, webBundle: WebBundle | null): NewerRelease | null;
+/** One entry of a multi-file bundle download, in the shape `@capgo/capacitor-updater`'s `ManifestEntry` takes. */
+export interface PluginEntry {
+    file_name: string;
+    file_hash: string;
+    download_url: string;
+}
+/**
+ * A phone updater's download list for `manifest`, or null when the manifest is not one to trust (another version, an
+ * unsafe or repeated path, a bad hash, no `index.html`). The updater checks each file against its hash and reuses
+ * every file it already holds, so only new content is fetched.
+ */
+export declare function pluginEntries(manifest: unknown, version: string, channelUrl: string): PluginEntry[] | null;
+/**
+ * A copy of `bundle` the updater already holds whole (downloaded and checked, applied or waiting), so asking again —
+ * a settings screen's check after the login screen's — takes it instead of downloading the same files twice.
+ */
+export declare function heldBundle<T extends {
+    version: string;
+    status: string;
+}>(held: readonly T[], bundle: WebBundle): T | null;
+//# sourceMappingURL=pickUpdate.d.ts.map

package/dist/types/updates/pickUpdate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickUpdate.d.ts","sourceRoot":"","sources":["../../../src/updates/pickUpdate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,UAAU,EAAoB,MAAM,YAAY,CAAC;AAErG,mGAAmG;AACnG,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAI/H;AAED,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,YAAY,GAAG,IAAI,CAG3I;AAED,kHAAkH;AAClH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,IAAI,CAW1G;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,GAAG,CAAC,GAAG,IAAI,CAEzH"}

package/dist/types/updates/webPlan.d.ts

@@ -0,0 +1,21 @@
+import type { WebFile, WebManifest } from './manifest.js';
+/** What building a new web takes, given the files a client already holds. */
+export interface WebPlan {
+    /** Files taken from the web held now: `from` is their path there. */
+    copy: {
+        path: string;
+        from: string;
+    }[];
+    /** Files to fetch from `<channel>/files/<sha256>`; content shared by several paths appears once per path. */
+    download: WebFile[];
+    /** Bytes to download, each distinct content counted once. */
+    bytes: number;
+}
+/**
+ * What to copy and what to download for `target`, given the web held now (`have`: path → sha256): a file whose path
+ * holds the same content is copied from there, one whose content lies under another path (a bundler renamed it) is
+ * copied from that path, and only content found nowhere is downloaded — once, however many paths share it. This is
+ * what makes a patch cost only what changed, the way a game launcher patches.
+ */
+export declare function planWeb(target: WebManifest, have: ReadonlyMap<string, string>): WebPlan;
+//# sourceMappingURL=webPlan.d.ts.map

package/dist/types/updates/webPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webPlan.d.ts","sourceRoot":"","sources":["../../../src/updates/webPlan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEvD,6EAA6E;AAC7E,MAAM,WAAW,OAAO;IACtB,qEAAqE;IACrE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvC,6GAA6G;IAC7G,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAoBvF"}

package/dist/ui/ScrollView.js

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

package/dist/updates/manifest.js

@@ -0,0 +1,35 @@
+function u(t, e) {
+  const r = (s) => s.replace(/^v/, "").split(".").map((i) => Number.parseInt(i, 10) || 0), n = r(t), f = r(e);
+  for (let s = 0; s < Math.max(n.length, f.length); s++) {
+    const i = (n[s] ?? 0) - (f[s] ?? 0);
+    if (i !== 0) return i > 0;
+  }
+  return !1;
+}
+function a(t) {
+  return !t || t.startsWith("/") || t.includes("\\") || t.includes("\0") ? !1 : t.split("/").every((e) => e !== "" && e !== "." && e !== "..");
+}
+const o = /^[0-9a-f]{64}$/;
+function l(t) {
+  return typeof t == "string" && o.test(t);
+}
+function c(t) {
+  const e = t;
+  if (!e || typeof e.version != "string" || typeof e.shell != "string" || !Array.isArray(e.files)) return !1;
+  const r = /* @__PURE__ */ new Set();
+  for (const n of e.files) {
+    if (!n || typeof n.path != "string" || !a(n.path) || r.has(n.path) || !l(n.sha256) || typeof n.size != "number") return !1;
+    r.add(n.path);
+  }
+  return r.has("index.html");
+}
+function h(t, e) {
+  return `${t}/files/${e}`;
+}
+export {
+  h as fileUrl,
+  u as isNewer,
+  l as isSha256,
+  a as safePath,
+  c as validManifest
+};

package/dist/updates/pickUpdate.js

@@ -0,0 +1,27 @@
+import { isNewer as o, safePath as u, isSha256 as f, fileUrl as l } from "./manifest.js";
+function h(n, s, e, r) {
+  const t = n.web;
+  return !t || !o(n.version, e) || r < t.minNative ? null : { version: n.version, manifestUrl: `${s}/${t.manifest}`, minNative: t.minNative };
+}
+function c(n, s, e, r) {
+  return r || !n.apk || !o(n.version, e) ? null : { version: n.version, apkUrl: `${s}/${n.apk.file}` };
+}
+function v(n, s, e) {
+  const r = n;
+  if (!r || r.version !== s || !Array.isArray(r.files)) return null;
+  const t = [], a = /* @__PURE__ */ new Set();
+  for (const i of r.files) {
+    if (!i || typeof i.path != "string" || !u(i.path) || a.has(i.path) || !f(i.sha256)) return null;
+    a.add(i.path), t.push({ file_name: i.path, file_hash: i.sha256, download_url: l(e, i.sha256) });
+  }
+  return a.has("index.html") ? t : null;
+}
+function d(n, s) {
+  return n.find((e) => e.version === s.version && (e.status === "pending" || e.status === "success")) ?? null;
+}
+export {
+  c as apkUpdateOf,
+  d as heldBundle,
+  h as pickWebUpdate,
+  v as pluginEntries
+};

package/dist/updates/webPlan.js

@@ -0,0 +1,14 @@
+function c(p, o) {
+  const e = /* @__PURE__ */ new Map();
+  for (const [t, s] of o) e.has(s) || e.set(s, t);
+  const h = [], a = [], f = /* @__PURE__ */ new Set();
+  let n = 0;
+  for (const t of p.files) {
+    const s = e.get(t.sha256);
+    o.get(t.path) === t.sha256 ? h.push({ path: t.path, from: t.path }) : s !== void 0 ? h.push({ path: t.path, from: s }) : (a.push(t), f.has(t.sha256) || (f.add(t.sha256), n += t.size));
+  }
+  return { copy: h, download: a, bytes: n };
+}
+export {
+  c as planWeb
+};

package/dist/updates.js

@@ -0,0 +1,15 @@
+import { fileUrl as p, isNewer as r, isSha256 as i, safePath as t, validManifest as f } from "./updates/manifest.js";
+import { planWeb as o } from "./updates/webPlan.js";
+import { apkUpdateOf as n, heldBundle as s, pickWebUpdate as h, pluginEntries as m } from "./updates/pickUpdate.js";
+export {
+  n as apkUpdateOf,
+  p as fileUrl,
+  s as heldBundle,
+  r as isNewer,
+  i as isSha256,
+  h as pickWebUpdate,
+  o as planWeb,
+  m as pluginEntries,
+  t as safePath,
+  f as validManifest
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "1681-engine",
-  "version": "0.5.9",
+  "version": "0.6.0",
   "description": "A 2D game engine on PixiJS 8 for any art style: scenes and a fast ECS, a fixed-step loop, asset loading, Tiled maps, sprite animation, input actions, camera follow, audio and deterministic, server-replayable movement, plus Dither, an optional pixel-art module (pixel-perfect effects, dithered lighting).",
   "type": "module",
   "types": "./dist/types/index.d.ts",
@@ -33,14 +33,39 @@
       "types": "./dist/types/pixel/pixelPaint.d.ts",
       "import": "./dist/pixel/pixelPaint.js"
     },
+    "./updates": {
+      "import": {
+        "types": "./dist/types/updates/index.d.ts",
+        "default": "./dist/updates.js"
+      },
+      "require": {
+        "types": "./dist/cjs/updates/index.d.ts",
+        "default": "./dist/cjs/updates/index.js"
+      }
+    },
+    "./electron": {
+      "import": {
+        "types": "./dist/types/electron/index.d.ts",
+        "default": "./dist/electron.js"
+      },
+      "require": {
+        "types": "./dist/cjs/electron/index.d.ts",
+        "default": "./dist/cjs/electron/index.js"
+      }
+    },
+    "./mobile": {
+      "types": "./dist/types/mobile/index.d.ts",
+      "import": "./dist/mobile.js"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {
     "dev": "vite",
-    "build": "npm run clean && vite build && tsc -p tsconfig.build.json && node scripts/fix-dts-extensions.mjs",
+    "build": "npm run clean && vite build && tsc -p tsconfig.build.json && node scripts/fix-dts-extensions.mjs && tsc -p tsconfig.cjs.json && node scripts/mark-cjs.mjs",
     "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
     "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
     "test": "node scripts/test.mjs",
+    "test:browser": "vitest run --config vitest.browser.config.ts",
     "check": "npm run typecheck && npm test && npm run build",
     "prepublishOnly": "npm run check",
     "bench": "node --expose-gc --import tsx bench/ecs.bench.ts",
@@ -57,7 +82,9 @@
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
     "@types/ws": "^8.18.2",
+    "@vitest/browser-playwright": "^4.1.11",
     "pixi.js": "^8.21.0",
+    "playwright": "^1.64.0",
     "react": "^19.3.0",
     "react-dom": "^19.3.0",
     "tsx": "^4.20.5",
@@ -67,6 +94,7 @@
     "typescript": "^5.9.2",
     "vite": "^7.1.4",
     "vitepress": "^1.6.4",
+    "vitest": "^4.1.11",
     "ws": "^8.22.0"
   },
   "license": "MIT",
@@ -92,7 +120,8 @@
   "peerDependencies": {
     "pixi.js": "^8.6.0",
     "react": "^19.0.0",
-    "react-dom": "^19.0.0"
+    "react-dom": "^19.0.0",
+    "electron": ">=28.0.0"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -100,6 +129,9 @@
     },
     "react-dom": {
       "optional": true
+    },
+    "electron": {
+      "optional": true
     }
   },
   "repository": {