@snack-uikit/table 0.37.2 → 0.37.3-preview-20442bcb.0

package/README.md

@@ -123,7 +123,7 @@ const columnDefinitions: ColumnDefinition<TableData>[] = [
 | enableSelectPinned | `boolean` | - | Параметр отвечает за чекбокс выбора закрепленных строк |
 | sorting | `{ initialState?: SortingState; state?: SortingState; onChange?(state: SortingState): void; }` | - | Параметры отвечают за возможность сортировки, их стоит использовать если нужно отслеживать состояние <br> <strong>initialState</strong>: Начальное состояние сортировки <br> <strong>state</strong>: Состояние сортировки, жестко устанавливаемое снаружи <br> <strong>onChange</strong>: Колбэк на изменение сортировки |
 | columnsSettings | `{ enableDrag?: boolean; enableSettingsMenu?: boolean; }` | - | Параметры отвечают за настройки колонок <br> <strong>enableDrag</strong>: Включение сортировки порядка столбцов вручную перетаскиванием <br> <strong>enableSettingsMenu</strong>: Включение настроек показа колонок <br> |
-| expanding | `{ getSubRows: (element: TData) => TData[]; expandingColumnDefinition: TreeColumnDefinitionProps<TData>; }` | - | Параметр отвечает за общие настройки раскрывающихся строк |
+| expanding | `{ getSubRows: (element: TData) => TData[]; expandingColumnDefinition: TreeColumnDefinitionProps<TData>; state?: ExpandedState; onExpandedChange?(state: ExpandedState): void; }` | - | Параметр отвечает за общие настройки раскрывающихся строк <br> <strong>getSubRows</strong>: Метод отвечает за получение дочерних строк <br> <strong>expandingColumnDefinition</strong>: Описание колонок для дочерних строк <br> <strong>state</strong>: Состояние открытых строк <br> <strong>onExpandedChange</strong>: Колбэк на раскрытие строк <br> |
 | rowSelection | `{ initialState?: RowSelectionState; state?: RowSelectionState; enable?: boolean \| ((row: Row<TData>) => boolean); multiRow?: boolean; onChange?(state: RowSelectionState): void; }` | - | Параметры отвечают за возможность выбора строк <br> <strong>initialState</strong>: Начальное состояние выбора строк <br> <strong>state</strong>: Состояние выбора строк, жестко устанавливаемое снаружи <br> <strong>enable</strong>: Колбэк определяющий можно ли выбрать строку <br> <strong>multiRow</strong>: Мульти-выбор строк (включен по-умолчанию, когда включается выбор) <br> <strong>onChange</strong>: Колбэк на выбор строк |
 | search | `{ initialState?: string; state?: string; placeholder?: string; loading?: boolean; onChange?(value: string): void; }` | 'Search'<br> <strong>loading</strong>: Состояние загрузки в строке поиска <br> <strong>onChange</strong>: Колбэк на изменение данных в строке поиска | Параметры отвечают за глобальный поиск в таблице <br> <strong>initialState</strong>: Начальное состояние строки поиска <br> <strong>state</strong>: Состояние строки поиска, жестко устанавливаемое снаружи <br> <strong>placeholder</strong>: Placeholder строки поиска |
 | enableFuzzySearch | `boolean` | - | Включить нечеткий поиск |
@@ -196,7 +196,7 @@ const columnDefinitions: ColumnDefinition<TableData>[] = [
 | copyPinnedRows | `boolean` | false | Параметр отвечает за сохранение закрепленных строк в теле таблицы |
 | enableSelectPinned | `boolean` | - | Параметр отвечает за чекбокс выбора закрепленных строк |
 | columnsSettings | `{ enableDrag?: boolean; enableSettingsMenu?: boolean; }` | - | Параметры отвечают за настройки колонок <br> <strong>enableDrag</strong>: Включение сортировки порядка столбцов вручную перетаскиванием <br> <strong>enableSettingsMenu</strong>: Включение настроек показа колонок <br> |
-| expanding | `{ getSubRows: (element: TData) => TData[]; expandingColumnDefinition: TreeColumnDefinitionProps<TData>; }` | - | Параметр отвечает за общие настройки раскрывающихся строк |
+| expanding | `{ getSubRows: (element: TData) => TData[]; expandingColumnDefinition: TreeColumnDefinitionProps<TData>; state?: ExpandedState; onExpandedChange?(state: ExpandedState): void; }` | - | Параметр отвечает за общие настройки раскрывающихся строк <br> <strong>getSubRows</strong>: Метод отвечает за получение дочерних строк <br> <strong>expandingColumnDefinition</strong>: Описание колонок для дочерних строк <br> <strong>state</strong>: Состояние открытых строк <br> <strong>onExpandedChange</strong>: Колбэк на раскрытие строк <br> |
 | rowSelection | `{ initialState?: RowSelectionState; state?: RowSelectionState; enable?: boolean \| ((row: Row<TData>) => boolean); multiRow?: boolean; onChange?(state: RowSelectionState): void; }` | - | Параметры отвечают за возможность выбора строк <br> <strong>initialState</strong>: Начальное состояние выбора строк <br> <strong>state</strong>: Состояние выбора строк, жестко устанавливаемое снаружи <br> <strong>enable</strong>: Колбэк определяющий можно ли выбрать строку <br> <strong>multiRow</strong>: Мульти-выбор строк (включен по-умолчанию, когда включается выбор) <br> <strong>onChange</strong>: Колбэк на выбор строк |
 | enableFuzzySearch | `boolean` | - | Включить нечеткий поиск |
 | rowAutoHeight | `boolean` | - |  |

package/dist/cjs/components/Table/Table.js

@@ -94,6 +94,7 @@ function Table(_a) {
     pageSize
   }), [pageSize]);
   const [sorting, onSortingChange] = (0, hooks_1.useStateControl)(sortingProp, constants_1.DEFAULT_SORTING);
+  const [expanded, onExpandedChange] = (0, hooks_1.useStateControl)(expanding, constants_1.DEFAULT_EXPANDED);
   const [pagination, onPaginationChange] = (0, hooks_1.useStateControl)(paginationProp, defaultPaginationState);
   const {
     filter,
@@ -184,7 +185,8 @@ function Table(_a) {
       pagination,
       rowPinning: expanding ? {
         top: []
-      } : rowPinning
+      } : rowPinning,
+      expanded
     },
     pageCount,
     defaultColumn: {
@@ -216,6 +218,7 @@ function Table(_a) {
     getSubRows: expanding === null || expanding === void 0 ? void 0 : expanding.getSubRows,
     filterFromLeafRows: Boolean(expanding),
     enableSubRowSelection: true,
+    onExpandedChange,
     getFilteredRowModel: (0, react_table_1.getFilteredRowModel)(),
     getExpandedRowModel: (0, react_table_1.getExpandedRowModel)(),
     enableColumnResizing: true,

package/dist/cjs/components/types.d.ts

@@ -4,7 +4,7 @@ import { FiltersState } from '@snack-uikit/chips';
 import { FilterRow, ToolbarProps } from '@snack-uikit/toolbar';
 import { WithSupportProps } from '@snack-uikit/utils';
 import { EmptyStateProps, ExportButtonProps, RowClickHandler, TreeColumnDefinitionProps } from '../helperComponents';
-import { ColumnDefinition } from '../types';
+import { ColumnDefinition, ExpandedState } from '../types';
 type BulkAction = Omit<NonNullable<ToolbarProps<Record<string, string>>['bulkActions']>[number], 'onClick'> & {
     onClick?(selectionState: RowSelectionState, resetRowSelection: (defaultState?: boolean) => void): void;
 };
@@ -37,11 +37,17 @@ type BaseTableProps<TData extends object, TFilters extends FiltersState = Record
         enableDrag?: boolean;
         enableSettingsMenu?: boolean;
     };
-    /** Параметр отвечает за общие настройки раскрывающихся строк*/
+    /** Параметр отвечает за общие настройки раскрывающихся строк <br>
+     * <strong>getSubRows</strong>: Метод отвечает за получение дочерних строк <br>
+     * <strong>expandingColumnDefinition</strong>: Описание колонок для дочерних строк <br>
+     * <strong>state</strong>: Состояние открытых строк <br>
+     * <strong>onExpandedChange</strong>: Колбэк на раскрытие строк <br>
+     * */
     expanding?: {
-        /** Метод отвечает за получение дочерних строк*/
         getSubRows: (element: TData) => TData[] | undefined;
         expandingColumnDefinition: TreeColumnDefinitionProps<TData>;
+        state?: ExpandedState;
+        onExpandedChange?(state: ExpandedState): void;
     };
     /** Параметры отвечают за возможность выбора строк <br>
      * <strong>initialState</strong>: Начальное состояние выбора строк <br>

package/dist/cjs/constants.d.ts

@@ -43,6 +43,7 @@ export declare const DEFAULT_PAGE_SIZE = 10;
 export declare const DEFAULT_SORTING: never[];
 export declare const DEFAULT_FILTER_VISIBILITY: never[];
 export declare const DEFAULT_ROW_SELECTION: {};
+export declare const DEFAULT_EXPANDED: {};
 export declare enum DefaultColumns {
     Status = "snack_predefined_statusColumn",
     Selection = "selectionCell",

package/dist/cjs/constants.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.DEFAULT_COLUMNS = exports.DefaultColumns = exports.DEFAULT_ROW_SELECTION = exports.DEFAULT_FILTER_VISIBILITY = exports.DEFAULT_SORTING = exports.DEFAULT_PAGE_SIZE = exports.SORT_FN = exports.TEST_IDS = exports.COLUMN_SETTINGS_MODE = exports.COLUMN_ALIGN = exports.COLUMN_PIN_POSITION = void 0;
+exports.DEFAULT_COLUMNS = exports.DefaultColumns = exports.DEFAULT_EXPANDED = exports.DEFAULT_ROW_SELECTION = exports.DEFAULT_FILTER_VISIBILITY = exports.DEFAULT_SORTING = exports.DEFAULT_PAGE_SIZE = exports.SORT_FN = exports.TEST_IDS = exports.COLUMN_SETTINGS_MODE = exports.COLUMN_ALIGN = exports.COLUMN_PIN_POSITION = void 0;
 exports.COLUMN_PIN_POSITION = {
   Left: 'left',
   Right: 'right'
@@ -50,6 +50,7 @@ exports.DEFAULT_PAGE_SIZE = 10;
 exports.DEFAULT_SORTING = [];
 exports.DEFAULT_FILTER_VISIBILITY = [];
 exports.DEFAULT_ROW_SELECTION = {};
+exports.DEFAULT_EXPANDED = {};
 var DefaultColumns;
 (function (DefaultColumns) {
   DefaultColumns["Status"] = "snack_predefined_statusColumn";

package/dist/cjs/types.d.ts

@@ -1,4 +1,4 @@
-import { CellContext, ColumnDef, ColumnMeta, HeaderContext, PaginationState, RowSelectionOptions, RowSelectionState, SortingState } from '@tanstack/react-table';
+import { CellContext, ColumnDef, ColumnMeta, ExpandedState, HeaderContext, PaginationState, RowSelectionOptions, RowSelectionState, SortingState } from '@tanstack/react-table';
 import { ReactNode } from 'react';
 import { ToolbarProps } from '@snack-uikit/toolbar';
 import { ValueOf } from '@snack-uikit/utils';
@@ -56,4 +56,4 @@ export type FilterableColumnDefinition<TData> = FilterableNormalColumnDefinition
 export type ColumnDefinition<TData> = NormalColumnDefinition<TData> | PinnedColumnDefinition<TData> | FilterableColumnDefinition<TData>;
 export type ColumnOrder = string[];
 export type { RowActionsColumnDefProps, StatusColumnDefinitionProps, RowInfo, RowClickHandler, ActionsGenerator, CopyCellProps, MapStatusToAppearanceFnType, } from './helperComponents';
-export type { ColumnPinPosition, PaginationState, SortingState, RowSelectionState, RowSelectionOptions, EmptyStateProps, ToolbarProps, HeaderContext, CellContext, };
+export type { ColumnPinPosition, PaginationState, SortingState, RowSelectionState, RowSelectionOptions, EmptyStateProps, ToolbarProps, HeaderContext, CellContext, ExpandedState, };

package/dist/esm/components/Table/Table.js

@@ -20,7 +20,7 @@ import { SkeletonContextProvider } from '@snack-uikit/skeleton';
 import { Toolbar } from '@snack-uikit/toolbar';
 import { TruncateString } from '@snack-uikit/truncate-string';
 import { extractSupportProps } from '@snack-uikit/utils';
-import { DEFAULT_PAGE_SIZE, DEFAULT_ROW_SELECTION, DEFAULT_SORTING, DefaultColumns, TEST_IDS } from '../../constants';
+import { DEFAULT_EXPANDED, DEFAULT_PAGE_SIZE, DEFAULT_ROW_SELECTION, DEFAULT_SORTING, DefaultColumns, TEST_IDS, } from '../../constants';
 import { CellAutoResizeContext, useCellAutoResizeController } from '../../contexts';
 import { BodyRow, ColumnsSettings, ExportButton, getColumnId, getRowActionsColumnDef, getStatusColumnDef, HeaderRow, STATUS_APPEARANCE, TableContext, TableEmptyState, TablePagination, useEmptyState, } from '../../helperComponents';
 import { fuzzyFilter } from '../../utils';
@@ -41,6 +41,7 @@ export function Table(_a) {
         pageSize,
     }), [pageSize]);
     const [sorting, onSortingChange] = useStateControl(sortingProp, DEFAULT_SORTING);
+    const [expanded, onExpandedChange] = useStateControl(expanding, DEFAULT_EXPANDED);
     const [pagination, onPaginationChange] = useStateControl(paginationProp, defaultPaginationState);
     const { filter, patchedFilter, setFilter, setFilterVisibility } = useFilters({ columnFilters });
     const validatePersistedState = useMemo(() => (data) => {
@@ -110,6 +111,7 @@ export function Table(_a) {
             sorting,
             pagination,
             rowPinning: expanding ? { top: [] } : rowPinning,
+            expanded,
         },
         pageCount,
         defaultColumn: {
@@ -138,6 +140,7 @@ export function Table(_a) {
         getSubRows: expanding === null || expanding === void 0 ? void 0 : expanding.getSubRows,
         filterFromLeafRows: Boolean(expanding),
         enableSubRowSelection: true,
+        onExpandedChange,
         getFilteredRowModel: getFilteredRowModel(),
         getExpandedRowModel: getExpandedRowModel(),
         enableColumnResizing: true,

package/dist/esm/components/types.d.ts

@@ -4,7 +4,7 @@ import { FiltersState } from '@snack-uikit/chips';
 import { FilterRow, ToolbarProps } from '@snack-uikit/toolbar';
 import { WithSupportProps } from '@snack-uikit/utils';
 import { EmptyStateProps, ExportButtonProps, RowClickHandler, TreeColumnDefinitionProps } from '../helperComponents';
-import { ColumnDefinition } from '../types';
+import { ColumnDefinition, ExpandedState } from '../types';
 type BulkAction = Omit<NonNullable<ToolbarProps<Record<string, string>>['bulkActions']>[number], 'onClick'> & {
     onClick?(selectionState: RowSelectionState, resetRowSelection: (defaultState?: boolean) => void): void;
 };
@@ -37,11 +37,17 @@ type BaseTableProps<TData extends object, TFilters extends FiltersState = Record
         enableDrag?: boolean;
         enableSettingsMenu?: boolean;
     };
-    /** Параметр отвечает за общие настройки раскрывающихся строк*/
+    /** Параметр отвечает за общие настройки раскрывающихся строк <br>
+     * <strong>getSubRows</strong>: Метод отвечает за получение дочерних строк <br>
+     * <strong>expandingColumnDefinition</strong>: Описание колонок для дочерних строк <br>
+     * <strong>state</strong>: Состояние открытых строк <br>
+     * <strong>onExpandedChange</strong>: Колбэк на раскрытие строк <br>
+     * */
     expanding?: {
-        /** Метод отвечает за получение дочерних строк*/
         getSubRows: (element: TData) => TData[] | undefined;
         expandingColumnDefinition: TreeColumnDefinitionProps<TData>;
+        state?: ExpandedState;
+        onExpandedChange?(state: ExpandedState): void;
     };
     /** Параметры отвечают за возможность выбора строк <br>
      * <strong>initialState</strong>: Начальное состояние выбора строк <br>

package/dist/esm/constants.d.ts

@@ -43,6 +43,7 @@ export declare const DEFAULT_PAGE_SIZE = 10;
 export declare const DEFAULT_SORTING: never[];
 export declare const DEFAULT_FILTER_VISIBILITY: never[];
 export declare const DEFAULT_ROW_SELECTION: {};
+export declare const DEFAULT_EXPANDED: {};
 export declare enum DefaultColumns {
     Status = "snack_predefined_statusColumn",
     Selection = "selectionCell",

package/dist/esm/constants.js

@@ -44,6 +44,7 @@ export const DEFAULT_PAGE_SIZE = 10;
 export const DEFAULT_SORTING = [];
 export const DEFAULT_FILTER_VISIBILITY = [];
 export const DEFAULT_ROW_SELECTION = {};
+export const DEFAULT_EXPANDED = {};
 export var DefaultColumns;
 (function (DefaultColumns) {
     DefaultColumns["Status"] = "snack_predefined_statusColumn";

package/dist/esm/types.d.ts

@@ -1,4 +1,4 @@
-import { CellContext, ColumnDef, ColumnMeta, HeaderContext, PaginationState, RowSelectionOptions, RowSelectionState, SortingState } from '@tanstack/react-table';
+import { CellContext, ColumnDef, ColumnMeta, ExpandedState, HeaderContext, PaginationState, RowSelectionOptions, RowSelectionState, SortingState } from '@tanstack/react-table';
 import { ReactNode } from 'react';
 import { ToolbarProps } from '@snack-uikit/toolbar';
 import { ValueOf } from '@snack-uikit/utils';
@@ -56,4 +56,4 @@ export type FilterableColumnDefinition<TData> = FilterableNormalColumnDefinition
 export type ColumnDefinition<TData> = NormalColumnDefinition<TData> | PinnedColumnDefinition<TData> | FilterableColumnDefinition<TData>;
 export type ColumnOrder = string[];
 export type { RowActionsColumnDefProps, StatusColumnDefinitionProps, RowInfo, RowClickHandler, ActionsGenerator, CopyCellProps, MapStatusToAppearanceFnType, } from './helperComponents';
-export type { ColumnPinPosition, PaginationState, SortingState, RowSelectionState, RowSelectionOptions, EmptyStateProps, ToolbarProps, HeaderContext, CellContext, };
+export type { ColumnPinPosition, PaginationState, SortingState, RowSelectionState, RowSelectionOptions, EmptyStateProps, ToolbarProps, HeaderContext, CellContext, ExpandedState, };

package/package.json

@@ -4,7 +4,7 @@
     "access": "public"
   },
   "title": "Table",
-  "version": "0.37.2",
+  "version": "0.37.3-preview-20442bcb.0",
   "sideEffects": [
     "*.css",
     "*.woff",
@@ -66,5 +66,5 @@
   "peerDependencies": {
     "@snack-uikit/locale": "*"
   },
-  "gitHead": "d19049c7017c7753cc6d261afebf555e1aa76661"
+  "gitHead": "cb7321ae85233da3b8da83934e39fbbcbb6b0295"
 }

package/src/components/Table/Table.tsx

@@ -2,6 +2,7 @@ import { DndContext } from '@dnd-kit/core';
 import {
   CellContext,
   ColumnPinningState,
+  ExpandedState,
   getCoreRowModel,
   getExpandedRowModel,
   getFilteredRowModel,
@@ -24,7 +25,14 @@ import { type PersistedFilterState, Toolbar, ToolbarProps } from '@snack-uikit/t
 import { TruncateString } from '@snack-uikit/truncate-string';
 import { extractSupportProps } from '@snack-uikit/utils';
 
-import { DEFAULT_PAGE_SIZE, DEFAULT_ROW_SELECTION, DEFAULT_SORTING, DefaultColumns, TEST_IDS } from '../../constants';
+import {
+  DEFAULT_EXPANDED,
+  DEFAULT_PAGE_SIZE,
+  DEFAULT_ROW_SELECTION,
+  DEFAULT_SORTING,
+  DefaultColumns,
+  TEST_IDS,
+} from '../../constants';
 import { CellAutoResizeContext, useCellAutoResizeController } from '../../contexts';
 import {
   BodyRow,
@@ -134,6 +142,8 @@ export function Table<TData extends object, TFilters extends FiltersState = Reco
 
   const [sorting, onSortingChange] = useStateControl<SortingState>(sortingProp, DEFAULT_SORTING);
 
+  const [expanded, onExpandedChange] = useStateControl<ExpandedState>(expanding, DEFAULT_EXPANDED);
+
   const [pagination, onPaginationChange] = useStateControl<PaginationState>(paginationProp, defaultPaginationState);
 
   const { filter, patchedFilter, setFilter, setFilterVisibility } = useFilters({ columnFilters });
@@ -235,6 +245,7 @@ export function Table<TData extends object, TFilters extends FiltersState = Reco
       sorting,
       pagination,
       rowPinning: expanding ? { top: [] } : rowPinning,
+      expanded,
     },
     pageCount,
     defaultColumn: {
@@ -266,6 +277,7 @@ export function Table<TData extends object, TFilters extends FiltersState = Reco
     getSubRows: expanding?.getSubRows,
     filterFromLeafRows: Boolean(expanding),
     enableSubRowSelection: true,
+    onExpandedChange,
     getFilteredRowModel: getFilteredRowModel(),
     getExpandedRowModel: getExpandedRowModel(),
     enableColumnResizing: true,

package/src/components/types.ts

@@ -13,7 +13,7 @@ import { FilterRow, ToolbarProps } from '@snack-uikit/toolbar';
 import { WithSupportProps } from '@snack-uikit/utils';
 
 import { EmptyStateProps, ExportButtonProps, RowClickHandler, TreeColumnDefinitionProps } from '../helperComponents';
-import { ColumnDefinition } from '../types';
+import { ColumnDefinition, ExpandedState } from '../types';
 
 type BulkAction = Omit<NonNullable<ToolbarProps<Record<string, string>>['bulkActions']>[number], 'onClick'> & {
   onClick?(selectionState: RowSelectionState, resetRowSelection: (defaultState?: boolean) => void): void;
@@ -50,11 +50,17 @@ type BaseTableProps<TData extends object, TFilters extends FiltersState = Record
     enableSettingsMenu?: boolean;
   };
 
-  /** Параметр отвечает за общие настройки раскрывающихся строк*/
+  /** Параметр отвечает за общие настройки раскрывающихся строк <br>
+   * <strong>getSubRows</strong>: Метод отвечает за получение дочерних строк <br>
+   * <strong>expandingColumnDefinition</strong>: Описание колонок для дочерних строк <br>
+   * <strong>state</strong>: Состояние открытых строк <br>
+   * <strong>onExpandedChange</strong>: Колбэк на раскрытие строк <br>
+   * */
   expanding?: {
-    /** Метод отвечает за получение дочерних строк*/
     getSubRows: (element: TData) => TData[] | undefined;
     expandingColumnDefinition: TreeColumnDefinitionProps<TData>;
+    state?: ExpandedState;
+    onExpandedChange?(state: ExpandedState): void;
   };
   /** Параметры отвечают за возможность выбора строк <br>
    * <strong>initialState</strong>: Начальное состояние выбора строк <br>

package/src/constants.ts

@@ -49,6 +49,7 @@ export const DEFAULT_PAGE_SIZE = 10;
 export const DEFAULT_SORTING = [];
 export const DEFAULT_FILTER_VISIBILITY = [];
 export const DEFAULT_ROW_SELECTION = {};
+export const DEFAULT_EXPANDED = {};
 
 export enum DefaultColumns {
   Status = 'snack_predefined_statusColumn',

package/src/types.ts

@@ -2,6 +2,7 @@ import {
   CellContext,
   ColumnDef,
   ColumnMeta,
+  ExpandedState,
   HeaderContext,
   PaginationState,
   RowSelectionOptions,
@@ -115,4 +116,5 @@ export type {
   ToolbarProps,
   HeaderContext,
   CellContext,
+  ExpandedState,
 };