@datamoc/mw_games 0.44.2 → 0.45.0

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

@@ -1,311 +0,0 @@
-import { Container, Graphics, Rectangle } from 'pixi.js';
-import { Signal } from '../../core/Signal.js';
-import { reducedMotion } from '../../core/Motion.js';
-import { openAnimationFrame } from '../render/SceneTransition.js';
-import { NinePatch } from './NinePatch.js';
-import { Label } from './Label.js';
-import { theme, themeChanged } from './theme.js';
-import { screenReader } from './a11y.js';
-/**
- * A panel with a frame, a title and a content area.
- *
- * Windows are the interface: inventory, dialogue, character sheets, confirmations. They
- * live in a `WindowStack`, which decides which one has the keyboard.
- *
- * Contents go in `content`, whose origin is already inset past the frame and padding, so a
- * child placed at 0,0 sits correctly whatever the theme's border is.
- *
- * The window's own area is not clickable: the frame, the title and any part of the body with
- * no widget in it let a click travel to whatever is underneath, so a window over a map is not
- * by itself a wall. `blocker` is the option that makes one, and it is what a window that has
- * to be answered should set.
- *
- * @example
- * ```ts
- * import { Window, Label } from '@datamoc/mw_games/two-d/ui';
- *
- * const confirm = new Window({ width: 200, height: 100, title: 'Leave?', anchor: 'center', blocker: true });
- * confirm.content.addChild(new Label({ text: 'Progress since your last save will be lost.' }));
- * confirm.onClose.add(() => console.log('window closed'));
- *
- * confirm.place(800, 600); // centres it in an 800x600 viewport
- * confirm.handleAction('cancel'); // closable defaults to true, so this closes it
- * ```
- */
-export class Window extends Container {
-    constructor(options) {
-        super();
-        this.content = new Container();
-        this.onClose = new Signal();
-        this.titleLabel = null;
-        this.closeMark = null;
-        this.innerWidth = 0;
-        this.innerHeight = 0;
-        this.currentWidth = 0;
-        this.currentHeight = 0;
-        /** the full-viewport click layer, first child so every widget of the window sits above it */
-        this.blocker = null;
-        this.themeListener = () => this.restyle();
-        this.isClosed = false;
-        this.motion = null;
-        /**
-         * A widget offered actions before the window itself sees them.
-         *
-         * Set it to the list or field the window exists to show. Without it, every window
-         * holding a widget has to override `handleAction` just to forward, which is noise at
-         * best and, done by assigning over the method, a trap.
-         */
-        this.delegate = null;
-        this.onBlockerDown = (event) => {
-            //a blocker means the click stops here: what is under the window never hears about it
-            event.stopPropagation();
-            const at = event.getLocalPosition(this);
-            this.handleOutsideClick(at.x, at.y);
-        };
-        const t = theme();
-        this.colors = { ...options.colors };
-        this.modal = options.modal ?? true;
-        this.closable = options.closable ?? true;
-        this.dims = options.dims ?? this.modal;
-        this.anchor = options.anchor ?? 'center';
-        if (options.blocker === true) {
-            //a plain container draws nothing and is not hit-tested at all without a hitArea,
-            //which is exactly the shape wanted: a click catcher with no appearance
-            this.blocker = new Container();
-            this.blocker.eventMode = 'static';
-            this.blocker.on('pointerdown', this.onBlockerDown);
-            this.addChild(this.blocker);
-        }
-        if (t.panel) {
-            this.background = new NinePatch(t.panel, { border: t.panelBorder });
-        }
-        else {
-            //no panel texture: a flat rounded rectangle, so a game is usable before it has
-            //any interface art at all
-            this.background = new Graphics();
-        }
-        this.addChild(this.background);
-        if (options.title !== undefined) {
-            this.titleLabel = new Label({
-                text: options.title,
-                color: this.colors.title ?? t.color.textHighlight,
-                bold: true,
-            });
-            this.addChild(this.titleLabel);
-            //the canvas is opaque to assistive technology, so a windowed screen announces its title
-            screenReader.announce(options.title);
-        }
-        if (options.closeButton === true && this.closable) {
-            this.closeMark = new Label({ text: '✕', color: this.colors.title ?? t.color.textHighlight, bold: true });
-            this.closeMark.eventMode = 'static';
-            this.closeMark.cursor = 'pointer';
-            this.closeMark.on('pointertap', () => this.close());
-            this.addChild(this.closeMark);
-        }
-        this.addChild(this.content);
-        this.resize(options.width, options.height);
-        themeChanged.add(this.themeListener);
-    }
-    /** reapplies the current theme to the frame and title, without changing size or content */
-    restyle() {
-        this.titleLabel?.setColor(this.colors.title ?? theme().color.textHighlight);
-        this.closeMark?.setColor(this.colors.title ?? theme().color.textHighlight);
-        this.resize(this.currentWidth, this.currentHeight);
-    }
-    resize(width, height) {
-        this.currentWidth = width;
-        this.currentHeight = height;
-        const t = theme();
-        const border = this.background instanceof NinePatch ? this.background.border.left : 2;
-        const inset = border + t.padding;
-        if (this.background instanceof NinePatch) {
-            this.background.resize(width, height);
-            this.background.tint = this.colors.background ?? 0xffffff;
-        }
-        else {
-            this.background
-                .clear()
-                .roundRect(0, 0, width, height, 4)
-                .fill({ color: this.colors.background ?? t.color.panelFill })
-                .stroke({ color: this.colors.border ?? t.color.panelBorder, width: 1 });
-        }
-        if (this.closeMark) {
-            this.closeMark.x = t.direction === 'rtl' ? inset : width - inset - this.closeMark.width;
-            this.closeMark.y = inset;
-        }
-        let contentTop = inset;
-        if (this.titleLabel) {
-            this.titleLabel.x = t.direction === 'rtl' ? width - inset - this.titleLabel.width : inset;
-            this.titleLabel.y = inset;
-            contentTop = inset + this.titleLabel.height + t.padding;
-        }
-        this.content.x = inset;
-        this.content.y = contentTop;
-        this.innerWidth = Math.max(0, width - inset * 2);
-        this.innerHeight = Math.max(0, height - contentTop - inset);
-    }
-    /** the space available inside the frame, which is what contents should lay out against */
-    get contentWidth() {
-        return this.innerWidth;
-    }
-    get contentHeight() {
-        return this.innerHeight;
-    }
-    setTitle(text) {
-        this.titleLabel?.setText(text);
-    }
-    /** Replaces this window's palette without changing its contents or lifecycle. */
-    setColors(colors) {
-        this.colors = { ...colors };
-        this.restyle();
-    }
-    /**
-     * Offered every action while this window is on top of the stack.
-     *
-     * @returns true if the window used it, which stops it going any further down
-     */
-    handleAction(action) {
-        if (this.isClosed)
-            return false;
-        if (this.delegate?.handleAction(action))
-            return true;
-        if (action === 'cancel' && this.closable) {
-            this.close();
-            return true;
-        }
-        return false;
-    }
-    /**
-     * true once `close()` (or `destroy()`) has run. A closed window is spent: `close()` freed it
-     * and its contents through Pixi, so the caller's `this.someWindow` reference must not be
-     * written to any more. Guard with this rather than discovering it as a null-internal throw,
-     * and drop the reference.
-     */
-    get closed() {
-        return this.isClosed;
-    }
-    /** called each frame while this window is the top of the stack */
-    update(dt) {
-        const motion = this.motion;
-        if (!motion)
-            return;
-        motion.elapsed += dt;
-        const duration = motion.options.duration ?? 0.25;
-        const progress = Math.min(1, motion.elapsed / duration);
-        this.applyMotion(motion.closing ? 1 - progress : progress, motion);
-        if (progress < 1)
-            return;
-        this.motion = null;
-        if (motion.closing)
-            this.close();
-        else
-            this.applyMotion(1, motion);
-    }
-    /** puts the window at `progress` of its animation: scaled about the origin, faded, pushed down by a slide */
-    applyMotion(progress, motion) {
-        const frame = openAnimationFrame(motion.options.animation, progress, motion.closing);
-        const origin = motion.options.from ?? {
-            x: motion.base.x + this.currentWidth / 2,
-            y: motion.base.y + this.currentHeight / 2,
-        };
-        this.scale.set(frame.scale);
-        this.alpha = frame.alpha;
-        this.position.set(origin.x + (motion.base.x - origin.x) * frame.scale, origin.y + (motion.base.y - origin.y) * frame.scale + frame.offset);
-    }
-    /**
-     * Plays the opening animation from the window's current position. The stack calls `update(dt)`
-     * on its top window, which drives it. Under reduced motion the window simply appears.
-     *
-     * @example
-     * ```ts
-     * import { Window } from '@datamoc/mw_games/two-d/ui';
-     *
-     * const window = new Window({ width: 240, height: 120, title: 'Result' });
-     * window.open({ animation: 'pop' });
-     * window.update(0.25); // normally the WindowStack's update does this
-     * console.log(window.scale.x); // 1
-     * ```
-     */
-    open(animation) {
-        if (!animation || reducedMotion() || this.isClosed)
-            return;
-        this.motion = { options: animation, elapsed: 0, closing: false, base: { x: this.x, y: this.y } };
-        this.applyMotion(0, this.motion);
-    }
-    /**
-     * Announces the close and frees this window and its contents. Idempotent, so a second
-     * `close()` (a `pop()` racing a `cancel`, a `closeAll()` after a manual close) is a no-op
-     * rather than a second `destroy`. The instance is spent afterwards; see `closed`.
-     *
-     * With `animation` it plays the opening backwards first and closes when it ends (driven by
-     * `update(dt)`), unless reduced motion is on, when it closes at once.
-     */
-    close(animation) {
-        if (this.isClosed)
-            return;
-        if (animation && !reducedMotion()) {
-            const base = this.motion?.base ?? { x: this.x, y: this.y };
-            this.motion = { options: animation, elapsed: 0, closing: true, base };
-            return;
-        }
-        this.isClosed = true;
-        this.onClose.dispatch();
-        this.parent?.removeChild(this);
-        this.destroy({ children: true });
-    }
-    /** positions the window in a viewport of the given size, per its anchor */
-    place(viewportWidth, viewportHeight) {
-        if (this.isClosed)
-            return;
-        const bounds = this.getLocalBounds();
-        const margin = theme().padding * 2;
-        this.x = Math.round((viewportWidth - bounds.width) / 2);
-        if (this.anchor === 'bottom') {
-            this.y = Math.round(viewportHeight - bounds.height - margin);
-        }
-        else if (this.anchor === 'top') {
-            this.y = margin;
-        }
-        else {
-            this.y = Math.round((viewportHeight - bounds.height) / 2);
-        }
-        this.fitBlocker(viewportWidth, viewportHeight);
-    }
-    /**
-     * The blocker's hit area is the whole viewport, expressed in the window's own coordinates,
-     * which is where the blocker's local space starts. It covers the window itself as well as
-     * the space around it, so nothing at all is clicked through while it is there; whether the
-     * click also closes the window is `handleOutsideClick`'s question, not the shape's.
-     */
-    fitBlocker(width, height) {
-        if (!this.blocker)
-            return;
-        this.blocker.hitArea = new Rectangle(-this.x, -this.y, width, height);
-    }
-    /**
-     * Offered a click that landed on the blocker, at `x, y` in this window's own coordinates
-     * (its top-left corner is 0, 0). A click outside the window closes it when it is closable -
-     * the pointer's answer to `handleAction('cancel')` - and a click on the window itself is
-     * swallowed without closing, so its frame and empty body are never a dismiss button.
-     *
-     * The blocker calls this for every click it takes, which is all a game usually needs; it is
-     * public because it is also the whole decision, and a headless test can ask it directly.
-     *
-     * @returns true when the click closed the window
-     */
-    handleOutsideClick(x, y) {
-        if (this.isClosed)
-            return false;
-        const onWindow = x >= 0 && y >= 0 && x < this.currentWidth && y < this.currentHeight;
-        if (onWindow || !this.closable)
-            return false;
-        this.close();
-        return true;
-    }
-    destroy(options) {
-        this.isClosed = true;
-        themeChanged.remove(this.themeListener);
-        super.destroy(options);
-    }
-}
-//# sourceMappingURL=Window.js.map

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

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

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

@@ -1,63 +0,0 @@
-import { Container } from 'pixi.js';
-import type { Action } from '../../core/Input.ts';
-import type { Window } from './Window.ts';
-/**
- * The stack of open windows, and the arbiter of who has the keyboard.
- *
- * Only the topmost window is offered input. That single rule is what makes nested
- * interfaces behave: opening a confirmation over an inventory means the inventory stops
- * responding until the confirmation is answered, without either window knowing about the
- * other.
- *
- * A scene with its own keyboard handling has to say which comes first, because registration
- * order decides nothing here: `Input.onAction` offers an action to the most recently
- * registered listener first, and the stack registers in its constructor, so a scene that
- * builds its stack in `create()` and then registers a handler is asked *before* the windows
- * are. Returning true for a key a window needed takes it away from that window. Chain through
- * `handleAction` instead, and the windows keep the priority they are supposed to have:
- *
- * ```ts
- * Input.onAction.add((action) => stack.handleAction(action) || myOwnHandling(action));
- * ```
- *
- * A scene that does not chain must return false for every key it did not consume, and check
- * `blocksWorld` itself before acting on one, since an open modal window is not otherwise
- * visible from outside.
- *
- * Below a modal window sits a dimming layer, which is both a visual cue and a hint that
- * the world underneath is not listening.
- */
-export declare class WindowStack extends Container {
-    private windows;
-    private overlay;
-    private viewportWidth;
-    private viewportHeight;
-    private listener;
-    private readonly themeListener;
-    constructor();
-    setViewport(width: number, height: number): void;
-    get top(): Window | null;
-    get isEmpty(): boolean;
-    get depth(): number;
-    /** opens a window on top; it takes the keyboard until it closes */
-    push(window: Window): Window;
-    /** closes the top window, as `cancel` would */
-    pop(): void;
-    closeAll(): void;
-    private forget;
-    private updateOverlay;
-    private drawOverlay;
-    /**
-     * Offers an action to the top window, which is the routing the stack does for itself:
-     * exposed so a scene can put the windows ahead of its own handling rather than racing them
-     * for it (see the class doc for the order that race is decided by).
-     *
-     * @returns true when the top window consumed the action
-     */
-    handleAction(action: Action): boolean;
-    /** true while any window is open, so the world knows to hold still */
-    get blocksWorld(): boolean;
-    update(dt: number): void;
-    destroy(options?: Parameters<Container['destroy']>[0]): void;
-}
-//# sourceMappingURL=WindowStack.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"WindowStack.d.ts","sourceRoot":"","sources":["../../../src/two-d/ui/WindowStack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAY,MAAM,SAAS,CAAC;AAE9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,WAAY,SAAQ,SAAS;IACzC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAAkB;IAEjC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,cAAc,CAAK;IAE3B,OAAO,CAAC,QAAQ,CAA0D;IAC1E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4B;IAE1D,cASC;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAM/C;IAED,IAAI,GAAG,IAAI,MAAM,GAAG,IAAI,CAEvB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,mEAAmE;IACnE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAa3B;IAED,+CAA+C;IAC/C,GAAG,IAAI,IAAI,CAEV;IAED,QAAQ,IAAI,IAAI,CAGf;IAED,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,WAAW;IAQnB;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpC;IAED,sEAAsE;IACtE,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEvB;IAEQ,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAIpE;CACD"}

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

@@ -1,132 +0,0 @@
-import { Container, Graphics } from 'pixi.js';
-import * as Input from '../../core/Input.js';
-import { theme, themeChanged } from './theme.js';
-/**
- * The stack of open windows, and the arbiter of who has the keyboard.
- *
- * Only the topmost window is offered input. That single rule is what makes nested
- * interfaces behave: opening a confirmation over an inventory means the inventory stops
- * responding until the confirmation is answered, without either window knowing about the
- * other.
- *
- * A scene with its own keyboard handling has to say which comes first, because registration
- * order decides nothing here: `Input.onAction` offers an action to the most recently
- * registered listener first, and the stack registers in its constructor, so a scene that
- * builds its stack in `create()` and then registers a handler is asked *before* the windows
- * are. Returning true for a key a window needed takes it away from that window. Chain through
- * `handleAction` instead, and the windows keep the priority they are supposed to have:
- *
- * ```ts
- * Input.onAction.add((action) => stack.handleAction(action) || myOwnHandling(action));
- * ```
- *
- * A scene that does not chain must return false for every key it did not consume, and check
- * `blocksWorld` itself before acting on one, since an open modal window is not otherwise
- * visible from outside.
- *
- * Below a modal window sits a dimming layer, which is both a visual cue and a hint that
- * the world underneath is not listening.
- */
-export class WindowStack extends Container {
-    constructor() {
-        super();
-        this.windows = [];
-        this.overlay = new Graphics();
-        this.viewportWidth = 0;
-        this.viewportHeight = 0;
-        this.listener = (action) => this.handleAction(action);
-        this.themeListener = () => this.drawOverlay();
-        this.overlay.visible = false;
-        this.addChild(this.overlay);
-        //stack mode, so this is offered actions before anything registered earlier: a window
-        //that is open should always win over the map underneath
-        Input.onAction.add(this.listener);
-        themeChanged.add(this.themeListener);
-    }
-    setViewport(width, height) {
-        this.viewportWidth = width;
-        this.viewportHeight = height;
-        this.drawOverlay();
-        for (const window of this.windows)
-            window.place(width, height);
-    }
-    get top() {
-        return this.windows[this.windows.length - 1] ?? null;
-    }
-    get isEmpty() {
-        return this.windows.length === 0;
-    }
-    get depth() {
-        return this.windows.length;
-    }
-    /** opens a window on top; it takes the keyboard until it closes */
-    push(window) {
-        if (window.closed)
-            throw new Error('cannot open a window that was already closed');
-        this.windows.push(window);
-        this.addChild(window);
-        window.onClose.add(() => {
-            this.forget(window);
-            return false;
-        });
-        window.place(this.viewportWidth, this.viewportHeight);
-        this.updateOverlay();
-        return window;
-    }
-    /** closes the top window, as `cancel` would */
-    pop() {
-        this.top?.close();
-    }
-    closeAll() {
-        //iterate a copy: closing a window mutates the list through its onClose handler
-        for (const window of [...this.windows].reverse())
-            window.close();
-    }
-    forget(window) {
-        const index = this.windows.indexOf(window);
-        if (index !== -1)
-            this.windows.splice(index, 1);
-        this.updateOverlay();
-    }
-    updateOverlay() {
-        //the overlay sits directly beneath the lowest window that asks to dim, so windows
-        //above it stay lit and the world below is dimmed exactly once however many are open
-        const firstModal = this.windows.findIndex((window) => window.dims);
-        if (firstModal === -1) {
-            this.overlay.visible = false;
-            return;
-        }
-        this.overlay.visible = true;
-        this.setChildIndex(this.overlay, Math.max(0, this.getChildIndex(this.windows[firstModal]) - 1));
-    }
-    drawOverlay() {
-        const t = theme();
-        this.overlay
-            .clear()
-            .rect(0, 0, this.viewportWidth, this.viewportHeight)
-            .fill({ color: t.color.overlay, alpha: t.overlayAlpha });
-    }
-    /**
-     * Offers an action to the top window, which is the routing the stack does for itself:
-     * exposed so a scene can put the windows ahead of its own handling rather than racing them
-     * for it (see the class doc for the order that race is decided by).
-     *
-     * @returns true when the top window consumed the action
-     */
-    handleAction(action) {
-        return this.top?.handleAction(action) ?? false;
-    }
-    /** true while any window is open, so the world knows to hold still */
-    get blocksWorld() {
-        return this.windows.some((window) => window.modal);
-    }
-    update(dt) {
-        this.top?.update(dt);
-    }
-    destroy(options) {
-        Input.onAction.remove(this.listener);
-        themeChanged.remove(this.themeListener);
-        super.destroy(options);
-    }
-}
-//# sourceMappingURL=WindowStack.js.map

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

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

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

@@ -1,43 +0,0 @@
-/**
- * The screen-reader bridge.
- *
- * `mwg` draws to a canvas, which assistive technology sees as one opaque element: a message
- * box, a window title or a list selection is invisible to it no matter how readable it looks.
- * This mirrors text a game wants read out into a visually hidden DOM node with `aria-live`,
- * which the framework's own `Window` and `MessageBox` already use, and which a game can drive
- * for its own widgets through the shared `screenReader`.
- *
- * It no-ops where there is no DOM, so the same scene code runs under `node --test` and the
- * calls cost nothing there. `role="status"` and `aria-live="polite"` mean an announcement waits
- * for a pause; pass `assertive: true` for something that should interrupt (a death, an alarm).
- *
- * @example
- * ```ts
- * import { ScreenReader, screenReader } from '@datamoc/mw_games/two-d/ui';
- *
- * // the built-in widgets use the shared instance; a game can own a second region
- * const reader = new ScreenReader();
- * reader.announce('You found a rusty key.');
- * screenReader.announce('Your torch goes out!', { assertive: true });
- * reader.destroy();
- * ```
- */
-export declare class ScreenReader {
-    private polite;
-    private assertive;
-    private region;
-    /**
-     * Reads `text` out at the next pause, or interrupting with `assertive`. The region is
-     * cleared first, so announcing the same string twice is two announcements rather than none.
-     */
-    announce(text: string, options?: {
-        assertive?: boolean;
-    }): void;
-    /** empties both regions without removing them */
-    clear(): void;
-    /** removes the regions; a later `announce` recreates them lazily */
-    destroy(): void;
-}
-/** the shared instance the built-in widgets announce through */
-export declare const screenReader: ScreenReader;
-//# sourceMappingURL=a11y.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"a11y.d.ts","sourceRoot":"","sources":["../../../src/two-d/ui/a11y.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAOH,qBAAa,YAAY;IACxB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,SAAS,CAA4B;IAE7C,OAAO,CAAC,MAAM;IAkBd;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI,CAMlE;IAED,iDAAiD;IACjD,KAAK,IAAI,IAAI,CAGZ;IAED,oEAAoE;IACpE,OAAO,IAAI,IAAI,CAKd;CACD;AAED,gEAAgE;AAChE,eAAO,MAAM,YAAY,cAAqB,CAAC"}

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

@@ -1,79 +0,0 @@
-/**
- * The screen-reader bridge.
- *
- * `mwg` draws to a canvas, which assistive technology sees as one opaque element: a message
- * box, a window title or a list selection is invisible to it no matter how readable it looks.
- * This mirrors text a game wants read out into a visually hidden DOM node with `aria-live`,
- * which the framework's own `Window` and `MessageBox` already use, and which a game can drive
- * for its own widgets through the shared `screenReader`.
- *
- * It no-ops where there is no DOM, so the same scene code runs under `node --test` and the
- * calls cost nothing there. `role="status"` and `aria-live="polite"` mean an announcement waits
- * for a pause; pass `assertive: true` for something that should interrupt (a death, an alarm).
- *
- * @example
- * ```ts
- * import { ScreenReader, screenReader } from '@datamoc/mw_games/two-d/ui';
- *
- * // the built-in widgets use the shared instance; a game can own a second region
- * const reader = new ScreenReader();
- * reader.announce('You found a rusty key.');
- * screenReader.announce('Your torch goes out!', { assertive: true });
- * reader.destroy();
- * ```
- */
-//the standard visually-hidden recipe: present to a screen reader, zero-sized on screen
-const HIDDEN = 'position:absolute;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;' +
-    'clip:rect(0 0 0 0);white-space:nowrap;border:0;';
-export class ScreenReader {
-    constructor() {
-        this.polite = null;
-        this.assertive = null;
-    }
-    region(assertive) {
-        if (typeof document === 'undefined' || !document.body)
-            return null;
-        const existing = assertive ? this.assertive : this.polite;
-        if (existing)
-            return existing;
-        const node = document.createElement('div');
-        node.setAttribute('aria-live', assertive ? 'assertive' : 'polite');
-        node.setAttribute('aria-atomic', 'true');
-        node.setAttribute('role', 'status');
-        node.setAttribute('style', HIDDEN);
-        document.body.appendChild(node);
-        if (assertive)
-            this.assertive = node;
-        else
-            this.polite = node;
-        return node;
-    }
-    /**
-     * Reads `text` out at the next pause, or interrupting with `assertive`. The region is
-     * cleared first, so announcing the same string twice is two announcements rather than none.
-     */
-    announce(text, options = {}) {
-        const region = this.region(options.assertive ?? false);
-        if (!region)
-            return;
-        region.textContent = '';
-        region.appendChild(document.createTextNode(text));
-    }
-    /** empties both regions without removing them */
-    clear() {
-        if (this.polite)
-            this.polite.textContent = '';
-        if (this.assertive)
-            this.assertive.textContent = '';
-    }
-    /** removes the regions; a later `announce` recreates them lazily */
-    destroy() {
-        this.polite?.remove();
-        this.assertive?.remove();
-        this.polite = null;
-        this.assertive = null;
-    }
-}
-/** the shared instance the built-in widgets announce through */
-export const screenReader = new ScreenReader();
-//# sourceMappingURL=a11y.js.map