@zakkster/lite-scratch-fx 1.5.0 → 1.5.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [1.5.1] - 2026-08-23
+
+Cover-fade fidelity patch for `iceBreath`. Backward compatible; no API change.
+
+### Fixed
+- **`iceBreath` brightness ramp is now eased, matching the game's tween (B-21).** The
+  `brightness()` filter followed a linear `1 + fadeT` while the opacity one line above
+  followed the cubic `1 - fadeT^3`. GSAP applies a tween's ease to its numeric filter
+  target too, so both should share the cubic `power2.in` curve. The tick now computes
+  `ez = easeIn(fadeT)` once and drives opacity as `1 - ez` and brightness as `1 + ez`;
+  binding both writes to the same value removes the drift that caused the bug. Observable
+  change: at the fade midpoint brightness is `1.125`, not `1.5` (the cover no longer blows
+  out to near-white by mid-reveal). No allocation added; the torture gate is unchanged.
+
+### Changed
+- **Docs: `iceBreath`/`dragonBreath` `spread` is a jet half-angle (B-22).** The catalog
+  card now states `spread` is a half-angle in radians, matching `README.md` and `llms.txt`.
+  `IceBreathRecipe({ spread: FX_CONFIG.iceBreath.spread })` doubles the cone; pass
+  `spread / 2`. No code change.
+
 ## [1.5.0] - 2026-08-23
 
 Cover-fade fidelity, live image reveals, and additive recipe/stage knobs. Backward

package/README.md

@@ -274,7 +274,7 @@ current built-in look:
 
 | Constant                  | Value                                                        | Meaning                                              |
 | ------------------------- | ----------------------------------------------------------- | ---------------------------------------------------- |
-| `VERSION`                 | `'1.5.0'`                                                    | Package version string (synced to package.json).     |
+| `VERSION`                 | `'1.5.1'`                                                    | Package version string (synced to package.json).     |
 | `maxParticles` (default)  | `2000`                                                       | Controller / stage pool capacity.                    |
 | `scanPrecision` (default) | `32`                                                         | Horizontal resolution of the spawn-point scan.       |
 | stage `capacity` (default)| `300`                                                       | Slots a stage controller reserves from the pool.     |

package/index.js

@@ -13,7 +13,7 @@
 
 // Three-place version sync: this constant, package.json "version", and the top
 // CHANGELOG.md heading must always match. /release keeps them locked.
-export const VERSION = '1.5.0';
+export const VERSION = '1.5.1';
 
 export { createScratchController } from './src/ScratchController.js';
 export { default as ScratchController } from './src/ScratchController.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zakkster/lite-scratch-fx",
   "author": "Zahary Shinikchiev <shinikchiev@yahoo.com>",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "One-shot scratch-card reveal effects on canvas. A controller scans the still-covered pixels of a scratch layer, spawns particles from them, and delegates physics and rendering to a recipe. 21 themeable recipes (burn, shatter, dissolve, glitch, gold dust, cosmic dust, and more), a registry with a register hook, zero GSAP, a zero-GC hot path, deterministic seeded RNG, and a stage that runs a grid of simultaneous reveals over one shared pool.",
   "type": "module",
   "main": "./index.js",

package/src/ScratchRecipes.js

@@ -275,8 +275,9 @@ export function IceBreathRecipe({count = 450, duration = 1500, spread = 0.225, s
             const dv = Math.pow(0.96, ds);
             let alive = 0;
             const fadeT = clamp((elapsed - 100) / 500, 0, 1);
-            src.style.opacity = 1 - easeIn(fadeT);
-            src.style.filter = `brightness(${1 + fadeT})`;
+            const ez = easeIn(fadeT);
+            src.style.opacity = 1 - ez;
+            src.style.filter = `brightness(${1 + ez})`;
 
             for (let i = 0; i < max; i++) {
                 if (life[i] <= 0) continue;