1681-engine 0.0.0-stage → 0.5.9

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

@@ -0,0 +1,72 @@
+/**
+ * - `crown`: a tree; the canopy above the trunk sways, the trunk found in the pixels (`trunkPivot`);
+ * - `top`: the top `top` share of the frame sways (a bush, a reed clump);
+ * - `hang`: a cloth hanging off a bar (`cloth`), each pair of rows swinging wider and later down it;
+ * - `tufts`: only the given rects move (reeds painted into a bigger sprite), per variant.
+ */
+export type SwayMode = 'crown' | 'top' | 'hang' | 'tufts';
+/** [x0, y0, x1, y1) in the frame's pixels, and an optional weight (share of the full reach, default 1). */
+export type TuftRect = readonly [number, number, number, number] | readonly [number, number, number, number, number];
+export interface SwayDef {
+    mode: SwayMode;
+    /** `top`: the share of the frame's height, from its top, that moves. */
+    top?: number;
+    /** `hang`: the cloth, [x0, y0, x1, y1) in the frame's pixels. */
+    cloth?: readonly [number, number, number, number];
+    /** `tufts`: the moving rects per variant ("*" for every variant without its own). */
+    tufts?: Readonly<Record<string, readonly TuftRect[]>>;
+    /** Whole world pixels of reach at wind 1. */
+    amp: number;
+    /** Sway cycles a second. */
+    speed: number;
+}
+export interface Rect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface SwayStrip {
+    rect: Rect;
+    /** Share of the full reach this strip moves (the crown's top moves furthest, a banner's hem most). */
+    weight: number;
+    /** How far behind the top of the prop this strip swings, in cycles: the wave runs down a banner. */
+    lag: number;
+}
+export interface SwayRig {
+    pieces: Rect[];
+    strips: SwayStrip[];
+}
+/**
+ * The first row of a tree's trunk (the canopy is every row above it), from the width of the opaque run on each row
+ * of its sprite (0 = empty). The trunk is the longest run of narrow rows in the lower part of the sprite, "narrow"
+ * meaning within two pixels of the narrowest row there — so a root flare at the foot does not end it. Null when
+ * the sprite has no trunk worth the name (a bush, a heap of reeds).
+ */
+export declare function trunkPivot(widths: readonly number[]): number | null;
+/**
+ * The frame `w`x`h` less the given rects (which must not overlap), as rects: cut into row bands at every rect's
+ * top and bottom, and each band into the runs no rect covers.
+ */
+export declare function complement(w: number, h: number, holes: Rect[]): Rect[];
+/**
+ * The rig for one prop frame `w`x`h`. `rowWidths` is only read by a `crown`, whose pivot comes from the pixels
+ * (without it, or without a trunk in them, the crown falls back to the top 60%). `variant` is only read by
+ * `tufts`, whose rects are drawn per variant.
+ */
+export declare function buildRig(def: SwayDef, w: number, h: number, rowWidths?: readonly number[], variant?: number): SwayRig;
+/** A stable [0, 1) per tile (or any two integers), so each prop keeps its own phase and pace from one visit to the next. */
+export declare function tileHash(tx: number, ty: number, salt?: number): number;
+/** A gust rolling across the world from the west: every tree it passes bends a little further, then less. */
+export declare function gustAt(tSec: number, worldX: number, gustSeconds: number, gustPx: number): number;
+/**
+ * How many whole pixels a strip stands off at `tSec`: a main swing with a slower second one riding it (so no two
+ * trees ever meet in step), leaning a little downwind as the wind rises, scaled by the reach, the wind, the gust
+ * and the strip's weight, and rounded — the sway moves in pixel steps, 0 → 1 → 0, never smeared between them.
+ *
+ * `minReach` is the least that reach × wind × gust may come to while any wind blows (a still place's
+ * floor, chosen by the game): without it a faint breeze never rounds to a whole pixel and the trees stand dead still, and
+ * rounding is the rule, so the floor is what lets the crest of a swing tick one pixel over and back.
+ */
+export declare function swayOffset(tSec: number, speed: number, phase: number, lag: number, amp: number, wind: number, gust: number, weight: number, minReach?: number): number;
+//# sourceMappingURL=swayRig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"swayRig.d.ts","sourceRoot":"","sources":["../../../src/pixel/swayRig.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1D,2GAA2G;AAC3G,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAErH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,KAAK,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,qFAAqF;IACrF,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC,CAAC,CAAC;IACtD,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AACD,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,sGAAsG;IACtG,MAAM,EAAE,MAAM,CAAC;IACf,oGAAoG;IACpG,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,IAAI,EAAE,CAAC;IACf,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAoBnE;AAcD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAgBtE;AAgBD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,SAAI,GAAG,OAAO,CA6BhH;AAED,4HAA4H;AAC5H,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,MAAM,CAMjE;AAED,6GAA6G;AAC7G,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhG;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,SAAI,GACX,MAAM,CAOR"}

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

@@ -0,0 +1,16 @@
+/**
+ * The pure half of `DitherVignette`: which pixels of a `w`×`h` screen (in world pixels) the edge sets, its falloff an
+ * ordered 4×4 Bayer dither rather than a gradient — the grammar `Darkness` lights the night in, so the edge reads as
+ * pixel art and not as a blur over it.
+ */
+/**
+ * One byte a pixel, 1 where the edge is set. `strength` (0..1) is the share of pixels set at the very corner; `from`
+ * (0..1) is how far from the centre toward a corner the edge begins.
+ */
+export declare function vignetteMask(w: number, h: number, strength: number, from?: number): Uint8Array;
+/**
+ * A pulse's opacity at `now` (ms): a quick rise and a slower fall, a beat every `slowMs` at `urgency` 0 quickening to
+ * every `fastMs` at 1, deeper as it quickens, in `steps` levels rather than a smooth swell (0 for smooth).
+ */
+export declare function heartbeat(now: number, urgency: number, steps?: number, slowMs?: number, fastMs?: number): number;
+//# sourceMappingURL=vignetteMask.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vignetteMask.d.ts","sourceRoot":"","sources":["../../../src/pixel/vignetteMask.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,SAAO,GAAG,UAAU,CAe5F;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,SAAI,EAAE,MAAM,SAAO,EAAE,MAAM,SAAM,GAAG,MAAM,CAOtG"}

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

@@ -0,0 +1,29 @@
+import type { TextureRegistry } from '../core/TextureRegistry.js';
+import type { WeatherLook } from '../ambient/WeatherLayer.js';
+/** A pixel of weather art: x, y and a CSS colour. */
+export type WeatherPixel = readonly [x: number, y: number, color: string];
+/** The colours the weather is painted in; every one may be replaced to suit a game's palette. */
+export interface WeatherColors {
+    rainHead: string;
+    rainBody: string;
+    rainTail: string;
+    snow: string;
+    snowShade: string;
+    ashLight: string;
+    ash: string;
+    ashDark: string;
+    ember: string;
+    emberDeep: string;
+    mist: string;
+}
+export declare const WEATHER_COLORS: WeatherColors;
+/** A bank of mist: pixels on a checkerboard, denser toward its middle, ragged at every edge. Pure and seeded. */
+export declare function mistPixels(w: number, h: number, seed: number, color: string): WeatherPixel[];
+/**
+ * Paints a set of weather in whole world pixels, flat colours and never a soft glow (a rain streak is the size of a
+ * pixel of the roof it falls past; light from the up-left, so a flake's lit pixel is its top-left one), and returns
+ * looks ready for `WeatherLayer`: `rain`, `snow`, `ash` (with an ember now and then) and `fog`. Painted once; a key
+ * already in the registry is kept.
+ */
+export declare function paintWeatherArt(textures: TextureRegistry, colors?: Partial<WeatherColors>, prefix?: string): Record<'rain' | 'snow' | 'ash' | 'fog', WeatherLook>;
+//# sourceMappingURL=weatherArt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"weatherArt.d.ts","sourceRoot":"","sources":["../../../src/pixel/weatherArt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,qDAAqD;AACrD,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAE1E,iGAAiG;AACjG,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,cAAc,EAAE,aAY5B,CAAC;AAEF,iHAAiH;AACjH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAgB5F;AAgBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,eAAe,EACzB,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,EACnC,MAAM,SAAQ,GACb,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,EAAE,WAAW,CAAC,CAgCtD"}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,10 @@
+/** A native shell (Capacitor, Electron touch kiosk…) tells the engine it is one; browsers leave it false. */
+export declare function setNativeShell(native: boolean): void;
+/**
+ * The `localStorage` key that forces the touch controls on or off (`'1'`/`'0'`, beside `?touch=1|0` in the URL), for
+ * trying them on a desktop browser. A game names its own so its players' saved choice carries over.
+ */
+export declare function setTouchOverrideKey(key: string): void;
+/** True when the game is played with fingers (decided once per launch, `detectTouch`). */
+export declare function isTouchUi(): boolean;
+//# sourceMappingURL=touch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"touch.d.ts","sourceRoot":"","sources":["../../../src/platform/touch.ts"],"names":[],"mappings":"AAMA,6GAA6G;AAC7G,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAGpD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGrD;AAqBD,0FAA0F;AAC1F,wBAAgB,SAAS,IAAI,OAAO,CAGnC"}

package/dist/types/postfx/BloomFilter.d.ts

@@ -0,0 +1,33 @@
+import { type FilterSystem, type RenderSurface, type Texture } from 'pixi.js';
+import { FxFilter } from './fxShader.js';
+export interface BloomOptions {
+    /** Brightness (0–1, the brightest channel) from which a pixel glows (default 0.7). */
+    threshold?: number;
+    /** How gradually the glow comes in above the threshold (default 0.2). */
+    knee?: number;
+    /** How strongly the glow is added back (default 1). */
+    intensity?: number;
+    /** Blur strength of the glow, pixels (default 8). */
+    blur?: number;
+    /** Blur quality: passes (default 4). */
+    quality?: number;
+}
+/**
+ * Bright things glow: the pixels above a threshold are blurred and added back over the picture. Three passes (bright,
+ * blur, combine) on textures from Pixi's pool; costlier than the one-pass effects, so give it a `filterArea` or put it
+ * on the world layer only.
+ */
+export declare class BloomFilter extends FxFilter {
+    private readonly bright;
+    private readonly blurPass;
+    constructor(options?: BloomOptions);
+    get intensity(): number;
+    set intensity(v: number);
+    get threshold(): number;
+    set threshold(v: number);
+    get blur(): number;
+    set blur(v: number);
+    apply(filterManager: FilterSystem, input: Texture, output: RenderSurface, clearMode: boolean): void;
+    destroy(): void;
+}
+//# sourceMappingURL=BloomFilter.d.ts.map

package/dist/types/postfx/BloomFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BloomFilter.d.ts","sourceRoot":"","sources":["../../../src/postfx/BloomFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AACvG,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,WAAW,YAAY;IAC3B,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAuBD;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,QAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;gBAE1B,OAAO,GAAE,YAAiB;IActC,IAAI,SAAS,IAAI,MAAM,CAEtB;IACD,IAAI,SAAS,CAAC,CAAC,EAAE,MAAM,EAEtB;IACD,IAAI,SAAS,IAAI,MAAM,CAEtB;IACD,IAAI,SAAS,CAAC,CAAC,EAAE,MAAM,EAEtB;IACD,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,EAEjB;IAEQ,KAAK,CAAC,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAWnG,OAAO,IAAI,IAAI;CAKzB"}

package/dist/types/postfx/ChromaticAberrationFilter.d.ts

@@ -0,0 +1,11 @@
+import { FxFilter } from './fxShader.js';
+/**
+ * Splits red and blue apart towards the edges, `offset` pixels at a corner: a hit's jolt, a dream, a cheap lens.
+ * Nothing at the centre of the screen moves.
+ */
+export declare class ChromaticAberrationFilter extends FxFilter {
+    constructor(offset?: number);
+    get offset(): number;
+    set offset(v: number);
+}
+//# sourceMappingURL=ChromaticAberrationFilter.d.ts.map

package/dist/types/postfx/ChromaticAberrationFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChromaticAberrationFilter.d.ts","sourceRoot":"","sources":["../../../src/postfx/ChromaticAberrationFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,QAAQ;gBACzC,MAAM,SAAI;IAatB,IAAI,MAAM,IAAI,MAAM,CAEnB;IACD,IAAI,MAAM,CAAC,CAAC,EAAE,MAAM,EAEnB;CACF"}

package/dist/types/postfx/ColorAdjustFilter.d.ts

@@ -0,0 +1,32 @@
+import { FxFilter } from './fxShader.js';
+export interface ColorAdjustOptions {
+    /** Multiplies every channel (default 1). */
+    brightness?: number;
+    /** 1 unchanged, 0 flat grey, above 1 punchier (default 1). */
+    contrast?: number;
+    /** 1 unchanged, 0 greyscale (default 1). */
+    saturation?: number;
+    /** A colour multiplied in by `tintAmount` (default white, 0). */
+    tint?: number;
+    tintAmount?: number;
+}
+/**
+ * Brightness, contrast, saturation and a tint, all animatable, plus a flash: the whole screen washed towards a colour
+ * (`flash` 0–1, `flashColor`), for a hit, a pickup or lightning. `PostFx.flash` drives it.
+ */
+export declare class ColorAdjustFilter extends FxFilter {
+    constructor(options?: ColorAdjustOptions);
+    get brightness(): number;
+    set brightness(v: number);
+    get contrast(): number;
+    set contrast(v: number);
+    get saturation(): number;
+    set saturation(v: number);
+    get flash(): number;
+    set flash(v: number);
+    set flashColor(c: number);
+    set tint(c: number);
+    get tintAmount(): number;
+    set tintAmount(v: number);
+}
+//# sourceMappingURL=ColorAdjustFilter.d.ts.map

package/dist/types/postfx/ColorAdjustFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorAdjustFilter.d.ts","sourceRoot":"","sources":["../../../src/postfx/ColorAdjustFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAO,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,OAAO,GAAE,kBAAuB;IAkC5C,IAAI,UAAU,IAAI,MAAM,CAEvB;IACD,IAAI,UAAU,CAAC,CAAC,EAAE,MAAM,EAEvB;IACD,IAAI,QAAQ,IAAI,MAAM,CAErB;IACD,IAAI,QAAQ,CAAC,CAAC,EAAE,MAAM,EAErB;IACD,IAAI,UAAU,IAAI,MAAM,CAEvB;IACD,IAAI,UAAU,CAAC,CAAC,EAAE,MAAM,EAEvB;IACD,IAAI,KAAK,IAAI,MAAM,CAElB;IACD,IAAI,KAAK,CAAC,CAAC,EAAE,MAAM,EAElB;IACD,IAAI,UAAU,CAAC,CAAC,EAAE,MAAM,EAEvB;IACD,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,EAEjB;IACD,IAAI,UAAU,IAAI,MAAM,CAEvB;IACD,IAAI,UAAU,CAAC,CAAC,EAAE,MAAM,EAEvB;CACF"}

package/dist/types/postfx/CrtFilter.d.ts

@@ -0,0 +1,16 @@
+import { FxFilter } from './fxShader.js';
+export interface CrtOptions {
+    /** 0–1, how dark the gaps between scanlines are (default 0.3). */
+    scanlines?: number;
+    /** Screen pixels per scanline (default 3). */
+    lineHeight?: number;
+    /** How much the glass bulges, 0 flat (default 0.08). */
+    curvature?: number;
+    /** 0–1, how much darker the bulged corners are (default 0.25). */
+    cornerShade?: number;
+}
+/** An old television: scanlines, a bulging glass with black beyond its edge, darker corners. */
+export declare class CrtFilter extends FxFilter {
+    constructor(options?: CrtOptions);
+}
+//# sourceMappingURL=CrtFilter.d.ts.map

package/dist/types/postfx/CrtFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrtFilter.d.ts","sourceRoot":"","sources":["../../../src/postfx/CrtFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,gGAAgG;AAChG,qBAAa,SAAU,SAAQ,QAAQ;gBACzB,OAAO,GAAE,UAAe;CAmCrC"}

package/dist/types/postfx/PixelateFilter.d.ts

@@ -0,0 +1,8 @@
+import { FxFilter } from './fxShader.js';
+/** Shows the screen in blocks of `size` pixels: a transition's dissolve, a retro mode, a censor box. 1 is off. */
+export declare class PixelateFilter extends FxFilter {
+    constructor(size?: number);
+    get size(): number;
+    set size(v: number);
+}
+//# sourceMappingURL=PixelateFilter.d.ts.map

package/dist/types/postfx/PixelateFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PixelateFilter.d.ts","sourceRoot":"","sources":["../../../src/postfx/PixelateFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,kHAAkH;AAClH,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,IAAI,SAAI;IAepB,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,EAEjB;CACF"}

package/dist/types/postfx/PostFx.d.ts

@@ -0,0 +1,92 @@
+import { Container, Rectangle, type Filter } from 'pixi.js';
+import { type EaseFn } from '../core/eases.js';
+import type { Engine } from '../engine/Engine.js';
+import { ColorAdjustFilter } from './ColorAdjustFilter.js';
+import { FxAnimator } from './fxAnimator.js';
+import { type ShockwaveOptions } from './ShockwaveFilter.js';
+export interface PostFxOptions {
+    /**
+     * What the effects lie over: 'all' (default) the whole picture, HUD included; 'world' the camera's layer only, so
+     * the HUD stays sharp; or any container.
+     */
+    layer?: 'all' | 'world' | Container;
+    /**
+     * Fills the screen behind the picture with this colour (default the renderer's background when `layer` is 'all').
+     * Effects only see what is drawn: without a backdrop the empty background stays untouched by a vignette or a flash.
+     * `false` for none.
+     */
+    backdrop?: number | false;
+    /** Skip flashes and shockwaves while the player asked for reduced effects (default true). */
+    honourReducedFx?: boolean;
+}
+export interface FlashOptions {
+    color?: number;
+    /** Peak strength, 0–1 (default 0.6). */
+    strength?: number;
+    ms?: number;
+}
+export interface ShockwaveRun extends ShockwaveOptions {
+    /** How far the ring travels, as a share of the screen's height (default 0.6). */
+    reach?: number;
+    ms?: number;
+}
+/**
+ * Full-screen effects over a game: a chain of filters (vignette, bloom, a colour grade, CRT, pixelate…) laid over the
+ * picture in the order added, switched on and off one by one, and short effects that come and go — a flash, a
+ * shockwave, any uniform animated over time. One per engine is plenty; give it to the scenes that want it.
+ *
+ * ```ts
+ * const post = PostFx.forEngine(engine);
+ * const vignette = post.add(new VignetteFilter({ strength: 0.4 }));
+ * post.add(new BloomFilter({ threshold: 0.75 }));
+ * post.flash({ color: 0xffffff, ms: 120 }); // a hit
+ * post.shockwave(x, y); // screen pixels: an explosion
+ * post.animate((v) => (vignette.strength = v), 0.4, 0.8, 300, 'Sine.InOut'); // a heartbeat
+ * ```
+ */
+export declare class PostFx {
+    readonly target: Container;
+    /** The screen rectangle, live (the renderer's `screen`): what is filtered, and how screen points map to it. */
+    private readonly screen;
+    private readonly options;
+    readonly animator: FxAnimator;
+    private readonly chain;
+    private transient;
+    private colorFx;
+    private backdropSprite;
+    private offFrame;
+    /** The screen in the target's own coordinates: the filtered area, refreshed every frame as a camera moves. */
+    private readonly area;
+    constructor(target: Container, 
+    /** The screen rectangle, live (the renderer's `screen`): what is filtered, and how screen points map to it. */
+    screen: Rectangle, options?: PostFxOptions);
+    /** A `PostFx` over an engine's picture, stepped on its frames. */
+    static forEngine(engine: Engine, options?: PostFxOptions): PostFx;
+    /** Adds an effect at the end of the chain (or at `index`) and returns it. */
+    add<T extends Filter>(filter: T, index?: number): T;
+    /** Takes an effect out (it is not destroyed: add it back later, or destroy it yourself). */
+    remove(filter: Filter): void;
+    /** Turns an effect on or off without taking it out of its place. */
+    setEnabled(filter: Filter, on: boolean): void;
+    isEnabled(filter: Filter): boolean;
+    /** Every effect in the chain, in order. */
+    get filters(): readonly Filter[];
+    /** Animates any number (a uniform, an effect's property) from `from` to `to` over `ms`. */
+    animate(set: (v: number) => void, from: number, to: number, ms: number, ease?: EaseFn | string, done?: () => void): void;
+    /** The whole picture washed towards a colour, fading out over `ms`. Skipped under reduced effects. */
+    flash(options?: FlashOptions): void;
+    /** A ring of bent picture spreading from a screen point (screen pixels). Skipped under reduced effects. */
+    shockwave(x: number, y: number, options?: ShockwaveRun): void;
+    /** The colour adjustment `flash` uses, made and put first in the chain the first time: brightness, saturation, a tint. */
+    get color(): ColorAdjustFilter;
+    /** Steps the animations; `forEngine` calls it on every frame. */
+    update(ms: number): void;
+    destroy(): void;
+    /** The screen rectangle mapped into the target's local space (a camera's layer is scaled and moved). */
+    private fitArea;
+    private get reduced();
+    private ensureColor;
+    private setBackdrop;
+    private apply;
+}
+//# sourceMappingURL=PostFx.d.ts.map

package/dist/types/postfx/PostFx.d.ts.map

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

package/dist/types/postfx/ShockwaveFilter.d.ts

@@ -0,0 +1,20 @@
+import { FxFilter } from './fxShader.js';
+export interface ShockwaveOptions {
+    /** Ring's width as a share of the screen's height (default 0.06). */
+    width?: number;
+    /** How far the ring pushes the picture, screen pixels (default 12). */
+    amplitude?: number;
+}
+/**
+ * A ring that bends the picture as it passes: an explosion's blast, a landing's thump. Set `centerX/Y` (0–1 across the
+ * filtered area) and grow `radius` (a share of its height) over time; `PostFx.shockwave` does both and removes it.
+ */
+export declare class ShockwaveFilter extends FxFilter {
+    constructor(options?: ShockwaveOptions);
+    setCenter(x: number, y: number): void;
+    get radius(): number;
+    set radius(v: number);
+    get amplitude(): number;
+    set amplitude(v: number);
+}
+//# sourceMappingURL=ShockwaveFilter.d.ts.map

package/dist/types/postfx/ShockwaveFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShockwaveFilter.d.ts","sourceRoot":"","sources":["../../../src/postfx/ShockwaveFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,GAAE,gBAAqB;IA4B1C,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAGrC,IAAI,MAAM,IAAI,MAAM,CAEnB;IACD,IAAI,MAAM,CAAC,CAAC,EAAE,MAAM,EAEnB;IACD,IAAI,SAAS,IAAI,MAAM,CAEtB;IACD,IAAI,SAAS,CAAC,CAAC,EAAE,MAAM,EAEtB;CACF"}

package/dist/types/postfx/VignetteFilter.d.ts

@@ -0,0 +1,19 @@
+import { FxFilter } from './fxShader.js';
+export interface VignetteOptions {
+    /** 0–1, how dark the corners go (default 0.5). */
+    strength?: number;
+    /** Where the darkening starts, as a share of the way from the centre to a corner (default 0.55). */
+    radius?: number;
+    /** How far beyond `radius` it reaches full strength (default 0.45). */
+    softness?: number;
+    /** What the edges fade to (default black); a red one is a classic low-health warning. */
+    color?: number;
+}
+/** Darkens the edges of the screen towards a colour, round whatever its shape. */
+export declare class VignetteFilter extends FxFilter {
+    constructor(options?: VignetteOptions);
+    get strength(): number;
+    set strength(v: number);
+    set color(c: number);
+}
+//# sourceMappingURL=VignetteFilter.d.ts.map

package/dist/types/postfx/VignetteFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VignetteFilter.d.ts","sourceRoot":"","sources":["../../../src/postfx/VignetteFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAO,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oGAAoG;IACpG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kFAAkF;AAClF,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,GAAE,eAAoB;IAsBzC,IAAI,QAAQ,IAAI,MAAM,CAErB;IACD,IAAI,QAAQ,CAAC,CAAC,EAAE,MAAM,EAErB;IAED,IAAI,KAAK,CAAC,CAAC,EAAE,MAAM,EAElB;CACF"}