@astral/ui 4.113.3 → 4.115.0

package/node/components/DataGrid/tests/selection/testDataGridSelection.js

@@ -0,0 +1,566 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testDataGridSelection = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const tests_1 = require("@ui/dev/tests");
+const react_1 = require("react");
+const vitest_1 = require("vitest");
+const Tooltip_1 = require("../../../Tooltip");
+const constants_1 = require("../../Row/constants");
+const COLUMNS = [
+    { field: 'name', label: 'Наименование' },
+];
+const COLUMNS_WITH_ACTION = [
+    { field: 'name', label: 'Наименование' },
+    {
+        label: 'Действия',
+        renderCell: ({ name }) => (0, jsx_runtime_1.jsxs)("button", { type: "button", children: ["\u041E\u0442\u043A\u0440\u044B\u0442\u044C ", name] }),
+    },
+];
+const FIRST_PAGE_ROWS = [
+    { id: '1', name: 'Договор №1' },
+    { id: '2', name: 'Договор №2' },
+];
+const SECOND_PAGE_ROWS = [
+    { id: '3', name: 'Договор №3' },
+    { id: '4', name: 'Договор №4' },
+];
+const NUMERIC_ID_ROWS = [{ id: 1, name: 'Договор №1' }];
+const SELECTION_DISABLED = {
+    mode: 'selection',
+    reason: 'Документ отправляется',
+};
+const ROW_DISABLED = {
+    mode: 'row',
+    reason: 'Нет доступа',
+};
+const ROW_EXCEPT_LAST_CELL_DISABLED = {
+    mode: 'row-except-last-cell',
+    reason: 'Нет доступа',
+};
+const SELECTION_DISABLED_WITHOUT_REASON = {
+    mode: 'selection',
+    reason: '',
+};
+const ROW_DISABLED_WITHOUT_REASON = {
+    mode: 'row',
+    reason: '',
+};
+const INERT_BY_MODE_CASES = [
+    { mode: 'row', isInertCell: true, isInertLastCell: true },
+    { mode: 'row-except-last-cell', isInertCell: true, isInertLastCell: false },
+    { mode: 'selection', isInertCell: false, isInertLastCell: false },
+];
+const NESTED_ROWS = [
+    {
+        id: '1',
+        name: 'Пакет документов',
+        children: [{ id: '1-1', name: 'Вложенный договор' }],
+    },
+];
+const getSelectAllCheckbox = () => (0, tests_1.within)(tests_1.screen.getByRole('heading')).getByRole('checkbox');
+// closest берёт ближайшую строку, поэтому для вложенной строки не находится родительская
+const getRowCheckbox = (name) => {
+    const row = tests_1.screen.getByText(name).closest('li');
+    if (!row) {
+        throw new Error(`Строка «${name}» не найдена`);
+    }
+    return (0, tests_1.within)(row).getByRole('checkbox');
+};
+// Заблокированная ячейка недоступна через атрибут inert
+const checkIsInert = (element) => Boolean(element.closest('[inert]'));
+const getActionButton = (name) => tests_1.screen.getByRole('button', { name: `Открыть ${name}` });
+const getRowContent = (name) => {
+    const rowContent = tests_1.screen.getByText(name).closest(`[${constants_1.DISABLE_ROW_ATTR}]`);
+    if (!(rowContent instanceof HTMLElement)) {
+        throw new Error(`Содержимое строки «${name}» не найдено`);
+    }
+    return rowContent;
+};
+const testDataGridSelection = ({ render, renderGrid, }) => {
+    const setup = (props = {}) => {
+        const onSelectRowSpy = vitest_1.vi.fn();
+        const renderUi = (nextProps) => renderGrid({
+            rows: FIRST_PAGE_ROWS,
+            columns: COLUMNS,
+            onSelectRow: onSelectRowSpy,
+            onRetry: () => { },
+            ...nextProps,
+        });
+        const view = render(renderUi(props));
+        const rerenderGrid = (nextProps) => view.rerender(renderUi(nextProps));
+        return { onSelectRowSpy, rerenderGrid };
+    };
+    (0, vitest_1.it)('Выбор строк предыдущей страницы сохраняется при выборе строки на новой странице', async () => {
+        const { onSelectRowSpy } = setup({
+            rows: SECOND_PAGE_ROWS,
+            selectedRows: [FIRST_PAGE_ROWS[0]],
+        });
+        await tests_1.userEvents.click(getRowCheckbox('Договор №3'));
+        (0, vitest_1.expect)(onSelectRowSpy).toHaveBeenCalledWith([
+            FIRST_PAGE_ROWS[0],
+            SECOND_PAGE_ROWS[0],
+        ]);
+    });
+    (0, vitest_1.it)('Строки отмечены выбранными при возврате на страницу с выбранными строками', () => {
+        const selectedRows = [FIRST_PAGE_ROWS[0]];
+        const { rerenderGrid } = setup({
+            rows: SECOND_PAGE_ROWS,
+            selectedRows,
+        });
+        rerenderGrid({ rows: FIRST_PAGE_ROWS, selectedRows });
+        (0, vitest_1.expect)(getRowCheckbox('Договор №1')).toBeChecked();
+    });
+    (0, vitest_1.it)('Строка выбрана при числовом keyId', () => {
+        setup({ rows: NUMERIC_ID_ROWS, selectedRows: NUMERIC_ID_ROWS });
+        (0, vitest_1.expect)(getRowCheckbox('Договор №1')).toBeChecked();
+    });
+    (0, vitest_1.it)('«Выбрать все» не отмечен при selectedRows только из строк вне выдачи', () => {
+        setup({ selectedRows: SECOND_PAGE_ROWS });
+        (0, vitest_1.expect)(getSelectAllCheckbox()).not.toBeChecked();
+    });
+    (0, vitest_1.describe)('onSelectRow не вызывается', () => {
+        (0, vitest_1.it)('При новом массиве selectedRows', () => {
+            const { rerenderGrid, onSelectRowSpy } = setup({
+                selectedRows: [FIRST_PAGE_ROWS[0]],
+            });
+            rerenderGrid({ selectedRows: [FIRST_PAGE_ROWS[1]] });
+            (0, vitest_1.expect)(onSelectRowSpy).not.toHaveBeenCalled();
+        });
+        (0, vitest_1.it)('При новом массиве rows с теми же строками', () => {
+            const { rerenderGrid, onSelectRowSpy } = setup({
+                selectedRows: [FIRST_PAGE_ROWS[0]],
+            });
+            rerenderGrid({
+                rows: [...FIRST_PAGE_ROWS],
+                selectedRows: [FIRST_PAGE_ROWS[0]],
+            });
+            (0, vitest_1.expect)(onSelectRowSpy).not.toHaveBeenCalled();
+        });
+        (0, vitest_1.it)('При новой функции getRowDisabled', () => {
+            const selectedRows = [FIRST_PAGE_ROWS[0]];
+            const { rerenderGrid, onSelectRowSpy } = setup({
+                selectedRows,
+                getRowDisabled: () => undefined,
+            });
+            rerenderGrid({
+                selectedRows,
+                getRowDisabled: () => SELECTION_DISABLED,
+            });
+            (0, vitest_1.expect)(onSelectRowSpy).not.toHaveBeenCalled();
+        });
+    });
+    (0, vitest_1.describe)('Выбрать все', () => {
+        (0, vitest_1.it)('Выбор строк других страниц сохраняется', async () => {
+            const { onSelectRowSpy } = setup({
+                rows: SECOND_PAGE_ROWS,
+                selectedRows: [FIRST_PAGE_ROWS[0]],
+            });
+            await tests_1.userEvents.click(getSelectAllCheckbox());
+            (0, vitest_1.expect)(onSelectRowSpy).toHaveBeenCalledWith([
+                FIRST_PAGE_ROWS[0],
+                ...SECOND_PAGE_ROWS,
+            ]);
+        });
+        vitest_1.it.each([
+            { condition: 'mode=selection', rowDisabled: SELECTION_DISABLED },
+            { condition: 'mode=row', rowDisabled: ROW_DISABLED },
+            {
+                condition: 'mode=row-except-last-cell',
+                rowDisabled: ROW_EXCEPT_LAST_CELL_DISABLED,
+            },
+            {
+                condition: 'options.isDisabled=true',
+                options: { isDisabled: true },
+            },
+            {
+                condition: 'isNotSelectable=true',
+                options: { isNotSelectable: true },
+            },
+        ])('Строка с $condition не выбирается', async ({ rowDisabled, options }) => {
+            const rows = [
+                FIRST_PAGE_ROWS[0],
+                { ...FIRST_PAGE_ROWS[1], options },
+            ];
+            const { onSelectRowSpy } = setup({
+                rows,
+                selectedRows: [],
+                getRowDisabled: rowDisabled
+                    ? (row) => (row.id === '2' ? rowDisabled : undefined)
+                    : undefined,
+            });
+            await tests_1.userEvents.click(getSelectAllCheckbox());
+            (0, vitest_1.expect)(onSelectRowSpy).toHaveBeenCalledWith([FIRST_PAGE_ROWS[0]]);
+        });
+        (0, vitest_1.it)('Чекбокс отмечен, если выбраны все доступные строки', () => {
+            setup({
+                selectedRows: [FIRST_PAGE_ROWS[0]],
+                getRowDisabled: (row) => row.id === '2' ? SELECTION_DISABLED : undefined,
+            });
+            (0, vitest_1.expect)(getSelectAllCheckbox()).toBeChecked();
+        });
+        (0, vitest_1.it)('Чекбокс в неопределённом состоянии при выборе части доступных строк', () => {
+            setup({ selectedRows: [FIRST_PAGE_ROWS[0]] });
+            (0, vitest_1.expect)(getSelectAllCheckbox()).toHaveAttribute('aria-checked', 'mixed');
+        });
+        (0, vitest_1.it)('Чекбокс не отмечен, если выбрана только строка с mode=selection', () => {
+            setup({
+                selectedRows: [FIRST_PAGE_ROWS[1]],
+                getRowDisabled: (row) => row.id === '2' ? SELECTION_DISABLED : undefined,
+            });
+            (0, vitest_1.expect)(getSelectAllCheckbox()).toHaveAttribute('aria-checked', 'false');
+        });
+        (0, vitest_1.it)('Выбранная строка с mode=selection остаётся выбранной', async () => {
+            const { onSelectRowSpy } = setup({
+                selectedRows: [FIRST_PAGE_ROWS[1]],
+                getRowDisabled: (row) => row.id === '2' ? SELECTION_DISABLED : undefined,
+            });
+            await tests_1.userEvents.click(getSelectAllCheckbox());
+            (0, vitest_1.expect)(onSelectRowSpy).toHaveBeenCalledWith([
+                FIRST_PAGE_ROWS[1],
+                FIRST_PAGE_ROWS[0],
+            ]);
+        });
+    });
+    (0, vitest_1.describe)('Снятие «Выбрать все»', () => {
+        (0, vitest_1.it)('Выбор строк других страниц сохраняется', async () => {
+            const { onSelectRowSpy } = setup({
+                selectedRows: [SECOND_PAGE_ROWS[0], ...FIRST_PAGE_ROWS],
+            });
+            await tests_1.userEvents.click(getSelectAllCheckbox());
+            (0, vitest_1.expect)(onSelectRowSpy).toHaveBeenCalledWith([SECOND_PAGE_ROWS[0]]);
+        });
+        (0, vitest_1.it)('Выбор строки с mode=selection снимается', async () => {
+            const { onSelectRowSpy } = setup({
+                selectedRows: FIRST_PAGE_ROWS,
+                getRowDisabled: (row) => row.id === '2' ? SELECTION_DISABLED : undefined,
+            });
+            await tests_1.userEvents.click(getSelectAllCheckbox());
+            (0, vitest_1.expect)(onSelectRowSpy).toHaveBeenCalledWith([]);
+        });
+    });
+    (0, vitest_1.describe)('Выбранная строка с mode=selection', () => {
+        const setupSelectedDisabledRow = () => setup({
+            selectedRows: [FIRST_PAGE_ROWS[1]],
+            getRowDisabled: (row) => row.id === '2' ? SELECTION_DISABLED : undefined,
+        });
+        (0, vitest_1.it)('Чекбокс строки отмечен', () => {
+            setupSelectedDisabledRow();
+            (0, vitest_1.expect)(getRowCheckbox('Договор №2')).toBeChecked();
+        });
+        (0, vitest_1.it)('Чекбокс строки заблокирован', () => {
+            setupSelectedDisabledRow();
+            (0, vitest_1.expect)(getRowCheckbox('Договор №2')).toBeDisabled();
+        });
+    });
+    (0, vitest_1.describe)('Блокировка через getRowDisabled', () => {
+        (0, vitest_1.it)('Чекбокс строки заблокирован при mode=selection', () => {
+            setup({
+                getRowDisabled: (row) => row.id === '1' ? SELECTION_DISABLED : undefined,
+            });
+            (0, vitest_1.expect)(getRowCheckbox('Договор №1')).toBeDisabled();
+        });
+        (0, vitest_1.it)('Чекбокс строки заблокирован при mode=row', () => {
+            setup({
+                getRowDisabled: (row) => (row.id === '1' ? ROW_DISABLED : undefined),
+            });
+            (0, vitest_1.expect)(getRowCheckbox('Договор №1')).toBeDisabled();
+        });
+        (0, vitest_1.it)('onSelectRow не вызывается при клике по checkbox с mode=selection', async () => {
+            const { onSelectRowSpy } = setup({
+                getRowDisabled: (row) => row.id === '1' ? SELECTION_DISABLED : undefined,
+            });
+            await tests_1.userEvents.click(getRowCheckbox('Договор №1'));
+            (0, vitest_1.expect)(onSelectRowSpy).not.toHaveBeenCalled();
+        });
+        (0, vitest_1.it)('onRowClick вызывается при клике по строке с mode=selection', async () => {
+            const onRowClickSpy = vitest_1.vi.fn();
+            setup({
+                onRowClick: onRowClickSpy,
+                getRowDisabled: (row) => row.id === '1' ? SELECTION_DISABLED : undefined,
+            });
+            await tests_1.userEvents.click(tests_1.screen.getByText('Договор №1'));
+            (0, vitest_1.expect)(onRowClickSpy).toHaveBeenCalledWith(FIRST_PAGE_ROWS[0]);
+        });
+        (0, vitest_1.it)('onRowClick не вызывается при клике по строке с mode=row', async () => {
+            const onRowClickSpy = vitest_1.vi.fn();
+            setup({
+                onRowClick: onRowClickSpy,
+                getRowDisabled: (row) => (row.id === '1' ? ROW_DISABLED : undefined),
+            });
+            await tests_1.userEvents.click(tests_1.screen.getByText('Договор №1'));
+            (0, vitest_1.expect)(onRowClickSpy).not.toHaveBeenCalled();
+        });
+        (0, vitest_1.it)('onRowClick вызывается при mode=selection и options.isDisabled=true', async () => {
+            const onRowClickSpy = vitest_1.vi.fn();
+            const row = {
+                ...FIRST_PAGE_ROWS[0],
+                options: { isDisabled: true },
+            };
+            setup({
+                rows: [row],
+                onRowClick: onRowClickSpy,
+                getRowDisabled: () => SELECTION_DISABLED,
+            });
+            await tests_1.userEvents.click(tests_1.screen.getByText('Договор №1'));
+            (0, vitest_1.expect)(onRowClickSpy).toHaveBeenCalledWith(row);
+        });
+        vitest_1.it.each(INERT_BY_MODE_CASES)('Ячейки строки недоступны=$isInertCell при mode=$mode', ({ mode, isInertCell }) => {
+            setup({
+                columns: COLUMNS_WITH_ACTION,
+                getRowDisabled: (row) => row.id === '1' ? { mode, reason: 'Нет доступа' } : undefined,
+            });
+            (0, vitest_1.expect)(checkIsInert(tests_1.screen.getByText('Договор №1'))).toBe(isInertCell);
+        });
+        vitest_1.it.each(INERT_BY_MODE_CASES)('Последняя ячейка недоступна=$isInertLastCell при mode=$mode', ({ mode, isInertLastCell }) => {
+            setup({
+                columns: COLUMNS_WITH_ACTION,
+                getRowDisabled: (row) => row.id === '1' ? { mode, reason: 'Нет доступа' } : undefined,
+            });
+            (0, vitest_1.expect)(checkIsInert(getActionButton('Договор №1'))).toBe(isInertLastCell);
+        });
+        (0, vitest_1.it)('Ячейки соседней строки доступны при mode=row', () => {
+            setup({
+                columns: COLUMNS_WITH_ACTION,
+                getRowDisabled: (row) => (row.id === '1' ? ROW_DISABLED : undefined),
+            });
+            (0, vitest_1.expect)(checkIsInert(tests_1.screen.getByText('Договор №2'))).toBe(false);
+        });
+        (0, vitest_1.it)('Tooltip строки показывает причину при mode=row', async () => {
+            setup({
+                getRowDisabled: (row) => (row.id === '1' ? ROW_DISABLED : undefined),
+            });
+            await tests_1.userEvents.hover(getRowContent('Договор №1'));
+            (0, vitest_1.expect)(await tests_1.screen.findByRole('tooltip')).toHaveTextContent(ROW_DISABLED.reason);
+        });
+        (0, vitest_1.it)('Чекбокс строки с options.isDisabled=true заблокирован, если getRowDisabled её не блокирует', () => {
+            setup({
+                rows: [{ ...FIRST_PAGE_ROWS[0], options: { isDisabled: true } }],
+                getRowDisabled: () => undefined,
+            });
+            (0, vitest_1.expect)(getRowCheckbox('Договор №1')).toBeDisabled();
+        });
+    });
+    (0, vitest_1.describe)('Блокировка через options без getRowDisabled', () => {
+        (0, vitest_1.it)('Чекбокс строки заблокирован при options.isDisabled=true', () => {
+            setup({
+                rows: [{ ...FIRST_PAGE_ROWS[0], options: { isDisabled: true } }],
+            });
+            (0, vitest_1.expect)(getRowCheckbox('Договор №1')).toBeDisabled();
+        });
+        (0, vitest_1.it)('Ячейки строки, кроме последней, недоступны при options.isDisabledLastCell=false', () => {
+            setup({
+                columns: COLUMNS_WITH_ACTION,
+                rows: [
+                    {
+                        ...FIRST_PAGE_ROWS[0],
+                        options: { isDisabled: true, isDisabledLastCell: false },
+                    },
+                ],
+            });
+            (0, vitest_1.expect)(checkIsInert(tests_1.screen.getByText('Договор №1'))).toBe(true);
+        });
+        (0, vitest_1.it)('Tooltip строки показывает options.disabledReason', async () => {
+            setup({
+                rows: [
+                    {
+                        ...FIRST_PAGE_ROWS[0],
+                        options: { isDisabled: true, disabledReason: 'Нет доступа' },
+                    },
+                ],
+            });
+            await tests_1.userEvents.hover(getRowContent('Договор №1'));
+            (0, vitest_1.expect)(await tests_1.screen.findByRole('tooltip')).toHaveTextContent('Нет доступа');
+        });
+        (0, vitest_1.it)('onSelectRow не вызывается при клике по checkbox строки с options.isDisabled=true', async () => {
+            const { onSelectRowSpy } = setup({
+                rows: [{ ...FIRST_PAGE_ROWS[0], options: { isDisabled: true } }],
+            });
+            await tests_1.userEvents.click(getRowCheckbox('Договор №1'));
+            (0, vitest_1.expect)(onSelectRowSpy).not.toHaveBeenCalled();
+        });
+    });
+    (0, vitest_1.describe)('Блокировка без причины', () => {
+        const WARN_MESSAGE_PREFIX = 'UIKIT. DataGrid: getRowDisabled вернул блокировку без reason для строк: ';
+        let consoleWarnSpy;
+        (0, vitest_1.beforeEach)(() => {
+            consoleWarnSpy = vitest_1.vi.spyOn(console, 'warn').mockImplementation(() => { });
+        });
+        (0, vitest_1.afterEach)(() => {
+            consoleWarnSpy.mockRestore();
+        });
+        (0, vitest_1.it)('Выводится одно предупреждение со всеми строками без причины', () => {
+            setup({ getRowDisabled: () => SELECTION_DISABLED_WITHOUT_REASON });
+            (0, vitest_1.expect)(consoleWarnSpy.mock.calls).toEqual([
+                [`${WARN_MESSAGE_PREFIX}1, 2`],
+            ]);
+        });
+        (0, vitest_1.it)('Не выводится повторно при новой функции getRowDisabled с тем же результатом', () => {
+            const { rerenderGrid } = setup({
+                getRowDisabled: () => ROW_DISABLED_WITHOUT_REASON,
+            });
+            rerenderGrid({ getRowDisabled: () => ROW_DISABLED_WITHOUT_REASON });
+            (0, vitest_1.expect)(consoleWarnSpy).toHaveBeenCalledTimes(1);
+        });
+        (0, vitest_1.it)('Выводится только для строк без причины, появившихся позже', () => {
+            const getRowDisabled = () => SELECTION_DISABLED_WITHOUT_REASON;
+            const { rerenderGrid } = setup({ getRowDisabled });
+            rerenderGrid({
+                rows: [...FIRST_PAGE_ROWS, ...SECOND_PAGE_ROWS],
+                getRowDisabled,
+            });
+            (0, vitest_1.expect)(consoleWarnSpy.mock.calls).toEqual([
+                [`${WARN_MESSAGE_PREFIX}1, 2`],
+                [`${WARN_MESSAGE_PREFIX}3, 4`],
+            ]);
+        });
+        (0, vitest_1.it)('Не выводится для options.isDisabled=true без disabledReason', () => {
+            setup({
+                rows: [{ ...FIRST_PAGE_ROWS[0], options: { isDisabled: true } }],
+            });
+            (0, vitest_1.expect)(consoleWarnSpy).not.toHaveBeenCalled();
+        });
+        (0, vitest_1.it)('Не выводится при mode=selection с reason', () => {
+            setup({ getRowDisabled: () => SELECTION_DISABLED });
+            (0, vitest_1.expect)(consoleWarnSpy).not.toHaveBeenCalled();
+        });
+        (0, vitest_1.it)('Tooltip не отображается при наведении на строку с mode=row без причины', async () => {
+            setup({
+                getRowDisabled: (row) => row.id === '1' ? ROW_DISABLED_WITHOUT_REASON : undefined,
+            });
+            await tests_1.userEvents.hover(tests_1.screen.getByText('Договор №1'));
+            (0, vitest_1.expect)(tests_1.screen.queryByRole('tooltip')).not.toBeInTheDocument();
+        });
+    });
+    (0, vitest_1.describe)('Tooltip причины блокировки выбора', () => {
+        const user = tests_1.userEvents.setup({
+            advanceTimers: vitest_1.vi.advanceTimersByTime.bind(vitest_1.vi),
+        });
+        const TOOLTIP_CONTAINER_SELECTOR = `.${Tooltip_1.tooltipClassnames.contentWrapper}`;
+        const getCheckboxTooltipContainer = (name) => {
+            const container = getRowCheckbox(name).closest(TOOLTIP_CONTAINER_SELECTOR);
+            if (!container) {
+                throw new Error(`Контейнер tooltip checkbox строки «${name}» не найден`);
+            }
+            return container;
+        };
+        const advanceTime = (ms) => (0, react_1.act)(() => {
+            vitest_1.vi.advanceTimersByTime(ms);
+        });
+        const setupSelectionDisabledRow = () => setup({
+            getRowDisabled: (row) => row.id === '1' ? SELECTION_DISABLED : undefined,
+        });
+        // shouldAdvanceTime: асинхронная обёртка RTL ждёт setTimeout и без него зависает
+        (0, vitest_1.beforeEach)(() => {
+            vitest_1.vi.useFakeTimers({ shouldAdvanceTime: true });
+        });
+        (0, vitest_1.afterEach)(() => {
+            vitest_1.vi.useRealTimers();
+        });
+        (0, vitest_1.it)('Отображается через 300ms после наведения на checkbox с mode=selection', async () => {
+            setupSelectionDisabledRow();
+            await user.hover(getCheckboxTooltipContainer('Договор №1'));
+            advanceTime(300);
+            (0, vitest_1.expect)(tests_1.screen.getByRole('tooltip')).toHaveTextContent(SELECTION_DISABLED.reason);
+        });
+        (0, vitest_1.it)('Не отображается раньше 300ms после наведения', async () => {
+            setupSelectionDisabledRow();
+            await user.hover(getCheckboxTooltipContainer('Договор №1'));
+            advanceTime(250);
+            (0, vitest_1.expect)(tests_1.screen.queryByRole('tooltip')).not.toBeInTheDocument();
+        });
+        (0, vitest_1.it)('Не отображается, если курсор ушёл с checkbox раньше 300ms', async () => {
+            setupSelectionDisabledRow();
+            await user.hover(getCheckboxTooltipContainer('Договор №1'));
+            advanceTime(150);
+            await user.unhover(getCheckboxTooltipContainer('Договор №1'));
+            advanceTime(300);
+            (0, vitest_1.expect)(tests_1.screen.queryByRole('tooltip')).not.toBeInTheDocument();
+        });
+        (0, vitest_1.it)('Checkbox строки с mode=row не показывает собственную причину', () => {
+            setup({
+                getRowDisabled: (row) => (row.id === '1' ? ROW_DISABLED : undefined),
+            });
+            (0, vitest_1.expect)(getRowCheckbox('Договор №1').closest(TOOLTIP_CONTAINER_SELECTOR)).not.toBeInTheDocument();
+        });
+    });
+    (0, vitest_1.describe)('Вложенные строки', () => {
+        (0, vitest_1.it)('Чекбокс вложенной строки заблокирован при mode=selection для неё', () => {
+            setup({
+                rows: NESTED_ROWS,
+                tree: { isInitialExpanded: true },
+                getRowDisabled: (row) => row.id === '1-1' ? SELECTION_DISABLED : undefined,
+            });
+            (0, vitest_1.expect)(getRowCheckbox('Вложенный договор')).toBeDisabled();
+        });
+        (0, vitest_1.it)('Чекбокс вложенной строки доступен при mode=row у родителя', () => {
+            setup({
+                rows: NESTED_ROWS,
+                tree: { isInitialExpanded: true },
+                getRowDisabled: (row) => (row.id === '1' ? ROW_DISABLED : undefined),
+            });
+            (0, vitest_1.expect)(getRowCheckbox('Вложенный договор')).toBeEnabled();
+        });
+        (0, vitest_1.it)('Чекбокс вложенной строки заблокирован при variant=subrows и mode=selection', () => {
+            setup({
+                rows: NESTED_ROWS,
+                variant: 'subrows',
+                getRowDisabled: (row) => row.id === '1-1' ? SELECTION_DISABLED : undefined,
+            });
+            (0, vitest_1.expect)(getRowCheckbox('Вложенный договор')).toBeDisabled();
+        });
+        (0, vitest_1.describe)('mode=row у вложенной строки', () => {
+            const setupNestedRowDisabled = () => setup({
+                rows: NESTED_ROWS,
+                tree: { isInitialExpanded: true },
+                getRowDisabled: (row) => row.id === '1-1' ? ROW_DISABLED : undefined,
+            });
+            (0, vitest_1.it)('Ячейки вложенной строки недоступны', () => {
+                setupNestedRowDisabled();
+                (0, vitest_1.expect)(checkIsInert(tests_1.screen.getByText('Вложенный договор'))).toBe(true);
+            });
+            (0, vitest_1.it)('Ячейки родительской строки доступны', () => {
+                setupNestedRowDisabled();
+                (0, vitest_1.expect)(checkIsInert(tests_1.screen.getByText('Пакет документов'))).toBe(false);
+            });
+        });
+        (0, vitest_1.describe)('options.isDisabled=true у вложенной строки', () => {
+            const NESTED_ROWS_WITH_DISABLED_CHILD = [
+                {
+                    ...NESTED_ROWS[0],
+                    children: [
+                        {
+                            id: '1-1',
+                            name: 'Вложенный договор',
+                            options: { isDisabled: true },
+                        },
+                    ],
+                },
+            ];
+            (0, vitest_1.it)('Чекбокс вложенной строки заблокирован без getRowDisabled', () => {
+                setup({
+                    rows: NESTED_ROWS_WITH_DISABLED_CHILD,
+                    tree: { isInitialExpanded: true },
+                });
+                (0, vitest_1.expect)(getRowCheckbox('Вложенный договор')).toBeDisabled();
+            });
+            (0, vitest_1.it)('Чекбокс вложенной строки заблокирован, если getRowDisabled её не блокирует', () => {
+                setup({
+                    rows: NESTED_ROWS_WITH_DISABLED_CHILD,
+                    tree: { isInitialExpanded: true },
+                    getRowDisabled: () => undefined,
+                });
+                (0, vitest_1.expect)(getRowCheckbox('Вложенный договор')).toBeDisabled();
+            });
+            (0, vitest_1.it)('Ячейки вложенной строки доступны при mode=selection из getRowDisabled', () => {
+                setup({
+                    rows: NESTED_ROWS_WITH_DISABLED_CHILD,
+                    tree: { isInitialExpanded: true },
+                    getRowDisabled: (row) => row.id === '1-1' ? SELECTION_DISABLED : undefined,
+                });
+                (0, vitest_1.expect)(checkIsInert(tests_1.screen.getByText('Вложенный договор'))).toBe(false);
+            });
+        });
+    });
+};
+exports.testDataGridSelection = testDataGridSelection;

package/node/components/DataGrid/types.d.ts

@@ -46,6 +46,11 @@ export type DataGridProps<TData extends Record<string, CellValue> = DataGridRow,
      * Компонент кастомного футера (например Pagination)
      */
     footer?: ReactNode;
+    /**
+     * Панель массовых действий над выбранными строками
+     * @example <DataGrid massActions={<DataGridMassActions />} />
+     */
+    massActions?: ReactNode;
     /**
      *  Используется для отображения placeholder при отсутствии данных в таблице
      */
@@ -149,6 +154,23 @@ export type DataGridProps<TData extends Record<string, CellValue> = DataGridRow,
      * Обработчик выбора строки
      */
     onSelectRow?: (row: TData[]) => void;
+    /**
+     * Возвращает блокировку строки { mode, reason }
+     * @example
+     * const getRowDisabled = useCallback(
+     *   (row: Document): DataGridRowDisabled | undefined => {
+     *     if (row.status === 'Отправлен') {
+     *       return { mode: 'selection', reason: 'Документ уже отправлен получателю' };
+     *     }
+     *
+     *     return undefined;
+     *   },
+     *   [],
+     * );
+     *
+     * <DataGrid getRowDisabled={getRowDisabled} />
+     */
+    getRowDisabled?: (row: TData) => DataGridRowDisabled | undefined;
     /**
      * @example <DataGrid onSort={({fieldId: 'test', sort: 'asc'}) => console.log('sorted')} />
      * Обработчик сортировки
@@ -313,14 +335,29 @@ export type DataGridRowOptionColumns<TData extends Record<string, CellValue>> =
      */
     renderCell?: RenderCell<TData>;
 };
+/**
+ * Состояние блокировки строки
+ */
+export type DataGridRowDisabled = {
+    /**
+     * Тип блокировки
+     */
+    mode: 'selection' | 'row' | 'row-except-last-cell';
+    /**
+     * Причина блокировки
+     */
+    reason: string;
+};
 export type DataGridRowOptions<TData extends Record<string, CellValue>> = {
     /**
      * Если true, строка будет недоступна для взаимодействия
+     * @deprecated Используйте `getRowDisabled` с `mode: 'row'`.
      */
     isDisabled?: boolean;
     /**
-     * Если true, последняя ячейка не будет блокироваться при `isDisabled=true`
+     * Если false, последняя ячейка не блокируется при `isDisabled=true`
      * @default 'true'
+     * @deprecated Используйте `getRowDisabled` с `mode: 'row-except-last-cell'`.
      */
     isDisabledLastCell?: boolean;
     /**
@@ -329,6 +366,7 @@ export type DataGridRowOptions<TData extends Record<string, CellValue>> = {
     isNotSelectable?: boolean;
     /**
      * Причина блокировки строки
+     * @deprecated Используйте `reason` в `getRowDisabled`.
      */
     disabledReason?: string;
     /**
@@ -367,4 +405,6 @@ export type DataGridRowWithOptions<TData extends DataGridRow> = TData & {
     children?: DataGridRowWithOptions<TData>[];
 };
 export type ContextOnRowClick = (row: Record<string, unknown>) => void;
+export type ContextSelectedRows = Record<string, unknown>[];
+export type ContextOnChangeSelectedRows = (rows: ContextSelectedRows) => void;
 export type RenderRow = (row: Record<string, unknown>, index: number) => ReactNode;