1681-engine 0.5.8 → 0.5.10

package/dist/types/core/Pointer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pointer.d.ts","sourceRoot":"","sources":["../../../src/core/Pointer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAQvC;;;GAGG;AACH,qBAAa,OAAO;IAeN,OAAO,CAAC,QAAQ,CAAC,MAAM;IAdnC;;;OAGG;IACH,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,GAAG,IAAI,CAAQ;IAEjE,6DAA6D;IAC7D,CAAC,SAAK;IACN,CAAC,SAAK;IACN,MAAM,SAAK;IACX,MAAM,SAAK;IACX,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;gBAEjB,MAAM,EAAE,iBAAiB;IAiCtD,cAAc,IAAI,OAAO;IAIzB,eAAe,IAAI,OAAO;IAI1B,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKnC,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,KAAK;CAKd"}
+{"version":3,"file":"Pointer.d.ts","sourceRoot":"","sources":["../../../src/core/Pointer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AASvC;;;GAGG;AACH,qBAAa,OAAO;IAkBN,OAAO,CAAC,QAAQ,CAAC,MAAM;IAjBnC;;;OAGG;IACH,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,GAAG,IAAI,CAAQ;IAEjE,6DAA6D;IAC7D,CAAC,SAAK;IACN,CAAC,SAAK;IACN,MAAM,SAAK;IACX,MAAM,SAAK;IACX,OAAO,CAAC,OAAO,CAAK;IACpB,oHAAoH;IACpH,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;gBAEjB,MAAM,EAAE,iBAAiB;IAqCtD,cAAc,IAAI,OAAO;IAIzB,eAAe,IAAI,OAAO;IAI1B,wDAAwD;IACxD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;OAGG;IACH,IAAI,CAAC,OAAO,GAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAKvD,MAAM,IAAI,IAAI;IAId,0GAA0G;IAC1G,YAAY,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAMxC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKnC,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,KAAK;CAKd"}

package/dist/types/core/Stage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Stage.d.ts","sourceRoot":"","sources":["../../../src/core/Stage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,8BAAsB,KAAK;IAgBvB,QAAQ,CAAC,GAAG,EAAE,WAAW;IACzB,QAAQ,CAAC,QAAQ,EAAE,eAAe;IAhBpC,yFAAyF;IACzF,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEvE,QAAQ,CAAC,KAAK,8CAA6C;IAC3D,QAAQ,CAAC,MAAM,8CAAmB;IAClC,QAAQ,CAAC,GAAG,gBAA2B;IACvC,QAAQ,CAAC,MAAM,UAAiB;IAChC,QAAQ,CAAC,IAAI,QAAe;IAC5B,QAAQ,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;IACtD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;gBAGZ,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,eAAe;IAQpC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,6GAA6G;IAC7G,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAQpC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAEjD;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAS1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C;;;;OAIG;IACH,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAInD,2EAA2E;IAC3E,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IAS/D,iIAAiI;IACjI,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI;IASlD,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,QAAQ;CAWjB"}
+{"version":3,"file":"Stage.d.ts","sourceRoot":"","sources":["../../../src/core/Stage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,8BAAsB,KAAK;IAgBvB,QAAQ,CAAC,GAAG,EAAE,WAAW;IACzB,QAAQ,CAAC,QAAQ,EAAE,eAAe;IAhBpC,yFAAyF;IACzF,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEvE,QAAQ,CAAC,KAAK,8CAA6C;IAC3D,QAAQ,CAAC,MAAM,8CAAmB;IAClC,QAAQ,CAAC,GAAG,gBAA2B;IACvC,QAAQ,CAAC,MAAM,UAAiB;IAChC,QAAQ,CAAC,IAAI,QAAe;IAC5B,QAAQ,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;IACtD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;gBAGZ,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,eAAe;IAUpC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,6GAA6G;IAC7G,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAQpC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAEjD;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAS1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C;;;;OAIG;IACH,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAInD,2EAA2E;IAC3E,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IAS/D,iIAAiI;IACjI,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI;IASlD,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,QAAQ;CAWjB"}

package/dist/types/core/TextureRegistry.d.ts

@@ -1,4 +1,30 @@
 import { CanvasSource, Texture } from 'pixi.js';
+/** A frame packed on an atlas page (TexturePacker and the like), as `assets/textureAtlas.ts` parses it. */
+export interface PackedFrame {
+    name: string;
+    /** The rect on the page (already swapped to its on-page size when `rotated`). */
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    /** Stored turned 90° clockwise on the page (Pixi's `rotate: 2`). */
+    rotated: boolean;
+    /** The untrimmed size of the sprite. */
+    sourceW: number;
+    sourceH: number;
+    /** Where the trimmed pixels sit inside the untrimmed sprite; absent when the frame was not trimmed. */
+    trim?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    /** The frame's pivot, 0–1, when the packer wrote one. */
+    anchor?: {
+        x: number;
+        y: number;
+    };
+}
 /** A canvas-backed texture with named frames; repaint the canvas, then `refresh()` to upload it. */
 export declare class CanvasTexture {
     readonly key: string;
@@ -12,6 +38,11 @@ export declare class CanvasTexture {
     get context(): CanvasRenderingContext2D;
     /** Adds a frame cut from the canvas (`_source` kept for the old call shape). */
     add(name: string, _source: number, x: number, y: number, w: number, h: number): void;
+    /**
+     * Adds a packed frame cut from `page` (this texture's canvas by default): trimmed frames keep their untrimmed size
+     * (`orig`) so they line up when drawn, and frames the packer turned are turned back (Pixi's `rotate: 2`).
+     */
+    addPacked(frame: PackedFrame, page?: CanvasTexture): void;
     /**
      * Registers under this texture a frame that lives on another one (an atlas page after the first), so the frame is
      * found by this texture's key. A texture of its own over the other page's source: each side frees its own.
@@ -43,6 +74,14 @@ export declare class TextureRegistry {
         frameWidth: number;
         frameHeight: number;
     }): CanvasTexture;
+    /**
+     * A packed atlas (TexturePacker JSON, `AssetLoader.atlas`): the first page under `key`, the others as `key~1`,
+     * `key~2`… like `AtlasBuilder`'s pages, and every frame of every page found under `key` by its name.
+     */
+    addAtlas(key: string, pages: readonly {
+        canvas: HTMLCanvasElement;
+        frames: readonly PackedFrame[];
+    }[]): CanvasTexture;
     createCanvas(key: string, width: number, height: number): CanvasTexture;
     remove(key: string): void;
     get(key: string, frame?: string | number): Texture;

package/dist/types/core/TextureRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextureRegistry.d.ts","sourceRoot":"","sources":["../../../src/core/TextureRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAa,OAAO,EAAE,MAAM,SAAS,CAAC;AAE3D,oGAAoG;AACpG,qBAAa,aAAa;IAMtB,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,MAAM,EAAE,iBAAiB;IANpC,QAAQ,CAAC,MAAM,6DAA8B;IAC7C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;gBAGb,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB;IAMpC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,OAAO,IAAI,wBAAwB,CAEtC;IAED,gFAAgF;IAChF,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAKpF;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI;IAO9C,OAAO,IAAI,IAAI;IAIf,OAAO,IAAI,IAAI;CAMhB;AAED,2FAA2F;AAC3F,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,6GAA6G;IAC7G,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAK;IAEtB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI3B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,iHAAiH;IACjH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAatD;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAkBjF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,aAAa;IAOhE,sFAAsF;IACtF,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa;IAUxH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa;IAOvE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMzB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAOlD,OAAO,CAAC,IAAI;CAOb"}
+{"version":3,"file":"TextureRegistry.d.ts","sourceRoot":"","sources":["../../../src/core/TextureRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAa,OAAO,EAAE,MAAM,SAAS,CAAC;AAE3D,2GAA2G;AAC3G,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,oEAAoE;IACpE,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,uGAAuG;IACvG,IAAI,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,yDAAyD;IACzD,MAAM,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnC;AAED,oGAAoG;AACpG,qBAAa,aAAa;IAMtB,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,MAAM,EAAE,iBAAiB;IANpC,QAAQ,CAAC,MAAM,6DAA8B;IAC7C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;gBAGb,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB;IAMpC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,OAAO,IAAI,wBAAwB,CAEtC;IAED,gFAAgF;IAChF,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAKpF;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,GAAE,aAAoB,GAAG,IAAI;IAa/D;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI;IAO9C,OAAO,IAAI,IAAI;IAIf,OAAO,IAAI,IAAI;CAMhB;AAED,2FAA2F;AAC3F,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,6GAA6G;IAC7G,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAK;IAEtB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI3B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,iHAAiH;IACjH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAatD;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAkBjF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,aAAa;IAOhE,sFAAsF;IACtF,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa;IAUxH;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;KAAE,EAAE,GAAG,aAAa;IAiBrH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa;IAOvE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMzB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAOlD,OAAO,CAAC,IAAI;CAOb"}

package/dist/types/core/blendLayer.d.ts

@@ -0,0 +1,23 @@
+import type { BLEND_MODES } from 'pixi.js';
+import type { Group } from './Group.js';
+import type { Stage } from './Stage.js';
+export interface BlendLayerOptions {
+    /** How its sprites blend (default `'add'`, light). Set on the container, so a sprite added needs no blend of its own. */
+    blend?: BLEND_MODES;
+    /**
+     * Its depth among the world's children (default 999,000: over every body sorted by a y under a million px, under
+     * labels a game keeps just below 1,000,000). Applied whenever given, so the first caller need not be the one to set it.
+     */
+    depth?: number;
+    /** A stage may hold several (a light layer and a shadow one): each name is its own container (default the blend's). */
+    name?: string;
+}
+/**
+ * One container per stage (and name) for every sprite of a blend mode: lamp glows, portals, the glow under loot.
+ * Laid among the bodies by depth, each additive sprite switched the blend mode twice and split the sprite batch — in
+ * one game 85–97 draw calls a frame in a fight, two thirds of them blend changes; gathered here they are one run.
+ * The price is that they no longer sort with the bodies: the layer stands over all of them, so put a glow where its
+ * light falls rather than relying on a body to cover it. Made again if destroyed (a scene change).
+ */
+export declare function blendLayer(stage: Stage, options?: BlendLayerOptions): Group;
+//# sourceMappingURL=blendLayer.d.ts.map

package/dist/types/core/blendLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blendLayer.d.ts","sourceRoot":"","sources":["../../../src/core/blendLayer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC,yHAAyH;IACzH,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uHAAuH;IACvH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,iBAAsB,GAAG,KAAK,CAiB/E"}

package/dist/types/core/gameObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gameObject.d.ts","sourceRoot":"","sources":["../../../src/core/gameObject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGrC,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAsBzC,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACtC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,8EAA8E;IAC9E,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,IAAI,IAAI,CAAC;IAClB,4DAA4D;IAC5D,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAuKtG"}
+{"version":3,"file":"gameObject.d.ts","sourceRoot":"","sources":["../../../src/core/gameObject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAMrC,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AA8BzC,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACtC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,8EAA8E;IAC9E,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,IAAI,IAAI,CAAC;IAClB,4DAA4D;IAC5D,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAuKtG"}

package/dist/types/core/pixelZoom.d.ts

@@ -0,0 +1,45 @@
+export interface PixelZoomOptions {
+    /** Canvas height (CSS px) worth one zoom step before clamping (default 290: ×2 on a phone held landscape, ×4 at 1080p). */
+    pxPerStep?: number;
+    /** The least and most zoom a screen gets on its own, before a player's offset (default 2 and 5). */
+    baseMin?: number;
+    baseMax?: number;
+    /** The least and most zoom any offset may reach (default 1 and 6). */
+    min?: number;
+    max?: number;
+    /** The one fractional zoom allowed, or null for whole steps only (default 1.5). */
+    halfZoom?: number | null;
+}
+/**
+ * The zoom a screen this tall gets on its own: one step per `pxPerStep` of height, within `baseMin`–`baseMax`.
+ * With the defaults a 375–440-px phone held landscape gets 2 (about 200 world px tall: ×1 drew a 24-px character
+ * 4 mm tall, ×3 left less than a monster's reach on screen), a 720p window 2, 1080p 4.
+ */
+export declare function baseZoom(canvasHeight: number, options?: PixelZoomOptions): number;
+/**
+ * The camera zoom (screen px per world px) for a canvas this tall, moved `offset` steps by the player (rounded to
+ * half steps), within `min`–`max`. Whole, or exactly `halfZoom`: a half step anywhere else rounds to the whole one.
+ */
+export declare function worldZoom(canvasHeight: number, offset?: number, options?: PixelZoomOptions): number;
+/**
+ * The zoom steps to offer a player on a screen this tall, by zoom from farthest to nearest: each of `offsets`
+ * and, where it lies below the screen's own zoom and no further than `lowest`, the offset that lands on `halfZoom`.
+ * Two offsets giving the same zoom are offered once, the one nearer 0 kept.
+ */
+export declare function zoomSteps(canvasHeight: number, offsets?: readonly number[], lowest?: number, options?: PixelZoomOptions): {
+    offset: number;
+    zoom: number;
+}[];
+/**
+ * The renderer's resolution for a zoom: 1 at a whole zoom (one backing pixel per CSS pixel, the cheapest fill), and at
+ * a fractional one the least whole resolution up to `maxResolution` (default 4) that makes `zoom × resolution` whole
+ * (2 at ×1.5, so a world pixel is 3 backing pixels) — but only on a screen of `devicePixelRatio` ≥ `minDpr`
+ * (default 1.5): a coarser one cannot show the difference and would pay the fill for nothing. 1 when none fits.
+ */
+export declare function zoomResolution(zoom: number, devicePixelRatio: number, minDpr?: number, maxResolution?: number): number;
+/**
+ * The whole-number scale content of this size is drawn at to fit a box (a map panel, a preview): the largest integer
+ * that fits both ways, never below 1, so every source pixel is the same number of screen pixels.
+ */
+export declare function fitScale(contentW: number, contentH: number, boxW: number, boxH: number): number;
+//# sourceMappingURL=pixelZoom.d.ts.map

package/dist/types/core/pixelZoom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixelZoom.d.ts","sourceRoot":"","sources":["../../../src/core/pixelZoom.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,gBAAgB;IAC/B,2HAA2H;IAC3H,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oGAAoG;IACpG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAQD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAGjF;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAI9F;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,SAAS,MAAM,EAAmB,EAC3C,MAAM,SAAO,EACb,OAAO,CAAC,EAAE,gBAAgB,GACzB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAcpC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,SAAM,EAAE,aAAa,SAAI,GAAG,MAAM,CAO9G;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/F"}

package/dist/types/core/runDue.d.ts

@@ -0,0 +1,15 @@
+/** Something to run at a time: a timer, an effect's later beat. `removed` ones are dropped without running. */
+export interface DueCall {
+    at: number;
+    fn: () => void;
+    removed?: boolean;
+}
+/**
+ * Runs and removes every call of `scheduled` due by `now`, in place: the list is compacted and `scratch` (kept by the
+ * caller, empty between calls) collects the due ones, so a frame allocates nothing. A call that throws goes to
+ * `failed` and the rest still run; whatever happens the due calls are gone from both lists afterwards. A list that
+ * kept a thrower threw again every frame anything else was scheduled, and cut short whatever the frame ran after it.
+ * A call scheduled by a running one lands in `scheduled` and waits for the next pass, even if already due.
+ */
+export declare function runDue<T extends DueCall>(scheduled: T[], scratch: T[], now: number, failed: (err: unknown) => void): void;
+//# sourceMappingURL=runDue.d.ts.map

package/dist/types/core/runDue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runDue.d.ts","sourceRoot":"","sources":["../../../src/core/runDue.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,IAAI,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CA6BzH"}

package/dist/types/core/silhouette.d.ts

@@ -0,0 +1,16 @@
+import { Texture } from 'pixi.js';
+/**
+ * `texture`'s frame with every opaque pixel painted `color` (default white), alpha kept; made once per frame and colour
+ * and cached. Only for textures that are never repainted (atlas frames, snapshots): copy a live one first
+ * (`TextureRegistry.snapshotInto`) and paint the copy with `fillSolid`. Null when the frame cannot be read (no
+ * drawable source, an empty or rotated frame, a cross-origin image).
+ */
+export declare function solidSilhouette(texture: Texture, color?: number): Texture | null;
+/** Paints every opaque pixel of a canvas `color` (default white), keeping its alpha. Upload the texture after. */
+export declare function fillSolid(canvas: unknown, color?: number): void;
+/**
+ * Frees cached silhouettes: those of one `texture` (it is about to be repainted or destroyed), or all of them (a
+ * scene or atlas change). A sprite still wearing one must be given another texture first.
+ */
+export declare function clearSilhouettes(texture?: Texture): void;
+//# sourceMappingURL=silhouette.d.ts.map

package/dist/types/core/silhouette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"silhouette.d.ts","sourceRoot":"","sources":["../../../src/core/silhouette.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,OAAO,EAAE,MAAM,SAAS,CAAC;AAiBhD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,SAAW,GAAG,OAAO,GAAG,IAAI,CAgClF;AAED,kHAAkH;AAClH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,SAAW,GAAG,IAAI,CAUjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAcxD"}

package/dist/types/debug/DrawCallCounter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DrawCallCounter.d.ts","sourceRoot":"","sources":["../../../src/debug/DrawCallCounter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC;;;;GAIG;AACH,qBAAa,eAAe;IAKd,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJrC,wCAAwC;IACxC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,OAAO,CAA6B;gBAEf,QAAQ,EAAE,QAAQ;IAE/C,oDAAoD;IACpD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,OAAO,IAAI,IAAI;IAmBf,SAAS,IAAI,IAAI;IAKjB,iEAAiE;IACjE,IAAI,IAAI,MAAM;CAKf"}
+{"version":3,"file":"DrawCallCounter.d.ts","sourceRoot":"","sources":["../../../src/debug/DrawCallCounter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AASxC;;;;GAIG;AACH,qBAAa,eAAe;IAKd,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJrC,wCAAwC;IACxC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,OAAO,CAA6B;gBAEf,QAAQ,EAAE,QAAQ;IAE/C,oDAAoD;IACpD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,OAAO,IAAI,IAAI;IAwBf,SAAS,IAAI,IAAI;IAKjB,iEAAiE;IACjE,IAAI,IAAI,MAAM;CAKf"}

package/dist/types/electron/electronLike.d.ts

@@ -0,0 +1,56 @@
+/** `electron.safeStorage`. */
+export interface SafeStorageLike {
+    isEncryptionAvailable(): boolean;
+    /** Linux only: `basic_text` means a hard-coded key, which is no encryption at all. */
+    getSelectedStorageBackend?(): string;
+    encryptString(plainText: string): Uint8Array;
+    decryptString(encrypted: Buffer): string;
+}
+/** `electron.ipcMain`. */
+export interface IpcMainLike {
+    handle(channel: string, listener: (event: any, ...args: any[]) => unknown): void;
+    removeHandler?(channel: string): void;
+}
+/** `electron.shell`. */
+export interface ShellLike {
+    openExternal(url: string): Promise<void>;
+}
+/** What `before-input-event` hands a listener (`Electron.Input`). */
+export interface InputLike {
+    type: string;
+    key: string;
+    control: boolean;
+    meta: boolean;
+    shift: boolean;
+    alt: boolean;
+}
+/** An event a listener may cancel. */
+export interface PreventableLike {
+    preventDefault(): void;
+}
+/** `electron.Session`, for the permission handlers. */
+export interface SessionLike {
+    setPermissionRequestHandler(handler: ((webContents: any, permission: any, callback: (granted: boolean) => void, details: any) => void) | null): void;
+    setPermissionCheckHandler(handler: ((webContents: any, permission: any, requestingOrigin: string, details: any) => boolean) | null): void;
+}
+/** `electron.WebContents`. */
+export interface WebContentsLike {
+    setWindowOpenHandler(handler: (details: {
+        url: string;
+    }) => any): void;
+    on(event: any, listener: (...args: any[]) => void): unknown;
+    toggleDevTools(): void;
+    session?: SessionLike;
+}
+/** `electron.BrowserWindow`, as far as a lockdown needs it. */
+export interface WindowLike {
+    webContents: WebContentsLike;
+}
+/** `electron.app`, as far as the debugger refusal needs it. */
+export interface AppLike {
+    isPackaged: boolean;
+    commandLine: {
+        hasSwitch(name: string): boolean;
+    };
+}
+//# sourceMappingURL=electronLike.d.ts.map

package/dist/types/electron/electronLike.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"electronLike.d.ts","sourceRoot":"","sources":["../../../src/electron/electronLike.ts"],"names":[],"mappings":"AAMA,8BAA8B;AAC9B,MAAM,WAAW,eAAe;IAC9B,qBAAqB,IAAI,OAAO,CAAC;IACjC,sFAAsF;IACtF,yBAAyB,CAAC,IAAI,MAAM,CAAC;IACrC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7C,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1C;AAED,0BAA0B;AAC1B,MAAM,WAAW,WAAW;IAE1B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC;IACjF,aAAa,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,wBAAwB;AACxB,MAAM,WAAW,SAAS;IACxB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;CACd;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,cAAc,IAAI,IAAI,CAAC;CACxB;AAED,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,2BAA2B,CAAC,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IACrJ,yBAAyB,CAAC,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;CAC3I;AAED,8BAA8B;AAC9B,MAAM,WAAW,eAAe;IAC9B,oBAAoB,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,GAAG,GAAG,IAAI,CAAC;IAGvE,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC;IAC5D,cAAc,IAAI,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,eAAe,CAAC;CAC9B;AAED,+DAA+D;AAC/D,MAAM,WAAW,OAAO;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE;QAAE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACnD"}

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

@@ -0,0 +1,15 @@
+/**
+ * `1681-engine/electron`: the main-process side of a desktop build on Electron — file-by-file web patching from a
+ * release store, the shell's identity, an OS-encrypted session store and a window lockdown. Electron is an optional
+ * peer: nothing here imports it, the game hands in its own `app`, `safeStorage`, `ipcMain`, `shell` and windows. Runs
+ * in the main process only (it uses Node's `fs` and `crypto`); the pure rules it shares with browsers and phones are
+ * `1681-engine/updates`. Importable from ESM (`import`) and from a CommonJS main process (`require`).
+ */
+export type { SafeStorageLike, IpcMainLike, ShellLike, InputLike, PreventableLike, SessionLike, WebContentsLike, WindowLike, AppLike } from './electronLike.js';
+export { shellId, type ShellIdOptions } from './shellId.js';
+export { WebPatcher, type WebPatcherOptions } from './webPatcher.js';
+export type { WebPointer, PointerName } from './webPointers.js';
+export { SessionStore, registerSessionStore, type SessionStoreOptions } from './sessionStore.js';
+export { isAllowedExternal, isAllowedNavigation, isDevToolsKey, debuggerRequested, DEBUG_SWITCHES, type ExternalPolicy } from './lockdownRules.js';
+export { lockDownWindow, denyPermissions, refuseDebugLaunch, type LockdownOptions } from './lockdown.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/electron/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC7J,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChJ,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/types/electron/lockdown.d.ts

@@ -0,0 +1,34 @@
+import type { AppLike, SessionLike, ShellLike, WindowLike } from './electronLike.js';
+import { type ExternalPolicy } from './lockdownRules.js';
+/** How {@link lockDownWindow} treats a window. */
+export interface LockdownOptions {
+    /** `electron.shell`, which opens an allowed link in the system browser. */
+    shell: ShellLike;
+    /** The links that may leave for the system browser. */
+    external: ExternalPolicy;
+    /** `app.isPackaged`: a packaged build refuses the DevTools keys. */
+    packaged: boolean;
+    /** A dev run's page origin, allowed for navigation; leave unset in a packaged build whatever the environment says. */
+    devServerUrl?: string;
+    /** In a dev run, this key toggles DevTools. Default `F12`; null for none. */
+    devToolsKey?: string | null;
+    /** Where refusals are reported. Default `console.log`. */
+    log?: (...args: unknown[]) => void;
+}
+/**
+ * Keeps a window on the game: a new window is never opened (an allowed link goes to the system browser instead, any
+ * other is refused), the window never navigates or redirects away from the game's own page, and a packaged build
+ * refuses the DevTools keys (set `webPreferences.devTools: !app.isPackaged` too: the keys are only the visible way in).
+ */
+export declare function lockDownWindow(win: WindowLike, o: LockdownOptions): void;
+/**
+ * Answers every permission request and check on `session` (camera, microphone, notifications, geolocation…) with no,
+ * but those in `allow`. Chromium's default in Electron is yes to almost everything, which a game never needs.
+ */
+export declare function denyPermissions(session: SessionLike, allow?: readonly string[]): void;
+/**
+ * A packaged app started with a debugger switch quits before it opens a window. Call it first thing in the main
+ * process; `exit` defaults to `process.exit` — not `app.exit`, so nothing after the call may run.
+ */
+export declare function refuseDebugLaunch(app: AppLike, argv?: readonly string[], exit?: (code: number) => void): boolean;
+//# sourceMappingURL=lockdown.d.ts.map

package/dist/types/electron/lockdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockdown.d.ts","sourceRoot":"","sources":["../../../src/electron/lockdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAClF,OAAO,EAA4E,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEhI,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,KAAK,EAAE,SAAS,CAAC;IACjB,uDAAuD;IACvD,QAAQ,EAAE,cAAc,CAAC;IACzB,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAC;IAClB,sHAAsH;IACtH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,0DAA0D;IAC1D,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,eAAe,GAAG,IAAI,CA8BxE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,GAAE,SAAS,MAAM,EAAO,GAAG,IAAI,CAIzF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE,SAAS,MAAM,EAAiB,EAAE,IAAI,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAA6B,GAAG,OAAO,CAMtJ"}

package/dist/types/electron/lockdownRules.d.ts

@@ -0,0 +1,29 @@
+import type { InputLike } from './electronLike.js';
+/**
+ * The links a locked-down window may open in the system browser: https only, no credentials in the URL, to one of
+ * `hosts` or a subdomain of it — or, for a host where anyone can publish a page (a code host), only under one of its
+ * `paths`.
+ */
+export interface ExternalPolicy {
+    /** Hosts allowed whole, each with its subdomains (`example.com` allows `www.example.com`). */
+    hosts: readonly string[];
+    /** Hosts allowed only under a path prefix (exact host, prefix compared case-insensitively), e.g. one owner's repositories. */
+    paths?: readonly {
+        host: string;
+        prefix: string;
+    }[];
+}
+/** Whether `url` is a link {@link ExternalPolicy} lets out to the system browser. */
+export declare function isAllowedExternal(url: string, policy: ExternalPolicy): boolean;
+/**
+ * The game's own page: the bundled `file://` build, or the dev server's origin in a dev run. Anything else followed
+ * inside the window would replace the game with a web page that has the shell's preload API.
+ */
+export declare function isAllowedNavigation(url: string, devServerUrl?: string): boolean;
+/** The keys that open DevTools (F12, Ctrl/Cmd+Shift/Alt+I/J/C), refused in a packaged build. */
+export declare function isDevToolsKey(input: InputLike): boolean;
+/** Chromium and Node switches that attach a debugger to a running app. */
+export declare const DEBUG_SWITCHES: readonly string[];
+/** Whether the command line (`argv`, or a switch Chromium parsed: `hasSwitch`) asks for a debugger. */
+export declare function debuggerRequested(argv: readonly string[], hasSwitch?: (name: string) => boolean): boolean;
+//# sourceMappingURL=lockdownRules.d.ts.map

package/dist/types/electron/lockdownRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockdownRules.d.ts","sourceRoot":"","sources":["../../../src/electron/lockdownRules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,8FAA8F;IAC9F,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,8HAA8H;IAC9H,KAAK,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACrD;AAUD,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAU9E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAQ/E;AAED,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAMvD;AAED,0EAA0E;AAC1E,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAAsG,CAAC;AAGnJ,uGAAuG;AACvG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAqB,GAAG,OAAO,CAGtH"}

package/dist/types/electron/sessionStore.d.ts

@@ -0,0 +1,41 @@
+import type { IpcMainLike, SafeStorageLike } from './electronLike.js';
+/** Where and how a {@link SessionStore} keeps its one secret. */
+export interface SessionStoreOptions {
+    /** `electron.safeStorage`. */
+    safeStorage: SafeStorageLike;
+    /** The folder, e.g. `app.getPath('userData')` — a second app (a test build) with its own user data keeps its own. */
+    dir: string;
+    /** Default `session.bin`. */
+    fileName?: string;
+    /** Longest value accepted, in characters. Default 4096: a saved login is a token and a name, never a blob. */
+    maxLength?: number;
+    /** Default `process.platform`. */
+    platform?: string;
+}
+/**
+ * One small secret (a refresh token and username, as a JSON string) kept for "stay logged in", encrypted by the OS —
+ * `safeStorage`: DPAPI for the Windows user, the Keychain on the Mac. Where the OS offers no real encryption (Linux
+ * without a keyring: `basic_text`, a key written into Chromium) nothing is written and the player logs in again after
+ * closing; a token on disk in the clear is worse than that. Never `localStorage`: any script in the page could read it.
+ */
+export declare class SessionStore {
+    private readonly o;
+    private readonly file;
+    private readonly maxLength;
+    private readonly platform;
+    constructor(o: SessionStoreOptions);
+    /** Whether the OS can encrypt for real here. */
+    canEncrypt(): boolean;
+    /** The saved value, or null when there is none, it cannot be decrypted (another OS user, a reinstall) or nothing may be. */
+    get(): Promise<string | null>;
+    /** Saves `value`; false when it is not a string, too long, or the OS cannot encrypt it. */
+    set(value: unknown): Promise<boolean>;
+    clear(): Promise<void>;
+}
+/**
+ * Answers a renderer's `<prefix>:get`, `<prefix>:set` (one string) and `<prefix>:clear` from `store`, so the page only
+ * ever sees the plain value, and only its own. Expose them in the preload with `ipcRenderer.invoke`. Returns a function
+ * that removes the handlers.
+ */
+export declare function registerSessionStore(ipcMain: IpcMainLike, store: SessionStore, prefix?: string): () => void;
+//# sourceMappingURL=sessionStore.d.ts.map

package/dist/types/electron/sessionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../../../src/electron/sessionStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEnE,iEAAiE;AACjE,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,WAAW,EAAE,eAAe,CAAC;IAC7B,qHAAqH;IACrH,GAAG,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8GAA8G;IAC9G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IAKX,OAAO,CAAC,QAAQ,CAAC,CAAC;IAJ9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEL,CAAC,EAAE,mBAAmB;IAMnD,gDAAgD;IAChD,UAAU,IAAI,OAAO;IAMrB,4HAA4H;IACtH,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASnC,2FAA2F;IACrF,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAerC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAY,GAAG,MAAM,IAAI,CAO9G"}

package/dist/types/electron/shellId.d.ts

@@ -0,0 +1,23 @@
+/** What goes into a shell's identity besides the runtime's version. */
+export interface ShellIdOptions {
+    /** Folders whose files (non-recursive) are hashed, in this order. */
+    dirs: string[];
+    /** Which files of each folder count; default the compiled main-process code, `*.cjs`. */
+    match?: (fileName: string) => boolean;
+    /** More text to fold in (an engine or framework version the main process bundles from elsewhere). */
+    extra?: string[];
+    /** Hex characters kept; default 16. */
+    length?: number;
+}
+/**
+ * A desktop shell's identity: a hash of the main process's own code and the Electron version it runs on. A web patch
+ * is taken only by a shell with the same identity, because the web talks to the shell through its preload script and
+ * may need what a newer shell adds; anything else comes with an installer. The publish script reckons it the same way
+ * off the build it uploads, so nobody has to remember to raise a number when the shell changes.
+ *
+ * `shellId(version, dir)` hashes `dir`'s `*.cjs`; pass {@link ShellIdOptions} for more folders or other files. With one
+ * folder, the default match and no `extra`, both forms give the same hash. Code the shell takes from `node_modules`
+ * (this module included) is not in `dir`: name its version in `extra`, or a change there would not change the identity.
+ */
+export declare function shellId(electronVersion: string, dirOrOptions: string | ShellIdOptions): string;
+//# sourceMappingURL=shellId.d.ts.map

package/dist/types/electron/shellId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shellId.d.ts","sourceRoot":"","sources":["../../../src/electron/shellId.ts"],"names":[],"mappings":"AAIA,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,yFAAyF;IACzF,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,qGAAqG;IACrG,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,MAAM,CAa9F"}

package/dist/types/electron/webFiles.d.ts

@@ -0,0 +1,14 @@
+/** Lower-case hex sha256. */
+export declare const sha256: (data: Uint8Array) => string;
+/** Every file under `dir`, as forward-slash paths relative to it. */
+export declare function listFiles(dir: string, base?: string): Promise<string[]>;
+/** Every file of the web in `dir`, path → sha256. */
+export declare function hashWeb(dir: string): Promise<Map<string, string>>;
+/** Writes `data` at the manifest path `path` under `dir`, making its folders. */
+export declare function putFile(dir: string, path: string, data: Uint8Array): Promise<void>;
+/**
+ * `fetch` that gives up after `ms` and never takes a cached answer: a store behind a CDN otherwise hands back
+ * yesterday's `latest.json`, and a stalled connection would hold an update check open for good.
+ */
+export declare function fetchWithTimeout(fetcher: typeof fetch, url: string, ms: number): Promise<Response>;
+//# sourceMappingURL=webFiles.d.ts.map

package/dist/types/electron/webFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webFiles.d.ts","sourceRoot":"","sources":["../../../src/electron/webFiles.ts"],"names":[],"mappings":"AAIA,6BAA6B;AAC7B,eAAO,MAAM,MAAM,GAAI,MAAM,UAAU,KAAG,MAAyD,CAAC;AAEpG,qEAAqE;AACrE,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQzE;AAED,qDAAqD;AACrD,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAIvE;AAED,iFAAiF;AACjF,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxF;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQxG"}

package/dist/types/electron/webPatcher.d.ts

@@ -0,0 +1,81 @@
+import { type LatestJson } from '../updates/manifest.js';
+/** How a {@link WebPatcher} finds its webs and its store. */
+export interface WebPatcherOptions {
+    /** Where patched webs are built and kept, e.g. `join(app.getPath('userData'), 'web')`. */
+    root: string;
+    /** The web the installed build ships (the folder holding its `index.html`). */
+    builtinDir: string;
+    /** The installed build's version (`app.getVersion()`): a patched web must be newer to be loaded. */
+    appVersion: string;
+    /** This shell's identity (`shellId`), or a function reckoning it on first use. */
+    shell: string | (() => string);
+    /** The store's channel, e.g. `https://store.example/public/live`: `latest.json`, `web/…`, `files/…` lie under it. */
+    channelUrl: string;
+    /** False in a dev run: the built-in web is always loaded and nothing is read or tidied. Default true. */
+    packaged?: boolean;
+    /** Starts an unconfirmed web gets before it is dropped. Default 2. */
+    maxTries?: number;
+    /** Fall back to the last web that booted, rather than the built-in one, when a new web never boots. Default true. */
+    keepPrevious?: boolean;
+    /** The page file in a web. Default `index.html`. */
+    entry?: string;
+    /** Downloads at once. Default 6. */
+    parallel?: number;
+    /** Per request. Default 15 000 ms. */
+    fetchTimeoutMs?: number;
+    /** Default `globalThis.fetch`. */
+    fetch?: typeof fetch;
+    /** Where a failure to read the patched webs is reported. Default `console.error`. */
+    log?: (...args: unknown[]) => void;
+}
+/**
+ * A desktop shell that patches its web file by file, the way a game launcher does: the web a build ships is its
+ * built-in copy, and every newer web is assembled beside it in `<root>/<version>/` from the files already held plus
+ * only those whose content is new (`<channel>/files/<sha256>`, checked against their hash), then loaded in its place.
+ * A web is taken only by a shell of the same identity; any other change needs an installer. A web that never reports
+ * booting ({@link markBooted}, from the page) within `maxTries` starts is dropped, and the shell goes back to the last
+ * web that did — or the built-in one — so a broken release cannot lock a player out.
+ *
+ * Use one per process: {@link startEntry} first (it decides which web this run loads), then the update calls.
+ */
+export declare class WebPatcher {
+    private readonly options;
+    private readonly o;
+    private readonly pointers;
+    private shellValue;
+    /** The web this run loads, and its version (the installed build's own when none is patched in). */
+    private loaded;
+    /** The tidy a start began: a build waits for it, or it could delete the `.part` folder being filled. */
+    private tidying;
+    constructor(options: WebPatcherOptions);
+    /** This shell's identity. */
+    get shell(): string;
+    /** Where the window loads the page from: a patched web when there is a good one, else the built-in copy. */
+    startEntry(): string;
+    /** The version of the web running now. */
+    webVersion(): string;
+    /** The page came up: the web it was loaded from is kept from now on. Call it from the page's own "booted" message. */
+    markBooted(): void;
+    /** The channel's newest build, or null when the store cannot be read. */
+    latest(): Promise<LatestJson | null>;
+    /** Whether `l`'s web can be patched in here rather than installed: newer than the web running, for this shell. */
+    patchable(l: LatestJson): boolean;
+    /**
+     * Builds `l`'s web beside the one running: the files held are copied, the rest downloaded and checked, into
+     * `<version>.part/`, which becomes `<version>/` and the pending web once whole — a crash mid-way never leaves a
+     * folder that looks finished. `onProgress` gets 0–100. Resolves with the version built; throws on any failure.
+     */
+    prepare(l: LatestJson, onProgress?: (percent: number) => void): Promise<string>;
+    /**
+     * Puts the pending web in use now and returns the page to load (reload every window from it), or null when there is
+     * none this shell may load. The switch counts as its first start, so a web that never boots is still dropped.
+     */
+    applyPending(): string | null;
+    /** Makes `p` the active web, keeping the one it replaces as the fallback when that one ever booted. */
+    private promote;
+    /** A pointer this shell may load: its own shell, newer than the installed build, its folder whole. */
+    private usable;
+    /** Removes every patched web but the active, pending and previous one, and any half-made folder. */
+    tidy(): Promise<void>;
+}
+//# sourceMappingURL=webPatcher.d.ts.map

package/dist/types/electron/webPatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webPatcher.d.ts","sourceRoot":"","sources":["../../../src/electron/webPatcher.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAKvF,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;IACnB,oGAAoG;IACpG,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IAC/B,qHAAqH;IACrH,UAAU,EAAE,MAAM,CAAC;IACnB,yGAAyG;IACzG,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qHAAqH;IACrH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,qFAAqF;IACrF,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACpC;AAED;;;;;;;;;GASG;AACH,qBAAa,UAAU;IAST,OAAO,CAAC,QAAQ,CAAC,OAAO;IARpC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAA6C;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,UAAU,CAAuB;IACzC,mGAAmG;IACnG,OAAO,CAAC,MAAM,CAAiD;IAC/D,wGAAwG;IACxG,OAAO,CAAC,OAAO,CAAoC;gBAEtB,OAAO,EAAE,iBAAiB;IAkBvD,6BAA6B;IAC7B,IAAI,KAAK,IAAI,MAAM,CAIlB;IAED,4GAA4G;IAC5G,UAAU,IAAI,MAAM;IAgCpB,0CAA0C;IAC1C,UAAU,IAAI,MAAM;IAIpB,sHAAsH;IACtH,UAAU,IAAI,IAAI;IAKlB,yEAAyE;IACnE,MAAM,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAW1C,kHAAkH;IAClH,SAAS,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO;IAIjC;;;;OAIG;IACG,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAmDtG;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IAS7B,uGAAuG;IACvG,OAAO,CAAC,OAAO;IAMf,sGAAsG;IACtG,OAAO,CAAC,MAAM;IAId,oGAAoG;IAC9F,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAY5B"}

package/dist/types/electron/webPointers.d.ts

@@ -0,0 +1,20 @@
+/** Which patched web a pointer names, and whether it ever came up. */
+export interface WebPointer {
+    version: string;
+    shell: string;
+    /** The page reported booting from it at least once. */
+    booted: boolean;
+    /** Starts it was loaded on without booting. */
+    tries: number;
+}
+/** `active`: in use; `pending`: built, put in use on the next start; `previous`: the last web that booted before `active`. */
+export type PointerName = 'active' | 'pending' | 'previous';
+/** The pointer files beside the patched webs (`<root>/<name>.json`), read and written whole. */
+export declare class WebPointers {
+    private readonly root;
+    constructor(root: string);
+    read(name: PointerName): WebPointer | null;
+    write(name: PointerName, p: WebPointer | null): void;
+    private file;
+}
+//# sourceMappingURL=webPointers.d.ts.map

package/dist/types/electron/webPointers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webPointers.d.ts","sourceRoot":"","sources":["../../../src/electron/webPointers.ts"],"names":[],"mappings":"AAGA,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,MAAM,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8HAA8H;AAC9H,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE5D,gGAAgG;AAChG,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IAEzC,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,IAAI;IAU1C,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI;IAOpD,OAAO,CAAC,IAAI;CAGb"}