zx-kit 0.2.3 → 0.4.0

package/README.md

@@ -195,7 +195,7 @@ Wraps the Web Audio API for authentic 1-bit square-wave sound. All audio goes th
 
 #### `initAudio(volume?): void`
 
-Creates the `AudioContext` and master gain. Idempotent — safe to call multiple times.
+Creates the `AudioContext` and master gain. Idempotent — safe to call multiple times. `volume` is clamped to 0.0–1.0.
 
 ```ts
 window.addEventListener('keydown', () => initAudio(), { once: true })
@@ -214,6 +214,33 @@ Returns the current context, or `null` before `initAudio()`.
 
 Returns the master gain node. Connect custom oscillators here to respect global volume.
 
+#### `getMasterVolume(): number`
+
+Returns the current master volume (0.0–1.0), or `0` before `initAudio()`.
+
+#### `setMasterVolume(volume): void`
+
+Sets master volume. Clamped to 0.0–1.0. No-op before `initAudio()`.
+
+```ts
+setMasterVolume(0.5)  // 50%
+setMasterVolume(0)    // mute
+setMasterVolume(1)    // full
+```
+
+#### `increaseVolume(): void` / `decreaseVolume(): void`
+
+Adjusts master volume by ±0.1, clamped at 0.0–1.0.
+
+```ts
+// Volume keys
+if (consumeAnyKey()) increaseVolume()  // example: + key
+decreaseVolume()                        // example: - key
+
+// Current state
+const vol = getMasterVolume()  // e.g. 0.4 after one increaseVolume()
+```
+
 #### `Note` interface
 
 ```ts
@@ -271,11 +298,11 @@ type Direction = 'up' | 'down' | 'left' | 'right'
 
 #### `initInput(repeatDelay?, repeatInterval?): void`
 
-Attaches `keydown`/`keyup` listeners. Keys: arrows = movement, `F` = flag, `P` = pause, `Ctrl+Shift+B` = debug.
+Attaches `keydown`/`keyup` listeners. Idempotent — timing params are always updated; listeners are only attached on the first call. Keys: arrows = movement, `F` = flag, `P` = pause, `Ctrl+Shift+B` = debug.
 
 ```ts
 initInput()         // 150ms delay, 80ms repeat
-initInput(200, 60)  // custom timing
+initInput(200, 60)  // custom timing; safe to call again to reconfigure
 ```
 
 #### `tickMovement(dtMs): Direction | null`
@@ -306,6 +333,140 @@ Returns whether a key is currently held. Argument is `KeyboardEvent.key`.
 if (isHeld('ArrowUp')) { ... }
 ```
 
+#### `resetInput(): void`
+
+Clears all pending key state immediately. Call on game phase transitions to prevent stale inputs carrying over.
+
+```ts
+appPhase = 'gameover'
+resetInput()  // discard any queued keypresses from the previous phase
+```
+
+---
+
+### `ui.ts` — ZX-style UI primitives
+
+High-level drawing helpers and a stateful widget system for HUD elements.
+All primitives operate in game pixels and enforce the Spectrum palette via `SpectrumColor`.
+
+#### Types
+
+**`BorderOptions`**
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `enabled` | `boolean` | `true` | Set to `false` to suppress the border without removing the object |
+| `thickness` | `number` | `1` | Border thickness in pixels |
+| `color` | `SpectrumColor` | same as ink/color | Overrides the parent function's foreground color |
+| `style` | `'solid' \| 'dashed'` | `'solid'` | Solid = continuous lines; dashed = 2 px on / 2 px off |
+
+**`DrawProgressBarOptions`**
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `id` | `string` | `"${x},${y}"` | Stable key for managed redraws |
+| `x` | `number` | — | Left edge in game pixels |
+| `y` | `number` | — | Top edge in game pixels |
+| `width` | `number` | — | Total width in game pixels (multiples of `CELL = 8` recommended) |
+| `value` | `number` | — | Current value |
+| `min` | `number` | `0` | Value at the left (empty) edge |
+| `max` | `number` | `1` | Value at the right (full) edge |
+| `ink` | `SpectrumColor` | `C.B_WHITE` | Filled-block color |
+| `paper` | `SpectrumColor` | `C.BLACK` | Empty-block background |
+| `border` | `BorderOptions` | — | Optional border around the bar |
+| `visibilityLength` | `number` | `500` | Ms to stay visible after last call; `0` = permanent |
+
+#### Stateless primitives
+
+##### `drawBox(ctx, options): void`
+
+Fills a rectangle with `paper` and draws an optional border.
+
+```ts
+drawBox(ctx, {
+  x: 8, y: 8, width: 112, height: 40,
+  paper: C.BLACK, ink: C.B_WHITE,
+  border: { style: 'solid', thickness: 1 },
+})
+```
+
+##### `drawFrame(ctx, options): void`
+
+Draws a border only — no background fill.
+
+```ts
+drawFrame(ctx, { x: 0, y: 0, width: 256, height: 176, color: C.B_CYAN })
+drawFrame(ctx, { x: 16, y: 16, width: 64, height: 32, color: C.B_RED,
+  border: { style: 'dashed' } })
+```
+
+##### `drawPanelTitle(ctx, options): void`
+
+Renders a text strip (height = `CELL + padding * 2`) with optional background fill.
+Does NOT draw the surrounding container — use `drawBox` / `drawFrame` separately.
+
+```ts
+drawBox(ctx, { x: 8, y: 24, width: 128, height: 56, paper: C.BLACK })
+drawPanelTitle(ctx, {
+  text: 'OPTIONS', x: 8, y: 24,
+  ink: C.B_YELLOW, paper: C.BLACK,
+  centered: true, width: 128,
+})
+```
+
+#### Stateful widget — progress bar
+
+The progress bar is a managed widget: after a `drawProgressBar` call, the bar is
+re-rendered automatically on subsequent frames by `renderUI` until `visibilityLength`
+milliseconds have elapsed. Calling `drawProgressBar` again resets the timer.
+
+##### `drawProgressBar(ctx, options): void`
+
+Draws the bar immediately **and** registers it for managed redraws.
+
+```ts
+// On value change:
+drawProgressBar(ctx, {
+  id: 'volume', x: 88, y: 88, width: 80,
+  value: getMasterVolume(),
+  ink: C.B_GREEN, paper: C.BLACK,
+  border: { style: 'solid' },
+  visibilityLength: 1500,
+})
+
+// Permanent HUD element:
+drawProgressBar(ctx, {
+  id: 'health', x: 0, y: 184, width: 40,
+  value: lives, min: 0, max: 3,
+  ink: C.B_GREEN, paper: C.BLACK,
+  visibilityLength: 0,
+})
+```
+
+##### `tickUI(dtMs): void`
+
+Advances all managed bar timers. Expired bars are removed. Call once per frame.
+
+##### `renderUI(ctx): void`
+
+Redraws all currently visible bars. Call every frame **after** the game world render.
+
+##### `resetUI(): void`
+
+Clears all managed state. Call alongside `resetInput()` on phase transitions.
+
+```ts
+// Typical game loop:
+renderFrame(ctx, state)
+tickUI(dt)
+renderUI(ctx)
+
+// Phase transition:
+resetInput()
+resetUI()
+appPhase = 'intro'
+```
+
 ---
 
 ## File structure
@@ -322,9 +483,14 @@ zx-kit/
 │   ├── renderer.ts      # setupCanvas, mirrorSprite, drawSprite, drawChar, drawText,
 │   │                    # drawTextCentered, flashBorder
 │   ├── audio.ts         # initAudio, resumeAudio, beep, playPattern, Note,
-│   │                    # getAudioContext, getMasterGain
-│   └── input.ts         # initInput, tickMovement, consumeFlag/Debug/Pause/AnyKey,
-│                        # isHeld, Direction
+│   │                    # getAudioContext, getMasterGain,
+│   │                    # getMasterVolume, setMasterVolume,
+│   │                    # increaseVolume, decreaseVolume
+│   ├── input.ts         # initInput, tickMovement, consumeFlag/Debug/Pause/AnyKey,
+│   │                    # isHeld, resetInput, Direction
+│   └── ui.ts            # drawBox, drawFrame, drawPanelTitle,
+│                        # drawProgressBar, tickUI, renderUI, resetUI,
+│                        # BorderOptions, DrawProgressBarOptions
 └── dist/                # compiled output (generated by npm run build)
     ├── index.js / .d.ts
     └── ...

package/dist/audio.d.ts

@@ -3,7 +3,7 @@
  * multiple times (subsequent calls are no-ops).
  * Must be called inside a user-gesture handler (click or keydown) due to browser autoplay policy.
  *
- * @param volume - Master gain value (0.0–1.0, default `0.3`)
+ * @param volume - Master gain value (0.0–1.0, default `0.3`). Clamped to valid range.
  *
  * @example
  * window.addEventListener('keydown', () => initAudio(), { once: true })
@@ -36,6 +36,37 @@ export declare function getAudioContext(): AudioContext | null;
  * osc.connect(getMasterGain()!)
  */
 export declare function getMasterGain(): GainNode | null;
+/**
+ * Returns the current master volume (0.0–1.0), or `0` before `initAudio()`.
+ *
+ * @example
+ * const vol = getMasterVolume()  // e.g. 0.3
+ */
+export declare function getMasterVolume(): number;
+/**
+ * Sets the master volume. Clamped to 0.0–1.0. No-op before `initAudio()`.
+ *
+ * @param volume - Target gain value (0.0–1.0)
+ *
+ * @example
+ * setMasterVolume(0.5)   // 50%
+ * setMasterVolume(0)     // mute
+ */
+export declare function setMasterVolume(volume: number): void;
+/**
+ * Increases master volume by 0.1, up to a maximum of 1.0.
+ *
+ * @example
+ * increaseVolume()  // 0.3 → 0.4
+ */
+export declare function increaseVolume(): void;
+/**
+ * Decreases master volume by 0.1, down to a minimum of 0.0.
+ *
+ * @example
+ * decreaseVolume()  // 0.3 → 0.2
+ */
+export declare function decreaseVolume(): void;
 /** A single note in a melody pattern. Use `freq: 0` for a rest (silence). */
 export interface Note {
     freq: number;

package/dist/audio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAM,GAAG,IAAI,CAM5C;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI,QAAQ,GAAG,IAAI,CAE/C;AAED,6EAA6E;AAC7E,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,SAAI,GAAG,IAAI,CAS/D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAc9E"}
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"AASA;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAM,GAAG,IAAI,CAM5C;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI,QAAQ,GAAG,IAAI,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAGpD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,6EAA6E;AAC7E,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,SAAI,GAAG,IAAI,CAS/D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAc9E"}

package/dist/audio.js

@@ -1,11 +1,15 @@
 let ctx = null;
 let masterGain = null;
+const VOLUME_STEP = 0.1;
+function clampVolume(v) {
+    return Math.max(0, Math.min(1, v));
+}
 /**
  * Creates the shared `AudioContext` and master `GainNode`. Idempotent — safe to call
  * multiple times (subsequent calls are no-ops).
  * Must be called inside a user-gesture handler (click or keydown) due to browser autoplay policy.
  *
- * @param volume - Master gain value (0.0–1.0, default `0.3`)
+ * @param volume - Master gain value (0.0–1.0, default `0.3`). Clamped to valid range.
  *
  * @example
  * window.addEventListener('keydown', () => initAudio(), { once: true })
@@ -15,7 +19,7 @@ export function initAudio(volume = 0.3) {
         return;
     ctx = new AudioContext();
     masterGain = ctx.createGain();
-    masterGain.gain.value = volume;
+    masterGain.gain.value = clampVolume(volume);
     masterGain.connect(ctx.destination);
 }
 /**
@@ -52,6 +56,47 @@ export function getAudioContext() {
 export function getMasterGain() {
     return masterGain;
 }
+/**
+ * Returns the current master volume (0.0–1.0), or `0` before `initAudio()`.
+ *
+ * @example
+ * const vol = getMasterVolume()  // e.g. 0.3
+ */
+export function getMasterVolume() {
+    return masterGain?.gain.value ?? 0;
+}
+/**
+ * Sets the master volume. Clamped to 0.0–1.0. No-op before `initAudio()`.
+ *
+ * @param volume - Target gain value (0.0–1.0)
+ *
+ * @example
+ * setMasterVolume(0.5)   // 50%
+ * setMasterVolume(0)     // mute
+ */
+export function setMasterVolume(volume) {
+    if (!masterGain)
+        return;
+    masterGain.gain.value = clampVolume(volume);
+}
+/**
+ * Increases master volume by 0.1, up to a maximum of 1.0.
+ *
+ * @example
+ * increaseVolume()  // 0.3 → 0.4
+ */
+export function increaseVolume() {
+    setMasterVolume(getMasterVolume() + VOLUME_STEP);
+}
+/**
+ * Decreases master volume by 0.1, down to a minimum of 0.0.
+ *
+ * @example
+ * decreaseVolume()  // 0.3 → 0.2
+ */
+export function decreaseVolume() {
+    setMasterVolume(getMasterVolume() - VOLUME_STEP);
+}
 /**
  * Schedules a sequence of notes on the shared `AudioContext`.
  * Silently exits if audio has not been initialised yet.

package/dist/audio.js.map

@@ -1 +1 @@
-{"version":3,"file":"audio.js","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"AAAA,IAAI,GAAG,GAAwB,IAAI,CAAA;AACnC,IAAI,UAAU,GAAoB,IAAI,CAAA;AAEtC;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,MAAM,GAAG,GAAG;IACpC,IAAI,GAAG;QAAE,OAAM;IACf,GAAG,GAAG,IAAI,YAAY,EAAE,CAAA;IACxB,UAAU,GAAG,GAAG,CAAC,UAAU,EAAE,CAAA;IAC7B,UAAU,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAA;IAC9B,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;AACrC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,WAAW;QAAE,KAAK,GAAG,CAAC,MAAM,EAAE,CAAA;AACzD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,CAAA;AACnB,CAAC;AAQD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,UAAU,GAAG,CAAC;IACvD,MAAM,KAAK,GAAG,eAAe,EAAE,CAAA;IAC/B,IAAI,CAAC,KAAK;QAAE,OAAM;IAClB,WAAW,EAAE,CAAA;IACb,IAAI,MAAM,GAAG,UAAU,CAAA;IACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC,CAAA;QAC/E,MAAM,IAAI,IAAI,CAAC,GAAG,CAAA;IACpB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,UAAkB,EAAE,SAAiB;IACtE,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU;QAAE,OAAM;IAC/B,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,EAAE,CAAA;IAClC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,EAAE,CAAA;IAC7B,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAA;IACnB,GAAG,CAAC,SAAS,CAAC,KAAK,GAAG,IAAI,CAAA;IAC1B,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;IACtC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,GAAG,EAAE,SAAS,GAAG,KAAK,CAAC,CAAA;IACzD,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,GAAG,KAAK,CAAC,CAAA;IACpE,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,CAAC,CAAA;IACnE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACjB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IACxB,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IACpB,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC,CAAA;AAChD,CAAC"}
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -3,4 +3,5 @@ export * from './font.js';
 export * from './renderer.js';
 export * from './audio.js';
 export * from './input.js';
+export * from './ui.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,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA"}

package/dist/index.js

@@ -3,4 +3,5 @@ export * from './font.js';
 export * from './renderer.js';
 export * from './audio.js';
 export * from './input.js';
+export * from './ui.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,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA"}

package/dist/input.d.ts

@@ -49,4 +49,14 @@ export declare function consumeAnyKey(): boolean;
  * if (isHeld('ArrowUp')) { ... }
  */
 export declare function isHeld(key: string): boolean;
+/**
+ * Clears all pending key state immediately.
+ * Call when entering a new game phase (e.g. after game-over or menu transition)
+ * to prevent stale inputs from carrying over.
+ *
+ * @example
+ * appPhase = 'gameover'
+ * resetInput()  // discard any queued keypresses from the previous phase
+ */
+export declare function resetInput(): void;
 //# sourceMappingURL=input.d.ts.map

package/dist/input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAoBxD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,WAAW,SAAM,EAAE,cAAc,SAAK,GAAG,IAAI,CAoCtE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAe3D;AAED,sGAAsG;AACtG,wBAAgB,WAAW,IAAI,OAAO,CAA+D;AAErG,gGAAgG;AAChG,wBAAgB,YAAY,IAAI,OAAO,CAA8D;AAErG,kFAAkF;AAClF,wBAAgB,YAAY,IAAI,OAAO,CAA8D;AAErG;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAA6D;AAErG;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAyB"}
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAoBxD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,WAAW,SAAM,EAAE,cAAc,SAAK,GAAG,IAAI,CAoCtE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAe3D;AAED,sGAAsG;AACtG,wBAAgB,WAAW,IAAI,OAAO,CAA+D;AAErG,gGAAgG;AAChG,wBAAgB,YAAY,IAAI,OAAO,CAA8D;AAErG,kFAAkF;AAClF,wBAAgB,YAAY,IAAI,OAAO,CAA8D;AAErG;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAA6D;AAErG;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAyB;AAErE;;;;;;;;GAQG;AACH,wBAAgB,UAAU,IAAI,IAAI,CASjC"}

package/dist/input.js

@@ -113,4 +113,23 @@ export function consumeAnyKey() { const v = pendingAnyKey; pendingAnyKey = false
  * if (isHeld('ArrowUp')) { ... }
  */
 export function isHeld(key) { return held.has(key); }
+/**
+ * Clears all pending key state immediately.
+ * Call when entering a new game phase (e.g. after game-over or menu transition)
+ * to prevent stale inputs from carrying over.
+ *
+ * @example
+ * appPhase = 'gameover'
+ * resetInput()  // discard any queued keypresses from the previous phase
+ */
+export function resetInput() {
+    held.clear();
+    pendingFlag = false;
+    pendingDebug = false;
+    pendingPause = false;
+    pendingAnyKey = false;
+    repeatDir = null;
+    repeatPhase = 'idle';
+    pendingImmediate = null;
+}
 //# sourceMappingURL=input.js.map

package/dist/input.js.map

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

package/dist/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,MAAM,EACb,KAAK,SAAM,EACX,MAAM,SAAM,GACX,wBAAwB,CAS1B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,CAUxD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,wBAAwB,EAC7B,MAAM,EAAE,UAAU,EAClB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GACzB,IAAI,CAUN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAC1B,IAAI,CAYN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAC1B,IAAI,CAIN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAC1B,IAAI,CAGN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,MAAgB,GAC3B,IAAI,CAWN"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,MAAM,EACb,KAAK,SAAM,EACX,MAAM,SAAM,GACX,wBAAwB,CAS1B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,CAUxD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,wBAAwB,EAC7B,MAAM,EAAE,UAAU,EAClB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GACzB,IAAI,CAKN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAC1B,IAAI,CAON;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAC1B,IAAI,CAIN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAC1B,IAAI,CAGN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,MAAgB,GAC3B,IAAI,CAWN"}

package/dist/renderer.js

@@ -1,5 +1,14 @@
 import { C, CELL } from './palette.js';
 import { getCharRow } from './font.js';
+function drawBitmap(ctx, getByte, x, y) {
+    for (let row = 0; row < 8; row++) {
+        const byte = getByte(row);
+        for (let bit = 0; bit < 8; bit++) {
+            if (byte & (0x80 >> bit))
+                ctx.fillRect(x + bit, y + row, 1, 1);
+        }
+    }
+}
 /**
  * Initialises a canvas element for pixel-perfect scaled rendering.
  * Sets canvas dimensions, applies CSS size, disables image smoothing, applies `ctx.scale()`,
@@ -65,13 +74,7 @@ export function drawSprite(ctx, sprite, x, y, ink, paper) {
     ctx.fillStyle = paper;
     ctx.fillRect(x, y, CELL, CELL);
     ctx.fillStyle = ink;
-    for (let row = 0; row < 8; row++) {
-        const byte = sprite[row];
-        for (let bit = 0; bit < 8; bit++) {
-            if (byte & (0x80 >> bit))
-                ctx.fillRect(x + bit, y + row, 1, 1);
-        }
-    }
+    drawBitmap(ctx, row => sprite[row], x, y);
 }
 /**
  * Draws a single ASCII character at game coordinates using the ROM font.
@@ -94,13 +97,7 @@ export function drawChar(ctx, code, x, y, ink, paper) {
         ctx.fillRect(x, y, CELL, CELL);
     }
     ctx.fillStyle = ink;
-    for (let row = 0; row < 8; row++) {
-        const byte = getCharRow(code, row);
-        for (let bit = 0; bit < 8; bit++) {
-            if (byte & (0x80 >> bit))
-                ctx.fillRect(x + bit, y + row, 1, 1);
-        }
-    }
+    drawBitmap(ctx, row => getCharRow(code, row), x, y);
 }
 /**
  * Draws a string left-to-right starting at game coordinates `(x, y)`.

package/dist/renderer.js.map

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

package/dist/ui.d.ts

@@ -0,0 +1,231 @@
+import type { SpectrumColor } from './palette.js';
+/**
+ * Border configuration for UI primitives.
+ * When the `border` object is present on a parent option, a border is rendered.
+ * `enabled` defaults to `true` — set it to `false` to suppress the border
+ * while keeping the object in place for future toggling.
+ */
+export type BorderOptions = {
+    /** Enable/disable border rendering. Default: `true` */
+    enabled?: boolean;
+    /** Border thickness in pixels. Default: `1` */
+    thickness?: number;
+    /**
+     * Border color. Default: same as the primary `ink` / `color` of the parent function.
+     * Accepts any {@link SpectrumColor} value.
+     */
+    color?: SpectrumColor;
+    /**
+     * Border style.
+     * - `'solid'`  — continuous lines (default)
+     * - `'dashed'` — alternating 2 px on / 2 px off segments
+     */
+    style?: 'solid' | 'dashed';
+};
+/**
+ * Options for {@link drawProgressBar}.
+ */
+export type DrawProgressBarOptions = {
+    /**
+     * Stable key for managed-visibility mode.
+     * The bar's last-drawn state is registered under this key so `renderUI` can
+     * redraw it on subsequent frames. Defaults to `"${x},${y}"` when omitted.
+     */
+    id?: string;
+    /** Left edge of the bar in game pixels. */
+    x: number;
+    /** Top edge of the bar in game pixels. */
+    y: number;
+    /**
+     * Total width of the bar in game pixels.
+     * Should be a multiple of `CELL` (8) — any remainder is left blank.
+     */
+    width: number;
+    /** Current value to represent. */
+    value: number;
+    /** Minimum value (left edge = empty). Default: `0` */
+    min?: number;
+    /** Maximum value (right edge = full). Default: `1` */
+    max?: number;
+    /** Filled-block foreground color. Default: `C.B_WHITE` */
+    ink?: SpectrumColor;
+    /** Empty-block background color. Default: `C.BLACK` */
+    paper?: SpectrumColor;
+    /** Optional border around the entire bar. */
+    border?: BorderOptions;
+    /**
+     * How long the bar stays visible after the last `drawProgressBar` call (ms).
+     * - `> 0` — auto-hides after this many milliseconds.
+     * - `0`   — permanent; only cleared by `resetUI()`.
+     * Default: `500`
+     */
+    visibilityLength?: number;
+};
+/**
+ * Draws a filled rectangular box using ZX-style rendering.
+ *
+ * Renders a solid background (`paper`) and an optional border.
+ * Coordinates are in game pixels (already scaled by `setupCanvas`).
+ * Does NOT render text — use `drawPanelTitle` for labelled panels.
+ *
+ * @example
+ * drawBox(ctx, {
+ *   x: 8, y: 8, width: 112, height: 40,
+ *   paper: C.BLACK, ink: C.B_WHITE,
+ *   border: { style: 'solid', thickness: 1 },
+ * })
+ */
+export declare function drawBox(ctx: CanvasRenderingContext2D, options: {
+    /** Left edge in game pixels */
+    x: number;
+    /** Top edge in game pixels */
+    y: number;
+    /** Width in game pixels */
+    width: number;
+    /** Height in game pixels */
+    height: number;
+    /** Background fill color */
+    paper: SpectrumColor;
+    /** Foreground color — used as default border color when `border.color` is omitted */
+    ink?: SpectrumColor;
+    /** Optional border */
+    border?: BorderOptions;
+}): void;
+/**
+ * Draws a rectangular frame — border only, no background fill.
+ *
+ * Unlike `drawBox`, the inside area is left untouched.
+ * Useful for selection highlights, overlays, and ZX-style panels
+ * where the background is already painted.
+ *
+ * @example
+ * drawFrame(ctx, { x: 0, y: 0, width: 256, height: 176, color: C.B_CYAN })
+ * drawFrame(ctx, { x: 16, y: 16, width: 64, height: 32, color: C.B_RED,
+ *   border: { style: 'dashed', thickness: 1 } })
+ */
+export declare function drawFrame(ctx: CanvasRenderingContext2D, options: {
+    /** Left edge in game pixels */
+    x: number;
+    /** Top edge in game pixels */
+    y: number;
+    /** Width in game pixels */
+    width: number;
+    /** Height in game pixels */
+    height: number;
+    /** Frame color */
+    color: SpectrumColor;
+    /** Border configuration — `color` here overrides the top-level `color` */
+    border?: BorderOptions;
+}): void;
+/**
+ * Draws a ZX-style panel title — a text strip with an optional background fill.
+ *
+ * Does NOT draw the surrounding container (`drawBox` / `drawFrame` are separate).
+ * The strip height is always `CELL + padding * 2` pixels.
+ *
+ * @example
+ * // Labelled panel:
+ * drawBox(ctx,   { x: 8, y: 24, width: 128, height: 56, paper: C.BLACK })
+ * drawPanelTitle(ctx, { text: 'OPTIONS', x: 8, y: 24, ink: C.B_YELLOW,
+ *   paper: C.BLACK, centered: true, width: 128 })
+ *
+ * // No background — ink only:
+ * drawPanelTitle(ctx, { text: 'DEBUG', x: 0, y: 0, ink: C.B_CYAN })
+ */
+export declare function drawPanelTitle(ctx: CanvasRenderingContext2D, options: {
+    /** Title text (ASCII — rendered via ZX ROM font) */
+    text: string;
+    /** Left edge in game pixels */
+    x: number;
+    /** Top edge of the title strip in game pixels */
+    y: number;
+    /** Text color */
+    ink: SpectrumColor;
+    /** Background behind the title strip. Omit for transparent (ink-only rendering) */
+    paper?: SpectrumColor;
+    /** Padding inside the strip in pixels. Default: `2` */
+    padding?: number;
+    /**
+     * Center the title horizontally within `width`.
+     * Requires `width` to be provided; ignored otherwise.
+     */
+    centered?: boolean;
+    /** Width used for centering (game pixels). Required when `centered: true`. */
+    width?: number;
+}): void;
+/**
+ * Draws a ZX-style progress / value bar and registers it for managed redraws.
+ *
+ * The bar is drawn **immediately** on every call. Additionally, the options are
+ * stored internally so `renderUI` can repaint the bar each frame for
+ * `visibilityLength` ms without requiring the caller to supply the state again.
+ *
+ * Calling `drawProgressBar` again with the same `id` **resets the timer** — use
+ * this to refresh the display when the value changes.
+ *
+ * **Typical pattern:**
+ * ```ts
+ * // On value change only:
+ * if (consumeVolUp()) {
+ *   increaseVolume()
+ *   drawProgressBar(ctx, { id: 'volume', x: 88, y: 88, width: 80,
+ *     value: getMasterVolume(), visibilityLength: 1500 })
+ * }
+ *
+ * // Every frame (after game world render):
+ * tickUI(dt)
+ * renderUI(ctx)
+ * ```
+ *
+ * @example
+ * // Permanent HUD health bar:
+ * drawProgressBar(ctx, {
+ *   id: 'health', x: 0, y: 184, width: 40, value: lives, min: 0, max: 3,
+ *   ink: C.B_GREEN, paper: C.BLACK, visibilityLength: 0,
+ * })
+ *
+ * // Temporary volume indicator (auto-hides after 1.5 s):
+ * drawProgressBar(ctx, {
+ *   id: 'volume', x: 88, y: 88, width: 80, value: getMasterVolume(),
+ *   ink: C.B_GREEN, paper: C.BLACK,
+ *   border: { style: 'solid' },
+ *   visibilityLength: 1500,
+ * })
+ */
+export declare function drawProgressBar(ctx: CanvasRenderingContext2D, options: DrawProgressBarOptions): void;
+/**
+ * Advances all managed bar timers by `dtMs` milliseconds.
+ * Bars whose timer reaches zero are removed and will no longer appear in `renderUI`.
+ * Call once per frame, typically just before `renderUI`.
+ *
+ * @param dtMs - Frame delta in milliseconds
+ *
+ * @example
+ * // End of game loop:
+ * tickUI(dt)
+ * renderUI(ctx)
+ */
+export declare function tickUI(dtMs: number): void;
+/**
+ * Redraws all currently visible managed bars (timer > 0 or permanent).
+ * Call every frame **after** the game world has been rendered so bars appear on top.
+ *
+ * @param ctx - Canvas 2D rendering context
+ *
+ * @example
+ * renderFrame(ctx, state)
+ * tickUI(dt)
+ * renderUI(ctx)
+ */
+export declare function renderUI(ctx: CanvasRenderingContext2D): void;
+/**
+ * Clears all managed UI state — removes every active bar timer and its stored options.
+ * Call alongside `resetInput()` when transitioning between major game phases.
+ *
+ * @example
+ * resetInput()
+ * resetUI()
+ * appPhase = 'intro'
+ */
+export declare function resetUI(): void;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

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

package/dist/ui.js

@@ -0,0 +1,210 @@
+import { C, CELL } from './palette.js';
+import { drawChar, drawText } from './renderer.js';
+const _bars = new Map();
+// ─── Private helpers ──────────────────────────────────────────────────────────
+function _drawBorder(ctx, x, y, width, height, border, fallbackColor) {
+    if (border.enabled === false)
+        return;
+    const color = border.color ?? fallbackColor;
+    const t = border.thickness ?? 1;
+    ctx.fillStyle = color;
+    if (border.style !== 'dashed') {
+        ctx.fillRect(x, y, width, t); // top
+        ctx.fillRect(x, y + height - t, width, t); // bottom
+        ctx.fillRect(x, y, t, height); // left
+        ctx.fillRect(x + width - t, y, t, height); // right
+    }
+    else {
+        const d = 2; // dash length in pixels
+        for (let i = 0; i < width; i += d * 2) {
+            ctx.fillRect(x + i, y, Math.min(d, width - i), t); // top
+            ctx.fillRect(x + i, y + height - t, Math.min(d, width - i), t); // bottom
+        }
+        for (let i = 0; i < height; i += d * 2) {
+            ctx.fillRect(x, y + i, t, Math.min(d, height - i)); // left
+            ctx.fillRect(x + width - t, y + i, t, Math.min(d, height - i)); // right
+        }
+    }
+}
+function _renderBar(ctx, o) {
+    const min = o.min ?? 0;
+    const max = o.max ?? 1;
+    const ink = o.ink ?? C.B_WHITE;
+    const paper = o.paper ?? C.BLACK;
+    const chars = Math.floor(o.width / CELL);
+    const ratio = Math.max(0, Math.min(1, (o.value - min) / (max - min)));
+    const filled = Math.round(ratio * chars);
+    ctx.fillStyle = paper;
+    ctx.fillRect(o.x, o.y, chars * CELL, CELL);
+    for (let i = 0; i < filled; i++) {
+        drawChar(ctx, 127, o.x + i * CELL, o.y, ink, paper); // 127 = solid block █
+    }
+    if (o.border)
+        _drawBorder(ctx, o.x, o.y, chars * CELL, CELL, o.border, ink);
+}
+// ─── Public API — stateless primitives ───────────────────────────────────────
+/**
+ * Draws a filled rectangular box using ZX-style rendering.
+ *
+ * Renders a solid background (`paper`) and an optional border.
+ * Coordinates are in game pixels (already scaled by `setupCanvas`).
+ * Does NOT render text — use `drawPanelTitle` for labelled panels.
+ *
+ * @example
+ * drawBox(ctx, {
+ *   x: 8, y: 8, width: 112, height: 40,
+ *   paper: C.BLACK, ink: C.B_WHITE,
+ *   border: { style: 'solid', thickness: 1 },
+ * })
+ */
+export function drawBox(ctx, options) {
+    const { x, y, width, height, paper, ink, border } = options;
+    ctx.fillStyle = paper;
+    ctx.fillRect(x, y, width, height);
+    if (border)
+        _drawBorder(ctx, x, y, width, height, border, ink ?? paper);
+}
+/**
+ * Draws a rectangular frame — border only, no background fill.
+ *
+ * Unlike `drawBox`, the inside area is left untouched.
+ * Useful for selection highlights, overlays, and ZX-style panels
+ * where the background is already painted.
+ *
+ * @example
+ * drawFrame(ctx, { x: 0, y: 0, width: 256, height: 176, color: C.B_CYAN })
+ * drawFrame(ctx, { x: 16, y: 16, width: 64, height: 32, color: C.B_RED,
+ *   border: { style: 'dashed', thickness: 1 } })
+ */
+export function drawFrame(ctx, options) {
+    const { x, y, width, height, color, border = {} } = options;
+    _drawBorder(ctx, x, y, width, height, { ...border, color }, color);
+}
+/**
+ * Draws a ZX-style panel title — a text strip with an optional background fill.
+ *
+ * Does NOT draw the surrounding container (`drawBox` / `drawFrame` are separate).
+ * The strip height is always `CELL + padding * 2` pixels.
+ *
+ * @example
+ * // Labelled panel:
+ * drawBox(ctx,   { x: 8, y: 24, width: 128, height: 56, paper: C.BLACK })
+ * drawPanelTitle(ctx, { text: 'OPTIONS', x: 8, y: 24, ink: C.B_YELLOW,
+ *   paper: C.BLACK, centered: true, width: 128 })
+ *
+ * // No background — ink only:
+ * drawPanelTitle(ctx, { text: 'DEBUG', x: 0, y: 0, ink: C.B_CYAN })
+ */
+export function drawPanelTitle(ctx, options) {
+    const { text, x, y, ink, paper, padding = 2, centered, width } = options;
+    const textW = text.length * CELL;
+    const stripW = centered && width !== undefined ? width : textW + padding * 2;
+    if (paper !== undefined) {
+        ctx.fillStyle = paper;
+        ctx.fillRect(x, y, stripW, CELL + padding * 2);
+    }
+    const tx = centered && width !== undefined
+        ? x + Math.floor((width - textW) / 2)
+        : x + padding;
+    drawText(ctx, text, tx, y + padding, ink, paper);
+}
+// ─── Public API — stateful widget ────────────────────────────────────────────
+/**
+ * Draws a ZX-style progress / value bar and registers it for managed redraws.
+ *
+ * The bar is drawn **immediately** on every call. Additionally, the options are
+ * stored internally so `renderUI` can repaint the bar each frame for
+ * `visibilityLength` ms without requiring the caller to supply the state again.
+ *
+ * Calling `drawProgressBar` again with the same `id` **resets the timer** — use
+ * this to refresh the display when the value changes.
+ *
+ * **Typical pattern:**
+ * ```ts
+ * // On value change only:
+ * if (consumeVolUp()) {
+ *   increaseVolume()
+ *   drawProgressBar(ctx, { id: 'volume', x: 88, y: 88, width: 80,
+ *     value: getMasterVolume(), visibilityLength: 1500 })
+ * }
+ *
+ * // Every frame (after game world render):
+ * tickUI(dt)
+ * renderUI(ctx)
+ * ```
+ *
+ * @example
+ * // Permanent HUD health bar:
+ * drawProgressBar(ctx, {
+ *   id: 'health', x: 0, y: 184, width: 40, value: lives, min: 0, max: 3,
+ *   ink: C.B_GREEN, paper: C.BLACK, visibilityLength: 0,
+ * })
+ *
+ * // Temporary volume indicator (auto-hides after 1.5 s):
+ * drawProgressBar(ctx, {
+ *   id: 'volume', x: 88, y: 88, width: 80, value: getMasterVolume(),
+ *   ink: C.B_GREEN, paper: C.BLACK,
+ *   border: { style: 'solid' },
+ *   visibilityLength: 1500,
+ * })
+ */
+export function drawProgressBar(ctx, options) {
+    _renderBar(ctx, options);
+    const id = options.id ?? `${options.x},${options.y}`;
+    const visibilityLength = options.visibilityLength ?? 500;
+    _bars.set(id, {
+        options,
+        timer: visibilityLength,
+        permanent: visibilityLength === 0,
+    });
+}
+/**
+ * Advances all managed bar timers by `dtMs` milliseconds.
+ * Bars whose timer reaches zero are removed and will no longer appear in `renderUI`.
+ * Call once per frame, typically just before `renderUI`.
+ *
+ * @param dtMs - Frame delta in milliseconds
+ *
+ * @example
+ * // End of game loop:
+ * tickUI(dt)
+ * renderUI(ctx)
+ */
+export function tickUI(dtMs) {
+    for (const [id, bar] of _bars) {
+        if (bar.permanent)
+            continue;
+        bar.timer -= dtMs;
+        if (bar.timer <= 0)
+            _bars.delete(id);
+    }
+}
+/**
+ * Redraws all currently visible managed bars (timer > 0 or permanent).
+ * Call every frame **after** the game world has been rendered so bars appear on top.
+ *
+ * @param ctx - Canvas 2D rendering context
+ *
+ * @example
+ * renderFrame(ctx, state)
+ * tickUI(dt)
+ * renderUI(ctx)
+ */
+export function renderUI(ctx) {
+    for (const bar of _bars.values()) {
+        _renderBar(ctx, bar.options);
+    }
+}
+/**
+ * Clears all managed UI state — removes every active bar timer and its stored options.
+ * Call alongside `resetInput()` when transitioning between major game phases.
+ *
+ * @example
+ * resetInput()
+ * resetUI()
+ * appPhase = 'intro'
+ */
+export function resetUI() {
+    _bars.clear();
+}
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zx-kit",
-  "version": "0.2.3",
-  "description": "Reusable ZX Spectrum primitives: font, palette, renderer, audio, input",
+  "version": "0.4.0",
+  "description": "Reusable ZX Spectrum primitives: font, palette, renderer, audio, input, ui",
   "type": "module",
   "exports": {
     ".": {