@datamoc/mw_games 0.44.2 → 0.46.0

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

@@ -1,134 +0,0 @@
-import { Text, TextStyle } from 'pixi.js';
-import { theme, themeChanged } from './theme.js';
-import { normalizeTextOptions, themedAlign } from './themedText.js';
-import { startReveal, advanceReveal, completeReveal } from './reveal.js';
-/**
- * A piece of text, styled from the theme.
- *
- * This is a thin wrapper over Pixi's `Text`, and its job is to stop every call site from
- * repeating a style object. Pixi renders text to its own texture, so changing the string
- * costs a re-render: cheap enough for a label, wasteful for something updated every
- * frame, where a value that only changes on whole numbers should be guarded.
- *
- * @example
- * ```ts
- * import { Label } from '@datamoc/mw_games/two-d/ui';
- *
- * const gold = new Label({ text: 'Gold: 0', color: 0xffe680 });
- *
- * gold.setText('Gold: 50'); // skips the re-render if the string is unchanged
- * gold.setColor(0xff4444); // flash red on a loss, say
- * ```
- */
-export class Label extends Text {
-    constructor(options = {}) {
-        const opts = normalizeTextOptions(options);
-        const t = theme();
-        super({
-            text: opts.text ?? '',
-            resolution: opts.resolution,
-            roundPixels: opts.roundPixels,
-            style: new TextStyle({
-                fontFamily: t.font.family,
-                stroke: opts.stroke,
-                fontSize: opts.size ?? t.font.size,
-                fontWeight: opts.bold ? 'bold' : 'normal',
-                fill: opts.color ?? t.color.text,
-                lineHeight: (opts.size ?? t.font.size) * t.font.lineHeight,
-                align: themedAlign(opts, t),
-                wordWrap: opts.wrapWidth !== undefined,
-                wordWrapWidth: opts.wrapWidth ?? 0,
-                //without this a long unbroken word overflows its window instead of wrapping
-                breakWords: true,
-            }),
-        });
-        this.themeListener = (t) => this.restyle(t);
-        this.revealSource = null;
-        this.reveal = null;
-        this.opts = opts;
-        themeChanged.add(this.themeListener);
-    }
-    /** changes the colour without rebuilding the style object */
-    setColor(color) {
-        if (this.destroyed)
-            return;
-        this.style.fill = color;
-    }
-    /** re-wraps at `width` pixels, or stops wrapping with `undefined` - for a label that follows the screen width */
-    setWrapWidth(width) {
-        if (this.destroyed)
-            return;
-        this.style.wordWrap = width !== undefined;
-        this.style.wordWrapWidth = width ?? 0;
-    }
-    /** avoids the re-render when the text has not actually changed */
-    setText(value) {
-        //Pixi's text update on a destroyed label reads its released texture and throws
-        if (this.destroyed)
-            return;
-        //an instant set cancels any reveal in progress - the two never interleave
-        this.revealSource = null;
-        this.reveal = null;
-        if (this.text !== value)
-            this.text = value;
-    }
-    /**
-     * Shows `value` progressively, `speed` characters per second. The game drives the
-     * reveal by calling `updateReveal(dt)` each frame (a label owns no update loop of
-     * its own, unlike a `MessageBox` on a `WindowStack`); `completeReveal` skips to the
-     * end, for a confirm press mid-reveal.
-     */
-    showProgressive(value, speed) {
-        if (this.destroyed)
-            return;
-        this.revealSource = value;
-        this.reveal = startReveal(value.length, speed);
-        this.renderRevealed();
-    }
-    /** advances an in-progress reveal; returns true when nothing is left to show */
-    updateReveal(dt) {
-        if (this.destroyed || !this.reveal)
-            return true;
-        const done = advanceReveal(this.reveal, dt);
-        this.renderRevealed();
-        return done;
-    }
-    /** shows the whole in-progress text at once */
-    completeReveal() {
-        if (this.destroyed || !this.reveal)
-            return;
-        completeReveal(this.reveal);
-        this.renderRevealed();
-    }
-    renderRevealed() {
-        if (!this.reveal || this.revealSource === null)
-            return;
-        //through the field rather than setText, which cancels a reveal in progress
-        const visible = this.revealSource.slice(0, Math.floor(this.reveal.revealed));
-        if (this.text !== visible)
-            this.text = visible;
-    }
-    /**
-     * Reapplies whichever style fields were never given an explicit option, so an
-     * explicit `color`/`size` a game passed in survives a theme change untouched while
-     * anything left to the theme's own defaults picks up the new one.
-     */
-    restyle(t) {
-        if (this.destroyed)
-            return;
-        this.style.fontFamily = t.font.family;
-        if (this.opts.color === undefined)
-            this.style.fill = t.color.text;
-        if (this.opts.size === undefined) {
-            this.style.fontSize = t.font.size;
-            this.style.lineHeight = t.font.size * t.font.lineHeight;
-        }
-        if (this.opts.align === undefined)
-            this.style.align = themedAlign(this.opts, t);
-    }
-    destroy(options) {
-        themeChanged.remove(this.themeListener);
-        super.destroy(options);
-    }
-}
-//# sourceMappingURL=Label.js.map

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

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

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

@@ -1,139 +0,0 @@
-export type Anchor = 'top-left' | 'top' | 'top-right' | 'left' | 'center' | 'right' | 'bottom-left' | 'bottom' | 'bottom-right' | 'fill';
-export interface LayoutRect {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-export interface AnchorSpec {
-    /** which corner or edge to sit against; `center` when omitted */
-    anchor?: Anchor;
-    /** extra offset after anchoring, positive right and down */
-    offsetX?: number;
-    offsetY?: number;
-    /** 0..1 position across the bounds, overriding the named anchor's own alignment */
-    alignX?: number;
-    alignY?: number;
-    /** the placed size; the content's own size when omitted */
-    width?: number;
-    height?: number;
-    /** shrinks the bounds on every side before anchoring */
-    margin?: number;
-}
-/**
- * The horizontal (0, 0.5, 1) and vertical alignment a named anchor implies.
- *
- * @example
- * ```ts
- * import { anchorAlign } from '@datamoc/mw_games/two-d/ui';
- *
- * console.log(anchorAlign('bottom-right')); // { x: 1, y: 1 }
- * ```
- */
-export declare function anchorAlign(anchor: Anchor): {
-    x: number;
-    y: number;
-};
-/**
- * Places a `size`-shaped child against the bounds - the anchor half of a data-driven shell, the
- * part GUI2 spells as `[cell]` anchoring a widget inside its slot.
- *
- * A `fill` anchor takes the bounds (minus margins) whole; every other anchor lines the child up on
- * the named edge and then applies the offsets, so `{ anchor: 'bottom-right', offsetX: -8 }` pins a
- * button eight pixels in from the bottom-right corner.
- *
- * @example
- * ```ts
- * import { resolveAnchor } from '@datamoc/mw_games/two-d/ui';
- *
- * const bounds = { x: 0, y: 0, width: 800, height: 600 };
- * console.log(resolveAnchor({ anchor: 'bottom-right', width: 100, height: 30, margin: 10 }, bounds));
- * // { x: 690, y: 560, width: 100, height: 30 }
- * ```
- */
-export declare function resolveAnchor(spec: AnchorSpec, bounds: LayoutRect, size?: {
-    width: number;
-    height: number;
-}): LayoutRect;
-export interface GridTrack {
-    /** a fixed size, in pixels */
-    size?: number;
-    /** share of what is left after the fixed tracks; a track with neither is 0 */
-    grow?: number;
-}
-export interface GridSpec {
-    columns: readonly GridTrack[];
-    rows: readonly GridTrack[];
-    /** space between tracks, in pixels */
-    gap?: number;
-}
-/**
- * A column/row grid whose tracks are `size` or `grow`, the data-driven counterpart to GUI2's
- * `[grid]`. Fixed tracks take their size; the rest of the space is divided between the `grow`
- * tracks in proportion to their weight, so a sidebar can be `size: 200` and the content
- * `grow: 1` without either side knowing the window's width.
- *
- * @example
- * ```ts
- * import { Grid } from '@datamoc/mw_games/two-d/ui';
- *
- * const grid = new Grid({ columns: [{ size: 200 }, { grow: 1 }], rows: [{ grow: 1 }], gap: 8 });
- * const cell = grid.rect(0, 1, { x: 0, y: 0, width: 800, height: 600 });
- * console.log(cell); // the content column: x 208, width 592
- * ```
- */
-export declare class Grid {
-    private spec;
-    constructor(spec: GridSpec);
-    get columns(): readonly GridTrack[];
-    get rows(): readonly GridTrack[];
-    /** the resolved pixel width of each column for a given total width */
-    columnSizes(totalWidth: number): number[];
-    /** the resolved pixel height of each row for a given total height */
-    rowSizes(totalHeight: number): number[];
-    /**
-     * The rectangle of a cell, spanning `columnSpan` columns and `rowSpan` rows. Out-of-range cells
-     * resolve to a zero-sized rect at the far edge rather than throwing, so a caller walking a
-     * changing table never has to bounds-check first.
-     */
-    rect(row: number, column: number, bounds: LayoutRect, options?: {
-        rowSpan?: number;
-        columnSpan?: number;
-    }): LayoutRect;
-    private get gap();
-}
-export interface FlowItem {
-    width: number;
-    height: number;
-}
-export interface FlowOptions {
-    /** space between items on a row and between rows; 0 when omitted */
-    gap?: number;
-    /** how each row sits in `width`; 'start' when omitted */
-    align?: 'start' | 'center' | 'end';
-}
-export interface FlowResult {
-    /** one position per item, in the order given */
-    positions: {
-        x: number;
-        y: number;
-    }[];
-    /** the total height the rows take, for sizing the container */
-    height: number;
-}
-/**
- * Lays items out left to right and wraps to a new row when the next one would pass `width`:
- * a toolbar that takes one row on a desktop and two on a phone. An item wider than `width`
- * sits alone on its row rather than being dropped.
- *
- * @example
- * ```ts
- * import { flowLayout } from '@datamoc/mw_games/two-d/ui';
- *
- * const buttons = [{ width: 120, height: 32 }, { width: 120, height: 32 }, { width: 120, height: 32 }];
- * const { positions, height } = flowLayout(buttons, 300, { gap: 8, align: 'center' });
- * console.log(positions.length, height); // 3 buttons on two rows: 72
- * ```
- */
-export declare function flowLayout(items: readonly FlowItem[], width: number, options?: FlowOptions): FlowResult;
-//# sourceMappingURL=Layout.d.ts.map

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

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

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

@@ -1,221 +0,0 @@
-/**
- * The horizontal (0, 0.5, 1) and vertical alignment a named anchor implies.
- *
- * @example
- * ```ts
- * import { anchorAlign } from '@datamoc/mw_games/two-d/ui';
- *
- * console.log(anchorAlign('bottom-right')); // { x: 1, y: 1 }
- * ```
- */
-export function anchorAlign(anchor) {
-    switch (anchor) {
-        case 'top':
-        case 'bottom':
-            return { x: 0.5, y: anchor === 'top' ? 0 : 1 };
-        case 'left':
-        case 'right':
-            return { x: anchor === 'left' ? 0 : 1, y: 0.5 };
-        case 'top-left':
-            return { x: 0, y: 0 };
-        case 'top-right':
-            return { x: 1, y: 0 };
-        case 'bottom-left':
-            return { x: 0, y: 1 };
-        case 'bottom-right':
-            return { x: 1, y: 1 };
-        case 'fill':
-        case 'center':
-        default:
-            return { x: 0.5, y: 0.5 };
-    }
-}
-/**
- * Places a `size`-shaped child against the bounds - the anchor half of a data-driven shell, the
- * part GUI2 spells as `[cell]` anchoring a widget inside its slot.
- *
- * A `fill` anchor takes the bounds (minus margins) whole; every other anchor lines the child up on
- * the named edge and then applies the offsets, so `{ anchor: 'bottom-right', offsetX: -8 }` pins a
- * button eight pixels in from the bottom-right corner.
- *
- * @example
- * ```ts
- * import { resolveAnchor } from '@datamoc/mw_games/two-d/ui';
- *
- * const bounds = { x: 0, y: 0, width: 800, height: 600 };
- * console.log(resolveAnchor({ anchor: 'bottom-right', width: 100, height: 30, margin: 10 }, bounds));
- * // { x: 690, y: 560, width: 100, height: 30 }
- * ```
- */
-export function resolveAnchor(spec, bounds, size = { width: 0, height: 0 }) {
-    const margin = spec.margin ?? 0;
-    const left = bounds.x + margin;
-    const top = bounds.y + margin;
-    const usableWidth = Math.max(0, bounds.width - margin * 2);
-    const usableHeight = Math.max(0, bounds.height - margin * 2);
-    if (spec.anchor === 'fill') {
-        const x = left + (spec.offsetX ?? 0);
-        const y = top + (spec.offsetY ?? 0);
-        return {
-            x,
-            y,
-            width: spec.width ?? Math.max(0, left + usableWidth - x),
-            height: spec.height ?? Math.max(0, top + usableHeight - y),
-        };
-    }
-    const align = anchorAlign(spec.anchor ?? 'center');
-    const alignX = spec.alignX ?? align.x;
-    const alignY = spec.alignY ?? align.y;
-    const width = spec.width ?? size.width;
-    const height = spec.height ?? size.height;
-    return {
-        x: left + alignX * Math.max(0, usableWidth - width) + (spec.offsetX ?? 0),
-        y: top + alignY * Math.max(0, usableHeight - height) + (spec.offsetY ?? 0),
-        width,
-        height,
-    };
-}
-/**
- * A column/row grid whose tracks are `size` or `grow`, the data-driven counterpart to GUI2's
- * `[grid]`. Fixed tracks take their size; the rest of the space is divided between the `grow`
- * tracks in proportion to their weight, so a sidebar can be `size: 200` and the content
- * `grow: 1` without either side knowing the window's width.
- *
- * @example
- * ```ts
- * import { Grid } from '@datamoc/mw_games/two-d/ui';
- *
- * const grid = new Grid({ columns: [{ size: 200 }, { grow: 1 }], rows: [{ grow: 1 }], gap: 8 });
- * const cell = grid.rect(0, 1, { x: 0, y: 0, width: 800, height: 600 });
- * console.log(cell); // the content column: x 208, width 592
- * ```
- */
-export class Grid {
-    constructor(spec) {
-        this.spec = spec;
-    }
-    get columns() {
-        return this.spec.columns;
-    }
-    get rows() {
-        return this.spec.rows;
-    }
-    /** the resolved pixel width of each column for a given total width */
-    columnSizes(totalWidth) {
-        return resolveTracks(this.spec.columns, totalWidth, this.gap);
-    }
-    /** the resolved pixel height of each row for a given total height */
-    rowSizes(totalHeight) {
-        return resolveTracks(this.spec.rows, totalHeight, this.gap);
-    }
-    /**
-     * The rectangle of a cell, spanning `columnSpan` columns and `rowSpan` rows. Out-of-range cells
-     * resolve to a zero-sized rect at the far edge rather than throwing, so a caller walking a
-     * changing table never has to bounds-check first.
-     */
-    rect(row, column, bounds, options = {}) {
-        const columns = this.columnSizes(bounds.width);
-        const rows = this.rowSizes(bounds.height);
-        const columnSpan = options.columnSpan ?? 1;
-        const rowSpan = options.rowSpan ?? 1;
-        const x = bounds.x + offsetOf(columns, column, this.gap);
-        const y = bounds.y + offsetOf(rows, row, this.gap);
-        return {
-            x,
-            y,
-            width: spanOf(columns, column, columnSpan, this.gap),
-            height: spanOf(rows, row, rowSpan, this.gap),
-        };
-    }
-    get gap() {
-        return this.spec.gap ?? 0;
-    }
-}
-function resolveTracks(tracks, total, gap) {
-    const gaps = gap * Math.max(0, tracks.length - 1);
-    const available = Math.max(0, total - gaps);
-    const fixed = tracks.reduce((sum, track) => sum + (track.size ?? 0), 0);
-    const growTotal = tracks.reduce((sum, track) => sum + (track.grow ?? 0), 0);
-    const remaining = Math.max(0, available - fixed);
-    let assigned = 0;
-    return tracks.map((track, index) => {
-        if (track.size !== undefined)
-            return track.size;
-        if (!track.grow || growTotal === 0)
-            return 0;
-        //give the last grow track whatever rounding is left, so the tracks always fill the space
-        const isLast = index === lastGrowIndex(tracks);
-        const size = isLast ? remaining - assigned : Math.floor((remaining * track.grow) / growTotal);
-        assigned += size;
-        return size;
-    });
-}
-function lastGrowIndex(tracks) {
-    for (let index = tracks.length - 1; index >= 0; index--)
-        if (tracks[index].grow)
-            return index;
-    return -1;
-}
-function offsetOf(sizes, index, gap) {
-    let offset = 0;
-    for (let i = 0; i < index && i < sizes.length; i++)
-        offset += sizes[i] + gap;
-    return offset;
-}
-function spanOf(sizes, index, span, gap) {
-    let width = 0;
-    for (let i = index; i < index + span && i < sizes.length; i++) {
-        width += sizes[i];
-        if (i > index)
-            width += gap;
-    }
-    return Math.max(0, width);
-}
-/**
- * Lays items out left to right and wraps to a new row when the next one would pass `width`:
- * a toolbar that takes one row on a desktop and two on a phone. An item wider than `width`
- * sits alone on its row rather than being dropped.
- *
- * @example
- * ```ts
- * import { flowLayout } from '@datamoc/mw_games/two-d/ui';
- *
- * const buttons = [{ width: 120, height: 32 }, { width: 120, height: 32 }, { width: 120, height: 32 }];
- * const { positions, height } = flowLayout(buttons, 300, { gap: 8, align: 'center' });
- * console.log(positions.length, height); // 3 buttons on two rows: 72
- * ```
- */
-export function flowLayout(items, width, options = {}) {
-    const gap = options.gap ?? 0;
-    const align = options.align ?? 'start';
-    const positions = new Array(items.length);
-    let y = 0;
-    let row = [];
-    let rowWidth = 0;
-    let rowHeight = 0;
-    const flush = () => {
-        if (row.length === 0)
-            return;
-        const free = Math.max(0, width - rowWidth);
-        let x = align === 'center' ? free / 2 : align === 'end' ? free : 0;
-        for (const index of row) {
-            positions[index] = { x, y };
-            x += items[index].width + gap;
-        }
-        y += rowHeight + gap;
-        row = [];
-        rowWidth = 0;
-        rowHeight = 0;
-    };
-    items.forEach((item, index) => {
-        const needed = row.length === 0 ? item.width : rowWidth + gap + item.width;
-        if (row.length > 0 && needed > width)
-            flush();
-        rowWidth = row.length === 0 ? item.width : rowWidth + gap + item.width;
-        rowHeight = Math.max(rowHeight, item.height);
-        row.push(index);
-    });
-    flush();
-    return { positions, height: Math.max(0, y - gap) };
-}
-//# sourceMappingURL=Layout.js.map

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

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

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

@@ -1,130 +0,0 @@
-import { Container } from 'pixi.js';
-import type { Action } from '../../core/Input.ts';
-import type { Container2D } from '../render/Types2D.ts';
-export interface ListItem {
-    /** what the row reads */
-    text: string;
-    /** a greyed-out row can be looked at but not chosen */
-    disabled?: boolean;
-    /** anything the game wants to get back when the row is chosen */
-    value?: unknown;
-    /** an icon drawn to the left of the text; sized to the row height */
-    icon?: Container2D;
-}
-export interface ListViewOptions {
-    width: number;
-    height: number;
-    items?: ListItem[];
-    /** row height; defaults to the theme's line height */
-    rowHeight?: number;
-    onSelect?: (item: ListItem, index: number) => void;
-    onHighlight?: (item: ListItem, index: number) => void;
-    /**
-     * check-rather-than-pick rows: arrows move the highlight, confirm and tap toggle
-     * a check instead of choosing, and the game reads `checkedIndexes` when it is done.
-     * Off by default, which keeps the pick-one menu this list has always been.
-     */
-    multiple?: boolean;
-    onToggle?: (item: ListItem, index: number, checked: boolean) => void;
-}
-/**
- * A scrolling list of rows, driven by the keyboard.
- *
- * This is the workhorse of an inventory-heavy game: bags, spell lists, shop stock,
- * dialogue choices, save slots. It scrolls by keeping the highlight in view rather than by
- * pixel offset, which is what makes it feel right with a keyboard: the list moves only
- * when the selection would otherwise leave the window.
- *
- * Rows that are `disabled` are skipped when moving, so holding a direction never lands on
- * something unusable.
- *
- * @example
- * ```ts
- * import { ListView } from '@datamoc/mw_games/two-d/ui';
- *
- * const menu = new ListView({
- * 	width: 160,
- * 	height: 96,
- * 	items: [
- * 		{ text: 'Attack' },
- * 		{ text: 'Item' },
- * 		{ text: 'Flee', disabled: true },
- * 	],
- * 	onSelect: (item, index) => console.log('chose', item.text, index),
- * });
- *
- * menu.handleAction('down'); // highlights "Item"
- * menu.handleAction('confirm'); // fires onSelect for the highlighted row
- * ```
- */
-export declare class ListView extends Container {
-    private readonly selection;
-    private rows;
-    private rowsLayer;
-    private highlight;
-    private mask_;
-    private viewWidth;
-    private viewHeight;
-    private rowHeight;
-    private readonly explicitRowHeight;
-    private scroll;
-    private readonly themeListener;
-    onSelect: ((item: ListItem, index: number) => void) | null;
-    onHighlight: ((item: ListItem, index: number) => void) | null;
-    onToggle: ((item: ListItem, index: number, checked: boolean) => void) | null;
-    private multiple;
-    private checked;
-    private ticks;
-    constructor(options: ListViewOptions);
-    /**
-     * Recolours rows and the default row height from the new theme in place, rather than
-     * through `setItems`: a row's optional `icon` is a `Container` the caller owns, and
-     * `setItems`'s teardown destroys a row's children on the way out - routing a restyle
-     * through it would destroy the very icons still referenced by the selection's items,
-     * the same trap `IconGrid.swapCells`'s own doc comment describes for its cells.
-     */
-    private restyle;
-    destroy(options?: Parameters<Container['destroy']>[0]): void;
-    private drawMask;
-    get visibleRows(): number;
-    get selectedIndex(): number;
-    get selected(): ListItem | null;
-    get length(): number;
-    setItems(items: ListItem[]): void;
-    resize(width: number, height: number): void;
-    /**
-     * Moves the highlight by `delta` rows, skipping disabled ones.
-     *
-     * Wraps at both ends, which is what a short menu wants. Returns false when there is
-     * nothing selectable to move to, so a caller can beep rather than doing nothing.
-     */
-    move(delta: number): boolean;
-    select(index: number): void;
-    confirm(): boolean;
-    /**
-     * Selects and confirms row `index` in one step, the way a mouse or touch player expects
-     * from a menu row rather than a select-then-confirm keyboard sequence - the same pointer
-     * parity `IconGrid.tapCell` already gives its cells. A disabled row is a no-op, the same
-     * as an out-of-range one. This is what a row's own `pointerdown` handler calls, so a game
-     * driving the list programmatically (a test, a gamepad-to-pointer bridge) reaches the
-     * exact behaviour a real tap would.
-     */
-    tapRow(index: number): void;
-    /** @returns true when the action was used */
-    handleAction(action: Action): boolean;
-    get checkedIndexes(): number[];
-    isChecked(index: number): boolean;
-    /** checks or unchecks a row, firing `onToggle` only when the mark actually moves */
-    setChecked(index: number, checked: boolean): void;
-    /** flips a row’s check; false for out-of-range and disabled rows */
-    toggleChecked(index: number): boolean;
-    /** unchecks everything silently, the way `setItems` starts unchecked */
-    clearChecked(): void;
-    /** the check box side, so text and icons indent past it in multiple mode */
-    private checkAdvance;
-    private checkBox;
-    private rebuildTicks;
-    private updateTicks;
-    private refresh;
-}
-//# sourceMappingURL=ListView.d.ts.map

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

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