zx-kit 0.38.1 → 0.40.0

package/README.md

@@ -187,6 +187,7 @@ Zero runtime dependencies, `sideEffects: false`, fully tree-shakeable.
 | `lighting` | Dithered cave darkness, one blit per frame | [rendering](docs/rendering.md#lightingts--dithered-cave-darkness) |
 | `audio` | 1-bit beeper: square-wave notes, patterns, stereo pan, volume + built-in auto-hide volume bar | [audio](docs/audio.md#audiots--beeper-audio) |
 | `ay` | AY-3-8912: 3-channel tone, LFSR noise, 16 envelopes, per-channel stereo pan + volume | [audio](docs/audio.md#ayts--ay-3-8912-melodik-audio) |
+| `aydump` | Real ZX-scene tunes: PSG register-dump player, sample-accurate AudioWorklet chip emulator | [audio](docs/audio.md#aydump--real-zx-scene-tunes-psg-register-dumps--experimental-037) |
 | `music` | AY music by note name (`A5`, `C#4`) + looping | [audio](docs/audio.md#musicts--note-name-ay-music) |
 | `collision` | AABB / rect-vs-tile / pixel-precise mask overlap | [collision](docs/collision.md) |
 | `save` | Typed save/load: versioning, migration, slots, throttle, optional tamper signature | [save](docs/save.md) |
@@ -230,6 +231,8 @@ zx-kit/
 │   ├── ay.ts              # AY-3-8912: createAY, playAY, AYChannel, AYNote, AYChip,
 │   │                      # AYHandle, AYStereoMode (pan / setStereoMode / volume / fade),
 │   │                      # AY_VOL, AY_CLOCK, AY_ENVELOPE_SHAPES
+│   ├── aydump.ts          # PSG register-dump player: parsePSG, loadPSG, playAYDump,
+│   │                      # renderAYDump (AudioWorklet AY/YM chip emulator)
 │   ├── music.ts           # noteToFreq, seq, playAYLoop (note-name AY music)
 │   ├── input.ts           # initInput, tickMovement, consumeFlag,
 │   │                      # consumePause, consumeDebug, consumeAnyKey,
@@ -248,6 +251,8 @@ zx-kit/
 │   ├── camera.ts          # scrolling viewport, lerp, deadzone, bounds
 │   ├── scene.ts           # stack-based scene manager
 │   ├── save.ts            # typed localStorage save/load with migrations
+│   ├── hiscore.ts         # high-score table over the save envelope:
+│   │                      # createHighScores, insertScore, isHighScore
 │   ├── presentation.ts    # blinkVisible, drawBlinkingText, drawTapeStripes, drawMenuOptions
 │   ├── debug.ts           # createDebugMonitor, beginFrame/endFrame, drawDebugOverlay
 │   └── i18n.ts            # pickLocale runtime locale selection

package/dist/attrscreen.d.ts

@@ -58,6 +58,10 @@ export interface AttrScreen {
     readonly cellInk: Uint32Array;
     /** Packed RGBA paper colour per cell, `cols*rows`. */
     readonly cellPaper: Uint32Array;
+    /** Per-cell **GLOW** flag — `1` = emissive light source (opt-in, like the FLASH
+     *  attribute bit). Set by `stampMono(..., glow=true)`; `0` otherwise. The normal
+     *  clash flush ignores it; {@link drawAttrGlowSources} feeds it to `glow.ts`. */
+    readonly cellGlow: Uint8Array;
     /** Resolved RGBA frame buffer (`width*height*4`), filled by {@link flushAttrScreen}. */
     readonly rgba: Uint8ClampedArray;
     /** Reusable `ImageData` backing {@link rgba} (`null` when headless). */
@@ -83,8 +87,25 @@ export declare function clearAttrScreen(scr: AttrScreen, paper: SpectrumColor, i
  * the pixel plane and re-attributes every cell that receives a lit pixel, per
  * `policy` (default `'both'`). Lit-pixel-only: existing pixels are never cleared,
  * so other sprites/background in a touched cell bleed to the new colour.
+ *
+ * **`glow`** (default `false`, opt-in): also flags every cell this stamp touches as
+ * an emissive GLOW source ({@link AttrScreen.cellGlow}), for `glow.ts`'s bloom via
+ * {@link drawAttrGlowSources}. Leaving it `false` is byte-for-byte the old behaviour.
+ */
+export declare function stampMono(scr: AttrScreen, bitmap: Bitmap, x: number, y: number, ink: SpectrumColor, paper: SpectrumColor, policy?: AttrPolicy, glow?: boolean): void;
+/**
+ * Draws every {@link AttrScreen.cellGlow}-flagged cell as a solid 8×8 block in its
+ * ink colour into the emissive context `g`. Use it as the `drawSources` callback of
+ * `glow.ts`'s `renderGlow`, so an attribute screen's glow cells feed the bloom.
+ * Cell-level, exactly like the FLASH bit — the whole flagged cell is the light
+ * source. Draws nothing when no cell is flagged; needs no canvas of its own.
+ *
+ * @example
+ * ```ts
+ * renderGlow(glowLayer, ctx, (g) => drawAttrGlowSources(scr, g))
+ * ```
  */
-export declare function stampMono(scr: AttrScreen, bitmap: Bitmap, x: number, y: number, ink: SpectrumColor, paper: SpectrumColor, policy?: AttrPolicy): void;
+export declare function drawAttrGlowSources(scr: AttrScreen, g: CanvasRenderingContext2D): void;
 /**
  * Resolves the two planes into RGBA (each pixel takes its cell's ink or paper)
  * and uploads the result with one `putImageData` + `drawImage`. The image is

package/dist/attrscreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attrscreen.d.ts","sourceRoot":"","sources":["../src/attrscreen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,OAAO,EAAQ,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAAA;AAE3D,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAA;IAC/B,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;IAChC,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;IAChC,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAC1C;AAqBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAK,EAAE,IAAI,SAAK,GAAG,UAAU,CAiCjE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,GAAE,aAAqB,GAAG,IAAI,CAIvG;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,EACd,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,aAAa,EACpB,MAAM,GAAE,UAAmB,GAC1B,IAAI,CA+BN;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,wBAAwB,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAoBpF"}
+{"version":3,"file":"attrscreen.d.ts","sourceRoot":"","sources":["../src/attrscreen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,OAAO,EAAQ,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAAA;AAE3D,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAA;IAC/B;;qFAEiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAA;IAC7B,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;IAChC,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;IAChC,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAC1C;AAqBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAK,EAAE,IAAI,SAAK,GAAG,UAAU,CAkCjE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,GAAE,aAAqB,GAAG,IAAI,CAKvG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,EACd,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,aAAa,EACpB,MAAM,GAAE,UAAmB,EAC3B,IAAI,UAAQ,GACX,IAAI,CAgCN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAWtF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,wBAAwB,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAoBpF"}

package/dist/attrscreen.js

@@ -89,6 +89,7 @@ export function createAttrScreen(cols = 32, rows = 24) {
         pixels: new Uint8Array(width * height),
         cellInk: new Uint32Array(cols * rows),
         cellPaper: new Uint32Array(cols * rows),
+        cellGlow: new Uint8Array(cols * rows),
         rgba,
         image,
         canvas,
@@ -103,6 +104,7 @@ export function clearAttrScreen(scr, paper, ink = paper) {
     scr.pixels.fill(0);
     scr.cellPaper.fill(hexToU32(paper));
     scr.cellInk.fill(hexToU32(ink));
+    scr.cellGlow.fill(0); // glow is per-frame opt-in — nothing glows until a stamp sets it
 }
 /**
  * Stamps a monochrome {@link Bitmap} at screen pixel `(x, y)` (rounded; may be
@@ -110,8 +112,12 @@ export function clearAttrScreen(scr, paper, ink = paper) {
  * the pixel plane and re-attributes every cell that receives a lit pixel, per
  * `policy` (default `'both'`). Lit-pixel-only: existing pixels are never cleared,
  * so other sprites/background in a touched cell bleed to the new colour.
+ *
+ * **`glow`** (default `false`, opt-in): also flags every cell this stamp touches as
+ * an emissive GLOW source ({@link AttrScreen.cellGlow}), for `glow.ts`'s bloom via
+ * {@link drawAttrGlowSources}. Leaving it `false` is byte-for-byte the old behaviour.
  */
-export function stampMono(scr, bitmap, x, y, ink, paper, policy = 'both') {
+export function stampMono(scr, bitmap, x, y, ink, paper, policy = 'both', glow = false) {
     const inkU32 = hexToU32(ink);
     const paperU32 = hexToU32(paper);
     const setInk = policy !== 'paper-only';
@@ -144,10 +150,37 @@ export function stampMono(scr, bitmap, x, y, ink, paper, policy = 'both') {
                     scr.cellInk[cell] = inkU32;
                 if (setPaper)
                     scr.cellPaper[cell] = paperU32;
+                if (glow)
+                    scr.cellGlow[cell] = 1;
             }
         }
     }
 }
+/**
+ * Draws every {@link AttrScreen.cellGlow}-flagged cell as a solid 8×8 block in its
+ * ink colour into the emissive context `g`. Use it as the `drawSources` callback of
+ * `glow.ts`'s `renderGlow`, so an attribute screen's glow cells feed the bloom.
+ * Cell-level, exactly like the FLASH bit — the whole flagged cell is the light
+ * source. Draws nothing when no cell is flagged; needs no canvas of its own.
+ *
+ * @example
+ * ```ts
+ * renderGlow(glowLayer, ctx, (g) => drawAttrGlowSources(scr, g))
+ * ```
+ */
+export function drawAttrGlowSources(scr, g) {
+    const { cellGlow, cellInk, cols, rows } = scr;
+    for (let row = 0; row < rows; row++) {
+        for (let col = 0; col < cols; col++) {
+            const cell = row * cols + col;
+            if (!cellGlow[cell])
+                continue;
+            const u = cellInk[cell]; // packed little-endian RGBA (a<<24 | b<<16 | g<<8 | r)
+            g.fillStyle = `rgba(${u & 0xff},${(u >> 8) & 0xff},${(u >> 16) & 0xff},${((u >>> 24) & 0xff) / 255})`;
+            g.fillRect(col * CELL, row * CELL, CELL, CELL);
+        }
+    }
+}
 /**
  * Resolves the two planes into RGBA (each pixel takes its cell's ink or paper)
  * and uploads the result with one `putImageData` + `drawImage`. The image is

package/dist/attrscreen.js.map

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

package/dist/glow.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @module glow
+ *
+ * **Optional phosphor GLOW / bloom — opt-in, purely additive.** The additive twin
+ * of {@link "lighting" | renderDarkness}: where lighting *subtracts* (dithered
+ * darkness), glow *adds* (a soft emissive bloom). A game marks its **light
+ * sources** — a torch, the moon, a sonar/radar blip — and their colour bleeds into
+ * the neighbours, so overlapping haloes sum into *perceived* extra colours **on the
+ * glass only**, while the crisp pixel-art framebuffer keeps its flat palette.
+ *
+ * **Emissive, not brighter (path B).** Glow is a marker on *sources of light*, not
+ * a lighter flat colour — the palette is never diluted. Everything the game does
+ * NOT draw into the glow layer stays exactly as before: this module adds new
+ * exports only, touches no existing render path, and a game that never calls
+ * {@link createGlowLayer} / {@link renderGlow} is byte-for-byte unaffected (it
+ * tree-shakes away).
+ *
+ * **Cheap bloom, no WebGL:** the emissive layer is **downscaled** to a small buffer
+ * and **upscaled** back with bilinear smoothing — that scaling IS the blur, for
+ * free — then blitted onto the frame with `globalCompositeOperation = 'lighter'`
+ * (additive). One offscreen buffer, a couple of `drawImage`s, headless-safe.
+ *
+ * @example
+ * ```ts
+ * const glow = createGlowLayer(256, 192)           // once, view-sized
+ * // each frame, AFTER drawing the scene, BEFORE scanlines:
+ * renderGlow(glow, ctx, (g) => {
+ *   drawGlowSource(g, { x: torchX, y: torchY, radius: 24, color: C.B_YELLOW, intensity: 0.9 })
+ *   drawGlowSource(g, { x: moonX,  y: moonY,  radius: 40, color: C.B_WHITE,  intensity: 0.5 })
+ *   // …or draw sprites/pixels directly for pixel-exact glow
+ * })
+ * ```
+ */
+import { type SpectrumColor } from './palette.js';
+/** Tunables for a {@link GlowLayer}. All optional; defaults are an eye-tuning start. */
+export interface GlowOptions {
+    /** Blur strength: the emissive layer is scaled down by this factor before the
+     *  bilinear upscale spreads it. Bigger = softer & cheaper. Clamped ≥ 1. Default `4`. */
+    downscale?: number;
+    /** How many additive blits of the bloom (brightness/saturation of the halo).
+     *  Clamped ≥ 1. Default `1`. */
+    passes?: number;
+    /** Global bloom strength, `0..1` — the `globalAlpha` of each additive blit.
+     *  Clamped to `0..1`. Default `0.5`. */
+    alpha?: number;
+}
+/** A view-sized glow layer: one emissive canvas + one downscale buffer. Allocate
+ *  once, reuse across frames. Both canvases are `null` when headless (no document). */
+export interface GlowLayer {
+    readonly width: number;
+    readonly height: number;
+    readonly downscale: number;
+    readonly passes: number;
+    readonly alpha: number;
+    /** Emissive layer — sources drawn here each frame (transparent elsewhere). `null` headless. */
+    readonly source: HTMLCanvasElement | null;
+    /** Small downscale buffer (the blur). `null` headless. */
+    readonly blur: HTMLCanvasElement | null;
+}
+/** A single light source for {@link drawGlowSource}: a soft coloured blob whose
+ *  bloom is scaled by `intensity`. Blooms in its **own** `color` — never white-only. */
+export interface GlowSource {
+    /** Centre in screen px. */
+    x: number;
+    y: number;
+    /** Reach in px (the blob's radius). */
+    radius: number;
+    /** The source's colour — the halo takes this colour. */
+    color: SpectrumColor;
+    /** Brightness scale `0..1` (default `1`). A dim torch vs a bright radar. */
+    intensity?: number;
+}
+/**
+ * Downscale-buffer dimensions for a `width`×`height` view at `downscale` — pure,
+ * exported for tests. Each axis is floored, never below 1.
+ */
+export declare function glowBufferSize(width: number, height: number, downscale: number): {
+    w: number;
+    h: number;
+};
+/**
+ * Creates a view-sized glow layer. `opts` tune the bloom ({@link GlowOptions}).
+ * Allocate once; reuse. Headless (no `document`): both canvases are `null` and
+ * {@link renderGlow} becomes a no-op.
+ */
+export declare function createGlowLayer(width: number, height: number, opts?: GlowOptions): GlowLayer;
+/**
+ * Draws one {@link GlowSource} — a soft radial blob in the source's own colour,
+ * scaled by `intensity` — into the emissive canvas context `g` (the one handed to
+ * the {@link renderGlow} callback). The blob fades to transparent at `radius`, so
+ * it adds nothing outside its reach when the layer is blitted with `'lighter'`.
+ */
+export declare function drawGlowSource(g: CanvasRenderingContext2D, source: GlowSource): void;
+/**
+ * Renders the bloom onto `ctx`, additively. Call each frame AFTER the scene is
+ * drawn (and before scanlines / `curveDisplay`). `drawSources` receives the
+ * emissive canvas context — draw your light sources into it (via
+ * {@link drawGlowSource} or any drawing). Their colour is then blurred (downscale
+ * → bilinear upscale) and blitted onto `ctx` with `'lighter'` at the layer's
+ * `alpha`, `passes` times. Restores `ctx`'s composite/alpha/smoothing afterwards,
+ * so it composes cleanly with the rest of the frame. Headless: a silent no-op.
+ */
+export declare function renderGlow(layer: GlowLayer, ctx: CanvasRenderingContext2D, drawSources: (g: CanvasRenderingContext2D) => void): void;
+//# sourceMappingURL=glow.d.ts.map

package/dist/glow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glow.d.ts","sourceRoot":"","sources":["../src/glow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,wFAAwF;AACxF,MAAM,WAAW,WAAW;IAC1B;4FACwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;oCACgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;4CACwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;uFACuF;AACvF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACzC,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAA;CACxC;AAED;wFACwF;AACxF,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAA;IACd,wDAAwD;IACxD,KAAK,EAAE,aAAa,CAAA;IACpB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAQD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAGzG;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,SAAS,CAqBhG;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,wBAAwB,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAWpF;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,wBAAwB,EAC7B,WAAW,EAAE,CAAC,CAAC,EAAE,wBAAwB,KAAK,IAAI,GACjD,IAAI,CA6BN"}

package/dist/glow.js

@@ -0,0 +1,128 @@
+/**
+ * @module glow
+ *
+ * **Optional phosphor GLOW / bloom — opt-in, purely additive.** The additive twin
+ * of {@link "lighting" | renderDarkness}: where lighting *subtracts* (dithered
+ * darkness), glow *adds* (a soft emissive bloom). A game marks its **light
+ * sources** — a torch, the moon, a sonar/radar blip — and their colour bleeds into
+ * the neighbours, so overlapping haloes sum into *perceived* extra colours **on the
+ * glass only**, while the crisp pixel-art framebuffer keeps its flat palette.
+ *
+ * **Emissive, not brighter (path B).** Glow is a marker on *sources of light*, not
+ * a lighter flat colour — the palette is never diluted. Everything the game does
+ * NOT draw into the glow layer stays exactly as before: this module adds new
+ * exports only, touches no existing render path, and a game that never calls
+ * {@link createGlowLayer} / {@link renderGlow} is byte-for-byte unaffected (it
+ * tree-shakes away).
+ *
+ * **Cheap bloom, no WebGL:** the emissive layer is **downscaled** to a small buffer
+ * and **upscaled** back with bilinear smoothing — that scaling IS the blur, for
+ * free — then blitted onto the frame with `globalCompositeOperation = 'lighter'`
+ * (additive). One offscreen buffer, a couple of `drawImage`s, headless-safe.
+ *
+ * @example
+ * ```ts
+ * const glow = createGlowLayer(256, 192)           // once, view-sized
+ * // each frame, AFTER drawing the scene, BEFORE scanlines:
+ * renderGlow(glow, ctx, (g) => {
+ *   drawGlowSource(g, { x: torchX, y: torchY, radius: 24, color: C.B_YELLOW, intensity: 0.9 })
+ *   drawGlowSource(g, { x: moonX,  y: moonY,  radius: 40, color: C.B_WHITE,  intensity: 0.5 })
+ *   // …or draw sprites/pixels directly for pixel-exact glow
+ * })
+ * ```
+ */
+import {} from './palette.js';
+const clampInt1 = (n, dflt) => Number.isFinite(n) && n >= 1 ? Math.floor(n) : dflt;
+const clamp01 = (n, dflt) => Number.isFinite(n) ? (n < 0 ? 0 : n > 1 ? 1 : n) : dflt;
+/**
+ * Downscale-buffer dimensions for a `width`×`height` view at `downscale` — pure,
+ * exported for tests. Each axis is floored, never below 1.
+ */
+export function glowBufferSize(width, height, downscale) {
+    const d = clampInt1(downscale, 4);
+    return { w: Math.max(1, Math.floor(width / d)), h: Math.max(1, Math.floor(height / d)) };
+}
+/**
+ * Creates a view-sized glow layer. `opts` tune the bloom ({@link GlowOptions}).
+ * Allocate once; reuse. Headless (no `document`): both canvases are `null` and
+ * {@link renderGlow} becomes a no-op.
+ */
+export function createGlowLayer(width, height, opts = {}) {
+    if (!Number.isInteger(width) || width <= 0 || !Number.isInteger(height) || height <= 0) {
+        throw new Error(`createGlowLayer: width and height must be positive integers, got ${width}×${height}`);
+    }
+    const downscale = clampInt1(opts.downscale ?? 4, 4);
+    const passes = clampInt1(opts.passes ?? 1, 1);
+    const alpha = clamp01(opts.alpha ?? 0.5, 0.5);
+    let source = null;
+    let blur = null;
+    if (typeof document !== 'undefined') {
+        const { w, h } = glowBufferSize(width, height, downscale);
+        source = document.createElement('canvas');
+        source.width = width;
+        source.height = height;
+        blur = document.createElement('canvas');
+        blur.width = w;
+        blur.height = h;
+    }
+    return { width, height, downscale, passes, alpha, source, blur };
+}
+/**
+ * Draws one {@link GlowSource} — a soft radial blob in the source's own colour,
+ * scaled by `intensity` — into the emissive canvas context `g` (the one handed to
+ * the {@link renderGlow} callback). The blob fades to transparent at `radius`, so
+ * it adds nothing outside its reach when the layer is blitted with `'lighter'`.
+ */
+export function drawGlowSource(g, source) {
+    const intensity = clamp01(source.intensity ?? 1, 1);
+    if (intensity <= 0 || source.radius <= 0)
+        return;
+    const grad = g.createRadialGradient(source.x, source.y, 0, source.x, source.y, source.radius);
+    grad.addColorStop(0, source.color);
+    grad.addColorStop(1, 'transparent');
+    const prevAlpha = g.globalAlpha;
+    g.globalAlpha = intensity;
+    g.fillStyle = grad;
+    g.fillRect(source.x - source.radius, source.y - source.radius, source.radius * 2, source.radius * 2);
+    g.globalAlpha = prevAlpha;
+}
+/**
+ * Renders the bloom onto `ctx`, additively. Call each frame AFTER the scene is
+ * drawn (and before scanlines / `curveDisplay`). `drawSources` receives the
+ * emissive canvas context — draw your light sources into it (via
+ * {@link drawGlowSource} or any drawing). Their colour is then blurred (downscale
+ * → bilinear upscale) and blitted onto `ctx` with `'lighter'` at the layer's
+ * `alpha`, `passes` times. Restores `ctx`'s composite/alpha/smoothing afterwards,
+ * so it composes cleanly with the rest of the frame. Headless: a silent no-op.
+ */
+export function renderGlow(layer, ctx, drawSources) {
+    const { source, blur, width, height, passes, alpha } = layer;
+    if (!source || !blur)
+        return; // headless → nothing to draw
+    // Draw the emissive sources, then downscale into the small blur buffer. In a
+    // browser both contexts exist; headless-ish (jsdom, getContext null) this block
+    // is skipped and only the blit below runs — mirrors renderDarkness.
+    const g = source.getContext('2d');
+    const b = blur.getContext('2d');
+    if (g && b) {
+        g.clearRect(0, 0, width, height); // transparent = additive-neutral
+        drawSources(g);
+        b.imageSmoothingEnabled = true;
+        b.clearRect(0, 0, blur.width, blur.height);
+        b.drawImage(source, 0, 0, blur.width, blur.height); // downscale (average)
+    }
+    // Upscale + additive blit: drawing the small buffer back to full size with
+    // smoothing on IS the blur; 'lighter' sums the haloes over the flat scene.
+    const prevSmooth = ctx.imageSmoothingEnabled;
+    const prevOp = ctx.globalCompositeOperation;
+    const prevAlpha = ctx.globalAlpha;
+    ctx.imageSmoothingEnabled = true;
+    ctx.globalCompositeOperation = 'lighter';
+    ctx.globalAlpha = alpha;
+    for (let i = 0; i < passes; i++)
+        ctx.drawImage(blur, 0, 0, width, height);
+    ctx.imageSmoothingEnabled = prevSmooth;
+    ctx.globalCompositeOperation = prevOp;
+    ctx.globalAlpha = prevAlpha;
+}
+//# sourceMappingURL=glow.js.map

package/dist/glow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glow.js","sourceRoot":"","sources":["../src/glow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,EAAsB,MAAM,cAAc,CAAA;AA2CjD,MAAM,SAAS,GAAG,CAAC,CAAS,EAAE,IAAY,EAAU,EAAE,CACpD,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAErD,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,IAAY,EAAU,EAAE,CAClD,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAEzD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,MAAc,EAAE,SAAiB;IAC7E,MAAM,CAAC,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;IACjC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;AAC1F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,MAAc,EAAE,OAAoB,EAAE;IACnF,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,KAAK,CAAC,oEAAoE,KAAK,IAAI,MAAM,EAAE,CAAC,CAAA;IACxG,CAAC;IACD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;IACnD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,GAAG,EAAE,GAAG,CAAC,CAAA;IAE7C,IAAI,MAAM,GAA6B,IAAI,CAAA;IAC3C,IAAI,IAAI,GAA6B,IAAI,CAAA;IACzC,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;QACzD,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;QACzC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAA;QACpB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAA;QACtB,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;QACvC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAA;QACd,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;IACjB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;AAClE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,CAA2B,EAAE,MAAkB;IAC5E,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;IACnD,IAAI,SAAS,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC;QAAE,OAAM;IAChD,MAAM,IAAI,GAAG,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IAC7F,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;IAClC,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,aAAa,CAAC,CAAA;IACnC,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAA;IAC/B,CAAC,CAAC,WAAW,GAAG,SAAS,CAAA;IACzB,CAAC,CAAC,SAAS,GAAG,IAAI,CAAA;IAClB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACpG,CAAC,CAAC,WAAW,GAAG,SAAS,CAAA;AAC3B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CACxB,KAAgB,EAChB,GAA6B,EAC7B,WAAkD;IAElD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;IAC5D,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI;QAAE,OAAM,CAAC,6BAA6B;IAE1D,6EAA6E;IAC7E,gFAAgF;IAChF,oEAAoE;IACpE,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IACjC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IAC/B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACX,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA,CAAC,iCAAiC;QAClE,WAAW,CAAC,CAAC,CAAC,CAAA;QACd,CAAC,CAAC,qBAAqB,GAAG,IAAI,CAAA;QAC9B,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1C,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA,CAAC,sBAAsB;IAC3E,CAAC;IAED,2EAA2E;IAC3E,2EAA2E;IAC3E,MAAM,UAAU,GAAG,GAAG,CAAC,qBAAqB,CAAA;IAC5C,MAAM,MAAM,GAAG,GAAG,CAAC,wBAAwB,CAAA;IAC3C,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,CAAA;IACjC,GAAG,CAAC,qBAAqB,GAAG,IAAI,CAAA;IAChC,GAAG,CAAC,wBAAwB,GAAG,SAAS,CAAA;IACxC,GAAG,CAAC,WAAW,GAAG,KAAK,CAAA;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;IACzE,GAAG,CAAC,qBAAqB,GAAG,UAAU,CAAA;IACtC,GAAG,CAAC,wBAAwB,GAAG,MAAM,CAAA;IACrC,GAAG,CAAC,WAAW,GAAG,SAAS,CAAA;AAC7B,CAAC"}

package/dist/index.d.ts

@@ -19,6 +19,7 @@ export * from './save.js';
 export * from './hiscore.js';
 export * from './i18n.js';
 export * from './lighting.js';
+export * from './glow.js';
 export * from './cache.js';
 export * from './attrscreen.js';
 export * from './monoscreen.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -19,6 +19,7 @@ export * from './save.js';
 export * from './hiscore.js';
 export * from './i18n.js';
 export * from './lighting.js';
+export * from './glow.js';
 export * from './cache.js';
 export * from './attrscreen.js';
 export * from './monoscreen.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zx-kit",
-  "version": "0.38.1",
+  "version": "0.40.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/zrebec/zx-kit.git"
@@ -23,7 +23,8 @@
   "scripts": {
     "build": "tsc",
     "prepublishOnly": "npm run build",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
   },
   "keywords": [
     "zx-spectrum",