@cloud-ru/ds-toolbar 1.0.24-preview-494c465d.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -3,6 +3,12 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ # 1.1.0 (2026-09-28)
7
+
8
+ ### Features
9
+
10
+ - **FF-9021:** add state storage prop ([ea2b24f](https://github.com/cloud-ru-tech/snack-v2/commit/ea2b24fc1c7525aa92074c7821b809937b69a22e))
11
+
6
12
  ## 1.0.23 (2026-09-25)
7
13
 
8
14
  ### Bug Fixes
package/README.md CHANGED
@@ -208,7 +208,7 @@ export function WithDataView() {
208
208
  | `onCheck` | `(() => void)` | — | Колбек смены значения чекбокса |
209
209
  | `onRefresh` | `(() => void)` | — | Колбек обновления |
210
210
  | `outline` | `boolean` | `true` | Внешний бордер |
211
- | `persist` | `ToolbarPersistConfig` | — | Конфиг для сохранения состояния в localStorage и queryParams. <br> <br/> Поле id должно быть уникальным для каждого инстанса компонента. <br> |
211
+ | `persist` | `ToolbarPersistConfig` | — | Конфиг сохранения состояния в URL, localStorage и sessionStorage. <br> <br/> Поле id должно быть уникальным для каждого инстанса компонента. <br> |
212
212
  | `search` | `SearchProps` | — | Параметры отвечают за строку поиска <br> <br/> <strong>value</strong>: Значение строки поиска <br> <br/> <strong>onChange</strong>: Колбэк смены значения <br> <br/> <strong>onSubmit</strong>: Колбэк на подтверждение поиска по строке <br/> <strong>placeholder</strong>: Плейсхолдер <br> <br/> <strong>loading</strong>: Состояние загрузки <br> |
213
213
  | `selectedCount` | `number` | — | Количество выбранных элементов (для подписи Selected: N) |
214
214
  | `showBulkCheckbox` | `boolean` | `true` | Показывать чекбокс слева (Figma: showBulkCheckbox) |
@@ -317,12 +317,14 @@ export function WithDataView() {
317
317
  | `parser` | `((value: string) => PersistedFilterState<T>) \| undefined` | — | Custom-парсер queryParams для преобразования в данные состояния |
318
318
  | `serializer` | `((value: PersistedFilterState<T>) => string) \| undefined` | — | Custom-сериализация состояния перед сохранением в queryParams |
319
319
  | `state` | `PersistedFilterState` | — | Состояние для сохранения |
320
+ | `storages` | `DataPersistStorage` | — | Хранилища общего состояния. По умолчанию queryParams и localStorage; [] отключает сохранение. <br/> Чтение: URL → sessionStorage → localStorage. Изменение после монтирования не поддерживается. <br/> Для всех вариантов необходимы id и filterQueryKey. |
320
321
  | `validateData` | `((value: unknown) => value is PersistedFilterState<T>) \| undefined` | — | Валидатор сохраненных |
321
322
 
322
323
  ## Смотри также
323
324
 
324
325
  - **`Search`** — поле поиска внутри тулбара (`background={false}`).
325
326
  - **`SegmentControl`** — типичный контент слота `dataView`.
327
+
326
328
  ## Адаптивность
327
329
 
328
330
  `Toolbar` — адаптивный компонент: DOM остаётся единым, но при mobile-раскладке панель перестраивается. Раскладку он берёт из `AdaptiveProvider` (контекст `@cloud-ru/ds-adaptive`); публичный API единый для обеих платформ:
@@ -402,3 +404,36 @@ export function MobileLayout() {
402
404
  ```
403
405
 
404
406
  Подробнее о модели адаптивности — [Адаптивность — паттерн](/patterns/adaptive).
407
+
408
+ ## Хранилища состояния
409
+
410
+ `persist.storages` задаёт хранилища общего объекта: фильтров, поиска, пагинации и сортировки.
411
+ Для сохранения и восстановления необходимы одновременно `id` и `filterQueryKey`, даже если URL отключён.
412
+
413
+ ```tsx
414
+ persist={{
415
+ id: 'orders',
416
+ filterQueryKey: 'ordersState',
417
+ storages: ['queryParams', 'sessionStorage'],
418
+ }}
419
+ ```
420
+
421
+ | Значение `storages` | Результат |
422
+ | --- | --- |
423
+ | Не задано | URL и localStorage — прежнее поведение |
424
+ | `['queryParams']` | Только URL |
425
+ | `['localStorage']` | Только localStorage |
426
+ | `['sessionStorage']` | Только sessionStorage |
427
+ | `['queryParams', 'sessionStorage']` | URL и sessionStorage |
428
+ | `[]` | Сохранение и восстановление отключены |
429
+
430
+ При восстановлении используется первый валидный объект целиком: URL → sessionStorage → localStorage.
431
+ Отключённые источники не читаются и не изменяются. Порядок списка не влияет на приоритет, повторы игнорируются.
432
+ Если данных нет или они невалидны, сохраняется исходное состояние компонента.
433
+
434
+ localStorage и sessionStorage используют ключ `${id}_filter` и JSON.
435
+ Пользовательские `parser` и `serializer` применяются только к URL, ключ которого задаёт `filterQueryKey`.
436
+ Ошибка одного источника не препятствует работе остальных.
437
+ Сброс фильтров или поиска записывает обновлённое состояние; старые и отключённые хранилища не очищаются.
438
+
439
+ Конфигурация задаётся при монтировании. Переключение хранилищ после монтирования не поддерживается.
@@ -34,6 +34,7 @@ function usePersistState({ persist, filter, search, }) {
34
34
  return persist?.validateData ? baseValid && persist.validateData(value) : baseValid;
35
35
  };
36
36
  return {
37
+ storages: persist.storages,
37
38
  queryKey: persist.filterQueryKey,
38
39
  localStorageKey: `${persist.id}_filter`,
39
40
  validateData: combinedValidate,
@@ -1,5 +1,5 @@
1
1
  import { ChipChoiceRowProps, FiltersState } from '@cloud-ru/ds-chips';
2
- import { WithSupportProps } from '@cloud-ru/ds-utils';
2
+ import { DataPersistStorage, WithSupportProps } from '@cloud-ru/ds-utils';
3
3
  import { ReactNode } from 'react';
4
4
  import { RequestPayloadParams } from '@cloud-ru/ft-request-payload-transform';
5
5
  import { BulkActionsProps, DataViewProps, DataViewValue, MoreActionsProps, SearchProps } from '../../helperComponents';
@@ -55,6 +55,11 @@ export type PersistedFilterState<T extends FiltersState> = {
55
55
  filter?: T;
56
56
  };
57
57
  export type ToolbarPersistConfig<T extends FiltersState> = {
58
+ /** Хранилища общего состояния. По умолчанию queryParams и localStorage; [] отключает сохранение.
59
+ * Чтение: URL → sessionStorage → localStorage. Изменение после монтирования не поддерживается.
60
+ * Для всех вариантов необходимы id и filterQueryKey.
61
+ */
62
+ storages?: DataPersistStorage[];
58
63
  /** Уникальный id для текущего инстанса компонента */
59
64
  id?: string;
60
65
  /** Ключ для queryParams */
@@ -72,7 +77,7 @@ export type ToolbarPersistConfig<T extends FiltersState> = {
72
77
  };
73
78
  export type ToolbarProps<TState extends FiltersState = Record<string, unknown>> = WithSupportProps<DefaultToolbarProps | CheckedToolbarProps> & {
74
79
  filterRow?: FilterRow<TState>;
75
- /** Конфиг для сохранения состояния в localStorage и queryParams. <br>
80
+ /** Конфиг сохранения состояния в URL, localStorage и sessionStorage. <br>
76
81
  * Поле id должно быть уникальным для каждого инстанса компонента. <br>
77
82
  * */
78
83
  persist?: ToolbarPersistConfig<TState>;
@@ -31,6 +31,7 @@ export function usePersistState({ persist, filter, search, }) {
31
31
  return persist?.validateData ? baseValid && persist.validateData(value) : baseValid;
32
32
  };
33
33
  return {
34
+ storages: persist.storages,
34
35
  queryKey: persist.filterQueryKey,
35
36
  localStorageKey: `${persist.id}_filter`,
36
37
  validateData: combinedValidate,
@@ -1,5 +1,5 @@
1
1
  import { ChipChoiceRowProps, FiltersState } from '@cloud-ru/ds-chips';
2
- import { WithSupportProps } from '@cloud-ru/ds-utils';
2
+ import { DataPersistStorage, WithSupportProps } from '@cloud-ru/ds-utils';
3
3
  import { ReactNode } from 'react';
4
4
  import { RequestPayloadParams } from '@cloud-ru/ft-request-payload-transform';
5
5
  import { BulkActionsProps, DataViewProps, DataViewValue, MoreActionsProps, SearchProps } from '../../helperComponents/index.js';
@@ -55,6 +55,11 @@ export type PersistedFilterState<T extends FiltersState> = {
55
55
  filter?: T;
56
56
  };
57
57
  export type ToolbarPersistConfig<T extends FiltersState> = {
58
+ /** Хранилища общего состояния. По умолчанию queryParams и localStorage; [] отключает сохранение.
59
+ * Чтение: URL → sessionStorage → localStorage. Изменение после монтирования не поддерживается.
60
+ * Для всех вариантов необходимы id и filterQueryKey.
61
+ */
62
+ storages?: DataPersistStorage[];
58
63
  /** Уникальный id для текущего инстанса компонента */
59
64
  id?: string;
60
65
  /** Ключ для queryParams */
@@ -72,7 +77,7 @@ export type ToolbarPersistConfig<T extends FiltersState> = {
72
77
  };
73
78
  export type ToolbarProps<TState extends FiltersState = Record<string, unknown>> = WithSupportProps<DefaultToolbarProps | CheckedToolbarProps> & {
74
79
  filterRow?: FilterRow<TState>;
75
- /** Конфиг для сохранения состояния в localStorage и queryParams. <br>
80
+ /** Конфиг сохранения состояния в URL, localStorage и sessionStorage. <br>
76
81
  * Поле id должно быть уникальным для каждого инстанса компонента. <br>
77
82
  * */
78
83
  persist?: ToolbarPersistConfig<TState>;