paperlab 0.7.0 → 0.8.0

package/dist/fx.d.cts

@@ -1,5 +1,5 @@
-import { D as DamageSource } from './damageContract-DPF1YFLZ.cjs';
-export { a as DAMAGE_CHANNELS, b as DAMAGE_LOOK_DEFAULTS, c as DamageLook } from './damageContract-DPF1YFLZ.cjs';
+import { D as DamageSource } from './damageContract-nF1fgK7P.cjs';
+export { a as DAMAGE_CHANNELS, b as DAMAGE_LOOK_DEFAULTS, c as DamageLook } from './damageContract-nF1fgK7P.cjs';
 import * as react from 'react';
 import { ReactNode } from 'react';
 import * as THREE from 'three';
@@ -400,7 +400,7 @@ declare const particlePresets: {
      * simulation, on purpose; see the fx plan.
      */
     readonly smoke: {
-        readonly life: readonly [1.8, 3.5];
+        readonly life: readonly [1.4, 2.6];
         readonly speed: readonly [0.05, 0.15];
         readonly direction: readonly [0, 1, 0];
         readonly spread: 0.3;
@@ -408,9 +408,9 @@ declare const particlePresets: {
         readonly drag: 0.9;
         readonly jitter: 0.3;
         readonly windCatch: 1;
-        readonly size: readonly [0.05, 0.35];
+        readonly size: readonly [0.05, 0.18];
         readonly color: readonly [readonly [0.147, 0.13, 0.117], readonly [0.2, 0.19, 0.18]];
-        readonly alpha: readonly [0.08, 0];
+        readonly alpha: readonly [0.07, 0];
         readonly spin: 0.4;
         readonly blend: "normal";
         readonly shape: "soft";
@@ -422,16 +422,16 @@ declare const particlePresets: {
      * burn that proves paper was there.
      */
     readonly ash: {
-        readonly life: readonly [2.5, 5];
+        readonly life: readonly [1.2, 2.6];
         readonly speed: readonly [0.14, 0.3];
         readonly direction: readonly [0, 1, 0];
         readonly spread: 0.55;
-        readonly lift: -0.22;
+        readonly lift: -0.42;
         readonly drag: 1.6;
         readonly jitter: 1.2;
         readonly windCatch: 1;
         readonly size: readonly [0.03, 0.026];
-        readonly color: readonly [readonly [0.07, 0.065, 0.06], readonly [0.12, 0.115, 0.11]];
+        readonly color: readonly [readonly [0.04, 0.037, 0.034], readonly [0.07, 0.066, 0.062]];
         readonly alpha: readonly [0.95, 0];
         readonly spin: 4;
         readonly blend: "normal";
@@ -540,19 +540,13 @@ interface FireEmitterOptions {
     };
 }
 /**
- * How much each kind leaves the front, per texel per second.
- *
- * `smoke` is 0 on purpose. There were three smoke systems running at once —
- * the fire simulator's own, these sprite puffs at 8% alpha, and the smoulder
- * wisp — and the review's note was that only one of them should exist. The
- * simulator's is the one that belongs to a burning sheet: it is the same
- * fluid the flames are made of, so it rises with them instead of beside them.
- * `FxWisps` still carries the thread after the flames are out, which is the
- * one moment the simulator has nothing left to make. The preset stays: it is
- * a parameter set, and anything may still ask the pool for smoke.
- *
- * Embers and ash are both down. Ash at 0.86 a texel was a flake for nearly
- * every one that burnt through — a dust shower. Fewer and larger is the note.
+ * How much each kind leaves the front, per texel per second — Noor's tune in
+ * the lab on 2026-09-13, which the lab starts from and `/hands` inherits.
+ *
+ * The simulator's smoke is the main smoke of a burning sheet, since it is the
+ * same fluid the flames are made of; these sprite puffs, once switched off
+ * for doubling it, are back as a light thread beside it. Ash at 0.86 a texel
+ * was a dust shower; 0.36 is a light fall of it.
  */
 declare const fireEmitterDefaults: Required<FireEmitterOptions>;
 /**
@@ -744,6 +738,15 @@ interface FxPostProps {
     locate?: SurfaceLocator;
     /** Heat haze in pixels at 1080p, overriding the tier's; 0 turns it off. */
     haze?: number;
+    /**
+     * Shallow focus on the burn, 0..1; 0 keeps everything sharp.
+     *
+     * A macro lens held close to a burning edge has a few millimetres of
+     * focus and nothing else (§K4): the rim is sharp, the rest of the sheet
+     * goes soft. It focuses on the fire itself — the burning rim is what the
+     * shot is about — so it needs `field` and `locate` like the haze does.
+     */
+    focus?: number;
 }
 /**
  * `fallback={null}`: the scene behind it is already drawn. One frame without
@@ -840,13 +843,13 @@ declare const FIRE_SOOT_SCALE = 3;
  *
  * It lives beside the threshold because the two are one setting: bloom is a
  * multiplier on whatever clears the threshold, so its right value depends
- * entirely on how much fire is authored above it. 1.55 was tuned when the
- * flames were UNDER the threshold and bloom had almost nothing to work on —
- * measured, 0.07% of the frame. Once the flames cleared it, that same 1.55
- * tinted the entire black stage olive. Swept at 0.25, 0.6 and 1.2 against the
- * peak frame; past about 0.4 the stage stops being black.
+ * entirely on how much fire is authored above it. With a core authored to
+ * over-expose, 0.55 was the most the black stage could take; the flame of
+ * {@link FIRE_ZONES} (Noor, 2026-09-13) authors none of it past the
+ * threshold, and 1.25 is her tune for it. `pnpm test:fire-budget` holds the
+ * stage black and the paper unbloomed whatever this is set to.
  */
-declare const FX_BLOOM = 0.55;
+declare const FX_BLOOM = 1.25;
 /**
  * A flame, in four zones — drawn the way the sheet's burn is (ember line, ash
  * lip, char, scorch): each part named for what it is, with its own controls.
@@ -854,11 +857,10 @@ declare const FX_BLOOM = 0.55;
  *
  *   root  the blue leading edge where fresh gas meets the air at the paper.
  *         Its light comes from excited molecules, not soot, so it is faint
- *         and blue — and it starts OFF, because blue light added over cream
- *         paper reads lavender.
- *   core  the hottest gas, where soot forms densest and glows pale. The only
- *         zone allowed to over-expose past the bloom threshold, and so the
- *         one that blooms.
+ *         and blue — and only ever a trace, because blue light added over
+ *         cream paper reads lavender.
+ *   core  the hottest gas, where soot forms densest and glows pale — the
+ *         brightest zone, and the one the bloom finds first.
  *   body  the luminous bulk: soot glowing yellow-orange as it rises.
  *   tip   where soot cools and burns off at the outer edge — orange-red,
  *         dimmer, tearing into tongues. What survives escapes as smoke.
@@ -876,12 +878,11 @@ declare const FX_BLOOM = 0.55;
  * multiples of paper white; colours are sRGB, the way a colour picker gives
  * them.
  *
- * The body is ABOVE paper white. It was once held below it, because under a
- * bright preset paper sits at the top of the tone curve and anything brighter
- * loses its colour — and a flame dimmer than the paper behind it, drawn
- * opaque, is a yellow decal on the sheet, not light. Fire photographed in a
- * bright room DOES wash out; that is the lighting's to answer (the lab shoots
- * under `noir`, as the references were), not the flame's.
+ * How bright the body is against paper white is a judgement, and it has gone
+ * both ways. Above it, a flame keeps its light in a bright room but loses its
+ * colour to the tone curve; below it, the colour holds, and a flame drawn
+ * opaque risks reading as a decal on the sheet rather than as light. The
+ * defaults sit below it (Noor, 2026-09-13), with the bloom carrying the glow.
  */
 interface FireZones {
     root: {
@@ -912,10 +913,12 @@ type FireZonesInput = {
     [Z in keyof FireZones]?: Partial<FireZones[Z]>;
 };
 /**
- * The defaults reproduce the look arrived at by measurement against
- * Flame_base.png (yellow ~30%, orange ~40%, pale ~18% of a flame's pixels),
- * now expressed zone by zone. Each colour is the linear emission the previous
- * ramp used in that band, written as the sRGB a picker would show.
+ * Noor's tune in the lab on 2026-09-13, and the source of truth for how a
+ * flame looks: the lab starts from it and `/hands` inherits it. A gentler
+ * flame than the one it replaced — every zone sits under the bloom threshold,
+ * so its glow comes from the bloom's strength ({@link FX_BLOOM}) spreading
+ * the brightest gas, not from a core authored to over-expose. The values it
+ * replaced, measured against Flame_base.png, are in the history of this file.
  */
 declare const FIRE_ZONES: FireZones;
 /** The defaults with `input` laid over them, zone by zone. */
@@ -1313,25 +1316,48 @@ declare class FireFluid {
 interface FxFireLightProps {
     field: DamageField;
     locate: SurfaceLocator;
-    /** How bright the fire is per unit of burning front. Tuned against Hero.png. */
+    /** How bright the fire is per unit of burning front. */
     gain?: number;
+    /**
+     * The brightest cluster's light casts shadows: a curled edge, a lifted
+     * plate and a hanging flap throw flickering shade across the sheet, which
+     * is much of what makes firelight read as firelight. One shadow pass a
+     * frame, so off unless asked for.
+     */
+    shadows?: boolean;
 }
 /**
  * Fire is a light source (§4.8, §7). A fire that changes nothing around it
  * looks pasted on.
  *
- * A warm point light — about 1900 K — at the middle of the burning rim,
- * raised by half a flame, as bright as the front is long and flickering on
- * the very noise the flames puff on, so light and flame agree. It reaches the
- * whole sheet: `decay` is held below the physical 2, because a sheet is a
- * small thing next to a fire and Hero.png warms it to the top edge.
- *
- * And a dimmer twin on the FAR side of the sheet, for translucency: paper is
- * thin, and a fire in front of it glows through to the back, warm and
- * diffused (§7). A second light is the whole trick — the sheet's own
- * material already lights its back face from whatever is behind it.
+ * One warm point light for each place the fire is gathered — up to
+ * {@link FIRE_CLUSTERS} of them, from {@link fireStateOf} — standing at its
+ * cluster raised by half a flame, as bright as its share of the fire and
+ * flickering on its own tongues' puff. A tall tongue on the left lights the
+ * left. It used to be one light at the middle of the whole rim, which lit the
+ * sheet the same wherever the flames actually were.
+ *
+ * Each light's colour follows how hot the paper under its tongues is: the
+ * pale peach of a fire at its height, deepening toward orange as it cools —
+ * never toward red, which on white paper is the pink the spec forbids.
+ * Together they give off what the single light did: the front's length times
+ * `gain`, shared out.
+ *
+ * And one dimmer light on the FAR side of the sheet, at the fire as a whole,
+ * for translucency: paper is thin, and a fire in front of it glows through to
+ * the back (§7). The sheet's own material lights its back face from whatever
+ * is behind it.
+ *
+ * Every light is mounted all the time and only its intensity changes, so a
+ * fire gathering into more places or fewer never makes three recompile a
+ * shader.
+ */
+declare function FxFireLight({ field, locate, gain, shadows }: FxFireLightProps): react.JSX.Element;
+/**
+ * Light per unit of front length; the front runs to ~0.045 at a burn's peak.
+ * Noor's tune, 2026-09-13 (it was 42).
  */
-declare function FxFireLight({ field, locate, gain }: FxFireLightProps): react.JSX.Element;
+declare const FIRE_LIGHT_GAIN = 26;
 
 /** What the page says about the match this frame. Written in place — never a prop change. */
 interface MatchFlameState {
@@ -1793,4 +1819,4 @@ declare class FireSound {
     private next;
 }
 
-export { Afterglow, type AfterglowOptions, type AudioLike, type BiquadFilterLike, CHAR, DamageField, type DamageFieldOptions, DamageSource, FIELD_SIZE, FIRE_GLOW, FIRE_HEAT_SCALE, FIRE_SOOT_SCALE, FIRE_ZONES, FIXED_DT, FLAME_HEIGHT, FX_BLOOM, FX_BLOOM_THRESHOLD, FX_INITIAL_TIER, FX_TIER_ORDER, type FieldStats, FireEmitter, type FireEmitterOptions, FireFluid, type FireFluidParams, FireSound, type FireSoundOptions, type FireZones, type FireZonesInput, type FlameAnchor, type FluidGrid, FxAudio, type FxAudioOptions, type FxFilm, FxFireFluid, type FxFireFluidProps, FxFireLight, type FxFireLightProps, FxFlames, type FxFlamesProps, FxMatchFlame, type FxMatchFlameProps, FxParticles, type FxParticlesProps, FxPost, type FxPostProps, type FxQualityName, type FxQualitySettings, type FxQualityTier, FxWisps, type FxWispsProps, HEAT, type MatchFlameState, PAPER_WHITE, PRESENCE, type PannerLike, ParticlePool, type ParticlePreset, type ParticlePresetName, type ParticleTarget, SATURATION, type SolverUniforms, type SoundAt, type SurfaceLocator, type Voice, createAudioContext, emit, emitHex, fireEmitterDefaults, fireFluidControls, fireFluidDefaults, fireZones, flameAnchors, flamePuff, fxQualityFor, fxQualityNames, fxQualityTiers, hexToLinear, luminance, particlePresets, solverUniforms, srgbToLinear, timesPaperWhite };
+export { Afterglow, type AfterglowOptions, type AudioLike, type BiquadFilterLike, CHAR, DamageField, type DamageFieldOptions, DamageSource, FIELD_SIZE, FIRE_GLOW, FIRE_HEAT_SCALE, FIRE_LIGHT_GAIN, FIRE_SOOT_SCALE, FIRE_ZONES, FIXED_DT, FLAME_HEIGHT, FX_BLOOM, FX_BLOOM_THRESHOLD, FX_INITIAL_TIER, FX_TIER_ORDER, type FieldStats, FireEmitter, type FireEmitterOptions, FireFluid, type FireFluidParams, FireSound, type FireSoundOptions, type FireZones, type FireZonesInput, type FlameAnchor, type FluidGrid, FxAudio, type FxAudioOptions, type FxFilm, FxFireFluid, type FxFireFluidProps, FxFireLight, type FxFireLightProps, FxFlames, type FxFlamesProps, FxMatchFlame, type FxMatchFlameProps, FxParticles, type FxParticlesProps, FxPost, type FxPostProps, type FxQualityName, type FxQualitySettings, type FxQualityTier, FxWisps, type FxWispsProps, HEAT, type MatchFlameState, PAPER_WHITE, PRESENCE, type PannerLike, ParticlePool, type ParticlePreset, type ParticlePresetName, type ParticleTarget, SATURATION, type SolverUniforms, type SoundAt, type SurfaceLocator, type Voice, createAudioContext, emit, emitHex, fireEmitterDefaults, fireFluidControls, fireFluidDefaults, fireZones, flameAnchors, flamePuff, fxQualityFor, fxQualityNames, fxQualityTiers, hexToLinear, luminance, particlePresets, solverUniforms, srgbToLinear, timesPaperWhite };

package/dist/fx.d.ts

@@ -1,5 +1,5 @@
-import { D as DamageSource } from './damageContract-DPF1YFLZ.js';
-export { a as DAMAGE_CHANNELS, b as DAMAGE_LOOK_DEFAULTS, c as DamageLook } from './damageContract-DPF1YFLZ.js';
+import { D as DamageSource } from './damageContract-nF1fgK7P.js';
+export { a as DAMAGE_CHANNELS, b as DAMAGE_LOOK_DEFAULTS, c as DamageLook } from './damageContract-nF1fgK7P.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
 import * as THREE from 'three';
@@ -400,7 +400,7 @@ declare const particlePresets: {
      * simulation, on purpose; see the fx plan.
      */
     readonly smoke: {
-        readonly life: readonly [1.8, 3.5];
+        readonly life: readonly [1.4, 2.6];
         readonly speed: readonly [0.05, 0.15];
         readonly direction: readonly [0, 1, 0];
         readonly spread: 0.3;
@@ -408,9 +408,9 @@ declare const particlePresets: {
         readonly drag: 0.9;
         readonly jitter: 0.3;
         readonly windCatch: 1;
-        readonly size: readonly [0.05, 0.35];
+        readonly size: readonly [0.05, 0.18];
         readonly color: readonly [readonly [0.147, 0.13, 0.117], readonly [0.2, 0.19, 0.18]];
-        readonly alpha: readonly [0.08, 0];
+        readonly alpha: readonly [0.07, 0];
         readonly spin: 0.4;
         readonly blend: "normal";
         readonly shape: "soft";
@@ -422,16 +422,16 @@ declare const particlePresets: {
      * burn that proves paper was there.
      */
     readonly ash: {
-        readonly life: readonly [2.5, 5];
+        readonly life: readonly [1.2, 2.6];
         readonly speed: readonly [0.14, 0.3];
         readonly direction: readonly [0, 1, 0];
         readonly spread: 0.55;
-        readonly lift: -0.22;
+        readonly lift: -0.42;
         readonly drag: 1.6;
         readonly jitter: 1.2;
         readonly windCatch: 1;
         readonly size: readonly [0.03, 0.026];
-        readonly color: readonly [readonly [0.07, 0.065, 0.06], readonly [0.12, 0.115, 0.11]];
+        readonly color: readonly [readonly [0.04, 0.037, 0.034], readonly [0.07, 0.066, 0.062]];
         readonly alpha: readonly [0.95, 0];
         readonly spin: 4;
         readonly blend: "normal";
@@ -540,19 +540,13 @@ interface FireEmitterOptions {
     };
 }
 /**
- * How much each kind leaves the front, per texel per second.
- *
- * `smoke` is 0 on purpose. There were three smoke systems running at once —
- * the fire simulator's own, these sprite puffs at 8% alpha, and the smoulder
- * wisp — and the review's note was that only one of them should exist. The
- * simulator's is the one that belongs to a burning sheet: it is the same
- * fluid the flames are made of, so it rises with them instead of beside them.
- * `FxWisps` still carries the thread after the flames are out, which is the
- * one moment the simulator has nothing left to make. The preset stays: it is
- * a parameter set, and anything may still ask the pool for smoke.
- *
- * Embers and ash are both down. Ash at 0.86 a texel was a flake for nearly
- * every one that burnt through — a dust shower. Fewer and larger is the note.
+ * How much each kind leaves the front, per texel per second — Noor's tune in
+ * the lab on 2026-09-13, which the lab starts from and `/hands` inherits.
+ *
+ * The simulator's smoke is the main smoke of a burning sheet, since it is the
+ * same fluid the flames are made of; these sprite puffs, once switched off
+ * for doubling it, are back as a light thread beside it. Ash at 0.86 a texel
+ * was a dust shower; 0.36 is a light fall of it.
  */
 declare const fireEmitterDefaults: Required<FireEmitterOptions>;
 /**
@@ -744,6 +738,15 @@ interface FxPostProps {
     locate?: SurfaceLocator;
     /** Heat haze in pixels at 1080p, overriding the tier's; 0 turns it off. */
     haze?: number;
+    /**
+     * Shallow focus on the burn, 0..1; 0 keeps everything sharp.
+     *
+     * A macro lens held close to a burning edge has a few millimetres of
+     * focus and nothing else (§K4): the rim is sharp, the rest of the sheet
+     * goes soft. It focuses on the fire itself — the burning rim is what the
+     * shot is about — so it needs `field` and `locate` like the haze does.
+     */
+    focus?: number;
 }
 /**
  * `fallback={null}`: the scene behind it is already drawn. One frame without
@@ -840,13 +843,13 @@ declare const FIRE_SOOT_SCALE = 3;
  *
  * It lives beside the threshold because the two are one setting: bloom is a
  * multiplier on whatever clears the threshold, so its right value depends
- * entirely on how much fire is authored above it. 1.55 was tuned when the
- * flames were UNDER the threshold and bloom had almost nothing to work on —
- * measured, 0.07% of the frame. Once the flames cleared it, that same 1.55
- * tinted the entire black stage olive. Swept at 0.25, 0.6 and 1.2 against the
- * peak frame; past about 0.4 the stage stops being black.
+ * entirely on how much fire is authored above it. With a core authored to
+ * over-expose, 0.55 was the most the black stage could take; the flame of
+ * {@link FIRE_ZONES} (Noor, 2026-09-13) authors none of it past the
+ * threshold, and 1.25 is her tune for it. `pnpm test:fire-budget` holds the
+ * stage black and the paper unbloomed whatever this is set to.
  */
-declare const FX_BLOOM = 0.55;
+declare const FX_BLOOM = 1.25;
 /**
  * A flame, in four zones — drawn the way the sheet's burn is (ember line, ash
  * lip, char, scorch): each part named for what it is, with its own controls.
@@ -854,11 +857,10 @@ declare const FX_BLOOM = 0.55;
  *
  *   root  the blue leading edge where fresh gas meets the air at the paper.
  *         Its light comes from excited molecules, not soot, so it is faint
- *         and blue — and it starts OFF, because blue light added over cream
- *         paper reads lavender.
- *   core  the hottest gas, where soot forms densest and glows pale. The only
- *         zone allowed to over-expose past the bloom threshold, and so the
- *         one that blooms.
+ *         and blue — and only ever a trace, because blue light added over
+ *         cream paper reads lavender.
+ *   core  the hottest gas, where soot forms densest and glows pale — the
+ *         brightest zone, and the one the bloom finds first.
  *   body  the luminous bulk: soot glowing yellow-orange as it rises.
  *   tip   where soot cools and burns off at the outer edge — orange-red,
  *         dimmer, tearing into tongues. What survives escapes as smoke.
@@ -876,12 +878,11 @@ declare const FX_BLOOM = 0.55;
  * multiples of paper white; colours are sRGB, the way a colour picker gives
  * them.
  *
- * The body is ABOVE paper white. It was once held below it, because under a
- * bright preset paper sits at the top of the tone curve and anything brighter
- * loses its colour — and a flame dimmer than the paper behind it, drawn
- * opaque, is a yellow decal on the sheet, not light. Fire photographed in a
- * bright room DOES wash out; that is the lighting's to answer (the lab shoots
- * under `noir`, as the references were), not the flame's.
+ * How bright the body is against paper white is a judgement, and it has gone
+ * both ways. Above it, a flame keeps its light in a bright room but loses its
+ * colour to the tone curve; below it, the colour holds, and a flame drawn
+ * opaque risks reading as a decal on the sheet rather than as light. The
+ * defaults sit below it (Noor, 2026-09-13), with the bloom carrying the glow.
  */
 interface FireZones {
     root: {
@@ -912,10 +913,12 @@ type FireZonesInput = {
     [Z in keyof FireZones]?: Partial<FireZones[Z]>;
 };
 /**
- * The defaults reproduce the look arrived at by measurement against
- * Flame_base.png (yellow ~30%, orange ~40%, pale ~18% of a flame's pixels),
- * now expressed zone by zone. Each colour is the linear emission the previous
- * ramp used in that band, written as the sRGB a picker would show.
+ * Noor's tune in the lab on 2026-09-13, and the source of truth for how a
+ * flame looks: the lab starts from it and `/hands` inherits it. A gentler
+ * flame than the one it replaced — every zone sits under the bloom threshold,
+ * so its glow comes from the bloom's strength ({@link FX_BLOOM}) spreading
+ * the brightest gas, not from a core authored to over-expose. The values it
+ * replaced, measured against Flame_base.png, are in the history of this file.
  */
 declare const FIRE_ZONES: FireZones;
 /** The defaults with `input` laid over them, zone by zone. */
@@ -1313,25 +1316,48 @@ declare class FireFluid {
 interface FxFireLightProps {
     field: DamageField;
     locate: SurfaceLocator;
-    /** How bright the fire is per unit of burning front. Tuned against Hero.png. */
+    /** How bright the fire is per unit of burning front. */
     gain?: number;
+    /**
+     * The brightest cluster's light casts shadows: a curled edge, a lifted
+     * plate and a hanging flap throw flickering shade across the sheet, which
+     * is much of what makes firelight read as firelight. One shadow pass a
+     * frame, so off unless asked for.
+     */
+    shadows?: boolean;
 }
 /**
  * Fire is a light source (§4.8, §7). A fire that changes nothing around it
  * looks pasted on.
  *
- * A warm point light — about 1900 K — at the middle of the burning rim,
- * raised by half a flame, as bright as the front is long and flickering on
- * the very noise the flames puff on, so light and flame agree. It reaches the
- * whole sheet: `decay` is held below the physical 2, because a sheet is a
- * small thing next to a fire and Hero.png warms it to the top edge.
- *
- * And a dimmer twin on the FAR side of the sheet, for translucency: paper is
- * thin, and a fire in front of it glows through to the back, warm and
- * diffused (§7). A second light is the whole trick — the sheet's own
- * material already lights its back face from whatever is behind it.
+ * One warm point light for each place the fire is gathered — up to
+ * {@link FIRE_CLUSTERS} of them, from {@link fireStateOf} — standing at its
+ * cluster raised by half a flame, as bright as its share of the fire and
+ * flickering on its own tongues' puff. A tall tongue on the left lights the
+ * left. It used to be one light at the middle of the whole rim, which lit the
+ * sheet the same wherever the flames actually were.
+ *
+ * Each light's colour follows how hot the paper under its tongues is: the
+ * pale peach of a fire at its height, deepening toward orange as it cools —
+ * never toward red, which on white paper is the pink the spec forbids.
+ * Together they give off what the single light did: the front's length times
+ * `gain`, shared out.
+ *
+ * And one dimmer light on the FAR side of the sheet, at the fire as a whole,
+ * for translucency: paper is thin, and a fire in front of it glows through to
+ * the back (§7). The sheet's own material lights its back face from whatever
+ * is behind it.
+ *
+ * Every light is mounted all the time and only its intensity changes, so a
+ * fire gathering into more places or fewer never makes three recompile a
+ * shader.
+ */
+declare function FxFireLight({ field, locate, gain, shadows }: FxFireLightProps): react.JSX.Element;
+/**
+ * Light per unit of front length; the front runs to ~0.045 at a burn's peak.
+ * Noor's tune, 2026-09-13 (it was 42).
  */
-declare function FxFireLight({ field, locate, gain }: FxFireLightProps): react.JSX.Element;
+declare const FIRE_LIGHT_GAIN = 26;
 
 /** What the page says about the match this frame. Written in place — never a prop change. */
 interface MatchFlameState {
@@ -1793,4 +1819,4 @@ declare class FireSound {
     private next;
 }
 
-export { Afterglow, type AfterglowOptions, type AudioLike, type BiquadFilterLike, CHAR, DamageField, type DamageFieldOptions, DamageSource, FIELD_SIZE, FIRE_GLOW, FIRE_HEAT_SCALE, FIRE_SOOT_SCALE, FIRE_ZONES, FIXED_DT, FLAME_HEIGHT, FX_BLOOM, FX_BLOOM_THRESHOLD, FX_INITIAL_TIER, FX_TIER_ORDER, type FieldStats, FireEmitter, type FireEmitterOptions, FireFluid, type FireFluidParams, FireSound, type FireSoundOptions, type FireZones, type FireZonesInput, type FlameAnchor, type FluidGrid, FxAudio, type FxAudioOptions, type FxFilm, FxFireFluid, type FxFireFluidProps, FxFireLight, type FxFireLightProps, FxFlames, type FxFlamesProps, FxMatchFlame, type FxMatchFlameProps, FxParticles, type FxParticlesProps, FxPost, type FxPostProps, type FxQualityName, type FxQualitySettings, type FxQualityTier, FxWisps, type FxWispsProps, HEAT, type MatchFlameState, PAPER_WHITE, PRESENCE, type PannerLike, ParticlePool, type ParticlePreset, type ParticlePresetName, type ParticleTarget, SATURATION, type SolverUniforms, type SoundAt, type SurfaceLocator, type Voice, createAudioContext, emit, emitHex, fireEmitterDefaults, fireFluidControls, fireFluidDefaults, fireZones, flameAnchors, flamePuff, fxQualityFor, fxQualityNames, fxQualityTiers, hexToLinear, luminance, particlePresets, solverUniforms, srgbToLinear, timesPaperWhite };
+export { Afterglow, type AfterglowOptions, type AudioLike, type BiquadFilterLike, CHAR, DamageField, type DamageFieldOptions, DamageSource, FIELD_SIZE, FIRE_GLOW, FIRE_HEAT_SCALE, FIRE_LIGHT_GAIN, FIRE_SOOT_SCALE, FIRE_ZONES, FIXED_DT, FLAME_HEIGHT, FX_BLOOM, FX_BLOOM_THRESHOLD, FX_INITIAL_TIER, FX_TIER_ORDER, type FieldStats, FireEmitter, type FireEmitterOptions, FireFluid, type FireFluidParams, FireSound, type FireSoundOptions, type FireZones, type FireZonesInput, type FlameAnchor, type FluidGrid, FxAudio, type FxAudioOptions, type FxFilm, FxFireFluid, type FxFireFluidProps, FxFireLight, type FxFireLightProps, FxFlames, type FxFlamesProps, FxMatchFlame, type FxMatchFlameProps, FxParticles, type FxParticlesProps, FxPost, type FxPostProps, type FxQualityName, type FxQualitySettings, type FxQualityTier, FxWisps, type FxWispsProps, HEAT, type MatchFlameState, PAPER_WHITE, PRESENCE, type PannerLike, ParticlePool, type ParticlePreset, type ParticlePresetName, type ParticleTarget, SATURATION, type SolverUniforms, type SoundAt, type SurfaceLocator, type Voice, createAudioContext, emit, emitHex, fireEmitterDefaults, fireFluidControls, fireFluidDefaults, fireZones, flameAnchors, flamePuff, fxQualityFor, fxQualityNames, fxQualityTiers, hexToLinear, luminance, particlePresets, solverUniforms, srgbToLinear, timesPaperWhite };