@datamoc/mw_games 0.7.4 → 0.7.7

package/dist/two-d/ui/Dropdown.d.ts

@@ -0,0 +1,72 @@
+import { Signal } from '../../core/Signal.ts';
+export interface DropdownOption {
+    /** the value the game reads back; the label when omitted */
+    id?: string;
+    label: string;
+    disabled?: boolean;
+}
+export interface DropdownOptions {
+    options: readonly DropdownOption[];
+    /** the entry selected from the start; the first enabled one when omitted */
+    selectedIndex?: number;
+    disabled?: boolean;
+}
+/**
+ * A closed button that opens a list of options - the "option button" a settings row or a
+ * scenario picker drops down.
+ *
+ * Renderer-free, like `TabbedList`: the state is the whole widget's mind, and a game draws the
+ * button's label and the open list wherever its own layout wants them. The rule worth naming is
+ * that opening restores the highlight to the current selection, so the first arrow key does not
+ * jump from wherever the highlight was last, and a disabled option is skipped by the highlight
+ * exactly as `ListView` skips one.
+ *
+ * @example
+ * ```ts
+ * import { Dropdown } from '@datamoc/mw_games/two-d/ui';
+ *
+ * const difficulty = new Dropdown({
+ *   options: [{ id: 'easy', label: 'Easy' }, { id: 'normal', label: 'Normal' }],
+ * });
+ * difficulty.open();
+ * difficulty.move(1);
+ * difficulty.confirm();
+ * console.log(difficulty.selected?.id); // 'normal'
+ * ```
+ */
+export declare class Dropdown {
+    readonly onChange: Signal<{
+        option: DropdownOption;
+        index: number;
+    }>;
+    private options_;
+    private current;
+    private highlight_;
+    private open_;
+    private disabled_;
+    constructor(options: DropdownOptions);
+    get options(): readonly DropdownOption[];
+    get selectedIndex(): number;
+    /** the selected entry; the first enabled one when nothing was selected, `null` when empty */
+    get selected(): DropdownOption | null;
+    get isOpen(): boolean;
+    get disabled(): boolean;
+    /** the row an open list has highlighted, which is what a confirm would take */
+    get highlight(): number;
+    setDisabled(disabled: boolean): void;
+    setOptions(options: readonly DropdownOption[]): void;
+    /** opens the list, restoring the highlight to the current selection */
+    open(): void;
+    close(): void;
+    toggleOpen(): void;
+    /** moves the highlight by `delta` rows, skipping disabled entries and wrapping at both ends */
+    move(delta: number): void;
+    /** opens the list and highlights `index`, if it is enabled */
+    setHighlight(index: number): void;
+    /** takes the highlighted row: closes, selects it, and fires `onChange` when it moved */
+    confirm(): boolean;
+    /** closes the list without taking anything, the escape key's own action */
+    cancel(): void;
+    private firstEnabled;
+}
+//# sourceMappingURL=Dropdown.d.ts.map

package/dist/two-d/ui/Dropdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dropdown.d.ts","sourceRoot":"","sources":["../../../src/two-d/ui/Dropdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC9B,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,QAAQ;IACpB,QAAQ,CAAC,QAAQ;gBAAwB,cAAc;eAAS,MAAM;OAAM;IAE5E,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAU;IAE3B,YAAY,OAAO,EAAE,eAAe,EAMnC;IAED,IAAI,OAAO,IAAI,SAAS,cAAc,EAAE,CAEvC;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,6FAA6F;IAC7F,IAAI,QAAQ,IAAI,cAAc,GAAG,IAAI,CAEpC;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,+EAA+E;IAC/E,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAGnC;IAED,UAAU,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,CAKnD;IAED,uEAAuE;IACvE,IAAI,IAAI,IAAI,CAIX;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,UAAU,IAAI,IAAI,CAGjB;IAED,+FAA+F;IAC/F,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAWxB;IAED,8DAA8D;IAC9D,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGhC;IAED,wFAAwF;IACxF,OAAO,IAAI,OAAO,CAUjB;IAED,2EAA2E;IAC3E,MAAM,IAAI,IAAI,CAGb;IAED,OAAO,CAAC,YAAY;CAIpB"}

package/dist/two-d/ui/Dropdown.js

@@ -0,0 +1,126 @@
+import { Signal } from '../../core/Signal.js';
+/**
+ * A closed button that opens a list of options - the "option button" a settings row or a
+ * scenario picker drops down.
+ *
+ * Renderer-free, like `TabbedList`: the state is the whole widget's mind, and a game draws the
+ * button's label and the open list wherever its own layout wants them. The rule worth naming is
+ * that opening restores the highlight to the current selection, so the first arrow key does not
+ * jump from wherever the highlight was last, and a disabled option is skipped by the highlight
+ * exactly as `ListView` skips one.
+ *
+ * @example
+ * ```ts
+ * import { Dropdown } from '@datamoc/mw_games/two-d/ui';
+ *
+ * const difficulty = new Dropdown({
+ *   options: [{ id: 'easy', label: 'Easy' }, { id: 'normal', label: 'Normal' }],
+ * });
+ * difficulty.open();
+ * difficulty.move(1);
+ * difficulty.confirm();
+ * console.log(difficulty.selected?.id); // 'normal'
+ * ```
+ */
+export class Dropdown {
+    constructor(options) {
+        this.onChange = new Signal();
+        this.open_ = false;
+        this.options_ = [...options.options];
+        this.disabled_ = options.disabled ?? false;
+        const requested = options.selectedIndex ?? this.firstEnabled();
+        this.current = this.options_[requested]?.disabled ? this.firstEnabled() : requested;
+        this.highlight_ = this.current;
+    }
+    get options() {
+        return this.options_;
+    }
+    get selectedIndex() {
+        return this.current;
+    }
+    /** the selected entry; the first enabled one when nothing was selected, `null` when empty */
+    get selected() {
+        return this.options_[this.current] ?? null;
+    }
+    get isOpen() {
+        return this.open_;
+    }
+    get disabled() {
+        return this.disabled_;
+    }
+    /** the row an open list has highlighted, which is what a confirm would take */
+    get highlight() {
+        return this.highlight_;
+    }
+    setDisabled(disabled) {
+        this.disabled_ = disabled;
+        if (disabled)
+            this.open_ = false;
+    }
+    setOptions(options) {
+        this.options_ = [...options];
+        this.current = this.firstEnabled();
+        this.highlight_ = this.current;
+        this.open_ = false;
+    }
+    /** opens the list, restoring the highlight to the current selection */
+    open() {
+        if (this.disabled_ || this.open_)
+            return;
+        this.open_ = true;
+        this.highlight_ = this.current;
+    }
+    close() {
+        this.open_ = false;
+    }
+    toggleOpen() {
+        if (this.open_)
+            this.close();
+        else
+            this.open();
+    }
+    /** moves the highlight by `delta` rows, skipping disabled entries and wrapping at both ends */
+    move(delta) {
+        if (!this.open_ || this.options_.length === 0)
+            return;
+        const count = this.options_.length;
+        let index = this.highlight_;
+        for (let tried = 0; tried < count; tried++) {
+            index = (((index + delta) % count) + count) % count;
+            if (!this.options_[index].disabled) {
+                this.highlight_ = index;
+                return;
+            }
+        }
+    }
+    /** opens the list and highlights `index`, if it is enabled */
+    setHighlight(index) {
+        if (index < 0 || index >= this.options_.length || this.options_[index].disabled)
+            return;
+        this.highlight_ = index;
+    }
+    /** takes the highlighted row: closes, selects it, and fires `onChange` when it moved */
+    confirm() {
+        if (!this.open_)
+            return false;
+        const option = this.options_[this.highlight_];
+        if (!option || option.disabled)
+            return false;
+        this.open_ = false;
+        if (this.highlight_ !== this.current) {
+            this.current = this.highlight_;
+            this.onChange.dispatch({ option, index: this.current });
+        }
+        return true;
+    }
+    /** closes the list without taking anything, the escape key's own action */
+    cancel() {
+        this.open_ = false;
+        this.highlight_ = this.current;
+    }
+    firstEnabled() {
+        const index = this.options_.findIndex((option) => !option.disabled);
+        return index === -1 ? 0 : index;
+    }
+}
+//# sourceMappingURL=Dropdown.js.map

package/dist/two-d/ui/Dropdown.js.map

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

package/dist/two-d/ui/FloatingText.d.ts

@@ -39,6 +39,31 @@ export declare function floatingTextAlpha(t: number, hold: number): number;
  * ```
  */
 export declare function floatingTextRise(t: number, rise: number, reduce?: boolean): number;
+/**
+ * The age a pop-up should report, given the age it has, its lifetime, and the age it is forced to
+ * be at least.
+ *
+ * Java's rule as arithmetic. Java caps what is *left*,
+ * `above.timeLeft = Math.min(above.timeLeft, LIFESPAN - numBelow / 5f)`, and a cap on what is left
+ * is a floor under the age. A floor and not a subtraction, on purpose: a line that has already
+ * lived longer than the floor keeps the age it has, where subtracting would shorten it a second
+ * time and cut a nearly-finished pop-up dead. A burst of numbers still cannot become a column that
+ * outlives the fight, which is what the rule is there for. Clamped to the lifetime as well, so a
+ * floor past the end finishes the pop-up on its next update instead of jumping through the rest of
+ * its rise.
+ *
+ * Pulled out of the class for the same reason `floatingTextAlpha` is: `FloatingText` needs a DOM
+ * to build, and a rule does not need one to be checked.
+ *
+ * @example
+ * ```ts
+ * import { floatingTextAgeAtLeast } from '@datamoc/mw_games/two-d/ui';
+ *
+ * console.log(floatingTextAgeAtLeast(0, 1, 0.2)); // 0.2, a fresh line is pushed forward
+ * console.log(floatingTextAgeAtLeast(0.5, 1, 0.2)); // 0.5, an older line keeps the age it has
+ * ```
+ */
+export declare function floatingTextAgeAtLeast(elapsed: number, duration: number, atLeast: number): number;
 /**
  * A damage number or a "+1 gold": text that rises and fades over its own lifetime, unlike
  * `Label`'s job of a static, positioned string. This is animation over a label, timed rather
@@ -67,17 +92,31 @@ export declare class FloatingText extends Container {
     private readonly rise;
     private readonly hold;
     /**
-     * The label's own layer: the rise moves this rather than the container itself, so
-     * `position` stays exactly where the caller put it. Writing `this.y` in `update` instead
-     * would overwrite the world point the pop-up is meant to sit over on its first frame.
+     * The label's own layer, and the layer the rise moves. `position` therefore stays exactly where
+     * the caller put it, whoever moved it last: writing `this.y` in `update` instead would overwrite
+     * the world point the pop-up sits over, and would silently undo a lift `FloatingTextStack`
+     * applies to a line that has already been on screen for a frame. That is not hypothetical, it is
+     * exactly how the first version of the stack's lift was lost.
      */
     private readonly rising;
     private elapsed;
     private done;
-    private baseY;
     constructor(options: FloatingTextOptions);
     /** true once the animation has finished and this container has removed and destroyed itself */
     get finished(): boolean;
+    /**
+     * How far the animation has lifted the text above where it was placed, in pixels: 0 at the
+     * start, negative as it rises, and 0 again under reduced motion. The drawn position is
+     * `y + riseOffset`, while `y` itself never moves, which is what lets a caller (a stack, a game
+     * following a moving creature) place a pop-up that is already animating.
+     */
+    get riseOffset(): number;
+    /**
+     * Ages the pop-up to at least `seconds` - what a stack does to the lines it lifts out of the
+     * way. `floatingTextAgeAtLeast` is that arithmetic, and says why it is a floor under the age
+     * rather than a subtraction from what is left.
+     */
+    ageAtLeast(seconds: number): void;
     /** advances the rise/fade; once complete, removes itself from its parent and destroys itself */
     update(dt: number): void;
 }

package/dist/two-d/ui/FloatingText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FloatingText.d.ts","sourceRoot":"","sources":["../../../src/two-d/ui/FloatingText.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIpC,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,MAAM,CAKhF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,YAAa,SAAQ,SAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAE9B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAE1C,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,KAAK,CAAqB;IAElC,YAAY,OAAO,EAAE,mBAAmB,EAWvC;IAED,+FAA+F;IAC/F,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,gGAAgG;IAChG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAgBvB;CACD"}
+{"version":3,"file":"FloatingText.d.ts","sourceRoot":"","sources":["../../../src/two-d/ui/FloatingText.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIpC,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,MAAM,CAKhF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGjG;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,YAAa,SAAQ,SAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAE9B;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAE1C,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,IAAI,CAAS;IAErB,YAAY,OAAO,EAAE,mBAAmB,EAWvC;IAED,+FAA+F;IAC/F,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;OAKG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhC;IAED,gGAAgG;IAChG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAevB;CACD"}

package/dist/two-d/ui/FloatingText.js

@@ -38,6 +38,35 @@ export function floatingTextRise(t, rise, reduce = false) {
         return 0;
     return -rise * t;
 }
+/**
+ * The age a pop-up should report, given the age it has, its lifetime, and the age it is forced to
+ * be at least.
+ *
+ * Java's rule as arithmetic. Java caps what is *left*,
+ * `above.timeLeft = Math.min(above.timeLeft, LIFESPAN - numBelow / 5f)`, and a cap on what is left
+ * is a floor under the age. A floor and not a subtraction, on purpose: a line that has already
+ * lived longer than the floor keeps the age it has, where subtracting would shorten it a second
+ * time and cut a nearly-finished pop-up dead. A burst of numbers still cannot become a column that
+ * outlives the fight, which is what the rule is there for. Clamped to the lifetime as well, so a
+ * floor past the end finishes the pop-up on its next update instead of jumping through the rest of
+ * its rise.
+ *
+ * Pulled out of the class for the same reason `floatingTextAlpha` is: `FloatingText` needs a DOM
+ * to build, and a rule does not need one to be checked.
+ *
+ * @example
+ * ```ts
+ * import { floatingTextAgeAtLeast } from '@datamoc/mw_games/two-d/ui';
+ *
+ * console.log(floatingTextAgeAtLeast(0, 1, 0.2)); // 0.2, a fresh line is pushed forward
+ * console.log(floatingTextAgeAtLeast(0.5, 1, 0.2)); // 0.5, an older line keeps the age it has
+ * ```
+ */
+export function floatingTextAgeAtLeast(elapsed, duration, atLeast) {
+    if (atLeast <= 0)
+        return elapsed;
+    return Math.max(elapsed, Math.min(atLeast, duration));
+}
 /**
  * A damage number or a "+1 gold": text that rises and fades over its own lifetime, unlike
  * `Label`'s job of a static, positioned string. This is animation over a label, timed rather
@@ -65,9 +94,11 @@ export class FloatingText extends Container {
     constructor(options) {
         super();
         /**
-         * The label's own layer: the rise moves this rather than the container itself, so
-         * `position` stays exactly where the caller put it. Writing `this.y` in `update` instead
-         * would overwrite the world point the pop-up is meant to sit over on its first frame.
+         * The label's own layer, and the layer the rise moves. `position` therefore stays exactly where
+         * the caller put it, whoever moved it last: writing `this.y` in `update` instead would overwrite
+         * the world point the pop-up sits over, and would silently undo a lift `FloatingTextStack`
+         * applies to a line that has already been on screen for a frame. That is not hypothetical, it is
+         * exactly how the first version of the stack's lift was lost.
          */
         this.rising = new Container();
         this.elapsed = 0;
@@ -84,6 +115,23 @@ export class FloatingText extends Container {
     get finished() {
         return this.done;
     }
+    /**
+     * How far the animation has lifted the text above where it was placed, in pixels: 0 at the
+     * start, negative as it rises, and 0 again under reduced motion. The drawn position is
+     * `y + riseOffset`, while `y` itself never moves, which is what lets a caller (a stack, a game
+     * following a moving creature) place a pop-up that is already animating.
+     */
+    get riseOffset() {
+        return this.rising.y;
+    }
+    /**
+     * Ages the pop-up to at least `seconds` - what a stack does to the lines it lifts out of the
+     * way. `floatingTextAgeAtLeast` is that arithmetic, and says why it is a floor under the age
+     * rather than a subtraction from what is left.
+     */
+    ageAtLeast(seconds) {
+        this.elapsed = floatingTextAgeAtLeast(this.elapsed, this.duration, seconds);
+    }
     /** advances the rise/fade; once complete, removes itself from its parent and destroys itself */
     update(dt) {
         if (this.done)
@@ -92,8 +140,7 @@ export class FloatingText extends Container {
         const t = this.duration > 0 ? this.elapsed / this.duration : 1;
         //the rise is peripheral movement beside whatever the player is reading; reduced
         //motion keeps the fade and drops the travel, so the number still appears and goes
-        this.baseY ??= this.y;
-        this.y = this.baseY + floatingTextRise(t, this.rise, reducedMotion());
+        this.rising.y = floatingTextRise(t, this.rise, reducedMotion());
         this.alpha = floatingTextAlpha(t, this.hold);
         if (t >= 1) {
             this.done = true;

package/dist/two-d/ui/FloatingText.js.map

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

package/dist/two-d/ui/FloatingTextStack.d.ts

@@ -1,43 +1,109 @@
 import { Container } from 'pixi.js';
 import { FloatingText, type FloatingTextOptions } from './FloatingText.ts';
 /**
- * One pop-up the stack knows about: where it was asked to appear, how tall it is, and what it
- * stacks against.
+ * One pop-up the stack knows about: where it sits right now, how tall it is, and what it stacks
+ * against.
  */
 export interface FloatingTextStackEntry {
     /** pop-ups sharing a key are stacked apart; leave it unset for one that stands alone */
     key?: string | number;
-    /** the world point, as asked for - not wherever stacking moved the pop-up to */
+    /**
+     * Where the pop-up is placed, at its centre - stacking moves the older ones, never a newcomer.
+     *
+     * This is the box the rise happens *inside* (`FloatingText` rises its own inner layer), so the
+     * arithmetic below compares where lines are put rather than where one frame caught them: a burst
+     * stacks the same way whatever the frame rate, where Java compares live positions.
+     */
     x: number;
     y: number;
     /** the pop-up's own height, measured rather than assumed */
     height: number;
 }
+/** The vertical gap left between two stacked lines - Java's `FloatingText.push()` uses `4`. */
+export declare const FLOATING_TEXT_STACK_GAP = 4;
 /**
- * How far a newcomer must move up to clear every live pop-up it shares a key *and* an origin
- * with - the classic "three numbers on one creature in one turn" case.
+ * The age a lifted line is forced to, in seconds, from how many lines sit below it - Java's
+ * `LIFESPAN - numBelow / 5f` read as a floor under the age rather than a cap on what is left, the
+ * same rule `FloatingText.ageAtLeast` applies. One second per five lines, a fifth of a second each,
+ * so a burst of numbers cannot become a column that outlives the fight that produced it.
+ */
+export declare function floatingTextStackLifePenalty(linesBelow: number): number;
+/**
+ * The `y` `older` must sit at to clear `below`, or `older.y` when it already does.
+ *
+ * The direction is the point, and it is why this returns a *position* rather than an offset to add:
+ * Java's `FloatingText.push()` anchors the newcomer on the target and lifts the lines already there
+ * (`above.setPos(above.left(), below.top() - above.height() - 4)`), the opposite of moving the
+ * newcomer out of the way. Pop-ups rise, so the older ones belong above the newer ones - an offset
+ * the caller adds is direction-ambiguous, a position the caller assigns is not.
+ *
+ * Both boxes are anchored at their centre, so a line's top is `y - height / 2`; a line is clear when
+ * its bottom plus the gap no longer reaches the other's top.
  *
  * Exported and pure on purpose: the stacking rule is arithmetic, and this way it is checked as
  * arithmetic rather than through a rendered label (`Label` needs a DOM to measure text).
- * Offsets accumulate by measured height, so a taller line clears the one under it rather than
- * overlapping it by a fixed guess.
+ */
+export declare function floatingTextStackLift(older: FloatingTextStackEntry, below: FloatingTextStackEntry, gap?: number): number;
+/** One line a newcomer pushes out of the way, and what that costs it. */
+export interface FloatingTextStackMove {
+    /** index into the `live` entries the policy was handed */
+    readonly index: number;
+    /** where the line ends up: the position to give it, not an offset to add */
+    readonly y: number;
+    /** the age the line is forced to, in seconds, from `floatingTextStackLifePenalty` */
+    readonly ageAtLeast: number;
+}
+/**
+ * The whole stacking policy as arithmetic: which of `live` (oldest first) share the newcomer's key,
+ * where each of them ends up, and what age each is forced to.
+ *
+ * Newest first, stopping at the first line already clear of the one below it: a stack is ordered,
+ * an older line sits above a newer one, so a line that needs no move means nothing above it does
+ * either. That is Java's `break`, and the reason the walk runs backwards over `live`.
+ *
+ * Pure and exported for the same reason `floatingTextStackLift` is: applying a plan needs a
+ * `FloatingText`, which is a `Label`, which needs a DOM. The decision is therefore checked as
+ * arithmetic and the class is left with the assignments. `push` inlined this loop once, and the
+ * loop is where the direction, the order and the life floor were all wrong at the same time.
  *
  * @example
  * ```ts
- * import { floatingTextStackOffset } from '@datamoc/mw_games/two-d/ui';
- * console.log(floatingTextStackOffset([{ key: 'hero', x: 1, y: 2, height: 10 }], { key: 'hero', x: 1, y: 2, height: 8 })); // 11
+ * import {
+ *   FLOATING_TEXT_STACK_GAP,
+ *   floatingTextStackLift,
+ *   floatingTextStackLifePenalty,
+ *   floatingTextStackMoves,
+ * } from '@datamoc/mw_games/two-d/ui';
+ *
+ * const older = { key: 'hero', x: 0, y: 0, height: 10 };
+ * const newcomer = { key: 'hero', x: 0, y: 0, height: 8 };
+ *
+ * console.log(FLOATING_TEXT_STACK_GAP); // 4, the gap Java's push leaves
+ * console.log(floatingTextStackLift(older, newcomer)); // -13, where the older line must sit
+ * console.log(floatingTextStackLifePenalty(1)); // 0.2, the age a first lifted line is forced to
+ * console.log(floatingTextStackMoves([older], newcomer)); // [{ index: 0, y: -13, ageAtLeast: 0.2 }]
  * ```
  */
-export declare function floatingTextStackOffset(live: readonly FloatingTextStackEntry[], incoming: FloatingTextStackEntry): number;
+export declare function floatingTextStackMoves(live: readonly FloatingTextStackEntry[], incoming: FloatingTextStackEntry, gap?: number): FloatingTextStackMove[];
 export interface FloatingTextPush extends FloatingTextOptions {
     /** where the pop-up belongs, in the stack's own coordinate space */
     x: number;
     y: number;
     /**
-     * Pop-ups pushed with the same key and the same origin stack upward instead of
-     * overprinting. A pop-up with no key always stands alone.
+     * Pop-ups pushed with the same key stack upward instead of overprinting. A pop-up with no key
+     * always stands alone.
+     *
+     * A key is the target's own identity, which is what Java's `stacks.get(key)` is keyed on: a
+     * caller reusing one key for two different targets sees their lines stacked together.
      */
     key?: string | number;
+    /**
+     * Uniform scale for the pop-up, applied *before* it is measured. Pass it here rather than
+     * scaling the returned pop-up: a `FloatingText`'s `height` includes its own scale, so a scale
+     * applied after the push is measured wrong and the lines stack by a size they are not drawn at
+     * (a port rasterising at 21px and drawing at 7 spaced one stack three times too far apart).
+     */
+    scale?: number;
 }
 /**
  * Owns the pop-ups a game spawns over world points: one `push` per number, one `update(dt)` to
@@ -65,7 +131,14 @@ export interface FloatingTextPush extends FloatingTextOptions {
  */
 export declare class FloatingTextStack extends Container {
     private readonly live;
-    /** spawns a pop-up at `options.x`/`options.y`, stacked clear of anything it shares a key with */
+    /**
+     * Spawns a pop-up at `options.x`/`options.y`, lifting the lines already there out of its way.
+     *
+     * The newcomer stays exactly where it was asked to appear; anything sharing its key that it
+     * would overlap moves up, newest first, each one measured against the line below it and each
+     * nudge costing it a little life - Java's order, so a stack grows upward and self-limits. The
+     * decision is `floatingTextStackMoves`; this method only assigns what that plan says.
+     */
     push(options: FloatingTextPush): FloatingText;
     /** drives every live pop-up, then forgets the ones that have finished and removed themselves */
     update(dt: number): void;

package/dist/two-d/ui/FloatingTextStack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FloatingTextStack.d.ts","sourceRoot":"","sources":["../../../src/two-d/ui/FloatingTextStack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACtC,wFAAwF;IACxF,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtB,gFAAgF;IAChF,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IAEV,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,SAAS,sBAAsB,EAAE,EACvC,QAAQ,EAAE,sBAAsB,GAC9B,MAAM,CAUR;AAED,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC5D,oEAAoE;IACpE,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IAEV;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqE;IAE1F,iGAAiG;IACjG,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,CAsB5C;IAED,gGAAgG;IAChG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAKvB;IAED,uCAAuC;IACvC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,4DAA4D;IAC5D,KAAK,IAAI,IAAI,CAMZ;CACD"}
+{"version":3,"file":"FloatingTextStack.d.ts","sourceRoot":"","sources":["../../../src/two-d/ui/FloatingTextStack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACtC,wFAAwF;IACxF,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtB;;;;;;OAMG;IACH,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IAEV,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;CACf;AAED,+FAA+F;AAC/F,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,sBAAsB,EAC7B,KAAK,EAAE,sBAAsB,EAC7B,GAAG,GAAE,MAAgC,GACnC,MAAM,CAIR;AAED,yEAAyE;AACzE,MAAM,WAAW,qBAAqB;IACrC,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,4EAA4E;IAC5E,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAEnB,qFAAqF;IACrF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,SAAS,sBAAsB,EAAE,EACvC,QAAQ,EAAE,sBAAsB,EAChC,GAAG,GAAE,MAAgC,GACnC,qBAAqB,EAAE,CAkBzB;AAED,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC5D,oEAAoE;IACpE,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IAEV;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqE;IAE1F;;;;;;;OAOG;IACH,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,CA2B5C;IAED,gGAAgG;IAChG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAKvB;IAED,uCAAuC;IACvC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,4DAA4D;IAC5D,KAAK,IAAI,IAAI,CAMZ;CACD"}