narraleaf-react 0.27.0 → 0.28.0

package/dist/game/nlcore/common/transition.d.ts

@@ -6,15 +6,17 @@ import { TextTransition } from "../elements/transition/transitions/text/textTran
 import { BlurDissolve } from "../elements/transition/transitions/image/blurDissolve";
 import { Push } from "../elements/transition/transitions/image/push";
 import { Darkness } from "../elements/transition/transitions/image/darkness";
+import { Exposure } from "../elements/transition/transitions/image/exposure";
 import { ThroughColor } from "../elements/transition/transitions/image/throughColor";
 import { Reveal } from "../elements/transition/transitions/image/reveal";
 import { Mask } from "../elements/transition/transitions/image/mask";
-export { Transition, ImageTransition, TextTransition, Dissolve, FadeIn, BlurDissolve, Push, Darkness, ThroughColor, Reveal, Mask, };
+export { Transition, ImageTransition, TextTransition, Dissolve, FadeIn, BlurDissolve, Push, Darkness, Exposure, ThroughColor, Reveal, Mask, };
 export type { DissolveOptions } from "../elements/transition/transitions/image/dissolve";
 export type { FadeInOptions } from "../elements/transition/transitions/image/fadeIn";
 export type { BlurDissolveOptions } from "../elements/transition/transitions/image/blurDissolve";
 export type { PushOptions } from "../elements/transition/transitions/image/push";
 export type { DarknessOptions } from "../elements/transition/transitions/image/darkness";
+export type { ExposureOptions } from "../elements/transition/transitions/image/exposure";
 export type { ThroughColorOptions, ThroughColorUncover, } from "../elements/transition/transitions/image/throughColor";
 export type { RevealOptions } from "../elements/transition/transitions/image/reveal";
 export type { MaskPattern, WipePatternOptions, BarnDoorPatternOptions, IrisPatternOptions, ClockPatternOptions, FanPatternOptions, BlindsPatternOptions, DotsPatternOptions, } from "../elements/transition/transitions/image/mask";

package/dist/game/nlcore/elements/transition/transitions/image/exposure.d.ts

@@ -0,0 +1,60 @@
+import { TransitionAnimationType, TransitionTask } from "../../../../elements/transition/type";
+import { TransformDefinitions } from "../../../../elements/transform/type";
+import { ImageTransition } from "../../../../elements/transition/transitions/image/imageTransition";
+type AnimationType = [TransitionAnimationType.Number];
+export type ExposureOptions = {
+    /** Duration in milliseconds. */
+    duration: number;
+    /**
+     * Peak exposure in stops, driving the frame to a gain of `2 ** ev`. Every channel
+     * clips at white on the way, so a channel already near white blows out almost at
+     * once while a dark one holds on nearly to the end — the difference between this
+     * and a white plate. @default 4.6
+     */
+    ev?: number;
+    /**
+     * Shadow lift (0–1) mixed in ahead of the gain, ramped in with it.
+     *
+     * Gain alone never whitens pure black, so without a lift a night frame ends the
+     * burn as a black silhouette on white. This is the flare a real lens adds; 0.03–0.06
+     * carries the shadows up without touching the frame at rest. @default 0.04
+     */
+    lift?: number;
+    /** Fraction (0–1) of the duration spent fully blown out. @default 0 */
+    hold?: number;
+    easing?: TransformDefinitions.EasingDefinition;
+};
+/**
+ * An exposure transition: the outgoing frame is driven up in stops until it burns out
+ * to white, the images swap inside that white window, and the incoming frame comes
+ * back down to a normal exposure.
+ *
+ * Unlike a white plate faded over the frame — which moves every colour toward white at
+ * one rate — the whitening here is per-channel clipping, so highlights go first,
+ * saturated colours pass through a hue shift as their leading channel clips, and the
+ * shadows are the last thing left. {@link ThroughColor} with a white colour is the
+ * plate version; this is the photographic one.
+ *
+ * Emitted as a plain CSS `filter` chain, so it drives an `<img>` and a detached scene
+ * root alike. `invert brightness invert` is a lift with no clipping of its own
+ * (`c → lift + (1 - lift)·c`); the trailing `brightness` is the gain that does clip.
+ */
+export declare class Exposure extends ImageTransition<AnimationType> {
+    private duration;
+    private ev;
+    private lift;
+    private hold;
+    private easing?;
+    constructor(options: ExposureOptions);
+    /**
+     * Style for a frame at a given burn amount (0 = untouched, 1 = fully blown out).
+     *
+     * The lift is scaled by the burn rather than applied flat, so a resting frame is
+     * bit-for-bit the source image and writes no filter at all — a filter left on a
+     * settled scene root would give it a compositing layer for nothing.
+     */
+    private burnStyle;
+    createTask(): TransitionTask<HTMLImageElement, AnimationType>;
+    copy(): Exposure;
+}
+export {};