melonjs 20.8.0 → 20.9.0

package/build/renderable/trail3d.d.ts

@@ -0,0 +1,174 @@
+/**
+ * A fading, tapering ribbon that recedes properly into a 3D scene.
+ *
+ * The 3D sibling of {@link Trail}, and a separate class for the same reason
+ * {@link Sprite3d} is separate from {@link Sprite}: the two draw through
+ * different tiers. A `Trail` emits its ribbon as 2D paths, which carry one
+ * depth for the whole renderable and a width measured in the screen plane, so
+ * it cannot narrow along its own length or lie on a surface. This one builds
+ * a real camera-facing strip and hands it to the mesh pipeline.
+ *
+ * It is a {@link Mesh}, so everything a mesh can do it can do: a post effect
+ * reaches it, `tint` multiplies it, it sorts into the transparent pass, and
+ * fog applies. It is also **cheaper to draw than a 2D trail** — one indexed
+ * draw call rather than one filled path per segment.
+ *
+ * Needs a {@link Camera3d}. Under a 2D camera it draws nothing and says so
+ * once, because the alternative is geometry projected twice.
+ * @augments Mesh
+ * @category Game Objects
+ * @example
+ * // an exhaust streak behind a craft
+ * const exhaust = new Trail3d(0, 0, {
+ *     target: ship,
+ *     width: 6,
+ *     lifetime: 260,
+ *     gradient: ["#eaffff", "#2ea8ff", "#2ea8ff00"],
+ * });
+ * exhaust.blendMode = "additive";
+ * app.world.addChild(exhaust);
+ * @example
+ * // a tyre mark lying in the ground plane: not camera-facing, so it keeps
+ * // the orientation it is given
+ * const skid = new Trail3d(0, 0, {
+ *     target: car,
+ *     width: 12,
+ *     billboard: false,
+ *     ribbonNormal: [0, -1, 0],   // world up
+ *     color: "#1a1a1a",
+ * });
+ * @example
+ * // manual mode, for a path the game computes itself
+ * const arc = new Trail3d(0, 0, { width: 4, lifetime: 400 });
+ * app.world.addChild(arc);
+ * // each frame while the spell travels
+ * arc.addPoint(bolt.pos.x, bolt.pos.y, bolt.pos.z);
+ * @see {@link Trail} for the 2D one
+ */
+export default class Trail3d extends Mesh {
+    /**
+     * @param {number} x - the ribbon's initial anchor, world units. Only seeds
+     * the cull bounds: once there are points, the anchor follows them.
+     * @param {number} y - as `x`
+     * @param {object} [settings] - trail options
+     * @param {Renderable|Vector3d} [settings.target] - auto-follow target
+     * @param {number} [settings.length=20] - max number of points. **Fixed at
+     * construction**: the geometry is sized once, so this cannot grow later,
+     * and assigning {@link Trail3d#maxPoints} throws. A fractional value is
+     * truncated.
+     * @param {number} [settings.lifetime=500] - point lifetime in ms
+     * @param {number} [settings.minDistance=4] - min world distance between samples
+     * @param {number} [settings.width=10] - max ribbon width in world units
+     * @param {number[]} [settings.widthCurve=[1, 0]] - width multiplier curve (0=head, 1=tail)
+     * @param {Color|string} [settings.color="#ffffff"] - single colour, faded out along the ribbon. Ignored if `gradient` is set.
+     * @param {(Color|string|{pos: number, color: Color|string})[]} [settings.gradient] - colour gradient. Overrides `color`.
+     * @param {boolean|string} [settings.billboard="spherical"] - `false` (use `ribbonNormal`), `true` / `"cylindrical"` (faces the camera but stays upright), or `"spherical"` (faces the camera on all axes)
+     * @param {Vector3d|number[]} [settings.ribbonNormal] - the facing used when `billboard` is `false`; defaults to world up
+     * @param {number} [settings.opacity=1.0] - opacity (0.0–1.0)
+     * @param {string} [settings.blendMode="normal"] - blend mode
+     * @param {boolean} [settings.depthTest=true] - whether the ribbon is depth tested
+     * @throws {Error} when `length` is not a finite number. Silence there is
+     * worse than it sounds: `NaN` sizes every buffer to zero and makes the
+     * capacity test always false, so the ribbon never renders and the point
+     * list grows without bound.
+     */
+    constructor(x: number, y: number, settings?: {
+        target?: Vector3d | Renderable | undefined;
+        length?: number | undefined;
+        lifetime?: number | undefined;
+        minDistance?: number | undefined;
+        width?: number | undefined;
+        widthCurve?: number[] | undefined;
+        color?: string | Color | undefined;
+        gradient?: (string | Color | {
+            pos: number;
+            color: Color | string;
+        })[] | undefined;
+        billboard?: string | boolean | undefined;
+        ribbonNormal?: number[] | Vector3d | undefined;
+        opacity?: number | undefined;
+        blendMode?: string | undefined;
+        depthTest?: boolean | undefined;
+    });
+    /**
+     * what the ribbon follows, sampled once per update
+     * @type {Renderable|Vector3d|null}
+     */
+    target: Renderable | Vector3d | null;
+    /** @type {number} */
+    lifetime: number;
+    /** @type {number} */
+    minDistance: number;
+    /** @type {number[]} */
+    widthCurve: number[];
+    billboard: string | boolean;
+    set ribbonNormal(value: Vector3d);
+    /**
+     * The facing used when {@link Trail3d#billboard} is `false`.
+     *
+     * Accepts a {@link Vector3d} or a `[x, y, z]` array and holds a normalized
+     * copy, so a caller that keeps mutating the array it passed is not
+     * steering this ribbon by accident. A zero-length value falls back to
+     * world up rather than dividing by it.
+     * @type {Vector3d}
+     * @default (0, -1, 0)
+     */
+    get ribbonNormal(): Vector3d;
+    castGroundShadow: boolean;
+    set maxPoints(_value: number);
+    /**
+     * How many points the ribbon can hold.
+     *
+     * Read-only: see the note on `settings.length`. Assigning throws rather
+     * than silently doing nothing, because the alternative is a ribbon that
+     * quietly keeps its old capacity.
+     * @type {number}
+     */
+    get maxPoints(): number;
+    /**
+     * Recolour the ribbon with a single colour, faded out along its length.
+     *
+     * A method rather than a setter, matching {@link Renderable#setTint} and
+     * {@link Renderable#setOpacity}: it allocates a gradient, so it is for a
+     * change of state rather than for every frame. {@link Renderable#tint} is
+     * the per-frame lever, and unlike on {@link Trail} it works here, because
+     * the mesh batcher multiplies it in.
+     * @param {Color|string} value - the colour
+     * @returns {Trail3d} this, for chaining
+     */
+    setColor(value: Color | string): Trail3d;
+    /**
+     * Recolour the ribbon with a gradient, in the format the constructor takes.
+     * @param {(Color|string|{pos: number, color: Color|string})[]} value - the stops
+     * @returns {Trail3d} this, for chaining
+     */
+    setGradient(value: (Color | string | {
+        pos: number;
+        color: Color | string;
+    })[]): Trail3d;
+    /**
+     * The gradient the ribbon is currently coloured by.
+     * @type {Gradient}
+     * @see {@link Trail3d#setGradient}
+     */
+    get gradient(): Gradient;
+    /**
+     * Add a point to the ribbon.
+     *
+     * Ignored when it is closer than {@link Trail3d#minDistance} to the last
+     * one, measured in three dimensions — which is what stops a ribbon flying
+     * straight at the camera from never sampling a second point.
+     * @param {number} x - x position, world units
+     * @param {number} y - y position, world units
+     * @param {number} [z=0] - z position, world units
+     */
+    addPoint(x: number, y: number, z?: number): void;
+    /** drop every point, leaving the ribbon empty */
+    clear(): void;
+}
+import Mesh from "./mesh.js";
+import type Renderable from "./renderable.js";
+import { Vector3d } from "../math/vector3d.ts";
+import type { Gradient } from "../video/gradient.js";
+import type { Color } from "../math/color.ts";
+//# sourceMappingURL=trail3d.d.ts.map

package/build/renderable/trail3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trail3d.d.ts","sourceRoot":"","sources":["../../src/renderable/trail3d.js"],"names":[],"mappings":"AAoCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH;IACC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,eAzBW,MAAM,KAEN,MAAM,aAEd;QAAuC,MAAM;QACnB,MAAM;QAIN,QAAQ;QACR,WAAW;QACX,KAAK;QACH,UAAU;QACN,KAAK;QACkC,QAAQ;iBAAnD,MAAM;mBAAS,KAAK,GAAC,MAAM;;QACrB,SAAS;QACN,YAAY;QACvB,OAAO;QACP,SAAS;QACR,SAAS;KACpC,EA+HF;IA1EA;;;OAGG;IACH,QAFU,UAAU,GAAC,QAAQ,GAAC,IAAI,CAEG;IACrC,qBAAqB;IACrB,UADW,MAAM,CACuB;IACxC,qBAAqB;IACrB,aADW,MAAM,CAC2B;IAG5C,uBAAuB;IACvB,YADW,MAAM,EAAE,CAIT;IAEV;;;OAGG;IACH,mBAAwB;IACxB;;;;;;;OAOG;IACH,eAAiB;IACjB,wBAAwB;IACxB,oBAA8C;IAC9C,wBAAwB;IACxB,qBAAoC;IACpC,6DAA6D;IAC7D,kCAA0C;IAC1C,wBAAwB;IACxB,wBAAqE;IACrE;;;;;;;;;;;OAWG;IACH,iBAAiB;IACjB,wBAAwB;IACxB,iBAAiB;IAEjB,4BAAkD;IAqDnD,wBAPU,QAAQ,EAiBjB;IAxBD;;;;;;;;;OASG;IACH,oBAHU,QAAQ,CAKjB;IAzCA,0BAA6B;IAuB9B,sBANU,MAAM,EAUf;IAhBD;;;;;;;OAOG;IACH,iBAFU,MAAM,CAIf;IAkCD;;;;;;;;;;OAUG;IACH,gBAHW,KAAK,GAAC,MAAM,GACV,OAAO,CAQnB;IAED;;;;OAIG;IACH,mBAHW,CAAC,KAAK,GAAC,MAAM,GAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,GAAC,MAAM,CAAA;KAAC,CAAC,EAAE,GACjD,OAAO,CAMnB;IAED;;;;OAIG;IACH,gBAHU,QAAQ,CAKjB;IAED;;;;;;;;;OASG;IACH,YAJW,MAAM,KACN,MAAM,MACN,MAAM,QAiBhB;IAED,iDAAiD;IACjD,cAEC;IAuCD;;;;;;;;;;;;;;;OAeG;IACH,sBA2DC;IAED;;;;;;;;;;;;;;OAcG;IACH,wBALW,OAAO,GACL,MAAM,CAuBlB;IAED;;;;;;OAMG;IACH,eALW,QAAQ,aACR,QAAQ,QA6BlB;IAED;;;;;OAKG;IACH,sBAJW,QAAQ,QA2FlB;IAED;;;;;;;OAOG;IACH,kBAJa,MAAM,GAAC,IAAI,CAsCvB;IAwBD;;;;;;;OAOG;IACH,uBAJa,MAAM,CAwBlB;CAmBD;iBA/tBgB,WAAW;4BAMD,iBAAiB;yBATnB,qBAAqB;8BAQnB,sBAAsB;2BADzB,kBAAkB;0BAGjB,sBAAsB;qBAb1B,uBAAuB"}

package/build/renderable/trigger.d.ts

@@ -88,7 +88,7 @@ export default class Trigger extends Renderable {
         shadowStretch?: number | undefined;
         shadowDirectionX?: number | undefined;
         shadowDirectionZ?: number | undefined;
-        shadowGroundNormal?: number[] | Vector3d;
+        shadowGroundNormal?: number[] | Vector3d | undefined;
         shadowLight?: any;
     });
     color: any;
@@ -129,4 +129,5 @@ import type { Rect } from "../geometries/rectangle.ts";
 import type { Line } from "../geometries/line.ts";
 import type { Color } from "../math/color.ts";
 import type Container from "./container.js";
+import type { Vector3d } from "../math/vector3d.ts";
 //# sourceMappingURL=trigger.d.ts.map

package/build/renderable/trigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../../src/renderable/trigger.js"],"names":[],"mappings":"AAiEA;IACC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8DG;IACH,eA9DW,MAAM,KACN,MAAM,YAEd;QAA0B,KAAK;QACL,MAAM;QACqB,MAAM;QACjC,QAAQ;QACF,KAAK;QACX,UAAU;QACD,KAAK;QACd,KAAK;QACL,EAAE;QACQ,SAAS;QACjB,QAAQ;QACT,OAAO;QACP,iBAAiB;QAClB,KAAK;QACJ,WAAW;QACX,MAAM;QACP,mBAAmB;QAClB,gBAAgB;QACjB,aAAa;QACb,aAAa;QACb,WAAW;QACX,YAAY;QACZ,aAAa;QACb,gBAAgB;QAChB,gBAAgB;QACL,kBAAkB,GAA/C,MAAM,EAAE,GAAC,QAAQ;QACE,WAAW;KACtC,EAyFF;IApDA,WAA4C;IAC5C,6BAAiC;IACjC,mBAA+C;IAC/C,+CAAqC;IACrC,gBAAmB;IAInB,UAAyB;IACzB,QAAqB;IACrB,8BAA4B;IAG5B;;MAEC;IAwBD;;;;;;MAMC;IASF;;;OAGG;IACH;;MAQC;IAED;;;OAGG;IACH,+BAwFC;IAED;;;;;OAKG;IACH,yBAIC;CACD;uBA3SsB,iBAAiB;6BASd,0BAA0B;6BAF1B,0BAA0B;0BAG7B,4BAA4B;0BAF5B,uBAAuB;2BAHtB,kBAAkB;2BAChB,gBAAgB"}
+{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../../src/renderable/trigger.js"],"names":[],"mappings":"AAkEA;IACC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8DG;IACH,eA9DW,MAAM,KACN,MAAM,YAEd;QAA0B,KAAK;QACL,MAAM;QACqB,MAAM;QACjC,QAAQ;QACF,KAAK;QACX,UAAU;QACD,KAAK;QACd,KAAK;QACL,EAAE;QACQ,SAAS;QACjB,QAAQ;QACT,OAAO;QACP,iBAAiB;QAClB,KAAK;QACJ,WAAW;QACX,MAAM;QACP,mBAAmB;QAClB,gBAAgB;QACjB,aAAa;QACb,aAAa;QACb,WAAW;QACX,YAAY;QACZ,aAAa;QACb,gBAAgB;QAChB,gBAAgB;QACL,kBAAkB;QAC5B,WAAW;KACtC,EAyFF;IApDA,WAA4C;IAC5C,6BAAiC;IACjC,mBAA+C;IAC/C,+CAAqC;IACrC,gBAAmB;IAInB,UAAyB;IACzB,QAAqB;IACrB,8BAA4B;IAG5B;;MAEC;IAwBD;;;;;;MAMC;IASF;;;OAGG;IACH;;MAQC;IAED;;;OAGG;IACH,+BAwFC;IAED;;;;;OAKG;IACH,yBAIC;CACD;uBA5SsB,iBAAiB;6BAUd,0BAA0B;6BAH1B,0BAA0B;0BAI7B,4BAA4B;0BAH5B,uBAAuB;2BAHtB,kBAAkB;2BAChB,gBAAgB;8BAGf,qBAAqB"}

package/build/renderable/ui/panelpaint.d.ts

@@ -0,0 +1,5 @@
+import { Color } from "../../math/color.ts";
+import type { Gradient } from "../../video/gradient.js";
+/** anything {@link Renderer#setColor} will take */
+export type Paint = Color | string | Gradient;
+//# sourceMappingURL=panelpaint.d.ts.map

package/build/renderable/ui/panelpaint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panelpaint.d.ts","sourceRoot":"","sources":["../../../src/renderable/ui/panelpaint.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAa,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGxD,mDAAmD;AACnD,MAAM,MAAM,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC"}

package/build/renderable/ui/progressbar.d.ts

@@ -1,9 +1,8 @@
-import { Color } from "../../math/color.ts";
 import { on } from "../../system/event.ts";
-import type { Gradient } from "../../video/gradient.js";
 import type Renderer from "../../video/renderer.js";
 import Renderable from "../renderable.js";
 import Text from "../text/text.js";
+import type { Paint } from "./panelpaint.ts";
 /**
  * The name of any event the engine knows about.
  *
@@ -11,8 +10,6 @@ import Text from "../text/text.js";
  * the event module; this gets the same set without widening that surface.
  */
 type EventName = Parameters<typeof on>[0];
-/** anything {@link Renderer#setColor} will take */
-type Paint = Color | string | Gradient;
 /** which way the fill grows */
 export type ProgressBarDirection = "left-to-right" | "right-to-left" | "top-to-bottom" | "bottom-to-top";
 /**
@@ -153,6 +150,7 @@ export default class ProgressBar extends Renderable {
     label?: Text | undefined;
     /** the event the value is taken from, if any */
     readonly bindEvent?: EventName | undefined;
+    private _value;
     /**
      * @param x - position of the bar's left edge
      * @param y - position of its top edge

package/build/renderable/ui/progressbar.d.ts.map

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

package/build/renderable/ui/uipanel.d.ts

@@ -0,0 +1,245 @@
+import type Camera2d from "../../camera/camera2d.ts";
+import type { Matrix3d } from "../../math/matrix3d.ts";
+import type { Vector3d } from "../../math/vector3d.ts";
+import type Renderer from "../../video/renderer.js";
+import type { Paint } from "./panelpaint.ts";
+import UIBaseElement from "./uibaseelement.ts";
+/**
+ * Everything {@link UIPanel} takes.
+ */
+export interface UIPanelSettings {
+    /** the panel's width, in pixels */
+    width: number;
+    /** the panel's height, in pixels */
+    height: number;
+    /**
+     * The fill behind the children; `null` leaves it transparent.
+     *
+     * NOT `backgroundColor`, which a `Container` already has and which does
+     * something else entirely: that one is handed to `clearColor` and wipes
+     * the whole render target, so a panel setting it would repaint the
+     * screen. The name here matches {@link ProgressBarSettings} instead.
+     */
+    fillColor?: Paint | null;
+    /** drawn around the edge; `null` for none */
+    borderColor?: Paint | null;
+    /** how thick that border is */
+    borderWidth?: number;
+    /** corner radius; `0` is square */
+    radius?: number;
+    /**
+     * How far the panel drifts up and down, in pixels. `0`, the default,
+     * leaves it still.
+     *
+     * See {@link UIPanel#bobAmplitude}.
+     */
+    bobAmplitude?: number;
+    /**
+     * How long one full up and down cycle takes, in milliseconds.
+     *
+     * See {@link UIPanel#bobPeriod}.
+     */
+    bobPeriod?: number;
+    /**
+     * Whether the panel swallows pointer events aimed at what is behind it.
+     *
+     * `true` by default, which is what a dialog wants: a click on the panel,
+     * or on the dimmed scene it covers, must not reach the game underneath.
+     * Children are unaffected either way, because the dispatcher asks a child
+     * before the container holding it.
+     *
+     * Set `false` for a panel that is only a backdrop, such as a HUD frame
+     * drawn over a playfield that still has to receive clicks.
+     */
+    blocking?: boolean;
+}
+/**
+ * A rectangular surface with a background, an optional border and children.
+ *
+ * The thing every menu, dialog and HUD frame starts by writing: a rounded
+ * rectangle, a fill, an outline, and some labels on top. One example in this
+ * repository had three of them, each repeating the same half dozen renderer
+ * calls, and each repeating the same correction for the way `setColor` folds
+ * the global alpha in. That correction is the reason this is a widget rather
+ * than a snippet: it is easy to leave out, and leaving it out does not fail,
+ * it just renders a panel at the wrong opacity.
+ *
+ * It is a {@link UIBaseElement}, so it is a container that carries pointer
+ * events, and children added to it are drawn over its background and are
+ * asked about a click before it is.
+ *
+ * It is floating, as every UI element is, and where it lands in the paint
+ * order is the depth it is added at. In a world sorted on `"depth"`, which
+ * is every `Camera3d` scene, that depth is read the other way round from
+ * the 2D habit: a floating child is ranked by `|pos.z|` there and the
+ * SMALLER magnitude draws on top, so a panel added at 9000 to sit above
+ * everything sits behind everything instead, and a dialog there wants a
+ * small depth, 0 or 1.
+ * @example
+ * import { UIPanel, Text } from "melonjs";
+ *
+ * const panel = new UIPanel(cx - 200, cy - 120, {
+ *     width: 400,
+ *     height: 240,
+ *     fillColor: "#0a1526",
+ *     borderColor: "rgba(130, 200, 240, 0.55)",
+ *     borderWidth: 2,
+ *     radius: 14,
+ * });
+ * // positioned relative to the panel, not to the screen
+ * panel.addChild(new Text(200, 24, { text: "PAUSED", textAlign: "center" }));
+ * app.world.addChild(panel);
+ * @category UI
+ */
+export default class UIPanel extends UIBaseElement {
+    /** the fill behind the children; `null` leaves it transparent */
+    fillColor: Paint | null;
+    /** drawn around the edge; `null` for none */
+    borderColor: Paint | null;
+    /** how thick that border is */
+    borderWidth: number;
+    /** corner radius; `0` is square */
+    radius: number;
+    /** whether it swallows pointer events aimed at what is behind it */
+    blocking: boolean;
+    /**
+     * How far the panel drifts up and down, in pixels. `0`, the default,
+     * leaves it still.
+     *
+     * The slow float an idle dialogue or pause panel has in a lot of games,
+     * which is there so a screen waiting for input does not look frozen. It
+     * is a sine, so this is the distance to either extreme and the panel
+     * covers twice it over a cycle; 2 to 4 is the usual range, and it starts
+     * by rising rather than sinking.
+     *
+     * Do not go much below 2. The renderer snaps a translation to whole
+     * pixels, truncating, so an amplitude of 1 spends most of the cycle
+     * reading as 0 and the panel twitches rather than drifts.
+     *
+     * The panel is CLICKABLE where it is drawn: the offset goes into
+     * {@link UIPanel#getAbsolutePosition}, which is what the bounds pipeline
+     * reads, so the hit area of the panel and of every widget inside it
+     * follows the float at any depth. `pos` is deliberately left alone, so a
+     * caller still reads and writes the resting place rather than a value
+     * that moves under them.
+     *
+     * The bounds are rebuilt only on the frames the offset actually changes,
+     * so a panel with no bob costs nothing.
+     * @default 0
+     */
+    bobAmplitude: number;
+    /**
+     * How long one full up and down cycle takes, in milliseconds.
+     *
+     * Anything at or below zero turns the bob off rather than dividing by it.
+     * That is not politeness: the offset would be `NaN`, and one `translate`
+     * by `NaN` writes it into the transform, where every batched vertex under
+     * it inherits the poison and the GPU clips the lot away. A panel that
+     * silently vanished would be a long way from an obviously bad period.
+     * @default 2000
+     */
+    bobPeriod: number;
+    /**
+     * @param x - position of the panel's left edge
+     * @param y - position of the panel's top edge
+     * @param settings - see {@link UIPanelSettings}
+     */
+    constructor(x: number, y: number, settings: UIPanelSettings);
+    /**
+     * Advance the bob.
+     * @param dt - time since the last frame, in milliseconds
+     * @returns whether the panel needs redrawing
+     */
+    update(dt: number): boolean;
+    /**
+     * Draw the fill, the border, and then the children over both.
+     * @param renderer - the renderer to draw with
+     * @param viewport - the camera being drawn through, passed to the children
+     */
+    draw(renderer: Renderer, viewport?: Camera2d): void;
+    /**
+     * Where the panel IS, bob included.
+     *
+     * THE hook that makes a floating panel honest. Both bounds paths funnel
+     * through this one method, and a child's absolute position is the sum of
+     * the chain above it, so adding the offset here reaches the panel's own
+     * hit area and every descendant's, at any depth, without any of them
+     * knowing a bob exists.
+     *
+     * Not `currentTransform`, which was the obvious guess: that reaches a
+     * renderable's OWN bounds and not its children's, so a bobbing panel's
+     * swallow rectangle would drift off the widgets sitting in it. And not a
+     * write to `pos`, which would reach everything correctly but silently
+     * overwrite a caller's own write on the very next frame.
+     *
+     * {@link Particle} overrides this method for the same reason, its
+     * placement not being in its `pos` chain either.
+     * @returns the absolute position, offset by the bob
+     */
+    getAbsolutePosition(): Vector3d;
+    /**
+     * The matrix form of the same offset.
+     *
+     * Without it `getWorldTransform()` and `getAbsolutePosition()` disagree
+     * about a bobbing panel, and the contract on those two says that for a
+     * `Container` they coincide.
+     * @param out - matrix to write into
+     * @returns `out`, for chaining
+     */
+    protected getLocalTransform(out: Matrix3d): Matrix3d;
+    /**
+     * Resize this panel's bounds, and refresh its children's.
+     *
+     * `Container` does those two jobs in ONE loop, both gated on
+     * `enableChildBoundsUpdate`, and a panel wants exactly one of them. The
+     * flag is off here so that a label overhanging the edge cannot grow the
+     * rectangle a blocking panel swallows clicks inside, and turning it off
+     * took the other job with it: a child's bounds are absolute, worked out
+     * once through `getAbsolutePosition()` and then cached, so moving the
+     * panel left every child's HIT AREA behind at the old place while the
+     * whole panel drew at the new one. A dialog slid or snapped into position
+     * after it was built had buttons that only answered where they used to
+     * be.
+     *
+     * This costs nothing per frame: `pos` calls `updateBounds` when it is
+     * written, so the walk happens when the panel actually moves.
+     * @param absolute - update in world absolute coordinates
+     * @returns this panel's bounds
+     */
+    updateBounds(absolute?: boolean): import("../../index.ts").Bounds;
+    /**
+     * Consume a click on the panel itself, unless told not to.
+     *
+     * Returning `false` is how {@link UIBaseElement} consumes. A child is
+     * asked before the container holding it, so this only ever sees a click
+     * that missed every one of them, which for a dialog means a click on its
+     * own background and should go no further.
+     * @returns false while {@link UIPanel#blocking}
+     */
+    onClick(): boolean;
+    /**
+     * Consume the release that follows a click on the panel, unless told not
+     * to.
+     *
+     * The three handlers consume independently. Taking the press and leaving
+     * the release is half a block: the pointer-up still reaches whatever is
+     * under the dialog, so a button there completes an interaction it never
+     * began.
+     * @returns false while {@link UIPanel#blocking}
+     */
+    onRelease(): boolean;
+    /**
+     * Consume a hover on the panel itself, unless told not to.
+     *
+     * Without this a widget UNDER a dialog keeps lighting up as the pointer
+     * crosses the panel covering it.
+     * @returns false while {@link UIPanel#blocking}
+     */
+    onOver(): boolean;
+    /**
+     * Hand back what the painter borrowed.
+     * @ignore
+     */
+    onDestroyEvent(): void;
+}
+//# sourceMappingURL=uipanel.d.ts.map

package/build/renderable/ui/uipanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uipanel.d.ts","sourceRoot":"","sources":["../../../src/renderable/ui/uipanel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AAEpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACzB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,aAAa;IACjD,iEAAiE;IACjE,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC;IACxB,6CAA6C;IAC7C,WAAW,EAAE,KAAK,GAAG,IAAI,CAAC;IAC1B,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;;;;OASG;IACH,SAAS,EAAE,MAAM,CAAC;IAmClB;;;;OAIG;gBACS,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe;IAiE3D;;;;OAIG;IACM,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAmBpC;;;;OAIG;IACM,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,QAAQ;IA6CrD;;;;;;;;;;;;;;;;;;OAkBG;IACM,mBAAmB,IAAI,QAAQ;IAMxC;;;;;;;;OAQG;cACgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ;IAS7D;;;;;;;;;;;;;;;;;;OAkBG;IACM,YAAY,CAAC,QAAQ,UAAO;IAQrC;;;;;;;;OAQG;IACM,OAAO,IAAI,OAAO;IAI3B;;;;;;;;;OASG;IACM,SAAS,IAAI,OAAO;IAI7B;;;;;;OAMG;IACM,MAAM,IAAI,OAAO;IAI1B;;;OAGG;IACM,cAAc;CAIvB"}

package/build/renderable/ui/uitextbutton.d.ts

@@ -1,5 +1,6 @@
 import type Camera2d from "../../camera/camera2d.ts";
 import { RoundRect } from "../../geometries/roundrect.ts";
+import type Pointer from "../../input/pointer.ts";
 import type { Bounds } from "../../physics/bounds.ts";
 import type Renderer from "../../video/renderer.js";
 import BitmapText from "../text/bitmaptext.js";
@@ -8,6 +9,7 @@ interface UITextButtonSettings {
     font?: string;
     size?: number;
     text?: string;
+    /** see {@link UITextButton.bindKey} */
     bindKey?: string | number;
     hoverOffColor?: string;
     hoverOnColor?: string;
@@ -25,9 +27,31 @@ interface UITextButtonSettings {
  */
 export default class UITextButton extends UIBaseElement {
     /**
-     * The key to bind the action to
+     * Keyboard shortcut: an input.KEY keycode or an existing input action name.
+     * A press calls onClick() and its matching release calls onRelease(), both
+     * without a pointer event. Shortcuts are active only while the button is
+     * activated and never change global key bindings. The first input to press
+     * owns the button until released; shortcuts do not start pointer dragging
+     * or tap-and-hold.
+     *
+     * `isClickable` gates the PRESS, not the release: a button disabled while
+     * its key is held still releases when that key comes up, so it cannot be
+     * left stuck down.
+     *
+     * **Losing focus or being removed cancels a held press WITHOUT calling
+     * `onRelease()`.** The press was abandoned rather than completed, so the
+     * button returns to its released state silently. Code that treats the pair
+     * as press and depress, firing a weapon on click and stopping on release,
+     * needs to stop on {@link event.BLUR} too or it will still be firing when
+     * the window comes back.
+     * @default -1
      */
     bindKey: string | number;
+    private keyboardKey;
+    private keyboardActive;
+    private readonly keyDown;
+    private readonly keyUp;
+    private readonly cancelKeyboardPress;
     /**
      * The css value of a color to be used if the pointer is not hovering over the button
      */
@@ -95,6 +119,11 @@ export default class UITextButton extends UIBaseElement {
      * world.addChild(new PlayButton(15,200));
      */
     constructor(x: number, y: number, settings: UITextButtonSettings);
+    onActivateEvent(): void;
+    onDeactivateEvent(): void;
+    clicked(event: Pointer): boolean | void;
+    release(event: Pointer): boolean | void;
+    pointerMove(event: Pointer): void;
     draw(renderer: Renderer, viewport?: Camera2d): void;
 }
 export {};

package/build/renderable/ui/uitextbutton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uitextbutton.d.ts","sourceRoot":"","sources":["../../../src/renderable/ui/uitextbutton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AACpD,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAE/C,UAAU,oBAAoB;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,aAAa;IACtD;;OAEG;IACH,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,UAAU,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;IAElB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;gBACS,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB;IAyCvD,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI;CAY5D"}
+{"version":3,"file":"uitextbutton.d.ts","sourceRoot":"","sources":["../../../src/renderable/ui/uitextbutton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AACpD,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAE/C,UAAU,oBAAoB;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,aAAa;IACtD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAkBtB;IAEF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAQpB;IAEF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAMlC;IAEF;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,UAAU,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;IAElB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;gBACS,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB;IAyCvD,eAAe,IAAI,IAAI;IAWvB,iBAAiB,IAAI,IAAI;IASzB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI;IAOvC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI;IAOvC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAMjC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI;CAY5D"}

package/build/state/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state/state.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,qBAAqB,CAAC;AA4QxC;;GAEG;AACH,QAAA,MAAM,KAAK;IACV;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;;;;;OAOG;;IAGH;;;OAGG;4BACoB,OAAO,GAAW,IAAI;IAqB7C;;;OAGG;kBACU,OAAO,GAAW,IAAI;IAkBnC;;;OAGG;oBACY,OAAO,GAAW,IAAI;IAiBrC;;;OAGG;mBACW,OAAO,GAAW,IAAI;IAmBpC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;qBACc,MAAM,UAAS,OAAO,GAAW,OAAO,CAAC,IAAI,CAAC;IAkC/D;;;OAGG;iBACU,OAAO;IAIpB;;;OAGG;gBACS,OAAO;IAInB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;iBACU,MAAM,SAAS,KAAK,UAAS,OAAO,GAAW,IAAI;IAchE;;;;;OAKG;kBACU,MAAM,GAAY,KAAK,GAAG,SAAS;IAQhD;;;;OAIG;eACQ,KAAK,GAAG,SAAS;IAI5B;;;;;;;;;;;;;;;;;;OAkBG;uBAEM,MAAM,GAAG,MAAM,SAChB,MAAM,aACH,MAAM,UAEb,OAAO,0BAA0B,EAAE,OAAO,GAC1C,OAAO,0BAA0B,EAAE,OAAO,GAC3C,IAAI;IAOP;;;;OAIG;2BACoB,MAAM,UAAU,OAAO,GAAG,IAAI;IAIrD;;;;;;;;;OASG;oBAEO,MAAM,gBACF,OAAO,gBACN,OAAO,EAAE,GACrB,IAAI;IA4FP;;;;OAIG;uBACgB,MAAM,GAAG,OAAO;CAGnC,CAAC;AACF,eAAe,KAAK,CAAC"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state/state.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,qBAAqB,CAAC;AA4QxC;;GAEG;AACH,QAAA,MAAM,KAAK;IACV;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;;;;;OAOG;;IAGH;;;OAGG;4BACoB,OAAO,GAAW,IAAI;IAqB7C;;;OAGG;kBACU,OAAO,GAAW,IAAI;IAkBnC;;;OAGG;oBACY,OAAO,GAAW,IAAI;IAiBrC;;;OAGG;mBACW,OAAO,GAAW,IAAI;IAmBpC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;qBACc,MAAM,UAAS,OAAO,GAAW,OAAO,CAAC,IAAI,CAAC;IAkC/D;;;OAGG;iBACU,OAAO;IAIpB;;;OAGG;gBACS,OAAO;IAInB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;iBACU,MAAM,SAAS,KAAK,UAAS,OAAO,GAAW,IAAI;IAchE;;;;;OAKG;kBACU,MAAM,GAAY,KAAK,GAAG,SAAS;IAQhD;;;;OAIG;eACQ,KAAK,GAAG,SAAS;IAI5B;;;;;;;;;;;;;;;;;;OAkBG;uBAEM,MAAM,GAAG,MAAM,SAChB,MAAM,aACH,MAAM,UAEb,OAAO,0BAA0B,EAAE,OAAO,GAC1C,OAAO,0BAA0B,EAAE,OAAO,GAC3C,IAAI;IAOP;;;;OAIG;2BACoB,MAAM,UAAU,OAAO,GAAG,IAAI;IAIrD;;;;;;;;;OASG;oBAEO,MAAM,gBACF,OAAO,gBACN,OAAO,EAAE,GACrB,IAAI;IA0GP;;;;OAIG;uBACgB,MAAM,GAAG,OAAO;CAGnC,CAAC;AACF,eAAe,KAAK,CAAC"}

package/build/system/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/system/bootstrap.ts"],"names":[],"mappings":"AAsBA;;GAEG;AACH,eAAO,IAAI,WAAW,SAAQ,CAAC;AAE/B;;;;;;GAMG;AACH,wBAAgB,IAAI,SA0DnB"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/system/bootstrap.ts"],"names":[],"mappings":"AAmBA;;GAEG;AACH,eAAO,IAAI,WAAW,SAAQ,CAAC;AAE/B;;;;;;GAMG;AACH,wBAAgB,IAAI,SAmDnB"}

package/build/system/legacy_pool.d.ts

@@ -27,6 +27,17 @@ declare const pool: ObjectPool;
  * which means, that on level loading the engine will try to instantiate every object
  * found in the map, based on the user defined name in each Object Properties<br>
  * <img src="../images/object_properties.png"/><br>
+ *
+ * **Superseded by the typed pools.** `createPool` arrived in 18.0.0 and does
+ * the same job without the string keys: `getPool("tween")`, `getPool("text")`
+ * and the rest are typed, so a wrong name is a compile error rather than a
+ * throw, and a pool can be created for any class with `createPool`. For
+ * registering a class so a Tiled map can name it, use
+ * {@link registerTiledObjectClass}, which is what this now delegates to.
+ *
+ * The engine itself no longer uses this pool for anything.
+ * @deprecated since 18.0.0, use {@link getPool} / `createPool`, and
+ * {@link registerTiledObjectClass} for Tiled classes
  * @see {@link pool} the default global instance of ObjectPool
  */
 declare class ObjectPool {
@@ -106,9 +117,18 @@ declare class ObjectPool {
      * Object pooling for the object class must be enabled,
      * and object must have been instantiated using {@link pull},
      * otherwise this function won't work
-     * @throws will throw an error if the object cannot be recycled
+     *
+     * Reports failure by RETURNING FALSE. It used to throw by default, and
+     * nothing at the call site made that visible: a class that was never
+     * registered, or registered without recycling, aborted whatever was
+     * running. Both of the internal uses removed in 20.7.0 failed that way,
+     * inside a `destroy()` that had already recycled other state, which left
+     * a half-torn-down object to die later somewhere unrelated. Pass
+     * `throwOnError` to opt back in where a missed registration is a bug you
+     * want to hear about immediately.
      * @param {object} obj - instance to be recycled
-     * @param {boolean} [throwOnError=true] - throw an exception if the object cannot be recycled
+     * @param {boolean} [throwOnError=false] - throw an exception instead of returning false
+     * @throws when the object cannot be recycled AND `throwOnError` is true
      * @returns {boolean} true if the object was successfully recycled in the object pool
      */
     push(obj: object, throwOnError?: boolean): boolean;

package/build/system/legacy_pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legacy_pool.d.ts","sourceRoot":"","sources":["../../src/system/legacy_pool.js"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,kEAEC;;AAmND;;;;;;;;;;;;;;GAcG;AACH,+BAA8B;AAhO9B;;;;;;;;;;;;GAYG;AACH;IAEE,gBAAqB;IACrB,yBAAyB;IAEzB;;;;;;;;;;;;;;OAcG;IACH,mBARU,OAAO,CAQY;IAG9B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,oBAhBW,MAAM,YACN,MAAM,cACN,OAAO,QAsCjB;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,WAnBW,MAAM,WACH,GAAC,EAAA,GACF,MAAM,CAsClB;IAED;;;;OAIG;IACH,cAOC;IAED;;;;;;;;;OASG;IACH,UAJW,MAAM,iBACN,OAAO,GACL,OAAO,CAgBnB;IAED;;;;OAIG;IACH,aAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;;;;;;;OAUG;IACH,cAPW,MAAM,GACJ,OAAO,CAcnB;IAED;;;OAGG;IACH,oBAFa,MAAM,CAIlB;CACD"}
+{"version":3,"file":"legacy_pool.d.ts","sourceRoot":"","sources":["../../src/system/legacy_pool.js"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,kEAEC;;AA4QD;;;;;;;;;;;;;;GAcG;AACH,+BAA8B;AAvP9B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH;IAEE,gBAAqB;IACrB,yBAAyB;IAEzB;;;;;;;;;;;;;;OAcG;IACH,mBARU,OAAO,CAQY;IAG9B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,oBAhBW,MAAM,YACN,MAAM,cACN,OAAO,QAuCjB;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,WAnBW,MAAM,WACH,GAAC,EAAA,GACF,MAAM,CAuClB;IAED;;;;OAIG;IACH,cAOC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,UALW,MAAM,iBACN,OAAO,GAEL,OAAO,CAiBnB;IAED;;;;OAIG;IACH,aAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;;;;;;;OAUG;IACH,cAPW,MAAM,GACJ,OAAO,CAcnB;IAED;;;OAGG;IACH,oBAFa,MAAM,CAIlB;CACD"}