apex-grid 3.2.0 → 3.4.0

package/controllers/row-reorder.d.ts

@@ -0,0 +1,161 @@
+import type { ReactiveController } from 'lit';
+import type { GridHost } from '../internal/types.js';
+/** Where a moved row lands relative to its target. */
+export type RowDropPosition = 'before' | 'after';
+/** A single cell snapshot used to paint the floating row ghost. */
+export interface RowGhostCell {
+    /** The cell's rendered text at grab time. */
+    text: string;
+    /** The cell's rendered width (px), so the ghost matches the column layout. */
+    width: number;
+    /** The cell's computed `text-align`, so numbers stay right-aligned in the ghost. */
+    align: string;
+}
+/** Everything the row hands the controller to seed the floating ghost. */
+export interface RowGhostInit {
+    /** The source row's bounding rect at grab time. */
+    rect: DOMRect;
+    /** Pointer position at grab time (to keep the grab point under the cursor). */
+    clientX: number;
+    clientY: number;
+    /** Per-cell snapshot of the row's visible content. */
+    cells: RowGhostCell[];
+}
+/**
+ * Live state for the floating "ghost" row that trails the cursor during a
+ * pointer drag. Mirrors {@link ReorderController}'s column ghost: the source
+ * row stays in the grid (and live-swaps), the ghost is a purely visual proxy.
+ */
+export interface RowGhostState {
+    /** Ghost position (viewport-relative top-left, in CSS pixels). */
+    x: number;
+    y: number;
+    /** Ghost size, fixed at the source row's initial bounding rect. */
+    width: number;
+    height: number;
+    /** Cursor offset within the ghost so the grab point stays under the cursor. */
+    pointerOffsetX: number;
+    pointerOffsetY: number;
+    /** Snapshot of the row's visible cells. */
+    cells: ReadonlyArray<RowGhostCell>;
+}
+/**
+ * Reactive controller backing row drag-reorder and a manual row order.
+ *
+ * @remarks
+ * Row order is normally derived (filter → sort). This controller adds a
+ * **manual order**: an explicit sequence of row references applied as a
+ * pipeline step after sort. While a manual order is active, sorting is mutually
+ * exclusive (applying a sort clears the manual order). State is reference-based,
+ * so it survives the in-place pipeline.
+ *
+ * Reordering happens through {@link moveRow} (pointer live-swap during a drag,
+ * the keyboard grab/move flow, or the public API). Each move goes through the
+ * cancellable `rowMoving` event and emits a follow-up `rowMoved`, then animates
+ * with a Y-axis FLIP. Pinned rows (F4) are never the drag source and reorder
+ * only within the unpinned body set.
+ *
+ * Persistence: by default the order lives in this controller and the app
+ * persists via `rowMoved`. With `rowReordering.applyToData` the move also
+ * splices {@link ApexGrid.data} in place (and clears the manual order, since the
+ * data array then carries the order).
+ */
+export declare class RowReorderController<T extends object> implements ReactiveController {
+    #private;
+    protected host: GridHost<T>;
+    /** The row currently being pointer-dragged, or `null`. */
+    dragging: T | null;
+    /**
+     * Live floating-ghost state during a pointer drag, or `null`. Surfaced to the
+     * grid, which renders the ghost at the top of its shadow tree (outside the
+     * virtualizer) so `position: fixed` tracks the viewport cleanly.
+     */
+    ghost: RowGhostState | null;
+    /** The row currently grabbed for keyboard reorder, or `null`. */
+    grabbed: T | null;
+    constructor(host: GridHost<T>);
+    hostConnected(): void;
+    /** Whether row reordering is enabled at the grid level. */
+    get enabled(): boolean;
+    /**
+     * Whether a pointer drag must start from the dedicated grip handle (the
+     * default), rather than from anywhere on the row. Driven by
+     * `rowReordering.handle` (defaults to `true`).
+     */
+    get handleMode(): boolean;
+    /**
+     * Whether the leading grip-handle column is rendered. Only in handle mode, and
+     * only while reordering is enabled.
+     */
+    get showHandleColumn(): boolean;
+    /** Whether moves also splice {@link ApexGrid.data} in place. */
+    get applyToData(): boolean;
+    /** Whether a manual order is currently active. */
+    get hasManualOrder(): boolean;
+    /** Whether a row is currently grabbed for keyboard reorder. */
+    get isGrabbing(): boolean;
+    /**
+     * Pipeline step: reorders the (post-filter, post-sort) rows by the manual
+     * order. Rows absent from the manual order (e.g. newly added) keep their
+     * incoming relative order at the end. Identity pass-through when inactive.
+     */
+    apply(rows: T[]): T[];
+    /**
+     * The current manual order as a copy of its row references, or `null` for the
+     * derived order. Consumed by `ApexGrid.getState`.
+     */
+    getManualOrder(): T[] | null;
+    /**
+     * Restores a manual order from a list of row references (state restore). Pass
+     * `null` (or an empty list) to clear it. Silent: emits no `rowMoving` /
+     * `rowMoved` and does not animate; re-runs the pipeline.
+     */
+    restoreManualOrder(order: T[] | null): void;
+    /**
+     * Clears the manual order (e.g. when a sort is applied). Re-runs the pipeline.
+     */
+    clearManualOrder(announce?: boolean): void;
+    /**
+     * Moves the row at view index `from` relative to the row at view index `to`.
+     * Indices are into {@link ApexGrid.pageItems}.
+     *
+     * @returns `true` when applied, `false` when disabled, out of range, or
+     * cancelled via `rowMoving`.
+     */
+    moveRow(from: number, to: number, position?: RowDropPosition): boolean;
+    /**
+     * Begins a pointer drag from `source`. When `ghost` is supplied (the pointer
+     * path always does), seeds the floating ghost from the source row's rect and
+     * the grab point so it stays anchored under the cursor.
+     */
+    startDrag(source: T, ghost?: RowGhostInit): void;
+    /** Moves the floating ghost to track the cursor. No-op without an active ghost. */
+    moveGhost(clientX: number, clientY: number): void;
+    /**
+     * Called on pointer-move during a drag: live-swaps the dragged row past the
+     * body row currently under `clientY` once the cursor crosses its midpoint.
+     */
+    dragOver(clientY: number): void;
+    /** Ends the pointer drag. The order is already final (live-swapped). */
+    endDrag(): void;
+    /**
+     * Arms a pointer drag from a row press. Called by the row on `pointerdown`
+     * (from the grip in handle mode, or anywhere in whole-row mode). The move /
+     * up / cancel listeners are bound to the **grid host**, so the gesture is
+     * immune to the source row's DOM being recycled by a live-swap. `getGhost` is
+     * a thunk the controller invokes once, the instant the drag engages, to
+     * snapshot the row's cells (the row is still in place then).
+     */
+    armPointerDrag(data: T, getGhost: () => RowGhostInit, event: PointerEvent): void;
+    /** Grabs the row at view index `rowIndex` for keyboard reorder. */
+    grab(rowIndex: number): boolean;
+    /**
+     * Moves the grabbed row one position in `direction`. Returns the grabbed
+     * row's new view index, or `-1` when it can't move (no grab / at the edge).
+     */
+    moveGrabbed(direction: -1 | 1): number;
+    /** Drops the grabbed row, keeping its moves. */
+    drop(): void;
+    /** Cancels the grab, reverting to the order captured when it was grabbed. */
+    cancelGrab(): void;
+}

package/controllers/row-reorder.js

@@ -0,0 +1,332 @@
+import { PIPELINE } from '../internal/constants.js';
+import { awaitChildUpdates, playKeyedFlip } from '../internal/flip.js';
+const DRAG_THRESHOLD_PX = 4;
+export class RowReorderController {
+    #order;
+    #preGrab;
+    #swapping;
+    #pending;
+    constructor(host) {
+        this.host = host;
+        this.#order = null;
+        this.#preGrab = null;
+        this.dragging = null;
+        this.ghost = null;
+        this.grabbed = null;
+        this.#swapping = false;
+        this.#pending = null;
+        this.#onHostPointerMove = (event) => {
+            const pending = this.#pending;
+            if (!pending || event.pointerId !== pending.pointerId)
+                return;
+            if (!this.dragging) {
+                const dx = event.clientX - pending.startX;
+                const dy = event.clientY - pending.startY;
+                if (Math.hypot(dx, dy) < DRAG_THRESHOLD_PX)
+                    return;
+                try {
+                    this.#hostElement.setPointerCapture(pending.pointerId);
+                }
+                catch {
+                }
+                this.startDrag(pending.data, pending.getGhost());
+            }
+            this.moveGhost(event.clientX, event.clientY);
+            this.dragOver(event.clientY);
+        };
+        this.#onHostPointerUp = (event) => {
+            const pending = this.#pending;
+            if (!pending || event.pointerId !== pending.pointerId)
+                return;
+            const host = this.#hostElement;
+            host.removeEventListener('pointermove', this.#onHostPointerMove);
+            host.removeEventListener('pointerup', this.#onHostPointerUp);
+            host.removeEventListener('pointercancel', this.#onHostPointerUp);
+            try {
+                if (host.hasPointerCapture(pending.pointerId))
+                    host.releasePointerCapture(pending.pointerId);
+            }
+            catch {
+            }
+            this.#pending = null;
+            this.endDrag();
+        };
+        this.host.addController(this);
+    }
+    get #hostElement() {
+        return this.host;
+    }
+    hostConnected() { }
+    get enabled() {
+        return Boolean(this.host.rowReordering?.enabled);
+    }
+    get handleMode() {
+        return this.enabled && this.host.rowReordering?.handle !== false;
+    }
+    get showHandleColumn() {
+        return this.handleMode;
+    }
+    get applyToData() {
+        return Boolean(this.host.rowReordering?.applyToData);
+    }
+    get hasManualOrder() {
+        return this.#order !== null;
+    }
+    get isGrabbing() {
+        return this.grabbed !== null;
+    }
+    apply(rows) {
+        if (!this.#order)
+            return rows;
+        const rank = new Map();
+        this.#order.forEach((row, i) => {
+            rank.set(row, i);
+        });
+        return [...rows].sort((a, b) => {
+            const ra = rank.has(a) ? rank.get(a) : Number.POSITIVE_INFINITY;
+            const rb = rank.has(b) ? rank.get(b) : Number.POSITIVE_INFINITY;
+            return ra - rb;
+        });
+    }
+    getManualOrder() {
+        return this.#order ? [...this.#order] : null;
+    }
+    restoreManualOrder(order) {
+        this.#order = order?.length ? [...order] : null;
+        this.host.requestUpdate(PIPELINE);
+    }
+    clearManualOrder(announce = false) {
+        if (!this.#order)
+            return;
+        this.#order = null;
+        this.host.requestUpdate(PIPELINE);
+        if (announce)
+            this.host.announce(this.host.localize('announce.manualOrderCleared'));
+    }
+    moveRow(from, to, position = 'before') {
+        const view = this.host.pageItems;
+        const before = this.#captureRowRects();
+        const ok = this.#commit(view[from], view[to], position);
+        if (ok)
+            void this.#flipAfterUpdate(before);
+        return ok;
+    }
+    startDrag(source, ghost) {
+        if (!this.enabled)
+            return;
+        this.dragging = source;
+        this.ghost = ghost
+            ? {
+                x: ghost.rect.left,
+                y: ghost.rect.top,
+                width: ghost.rect.width,
+                height: ghost.rect.height,
+                pointerOffsetX: ghost.clientX - ghost.rect.left,
+                pointerOffsetY: ghost.clientY - ghost.rect.top,
+                cells: ghost.cells,
+            }
+            : null;
+        this.host.requestUpdate();
+    }
+    moveGhost(clientX, clientY) {
+        if (!this.ghost)
+            return;
+        this.ghost = {
+            ...this.ghost,
+            x: clientX - this.ghost.pointerOffsetX,
+            y: clientY - this.ghost.pointerOffsetY,
+        };
+        this.host.requestUpdate();
+    }
+    dragOver(clientY) {
+        if (!this.dragging || this.#swapping)
+            return;
+        const target = this.#bodyRowAt(clientY);
+        if (!target || target.data === this.dragging)
+            return;
+        const view = this.host.pageItems;
+        const sourceIdx = view.indexOf(this.dragging);
+        const targetIdx = view.indexOf(target.data);
+        if (sourceIdx === -1 || targetIdx === -1)
+            return;
+        const rect = target.element.getBoundingClientRect();
+        const midpoint = rect.top + rect.height / 2;
+        let position;
+        if (sourceIdx < targetIdx) {
+            if (clientY < midpoint)
+                return;
+            position = 'after';
+        }
+        else {
+            if (clientY > midpoint)
+                return;
+            position = 'before';
+        }
+        void this.#dragSwap(target.data, position);
+    }
+    endDrag() {
+        if (!this.dragging)
+            return;
+        this.dragging = null;
+        this.ghost = null;
+        this.host.requestUpdate();
+    }
+    armPointerDrag(data, getGhost, event) {
+        const pinned = this.host.pinnedRows;
+        if (!this.enabled || pinned.top.includes(data) || pinned.bottom.includes(data))
+            return;
+        this.#pending = {
+            data,
+            getGhost,
+            startX: event.clientX,
+            startY: event.clientY,
+            pointerId: event.pointerId,
+        };
+        const host = this.#hostElement;
+        host.addEventListener('pointermove', this.#onHostPointerMove);
+        host.addEventListener('pointerup', this.#onHostPointerUp);
+        host.addEventListener('pointercancel', this.#onHostPointerUp);
+    }
+    #onHostPointerMove;
+    #onHostPointerUp;
+    async #dragSwap(target, position) {
+        if (this.#swapping)
+            return;
+        this.#swapping = true;
+        try {
+            const before = this.#captureRowRects();
+            if (this.#commit(this.dragging, target, position)) {
+                await this.host.updateComplete;
+                await awaitChildUpdates(this.host.rows);
+                this.#playRowFlip(before);
+            }
+        }
+        finally {
+            this.#swapping = false;
+        }
+    }
+    grab(rowIndex) {
+        if (!this.enabled)
+            return false;
+        const row = this.host.pageItems[rowIndex];
+        if (!row)
+            return false;
+        this.grabbed = row;
+        this.#preGrab = this.#order ? [...this.#order] : null;
+        this.host.requestUpdate();
+        this.host.announce(this.host.localize('announce.rowGrabbed'));
+        return true;
+    }
+    moveGrabbed(direction) {
+        if (!this.grabbed)
+            return -1;
+        const view = this.host.pageItems;
+        const current = view.indexOf(this.grabbed);
+        const target = current + direction;
+        if (current === -1 || target < 0 || target >= view.length)
+            return -1;
+        const before = this.#captureRowRects();
+        const ok = this.#commit(this.grabbed, view[target], direction > 0 ? 'after' : 'before', {
+            silent: true,
+        });
+        if (!ok)
+            return -1;
+        void this.#flipAfterUpdate(before);
+        this.host.announce(this.host.localize('announce.rowMovedTo', { position: target + 1 }));
+        return target;
+    }
+    drop() {
+        if (!this.grabbed)
+            return;
+        this.grabbed = null;
+        this.#preGrab = null;
+        this.host.requestUpdate();
+        this.host.announce(this.host.localize('announce.rowDropped'));
+    }
+    cancelGrab() {
+        if (!this.grabbed)
+            return;
+        this.grabbed = null;
+        this.#order = this.#preGrab;
+        this.#preGrab = null;
+        this.host.requestUpdate(PIPELINE);
+        this.host.announce(this.host.localize('announce.reorderCancelled'));
+    }
+    #commit(source, target, position, options = {}) {
+        if (!this.enabled || !source || !target || source === target)
+            return false;
+        const view = this.host.pageItems;
+        const from = view.indexOf(source);
+        const to = view.indexOf(target);
+        const proceed = this.host.emitEvent('rowMoving', {
+            detail: { from, to, data: source },
+            cancelable: true,
+        });
+        if (!proceed)
+            return false;
+        const baseline = this.#order ?? [...this.host.dataView];
+        const next = baseline.filter((row) => row !== source);
+        let index = next.indexOf(target);
+        if (index === -1)
+            return false;
+        if (position === 'after')
+            index += 1;
+        next.splice(index, 0, source);
+        if (this.applyToData) {
+            this.#spliceData(next);
+            this.#order = null;
+        }
+        else {
+            this.#order = next;
+        }
+        this.host.requestUpdate(PIPELINE);
+        if (!options.silent)
+            this.host.announce(this.host.localize('announce.rowMoved'));
+        this.host.emitEvent('rowMoved', { detail: { from, to, data: source } });
+        return true;
+    }
+    #spliceData(order) {
+        const rank = new Map();
+        order.forEach((row, i) => {
+            rank.set(row, i);
+        });
+        this.host.data.sort((a, b) => {
+            const ra = rank.has(a) ? rank.get(a) : Number.POSITIVE_INFINITY;
+            const rb = rank.has(b) ? rank.get(b) : Number.POSITIVE_INFINITY;
+            return ra - rb;
+        });
+    }
+    #bodyRowAt(clientY) {
+        const pinned = this.host.pinnedRows;
+        for (const row of this.host.rows) {
+            if (pinned.top.includes(row.data) || pinned.bottom.includes(row.data))
+                continue;
+            const element = row;
+            const rect = element.getBoundingClientRect();
+            if (clientY >= rect.top && clientY < rect.bottom)
+                return { data: row.data, element };
+        }
+        return null;
+    }
+    #captureRowRects() {
+        const entries = [];
+        for (const row of this.host.rows) {
+            const el = row;
+            entries.push({ key: row.data, rect: el.getBoundingClientRect() });
+        }
+        return entries;
+    }
+    async #flipAfterUpdate(before) {
+        await this.host.updateComplete;
+        await awaitChildUpdates(this.host.rows);
+        this.#playRowFlip(before);
+    }
+    #playRowFlip(before) {
+        const byData = new Map();
+        for (const row of this.host.rows) {
+            byData.set(row.data, row);
+        }
+        playKeyedFlip(before, (data) => byData.get(data) ?? null, 'y');
+    }
+}
+//# sourceMappingURL=row-reorder.js.map

package/controllers/row-reorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-reorder.js","sourceRoot":"","sources":["../../src/controllers/row-reorder.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController } from 'lit';\nimport { PIPELINE } from '../internal/constants.js';\nimport { awaitChildUpdates, type KeyedFlipEntry, playKeyedFlip } from '../internal/flip.js';\nimport type { GridHost } from '../internal/types.js';\n\n/** Where a moved row lands relative to its target. */\nexport type RowDropPosition = 'before' | 'after';\n\n/** Pixels the pointer must travel before a row drag engages. */\nconst DRAG_THRESHOLD_PX = 4;\n\n/** A single cell snapshot used to paint the floating row ghost. */\nexport interface RowGhostCell {\n  /** The cell's rendered text at grab time. */\n  text: string;\n  /** The cell's rendered width (px), so the ghost matches the column layout. */\n  width: number;\n  /** The cell's computed `text-align`, so numbers stay right-aligned in the ghost. */\n  align: string;\n}\n\n/** Everything the row hands the controller to seed the floating ghost. */\nexport interface RowGhostInit {\n  /** The source row's bounding rect at grab time. */\n  rect: DOMRect;\n  /** Pointer position at grab time (to keep the grab point under the cursor). */\n  clientX: number;\n  clientY: number;\n  /** Per-cell snapshot of the row's visible content. */\n  cells: RowGhostCell[];\n}\n\n/**\n * Live state for the floating \"ghost\" row that trails the cursor during a\n * pointer drag. Mirrors {@link ReorderController}'s column ghost: the source\n * row stays in the grid (and live-swaps), the ghost is a purely visual proxy.\n */\nexport interface RowGhostState {\n  /** Ghost position (viewport-relative top-left, in CSS pixels). */\n  x: number;\n  y: number;\n  /** Ghost size, fixed at the source row's initial bounding rect. */\n  width: number;\n  height: number;\n  /** Cursor offset within the ghost so the grab point stays under the cursor. */\n  pointerOffsetX: number;\n  pointerOffsetY: number;\n  /** Snapshot of the row's visible cells. */\n  cells: ReadonlyArray<RowGhostCell>;\n}\n\n/**\n * Reactive controller backing row drag-reorder and a manual row order.\n *\n * @remarks\n * Row order is normally derived (filter → sort). This controller adds a\n * **manual order**: an explicit sequence of row references applied as a\n * pipeline step after sort. While a manual order is active, sorting is mutually\n * exclusive (applying a sort clears the manual order). State is reference-based,\n * so it survives the in-place pipeline.\n *\n * Reordering happens through {@link moveRow} (pointer live-swap during a drag,\n * the keyboard grab/move flow, or the public API). Each move goes through the\n * cancellable `rowMoving` event and emits a follow-up `rowMoved`, then animates\n * with a Y-axis FLIP. Pinned rows (F4) are never the drag source and reorder\n * only within the unpinned body set.\n *\n * Persistence: by default the order lives in this controller and the app\n * persists via `rowMoved`. With `rowReordering.applyToData` the move also\n * splices {@link ApexGrid.data} in place (and clears the manual order, since the\n * data array then carries the order).\n */\nexport class RowReorderController<T extends object> implements ReactiveController {\n  /** Manual order of row references, or `null` for the natural (sorted) order. */\n  #order: T[] | null = null;\n\n  /** Order snapshot captured at keyboard-grab time, for Escape-to-cancel. */\n  #preGrab: T[] | null = null;\n\n  /** The row currently being pointer-dragged, or `null`. */\n  public dragging: T | null = null;\n\n  /**\n   * Live floating-ghost state during a pointer drag, or `null`. Surfaced to the\n   * grid, which renders the ghost at the top of its shadow tree (outside the\n   * virtualizer) so `position: fixed` tracks the viewport cleanly.\n   */\n  public ghost: RowGhostState | null = null;\n\n  /** The row currently grabbed for keyboard reorder, or `null`. */\n  public grabbed: T | null = null;\n\n  /** Re-entrancy guard so a slow swap can't trigger a second mid-drag. */\n  #swapping = false;\n\n  /**\n   * In-flight pointer-drag gesture. The move/up listeners live on the **grid\n   * host** (a stable element), not the row, so a live-swap that recycles the\n   * source row's DOM can't tear the drag down mid-gesture.\n   */\n  #pending: {\n    data: T;\n    getGhost: () => RowGhostInit;\n    startX: number;\n    startY: number;\n    pointerId: number;\n  } | null = null;\n\n  constructor(protected host: GridHost<T>) {\n    this.host.addController(this);\n  }\n\n  /** The grid host as a DOM event target (it is always an `HTMLElement`). */\n  get #hostElement(): HTMLElement {\n    return this.host as unknown as HTMLElement;\n  }\n\n  public hostConnected() {}\n\n  /** Whether row reordering is enabled at the grid level. */\n  public get enabled(): boolean {\n    return Boolean(this.host.rowReordering?.enabled);\n  }\n\n  /**\n   * Whether a pointer drag must start from the dedicated grip handle (the\n   * default), rather than from anywhere on the row. Driven by\n   * `rowReordering.handle` (defaults to `true`).\n   */\n  public get handleMode(): boolean {\n    return this.enabled && this.host.rowReordering?.handle !== false;\n  }\n\n  /**\n   * Whether the leading grip-handle column is rendered. Only in handle mode, and\n   * only while reordering is enabled.\n   */\n  public get showHandleColumn(): boolean {\n    return this.handleMode;\n  }\n\n  /** Whether moves also splice {@link ApexGrid.data} in place. */\n  public get applyToData(): boolean {\n    return Boolean(this.host.rowReordering?.applyToData);\n  }\n\n  /** Whether a manual order is currently active. */\n  public get hasManualOrder(): boolean {\n    return this.#order !== null;\n  }\n\n  /** Whether a row is currently grabbed for keyboard reorder. */\n  public get isGrabbing(): boolean {\n    return this.grabbed !== null;\n  }\n\n  /**\n   * Pipeline step: reorders the (post-filter, post-sort) rows by the manual\n   * order. Rows absent from the manual order (e.g. newly added) keep their\n   * incoming relative order at the end. Identity pass-through when inactive.\n   */\n  public apply(rows: T[]): T[] {\n    if (!this.#order) return rows;\n    const rank = new Map<T, number>();\n    this.#order.forEach((row, i) => {\n      rank.set(row, i);\n    });\n    return [...rows].sort((a, b) => {\n      const ra = rank.has(a) ? (rank.get(a) as number) : Number.POSITIVE_INFINITY;\n      const rb = rank.has(b) ? (rank.get(b) as number) : Number.POSITIVE_INFINITY;\n      return ra - rb;\n    });\n  }\n\n  /**\n   * The current manual order as a copy of its row references, or `null` for the\n   * derived order. Consumed by `ApexGrid.getState`.\n   */\n  public getManualOrder(): T[] | null {\n    return this.#order ? [...this.#order] : null;\n  }\n\n  /**\n   * Restores a manual order from a list of row references (state restore). Pass\n   * `null` (or an empty list) to clear it. Silent: emits no `rowMoving` /\n   * `rowMoved` and does not animate; re-runs the pipeline.\n   */\n  public restoreManualOrder(order: T[] | null): void {\n    this.#order = order?.length ? [...order] : null;\n    this.host.requestUpdate(PIPELINE);\n  }\n\n  /**\n   * Clears the manual order (e.g. when a sort is applied). Re-runs the pipeline.\n   */\n  public clearManualOrder(announce = false): void {\n    if (!this.#order) return;\n    this.#order = null;\n    this.host.requestUpdate(PIPELINE);\n    if (announce) this.host.announce(this.host.localize('announce.manualOrderCleared'));\n  }\n\n  /**\n   * Moves the row at view index `from` relative to the row at view index `to`.\n   * Indices are into {@link ApexGrid.pageItems}.\n   *\n   * @returns `true` when applied, `false` when disabled, out of range, or\n   * cancelled via `rowMoving`.\n   */\n  public moveRow(from: number, to: number, position: RowDropPosition = 'before'): boolean {\n    const view = this.host.pageItems;\n    const before = this.#captureRowRects();\n    const ok = this.#commit(view[from] as T, view[to] as T, position);\n    if (ok) void this.#flipAfterUpdate(before);\n    return ok;\n  }\n\n  // --- pointer drag -------------------------------------------------------\n\n  /**\n   * Begins a pointer drag from `source`. When `ghost` is supplied (the pointer\n   * path always does), seeds the floating ghost from the source row's rect and\n   * the grab point so it stays anchored under the cursor.\n   */\n  public startDrag(source: T, ghost?: RowGhostInit): void {\n    if (!this.enabled) return;\n    this.dragging = source;\n    this.ghost = ghost\n      ? {\n          x: ghost.rect.left,\n          y: ghost.rect.top,\n          width: ghost.rect.width,\n          height: ghost.rect.height,\n          pointerOffsetX: ghost.clientX - ghost.rect.left,\n          pointerOffsetY: ghost.clientY - ghost.rect.top,\n          cells: ghost.cells,\n        }\n      : null;\n    this.host.requestUpdate();\n  }\n\n  /** Moves the floating ghost to track the cursor. No-op without an active ghost. */\n  public moveGhost(clientX: number, clientY: number): void {\n    if (!this.ghost) return;\n    this.ghost = {\n      ...this.ghost,\n      x: clientX - this.ghost.pointerOffsetX,\n      y: clientY - this.ghost.pointerOffsetY,\n    };\n    this.host.requestUpdate();\n  }\n\n  /**\n   * Called on pointer-move during a drag: live-swaps the dragged row past the\n   * body row currently under `clientY` once the cursor crosses its midpoint.\n   */\n  public dragOver(clientY: number): void {\n    if (!this.dragging || this.#swapping) return;\n    const target = this.#bodyRowAt(clientY);\n    if (!target || target.data === this.dragging) return;\n\n    const view = this.host.pageItems;\n    const sourceIdx = view.indexOf(this.dragging);\n    const targetIdx = view.indexOf(target.data);\n    if (sourceIdx === -1 || targetIdx === -1) return;\n\n    const rect = target.element.getBoundingClientRect();\n    const midpoint = rect.top + rect.height / 2;\n    let position: RowDropPosition;\n    if (sourceIdx < targetIdx) {\n      if (clientY < midpoint) return; // dragging down — wait for the midpoint\n      position = 'after';\n    } else {\n      if (clientY > midpoint) return; // dragging up\n      position = 'before';\n    }\n    void this.#dragSwap(target.data, position);\n  }\n\n  /** Ends the pointer drag. The order is already final (live-swapped). */\n  public endDrag(): void {\n    if (!this.dragging) return;\n    this.dragging = null;\n    this.ghost = null;\n    this.host.requestUpdate();\n  }\n\n  /**\n   * Arms a pointer drag from a row press. Called by the row on `pointerdown`\n   * (from the grip in handle mode, or anywhere in whole-row mode). The move /\n   * up / cancel listeners are bound to the **grid host**, so the gesture is\n   * immune to the source row's DOM being recycled by a live-swap. `getGhost` is\n   * a thunk the controller invokes once, the instant the drag engages, to\n   * snapshot the row's cells (the row is still in place then).\n   */\n  public armPointerDrag(data: T, getGhost: () => RowGhostInit, event: PointerEvent): void {\n    const pinned = this.host.pinnedRows;\n    if (!this.enabled || pinned.top.includes(data) || pinned.bottom.includes(data)) return;\n    this.#pending = {\n      data,\n      getGhost,\n      startX: event.clientX,\n      startY: event.clientY,\n      pointerId: event.pointerId,\n    };\n    const host = this.#hostElement;\n    host.addEventListener('pointermove', this.#onHostPointerMove);\n    host.addEventListener('pointerup', this.#onHostPointerUp);\n    host.addEventListener('pointercancel', this.#onHostPointerUp);\n  }\n\n  #onHostPointerMove = (event: PointerEvent): void => {\n    const pending = this.#pending;\n    if (!pending || event.pointerId !== pending.pointerId) return;\n    if (!this.dragging) {\n      const dx = event.clientX - pending.startX;\n      const dy = event.clientY - pending.startY;\n      if (Math.hypot(dx, dy) < DRAG_THRESHOLD_PX) return;\n      // Capture on the stable host so moves keep arriving even when the cursor\n      // leaves the grid, and so the source row reflowing can't drop the pointer.\n      try {\n        this.#hostElement.setPointerCapture(pending.pointerId);\n      } catch {\n        /* a synthetic pointer id may not be capturable; hit-testing still works */\n      }\n      this.startDrag(pending.data, pending.getGhost());\n    }\n    this.moveGhost(event.clientX, event.clientY);\n    this.dragOver(event.clientY);\n  };\n\n  #onHostPointerUp = (event: PointerEvent): void => {\n    const pending = this.#pending;\n    if (!pending || event.pointerId !== pending.pointerId) return;\n    const host = this.#hostElement;\n    host.removeEventListener('pointermove', this.#onHostPointerMove);\n    host.removeEventListener('pointerup', this.#onHostPointerUp);\n    host.removeEventListener('pointercancel', this.#onHostPointerUp);\n    try {\n      if (host.hasPointerCapture(pending.pointerId)) host.releasePointerCapture(pending.pointerId);\n    } catch {\n      /* capture was never taken or already released */\n    }\n    this.#pending = null;\n    this.endDrag();\n  };\n\n  async #dragSwap(target: T, position: RowDropPosition): Promise<void> {\n    if (this.#swapping) return;\n    this.#swapping = true;\n    try {\n      const before = this.#captureRowRects();\n      if (this.#commit(this.dragging as T, target, position)) {\n        await this.host.updateComplete;\n        await awaitChildUpdates(this.host.rows);\n        this.#playRowFlip(before);\n      }\n    } finally {\n      this.#swapping = false;\n    }\n  }\n\n  // --- keyboard grab ------------------------------------------------------\n\n  /** Grabs the row at view index `rowIndex` for keyboard reorder. */\n  public grab(rowIndex: number): boolean {\n    if (!this.enabled) return false;\n    const row = this.host.pageItems[rowIndex] as T | undefined;\n    if (!row) return false;\n    this.grabbed = row;\n    this.#preGrab = this.#order ? [...this.#order] : null;\n    this.host.requestUpdate();\n    this.host.announce(this.host.localize('announce.rowGrabbed'));\n    return true;\n  }\n\n  /**\n   * Moves the grabbed row one position in `direction`. Returns the grabbed\n   * row's new view index, or `-1` when it can't move (no grab / at the edge).\n   */\n  public moveGrabbed(direction: -1 | 1): number {\n    if (!this.grabbed) return -1;\n    const view = this.host.pageItems;\n    const current = view.indexOf(this.grabbed);\n    const target = current + direction;\n    if (current === -1 || target < 0 || target >= view.length) return -1;\n    const before = this.#captureRowRects();\n    const ok = this.#commit(this.grabbed, view[target] as T, direction > 0 ? 'after' : 'before', {\n      silent: true,\n    });\n    if (!ok) return -1;\n    void this.#flipAfterUpdate(before);\n    this.host.announce(this.host.localize('announce.rowMovedTo', { position: target + 1 }));\n    return target;\n  }\n\n  /** Drops the grabbed row, keeping its moves. */\n  public drop(): void {\n    if (!this.grabbed) return;\n    this.grabbed = null;\n    this.#preGrab = null;\n    this.host.requestUpdate();\n    this.host.announce(this.host.localize('announce.rowDropped'));\n  }\n\n  /** Cancels the grab, reverting to the order captured when it was grabbed. */\n  public cancelGrab(): void {\n    if (!this.grabbed) return;\n    this.grabbed = null;\n    this.#order = this.#preGrab;\n    this.#preGrab = null;\n    this.host.requestUpdate(PIPELINE);\n    this.host.announce(this.host.localize('announce.reorderCancelled'));\n  }\n\n  // --- internals ----------------------------------------------------------\n\n  /**\n   * The core order mutation: validates, emits `rowMoving` (cancellable),\n   * updates the manual order (or splices data when `applyToData`), re-runs the\n   * pipeline, and emits `rowMoved`. Does not animate.\n   */\n  #commit(\n    source: T | undefined,\n    target: T | undefined,\n    position: RowDropPosition,\n    options: { silent?: boolean } = {}\n  ): boolean {\n    if (!this.enabled || !source || !target || source === target) return false;\n    const view = this.host.pageItems;\n    const from = view.indexOf(source);\n    const to = view.indexOf(target);\n\n    const proceed = this.host.emitEvent('rowMoving', {\n      detail: { from, to, data: source },\n      cancelable: true,\n    });\n    if (!proceed) return false;\n\n    const baseline = this.#order ?? [...(this.host.dataView as ReadonlyArray<T>)];\n    const next = baseline.filter((row) => row !== source);\n    let index = next.indexOf(target);\n    if (index === -1) return false;\n    if (position === 'after') index += 1;\n    next.splice(index, 0, source);\n\n    if (this.applyToData) {\n      this.#spliceData(next);\n      this.#order = null; // the data array now carries the order\n    } else {\n      this.#order = next;\n    }\n\n    this.host.requestUpdate(PIPELINE);\n    if (!options.silent) this.host.announce(this.host.localize('announce.rowMoved'));\n    this.host.emitEvent('rowMoved', { detail: { from, to, data: source } });\n    return true;\n  }\n\n  /** Reorders {@link ApexGrid.data} in place to match `order`. */\n  #spliceData(order: ReadonlyArray<T>): void {\n    const rank = new Map<T, number>();\n    order.forEach((row, i) => {\n      rank.set(row, i);\n    });\n    (this.host.data as T[]).sort((a, b) => {\n      const ra = rank.has(a) ? (rank.get(a) as number) : Number.POSITIVE_INFINITY;\n      const rb = rank.has(b) ? (rank.get(b) as number) : Number.POSITIVE_INFINITY;\n      return ra - rb;\n    });\n  }\n\n  /** The rendered body row (non-pinned) whose box contains `clientY`. */\n  #bodyRowAt(clientY: number): { data: T; element: HTMLElement } | null {\n    const pinned = this.host.pinnedRows;\n    for (const row of this.host.rows) {\n      if (pinned.top.includes(row.data) || pinned.bottom.includes(row.data)) continue;\n      const element = row as unknown as HTMLElement;\n      const rect = element.getBoundingClientRect();\n      if (clientY >= rect.top && clientY < rect.bottom) return { data: row.data, element };\n    }\n    return null;\n  }\n\n  #captureRowRects(): KeyedFlipEntry<T>[] {\n    const entries: KeyedFlipEntry<T>[] = [];\n    for (const row of this.host.rows) {\n      const el = row as unknown as HTMLElement;\n      entries.push({ key: row.data, rect: el.getBoundingClientRect() });\n    }\n    return entries;\n  }\n\n  async #flipAfterUpdate(before: ReadonlyArray<KeyedFlipEntry<T>>): Promise<void> {\n    await this.host.updateComplete;\n    await awaitChildUpdates(this.host.rows);\n    this.#playRowFlip(before);\n  }\n\n  #playRowFlip(before: ReadonlyArray<KeyedFlipEntry<T>>): void {\n    const byData = new Map<T, HTMLElement>();\n    for (const row of this.host.rows) {\n      byData.set(row.data, row as unknown as HTMLElement);\n    }\n    playKeyedFlip(before, (data) => byData.get(data) ?? null, 'y');\n  }\n}\n"]}

package/controllers/selection.js

@@ -151,13 +151,13 @@ export class SelectionController {
         this.host.requestUpdate();
         const total = this.selected.size;
         if (total === 0) {
-            this.host.announce('Selection cleared');
+            this.host.announce(this.host.localize('announce.selectionCleared'));
         }
         else if (added.length === 1 && removed.length === 0 && total === 1) {
-            this.host.announce('1 row selected');
+            this.host.announce(this.host.localize('announce.rowSelected'));
         }
         else {
-            this.host.announce(`${total} rows selected`);
+            this.host.announce(this.host.localize('announce.rowsSelected', { count: total }));
         }
         this.host.emitEvent('rowSelected', {
             detail: { added, removed, selected: Array.from(this.selected) },

package/controllers/selection.js.map

@@ -1 +1 @@
-{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/controllers/selection.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController } from 'lit';\nimport type { GridHost, SelectionMode } from '../internal/types.js';\n\n/**\n * The default selection configuration used when the grid has none set.\n */\nexport const DEFAULT_SELECTION_CONFIG = Object.freeze({\n  enabled: false,\n  mode: 'multiple' as SelectionMode,\n  showCheckboxColumn: false,\n});\n\n/**\n * Reactive controller backing row selection.\n *\n * @remarks\n * Selection state is reference-based — the controller holds a `Set` of row\n * data references so the selection survives sort / filter / pagination as\n * long as those operations preserve identities (the default in-place\n * pipeline does). Replacing {@link ApexGrid.data} wholesale will invalidate\n * any selected rows that are no longer present in the new array; consumers\n * should call {@link clear} or re-apply selection after such a change.\n *\n * Mutations go through the cancellable `rowSelecting` event and emit a\n * follow-up `rowSelected` event, mirroring the pattern used by editing.\n */\nexport class SelectionController<T extends object> implements ReactiveController {\n  /** Set of currently selected row data references. */\n  public selected: Set<T> = new Set();\n\n  /**\n   * Anchor row for Shift+click range selection. Set whenever a single row\n   * is toggled / picked so a follow-up Shift+click knows where to start.\n   */\n  public anchor: T | null = null;\n\n  constructor(protected host: GridHost<T>) {\n    this.host.addController(this);\n  }\n\n  public hostConnected() {}\n\n  /**\n   * Whether selection is enabled at the grid level.\n   */\n  public get enabled(): boolean {\n    return Boolean(this.host.selection?.enabled);\n  }\n\n  /**\n   * The resolved selection mode (`'multiple'` if unset).\n   */\n  public get mode(): SelectionMode {\n    return this.host.selection?.mode ?? DEFAULT_SELECTION_CONFIG.mode;\n  }\n\n  /**\n   * Whether to render the built-in checkbox column.\n   */\n  public get showCheckboxColumn(): boolean {\n    return (\n      this.enabled &&\n      (this.host.selection?.showCheckboxColumn ?? DEFAULT_SELECTION_CONFIG.showCheckboxColumn)\n    );\n  }\n\n  /**\n   * Whether the given row is currently selected.\n   */\n  public isSelected(row: T): boolean {\n    return this.selected.has(row);\n  }\n\n  /**\n   * Returns the currently selected rows in insertion order.\n   */\n  public selectedRows(): T[] {\n    return Array.from(this.selected);\n  }\n\n  /**\n   * Whether every row in the current view ({@link ApexGrid.dataView}) is\n   * selected. Used by the header checkbox to render its \"all\" state.\n   */\n  public allSelected(): boolean {\n    const view = this.host.dataView;\n    if (view.length === 0) return false;\n    return view.every((row) => this.selected.has(row as T));\n  }\n\n  /**\n   * Whether some — but not all — rows in the current view are selected.\n   * Used to render the header checkbox in its indeterminate state.\n   */\n  public someSelected(): boolean {\n    if (this.selected.size === 0) return false;\n    if (this.allSelected()) return false;\n    return true;\n  }\n\n  /**\n   * Toggles selection of `row`. In `'single'` mode this either selects the\n   * row (replacing any previous selection) or deselects it if it was the\n   * only selected row.\n   */\n  public async toggleRow(row: T): Promise<boolean> {\n    if (!this.enabled) return false;\n    const next = new Set(this.selected);\n    if (next.has(row)) {\n      next.delete(row);\n    } else {\n      if (this.mode === 'single') next.clear();\n      next.add(row);\n    }\n    this.anchor = next.has(row) ? row : null;\n    return this.#commit(next);\n  }\n\n  /**\n   * Adds `row` to the selection. In `'single'` mode the existing selection\n   * is cleared first.\n   */\n  public async selectRow(row: T): Promise<boolean> {\n    if (!this.enabled) return false;\n    const next = new Set(this.mode === 'single' ? [] : this.selected);\n    next.add(row);\n    this.anchor = row;\n    return this.#commit(next);\n  }\n\n  /**\n   * Removes `row` from the selection.\n   */\n  public async deselectRow(row: T): Promise<boolean> {\n    if (!this.enabled) return false;\n    if (!this.selected.has(row)) return true;\n    const next = new Set(this.selected);\n    next.delete(row);\n    return this.#commit(next);\n  }\n\n  /**\n   * Adds `row` to the selection without affecting other selected rows\n   * (`'multiple'` mode only). In `'single'` mode this behaves like\n   * {@link selectRow}.\n   */\n  public async additiveToggle(row: T): Promise<boolean> {\n    if (!this.enabled) return false;\n    if (this.mode === 'single') return this.toggleRow(row);\n    const next = new Set(this.selected);\n    if (next.has(row)) {\n      next.delete(row);\n    } else {\n      next.add(row);\n    }\n    this.anchor = next.has(row) ? row : this.anchor;\n    return this.#commit(next);\n  }\n\n  /**\n   * Selects every row between {@link anchor} and `row` (inclusive) in the\n   * current page view. No-op in `'single'` mode or when no anchor is set —\n   * in those cases the call falls back to a plain {@link selectRow}.\n   */\n  public async rangeToggle(row: T): Promise<boolean> {\n    if (!this.enabled) return false;\n    if (this.mode === 'single' || !this.anchor) {\n      return this.selectRow(row);\n    }\n    const pageItems = this.host.pageItems as ReadonlyArray<T>;\n    const startIdx = pageItems.indexOf(this.anchor);\n    const endIdx = pageItems.indexOf(row);\n    if (startIdx === -1 || endIdx === -1) {\n      return this.selectRow(row);\n    }\n    const [lo, hi] = startIdx < endIdx ? [startIdx, endIdx] : [endIdx, startIdx];\n    const next = new Set(this.selected);\n    for (let i = lo; i <= hi; i++) {\n      next.add(pageItems[i] as T);\n    }\n    return this.#commit(next);\n  }\n\n  /**\n   * Selects every row currently in view ({@link ApexGrid.dataView}). No-op\n   * in `'single'` mode.\n   */\n  public async selectAll(): Promise<boolean> {\n    if (!this.enabled || this.mode === 'single') return false;\n    const next = new Set(this.host.dataView as ReadonlyArray<T>);\n    return this.#commit(next);\n  }\n\n  /**\n   * Clears the selection.\n   */\n  public async clear(): Promise<boolean> {\n    if (this.selected.size === 0) return true;\n    return this.#commit(new Set());\n  }\n\n  /**\n   * Replaces the current selection with `rows`. Used by the public\n   * {@link ApexGrid.selectedRows} setter so callers can drive selection\n   * programmatically. Single-mode keeps at most one row.\n   */\n  public async replaceSelection(rows: ReadonlyArray<T>): Promise<boolean> {\n    if (!this.enabled) return false;\n    const next = new Set(this.mode === 'single' ? rows.slice(0, 1) : rows);\n    return this.#commit(next);\n  }\n\n  async #commit(next: Set<T>): Promise<boolean> {\n    const added: T[] = [];\n    const removed: T[] = [];\n    for (const row of next) {\n      if (!this.selected.has(row)) added.push(row);\n    }\n    for (const row of this.selected) {\n      if (!next.has(row)) removed.push(row);\n    }\n    if (added.length === 0 && removed.length === 0) return true;\n\n    const proceed = this.host.emitEvent('rowSelecting', {\n      detail: {\n        added,\n        removed,\n        current: Array.from(this.selected),\n        next: Array.from(next),\n      },\n      cancelable: true,\n    });\n    if (!proceed) return false;\n\n    this.selected = next;\n    this.host.requestUpdate();\n\n    const total = this.selected.size;\n    if (total === 0) {\n      this.host.announce('Selection cleared');\n    } else if (added.length === 1 && removed.length === 0 && total === 1) {\n      this.host.announce('1 row selected');\n    } else {\n      this.host.announce(`${total} rows selected`);\n    }\n\n    this.host.emitEvent('rowSelected', {\n      detail: { added, removed, selected: Array.from(this.selected) },\n    });\n    return true;\n  }\n}\n"]}
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/controllers/selection.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController } from 'lit';\nimport type { GridHost, SelectionMode } from '../internal/types.js';\n\n/**\n * The default selection configuration used when the grid has none set.\n */\nexport const DEFAULT_SELECTION_CONFIG = Object.freeze({\n  enabled: false,\n  mode: 'multiple' as SelectionMode,\n  showCheckboxColumn: false,\n});\n\n/**\n * Reactive controller backing row selection.\n *\n * @remarks\n * Selection state is reference-based — the controller holds a `Set` of row\n * data references so the selection survives sort / filter / pagination as\n * long as those operations preserve identities (the default in-place\n * pipeline does). Replacing {@link ApexGrid.data} wholesale will invalidate\n * any selected rows that are no longer present in the new array; consumers\n * should call {@link clear} or re-apply selection after such a change.\n *\n * Mutations go through the cancellable `rowSelecting` event and emit a\n * follow-up `rowSelected` event, mirroring the pattern used by editing.\n */\nexport class SelectionController<T extends object> implements ReactiveController {\n  /** Set of currently selected row data references. */\n  public selected: Set<T> = new Set();\n\n  /**\n   * Anchor row for Shift+click range selection. Set whenever a single row\n   * is toggled / picked so a follow-up Shift+click knows where to start.\n   */\n  public anchor: T | null = null;\n\n  constructor(protected host: GridHost<T>) {\n    this.host.addController(this);\n  }\n\n  public hostConnected() {}\n\n  /**\n   * Whether selection is enabled at the grid level.\n   */\n  public get enabled(): boolean {\n    return Boolean(this.host.selection?.enabled);\n  }\n\n  /**\n   * The resolved selection mode (`'multiple'` if unset).\n   */\n  public get mode(): SelectionMode {\n    return this.host.selection?.mode ?? DEFAULT_SELECTION_CONFIG.mode;\n  }\n\n  /**\n   * Whether to render the built-in checkbox column.\n   */\n  public get showCheckboxColumn(): boolean {\n    return (\n      this.enabled &&\n      (this.host.selection?.showCheckboxColumn ?? DEFAULT_SELECTION_CONFIG.showCheckboxColumn)\n    );\n  }\n\n  /**\n   * Whether the given row is currently selected.\n   */\n  public isSelected(row: T): boolean {\n    return this.selected.has(row);\n  }\n\n  /**\n   * Returns the currently selected rows in insertion order.\n   */\n  public selectedRows(): T[] {\n    return Array.from(this.selected);\n  }\n\n  /**\n   * Whether every row in the current view ({@link ApexGrid.dataView}) is\n   * selected. Used by the header checkbox to render its \"all\" state.\n   */\n  public allSelected(): boolean {\n    const view = this.host.dataView;\n    if (view.length === 0) return false;\n    return view.every((row) => this.selected.has(row as T));\n  }\n\n  /**\n   * Whether some — but not all — rows in the current view are selected.\n   * Used to render the header checkbox in its indeterminate state.\n   */\n  public someSelected(): boolean {\n    if (this.selected.size === 0) return false;\n    if (this.allSelected()) return false;\n    return true;\n  }\n\n  /**\n   * Toggles selection of `row`. In `'single'` mode this either selects the\n   * row (replacing any previous selection) or deselects it if it was the\n   * only selected row.\n   */\n  public async toggleRow(row: T): Promise<boolean> {\n    if (!this.enabled) return false;\n    const next = new Set(this.selected);\n    if (next.has(row)) {\n      next.delete(row);\n    } else {\n      if (this.mode === 'single') next.clear();\n      next.add(row);\n    }\n    this.anchor = next.has(row) ? row : null;\n    return this.#commit(next);\n  }\n\n  /**\n   * Adds `row` to the selection. In `'single'` mode the existing selection\n   * is cleared first.\n   */\n  public async selectRow(row: T): Promise<boolean> {\n    if (!this.enabled) return false;\n    const next = new Set(this.mode === 'single' ? [] : this.selected);\n    next.add(row);\n    this.anchor = row;\n    return this.#commit(next);\n  }\n\n  /**\n   * Removes `row` from the selection.\n   */\n  public async deselectRow(row: T): Promise<boolean> {\n    if (!this.enabled) return false;\n    if (!this.selected.has(row)) return true;\n    const next = new Set(this.selected);\n    next.delete(row);\n    return this.#commit(next);\n  }\n\n  /**\n   * Adds `row` to the selection without affecting other selected rows\n   * (`'multiple'` mode only). In `'single'` mode this behaves like\n   * {@link selectRow}.\n   */\n  public async additiveToggle(row: T): Promise<boolean> {\n    if (!this.enabled) return false;\n    if (this.mode === 'single') return this.toggleRow(row);\n    const next = new Set(this.selected);\n    if (next.has(row)) {\n      next.delete(row);\n    } else {\n      next.add(row);\n    }\n    this.anchor = next.has(row) ? row : this.anchor;\n    return this.#commit(next);\n  }\n\n  /**\n   * Selects every row between {@link anchor} and `row` (inclusive) in the\n   * current page view. No-op in `'single'` mode or when no anchor is set —\n   * in those cases the call falls back to a plain {@link selectRow}.\n   */\n  public async rangeToggle(row: T): Promise<boolean> {\n    if (!this.enabled) return false;\n    if (this.mode === 'single' || !this.anchor) {\n      return this.selectRow(row);\n    }\n    const pageItems = this.host.pageItems as ReadonlyArray<T>;\n    const startIdx = pageItems.indexOf(this.anchor);\n    const endIdx = pageItems.indexOf(row);\n    if (startIdx === -1 || endIdx === -1) {\n      return this.selectRow(row);\n    }\n    const [lo, hi] = startIdx < endIdx ? [startIdx, endIdx] : [endIdx, startIdx];\n    const next = new Set(this.selected);\n    for (let i = lo; i <= hi; i++) {\n      next.add(pageItems[i] as T);\n    }\n    return this.#commit(next);\n  }\n\n  /**\n   * Selects every row currently in view ({@link ApexGrid.dataView}). No-op\n   * in `'single'` mode.\n   */\n  public async selectAll(): Promise<boolean> {\n    if (!this.enabled || this.mode === 'single') return false;\n    const next = new Set(this.host.dataView as ReadonlyArray<T>);\n    return this.#commit(next);\n  }\n\n  /**\n   * Clears the selection.\n   */\n  public async clear(): Promise<boolean> {\n    if (this.selected.size === 0) return true;\n    return this.#commit(new Set());\n  }\n\n  /**\n   * Replaces the current selection with `rows`. Used by the public\n   * {@link ApexGrid.selectedRows} setter so callers can drive selection\n   * programmatically. Single-mode keeps at most one row.\n   */\n  public async replaceSelection(rows: ReadonlyArray<T>): Promise<boolean> {\n    if (!this.enabled) return false;\n    const next = new Set(this.mode === 'single' ? rows.slice(0, 1) : rows);\n    return this.#commit(next);\n  }\n\n  async #commit(next: Set<T>): Promise<boolean> {\n    const added: T[] = [];\n    const removed: T[] = [];\n    for (const row of next) {\n      if (!this.selected.has(row)) added.push(row);\n    }\n    for (const row of this.selected) {\n      if (!next.has(row)) removed.push(row);\n    }\n    if (added.length === 0 && removed.length === 0) return true;\n\n    const proceed = this.host.emitEvent('rowSelecting', {\n      detail: {\n        added,\n        removed,\n        current: Array.from(this.selected),\n        next: Array.from(next),\n      },\n      cancelable: true,\n    });\n    if (!proceed) return false;\n\n    this.selected = next;\n    this.host.requestUpdate();\n\n    const total = this.selected.size;\n    if (total === 0) {\n      this.host.announce(this.host.localize('announce.selectionCleared'));\n    } else if (added.length === 1 && removed.length === 0 && total === 1) {\n      this.host.announce(this.host.localize('announce.rowSelected'));\n    } else {\n      this.host.announce(this.host.localize('announce.rowsSelected', { count: total }));\n    }\n\n    this.host.emitEvent('rowSelected', {\n      detail: { added, removed, selected: Array.from(this.selected) },\n    });\n    return true;\n  }\n}\n"]}