1681-engine 0.0.0-stage → 0.5.8

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

@@ -0,0 +1,26 @@
+import { type Color, PixelGrid } from './pixel.js';
+export interface PropArt {
+    canvas: HTMLCanvasElement;
+    anchorX: number;
+    anchorY: number;
+}
+export declare function art(g: PixelGrid, anchorX: number, anchorY: number): PropArt;
+/**
+ * The selective outline a prop takes, lit from the upper left like the map: the same ring a plain outline lays, but
+ * full dark only where the silhouette meets the ground (under it) and on its shadow side (the right); along the top
+ * and the left it is the darkest tone of the fill it borders (`outlineOf`), so a lit edge reads as the thing's own
+ * shade rather than a sticker's line. Translucent pixels (a cast
+ * shadow on the ground) are not part of the silhouette.
+ */
+export declare function litOutline(g: PixelGrid, dark?: Color): void;
+/**
+ * A soft shadow thrown down and to the right onto the ground, laid only on empty pixels (call it after `litOutline`,
+ * or the outline would ring the shadow): a darker `core` and a fainter `rim`, by default a translucent violet.
+ */
+export declare function groundShadow(g: PixelGrid, cx: number, cy: number, rx: number, ry: number, core?: Color, rim?: Color): void;
+/**
+ * Moves every opaque pixel of a box one step into shadow (or, with `f > 1`, into light) along its own hue: the eave's
+ * shadow on a wall, the dark side of a chimney, a porch's shade. `mask` limits it to some pixels of the box.
+ */
+export declare function shadeBox(g: PixelGrid, x: number, y: number, w: number, h: number, f: number, mask?: (x: number, y: number) => boolean): void;
+//# sourceMappingURL=propKit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"propKit.d.ts","sourceRoot":"","sources":["../../../src/pixel/propKit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,KAAK,EAAE,SAAS,EAAQ,MAAM,SAAS,CAAC;AAQtD,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,GAAE,KAAiB,GAAG,IAAI,CAetE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,KAAmB,EAAE,GAAG,GAAE,KAAkB,GAAG,IAAI,CAUnJ;AAUD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAQ5I"}

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

@@ -0,0 +1,57 @@
+import { type Color } from './pixel.js';
+/** The materials every game starts with. */
+export type BuiltinMaterial = 'cloth' | 'leather' | 'mail' | 'plate' | 'dragon' | 'fur' | 'skin' | 'hair' | 'gold' | 'gem' | 'shadow';
+/** A built-in material or one a game registered (`registerMaterial`). */
+export type Material = BuiltinMaterial | (string & {});
+/** How a material's shadows and lights move its hue. */
+export interface MaterialLight {
+    /** Hue (degrees) a shadow drifts toward, and how far it drifts at a factor of 0.5. */
+    cool: number;
+    coolDeg: number;
+    /** Saturation a shadow gains at a factor of 0.5. */
+    coolSat: number;
+    /** Hue a light drifts toward, and how far it drifts at a factor of 1.3. */
+    warm: number;
+    warmDeg: number;
+}
+/** Tones of one colour in one material, darkest to brightest. `base` is the colour itself. */
+export interface Ramp {
+    /** Under-edges, rivets, seams: the darkest tone that is still the material. */
+    deep: Color;
+    dark: Color;
+    mid: Color;
+    base: Color;
+    light: Color;
+    /** One specular pixel: a plate's glint, a strand of hair, a buckle. */
+    glint: Color;
+}
+/** Five shading factors, darkest to brightest. */
+export type RampFactors = [number, number, number, number, number];
+/** Every registered material, built-in ones first. */
+export declare const MATERIALS: readonly Material[];
+/** Every factor a ramp or a painter shades by — what a recolour or a fine-pass mask has to recognise. */
+export declare const RAMP_FACTOR_SET: readonly number[];
+/**
+ * Adds a material, or changes a built-in one: how its shadows and lights drift (`light`) and the five factors its
+ * ramp is built from, darkest to brightest (`factors`, around 1: below darkens, above lifts). Register before painting
+ * with it; tones already worked out for that material are forgotten.
+ */
+export declare function registerMaterial(name: string, material: {
+    light: MaterialLight;
+    factors: RampFactors;
+}): void;
+/**
+ * `c` shaded by `f` the way `shade` would (f < 1 darkens, f > 1 lifts toward white), with the hue moved the way
+ * `material` moves it. `f === 1` returns `c` itself. A colour with too little saturation to have a hue (steel,
+ * grey wool, white linen) takes the material's hue outright, faintly, so a grey coat still has a violet shadow.
+ */
+export declare function hueShade(c: Color, f: number, material: Material): Color;
+export declare function ramp(c: Color, material: Material): Ramp;
+/** Every tone of `c`'s ramp, for masking a material cue to that material. */
+export declare function rampTones(c: Color, material: Material): Color[];
+/**
+ * The selective-outline tone of a fill: its own hue, cooled and pushed dark enough to hold an edge against grass
+ * (value at most 0.3), so the outline on the lit side is the fill's own darkest shade instead of flat black.
+ */
+export declare function outlineOf(c: Color): Color;
+//# sourceMappingURL=ramp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ramp.d.ts","sourceRoot":"","sources":["../../../src/pixel/ramp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAA8B,MAAM,SAAS,CAAC;AAajE,4CAA4C;AAC5C,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AACtI,yEAAyE;AACzE,MAAM,MAAM,QAAQ,GAAG,eAAe,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEvD,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAsBD,8FAA8F;AAC9F,MAAM,WAAW,IAAI;IACnB,+EAA+E;IAC/E,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,KAAK,CAAC;IACX,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,uEAAuE;IACvE,KAAK,EAAE,KAAK,CAAC;CACd;AAED,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAiBnE,sDAAsD;AACtD,eAAO,MAAM,SAAS,EAAE,SAAS,QAAQ,EAAuB,CAAC;AAEjE,yGAAyG;AACzG,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAAqD,CAAC;AAEnG;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG,IAAI,CAO7G;AAyCD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,KAAK,CA2BvE;AAID,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CASvD;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAG,KAAK,EAAE,CAG/D;AAID;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAQzC"}

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

@@ -0,0 +1,3 @@
+import type { Color, PixelGrid } from './pixel.js';
+export declare function selectiveOutline(g: PixelGrid, width?: number, dark?: Color): void;
+//# sourceMappingURL=selout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selout.d.ts","sourceRoot":"","sources":["../../../src/pixel/selout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAYhD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,SAAI,EAAE,IAAI,GAAE,KAAiB,GAAG,IAAI,CAmDvF"}

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

@@ -0,0 +1,29 @@
+import type { Image } from '../core/Image.js';
+/** One opaque world pixel of a sprite frame: offset from the frame's feet (origin 0.5, 1) and its colour. */
+export interface SpritePixel {
+    dx: number;
+    dy: number;
+    color: number;
+}
+/**
+ * A frame's opaque pixels packed in typed arrays (12 bytes a pixel instead of an object each). Iterating hands out one
+ * reused `SpritePixel`, so read it in the loop and keep nothing of it; `at(i)` reads one into a given object.
+ */
+export declare class PackedPixels implements Iterable<SpritePixel> {
+    readonly dx: Float32Array;
+    readonly dy: Float32Array;
+    readonly color: Uint32Array;
+    readonly length: number;
+    constructor(dx: Float32Array, dy: Float32Array, color: Uint32Array, length: number);
+    [Symbol.iterator](): Iterator<SpritePixel>;
+}
+/** No pixels: what a body hands over when there is nothing of it worth lifting (a death with nothing to evaporate). */
+export declare const NO_PIXELS: PackedPixels;
+/**
+ * The opaque pixels of an image's current frame, one per **world** pixel (`artScale` image pixels to one), as offsets
+ * from the frame's feet in unscaled, unflipped world pixels. Read straight off the texture's canvas, so it is the
+ * frame actually on screen. Atlas frames are shared by every body of one kind and cached (least recently read out
+ * first); a texture repainted while in use (a rig body) is read fresh.
+ */
+export declare function spritePixels(img: Image, artScale: number, live: boolean): PackedPixels;
+//# sourceMappingURL=spritePixels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spritePixels.d.ts","sourceRoot":"","sources":["../../../src/pixel/spritePixels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,6GAA6G;AAC7G,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,qBAAa,YAAa,YAAW,QAAQ,CAAC,WAAW,CAAC;IAEtD,QAAQ,CAAC,EAAE,EAAE,YAAY;IACzB,QAAQ,CAAC,EAAE,EAAE,YAAY;IACzB,QAAQ,CAAC,KAAK,EAAE,WAAW;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAHd,EAAE,EAAE,YAAY,EAChB,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,MAAM;IAGxB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,WAAW,CAAC;CAS5C;AAGD,uHAAuH;AACvH,eAAO,MAAM,SAAS,cAAQ,CAAC;AAwB/B;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,YAAY,CA+CtF"}

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

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

@@ -0,0 +1,32 @@
+import type { EaseFn } from '../core/eases.js';
+/** One running change of a number over time. */
+export interface FxAnimation {
+    /** Called with the eased value every frame, and with `to` at the end. */
+    set: (value: number) => void;
+    from: number;
+    to: number;
+    ms: number;
+    ease: EaseFn;
+    /** Runs once after the last `set`. */
+    done?: () => void;
+    elapsed: number;
+    /** A key that cancels whatever animation already holds it (one flash at a time, say). */
+    key?: string;
+}
+/**
+ * Advances numbers over time for the post effects: a flash fading, a shockwave growing, a vignette breathing. Pure,
+ * so it is tested without a renderer; `PostFx` steps it on every frame.
+ */
+export declare class FxAnimator {
+    private readonly list;
+    get size(): number;
+    /** Starts an animation; one with the same `key` as a running one replaces it (the old one's `done` still runs). */
+    run(a: Omit<FxAnimation, 'elapsed' | 'ease'> & {
+        ease?: EaseFn;
+    }): void;
+    /** Moves every animation on by `ms`; finished ones set their last value, call `done` and are dropped. */
+    step(ms: number): void;
+    /** Ends everything at once, each at its last value. */
+    finishAll(): void;
+}
+//# sourceMappingURL=fxAnimator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fxAnimator.d.ts","sourceRoot":"","sources":["../../../src/postfx/fxAnimator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,yEAAyE;IACzE,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,yFAAyF;IACzF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAID;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAE1C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,mHAAmH;IACnH,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAevE,yGAAyG;IACzG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAatB,uDAAuD;IACvD,SAAS,IAAI,IAAI;CAMlB"}