@geotab/zenith 3.16.0 → 3.17.0-beta.1

package/dist/table/selectable/useDragSelection.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDragSelection = void 0;
+const react_1 = require("react");
+const zen_1 = require("../../utils/zen");
+const getRangeIds_1 = require("./utils/getRangeIds");
+const DRAG_CLASS = "zen-not-selectable";
+/**
+ * @param rows every checkbox row in render order, expanded nested rows included, so ranges can
+ * span nesting levels.
+ */
+const useDragSelection = (rows, gridRef, onBatchSelect, getBaseSelection, isSelectable, isEnabled) => {
+    const rowsRef = (0, react_1.useRef)(rows);
+    rowsRef.current = rows;
+    const getBaseSelectionRef = (0, react_1.useRef)(getBaseSelection);
+    getBaseSelectionRef.current = getBaseSelection;
+    const onBatchSelectRef = (0, react_1.useRef)(onBatchSelect);
+    onBatchSelectRef.current = onBatchSelect;
+    const isSelectableRef = (0, react_1.useRef)(isSelectable);
+    isSelectableRef.current = isSelectable;
+    const isEnabledRef = (0, react_1.useRef)(isEnabled);
+    isEnabledRef.current = isEnabled;
+    const anchorIdRef = (0, react_1.useRef)(null);
+    const anchorSelectRef = (0, react_1.useRef)(true);
+    const baseSelectedRef = (0, react_1.useRef)(new Set());
+    const isDraggingRef = (0, react_1.useRef)(false);
+    const movedRef = (0, react_1.useRef)(false);
+    const lastResultKeyRef = (0, react_1.useRef)("");
+    const lastPointRef = (0, react_1.useRef)(null);
+    const suppressNextChangeRef = (0, react_1.useRef)(false);
+    const attachedGridElementRef = (0, react_1.useRef)(null);
+    const emitRange = (0, react_1.useCallback)((currentId) => {
+        const anchorId = anchorIdRef.current;
+        if (anchorId === null) {
+            return;
+        }
+        const range = (0, getRangeIds_1.getRangeIds)(rowsRef.current, anchorId, currentId, isSelectableRef.current);
+        if (range.length === 0) {
+            return;
+        }
+        const select = anchorSelectRef.current;
+        const key = `${select}|${range.join(",")}`;
+        if (key === lastResultKeyRef.current) {
+            return;
+        }
+        lastResultKeyRef.current = key;
+        onBatchSelectRef.current(range, select, baseSelectedRef.current);
+    }, []);
+    const extend = (0, react_1.useCallback)((x, y) => {
+        var _a, _b;
+        lastPointRef.current = { x, y };
+        const row = (_b = (_a = zen_1.zen.document) === null || _a === void 0 ? void 0 : _a.elementFromPoint(x, y)) === null || _b === void 0 ? void 0 : _b.closest("[data-row-id]");
+        const currentId = row === null || row === void 0 ? void 0 : row.getAttribute("data-row-id");
+        if (!currentId) {
+            return;
+        }
+        if (currentId !== anchorIdRef.current) {
+            movedRef.current = true;
+        }
+        if (!movedRef.current) {
+            return;
+        }
+        emitRange(currentId);
+    }, [emitRange]);
+    const onMouseMove = (0, react_1.useCallback)((e) => {
+        extend(e.clientX, e.clientY);
+    }, [extend]);
+    const onScroll = (0, react_1.useCallback)(() => {
+        const point = lastPointRef.current;
+        if (point) {
+            extend(point.x, point.y);
+        }
+    }, [extend]);
+    const endDrag = (0, react_1.useCallback)(() => {
+        var _a, _b, _c, _d;
+        if (!isDraggingRef.current) {
+            return;
+        }
+        isDraggingRef.current = false;
+        if (movedRef.current) {
+            suppressNextChangeRef.current = true;
+        }
+        (_a = zen_1.zen.document) === null || _a === void 0 ? void 0 : _a.removeEventListener("mousemove", onMouseMove);
+        (_b = zen_1.zen.document) === null || _b === void 0 ? void 0 : _b.removeEventListener("mouseup", endDrag);
+        (_c = attachedGridElementRef.current) === null || _c === void 0 ? void 0 : _c.removeEventListener("scroll", onScroll);
+        (_d = attachedGridElementRef.current) === null || _d === void 0 ? void 0 : _d.classList.remove(DRAG_CLASS);
+        attachedGridElementRef.current = null;
+    }, [onMouseMove, onScroll]); // eslint-disable-line react-hooks/exhaustive-deps
+    const onCheckboxMouseDown = (0, react_1.useCallback)((id, checked, e) => {
+        var _a, _b, _c, _d, _e;
+        // Right-click between drag-end and the trailing click must not clear suppression.
+        if (e.button === 0) {
+            suppressNextChangeRef.current = false;
+        }
+        if (!isEnabledRef.current || e.button !== 0) {
+            return;
+        }
+        if (e.shiftKey && anchorIdRef.current !== null) {
+            e.preventDefault();
+            const anchorId = anchorIdRef.current;
+            const anchorInList = rowsRef.current.some(row => row.id === anchorId);
+            if (!anchorInList) {
+                // The anchor is no longer rendered (e.g. its parent was collapsed, or the list was
+                // re-filtered/paginated since). Drop the stale anchor and let the target row's own
+                // onChange fire normally, rather than swallowing it as a silent no-op.
+                anchorIdRef.current = null;
+                return;
+            }
+            // Gmail-style: every shift-click re-applies the range to the selection captured when
+            // the anchor was clicked, so moving the target closer to the anchor deselects the rows
+            // that dropped out of the range. Shift-clicking the anchor itself collapses the range
+            // to nothing, restoring that captured selection — the anchor included.
+            const range = id === anchorId ? [] : (0, getRangeIds_1.getRangeIds)(rowsRef.current, anchorId, id, isSelectableRef.current);
+            // Suppress even when the range is empty to prevent the anchor from double-toggling
+            // on a same-row shift-click.
+            suppressNextChangeRef.current = true;
+            onBatchSelectRef.current(range, anchorSelectRef.current, baseSelectedRef.current);
+            return;
+        }
+        anchorIdRef.current = id;
+        anchorSelectRef.current = !checked;
+        baseSelectedRef.current = getBaseSelectionRef.current();
+        isDraggingRef.current = true;
+        movedRef.current = false;
+        lastResultKeyRef.current = "";
+        lastPointRef.current = { x: e.clientX, y: e.clientY };
+        attachedGridElementRef.current = (_a = gridRef === null || gridRef === void 0 ? void 0 : gridRef.current) !== null && _a !== void 0 ? _a : null;
+        (_b = attachedGridElementRef.current) === null || _b === void 0 ? void 0 : _b.classList.add(DRAG_CLASS);
+        (_c = zen_1.zen.document) === null || _c === void 0 ? void 0 : _c.addEventListener("mousemove", onMouseMove);
+        (_d = zen_1.zen.document) === null || _d === void 0 ? void 0 : _d.addEventListener("mouseup", endDrag);
+        (_e = attachedGridElementRef.current) === null || _e === void 0 ? void 0 : _e.addEventListener("scroll", onScroll);
+    }, [gridRef, onMouseMove, onScroll, endDrag]);
+    // Drop the anchor only once its row is actually gone (collapsed, filtered, paginated away).
+    // Keying this on the `rows` array identity instead would clear the anchor on every render for
+    // any caller that rebuilds its entity list each time - NestedData does exactly that - which
+    // silently turns every shift-click into a plain single-row toggle.
+    (0, react_1.useEffect)(() => {
+        if (anchorIdRef.current !== null && !rows.some(row => row.id === anchorIdRef.current)) {
+            anchorIdRef.current = null;
+        }
+    }, [rows]);
+    (0, react_1.useEffect)(() => endDrag, [endDrag]);
+    return { onCheckboxMouseDown, suppressNextChangeRef };
+};
+exports.useDragSelection = useDragSelection;

package/dist/table/selectable/useSelectableRows.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode } from "react";
+import { ReactNode, RefObject } from "react";
 import { IListColumn } from "../table";
 import { ISelectionValue, SelectionState } from "./interfaces";
 import "./selectableColumn.less";
@@ -8,6 +8,8 @@ export type TSelectionStrategy = "main" | "nested";
 export interface ISelectableRowsOptions<T extends IRowEntity<N>, N extends IEntityWithId> {
     selection: ISelectionValue | undefined;
     onSelect: (selection: ISelectionValue) => void;
+    /** Preserve cross-page Select All using excluded IDs. Consumers must resolve exclusions before running bulk actions. Defaults to false. */
+    allowExclusions?: boolean;
     checkboxDisabled?: (entity: T | N, isNested?: boolean) => boolean;
     checkboxVisible?: (entity: T | N, isNested?: boolean) => boolean;
     checkboxInHeader?: boolean;
@@ -32,8 +34,9 @@ export declare const getEmptySelection: () => {
     all: boolean;
     selected: string[];
 };
+export declare const isAllSelection: (all: boolean | undefined, selectedCount: number | undefined, allowExclusions?: boolean) => boolean;
 export declare const SelectableWrapperName = "Selectable";
-export declare const useSelectableRows: <T extends IRowEntity<N>, N extends IEntityWithId>(columns: IListColumn<T, N>[], entities: T[], isMobile: boolean, selectMode: boolean, setSelectMode: (value: boolean) => void, selectable?: ISelectableRowsOptions<T, N>, isInfinite?: boolean) => {
+export declare const useSelectableRows: <T extends IRowEntity<N>, N extends IEntityWithId>(columns: IListColumn<T, N>[], entities: T[], isMobile: boolean, selectMode: boolean, setSelectMode: (value: boolean) => void, selectable?: ISelectableRowsOptions<T, N>, isInfinite?: boolean, gridRef?: RefObject<HTMLElement | null>, expandedRows?: string[]) => {
     selectableColumns: IListColumn<T, N>[];
     selectableFeedWrapper: (primaryData: ReactNode, secondaryData: ReactNode, entity: T | N, isNested: boolean) => [ReactNode, ReactNode];
 };

package/dist/table/selectable/useSelectableRows.js

@@ -6,8 +6,9 @@ const {
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.TRANSLATIONS = exports.useSelectableRows = exports.SelectableWrapperName = exports.getEmptySelection = void 0;
+exports.TRANSLATIONS = exports.useSelectableRows = exports.SelectableWrapperName = exports.isAllSelection = exports.getEmptySelection = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
+/* eslint-disable complexity */
 const react_1 = require("react");
 const interfaces_1 = require("./interfaces");
 const checkboxCell_1 = require("../../dataGrid/columns/checkboxColumn/checkboxCell");
@@ -84,15 +85,21 @@ const useLanguage_1 = require("../../utils/localization/useLanguage");
 const checkRow_1 = require("./utils/checkRow");
 const isRowChecked_1 = require("./utils/isRowChecked");
 const getCurrentPageSelection_1 = require("./utils/getCurrentPageSelection");
+const useDragSelection_1 = require("./useDragSelection");
+const getDragSelectionRows_1 = require("./utils/getDragSelectionRows");
+const showMoreRow_1 = require("../../commonHelpers/showMoreRow");
 const getEmptySelection = () => ({
   all: false,
   selected: []
 });
 exports.getEmptySelection = getEmptySelection;
+const isAllSelection = (all, selectedCount, allowExclusions) => !!all && (!!allowExclusions || selectedCount === 0);
+exports.isAllSelection = isAllSelection;
 exports.SelectableWrapperName = "Selectable";
 // Infinite scroll has no pages, so the header checkbox always means "select all" (never current page).
 const resolveCheckboxEmitsCurrentPage = (isInfinite, checkboxSelectsCurrentPage, turnOffSelectAll) => isInfinite ? false : checkboxSelectsCurrentPage !== null && checkboxSelectsCurrentPage !== void 0 ? checkboxSelectsCurrentPage : turnOffSelectAll;
-const useSelectableRows = (columns, entities, isMobile, selectMode, setSelectMode, selectable, isInfinite = false) => {
+const getSelectionMenuState = (allSelected, selections, pageState) => allSelected ? selections.size === 0 ? interfaces_1.SelectionState.All : interfaces_1.SelectionState.Partial : pageState;
+const useSelectableRows = (columns, entities, isMobile, selectMode, setSelectMode, selectable, isInfinite = false, gridRef, expandedRows) => {
   var _a;
   const {
     translate
@@ -100,13 +107,12 @@ const useSelectableRows = (columns, entities, isMobile, selectMode, setSelectMod
   const selections = (0, react_1.useMemo)(() => (0, getSelection_1.getSelections)(selectable === null || selectable === void 0 ? void 0 : selectable.selection), [selectable === null || selectable === void 0 ? void 0 : selectable.selection]);
   const [state, setState] = (0, react_1.useState)(interfaces_1.SelectionState.None);
   const checkboxVisible = (0, react_1.useMemo)(() => {
-    if (selectable === null || selectable === void 0 ? void 0 : selectable.checkboxVisible) {
-      return selectable.checkboxVisible;
-    }
-    if ((selectable === null || selectable === void 0 ? void 0 : selectable.strategy) !== "nested") {
-      return (_, isNested) => !isNested;
-    }
-    return () => true;
+    const base = (selectable === null || selectable === void 0 ? void 0 : selectable.checkboxVisible) ? selectable.checkboxVisible : (selectable === null || selectable === void 0 ? void 0 : selectable.strategy) !== "nested" ? (_, isNested) => !isNested : () => true;
+    // Synthetic "+N more" and loading placeholder rows are never selectable.
+    return (entity, isNested) => {
+      if ((0, showMoreRow_1.isShowMoreRow)(entity) || entity.isLoading) return false;
+      return base(entity, isNested);
+    };
   }, [selectable === null || selectable === void 0 ? void 0 : selectable.checkboxVisible, selectable === null || selectable === void 0 ? void 0 : selectable.strategy]);
   const checkboxDisabled = (0, react_1.useMemo)(() => {
     if (selectable === null || selectable === void 0 ? void 0 : selectable.checkboxDisabled) {
@@ -118,6 +124,12 @@ const useSelectableRows = (columns, entities, isMobile, selectMode, setSelectMod
     }
     return () => false;
   }, [selectable, selections]);
+  // `checkRow` and `getCurrentPageSelection` read callbacks off `selectable`, so hand them the
+  // wrapped ones to apply the same exclusions.
+  const wrappedSelectable = (0, react_1.useMemo)(() => selectable ? Object.assign(Object.assign({}, selectable), {
+    checkboxVisible,
+    checkboxDisabled
+  }) : undefined, [selectable, checkboxVisible, checkboxDisabled]);
   const checkboxPlaceholder = (0, react_1.useMemo)(() => {
     if ((selectable === null || selectable === void 0 ? void 0 : selectable.checkboxPlaceholder) !== undefined) {
       return selectable.checkboxPlaceholder;
@@ -130,40 +142,96 @@ const useSelectableRows = (columns, entities, isMobile, selectMode, setSelectMod
   }, [selectable === null || selectable === void 0 ? void 0 : selectable.checkboxPlaceholder, selectable === null || selectable === void 0 ? void 0 : selectable.checkboxVisible, selectable === null || selectable === void 0 ? void 0 : selectable.strategy]);
   const isAllSelected = (0, react_1.useMemo)(() => {
     var _a;
-    return ((_a = selectable === null || selectable === void 0 ? void 0 : selectable.selection) === null || _a === void 0 ? void 0 : _a.all) || false;
-  }, [(_a = selectable === null || selectable === void 0 ? void 0 : selectable.selection) === null || _a === void 0 ? void 0 : _a.all]);
+    return (0, exports.isAllSelection)((_a = selectable === null || selectable === void 0 ? void 0 : selectable.selection) === null || _a === void 0 ? void 0 : _a.all, selections.size, selectable === null || selectable === void 0 ? void 0 : selectable.allowExclusions);
+  }, [(_a = selectable === null || selectable === void 0 ? void 0 : selectable.selection) === null || _a === void 0 ? void 0 : _a.all, selectable === null || selectable === void 0 ? void 0 : selectable.allowExclusions, selections.size]);
   const selectableState = (0, react_1.useMemo)(() => (0, calculateSelectionState_1.calculateSelectionState)(entities, selections, isAllSelected, checkboxVisible, checkboxDisabled, selectable === null || selectable === void 0 ? void 0 : selectable.strategy), [checkboxDisabled, checkboxVisible, entities, isAllSelected, selections, selectable === null || selectable === void 0 ? void 0 : selectable.strategy]);
+  const selectionMenuState = getSelectionMenuState(isAllSelected, selections, selectableState);
   const firstColumnId = (0, react_1.useMemo)(() => columns.length > 0 ? columns[0].id : null, [columns]);
   (0, react_1.useEffect)(() => {
     if (selectable && selectable.selection) {
       const newSelections = new Set(selectable.selection.selected);
-      const newState = (0, calculateSelectionState_1.calculateSelectionState)(entities, newSelections, selectable.selection.all || false, checkboxVisible, checkboxDisabled, selectable.strategy);
+      const newState = (0, calculateSelectionState_1.calculateSelectionState)(entities, newSelections, isAllSelected, checkboxVisible, checkboxDisabled, selectable.strategy);
       setState(newState);
     }
-  }, [checkboxDisabled, checkboxVisible, entities, selectable, setSelectMode, selectable === null || selectable === void 0 ? void 0 : selectable.strategy]);
+  }, [checkboxDisabled, checkboxVisible, entities, selectable, setSelectMode, selectable === null || selectable === void 0 ? void 0 : selectable.strategy, isAllSelected]);
   const getNewSelection = (0, react_1.useCallback)((id, checked) => {
-    if (state === interfaces_1.SelectionState.All) {
-      const newSelection = (0, getCurrentPageSelection_1.getCurrentPageSelection)(entities, selectable);
-      (0, checkRow_1.checkRow)(newSelection, selectable, entities, id, false);
-      return newSelection;
+    if (isAllSelected && !(selectable === null || selectable === void 0 ? void 0 : selectable.allowExclusions)) {
+      const included = (0, getCurrentPageSelection_1.getCurrentPageSelection)(entities, wrappedSelectable);
+      (0, checkRow_1.checkRow)(included, wrappedSelectable, entities, id, checked);
+      return included;
     }
-    (0, checkRow_1.checkRow)(selections, selectable, entities, id, checked);
+    if (isAllSelected) {
+      // MYG-142234: `selections` holds the ids excluded from the "all" selection.
+      // Toggling a row here must only ever add/remove that single id from the
+      // exclusion set - it must never be rebuilt from `entities` (the current page),
+      // otherwise every other page's rows would silently fall out of the selection.
+      const excluded = new Set(selections);
+      (0, checkRow_1.checkRow)(excluded, wrappedSelectable, entities, id, !checked);
+      return excluded;
+    }
+    (0, checkRow_1.checkRow)(selections, wrappedSelectable, entities, id, checked);
     return selections;
-  }, [state, entities, selectable, selections]);
+  }, [entities, selectable, wrappedSelectable, selections, isAllSelected]);
   const onSelectListener = (0, react_1.useCallback)((id, checked) => {
-    var _a;
+    const wasAllSelected = !!(selectable === null || selectable === void 0 ? void 0 : selectable.allowExclusions) && isAllSelected;
     const newSelection = getNewSelection(id, checked);
-    const newState = (0, calculateSelectionState_1.calculateSelectionState)(entities, newSelection, ((_a = selectable === null || selectable === void 0 ? void 0 : selectable.selection) === null || _a === void 0 ? void 0 : _a.all) || false, checkboxVisible, checkboxDisabled, selectable === null || selectable === void 0 ? void 0 : selectable.strategy);
-    const newValue = {
+    const newState = (0, calculateSelectionState_1.calculateSelectionState)(entities, newSelection, wasAllSelected, checkboxVisible, checkboxDisabled, selectable === null || selectable === void 0 ? void 0 : selectable.strategy);
+    // MYG-142234: once selection spans "all" pages, unchecking a row must keep `all: true`
+    // and only record the exclusion - it must not collapse to the current page's ids.
+    const newValue = wasAllSelected ? {
+      selected: [...newSelection],
+      all: true
+    } : {
       selected: [...newSelection],
       all: newState === interfaces_1.SelectionState.All
     };
     setState(newState);
     selectable === null || selectable === void 0 ? void 0 : selectable.onSelect(newValue);
     setSelectMode(newValue.all || newValue.selected.length > 0);
-  }, [checkboxDisabled, checkboxVisible, entities, selectable, setSelectMode, setState, getNewSelection]);
+  }, [checkboxDisabled, checkboxVisible, entities, selectable, setSelectMode, setState, getNewSelection, isAllSelected]);
+  const onBatchSelect = (0, react_1.useCallback)((rangeIds, select, base) => {
+    const result = new Set(base);
+    const limit = selectable === null || selectable === void 0 ? void 0 : selectable.selectionLimit;
+    const wasAllSelected = !!(selectable === null || selectable === void 0 ? void 0 : selectable.allowExclusions) && isAllSelected;
+    for (const id of rangeIds) {
+      if (!wasAllSelected && select && limit !== undefined && result.size >= limit) {
+        break;
+      }
+      (0, checkRow_1.checkRow)(result, wrappedSelectable, entities, id, wasAllSelected ? !select : select);
+    }
+    const newState = (0, calculateSelectionState_1.calculateSelectionState)(entities, result, wasAllSelected, checkboxVisible, checkboxDisabled, selectable === null || selectable === void 0 ? void 0 : selectable.strategy);
+    const newValue = {
+      selected: [...result],
+      all: wasAllSelected || newState === interfaces_1.SelectionState.All
+    };
+    setState(newState);
+    selectable === null || selectable === void 0 ? void 0 : selectable.onSelect(newValue);
+    setSelectMode(newValue.all || newValue.selected.length > 0);
+  }, [entities, selectable, wrappedSelectable, checkboxVisible, checkboxDisabled, setSelectMode, isAllSelected]);
+  // Deliberately independent of the current selection, so the drag anchor survives the
+  // selection changes a drag itself produces.
+  const {
+    rows: dragRows,
+    entityById
+  } = (0, react_1.useMemo)(() => (0, getDragSelectionRows_1.getDragSelectionRows)(entities, expandedRows), [entities, expandedRows]);
+  const isSelectable = (0, react_1.useCallback)(row => {
+    const entity = entityById.get(row.id);
+    return !!entity && checkboxVisible(entity, row.isNested) && !checkboxDisabled(entity, row.isNested);
+  }, [entityById, checkboxVisible, checkboxDisabled]);
+  const getBaseSelection = (0, react_1.useCallback)(() => isAllSelected && !(selectable === null || selectable === void 0 ? void 0 : selectable.allowExclusions) ? (0, getCurrentPageSelection_1.getCurrentPageSelection)(entities, wrappedSelectable) : new Set(selections), [isAllSelected, selectable === null || selectable === void 0 ? void 0 : selectable.allowExclusions, entities, wrappedSelectable, selections]);
+  const {
+    onCheckboxMouseDown,
+    suppressNextChangeRef
+  } = (0, useDragSelection_1.useDragSelection)(dragRows, gridRef, onBatchSelect, getBaseSelection, isSelectable, !!selectable);
+  const onCheckboxChange = (0, react_1.useCallback)((id, checked) => {
+    if (suppressNextChangeRef.current) {
+      suppressNextChangeRef.current = false;
+      return;
+    }
+    onSelectListener(id, checked);
+  }, [onSelectListener, suppressNextChangeRef]);
   const onChangeSelectionState = (0, react_1.useCallback)(newState => {
-    var _a, _b;
+    var _a, _b, _c;
     if (newState === interfaces_1.SelectionState.All) {
       (selectable === null || selectable === void 0 ? void 0 : selectable.onSelect) && selectable.onSelect({
         selected: [],
@@ -180,17 +248,19 @@ const useSelectableRows = (columns, entities, isMobile, selectMode, setSelectMod
       setSelectMode(false);
       return;
     }
-    const newSelections = (0, getCurrentPageSelection_1.getCurrentPageSelection)(entities, selectable);
+    const newSelections = (0, getCurrentPageSelection_1.getCurrentPageSelection)(entities, wrappedSelectable);
     setState(newState);
     const previousSelections = (_b = (_a = selectable === null || selectable === void 0 ? void 0 : selectable.selection) === null || _a === void 0 ? void 0 : _a.selected) !== null && _b !== void 0 ? _b : [];
-    const mergedSelections = new Set([...previousSelections, ...newSelections]);
-    const newValue = {
-      selected: [...mergedSelections],
+    const newValue = (selectable === null || selectable === void 0 ? void 0 : selectable.allowExclusions) && ((_c = selectable.selection) === null || _c === void 0 ? void 0 : _c.all) ? {
+      selected: previousSelections.filter(id => !newSelections.has(id)),
+      all: true
+    } : {
+      selected: [...new Set([...previousSelections, ...newSelections])],
       all: false
     };
     selectable === null || selectable === void 0 ? void 0 : selectable.onSelect(newValue);
     setSelectMode(newValue.all || newValue.selected.length > 0);
-  }, [selectable, entities, setSelectMode]);
+  }, [selectable, wrappedSelectable, entities, setSelectMode]);
   const checkboxTitle = (0, react_1.useCallback)(entity => (selectable === null || selectable === void 0 ? void 0 : selectable.checkboxTitle) ? selectable.checkboxTitle(entity) : firstColumnId ? entity[firstColumnId] || entity.id : entity.id, [firstColumnId, selectable]);
   const headerTitle = (0, react_1.useCallback)(() => {
     if (selectable === null || selectable === void 0 ? void 0 : selectable.headerTitle) {
@@ -201,7 +271,12 @@ const useSelectableRows = (columns, entities, isMobile, selectMode, setSelectMod
     }
     return translate("Deselect all");
   }, [selectable, selectableState, state, translate]);
-  const isEntityChecked = (0, react_1.useCallback)((entity, isNested) => (0, isRowChecked_1.isRowChecked)(selections, state, selectable === null || selectable === void 0 ? void 0 : selectable.strategy, entity, isNested), [selections, state, selectable === null || selectable === void 0 ? void 0 : selectable.strategy]);
+  const isEntityChecked = (0, react_1.useCallback)(
+  // MYG-142234: while `selection.all` is true, `selections` holds excluded ids, and every
+  // row must be evaluated through the SelectionState.All (exclusion-aware) branch of
+  // isRowChecked - not the per-page `state`, which can be Partial/None for a page that
+  // contains some of those exclusions.
+  (entity, isNested) => (0, isRowChecked_1.isRowChecked)(selections, isAllSelected ? interfaces_1.SelectionState.All : state, selectable === null || selectable === void 0 ? void 0 : selectable.strategy, entity, isNested, checkboxVisible, checkboxDisabled), [selections, isAllSelected, state, selectable === null || selectable === void 0 ? void 0 : selectable.strategy, checkboxVisible, checkboxDisabled]);
   const hasSelectable = !!selectable;
   const selectableCheckboxSelectsCurrentPage = selectable === null || selectable === void 0 ? void 0 : selectable.checkboxSelectsCurrentPage;
   const selectableTurnOffSelectAll = selectable === null || selectable === void 0 ? void 0 : selectable.turnOffSelectAll;
@@ -239,7 +314,8 @@ const useSelectableRows = (columns, entities, isMobile, selectMode, setSelectMod
           indeterminate: checked.indeterminate,
           disabled: isDisable,
           label: checkboxTitle(entity),
-          onChange: onSelectListener,
+          onChange: onCheckboxChange,
+          onMouseDown: isDisable ? undefined : onCheckboxMouseDown,
           children: (0, jsx_runtime_1.jsx)(checkboxCell_1.CheckboxCell.Content, {
             children: value
           })
@@ -253,16 +329,32 @@ const useSelectableRows = (columns, entities, isMobile, selectMode, setSelectMod
           checked: state === interfaces_1.SelectionState.CurrentPage || state === interfaces_1.SelectionState.All,
           indeterminate: state === interfaces_1.SelectionState.Partial,
           onChange: newValue => {
-            var _a, _b;
+            var _a, _b, _c;
             if (newValue) {
               const newState = checkboxEmitsCurrentPage ? interfaces_1.SelectionState.CurrentPage : interfaces_1.SelectionState.All;
               setState(newState);
               onChangeSelectionState(newState);
+            } else if (isInfinite) {
+              onChangeSelectionState(interfaces_1.SelectionState.None);
+            } else if (selectable.allowExclusions && ((_a = selectable.selection) === null || _a === void 0 ? void 0 : _a.all)) {
+              // MYG-142234: in exclusion mode, `selected` holds excluded ids. Unchecking
+              // the header must add the current page's ids to that exclusion set and
+              // keep `all: true` - it must never be treated as an inclusion list, or
+              // every other page's selection would be silently wiped out.
+              const currentPageIds = (0, getCurrentPageSelection_1.getCurrentPageSelection)(entities, wrappedSelectable);
+              const newExcluded = new Set([...selectable.selection.selected, ...currentPageIds]);
+              const newState = (0, calculateSelectionState_1.calculateSelectionState)(entities, newExcluded, true, checkboxVisible, checkboxDisabled, selectable.strategy);
+              setState(newState);
+              selectable.onSelect({
+                selected: [...newExcluded],
+                all: true
+              });
+              setSelectMode(true);
             } else {
               // Intentionally different from onSelect(None) ("Deselect all" menu item, which clears everything).
               // Unchecking the header checkbox only removes the current page from the selection, preserving other pages.
-              const currentPageIds = (0, getCurrentPageSelection_1.getCurrentPageSelection)(entities, selectable);
-              const remaining = ((_b = (_a = selectable.selection) === null || _a === void 0 ? void 0 : _a.selected) !== null && _b !== void 0 ? _b : []).filter(id => !currentPageIds.has(id));
+              const currentPageIds = (0, getCurrentPageSelection_1.getCurrentPageSelection)(entities, wrappedSelectable);
+              const remaining = ((_c = (_b = selectable.selection) === null || _b === void 0 ? void 0 : _b.selected) !== null && _c !== void 0 ? _c : []).filter(id => !currentPageIds.has(id));
               const newState = remaining.length > 0 ? interfaces_1.SelectionState.Partial : interfaces_1.SelectionState.None;
               setState(newState);
               selectable.onSelect({
@@ -272,7 +364,7 @@ const useSelectableRows = (columns, entities, isMobile, selectMode, setSelectMod
               setSelectMode(remaining.length > 0);
             }
           },
-          calculateSelectionState: () => selectableState,
+          calculateSelectionState: () => selectionMenuState,
           checkboxInHeader: checkboxInHeaderValue,
           header: selectableHeader,
           onSelect: newState => {
@@ -285,7 +377,7 @@ const useSelectableRows = (columns, entities, isMobile, selectMode, setSelectMod
         return cell;
       }
     };
-  }, [checkboxDisabled, checkboxTitle, checkboxVisible, headerTitle, onChangeSelectionState, onSelectListener, hasSelectable, checkboxEmitsCurrentPage, checkboxInHeaderValue, selectableHeader, selectableTurnOffSelectAll, isInfinite, selectable, selectableState, state, isMobile, checkboxPlaceholder, isEntityChecked, entities, setSelectMode]);
+  }, [checkboxDisabled, checkboxTitle, checkboxVisible, headerTitle, onChangeSelectionState, onCheckboxChange, onCheckboxMouseDown, hasSelectable, checkboxEmitsCurrentPage, checkboxInHeaderValue, selectableHeader, selectableTurnOffSelectAll, isInfinite, selectable, wrappedSelectable, selectionMenuState, state, isMobile, checkboxPlaceholder, isEntityChecked, entities, setSelectMode]);
   const selectableFeedWrapper = (0, react_1.useCallback)((primaryData, secondaryData, entity, isNested) => {
     // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
     if (!entity) {
@@ -294,6 +386,9 @@ const useSelectableRows = (columns, entities, isMobile, selectMode, setSelectMod
     if (!isMobile) {
       return [primaryData, secondaryData];
     }
+    if (entity.isLoading) {
+      return [primaryData, secondaryData];
+    }
     if (!selectMode) {
       return [primaryData, secondaryData];
     }

package/dist/table/selectable/utils/calculateSelectionState.d.ts

@@ -2,4 +2,4 @@ import { IEntityWithId } from "../../../commonHelpers/entity";
 import { IRowEntity } from "../../../dataGrid/row/row";
 import { SelectionState } from "../interfaces";
 import { TSelectionStrategy } from "../useSelectableRows";
-export declare const calculateSelectionState: <T extends IRowEntity<N>, N extends IEntityWithId>(entities: T[], selections: Set<string>, all: boolean, checkboxVisible: (e: T | N) => boolean, checkboxDisabled: (e: T | N) => boolean, strategy?: TSelectionStrategy) => SelectionState;
+export declare const calculateSelectionState: <T extends IRowEntity<N>, N extends IEntityWithId>(entities: T[], selections: Set<string>, all: boolean, checkboxVisible: (e: T | N, isNested?: boolean) => boolean, checkboxDisabled: (e: T | N, isNested?: boolean) => boolean, strategy?: TSelectionStrategy) => SelectionState;

package/dist/table/selectable/utils/calculateSelectionState.js

@@ -1,31 +1,67 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.calculateSelectionState = void 0;
+const showMoreRow_1 = require("../../../commonHelpers/showMoreRow");
 const interfaces_1 = require("../interfaces");
 const calculateSelectionState = (entities, selections, all, checkboxVisible, checkboxDisabled, strategy) => {
     if (selections.size === 0) {
         return all ? interfaces_1.SelectionState.All : interfaces_1.SelectionState.None;
     }
+    if (all) {
+        // When `all` is true, `selections` holds the ids explicitly excluded from the
+        // otherwise-fully-selected set (see ISelectionValue), rather than included ids.
+        const isExcluded = (entity) => {
+            const children = strategy === "nested" ? (0, showMoreRow_1.getChildrenForSelection)(entity) : undefined;
+            if (children && children.length > 0) {
+                return children.every(child => {
+                    if (!checkboxVisible(child, true)) {
+                        return true;
+                    }
+                    if (checkboxDisabled(child, true)) {
+                        return true;
+                    }
+                    return selections.has(child.id);
+                });
+            }
+            return selections.has(entity.id);
+        };
+        const isPartiallyExcluded = (entity) => {
+            const children = strategy === "nested" ? (0, showMoreRow_1.getChildrenForSelection)(entity) : undefined;
+            if (children && children.length > 0) {
+                return children.some(child => selections.has(child.id));
+            }
+            return selections.has(entity.id);
+        };
+        const relevantEntities = entities.filter(entity => checkboxVisible(entity, false) && !checkboxDisabled(entity, false));
+        if (relevantEntities.length === 0) {
+            return interfaces_1.SelectionState.All;
+        }
+        if (relevantEntities.every(entity => !isPartiallyExcluded(entity))) {
+            return interfaces_1.SelectionState.All;
+        }
+        return relevantEntities.every(entity => isExcluded(entity)) ? interfaces_1.SelectionState.None : interfaces_1.SelectionState.Partial;
+    }
     return entities.every(entity => {
-        if (!checkboxVisible(entity)) {
+        if (!checkboxVisible(entity, false)) {
             return true;
         }
-        if (checkboxDisabled(entity)) {
+        if (checkboxDisabled(entity, false)) {
             return true;
         }
         if (strategy === "nested") {
-            if (entity.children) {
-                return entity.children.every(child => {
-                    if (!checkboxVisible(child)) {
+            const children = (0, showMoreRow_1.getChildrenForSelection)(entity);
+            if (children && children.length > 0) {
+                return children.every(child => {
+                    if (!checkboxVisible(child, true)) {
                         return true;
                     }
-                    if (checkboxDisabled(child)) {
+                    if (checkboxDisabled(child, true)) {
                         return true;
                     }
                     return selections.has(child.id);
                 });
             }
-            return false;
+            return selections.has(entity.id);
         }
         return selections.has(entity.id);
     })

package/dist/table/selectable/utils/checkRow.js

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkRow = void 0;
+const showMoreRow_1 = require("../../../commonHelpers/showMoreRow");
 const checkRow = (selectionSet, selectable, entities, id, checked) => {
     const setValue = (rowId) => (checked ? selectionSet.add(rowId) : selectionSet.delete(rowId));
     if ((selectable === null || selectable === void 0 ? void 0 : selectable.strategy) === "nested") {
         const entity = entities.find(e => e.id === id);
-        if (entity && entity.children && entity.children.length > 0) {
-            entity.children.forEach(child => {
+        const children = entity ? (0, showMoreRow_1.getChildrenForSelection)(entity) : undefined;
+        if (entity && children && children.length > 0) {
+            children.forEach(child => {
                 const isChildVisible = selectable.checkboxVisible ? selectable.checkboxVisible(child, true) : true;
                 const isChildEnabled = !selectable.checkboxDisabled || !selectable.checkboxDisabled(child, true);
                 if (isChildVisible && isChildEnabled) {

package/dist/table/selectable/utils/getCurrentPageSelection.js

@@ -1,15 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCurrentPageSelection = void 0;
+const showMoreRow_1 = require("../../../commonHelpers/showMoreRow");
 const getCurrentPageSelection = (entities, selectable) => {
     const newSelections = new Set();
     entities.forEach(entity => {
-        const isVisible = (selectable === null || selectable === void 0 ? void 0 : selectable.checkboxVisible) ? selectable.checkboxVisible(entity) : true;
+        const isVisible = !entity.isLoading && !(0, showMoreRow_1.isShowMoreRow)(entity) && ((selectable === null || selectable === void 0 ? void 0 : selectable.checkboxVisible) ? selectable.checkboxVisible(entity) : true);
         const isEnabled = !(selectable === null || selectable === void 0 ? void 0 : selectable.checkboxDisabled) || !selectable.checkboxDisabled(entity);
-        if ((selectable === null || selectable === void 0 ? void 0 : selectable.strategy) === "nested") {
-            (entity.children || []).forEach(child => {
-                const isChildVisible = selectable.checkboxVisible ? selectable.checkboxVisible(child, true) : true;
-                const isChildEnabled = !selectable.checkboxDisabled || !selectable.checkboxDisabled(child, true);
+        const children = (selectable === null || selectable === void 0 ? void 0 : selectable.strategy) === "nested" ? (0, showMoreRow_1.getChildrenForSelection)(entity) : undefined;
+        if (children && children.length > 0) {
+            children.forEach(child => {
+                const isChildVisible = !child.isLoading &&
+                    !(0, showMoreRow_1.isShowMoreRow)(child) &&
+                    ((selectable === null || selectable === void 0 ? void 0 : selectable.checkboxVisible) ? selectable.checkboxVisible(child, true) : true);
+                const isChildEnabled = !(selectable === null || selectable === void 0 ? void 0 : selectable.checkboxDisabled) || !selectable.checkboxDisabled(child, true);
                 if (isChildVisible && isChildEnabled) {
                     newSelections.add(child.id);
                 }

package/dist/table/selectable/utils/getDragSelectionRows.d.ts

@@ -0,0 +1,15 @@
+import { IEntityWithId } from "../../../commonHelpers/entity";
+import { IRowEntity } from "../../../dataGrid/row/row";
+import { IDragSelectionRow } from "../interfaces";
+export interface IDragSelection<T> {
+    /** The rows in render order. */
+    rows: IDragSelectionRow[];
+    /** Every entity a row can point at, parents and children alike. */
+    entityById: Map<string, T>;
+}
+/**
+ * Flattens the entities into the rows the grid actually renders: each entity followed by its
+ * children while it is expanded. Drag and shift-click ranges walk this list, so they cross
+ * nesting levels the way the user sees them on screen.
+ */
+export declare const getDragSelectionRows: <T extends IRowEntity<N>, N extends IEntityWithId>(entities: T[], expandedRows?: string[]) => IDragSelection<T | N>;

package/dist/table/selectable/utils/getDragSelectionRows.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDragSelectionRows = void 0;
+/**
+ * Flattens the entities into the rows the grid actually renders: each entity followed by its
+ * children while it is expanded. Drag and shift-click ranges walk this list, so they cross
+ * nesting levels the way the user sees them on screen.
+ */
+const getDragSelectionRows = (entities, expandedRows) => {
+    const expanded = new Set(expandedRows);
+    const rows = [];
+    const entityById = new Map();
+    entities.forEach(entity => {
+        rows.push({ id: entity.id, isNested: false });
+        entityById.set(entity.id, entity);
+        // Children are always indexed — a collapsed row's children still need to resolve for
+        // the selection predicates — but only an expanded row contributes them to the range.
+        const isExpanded = expanded.has(entity.id);
+        (entity.children || []).forEach(child => {
+            entityById.set(child.id, child);
+            if (isExpanded) {
+                rows.push({ id: child.id, isNested: true });
+            }
+        });
+    });
+    return { rows, entityById };
+};
+exports.getDragSelectionRows = getDragSelectionRows;