apex-grid 3.1.0 → 3.3.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('Manual row order cleared');
+    }
+    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('Row grabbed. Use arrow keys to move, Enter to drop, Escape to cancel.');
+        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(`Row moved to position ${target + 1}`);
+        return target;
+    }
+    drop() {
+        if (!this.grabbed)
+            return;
+        this.grabbed = null;
+        this.#preGrab = null;
+        this.host.requestUpdate();
+        this.host.announce('Row dropped');
+    }
+    cancelGrab() {
+        if (!this.grabbed)
+            return;
+        this.grabbed = null;
+        this.#order = this.#preGrab;
+        this.#preGrab = null;
+        this.host.requestUpdate(PIPELINE);
+        this.host.announce('Reorder cancelled');
+    }
+    #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('Row moved');
+        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('Manual row order cleared');\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('Row grabbed. Use arrow keys to move, Enter to drop, Escape to cancel.');\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(`Row moved to 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('Row dropped');\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('Reorder cancelled');\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('Row moved');\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/sort.d.ts

@@ -6,7 +6,7 @@ export declare class SortController<T extends object> implements ReactiveControl
     protected host: GridHost<T>;
     constructor(host: GridHost<T>);
     state: SortState<T>;
-    sortFromHeaderClick(column: ColumnConfiguration<T>): Promise<void>;
+    sortFromHeaderClick(column: ColumnConfiguration<T>, additive?: boolean): Promise<void>;
     prepareExpression({ key, sort: options }: ColumnConfiguration<T>): SortExpression<T>;
     reset(key?: Keys<T>): void;
     protected _sort(expressions: SortExpression<T> | SortExpression<T>[]): void;

package/controllers/sort.js

@@ -56,12 +56,12 @@ export class SortController {
             ? this.reset(expression.key)
             : this.state.set(expression.key, { ...expression });
     }
-    async sortFromHeaderClick(column) {
+    async sortFromHeaderClick(column, additive = false) {
         const expression = this.prepareExpression(column);
         if (!this.#emitSortingEvent(expression)) {
             return;
         }
-        if (!this.#isMultipleSort) {
+        if (!this.#isMultipleSort || !additive) {
             this.reset();
         }
         const beforeRects = this.#captureRowRects();
@@ -108,8 +108,16 @@ export class SortController {
     reset(key) {
         key ? this.state.delete(key) : this.state.clear();
     }
+    get #rowReorder() {
+        return this.host.stateController.rowReorder;
+    }
     _sort(expressions) {
-        for (const expr of asArray(expressions)) {
+        const exprs = asArray(expressions);
+        const reorder = this.#rowReorder;
+        if (reorder?.hasManualOrder && exprs.some((expr) => expr.direction !== 'none')) {
+            reorder.clearManualOrder(true);
+        }
+        for (const expr of exprs) {
             this.#setExpression(expr);
         }
         this.host.requestUpdate(PIPELINE);

package/controllers/sort.js.map

@@ -1 +1 @@
-{"version":3,"file":"sort.js","sourceRoot":"","sources":["../../src/controllers/sort.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 {\n  ColumnConfiguration,\n  ColumnSortConfiguration,\n  GridHost,\n  Keys,\n} from '../internal/types.js';\nimport { asArray } from '../internal/utils.js';\nimport type { SortExpression, SortingDirection, SortState } from '../operations/sort/types.js';\n\nexport class SortController<T extends object> implements ReactiveController {\n  constructor(protected host: GridHost<T>) {\n    this.host.addController(this);\n  }\n\n  public state: SortState<T> = new Map();\n\n  get #isMultipleSort() {\n    return this.host.sortConfiguration.multiple;\n  }\n\n  get #isTriStateSort() {\n    return this.host.sortConfiguration.triState;\n  }\n\n  #resolveSortOptions(options?: boolean | ColumnSortConfiguration<T>) {\n    const expr: Pick<SortExpression<T>, 'caseSensitive' | 'comparer'> = {\n      caseSensitive: false,\n      comparer: undefined,\n    };\n\n    if (!options || typeof options === 'boolean') {\n      return expr as Partial<SortExpression<T>>;\n    }\n\n    return Object.assign(expr, {\n      caseSensitive: options.caseSensitive,\n      comparer: options.comparer,\n    }) as Partial<SortExpression<T>>;\n  }\n\n  #createDefaultExpression(key: Keys<T>) {\n    const options = this.host.getColumn(key)?.sort;\n\n    return {\n      key,\n      direction: 'ascending',\n      ...this.#resolveSortOptions(options),\n    } as SortExpression<T>;\n  }\n\n  #orderBy(dir?: SortingDirection): SortingDirection {\n    return this.#isTriStateSort\n      ? dir === 'ascending'\n        ? 'descending'\n        : dir === 'descending'\n          ? 'none'\n          : 'ascending'\n      : dir === 'ascending'\n        ? 'descending'\n        : 'ascending';\n  }\n\n  #emitSortingEvent(detail: SortExpression<T>) {\n    return this.host.emitEvent('sorting', { detail, cancelable: true });\n  }\n\n  #emitSortedEvent(detail: SortExpression<T>) {\n    return this.host.emitEvent('sorted', { detail });\n  }\n\n  #setExpression(expression: SortExpression<T>) {\n    expression.direction === 'none'\n      ? this.reset(expression.key)\n      : this.state.set(expression.key, { ...expression });\n  }\n\n  public async sortFromHeaderClick(column: ColumnConfiguration<T>) {\n    const expression = this.prepareExpression(column);\n\n    if (!this.#emitSortingEvent(expression)) {\n      return;\n    }\n\n    if (!this.#isMultipleSort) {\n      this.reset();\n    }\n\n    // Capture visible-row rects keyed by data identity BEFORE the pipeline\n    // runs. After the new render the virtualizer will have repositioned\n    // rows; we use those captured rects as the \"First\" of a FLIP and\n    // animate each row from its old viewport position back to identity.\n    const beforeRects = this.#captureRowRects();\n\n    this._sort(expression);\n\n    await this.host.updateComplete;\n    // Wait for body row updates so the new data is committed to each row\n    // element before measuring the \"Last\" rect — otherwise the captured-\n    // before and measured-after rects match and the animation no-ops.\n    await awaitChildUpdates(this.host.rows);\n    this.#playRowFlip(beforeRects);\n    this.#announce(expression, column);\n    this.#emitSortedEvent(expression);\n  }\n\n  #announce(expression: SortExpression<T>, column: ColumnConfiguration<T>) {\n    const label = column.headerText ?? String(column.key);\n    const message =\n      expression.direction === 'none'\n        ? `Sort cleared on ${label}`\n        : `Sorted by ${label} ${expression.direction}`;\n    this.host.announce(message);\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  #playRowFlip(before: ReadonlyArray<KeyedFlipEntry<T>>) {\n    // After sort, the same data may be rendered by a different `<apex-grid-row>`\n    // DOM element (virtualizer recycles rows). Resolve by data identity.\n    const rows = this.host.rows;\n    const byData = new Map<T, HTMLElement>();\n    for (const row of rows) {\n      byData.set(row.data, row as unknown as HTMLElement);\n    }\n    playKeyedFlip(before, (data) => byData.get(data) ?? null, 'y');\n  }\n\n  public prepareExpression({ key, sort: options }: ColumnConfiguration<T>): SortExpression<T> {\n    if (this.state.has(key)) {\n      const expr = this.state.get(key)!;\n\n      return Object.assign(expr, {\n        direction: this.#orderBy(expr.direction),\n        ...this.#resolveSortOptions(options),\n      });\n    }\n\n    // Initial state\n    return this.#createDefaultExpression(key);\n  }\n\n  public reset(key?: Keys<T>) {\n    key ? this.state.delete(key) : this.state.clear();\n  }\n\n  protected _sort(expressions: SortExpression<T> | SortExpression<T>[]) {\n    for (const expr of asArray(expressions)) {\n      this.#setExpression(expr);\n    }\n\n    this.host.requestUpdate(PIPELINE);\n  }\n\n  public sort(expressions: SortExpression<T> | SortExpression<T>[]) {\n    this._sort(\n      asArray(expressions).map((expr) =>\n        Object.assign(this.state.get(expr.key) ?? this.#createDefaultExpression(expr.key), expr)\n      )\n    );\n  }\n\n  public hostConnected() {}\n}\n"]}
+{"version":3,"file":"sort.js","sourceRoot":"","sources":["../../src/controllers/sort.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 {\n  ColumnConfiguration,\n  ColumnSortConfiguration,\n  GridHost,\n  Keys,\n} from '../internal/types.js';\nimport { asArray } from '../internal/utils.js';\nimport type { SortExpression, SortingDirection, SortState } from '../operations/sort/types.js';\n\nexport class SortController<T extends object> implements ReactiveController {\n  constructor(protected host: GridHost<T>) {\n    this.host.addController(this);\n  }\n\n  public state: SortState<T> = new Map();\n\n  get #isMultipleSort() {\n    return this.host.sortConfiguration.multiple;\n  }\n\n  get #isTriStateSort() {\n    return this.host.sortConfiguration.triState;\n  }\n\n  #resolveSortOptions(options?: boolean | ColumnSortConfiguration<T>) {\n    const expr: Pick<SortExpression<T>, 'caseSensitive' | 'comparer'> = {\n      caseSensitive: false,\n      comparer: undefined,\n    };\n\n    if (!options || typeof options === 'boolean') {\n      return expr as Partial<SortExpression<T>>;\n    }\n\n    return Object.assign(expr, {\n      caseSensitive: options.caseSensitive,\n      comparer: options.comparer,\n    }) as Partial<SortExpression<T>>;\n  }\n\n  #createDefaultExpression(key: Keys<T>) {\n    const options = this.host.getColumn(key)?.sort;\n\n    return {\n      key,\n      direction: 'ascending',\n      ...this.#resolveSortOptions(options),\n    } as SortExpression<T>;\n  }\n\n  #orderBy(dir?: SortingDirection): SortingDirection {\n    return this.#isTriStateSort\n      ? dir === 'ascending'\n        ? 'descending'\n        : dir === 'descending'\n          ? 'none'\n          : 'ascending'\n      : dir === 'ascending'\n        ? 'descending'\n        : 'ascending';\n  }\n\n  #emitSortingEvent(detail: SortExpression<T>) {\n    return this.host.emitEvent('sorting', { detail, cancelable: true });\n  }\n\n  #emitSortedEvent(detail: SortExpression<T>) {\n    return this.host.emitEvent('sorted', { detail });\n  }\n\n  #setExpression(expression: SortExpression<T>) {\n    expression.direction === 'none'\n      ? this.reset(expression.key)\n      : this.state.set(expression.key, { ...expression });\n  }\n\n  public async sortFromHeaderClick(column: ColumnConfiguration<T>, additive = false) {\n    const expression = this.prepareExpression(column);\n\n    if (!this.#emitSortingEvent(expression)) {\n      return;\n    }\n\n    // A plain click sorts by this column alone, clearing any other sorted\n    // columns. Only a Ctrl/Cmd+click while multi-sort is enabled keeps the\n    // existing sort keys and appends this column as an additional, lower-\n    // priority sort. Without this gate every plain click would accumulate a\n    // key, so a second column added behind a unique primary column would not\n    // change the visible order at all.\n    if (!this.#isMultipleSort || !additive) {\n      this.reset();\n    }\n\n    // Capture visible-row rects keyed by data identity BEFORE the pipeline\n    // runs. After the new render the virtualizer will have repositioned\n    // rows; we use those captured rects as the \"First\" of a FLIP and\n    // animate each row from its old viewport position back to identity.\n    const beforeRects = this.#captureRowRects();\n\n    this._sort(expression);\n\n    await this.host.updateComplete;\n    // Wait for body row updates so the new data is committed to each row\n    // element before measuring the \"Last\" rect — otherwise the captured-\n    // before and measured-after rects match and the animation no-ops.\n    await awaitChildUpdates(this.host.rows);\n    this.#playRowFlip(beforeRects);\n    this.#announce(expression, column);\n    this.#emitSortedEvent(expression);\n  }\n\n  #announce(expression: SortExpression<T>, column: ColumnConfiguration<T>) {\n    const label = column.headerText ?? String(column.key);\n    const message =\n      expression.direction === 'none'\n        ? `Sort cleared on ${label}`\n        : `Sorted by ${label} ${expression.direction}`;\n    this.host.announce(message);\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  #playRowFlip(before: ReadonlyArray<KeyedFlipEntry<T>>) {\n    // After sort, the same data may be rendered by a different `<apex-grid-row>`\n    // DOM element (virtualizer recycles rows). Resolve by data identity.\n    const rows = this.host.rows;\n    const byData = new Map<T, HTMLElement>();\n    for (const row of rows) {\n      byData.set(row.data, row as unknown as HTMLElement);\n    }\n    playKeyedFlip(before, (data) => byData.get(data) ?? null, 'y');\n  }\n\n  public prepareExpression({ key, sort: options }: ColumnConfiguration<T>): SortExpression<T> {\n    if (this.state.has(key)) {\n      const expr = this.state.get(key)!;\n\n      return Object.assign(expr, {\n        direction: this.#orderBy(expr.direction),\n        ...this.#resolveSortOptions(options),\n      });\n    }\n\n    // Initial state\n    return this.#createDefaultExpression(key);\n  }\n\n  public reset(key?: Keys<T>) {\n    key ? this.state.delete(key) : this.state.clear();\n  }\n\n  get #rowReorder() {\n    // @ts-expect-error - protected member access\n    return this.host.stateController.rowReorder as\n      | { hasManualOrder: boolean; clearManualOrder(announce?: boolean): void }\n      | undefined;\n  }\n\n  protected _sort(expressions: SortExpression<T> | SortExpression<T>[]) {\n    const exprs = asArray(expressions);\n    // Applying a sort is mutually exclusive with a manual row order (F5):\n    // a real sort (any non-`none` direction) clears it, with an announcement.\n    const reorder = this.#rowReorder;\n    if (reorder?.hasManualOrder && exprs.some((expr) => expr.direction !== 'none')) {\n      reorder.clearManualOrder(true);\n    }\n\n    for (const expr of exprs) {\n      this.#setExpression(expr);\n    }\n\n    this.host.requestUpdate(PIPELINE);\n  }\n\n  public sort(expressions: SortExpression<T> | SortExpression<T>[]) {\n    this._sort(\n      asArray(expressions).map((expr) =>\n        Object.assign(this.state.get(expr.key) ?? this.#createDefaultExpression(expr.key), expr)\n      )\n    );\n  }\n\n  public hostConnected() {}\n}\n"]}