narraleaf-react 0.27.0 → 0.29.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 {};

package/dist/game/player/lib/verticalText.d.ts

@@ -5,9 +5,9 @@
  * top to bottom, and the next column starts to the left. Two things in that layout are not free,
  * and both are about text that is not Japanese:
  *
- * - A Latin word must stay whole. `word-break: break-all`, which the horizontal renderer wants so
- *   that CJK wraps anywhere, will otherwise split "Prologue" across two columns, one glyph at a
- *   time, sideways.
+ * - A Latin word must stay whole. `word-break: break-all` would split "Prologue" across two
+ *   columns, one glyph at a time, sideways. Neither writing mode needs it: `normal` already breaks
+ *   between CJK characters, which is the only place either one has to break.
  * - A short run - a two-digit number, an initialism - reads better set upright across the column
  *   than laid on its side. That is tate-chu-yoko (縦中横), and CSS spells it
  *   `text-combine-upright: all` on a wrapper around exactly that run.
@@ -43,12 +43,30 @@ export type VerticalTextSegment = {
  */
 export declare function segmentVerticalText(text: string, maxLength: number): VerticalTextSegment[];
 /**
- * How a word's own box breaks.
+ * How a word's own box breaks. The two writing modes want the same thing, which is why this takes
+ * no argument: a column of Japanese breaks by the same rules a line of it does.
  *
- * Vertical text keeps `word-break: normal`, which still breaks between CJK characters - that rule
- * has never needed `break-all` - while leaving Latin words whole.
+ * `word-break: normal` already breaks between CJK characters, which is the only thing `break-all`
+ * was ever here for, and it does not take a Latin word apart to do it. `break-all` means what it
+ * says: it cut "NarraLeaf" and "English" wherever the line ran out.
+ *
+ * `line-break: strict` asks for the rest of the kinsoku set. The prohibitions everyone knows - no
+ * line beginning with 、 。 」 ？ ！, none ending with 「 （ - are applied by the browser whatever
+ * `word-break` says, and were never the thing at fault. `strict` adds what a printed book is set
+ * to, holding back the small kana and the prolonged sound mark: over 301 container sizes, っ opened
+ * a line in 20 of them set horizontally and a column in 18 set vertically, and none at all under
+ * `strict`. It leaves the tate-chu-yoko runs below alone - a combined `12` measures the same
+ * either way.
+ *
+ * Worth knowing before deleting it: `strict` does nothing unless the document declares a language.
+ * Any `lang` will do - `en` is enough, and the shipped shell has one - but with no `lang` above the
+ * text the strict rules are not applied and this reads as dead weight.
+ *
+ * `overflow-wrap: break-word` is the last resort, for a run that fits nowhere - a URL, a long
+ * unspaced word in a narrow box - and it applies only after the line has been given its chance to
+ * break somewhere legal.
  */
-export declare function wordBreakStyleFor(vertical: boolean): React.CSSProperties;
+export declare function wordBreakStyleFor(): React.CSSProperties;
 /**
  * Renders a word's text with its short runs set upright.
  *