@codexo/exojs 0.13.0 → 0.15.0

package/dist/esm/resources/utils.js

@@ -89,17 +89,17 @@ const matchesAvifImage = (arrayBuffer) => {
         return false;
     }
     const header = new Uint8Array(arrayBuffer);
-    if (String.fromCharCode(header[4], header[5], header[6], header[7]) !== 'ftyp') {
+    if (String.fromCharCode(header[4] ?? 0, header[5] ?? 0, header[6] ?? 0, header[7] ?? 0) !== 'ftyp') {
         return false;
     }
-    const brand = String.fromCharCode(header[8], header[9], header[10], header[11]);
+    const brand = String.fromCharCode(header[8] ?? 0, header[9] ?? 0, header[10] ?? 0, header[11] ?? 0);
     return brand === 'avif' || brand === 'avis';
 };
 const matchesWebmVideo = (arrayBuffer) => {
     const header = new Uint8Array(arrayBuffer);
     const matching = [0x1a, 0x45, 0xdf, 0xa3].every((byte, i) => byte === header[i]);
     const sliced = header.subarray(4, 4 + 4096);
-    const index = sliced.findIndex((el, i, arr) => arr[i] === 0x42 && arr[i + 1] === 0x82);
+    const index = sliced.findIndex((_el, i, arr) => arr[i] === 0x42 && arr[i + 1] === 0x82);
     if (!matching || index === -1) {
         return false;
     }
@@ -124,7 +124,7 @@ const determineMimeType = (arrayBuffer) => {
         if (header.length < type.pattern.length) {
             continue;
         }
-        if (type.pattern.every((p, i) => (header[i] & type.mask[i]) === p)) {
+        if (type.pattern.every((p, i) => ((header[i] ?? 0) & (type.mask[i] ?? 0)) === p)) {
             return type.mimeType;
         }
     }

package/dist/esm/resources/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sources":["../../../../src/resources/utils.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sources":["../../../../src/resources/utils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAMA,MAAM,SAAS,GAAe;AAC5B,IAAA;AACE,QAAA,QAAQ,EAAE,cAAc;QACxB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QACjC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AAC/B,KAAA;AACD,IAAA;AACE,QAAA,QAAQ,EAAE,cAAc;QACxB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QACjC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AAC/B,KAAA;AACD,IAAA;AACE,QAAA,QAAQ,EAAE,WAAW;AACrB,QAAA,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;AACrB,QAAA,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;AACnB,KAAA;AACD,IAAA;AACE,QAAA,QAAQ,EAAE,WAAW;AACrB,QAAA,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AAC7C,QAAA,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AAC3C,KAAA;AACD,IAAA;AACE,QAAA,QAAQ,EAAE,WAAW;AACrB,QAAA,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AAC7C,QAAA,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AAC3C,KAAA;AACD,IAAA;AACE,QAAA,QAAQ,EAAE,YAAY;AACtB,QAAA,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AAC7F,QAAA,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AAC3F,KAAA;AACD,IAAA;AACE,QAAA,QAAQ,EAAE,WAAW;AACrB,QAAA,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AACzD,QAAA,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AACvD,KAAA;AACD,IAAA;AACE,QAAA,QAAQ,EAAE,YAAY;AACtB,QAAA,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AAC3B,QAAA,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AACzB,KAAA;AACD,IAAA;AACE,QAAA,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QACjC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AAC/B,KAAA;AACD,IAAA;AACE,QAAA,QAAQ,EAAE,cAAc;AACxB,QAAA,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AAC3B,QAAA,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AACzB,KAAA;AACD,IAAA;AACE,QAAA,QAAQ,EAAE,cAAc;QACxB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QACjF,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AAC/E,KAAA;AACD,IAAA;AACE,QAAA,QAAQ,EAAE,cAAc;AACxB,QAAA,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AACzD,QAAA,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AACvD,KAAA;AACD,IAAA;AACE,QAAA,QAAQ,EAAE,cAAc;QACxB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QACjF,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AAC/E,KAAA;AACD,IAAA;AACE,QAAA,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QACjF,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AAC/E,KAAA;AACD,IAAA;AACE,QAAA,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QACvC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AACrC,KAAA;CACF;AAED,MAAM,eAAe,GAAG,CAAC,WAAwB,KAAa;AAC5D,IAAA,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC;AAC1C,IAAA,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,WAAW,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC;AAExC,IAAA,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,KAAK,CAAC,EAAE;AAC9D,QAAA,OAAO,KAAK;IACd;AAEA,IAAA,OAAO,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS;AACrE,CAAC;AAED,MAAM,gBAAgB,GAAG,CAAC,WAAwB,KAAa;AAC7D,IAAA,IAAI,WAAW,CAAC,UAAU,GAAG,EAAE,EAAE;AAC/B,QAAA,OAAO,KAAK;IACd;AAEA,IAAA,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC;AAE1C,IAAA,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,MAAM,EAAE;AAClG,QAAA,OAAO,KAAK;IACd;AAEA,IAAA,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;AAEnG,IAAA,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM;AAC7C,CAAC;AAED,MAAM,gBAAgB,GAAG,CAAC,WAAwB,KAAa;AAC7D,IAAA,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC;AAC1C,IAAA,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC;AAChF,IAAA,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;AAC3C,IAAA,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC;IAEvF,IAAI,CAAC,QAAQ,IAAI,KAAK,KAAK,EAAE,EAAE;AAC7B,QAAA,OAAO,KAAK;IACd;IAEA,OAAO,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM;AACjF,CAAC;AAED;;;;;;;;;AASG;AACI,MAAM,iBAAiB,GAAG,CAAC,WAAwB,KAAY;AACpE,IAAA,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC;AAE1C,IAAA,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;AAClB,QAAA,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC;IACzD;AAEA,IAAA,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE;QAC5B,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YACvC;QACF;AAEA,QAAA,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE;YAChF,OAAO,IAAI,CAAC,QAAQ;QACtB;IACF;AAEA,IAAA,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE;AAChC,QAAA,OAAO,WAAW;IACpB;AAEA,IAAA,IAAI,gBAAgB,CAAC,WAAW,CAAC,EAAE;AACjC,QAAA,OAAO,YAAY;IACrB;AAEA,IAAA,IAAI,gBAAgB,CAAC,WAAW,CAAC,EAAE;AACjC,QAAA,OAAO,YAAY;IACrB;AAEA,IAAA,OAAO,YAAY;AACrB;;;;"}

package/dist/esm/ui/Button.d.ts

@@ -0,0 +1,54 @@
+import { Color } from '#core/Color';
+import { Signal } from '#core/Signal';
+import { Widget } from './Widget';
+export interface ButtonOptions {
+    width?: number;
+    height?: number;
+    label?: string;
+    cornerRadius?: number;
+    /** Fill color in the normal state. */
+    color?: Color;
+    hoverColor?: Color;
+    pressedColor?: Color;
+    disabledColor?: Color;
+    textColor?: Color;
+    fontSize?: number;
+}
+/**
+ * Clickable button with a rounded background, a centered label, hover/pressed
+ * visual states, and keyboard activation (Enter / Space while focused).
+ * Listen to {@link Button.onClick} for activation.
+ */
+export declare class Button extends Widget {
+    /** Fires when the button is activated by click, tap, or Enter/Space. */
+    readonly onClick: Signal<[Button]>;
+    private readonly _background;
+    private readonly _label;
+    private readonly _colors;
+    private readonly _cornerRadius;
+    private _state;
+    private _pointerInside;
+    constructor(options?: ButtonOptions);
+    get label(): string;
+    set label(value: string);
+    /** The per-state fill colours (`normal` / `hover` / `pressed` / `disabled`). */
+    get colors(): Readonly<Record<'normal' | 'hover' | 'pressed' | 'disabled', Color>>;
+    /** Corner radius in pixels. */
+    get cornerRadius(): number;
+    /** Label fill colour. */
+    get textColor(): Color;
+    /** Label font size in pixels. */
+    get fontSize(): number;
+    private readonly _onPointerOver;
+    private readonly _onPointerOut;
+    private readonly _onPointerDown;
+    private readonly _onPointerUp;
+    private readonly _activate;
+    private readonly _onKey;
+    private _refreshState;
+    protected _onEnabledChanged(enabled: boolean): void;
+    protected _relayout(): void;
+    private _draw;
+    private _positionLabel;
+}
+//# sourceMappingURL=Button.d.ts.map

package/dist/esm/ui/Button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/ui/Button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAMtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID;;;;GAIG;AACH,qBAAa,MAAO,SAAQ,MAAM;IAChC,wEAAwE;IACxE,SAAgB,OAAO,mBAA0B;IAEjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAO;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,cAAc,CAAS;gBAEZ,OAAO,GAAE,aAAkB;IAiC9C,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAG7B;IAED,gFAAgF;IAChF,IAAW,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,EAAE,KAAK,CAAC,CAAC,CAExF;IAED,+BAA+B;IAC/B,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED,yBAAyB;IACzB,IAAW,SAAS,IAAI,KAAK,CAE5B;IAED,iCAAiC;IACjC,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG7B;IAEF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAG5B;IAEF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAK7B;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAE3B;IAEF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAIxB;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAUrB;IAEF,OAAO,CAAC,aAAa;cAaF,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;cAKzC,SAAS,IAAI,IAAI;IAKpC,OAAO,CAAC,KAAK;IAab,OAAO,CAAC,cAAc;CAKvB"}

package/dist/esm/ui/Button.js

@@ -0,0 +1,139 @@
+import { Color } from '../core/Color.js';
+import { Signal } from '../core/Signal.js';
+import { Keyboard } from '../input/types.js';
+import { Graphics } from '../rendering/primitives/Graphics.js';
+import { Text } from '../rendering/text/Text.js';
+import { Widget } from './Widget.js';
+
+/**
+ * Clickable button with a rounded background, a centered label, hover/pressed
+ * visual states, and keyboard activation (Enter / Space while focused).
+ * Listen to {@link Button.onClick} for activation.
+ */
+class Button extends Widget {
+    /** Fires when the button is activated by click, tap, or Enter/Space. */
+    onClick = new Signal();
+    _background = new Graphics();
+    _label;
+    _colors;
+    _cornerRadius;
+    _state = 'normal';
+    _pointerInside = false;
+    constructor(options = {}) {
+        super();
+        this._colors = {
+            normal: (options.color ?? new Color(54, 120, 220, 1)).clone(),
+            hover: (options.hoverColor ?? new Color(74, 140, 240, 1)).clone(),
+            pressed: (options.pressedColor ?? new Color(40, 96, 180, 1)).clone(),
+            disabled: (options.disabledColor ?? new Color(70, 76, 90, 1)).clone(),
+        };
+        this._cornerRadius = options.cornerRadius ?? 8;
+        this._label = new Text(options.label ?? '', {
+            fillColor: options.textColor ?? Color.white,
+            fontSize: options.fontSize ?? 16,
+            align: 'center',
+        });
+        this.addChild(this._background);
+        this.addChild(this._label);
+        this.interactive = true;
+        this.focusable = true;
+        this.cursor = 'pointer';
+        this.onPointerOver.add(this._onPointerOver);
+        this.onPointerOut.add(this._onPointerOut);
+        this.onPointerDown.add(this._onPointerDown);
+        this.onPointerUp.add(this._onPointerUp);
+        this.onPointerTap.add(this._activate);
+        this.onKeyDown.add(this._onKey);
+        this.setSize(options.width ?? 120, options.height ?? 40);
+    }
+    get label() {
+        return this._label.text;
+    }
+    set label(value) {
+        this._label.text = value;
+        this._positionLabel();
+    }
+    /** The per-state fill colours (`normal` / `hover` / `pressed` / `disabled`). */
+    get colors() {
+        return this._colors;
+    }
+    /** Corner radius in pixels. */
+    get cornerRadius() {
+        return this._cornerRadius;
+    }
+    /** Label fill colour. */
+    get textColor() {
+        return this._label.style.fillColor;
+    }
+    /** Label font size in pixels. */
+    get fontSize() {
+        return this._label.style.fontSize;
+    }
+    _onPointerOver = () => {
+        this._pointerInside = true;
+        this._refreshState();
+    };
+    _onPointerOut = () => {
+        this._pointerInside = false;
+        this._refreshState();
+    };
+    _onPointerDown = () => {
+        if (this.enabled) {
+            this._state = 'pressed';
+            this._draw();
+        }
+    };
+    _onPointerUp = () => {
+        this._refreshState();
+    };
+    _activate = () => {
+        if (this.enabled) {
+            this.onClick.dispatch(this);
+        }
+    };
+    _onKey = (event) => {
+        const channel = event.channel;
+        // `channel` is a generic numeric input channel (KeyEvent.channel is `number`),
+        // intentionally compared against the Keyboard enum constants — see KeyEvent docs.
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-enum-comparison
+        if (this.enabled && (channel === Keyboard.Enter || channel === Keyboard.Space)) {
+            event.preventDefault();
+            this.onClick.dispatch(this);
+        }
+    };
+    _refreshState() {
+        let state = 'normal';
+        if (!this.enabled) {
+            state = 'disabled';
+        }
+        else if (this._pointerInside) {
+            state = 'hover';
+        }
+        this._state = state;
+        this._draw();
+    }
+    _onEnabledChanged(enabled) {
+        this.interactive = enabled;
+        this._refreshState();
+    }
+    _relayout() {
+        this._draw();
+        this._positionLabel();
+    }
+    _draw() {
+        const g = this._background;
+        g.clear();
+        if (this._uiWidth <= 0 || this._uiHeight <= 0) {
+            return;
+        }
+        g.fillColor = this._colors[this._state];
+        g.drawRoundedRectangle(0, 0, this._uiWidth, this._uiHeight, this._cornerRadius);
+    }
+    _positionLabel() {
+        const bounds = this._label.getLocalBounds();
+        this._label.setPosition((this._uiWidth - bounds.width) / 2, (this._uiHeight - bounds.height) / 2);
+    }
+}
+
+export { Button };
+//# sourceMappingURL=Button.js.map

package/dist/esm/ui/Button.js.map

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

package/dist/esm/ui/Label.d.ts

@@ -0,0 +1,17 @@
+import { Text } from '#rendering/text/Text';
+import type { TextStyleOptions } from '#rendering/text/TextStyle';
+import { Widget } from './Widget';
+/**
+ * Text label widget. Wraps a {@link Text} node and keeps the widget's layout
+ * size in sync with the measured text, so it anchors and stacks correctly.
+ */
+export declare class Label extends Widget {
+    private readonly _text;
+    constructor(text?: string, style?: TextStyleOptions);
+    get text(): string;
+    set text(value: string);
+    /** The underlying {@link Text} node, for advanced styling. */
+    get textNode(): Text;
+    private _syncSize;
+}
+//# sourceMappingURL=Label.d.ts.map

package/dist/esm/ui/Label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Label.d.ts","sourceRoot":"","sources":["../../../src/ui/Label.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;GAGG;AACH,qBAAa,KAAM,SAAQ,MAAM;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAO;gBAEV,IAAI,SAAK,EAAE,KAAK,GAAE,gBAAqB;IAQ1D,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,IAAI,CAAC,KAAK,EAAE,MAAM,EAK5B;IAED,8DAA8D;IAC9D,IAAW,QAAQ,IAAI,IAAI,CAE1B;IAED,OAAO,CAAC,SAAS;CAKlB"}

package/dist/esm/ui/Label.js

@@ -0,0 +1,37 @@
+import { Color } from '../core/Color.js';
+import { Text } from '../rendering/text/Text.js';
+import { Widget } from './Widget.js';
+
+/**
+ * Text label widget. Wraps a {@link Text} node and keeps the widget's layout
+ * size in sync with the measured text, so it anchors and stacks correctly.
+ */
+class Label extends Widget {
+    _text;
+    constructor(text = '', style = {}) {
+        super();
+        this._text = new Text(text, { fillColor: Color.white, fontSize: 16, ...style });
+        this.addChild(this._text);
+        this._syncSize();
+    }
+    get text() {
+        return this._text.text;
+    }
+    set text(value) {
+        if (this._text.text !== value) {
+            this._text.text = value;
+            this._syncSize();
+        }
+    }
+    /** The underlying {@link Text} node, for advanced styling. */
+    get textNode() {
+        return this._text;
+    }
+    _syncSize() {
+        const bounds = this._text.getLocalBounds();
+        this.setSize(bounds.width, bounds.height);
+    }
+}
+
+export { Label };
+//# sourceMappingURL=Label.js.map

package/dist/esm/ui/Label.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Label.js","sources":["../../../../src/ui/Label.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAMA;;;AAGG;AACG,MAAO,KAAM,SAAQ,MAAM,CAAA;AACd,IAAA,KAAK;AAEtB,IAAA,WAAA,CAAmB,IAAI,GAAG,EAAE,EAAE,QAA0B,EAAE,EAAA;AACxD,QAAA,KAAK,EAAE;QAEP,IAAI,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC;AAC/E,QAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,SAAS,EAAE;IAClB;AAEA,IAAA,IAAW,IAAI,GAAA;AACb,QAAA,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI;IACxB;IAEA,IAAW,IAAI,CAAC,KAAa,EAAA;QAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE;AAC7B,YAAA,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK;YACvB,IAAI,CAAC,SAAS,EAAE;QAClB;IACF;;AAGA,IAAA,IAAW,QAAQ,GAAA;QACjB,OAAO,IAAI,CAAC,KAAK;IACnB;IAEQ,SAAS,GAAA;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE;QAE1C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;IAC3C;AACD;;;;"}

package/dist/esm/ui/Panel.d.ts

@@ -0,0 +1,38 @@
+import { Color } from '#core/Color';
+import { Graphics } from '#rendering/primitives/Graphics';
+import { Widget } from './Widget';
+export interface PanelOptions {
+    width?: number;
+    height?: number;
+    /** Fill color. Default: a translucent dark slate. */
+    color?: Color;
+    /** Border color (only drawn when `borderWidth > 0`). */
+    borderColor?: Color;
+    borderWidth?: number;
+    cornerRadius?: number;
+}
+/**
+ * Rectangular background container with rounded corners and an optional border.
+ * The base building block for HUD boxes, dialogs, and menus — add content with
+ * `panel.addChild(...)`.
+ */
+export declare class Panel extends Widget {
+    private readonly _background;
+    private readonly _color;
+    private readonly _borderColor;
+    private readonly _borderWidth;
+    private readonly _cornerRadius;
+    constructor(options?: PanelOptions);
+    /** The background {@link Graphics}, for advanced customization. */
+    get background(): Graphics;
+    /** Fill colour. */
+    get color(): Color;
+    /** Border colour (drawn only when {@link borderWidth} is greater than 0). */
+    get borderColor(): Color;
+    /** Border thickness in pixels. */
+    get borderWidth(): number;
+    /** Corner radius in pixels. */
+    get cornerRadius(): number;
+    protected _relayout(): void;
+}
+//# sourceMappingURL=Panel.d.ts.map

package/dist/esm/ui/Panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Panel.d.ts","sourceRoot":"","sources":["../../../src/ui/Panel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,wDAAwD;IACxD,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,KAAM,SAAQ,MAAM;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAEpB,OAAO,GAAE,YAAiB;IAY7C,mEAAmE;IACnE,IAAW,UAAU,IAAI,QAAQ,CAEhC;IAED,mBAAmB;IACnB,IAAW,KAAK,IAAI,KAAK,CAExB;IAED,6EAA6E;IAC7E,IAAW,WAAW,IAAI,KAAK,CAE9B;IAED,kCAAkC;IAClC,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,+BAA+B;IAC/B,IAAW,YAAY,IAAI,MAAM,CAEhC;cAEkB,SAAS,IAAI,IAAI;CAiBrC"}

package/dist/esm/ui/Panel.js

@@ -0,0 +1,61 @@
+import { Color } from '../core/Color.js';
+import { Graphics } from '../rendering/primitives/Graphics.js';
+import { Widget } from './Widget.js';
+
+/**
+ * Rectangular background container with rounded corners and an optional border.
+ * The base building block for HUD boxes, dialogs, and menus — add content with
+ * `panel.addChild(...)`.
+ */
+class Panel extends Widget {
+    _background = new Graphics();
+    _color;
+    _borderColor;
+    _borderWidth;
+    _cornerRadius;
+    constructor(options = {}) {
+        super();
+        this._color = (options.color ?? new Color(30, 34, 45, 0.92)).clone();
+        this._borderColor = (options.borderColor ?? new Color(255, 255, 255, 0.12)).clone();
+        this._borderWidth = options.borderWidth ?? 0;
+        this._cornerRadius = options.cornerRadius ?? 8;
+        this.addChild(this._background);
+        this.setSize(options.width ?? 0, options.height ?? 0);
+    }
+    /** The background {@link Graphics}, for advanced customization. */
+    get background() {
+        return this._background;
+    }
+    /** Fill colour. */
+    get color() {
+        return this._color;
+    }
+    /** Border colour (drawn only when {@link borderWidth} is greater than 0). */
+    get borderColor() {
+        return this._borderColor;
+    }
+    /** Border thickness in pixels. */
+    get borderWidth() {
+        return this._borderWidth;
+    }
+    /** Corner radius in pixels. */
+    get cornerRadius() {
+        return this._cornerRadius;
+    }
+    _relayout() {
+        const g = this._background;
+        g.clear();
+        if (this._uiWidth <= 0 || this._uiHeight <= 0) {
+            return;
+        }
+        if (this._borderWidth > 0) {
+            g.lineWidth = this._borderWidth;
+            g.lineColor = this._borderColor;
+        }
+        g.fillColor = this._color;
+        g.drawRoundedRectangle(0, 0, this._uiWidth, this._uiHeight, this._cornerRadius);
+    }
+}
+
+export { Panel };
+//# sourceMappingURL=Panel.js.map

package/dist/esm/ui/Panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Panel.js","sources":["../../../../src/ui/Panel.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAgBA;;;;AAIG;AACG,MAAO,KAAM,SAAQ,MAAM,CAAA;AACd,IAAA,WAAW,GAAG,IAAI,QAAQ,EAAE;AAC5B,IAAA,MAAM;AACN,IAAA,YAAY;AACZ,IAAA,YAAY;AACZ,IAAA,aAAa;AAE9B,IAAA,WAAA,CAAmB,UAAwB,EAAE,EAAA;AAC3C,QAAA,KAAK,EAAE;QAEP,IAAI,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE;QACpE,IAAI,CAAC,YAAY,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE;QACnF,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC;QAC5C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC;AAE9C,QAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC;AAC/B,QAAA,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IACvD;;AAGA,IAAA,IAAW,UAAU,GAAA;QACnB,OAAO,IAAI,CAAC,WAAW;IACzB;;AAGA,IAAA,IAAW,KAAK,GAAA;QACd,OAAO,IAAI,CAAC,MAAM;IACpB;;AAGA,IAAA,IAAW,WAAW,GAAA;QACpB,OAAO,IAAI,CAAC,YAAY;IAC1B;;AAGA,IAAA,IAAW,WAAW,GAAA;QACpB,OAAO,IAAI,CAAC,YAAY;IAC1B;;AAGA,IAAA,IAAW,YAAY,GAAA;QACrB,OAAO,IAAI,CAAC,aAAa;IAC3B;IAEmB,SAAS,GAAA;AAC1B,QAAA,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW;QAE1B,CAAC,CAAC,KAAK,EAAE;AAET,QAAA,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE;YAC7C;QACF;AAEA,QAAA,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE;AACzB,YAAA,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,YAAY;AAC/B,YAAA,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,YAAY;QACjC;AAEA,QAAA,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM;AACzB,QAAA,CAAC,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC;IACjF;AACD;;;;"}

package/dist/esm/ui/ProgressBar.d.ts

@@ -0,0 +1,37 @@
+import { Color } from '#core/Color';
+import { Widget } from './Widget';
+export interface ProgressBarOptions {
+    width?: number;
+    height?: number;
+    /** Initial fill fraction in `[0, 1]`. */
+    value?: number;
+    trackColor?: Color;
+    fillColor?: Color;
+    cornerRadius?: number;
+}
+/**
+ * Horizontal progress / health bar. {@link ProgressBar.value} is the fill
+ * fraction in `[0, 1]`; setting it redraws only the fill.
+ */
+export declare class ProgressBar extends Widget {
+    private readonly _track;
+    private readonly _fill;
+    private readonly _trackColor;
+    private readonly _fillColor;
+    private readonly _cornerRadius;
+    private _value;
+    constructor(options?: ProgressBarOptions);
+    /** Fill fraction in `[0, 1]`. */
+    get value(): number;
+    set value(value: number);
+    /** Track (background) colour. */
+    get trackColor(): Color;
+    /** Fill (foreground) colour. */
+    get fillColor(): Color;
+    /** Corner radius in pixels. */
+    get cornerRadius(): number;
+    protected _relayout(): void;
+    private _drawTrack;
+    private _drawFill;
+}
+//# sourceMappingURL=ProgressBar.d.ts.map

package/dist/esm/ui/ProgressBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressBar.d.ts","sourceRoot":"","sources":["../../../src/ui/ProgressBar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIpC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,MAAM;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,MAAM,CAAS;gBAEJ,OAAO,GAAE,kBAAuB;IAanD,iCAAiC;IACjC,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAO7B;IAED,iCAAiC;IACjC,IAAW,UAAU,IAAI,KAAK,CAE7B;IAED,gCAAgC;IAChC,IAAW,SAAS,IAAI,KAAK,CAE5B;IAED,+BAA+B;IAC/B,IAAW,YAAY,IAAI,MAAM,CAEhC;cAEkB,SAAS,IAAI,IAAI;IAKpC,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,SAAS;CAclB"}

package/dist/esm/ui/ProgressBar.js

@@ -0,0 +1,76 @@
+import { Color } from '../core/Color.js';
+import { clamp } from '../math/utils.js';
+import { Graphics } from '../rendering/primitives/Graphics.js';
+import { Widget } from './Widget.js';
+
+/**
+ * Horizontal progress / health bar. {@link ProgressBar.value} is the fill
+ * fraction in `[0, 1]`; setting it redraws only the fill.
+ */
+class ProgressBar extends Widget {
+    _track = new Graphics();
+    _fill = new Graphics();
+    _trackColor;
+    _fillColor;
+    _cornerRadius;
+    _value;
+    constructor(options = {}) {
+        super();
+        this._value = clamp(options.value ?? 0, 0, 1);
+        this._trackColor = (options.trackColor ?? new Color(255, 255, 255, 0.16)).clone();
+        this._fillColor = (options.fillColor ?? new Color(80, 220, 120, 1)).clone();
+        this._cornerRadius = options.cornerRadius ?? 4;
+        this.addChild(this._track);
+        this.addChild(this._fill);
+        this.setSize(options.width ?? 200, options.height ?? 12);
+    }
+    /** Fill fraction in `[0, 1]`. */
+    get value() {
+        return this._value;
+    }
+    set value(value) {
+        const next = clamp(value, 0, 1);
+        if (this._value !== next) {
+            this._value = next;
+            this._drawFill();
+        }
+    }
+    /** Track (background) colour. */
+    get trackColor() {
+        return this._trackColor;
+    }
+    /** Fill (foreground) colour. */
+    get fillColor() {
+        return this._fillColor;
+    }
+    /** Corner radius in pixels. */
+    get cornerRadius() {
+        return this._cornerRadius;
+    }
+    _relayout() {
+        this._drawTrack();
+        this._drawFill();
+    }
+    _drawTrack() {
+        const g = this._track;
+        g.clear();
+        if (this._uiWidth <= 0 || this._uiHeight <= 0) {
+            return;
+        }
+        g.fillColor = this._trackColor;
+        g.drawRoundedRectangle(0, 0, this._uiWidth, this._uiHeight, this._cornerRadius);
+    }
+    _drawFill() {
+        const g = this._fill;
+        g.clear();
+        const width = this._uiWidth * this._value;
+        if (width <= 0 || this._uiHeight <= 0) {
+            return;
+        }
+        g.fillColor = this._fillColor;
+        g.drawRoundedRectangle(0, 0, width, this._uiHeight, Math.min(this._cornerRadius, width / 2));
+    }
+}
+
+export { ProgressBar };
+//# sourceMappingURL=ProgressBar.js.map

package/dist/esm/ui/ProgressBar.js.map

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

package/dist/esm/ui/ScrollContainer.d.ts

@@ -0,0 +1,63 @@
+import type { Stage } from '#core/Stage';
+import { Container } from '#rendering/Container';
+import { Widget } from './Widget';
+/** Direction(s) in which a {@link ScrollContainer} can scroll. */
+export type ScrollDirection = 'vertical' | 'horizontal' | 'both';
+/** Options for {@link ScrollContainer}. */
+export interface ScrollContainerOptions {
+    /** Visible width in pixels. */
+    width: number;
+    /** Visible height in pixels. */
+    height: number;
+    /** Scroll axis. Default `'vertical'`. */
+    direction?: ScrollDirection;
+}
+/**
+ * Clipped container that scrolls its content via the mouse wheel.
+ *
+ * Add child nodes to {@link ScrollContainer.content} rather than to the
+ * `ScrollContainer` itself. The content container is offset as the user scrolls,
+ * while the outer widget is clipped to its declared `width` × `height`.
+ *
+ * Mouse-wheel events from the global {@link InputManager} are consumed only
+ * when the pointer is within the widget's bounds. The container subscribes to
+ * the app's `onMouseWheel` signal when it enters the scene tree, and
+ * unsubscribes on detach.
+ *
+ * @example
+ * ```ts
+ * const scroll = new ScrollContainer({ width: 300, height: 400 });
+ * for (let i = 0; i < 20; i++) {
+ *   scroll.content.addChild(new Label(`Item ${i}`).setPosition(0, i * 30));
+ * }
+ * scene.ui.addChild(scroll);
+ * ```
+ */
+export declare class ScrollContainer extends Widget {
+    /** Add children here — not to the `ScrollContainer` itself. */
+    readonly content: Container;
+    private readonly _direction;
+    private _scrollX;
+    private _scrollY;
+    private readonly _onWheel;
+    constructor(options: ScrollContainerOptions);
+    /** Current horizontal scroll position in pixels. */
+    get scrollX(): number;
+    /** Current vertical scroll position in pixels. */
+    get scrollY(): number;
+    /**
+     * Scroll by `(dx, dy)` pixels, clamped to the scrollable content range.
+     * Positive values scroll right / down; negative values scroll left / up.
+     */
+    scrollBy(dx: number, dy: number): void;
+    /**
+     * Scroll to an absolute `(x, y)` position in pixels, clamped to the
+     * content range so the content never scrolls past its edges.
+     */
+    scrollTo(x: number, y: number): void;
+    protected _relayout(): void;
+    /** @internal — subscribe to the app's wheel signal when entering the scene tree. */
+    _setStage(stage: Stage | null): void;
+    destroy(): void;
+}
+//# sourceMappingURL=ScrollContainer.d.ts.map

package/dist/esm/ui/ScrollContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollContainer.d.ts","sourceRoot":"","sources":["../../../src/ui/ScrollContainer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;AAEjE,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,eAAgB,SAAQ,MAAM;IACzC,+DAA+D;IAC/D,SAAgB,OAAO,EAAE,SAAS,CAAC;IAEnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAK;IAErB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAcvB;gBAEiB,OAAO,EAAE,sBAAsB;IAYlD,oDAAoD;IACpD,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,kDAAkD;IAClD,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED;;;OAGG;IACI,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAI7C;;;OAGG;IACI,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;cAYxB,SAAS,IAAI,IAAI;IAKpC,oFAAoF;IACpE,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI;IAYpC,OAAO,IAAI,IAAI;CAIhC"}