1681-engine 0.5.9 → 0.6.0

package/dist/types/assets/Prepainter.d.ts

@@ -0,0 +1,64 @@
+/** A painted RGBA image: `w` × `h` pixels, 4 bytes each, row by row (what `ImageData` holds). */
+export interface PaintedPixels {
+    w: number;
+    h: number;
+    pixels: ArrayBuffer;
+}
+/** Paints an item's texture off the main thread (`workerPainter`), or anywhere else that answers with a promise. */
+export interface Painter<T> {
+    paint(item: T, id: string): Promise<PaintedPixels>;
+    /** Stops it for good (a worker terminated). */
+    dispose?(): void;
+}
+/** What a `Prepainter` needs of a texture registry (`TextureRegistry` has it). */
+export interface PrepainterTextures {
+    exists(key: string): boolean;
+    remove(key: string): void;
+    addCanvas(key: string, canvas: HTMLCanvasElement): unknown;
+}
+export interface PrepainterOptions<T> {
+    textures: PrepainterTextures;
+    /** The item's id, unique among items. */
+    id: (item: T) => string;
+    /** The texture key an id's painting is kept under (default the id itself). */
+    key?: (id: string) => string;
+    /** Null where nothing can be painted ahead: then everything is painted on arrival, as without a prepainter. */
+    painter: Painter<T> | null;
+    /** Turns painted pixels into a canvas (default a DOM canvas; tests hand in a stand-in). */
+    canvas?: (painted: PaintedPixels) => HTMLCanvasElement | null;
+    /** Told when a painting landed in the registry. */
+    onPainted?: (id: string) => void;
+}
+/**
+ * Paints ahead the big textures a player may need next (the maps beyond the current one's doors, the next level's
+ * backdrop) so the step into them finds them ready instead of painting them there and then — a large map's ground was
+ * two seconds of main-thread work, which froze the first step through every door. It also frees the rest: each such
+ * texture is one big image, and a long session through thirty-odd places kept every one of them.
+ *
+ * Whatever is not ready yet is the caller's to paint on arrival, as before; a painter that cannot start or fails only
+ * means nothing is painted ahead.
+ */
+export declare class Prepainter<T> {
+    private readonly options;
+    private readonly pending;
+    /** Ids whose painting is held as a texture: the current one and its neighbours. */
+    private readonly held;
+    private readonly key;
+    private destroyed;
+    constructor(options: PrepainterOptions<T>);
+    /**
+     * Stands on `current`: its texture (painted by the caller on arrival, or ahead) and its neighbours' are kept, every
+     * other one this prepainter held is freed, and the neighbours not yet painted are started.
+     */
+    enter(current: T, next: readonly T[]): void;
+    /** Whether `id` is being painted right now (so a caller may wait for it a moment rather than paint it again). */
+    painting(id: string): boolean;
+    /** Ids held as textures now. */
+    get holding(): ReadonlySet<string>;
+    /** Starts painting `item` unless it is painted or under way. */
+    prepare(item: T): void;
+    /** Stops painting; textures already made are left to the registry. */
+    destroy(): void;
+    private receive;
+}
+//# sourceMappingURL=Prepainter.d.ts.map

package/dist/types/assets/Prepainter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prepainter.d.ts","sourceRoot":"","sources":["../../../src/assets/Prepainter.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,oHAAoH;AACpH,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACnD,+CAA+C;IAC/C,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED,kFAAkF;AAClF,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC;CAC5D;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,yCAAyC;IACzC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IACxB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7B,+GAA+G;IAC/G,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3B,2FAA2F;IAC3F,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,iBAAiB,GAAG,IAAI,CAAC;IAC9D,mDAAmD;IACnD,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAaD;;;;;;;;GAQG;AACH,qBAAa,UAAU,CAAC,CAAC;IAOX,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,mFAAmF;IACnF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyB;IAC7C,OAAO,CAAC,SAAS,CAAS;gBAEG,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAI1D;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI;IAa3C,iHAAiH;IACjH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI7B,gCAAgC;IAChC,IAAI,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAEjC;IAED,gEAAgE;IAChE,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAatB,sEAAsE;IACtE,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,OAAO;CAYhB"}

package/dist/types/assets/workerPainter.d.ts

@@ -0,0 +1,21 @@
+import type { PaintedPixels, Painter } from './Prepainter.js';
+/** What the worker posts back for one request: the painted pixels (the buffer transferred), or why it could not. */
+export type PaintReply = {
+    id: string;
+} & (PaintedPixels | {
+    error: string;
+});
+export interface WorkerPainterOptions<T> {
+    /** Makes the worker, the first time something is painted: `() => new Worker(new URL('./paint.ts', import.meta.url), { type: 'module' })`. */
+    create: () => Worker;
+    /** The message posted for an item (default `{ id, item }`); the worker answers with a `PaintReply` naming that id. */
+    message?: (item: T, id: string) => unknown;
+}
+/**
+ * A `Painter` that paints in a worker. The worker answers each request with a `PaintReply` carrying the request's id,
+ * transferring the pixel buffer (`postMessage(reply, { transfer: [reply.pixels] })`) so nothing is copied back. A
+ * worker that cannot start or fails rejects everything under way and everything after: a prepainter then simply
+ * paints nothing ahead.
+ */
+export declare function workerPainter<T>(options: WorkerPainterOptions<T>): Painter<T>;
+//# sourceMappingURL=workerPainter.d.ts.map

package/dist/types/assets/workerPainter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerPainter.d.ts","sourceRoot":"","sources":["../../../src/assets/workerPainter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE3D,oHAAoH;AACpH,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,CAAC,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE9E,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,6IAA6I;IAC7I,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,sHAAsH;IACtH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAmD7E"}

package/dist/types/audio/spatial.d.ts

@@ -0,0 +1,107 @@
+/** A point in the world, px. */
+export interface Point {
+    readonly x: number;
+    readonly y: number;
+}
+export interface SpatialMixOptions {
+    /** Beyond this (px) the source is not heard (default 480). */
+    range?: number;
+    /** How the loudness falls off: 1 straight, higher drops faster near the edge of `range` (default 1.5). */
+    rolloff?: number;
+    /** Px off to one side at which the sound is panned fully that way (default `range / 2`). */
+    panWidth?: number;
+    /** The furthest it pans, 0–1: 1 is one ear only, which sounds wrong on headphones (default 0.8). */
+    maxPan?: number;
+    /** Low-pass cutoff (Hz) beside the listener and at the edge of `range`, so far sounds are dull; null for none. */
+    muffle?: readonly [number, number] | null;
+}
+/** How a source sounds from where the listener stands. */
+export interface SpatialMix {
+    /** Within `range`. */
+    audible: boolean;
+    /** 0–1. */
+    gain: number;
+    /** −1 left … 1 right. */
+    pan: number;
+    /** The low-pass cutoff, Hz (the top of hearing when `muffle` is null). */
+    cutoffHz: number;
+}
+/** The mix of a source at `source` heard from `listener`: louder near, panned to its side, duller far. */
+export declare function spatialMix(listener: Point, source: Point, options?: SpatialMixOptions): SpatialMix;
+export interface EmitterOptions extends SpatialMixOptions {
+    /** 0–1 (default 1). */
+    volume?: number;
+    /** Plays on for good (default true); a one-shot ends by itself. */
+    loop?: boolean;
+    playbackRate?: number;
+}
+/** A sound placed in the world by `SpatialAudio`. */
+export interface SpatialEmitter {
+    x: number;
+    y: number;
+    volume: number;
+    /** Playing now: false while out of range (a loop waits silent), and for good once stopped or ended. */
+    readonly playing: boolean;
+    readonly done: boolean;
+    stop(fadeMs?: number): void;
+}
+/**
+ * Sounds placed in the world, heard from a listener that moves: a waterfall, a campfire, a machine humming, or a
+ * one-shot at a spot. Each emitter is panned to its side, fades with distance and loses its highs far away
+ * (`spatialMix`), eased each `update` so a moving source does not click. A loop out of range stops its source to
+ * save the voice and starts again at the point it would have reached, so it seems to have played on.
+ *
+ * ```ts
+ * const world = new SpatialAudio(audioContext);
+ * const falls = world.emitter(fallsBuffer, 320, 96, { range: 400, volume: 0.6 });
+ * // each frame: world.update(hero);
+ * ```
+ */
+export declare class SpatialAudio {
+    readonly context: BaseAudioContext;
+    /** Every emitter's gain goes through this: the game's volume setting. */
+    readonly output: GainNode;
+    private readonly emitters;
+    private here;
+    constructor(context: BaseAudioContext, destination?: AudioNode);
+    /** The listener's place as of the last `update`. */
+    get listener(): Point;
+    /** How many emitters are alive (playing or waiting out of range). */
+    get size(): number;
+    /** A sound at (x, y), looping by default. Starts at once when in range of the listener. */
+    emitter(buffer: AudioBuffer, x: number, y: number, options?: EmitterOptions): SpatialEmitter;
+    /** A one-shot at (x, y), dropped when it ends; skipped (and done at once) when out of range. */
+    play(buffer: AudioBuffer, x: number, y: number, options?: Omit<EmitterOptions, 'loop'>): SpatialEmitter;
+    /** Moves the listener and re-mixes every emitter. Call once a frame. */
+    update(listener?: Point): void;
+    /** Stops every emitter. */
+    stopAll(fadeMs?: number): void;
+    destroy(): void;
+    /** @internal */
+    forget(e: Emitter): void;
+}
+declare class Emitter implements SpatialEmitter {
+    private readonly owner;
+    private readonly buffer;
+    x: number;
+    y: number;
+    private readonly options;
+    volume: number;
+    done: boolean;
+    private source;
+    private readonly gain;
+    private readonly panner;
+    private readonly filter;
+    /** When the loop would have begun, had it never stopped: where a restart picks it up. */
+    private readonly origin;
+    private readonly rate;
+    constructor(owner: SpatialAudio, buffer: AudioBuffer, x: number, y: number, options: EmitterOptions);
+    get playing(): boolean;
+    refresh(listener: Point, smooth: boolean): void;
+    stop(fadeMs?: number): void;
+    private begin;
+    private halt;
+    private release;
+}
+export {};
+//# sourceMappingURL=spatial.d.ts.map

package/dist/types/audio/spatial.d.ts.map

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

package/dist/types/dialogue/DialogueRunner.d.ts

@@ -0,0 +1,78 @@
+import { type ExprValue } from './expr.js';
+import type { DialogueScript, DialogueStep } from './script.js';
+export interface DialogueOptions {
+    /** The variables conditions read and `set` writes; shared with the game (default a fresh object). */
+    vars?: Record<string, unknown>;
+    /** Functions an expression may call, beside the built-in `visited(node)` and `chose(node, index)`. */
+    functions?: Record<string, (...args: ExprValue[]) => ExprValue>;
+    /** A `do` command: what the game does for it. */
+    onCommand?: (name: string, args: readonly unknown[], runner: DialogueRunner) => void;
+    /** A line's or a choice's text in the player's language, before `{…}` is filled in (default as written). */
+    translate?: (text: string, key: string | undefined) => string;
+}
+/** Where a dialogue was, and what it knew, for a save: plain data. */
+export interface DialogueSave {
+    node: string | null;
+    line: number;
+    vars: Record<string, unknown>;
+    visits: Record<string, number>;
+    chosen: string[];
+}
+/**
+ * Runs a `DialogueScript`: hands the game one step at a time — a line, a set of choices, the end — and moves on when
+ * the game says the line was read (`next`) or a choice made (`choose`). It draws nothing: the game's own box shows a
+ * `ShownLine` however it likes (a typewriter, a portrait from `tags`).
+ *
+ * ```ts
+ * const talk = new DialogueRunner(script, { vars: save.flags, onCommand: (name, args) => game.run(name, args) });
+ * let step = talk.start();
+ * // on a press: step = step.type === 'line' ? talk.next() : talk.choose(picked);
+ * ```
+ */
+export declare class DialogueRunner {
+    readonly script: DialogueScript;
+    private readonly options;
+    readonly vars: Record<string, unknown>;
+    private node;
+    private line;
+    private step;
+    private readonly visits;
+    private readonly chosen;
+    private readonly scope;
+    constructor(script: DialogueScript, options?: DialogueOptions);
+    /** The step showing now. */
+    get current(): DialogueStep;
+    /** The node the dialogue is in, or null once it has ended. */
+    get at(): string | null;
+    /** How many times a node was entered. */
+    visited(node: string): number;
+    /** Begins at `node` (default the script's `start`, else its first node). */
+    start(node?: string | undefined): DialogueStep;
+    /** The line showing was read: on to the next line, the choices, or wherever the node leads. */
+    next(): DialogueStep;
+    /** Picks a choice by its `index` (as shown). A locked or unknown index changes nothing. */
+    choose(index: number): DialogueStep;
+    /** Jumps to a node from outside (the game's own event broke in). */
+    jump(node: string): DialogueStep;
+    /** Ends the dialogue now. */
+    stop(): DialogueStep;
+    /** The value of an expression over this dialogue's variables, for a game that shares the language. */
+    evaluate(source: string): ExprValue;
+    save(): DialogueSave;
+    /** Puts a saved dialogue back where it was, without running the node's `set` and `do` again. */
+    restore(save: DialogueSave): DialogueStep;
+    private go;
+    private enter;
+    /** The step from the current line on: the next line that holds, else the choices, else the way on. */
+    private show;
+    private offered;
+    private wayOn;
+    private finish;
+    private nodeOf;
+    private test;
+    private assign;
+    private run;
+    /** `text` translated, with each `{expression}` replaced by its value; `{{` and `}}` are braces. */
+    private text;
+}
+//# sourceMappingURL=DialogueRunner.d.ts.map

package/dist/types/dialogue/DialogueRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DialogueRunner.d.ts","sourceRoot":"","sources":["../../../src/dialogue/DialogueRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,KAAK,EAA+D,cAAc,EAAE,YAAY,EAAe,MAAM,UAAU,CAAC;AAEvI,MAAM,WAAW,eAAe;IAC9B,qGAAqG;IACrG,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,sGAAsG;IACtG,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,SAAS,EAAE,KAAK,SAAS,CAAC,CAAC;IAChE,iDAAiD;IACjD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,OAAO,EAAE,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IACrF,4GAA4G;IAC5G,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAAC;CAC/D;AAED,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAKD;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IAUvB,QAAQ,CAAC,MAAM,EAAE,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAV1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,IAAI,CAAiC;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAGvB,MAAM,EAAE,cAAc,EACd,OAAO,GAAE,eAAoB;IAgBhD,4BAA4B;IAC5B,IAAI,OAAO,IAAI,YAAY,CAE1B;IAED,8DAA8D;IAC9D,IAAI,EAAE,IAAI,MAAM,GAAG,IAAI,CAEtB;IAED,yCAAyC;IACzC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI7B,4EAA4E;IAC5E,KAAK,CAAC,IAAI,qBAAyD,GAAG,YAAY;IAKlF,+FAA+F;IAC/F,IAAI,IAAI,YAAY;IAMpB,2FAA2F;IAC3F,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;IAYnC,oEAAoE;IACpE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAIhC,6BAA6B;IAC7B,IAAI,IAAI,YAAY;IAIpB,sGAAsG;IACtG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAInC,IAAI,IAAI,YAAY;IAUpB,gGAAgG;IAChG,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY;IAazC,OAAO,CAAC,EAAE;IAIV,OAAO,CAAC,KAAK;IAab,sGAAsG;IACtG,OAAO,CAAC,IAAI;IAgBZ,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,GAAG;IAOX,mGAAmG;IACnG,OAAO,CAAC,IAAI;CASb"}

package/dist/types/dialogue/expr.d.ts

@@ -0,0 +1,12 @@
+export type ExprValue = number | string | boolean | null | undefined;
+/** What an expression reads: variables by (dotted) name, and the functions it may call. */
+export interface ExprScope {
+    get(name: string): unknown;
+    call(name: string, args: ExprValue[]): ExprValue;
+}
+export type CompiledExpr = (scope: ExprScope) => ExprValue;
+/** Compiles `src`; throws with what and where on a syntax error. */
+export declare function compileExpr(src: string): CompiledExpr;
+/** `compileExpr`, kept: a script asks the same few conditions again and again. */
+export declare function expr(src: string): CompiledExpr;
+//# sourceMappingURL=expr.d.ts.map

package/dist/types/dialogue/expr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expr.d.ts","sourceRoot":"","sources":["../../../src/dialogue/expr.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAErE,2FAA2F;AAC3F,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,CAAC;AAsD3D,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAgHrD;AAID,kFAAkF;AAClF,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAQ9C"}

package/dist/types/dialogue/script.d.ts

@@ -0,0 +1,78 @@
+/** One line said: by `speaker` (absent: narration). A bare string is a line of narration. */
+export interface DialogueLine {
+    text: string;
+    speaker?: string;
+    /** Said only when this holds. */
+    if?: string;
+    /** The game's own marks (a portrait's mood, a sound): handed back with the line. */
+    tags?: string[];
+    /** A translation key, handed to `translate` with the text. */
+    key?: string;
+}
+/** Something the game does, by name: `"open_gate"`, or `{ "name": "give", "args": ["key", 1] }`. */
+export type DialogueCommand = string | {
+    name: string;
+    args?: unknown[];
+};
+/** One answer the player may pick. */
+export interface DialogueChoice {
+    text: string;
+    /** Where it leads (absent: the dialogue ends). */
+    goto?: string;
+    /** Offered only when this holds. */
+    if?: string;
+    /** When `if` fails, show it greyed out instead of leaving it out (the player sees what they lack). */
+    showLocked?: boolean;
+    /** Offered only until picked once. */
+    once?: boolean;
+    /** Assignments run when it is picked: name → expression. */
+    set?: Record<string, string>;
+    do?: DialogueCommand[];
+    key?: string;
+}
+/** A way on from a node with no choices: the first branch whose `if` holds (or that has none) is taken. */
+export interface DialogueBranch {
+    if?: string;
+    goto: string;
+}
+export interface DialogueNode {
+    lines?: (string | DialogueLine)[];
+    choices?: DialogueChoice[];
+    /** Where to go after the lines when there are no choices: a node, or branches. Absent: the dialogue ends. */
+    next?: string | DialogueBranch[];
+    /** Assignments run on entering the node, before its lines. */
+    set?: Record<string, string>;
+    /** Commands run on entering the node, after `set`. */
+    do?: DialogueCommand[];
+}
+export interface DialogueScript {
+    /** Where `start()` begins (default the first node). */
+    start?: string;
+    nodes: Record<string, DialogueNode>;
+}
+/** A line as the runner hands it on: with its `{…}` filled in and translated. */
+export interface ShownLine {
+    type: 'line';
+    node: string;
+    speaker: string | undefined;
+    text: string;
+    tags: readonly string[];
+}
+export interface ShownChoice {
+    /** What to pass to `choose`. */
+    index: number;
+    text: string;
+    /** False for a `showLocked` choice whose condition fails: drawn, but not pickable. */
+    enabled: boolean;
+}
+export interface ShownChoices {
+    type: 'choices';
+    node: string;
+    choices: ShownChoice[];
+}
+export interface DialogueEnd {
+    type: 'end';
+}
+/** Where a dialogue stands: a line to show, choices to offer, or the end. */
+export type DialogueStep = ShownLine | ShownChoices | DialogueEnd;
+//# sourceMappingURL=script.d.ts.map

package/dist/types/dialogue/script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../../src/dialogue/script.ts"],"names":[],"mappings":"AAmBA,6FAA6F;AAC7F,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,oGAAoG;AACpG,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC;AAE1E,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,sGAAsG;IACtG,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sCAAsC;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,2GAA2G;AAC3G,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,6GAA6G;IAC7G,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;IACjC,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,sDAAsD;IACtD,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACrC;AAED,iFAAiF;AACjF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,KAAK,CAAC;CACb;AAED,6EAA6E;AAC7E,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC"}

package/dist/types/dialogue/validateDialogue.d.ts

@@ -0,0 +1,21 @@
+import type { DialogueScript } from './script.js';
+/** One fault in a script: where (`nodes.gate.choices[1].goto`), and what. */
+export interface DialogueIssue {
+    path: string;
+    message: string;
+    /** An error stops the dialogue when reached; a warning is likely a slip (a node nothing leads to). */
+    level: 'error' | 'warning';
+}
+export interface ValidateOptions {
+    /** The commands the game handles; when given, a `do` naming another is an error. */
+    commands?: readonly string[];
+    /** The functions the game registered, beside `visited` and `chose`; when given, a call to another is an error. */
+    functions?: readonly string[];
+}
+/**
+ * Checks a script without running it, for a test or an editor: every `goto` and `next` names a node, every condition,
+ * assignment and `{…}` parses, commands and functions are known (when the lists are given), and every node can be
+ * reached from the start.
+ */
+export declare function validateDialogue(script: DialogueScript, options?: ValidateOptions): DialogueIssue[];
+//# sourceMappingURL=validateDialogue.d.ts.map

package/dist/types/dialogue/validateDialogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateDialogue.d.ts","sourceRoot":"","sources":["../../../src/dialogue/validateDialogue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,UAAU,CAAC;AAEhE,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,sGAAsG;IACtG,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,kHAAkH;IAClH,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,eAAoB,GAAG,aAAa,EAAE,CAqFvG"}

package/dist/types/ecs/prefab.d.ts

@@ -0,0 +1,84 @@
+import type { FieldSpec, FieldsType, FieldValues } from './fields.js';
+import type { ComponentType, Entity, World } from './World.js';
+/** What a prefab's factory values are given: the entity being made and the spawn's own `args`. */
+export interface PrefabContext<A> {
+    entity: Entity;
+    args: A;
+}
+/**
+ * A component's value in a prefab: plain data (copied afresh for every entity, so no two share an object), or a
+ * factory called once per entity, for what cannot be copied (a class instance, a sprite) or must differ (a random
+ * roll, a position from the spawn's args). `null` in a variant takes away a component its base has.
+ */
+export type PrefabValue<T, A = unknown> = T | ((ctx: PrefabContext<A>) => T);
+export type PrefabPart<A = unknown> = readonly [ComponentType<unknown>, PrefabValue<unknown, A> | null];
+/**
+ * One part of a prefab, typed: the value is checked against the component's type, and a factory's `ctx` is known.
+ * A bare `[type, value]` tuple works too, unchecked.
+ */
+export declare function prefabPart<S extends FieldSpec, A = unknown>(type: FieldsType<S>, value: PrefabValue<FieldValues<S>, A> | null): PrefabPart<A>;
+export declare function prefabPart<T, A = unknown>(type: ComponentType<T>, value: PrefabValue<T, A> | null): PrefabPart<A>;
+/** A template for entities: the components each gets, with their starting values. */
+export interface Prefab<A = unknown> {
+    readonly name: string;
+    /** The components, the base's merged in: a variant's plain-object values are laid over the base's field by field. */
+    readonly parts: ReadonlyMap<ComponentType<unknown>, PrefabValue<unknown, A>>;
+    readonly base: Prefab<A> | null;
+}
+export interface PrefabOptions<A> {
+    /** The prefab this is a variant of: everything it has, with these parts laid over. */
+    extends?: Prefab<A>;
+}
+/**
+ * Defines a prefab.
+ *
+ * ```ts
+ * const Monster = definePrefab('monster', [prefabPart(Health, { hp: 10, max: 10 }), prefabPart(Brain, () => tree.agent())]);
+ * const Boss = definePrefab('boss', [prefabPart(Health, { hp: 200, max: 200 }), prefabPart(Flying, null)], { extends: Monster });
+ * spawnPrefab(world, Boss, { with: [[Position, { x: 40, y: 80 }]] });
+ * ```
+ */
+export declare function definePrefab<A = unknown>(name: string, parts: readonly PrefabPart<A>[], options?: PrefabOptions<A>): Prefab<A>;
+export interface SpawnOptions<A> {
+    /** Components added or replaced for this entity only (laid over the prefab's like a variant's). */
+    with?: readonly PrefabPart<A>[];
+    /** Components of the prefab this entity goes without. */
+    without?: readonly ComponentType<unknown>[];
+    /** Handed to every factory value. */
+    args?: A;
+}
+/** Makes one entity from a prefab: each component's value copied, or made by its factory. */
+export declare function spawnPrefab<A = unknown>(world: World, prefab: Prefab<A>, options?: SpawnOptions<A>): Entity;
+/** Whether `prefab` is `of` or a variant of it, however far down. */
+export declare function isPrefabOf(prefab: Prefab<never> | Prefab<unknown>, of: Prefab<never> | Prefab<unknown>): boolean;
+/** Prefabs as data: `{ "goblin": { "extends": "monster", "components": { "Health": { "hp": 6 }, "Flying": null } } }`. */
+export type PrefabData = Record<string, {
+    extends?: string;
+    components?: Record<string, unknown>;
+}>;
+/**
+ * Prefabs by name, loadable from data a designer edits. Components are named through `component(name, type)`;
+ * a value in the data is plain JSON, so factories (a sprite, a brain) are given in code with `factory`.
+ */
+export declare class PrefabLibrary {
+    private readonly types;
+    private readonly factories;
+    private readonly prefabs;
+    /** Lets data name a component type. */
+    component(name: string, type: ComponentType<unknown>): this;
+    /** A value made in code for a prefab loaded from data (and its variants): the data cannot hold a function. */
+    factory<T>(prefab: string, type: ComponentType<T>, make: (ctx: PrefabContext<unknown>) => T): this;
+    /** Adds a prefab made in code. */
+    add(prefab: Prefab): this;
+    /**
+     * Builds the prefabs of `data`, bases before their variants (in any order in the data), and adds them. Throws,
+     * naming the prefab, on an unknown component or base, or a prefab that extends itself.
+     */
+    load(data: PrefabData): this;
+    get(name: string): Prefab;
+    has(name: string): boolean;
+    names(): string[];
+    /** `spawnPrefab` by name. */
+    spawn<A = unknown>(world: World, name: string, options?: SpawnOptions<A>): Entity;
+}
+//# sourceMappingURL=prefab.d.ts.map

package/dist/types/ecs/prefab.d.ts.map

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

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