@datamoc/mw_games 0.42.0 → 0.44.2

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

@@ -1,4 +1,4 @@
-import { Container, Graphics } from 'pixi.js';
+import { Container, Graphics, Rectangle } from 'pixi.js';
 import { Signal } from '../../core/Signal.js';
 import { theme, themeChanged } from './theme.js';
 /**
@@ -16,10 +16,90 @@ import { theme, themeChanged } from './theme.js';
 export function scrollOffset(offset, contentSize, viewportSize) {
     return Math.max(0, Math.min(Math.max(0, contentSize - viewportSize), offset));
 }
+/**
+ * Touch scrolling as plain numbers: feed it pointer positions and it says how far the content moves
+ * while the finger is down, then keeps coasting after release with a friction that decays the speed.
+ * No pointer events or clock of its own, so it is the same under a test as under a finger.
+ *
+ * @example
+ * ```ts
+ * import { ScrollDrag } from '@datamoc/mw_games/two-d/ui';
+ *
+ * const drag = new ScrollDrag();
+ * drag.start(200, 0);
+ * console.log(drag.move(170, 0.1)); // 30: the content follows the finger up
+ * drag.end();
+ * console.log(drag.step(1 / 60) > 0); // true: it keeps coasting
+ * ```
+ */
+export class ScrollDrag {
+    /**
+     * @param friction fraction of the speed lost per second of coasting; 0.92 when omitted
+     * @param minSpeed the speed, in pixels per second, below which it counts as at rest; 8 when omitted
+     */
+    constructor(friction = 0.92, minSpeed = 8) {
+        /** content pixels per second the content keeps moving at after release; 0 when at rest */
+        this.velocity = 0;
+        this.dragging = false;
+        /** how far the pointer has travelled since `start`, to tell a drag from a tap */
+        this.travelled = 0;
+        this.lastY = 0;
+        this.lastTime = 0;
+        this.friction = friction;
+        this.minSpeed = minSpeed;
+    }
+    start(y, time) {
+        this.dragging = true;
+        this.velocity = 0;
+        this.travelled = 0;
+        this.lastY = y;
+        this.lastTime = time;
+    }
+    /** @returns how far the content should move for this pointer position */
+    move(y, time) {
+        if (!this.dragging)
+            return 0;
+        const delta = this.lastY - y;
+        const dt = time - this.lastTime;
+        if (dt > 0)
+            this.velocity = this.velocity * 0.4 + (delta / dt) * 0.6;
+        this.travelled += Math.abs(delta);
+        this.lastY = y;
+        this.lastTime = time;
+        return delta;
+    }
+    end() {
+        this.dragging = false;
+        if (Math.abs(this.velocity) < this.minSpeed)
+            this.velocity = 0;
+    }
+    /** @returns how far the content coasts in `dt` seconds, 0 once it has stopped */
+    step(dt) {
+        if (this.dragging || this.velocity === 0)
+            return 0;
+        const delta = this.velocity * dt;
+        this.velocity *= (1 - this.friction) ** dt;
+        if (Math.abs(this.velocity) < this.minSpeed)
+            this.velocity = 0;
+        return delta;
+    }
+    /** stops coasting, for when the content hit an end */
+    stop() {
+        this.velocity = 0;
+    }
+}
 /**
  * A clipped viewport with a scrollbar: put rows in `content` and they scroll inside the box,
  * everything outside it hidden by a mask. The scrollbar is drawn from the theme; the wheel,
  * `scrollBy` and `scrollIntoView` all run through `scrollOffset`, so they clamp the same way.
+ * The box owns its `hitArea` (its viewport, kept current by `resize` and `setContentHeight`),
+ * so a wheel over the empty part of the viewport reaches it instead of needing a row under
+ * the pointer to bubble from.
+ *
+ * `touch: true` lets a finger drag the content (a drag ends the tap on the rows under it) and coast
+ * on release, `keyboard: true` makes `handleKey` scroll by line, page and to the ends, the scrollbar's
+ * thumb can be dragged and its track clicked, and `autoHeight` sizes the viewport to the content up
+ * to `height`. Call `update(dt)` each frame for the coasting.
  *
  * @example
  * ```ts
@@ -36,16 +116,23 @@ export class ScrollBox extends Container {
         this.onChange = new Signal();
         /** add the rows to scroll here */
         this.content = new Container();
+        this.hit = new Rectangle(0, 0, 0, 0);
         this.maskShape = new Graphics();
         this.track = new Graphics();
         this.thumb = new Graphics();
+        this.dragMoved = false;
+        this.thumbGrab = null;
         this.themeListener = () => this.draw();
         this.handleWheel = (event) => {
             this.scrollBy(event.deltaY);
         };
         this.width_ = options.width;
-        this.height_ = options.height;
+        this.maxHeight_ = options.height;
+        this.auto = options.autoHeight ?? false;
+        this.lineHeight = options.lineHeight ?? 24;
+        this.drag = options.touch ? new ScrollDrag() : null;
         this.contentHeight_ = Math.max(0, options.contentHeight ?? 0);
+        this.height_ = this.fit();
         this.offset_ = scrollOffset(options.offset ?? 0, this.contentHeight_, this.height_);
         this.addChild(this.content);
         this.addChild(this.maskShape);
@@ -54,6 +141,30 @@ export class ScrollBox extends Container {
         this.content.mask = this.maskShape;
         this.eventMode = 'static';
         this.on('wheel', this.handleWheel);
+        if (this.drag) {
+            this.on('pointerdown', (event) => this.dragStart(event.global.y, performance.now() / 1000));
+            this.on('globalpointermove', (event) => this.dragMove(event.global.y, performance.now() / 1000));
+            this.on('pointerup', () => this.dragEnd());
+            this.on('pointerupoutside', () => this.dragEnd());
+            //a drag that ended over a row is not a click on that row
+            this.on('pointerupcapture', (event) => {
+                if (this.dragMoved)
+                    event.stopPropagation();
+            });
+        }
+        this.track.eventMode = 'static';
+        this.thumb.eventMode = 'static';
+        this.thumb.on('pointerdown', (event) => {
+            event.stopPropagation();
+            this.thumbDragStart(event.global.y);
+        });
+        this.thumb.on('globalpointermove', (event) => this.thumbDragMove(event.global.y));
+        this.thumb.on('pointerup', () => (this.thumbGrab = null));
+        this.thumb.on('pointerupoutside', () => (this.thumbGrab = null));
+        this.track.on('pointerdown', (event) => {
+            event.stopPropagation();
+            this.scrollToThumbCentre(this.toLocal(event.global).y);
+        });
         this.draw();
         themeChanged.add(this.themeListener);
     }
@@ -63,9 +174,17 @@ export class ScrollBox extends Container {
     get contentHeight() {
         return this.contentHeight_;
     }
+    /** the viewport's width, the other half of the box's `hitArea` */
+    get viewportWidth() {
+        return this.width_;
+    }
     get viewportHeight() {
         return this.height_;
     }
+    /** the viewport's height: the content's, capped at the maximum, when `autoHeight` is on */
+    fit() {
+        return this.auto ? Math.min(this.maxHeight_, this.contentHeight_) : this.maxHeight_;
+    }
     /** how far the content can scroll; 0 when it all fits */
     get maxOffset() {
         return Math.max(0, this.contentHeight_ - this.height_);
@@ -75,11 +194,13 @@ export class ScrollBox extends Container {
     }
     setContentHeight(height) {
         this.contentHeight_ = Math.max(0, height);
+        this.height_ = this.fit();
         this.setOffset(scrollOffset(this.offset_, this.contentHeight_, this.height_));
     }
     resize(width, height) {
         this.width_ = width;
-        this.height_ = height;
+        this.maxHeight_ = height;
+        this.height_ = this.fit();
         this.setOffset(scrollOffset(this.offset_, this.contentHeight_, this.height_));
     }
     scrollBy(delta) {
@@ -95,6 +216,96 @@ export class ScrollBox extends Container {
         else if (top + height > this.offset_ + this.height_)
             this.scrollTo(top + height - this.height_);
     }
+    /**
+     * Scrolls for a key a keyboard-driven list was handed (`KeyboardEvent.key`).
+     *
+     * @returns true when the key is one this box scrolls by, so a caller can stop it going further
+     */
+    handleKey(key) {
+        const page = Math.max(this.lineHeight, this.height_ - this.lineHeight);
+        switch (key) {
+            case 'ArrowUp':
+                this.scrollBy(-this.lineHeight);
+                return true;
+            case 'ArrowDown':
+                this.scrollBy(this.lineHeight);
+                return true;
+            case 'PageUp':
+                this.scrollBy(-page);
+                return true;
+            case 'PageDown':
+                this.scrollBy(page);
+                return true;
+            case 'Home':
+                this.scrollTo(0);
+                return true;
+            case 'End':
+                this.scrollTo(this.maxOffset);
+                return true;
+            default:
+                return false;
+        }
+    }
+    /** a finger or button went down at `y` (any one coordinate space, `time` in seconds) */
+    dragStart(y, time) {
+        this.drag?.start(y, time);
+        this.dragMoved = false;
+    }
+    /** the pointer moved while down; the content follows once it has travelled a few pixels */
+    dragMove(y, time) {
+        const drag = this.drag;
+        if (!drag?.dragging)
+            return;
+        const delta = drag.move(y, time);
+        if (!this.dragMoved && drag.travelled < 6)
+            return;
+        this.dragMoved = true;
+        this.scrollBy(delta);
+    }
+    dragEnd() {
+        this.drag?.end();
+    }
+    /** true once the pointer travelled far enough to count as a drag rather than a tap */
+    get dragged() {
+        return this.dragMoved;
+    }
+    /** advances touch coasting; call once a frame from the owning scene's `update` */
+    update(dt) {
+        const drag = this.drag;
+        if (!drag)
+            return;
+        const before = this.offset_;
+        this.scrollBy(drag.step(dt));
+        if (this.offset_ === before && drag.velocity !== 0)
+            drag.stop();
+    }
+    /** where the scrollbar's thumb sits and how tall it is, in the box's own space */
+    get thumbMetrics() {
+        const barWidth = 6;
+        const height = Math.max(barWidth, (this.height_ / Math.max(1, this.contentHeight_)) * this.height_);
+        const y = this.maxOffset === 0 ? 0 : (this.offset_ / this.maxOffset) * (this.height_ - height);
+        return { y, height };
+    }
+    /** the thumb was grabbed at `y` */
+    thumbDragStart(y) {
+        this.thumbGrab = { y, offset: this.offset_ };
+    }
+    /** the thumb moved to `y`: the offset follows in proportion to the thumb's travel */
+    thumbDragMove(y) {
+        if (!this.thumbGrab)
+            return;
+        const travel = this.height_ - this.thumbMetrics.height;
+        if (travel <= 0)
+            return;
+        this.scrollTo(this.thumbGrab.offset + ((y - this.thumbGrab.y) / travel) * this.maxOffset);
+    }
+    /** a click on the track at local `y` puts the thumb's centre there */
+    scrollToThumbCentre(y) {
+        const travel = this.height_ - this.thumbMetrics.height;
+        if (travel <= 0)
+            return;
+        this.scrollTo(((y - this.thumbMetrics.height / 2) / travel) * this.maxOffset);
+    }
     setOffset(offset) {
         if (offset === this.offset_) {
             this.draw();
@@ -105,6 +316,9 @@ export class ScrollBox extends Container {
         this.onChange.dispatch(offset);
     }
     draw() {
+        this.hit.width = this.width_;
+        this.hit.height = this.height_;
+        this.hitArea = this.hit;
         const t = theme();
         this.content.y = -this.offset_;
         this.maskShape.clear().rect(0, 0, this.width_, this.height_).fill({ color: 0xffffff });
@@ -115,8 +329,7 @@ export class ScrollBox extends Container {
         const barWidth = 6;
         const x = this.width_ - barWidth;
         this.track.roundRect(x, 0, barWidth, this.height_, barWidth / 2).fill({ color: t.color.panelFill });
-        const thumbHeight = Math.max(barWidth, (this.height_ / this.contentHeight_) * this.height_);
-        const thumbY = (this.offset_ / this.maxOffset) * (this.height_ - thumbHeight);
+        const { y: thumbY, height: thumbHeight } = this.thumbMetrics;
         this.thumb.roundRect(x, thumbY, barWidth, thumbHeight, barWidth / 2).fill({ color: t.color.textHighlight });
     }
     destroy(options) {

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

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

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

@@ -0,0 +1,131 @@
+import { Container } from 'pixi.js';
+import { type LabelOptions } from './Label.ts';
+import { ScrollBox } from './ScrollBox.ts';
+/**
+ * `text` cut to fit `maxWidth`, ending in `ellipsis`, as measured by `measure` (the width of a string
+ * in whatever font the caller draws it with). A text that already fits comes back unchanged.
+ *
+ * @example
+ * ```ts
+ * import { ellipsize } from '@datamoc/mw_games/two-d/ui';
+ *
+ * const width = (text: string) => text.length * 10;
+ * console.log(ellipsize('3. Le Fleuve profond (verrouillé)', 150, width)); // 3. Le Fleuve…
+ * ```
+ */
+export declare function ellipsize(text: string, maxWidth: number, measure: (text: string) => number, ellipsis?: string): string;
+/**
+ * `text` wrapped at `maxWidth` and cut to `maxLines`, the last kept line ending in an ellipsis when
+ * something was dropped. Words are not split unless one alone is wider than a line.
+ *
+ * @example
+ * ```ts
+ * import { truncateLines } from '@datamoc/mw_games/two-d/ui';
+ *
+ * const width = (text: string) => text.length * 10;
+ * console.log(truncateLines('build a bridge across the river gorge', 120, 2, width));
+ * // ['build a', 'bridge acr…']
+ * ```
+ */
+export declare function truncateLines(text: string, maxWidth: number, maxLines: number, measure: (text: string) => number, ellipsis?: string): string[];
+/**
+ * How far a line of `textWidth` is shifted to scroll inside `boxWidth`, `time` seconds in: it waits
+ * `pause` seconds, slides to its end at `speed` px/s, waits again, then slides back, over and over.
+ * A text that fits never moves.
+ *
+ * @example
+ * ```ts
+ * import { marqueeOffset } from '@datamoc/mw_games/two-d/ui';
+ *
+ * console.log(marqueeOffset(300, 200, 0)); // 0, waiting at the start
+ * console.log(marqueeOffset(300, 200, 3)); // 100, at the far end
+ * console.log(marqueeOffset(150, 200, 3)); // 0, it fits
+ * ```
+ */
+export declare function marqueeOffset(textWidth: number, boxWidth: number, time: number, speed?: number, pause?: number): number;
+export interface ScrollTextOptions {
+    width: number;
+    /** the tallest the box grows before the text scrolls instead */
+    maxHeight: number;
+    text?: string;
+    label?: Omit<LabelOptions, 'text' | 'wrapWidth'>;
+    /** a finger drag scrolls the text; true when omitted */
+    touch?: boolean;
+}
+/**
+ * A wrapped `Label` in a `ScrollBox` that sizes itself: the box is as tall as the text up to
+ * `maxHeight`, and scrolls (wheel, touch, keys, scrollbar) beyond it, so a long hint, credit list or
+ * result message never spills over what is around it. `setText` re-measures and `resize(width)`
+ * re-wraps in place; the caller no longer measures the label and feeds `setContentHeight` by hand.
+ *
+ * @example
+ * ```ts
+ * import { ScrollText } from '@datamoc/mw_games/two-d/ui';
+ *
+ * const hint = new ScrollText({ width: 220, maxHeight: 60 });
+ * hint.setText('Span the gorge with at most 400 of budget. Cables only pull; beams push as well.');
+ * console.log(hint.box.viewportHeight <= 60); // true
+ * ```
+ */
+export declare class ScrollText extends Container {
+    readonly box: ScrollBox;
+    private readonly body;
+    private readonly maxHeight;
+    private width_;
+    constructor(options: ScrollTextOptions);
+    /** the text's own height, which sizes the box; its own method so a test can supply it */
+    protected measureHeight(): number;
+    private measure;
+    /** the current width, what `resize` last set it to */
+    get viewWidth(): number;
+    /**
+     * Sets the width in place: the text re-wraps at the new width and the box resizes and
+     * re-measures, so a layout change does not rebuild the widget.
+     */
+    resize(width: number): void;
+    setText(text: string): void;
+    /** call each frame for touch coasting */
+    update(dt: number): void;
+}
+export interface MarqueeLabelOptions {
+    width: number;
+    text?: string;
+    label?: Omit<LabelOptions, 'text'>;
+    /** pixels per second; 40 when omitted */
+    speed?: number;
+    /** seconds it waits at each end; 1 when omitted */
+    pause?: number;
+}
+/**
+ * One line of text that stays on one line: when it is wider than `width` it slides back and forth
+ * inside a clipped window (`marqueeOffset`), driven by `update(dt)`. Under reduced motion it holds
+ * still, cut short with an ellipsis, instead of moving.
+ *
+ * @example
+ * ```ts
+ * import { MarqueeLabel } from '@datamoc/mw_games/two-d/ui';
+ *
+ * const title = new MarqueeLabel({ width: 160, text: 'A very long track title that cannot fit' });
+ * title.update(1 / 60); // once a frame from the scene
+ * ```
+ */
+export declare class MarqueeLabel extends Container {
+    private readonly body;
+    private readonly clip;
+    private readonly speed;
+    private readonly pause;
+    private readonly width_;
+    private readonly labelOptions;
+    private source;
+    private fullWidth;
+    private time;
+    constructor(options: MarqueeLabelOptions);
+    /** the text's width in pixels; its own method so a test can supply it */
+    protected measureWidth(text: string): number;
+    setText(text: string): void;
+    private apply;
+    /** where the text is shifted to now (0 until it has waited out its first pause) */
+    get shift(): number;
+    update(dt: number): void;
+}
+//# sourceMappingURL=ScrollText.d.ts.map

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

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