zx-kit 0.28.0 → 0.30.0

package/README.md

@@ -3,7 +3,7 @@
 > **A Speccy-flavoured fantasy toolkit for tiny TypeScript browser games.**
 > Inspired by the ZX Spectrum — not an emulator, not a hardware clone.
 
-Spectrum-palette canvas rendering. ROM bitmap font. AY-3-8912 three-channel audio. Beeper SFX. Tile maps. Free-roaming sprites. Collision detection. Saves. Camera. Scene manager. Particle pool. Dithered lighting. Zero dependencies. TypeScript-first.
+Spectrum-palette canvas rendering. ROM bitmap font. AY-3-8912 three-channel audio. Beeper SFX. Tile maps. Free-roaming sprites. Collision detection. Saves. Camera. Scene manager. Particle pool. Dithered lighting. Offscreen layer cache. Authentic attribute clash. Zero dependencies. TypeScript-first.
 
 [![npm](https://img.shields.io/npm/v/zx-kit)](https://www.npmjs.com/package/zx-kit)
 [![license](https://img.shields.io/npm/l/zx-kit)](LICENSE)
@@ -27,6 +27,8 @@ zx-kit captures that aesthetic in TypeScript. You get the Spectrum's palette, RO
 - **Authentic 15-color palette** — normal and bright variants, palette-enforced at compile time via the `SpectrumColor` type
 - **Canvas renderer** — pixel-perfect scaled rendering, sprite flipping, text drawing, CRT scanline overlay, animated border flashing
 - **Tile map engine** — scrollable maps, O(1) id-index, smart seasonal background swapping, solid-tile collision queries
+- **Offscreen layer cache** — render a static or rarely-changing layer (tile map, CRT overlay) once to an offscreen canvas and blit it each frame; `dirty`-flag invalidation turns thousands of per-pixel `fillRect`s into a single `drawImage`
+- **Authentic attribute clash (opt-in)** — a 32×24 cell ink/paper screen that reproduces the real Spectrum colour bleed when a sprite and the background share an 8×8 cell; resolved to one `putImageData`/frame. Off by default, on when you want it
 - **Free-roaming sprites** — position, velocity, gravity, `flipX` caching, transparent or opaque background
 - **Three-tier collision** — AABB overlap tests, generic rect-vs-tile wall resolution (any sprite size), and pixel-precise mask overlap with O(pixels) sorted-merge intersection — no allocations per frame
 - **Keyboard and gamepad input** — configurable key-repeat, transparent gamepad polling, single-consume action flags, instant state reset on phase transitions
@@ -589,6 +591,8 @@ requestAnimationFrame(loop)
 | [`font.ts`](#fontts--rom-bitmap-font) | 96-character ROM font, raw bitmap access |
 | [`i18n.ts`](#i18nts--runtime-locale-selection) | Type-safe runtime locale selection for translated string packs |
 | [`lighting.ts`](#lightingts--dithered-cave-darkness) | Dithered cave darkness: pre-baked level tiles + dirty-cell buffer, one blit/frame (no per-frame putImageData) |
+| [`cache.ts`](#cachets--offscreen-layer-cache) | Offscreen layer cache: render a static layer once, blit each frame, `dirty`-flag invalidation |
+| [`attrscreen.ts`](#attrscreents--attribute-clash-opt-in) | Opt-in authentic ZX colour clash: 1-bit pixels + 32×24 per-cell ink/paper, one `putImageData`/frame |
 | [`music.ts`](#musicts--note-name-ay-music) | Write AY music by note name (`A5`, `C#4`) and loop it for background tracks |
 
 ---
@@ -2740,6 +2744,115 @@ track.stop()
 
 ---
 
+## `cache.ts` — Offscreen Layer Cache
+
+`drawBitmap`, `drawSprite` and `drawTileMapAt` paint **one `fillRect` per lit
+pixel** — perfect for a moving sprite, but lethal for a full-screen layer redrawn
+every frame (a scrolling tile map can be thousands of `fillRect`s per frame). The
+cure is to render that layer **once** to an offscreen canvas, then blit it with a
+single `drawImage`.
+
+A `LayerCache` is an offscreen canvas plus a `dirty` flag. `refreshLayer` re-runs
+your draw callback **only while the cache is dirty**, then clears the flag; call
+`invalidateLayer` whenever the layer's contents change (a tile edited, a level
+reset) to force exactly one re-render. Headless-safe: with no `document` the
+canvas is `null`, the draw is skipped, and nothing throws.
+
+### `createLayerCache(width, height): LayerCache`
+
+Creates an offscreen cache of the given pixel size, starting `dirty`. Image
+smoothing is disabled for crisp ZX output. Create once; reuse across frames.
+Throws if `width`/`height` is not a positive number.
+
+### `invalidateLayer(layer): void`
+
+Marks the cache stale so the next `refreshLayer` re-renders it.
+
+### `refreshLayer(layer, render): HTMLCanvasElement | null`
+
+Runs `render(offscreenCtx)` only if the cache is dirty (the context is cleared
+first), then clears the flag and returns the offscreen canvas to blit (or `null`
+when headless). Blitting is yours: a `drawImage` source window for a scrolling
+camera, or `drawImage(canvas, 0, 0)` for a static overlay.
+
+```ts
+// Cache a whole tile map; blit a moving camera window each frame.
+const world = tileMapWorldSize(map)
+const tiles = createLayerCache(world.width, world.height)   // once
+
+// game loop:
+refreshLayer(tiles, (lctx) => drawTileMapAt(lctx, map, 0, 0, world.width, world.height))
+if (tiles.canvas) ctx.drawImage(tiles.canvas, camX, camY, 256, 192, 0, 0, 256, 192)
+
+// when a tile changes (a platform crumbles, the level resets):
+invalidateLayer(tiles)
+```
+
+> Pairs naturally with `tilescroll` / `tilemap`: cache the static geometry and
+> invalidate only on the rare tile change. The same primitive caches any static
+> overlay — e.g. `refreshLayer(overlay, (c) => drawScanlines(c))`.
+
+---
+
+## `attrscreen.ts` — Attribute Clash (opt-in)
+
+The real Spectrum stored the screen as **two planes**: a 1-bit pixel bitmap and a
+32×24 grid where each 8×8 cell holds exactly *one* ink + *one* paper. Drawing into a
+cell rewrote that single attribute, so the sprite and the background sharing the
+cell snapped to the same two colours — the famous **colour clash**.
+
+zx-kit composites in full colour by default (no clash — see *Spectrum-inspired, not
+hardware-accurate*). `attrscreen.ts` is the opt-in way to get the authentic bleed,
+the same shape as `drawScanlines` / `renderDarkness`: route a frame through an
+`AttrScreen`, then `flushAttrScreen` once.
+
+`stampMono` writes a monochrome bitmap's *shape* into the pixel plane and
+re-attributes every cell a lit pixel lands in — and it **never clears** other
+pixels, so whatever was already in a touched cell renders in the new colour. That
+is the clash. The flush resolves both planes into one reused `ImageData` and uploads
+it with a single `putImageData` + `drawImage` — never per-pixel `fillRect`.
+
+> Not hardware-exact by choice: ink and paper may be any two of the 15 colours (the
+> real machine forced both to share the BRIGHT bit), and FLASH is not modelled (yet).
+> Assumes a little-endian platform (every browser). Headless-safe.
+
+### `createAttrScreen(cols = 32, rows = 24): AttrScreen`
+
+Allocates a screen-space attribute plane (default 32×24 cells = 256×192). Create
+once; reuse across frames. Throws on a non-positive size.
+
+### `clearAttrScreen(scr, paper, ink?)`
+
+Resets for a new frame: clears all pixels to paper and fills every cell's
+attributes (`ink` defaults to `paper`). Call before stamping.
+
+### `stampMono(scr, bitmap, x, y, ink, paper, policy?)`
+
+Stamps a monochrome `Bitmap` at screen pixel `(x, y)` (rounded; may be sub-cell,
+negative, or off-screen — clipped). `policy` controls how touched cells recolour:
+`'both'` (default — ink **and** paper, the most authentic bleed), `'ink-only'`
+(keep the existing paper), `'paper-only'`.
+
+### `flushAttrScreen(ctx, scr)`
+
+Resolves the two planes into RGBA and uploads with one `putImageData` + `drawImage`
+at `(0, 0)` under the current transform (so `setupCanvas`'s `×scale` fills the
+canvas). Headless: fills `scr.rgba` and skips the blit.
+
+```ts
+const scr = createAttrScreen()                              // once
+// each frame, in screen space:
+clearAttrScreen(scr, C.BLACK)
+stampMono(scr, caveBitmap,   0,  0, C.B_BLUE,  C.BLACK)     // background
+stampMono(scr, rabbitBitmap, rx, ry, C.B_WHITE, C.BLACK)    // sprite → its cells clash to white
+flushAttrScreen(ctx, scr)
+```
+
+> A cell clashes only when a lit pixel lands in it (silhouette clash), so a sprite
+> recolours exactly the cells it visibly occupies.
+
+---
+
 ## Architecture
 
 ### Module structure

package/dist/attrscreen.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @module attrscreen
+ *
+ * **Authentic ZX attribute clash — opt-in.** The real Spectrum stored the screen
+ * as two separate planes: a 1-bit **pixel** bitmap (256×192) and a 32×24
+ * **attribute** grid where each 8×8 cell holds exactly *one* ink + *one* paper.
+ * Drawing a sprite into a cell rewrote that cell's attribute, so everything in
+ * the cell — sprite *and* background — snapped to the same two colours. That bleed
+ * is the famous *colour clash*.
+ *
+ * zx-kit normally composites in full colour (no clash — by design, see the README).
+ * This module is the opt-in way to get the real thing, the same shape as the other
+ * effects ({@link "renderer" | drawScanlines}, {@link "lighting" | renderDarkness}):
+ * a game that wants clash routes its drawing through an {@link AttrScreen} and
+ * calls {@link flushAttrScreen} once per frame.
+ *
+ * **The dual plane:** {@link stampMono} writes a monochrome bitmap's *shape* into
+ * the pixel plane and re-attributes every cell it touches (per {@link AttrPolicy}).
+ * Crucially it does **not** clear other pixels — so a leaf already drawn in a cell
+ * keeps its pixels but now renders in the *new* cell colour. That is the clash.
+ *
+ * **Fast flush:** the two planes are resolved into one RGBA buffer and uploaded
+ * with a single `putImageData` + `drawImage` — never per-pixel `fillRect`. Assumes
+ * a little-endian platform (every browser; common Node).
+ *
+ * Headless-safe: with no `document` the offscreen canvas is `null`, the resolve
+ * still runs (so the logic is testable) and the blit is skipped — nothing throws.
+ *
+ * @example
+ * ```ts
+ * const scr = createAttrScreen()                       // 32×24 cells = 256×192, once
+ * // each frame, in screen space:
+ * clearAttrScreen(scr, C.BLACK)                        // blank paper
+ * stampMono(scr, caveBitmap,   0,  0, C.B_BLUE,  C.BLACK)   // background
+ * stampMono(scr, rabbitBitmap, rx, ry, C.B_WHITE, C.BLACK)  // sprite → its cells clash to white
+ * flushAttrScreen(ctx, scr)                            // one putImageData + drawImage
+ * ```
+ */
+import { type SpectrumColor } from './palette.js';
+import type { Bitmap } from './renderer.js';
+/**
+ * How a {@link stampMono} re-colours each cell it touches:
+ * - `'both'` — set ink **and** paper (last writer owns the whole cell — the most
+ *   authentic clash: the background paper changes too).
+ * - `'ink-only'` — set ink, keep the existing paper (gentler bleed).
+ * - `'paper-only'` — set paper, keep the existing ink.
+ */
+export type AttrPolicy = 'both' | 'ink-only' | 'paper-only';
+/** A screen-space dual plane: 1-bit pixels + per-cell ink/paper attributes. */
+export interface AttrScreen {
+    readonly cols: number;
+    readonly rows: number;
+    readonly width: number;
+    readonly height: number;
+    /** One byte per pixel — `1` = ink, `0` = paper. Row-major, `width*height`. */
+    readonly pixels: Uint8Array;
+    /** Packed RGBA (little-endian) ink colour per cell, `cols*rows`. */
+    readonly cellInk: Uint32Array;
+    /** Packed RGBA paper colour per cell, `cols*rows`. */
+    readonly cellPaper: Uint32Array;
+    /** Resolved RGBA frame buffer (`width*height*4`), filled by {@link flushAttrScreen}. */
+    readonly rgba: Uint8ClampedArray;
+    /** Reusable `ImageData` backing {@link rgba} (`null` when headless). */
+    readonly image: ImageData | null;
+    /** Offscreen canvas the resolved buffer is uploaded to (`null` when headless). */
+    readonly canvas: HTMLCanvasElement | null;
+}
+/**
+ * Creates a screen-space attribute plane of `cols`×`rows` 8×8 cells (default
+ * 32×24 = 256×192). Allocate once; reuse across frames. Throws on a non-positive
+ * size.
+ */
+export declare function createAttrScreen(cols?: number, rows?: number): AttrScreen;
+/**
+ * Resets the screen for a new frame: clears all pixels to paper and fills every
+ * cell's attributes. `ink` defaults to `paper`, so untouched cells are a flat
+ * paper colour. Call at the start of each frame, before stamping.
+ */
+export declare function clearAttrScreen(scr: AttrScreen, paper: SpectrumColor, ink?: SpectrumColor): void;
+/**
+ * Stamps a monochrome {@link Bitmap} at screen pixel `(x, y)` (rounded; may be
+ * sub-cell, negative, or off-screen — clipped). Sets the bitmap's lit pixels in
+ * 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.
+ */
+export declare function stampMono(scr: AttrScreen, bitmap: Bitmap, x: number, y: number, ink: SpectrumColor, paper: SpectrumColor, policy?: AttrPolicy): 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
+ * drawn at `(0, 0)` under the current transform, so the usual `setupCanvas`
+ * `×scale` makes it fill the canvas. Headless: fills {@link AttrScreen.rgba} and
+ * skips the blit.
+ */
+export declare function flushAttrScreen(ctx: CanvasRenderingContext2D, scr: AttrScreen): void;
+//# sourceMappingURL=attrscreen.d.ts.map

package/dist/attrscreen.d.ts.map

@@ -0,0 +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;AAUD;;;;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"}

package/dist/attrscreen.js

@@ -0,0 +1,167 @@
+/**
+ * @module attrscreen
+ *
+ * **Authentic ZX attribute clash — opt-in.** The real Spectrum stored the screen
+ * as two separate planes: a 1-bit **pixel** bitmap (256×192) and a 32×24
+ * **attribute** grid where each 8×8 cell holds exactly *one* ink + *one* paper.
+ * Drawing a sprite into a cell rewrote that cell's attribute, so everything in
+ * the cell — sprite *and* background — snapped to the same two colours. That bleed
+ * is the famous *colour clash*.
+ *
+ * zx-kit normally composites in full colour (no clash — by design, see the README).
+ * This module is the opt-in way to get the real thing, the same shape as the other
+ * effects ({@link "renderer" | drawScanlines}, {@link "lighting" | renderDarkness}):
+ * a game that wants clash routes its drawing through an {@link AttrScreen} and
+ * calls {@link flushAttrScreen} once per frame.
+ *
+ * **The dual plane:** {@link stampMono} writes a monochrome bitmap's *shape* into
+ * the pixel plane and re-attributes every cell it touches (per {@link AttrPolicy}).
+ * Crucially it does **not** clear other pixels — so a leaf already drawn in a cell
+ * keeps its pixels but now renders in the *new* cell colour. That is the clash.
+ *
+ * **Fast flush:** the two planes are resolved into one RGBA buffer and uploaded
+ * with a single `putImageData` + `drawImage` — never per-pixel `fillRect`. Assumes
+ * a little-endian platform (every browser; common Node).
+ *
+ * Headless-safe: with no `document` the offscreen canvas is `null`, the resolve
+ * still runs (so the logic is testable) and the blit is skipped — nothing throws.
+ *
+ * @example
+ * ```ts
+ * const scr = createAttrScreen()                       // 32×24 cells = 256×192, once
+ * // each frame, in screen space:
+ * clearAttrScreen(scr, C.BLACK)                        // blank paper
+ * stampMono(scr, caveBitmap,   0,  0, C.B_BLUE,  C.BLACK)   // background
+ * stampMono(scr, rabbitBitmap, rx, ry, C.B_WHITE, C.BLACK)  // sprite → its cells clash to white
+ * flushAttrScreen(ctx, scr)                            // one putImageData + drawImage
+ * ```
+ */
+import { CELL } from './palette.js';
+/** Packs a `#RRGGBB` Spectrum colour into a little-endian RGBA word (opaque). */
+function hexToU32(hex) {
+    const r = parseInt(hex.slice(1, 3), 16);
+    const g = parseInt(hex.slice(3, 5), 16);
+    const b = parseInt(hex.slice(5, 7), 16);
+    return ((255 << 24) | (b << 16) | (g << 8) | r) >>> 0;
+}
+/**
+ * Creates a screen-space attribute plane of `cols`×`rows` 8×8 cells (default
+ * 32×24 = 256×192). Allocate once; reuse across frames. Throws on a non-positive
+ * size.
+ */
+export function createAttrScreen(cols = 32, rows = 24) {
+    if (!Number.isInteger(cols) || cols <= 0 || !Number.isInteger(rows) || rows <= 0) {
+        throw new Error(`createAttrScreen: cols and rows must be positive integers, got ${cols}×${rows}`);
+    }
+    const width = cols * CELL;
+    const height = rows * CELL;
+    let canvas = null;
+    let image = null;
+    if (typeof document !== 'undefined') {
+        canvas = document.createElement('canvas');
+        canvas.width = width;
+        canvas.height = height;
+        const ctx = canvas.getContext('2d');
+        if (ctx) {
+            ctx.imageSmoothingEnabled = false;
+            image = ctx.createImageData(width, height);
+        }
+    }
+    // In the browser the resolved buffer IS the ImageData's data (no per-frame copy,
+    // no constructor); headless it's a standalone buffer so the resolve stays testable.
+    const rgba = image ? image.data : new Uint8ClampedArray(width * height * 4);
+    return {
+        cols,
+        rows,
+        width,
+        height,
+        pixels: new Uint8Array(width * height),
+        cellInk: new Uint32Array(cols * rows),
+        cellPaper: new Uint32Array(cols * rows),
+        rgba,
+        image,
+        canvas,
+    };
+}
+/**
+ * Resets the screen for a new frame: clears all pixels to paper and fills every
+ * cell's attributes. `ink` defaults to `paper`, so untouched cells are a flat
+ * paper colour. Call at the start of each frame, before stamping.
+ */
+export function clearAttrScreen(scr, paper, ink = paper) {
+    scr.pixels.fill(0);
+    scr.cellPaper.fill(hexToU32(paper));
+    scr.cellInk.fill(hexToU32(ink));
+}
+/**
+ * Stamps a monochrome {@link Bitmap} at screen pixel `(x, y)` (rounded; may be
+ * sub-cell, negative, or off-screen — clipped). Sets the bitmap's lit pixels in
+ * 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.
+ */
+export function stampMono(scr, bitmap, x, y, ink, paper, policy = 'both') {
+    const inkU32 = hexToU32(ink);
+    const paperU32 = hexToU32(paper);
+    const setInk = policy !== 'paper-only';
+    const setPaper = policy !== 'ink-only';
+    const { data, width: bw, height: bh } = bitmap;
+    const bytesPerRow = bw >> 3;
+    const ox = Math.round(x);
+    const oy = Math.round(y);
+    for (let row = 0; row < bh; row++) {
+        const py = oy + row;
+        if (py < 0 || py >= scr.height)
+            continue;
+        const rowByteBase = row * bytesPerRow;
+        const rowPixBase = py * scr.width;
+        const cellRowBase = (py >> 3) * scr.cols;
+        for (let byteIdx = 0; byteIdx < bytesPerRow; byteIdx++) {
+            const byte = data[rowByteBase + byteIdx];
+            if (!byte)
+                continue;
+            const colBase = byteIdx << 3;
+            for (let bit = 0; bit < 8; bit++) {
+                if (!(byte & (0x80 >> bit)))
+                    continue;
+                const px = ox + colBase + bit;
+                if (px < 0 || px >= scr.width)
+                    continue;
+                scr.pixels[rowPixBase + px] = 1;
+                const cell = cellRowBase + (px >> 3);
+                if (setInk)
+                    scr.cellInk[cell] = inkU32;
+                if (setPaper)
+                    scr.cellPaper[cell] = paperU32;
+            }
+        }
+    }
+}
+/**
+ * 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
+ * drawn at `(0, 0)` under the current transform, so the usual `setupCanvas`
+ * `×scale` makes it fill the canvas. Headless: fills {@link AttrScreen.rgba} and
+ * skips the blit.
+ */
+export function flushAttrScreen(ctx, scr) {
+    const { pixels, cellInk, cellPaper, width, height, cols } = scr;
+    const out = new Uint32Array(scr.rgba.buffer);
+    let p = 0;
+    for (let yy = 0; yy < height; yy++) {
+        const cellRow = (yy >> 3) * cols;
+        for (let xx = 0; xx < width; xx++) {
+            const cell = cellRow + (xx >> 3);
+            out[p] = pixels[p] ? cellInk[cell] : cellPaper[cell];
+            p++;
+        }
+    }
+    if (scr.canvas && scr.image) {
+        const offctx = scr.canvas.getContext('2d');
+        if (offctx) {
+            offctx.putImageData(scr.image, 0, 0);
+            ctx.drawImage(scr.canvas, 0, 0);
+        }
+    }
+}
+//# sourceMappingURL=attrscreen.js.map

package/dist/attrscreen.js.map

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

package/dist/cache.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @module cache
+ *
+ * **Offscreen layer cache** — render a static (or rarely-changing) layer to an
+ * offscreen canvas **once**, then blit it every frame with a single `drawImage`
+ * instead of re-rasterising it. This is the antidote to the per-pixel `fillRect`
+ * cost of {@link "renderer" | drawBitmap} / {@link "tilescroll" | drawTileMapAt}
+ * when they are used for a full-screen layer on every frame.
+ *
+ * The cache is **dirty-driven**: {@link refreshLayer} re-runs your draw callback
+ * only while the cache is `dirty`, then clears the flag. Call
+ * {@link invalidateLayer} whenever the layer's contents change (a tile edited, a
+ * palette swap, a level reset) to force exactly one re-render next frame.
+ *
+ * Headless-safe: with no `document` (Node / SSR / tests) the canvas is `null`,
+ * `refreshLayer` skips the draw and returns `null`, and nothing throws — mirrors
+ * the {@link "lighting" | lighting} module's degrade-gracefully behaviour.
+ *
+ * @example Cache a whole tile map, blit a moving camera window each frame
+ * ```ts
+ * const world = tileMapWorldSize(map)
+ * const tiles = createLayerCache(world.width, world.height)   // once
+ * // game loop:
+ * refreshLayer(tiles, (lctx) => drawTileMapAt(lctx, map, 0, 0, world.width, world.height))
+ * if (tiles.canvas) ctx.drawImage(tiles.canvas, camX, camY, viewW, viewH, 0, 0, viewW, viewH)
+ * // when a tile changes (e.g. a platform crumbles or the level resets):
+ * invalidateLayer(tiles)
+ * ```
+ *
+ * @example Cache a static overlay — drawn once, blitted forever
+ * ```ts
+ * const overlay = createLayerCache(canvas.width, canvas.height)
+ * refreshLayer(overlay, (lctx) => drawScanlines(lctx))
+ * if (overlay.canvas) ctx.drawImage(overlay.canvas, 0, 0)
+ * ```
+ */
+/** An offscreen canvas plus a dirty flag. `canvas` is `null` when headless. */
+export interface LayerCache {
+    /** Width of the cached layer in pixels. */
+    readonly width: number;
+    /** Height of the cached layer in pixels. */
+    readonly height: number;
+    /** The offscreen canvas to blit, or `null` with no `document` (headless). */
+    readonly canvas: HTMLCanvasElement | null;
+    /** When `true`, the next {@link refreshLayer} re-runs the draw callback. */
+    dirty: boolean;
+}
+/**
+ * Creates an offscreen layer cache of the given pixel size. Starts `dirty`, so
+ * the first {@link refreshLayer} renders it. Image smoothing is disabled on the
+ * offscreen context for crisp ZX output. Create once and reuse across frames.
+ *
+ * @throws if `width` or `height` is not a positive finite number.
+ */
+export declare function createLayerCache(width: number, height: number): LayerCache;
+/** Marks the cache stale so the next {@link refreshLayer} re-renders it. */
+export declare function invalidateLayer(layer: LayerCache): void;
+/**
+ * Re-renders the cache via `render` **only if it is dirty**, then clears the
+ * dirty flag. `render` receives the offscreen 2D context (already cleared) and
+ * should draw the whole layer in layer-local coordinates (top-left = `0,0`).
+ * Returns the offscreen canvas to blit (or `null` when headless).
+ *
+ * Blitting is the caller's job: use a `drawImage` source window for a scrolling
+ * camera, or `drawImage(canvas, 0, 0)` for a static overlay.
+ */
+export declare function refreshLayer(layer: LayerCache, render: (ctx: CanvasRenderingContext2D) => void): HTMLCanvasElement | null;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACzC,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAa1E;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAEvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,CAAC,GAAG,EAAE,wBAAwB,KAAK,IAAI,GAC9C,iBAAiB,GAAG,IAAI,CAW1B"}

package/dist/cache.js

@@ -0,0 +1,84 @@
+/**
+ * @module cache
+ *
+ * **Offscreen layer cache** — render a static (or rarely-changing) layer to an
+ * offscreen canvas **once**, then blit it every frame with a single `drawImage`
+ * instead of re-rasterising it. This is the antidote to the per-pixel `fillRect`
+ * cost of {@link "renderer" | drawBitmap} / {@link "tilescroll" | drawTileMapAt}
+ * when they are used for a full-screen layer on every frame.
+ *
+ * The cache is **dirty-driven**: {@link refreshLayer} re-runs your draw callback
+ * only while the cache is `dirty`, then clears the flag. Call
+ * {@link invalidateLayer} whenever the layer's contents change (a tile edited, a
+ * palette swap, a level reset) to force exactly one re-render next frame.
+ *
+ * Headless-safe: with no `document` (Node / SSR / tests) the canvas is `null`,
+ * `refreshLayer` skips the draw and returns `null`, and nothing throws — mirrors
+ * the {@link "lighting" | lighting} module's degrade-gracefully behaviour.
+ *
+ * @example Cache a whole tile map, blit a moving camera window each frame
+ * ```ts
+ * const world = tileMapWorldSize(map)
+ * const tiles = createLayerCache(world.width, world.height)   // once
+ * // game loop:
+ * refreshLayer(tiles, (lctx) => drawTileMapAt(lctx, map, 0, 0, world.width, world.height))
+ * if (tiles.canvas) ctx.drawImage(tiles.canvas, camX, camY, viewW, viewH, 0, 0, viewW, viewH)
+ * // when a tile changes (e.g. a platform crumbles or the level resets):
+ * invalidateLayer(tiles)
+ * ```
+ *
+ * @example Cache a static overlay — drawn once, blitted forever
+ * ```ts
+ * const overlay = createLayerCache(canvas.width, canvas.height)
+ * refreshLayer(overlay, (lctx) => drawScanlines(lctx))
+ * if (overlay.canvas) ctx.drawImage(overlay.canvas, 0, 0)
+ * ```
+ */
+/**
+ * Creates an offscreen layer cache of the given pixel size. Starts `dirty`, so
+ * the first {@link refreshLayer} renders it. Image smoothing is disabled on the
+ * offscreen context for crisp ZX output. Create once and reuse across frames.
+ *
+ * @throws if `width` or `height` is not a positive finite number.
+ */
+export function createLayerCache(width, height) {
+    if (!Number.isFinite(width) || width <= 0 || !Number.isFinite(height) || height <= 0) {
+        throw new Error(`createLayerCache: width and height must be positive, got ${width}×${height}`);
+    }
+    let canvas = null;
+    if (typeof document !== 'undefined') {
+        canvas = document.createElement('canvas');
+        canvas.width = width;
+        canvas.height = height;
+        const ctx = canvas.getContext('2d');
+        if (ctx)
+            ctx.imageSmoothingEnabled = false;
+    }
+    return { width, height, canvas, dirty: true };
+}
+/** Marks the cache stale so the next {@link refreshLayer} re-renders it. */
+export function invalidateLayer(layer) {
+    layer.dirty = true;
+}
+/**
+ * Re-renders the cache via `render` **only if it is dirty**, then clears the
+ * dirty flag. `render` receives the offscreen 2D context (already cleared) and
+ * should draw the whole layer in layer-local coordinates (top-left = `0,0`).
+ * Returns the offscreen canvas to blit (or `null` when headless).
+ *
+ * Blitting is the caller's job: use a `drawImage` source window for a scrolling
+ * camera, or `drawImage(canvas, 0, 0)` for a static overlay.
+ */
+export function refreshLayer(layer, render) {
+    if (layer.dirty) {
+        layer.dirty = false;
+        const ctx = layer.canvas ? layer.canvas.getContext('2d') : null;
+        if (ctx) {
+            ctx.clearRect(0, 0, layer.width, layer.height);
+            ctx.imageSmoothingEnabled = false;
+            render(ctx);
+        }
+    }
+    return layer.canvas;
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAcH;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,MAAc;IAC5D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CAAC,4DAA4D,KAAK,IAAI,MAAM,EAAE,CAAC,CAAA;IAChG,CAAC;IACD,IAAI,MAAM,GAA6B,IAAI,CAAA;IAC3C,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;QACzC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAA;QACpB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAA;QACtB,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;QACnC,IAAI,GAAG;YAAE,GAAG,CAAC,qBAAqB,GAAG,KAAK,CAAA;IAC5C,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AAC/C,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,KAAK,CAAC,KAAK,GAAG,IAAI,CAAA;AACpB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAiB,EACjB,MAA+C;IAE/C,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,KAAK,CAAC,KAAK,GAAG,KAAK,CAAA;QACnB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAC/D,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;YAC9C,GAAG,CAAC,qBAAqB,GAAG,KAAK,CAAA;YACjC,MAAM,CAAC,GAAG,CAAC,CAAA;QACb,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAA;AACrB,CAAC"}

package/dist/index.d.ts

@@ -17,5 +17,7 @@ export * from './scene.js';
 export * from './save.js';
 export * from './i18n.js';
 export * from './lighting.js';
+export * from './cache.js';
+export * from './attrscreen.js';
 export * from './music.js';
 //# sourceMappingURL=index.d.ts.map

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,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,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,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,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,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -17,5 +17,7 @@ export * from './scene.js';
 export * from './save.js';
 export * from './i18n.js';
 export * from './lighting.js';
+export * from './cache.js';
+export * from './attrscreen.js';
 export * from './music.js';
 //# sourceMappingURL=index.js.map

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,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,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,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,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,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zx-kit",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/zrebec/zx-kit.git"