@cloud-ru/ds-utils 1.1.0 → 1.3.0

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 1.3.0 (2026-10-17)
+
+### Features
+
+- **FF-8949:** improve typings for componentPropsProcessors ([d17bae0](https://github.com/cloud-ru-tech/snack-v2/commit/d17bae0eaf11e56e3e631fd52a4da5d4bb97f7f4))
+
+# 1.2.0 (2026-09-28)
+
+### Features
+
+- **FF-9021:** add state storage prop ([ea2b24f](https://github.com/cloud-ru-tech/snack-v2/commit/ea2b24fc1c7525aa92074c7821b809937b69a22e))
+
 # 1.1.0 (2026-08-24)
 
 ### Features

package/dist/cjs/hooks/useDataPersist/sources/index.d.ts

@@ -1,3 +1,4 @@
 export * from './queryParamSource';
 export * from './localStorageSource';
 export * from './baseSource';
+export * from './sessionStorageSource';

package/dist/cjs/hooks/useDataPersist/sources/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./queryParamSource"), exports);
 __exportStar(require("./localStorageSource"), exports);
 __exportStar(require("./baseSource"), exports);
+__exportStar(require("./sessionStorageSource"), exports);

package/dist/cjs/hooks/useDataPersist/sources/sessionStorageSource.d.ts

@@ -0,0 +1,5 @@
+import { BaseSource } from './baseSource';
+export declare class SessionStorageSource<TData> extends BaseSource<TData> {
+    getFromSource(): string;
+    setToSource(value: string): void;
+}

package/dist/cjs/hooks/useDataPersist/sources/sessionStorageSource.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionStorageSource = void 0;
+const utils_1 = require("../../../utils");
+const baseSource_1 = require("./baseSource");
+class SessionStorageSource extends baseSource_1.BaseSource {
+    getFromSource() {
+        if ((0, utils_1.isBrowser)()) {
+            return sessionStorage.getItem(this.filterKey) || '';
+        }
+        return '';
+    }
+    setToSource(value) {
+        if ((0, utils_1.isBrowser)()) {
+            sessionStorage.setItem(this.filterKey, value);
+        }
+    }
+}
+exports.SessionStorageSource = SessionStorageSource;

package/dist/cjs/hooks/useDataPersist/useDataPersist.d.ts

@@ -1,5 +1,7 @@
 import { type StateProps } from './useSource';
+export type DataPersistStorage = 'queryParams' | 'localStorage' | 'sessionStorage';
 export type DataPersistOptions<T> = {
+    storages?: DataPersistStorage[];
     queryKey: string;
     localStorageKey: string;
     validateData(value: unknown): value is T;

package/dist/cjs/hooks/useDataPersist/useDataPersist.js

@@ -4,9 +4,21 @@ exports.useDataPersist = void 0;
 const react_1 = require("react");
 const sources_1 = require("./sources");
 const useSource_1 = require("./useSource");
+const DEFAULT_STORAGES = ['queryParams', 'localStorage'];
 const useDataPersist = ({ options, parser, serializer }) => {
-    const querySource = (0, react_1.useMemo)(() => options ? new sources_1.QueryParamSource(options.queryKey, options.validateData, parser, serializer) : undefined, [options, parser, serializer]);
-    const localStorageSource = (0, react_1.useMemo)(() => (options ? new sources_1.LocalStorageSource(options.localStorageKey, options.validateData) : undefined), [options]);
+    const storages = options?.storages ?? DEFAULT_STORAGES;
+    const querySource = (0, react_1.useMemo)(() => options && storages.includes('queryParams')
+        ? new sources_1.QueryParamSource(options.queryKey, options.validateData, parser, serializer)
+        : undefined, [options, parser, serializer, storages]);
+    const localStorageSource = (0, react_1.useMemo)(() => options && storages.includes('localStorage')
+        ? new sources_1.LocalStorageSource(options.localStorageKey, options.validateData)
+        : undefined, [options, storages]);
+    const sessionStorageSource = (0, react_1.useMemo)(() => options && storages.includes('sessionStorage')
+        ? new sources_1.SessionStorageSource(options.localStorageKey, options.validateData)
+        : undefined, [options, storages]);
+    const { getData: getSessionStorageData, setData: setSessionStorageData } = (0, useSource_1.useSource)({
+        source: sessionStorageSource,
+    });
     const { getData: getLocalStorageData, setData: setLocalStorageData } = (0, useSource_1.useSource)({
         source: localStorageSource,
     });
@@ -15,12 +27,13 @@ const useDataPersist = ({ options, parser, serializer }) => {
     });
     const setDataToStorages = (0, react_1.useCallback)((data) => {
         setLocalStorageData(data);
+        setSessionStorageData(data);
         setQueryParamsData(data);
-    }, [setLocalStorageData, setQueryParamsData]);
+    }, [setLocalStorageData, setSessionStorageData, setQueryParamsData]);
     const getDefaultData = (0, react_1.useCallback)(() => {
         const queryData = getQueryParamsData();
-        return queryData ?? getLocalStorageData();
-    }, [getLocalStorageData, getQueryParamsData]);
+        return queryData ?? getSessionStorageData() ?? getLocalStorageData();
+    }, [getLocalStorageData, getSessionStorageData, getQueryParamsData]);
     return { getDefaultData, setDataToStorages };
 };
 exports.useDataPersist = useDataPersist;

package/dist/cjs/hooks/useDataPersist/useSource.js

@@ -7,7 +7,12 @@ const useSource = ({ source }) => {
         if (!source) {
             return;
         }
-        source.setData(data);
+        try {
+            source.setData(data);
+        }
+        catch {
+            // Ошибка одного хранилища не должна прерывать запись в остальные.
+        }
     }, [source]);
     const getData = (0, react_1.useCallback)(() => source?.getData() ?? undefined, [source]);
     return { getData, setData };

package/dist/cjs/utils/componentPropsProcessors.d.ts

@@ -6,14 +6,14 @@ export type WithSupportProps<T> = {
  * Функция для исключения вспомогательных свойств (data-test-id & aria-*)
  * @function helper
  */
-export declare function excludeSupportProps<T extends Record<string, unknown>>(props: T): {};
+export declare function excludeSupportProps<T extends Record<string, unknown>>(props: T): Omit<T, `data-${string}` | `aria-${string}`>;
 /**
  * Функция для отбора свойства data-test-id
  * @function helper
  */
-export declare function extractDataTestProps<T extends Record<string, unknown>>(props: T): Record<string, unknown>;
+export declare function extractDataTestProps<T extends Record<string, unknown>>(props: T): Pick<T, `data-test-${string}`>;
 /**
  * Функция для отбора вспомогательных свойств (data-test-id & aria-*)
  * @function helper
  */
-export declare function extractSupportProps<T extends Record<string, unknown>>(props: T): Record<string, unknown>;
+export declare function extractSupportProps<T extends Record<string, unknown>>(props: T): Pick<T, Extract<keyof T, `data-${string}` | `aria-${string}`>>;

package/dist/esm/hooks/useDataPersist/sources/index.d.ts

@@ -1,3 +1,4 @@
 export * from './queryParamSource.js';
 export * from './localStorageSource.js';
 export * from './baseSource.js';
+export * from './sessionStorageSource.js';

package/dist/esm/hooks/useDataPersist/sources/index.js

@@ -1,3 +1,4 @@
 export * from './queryParamSource.js';
 export * from './localStorageSource.js';
 export * from './baseSource.js';
+export * from './sessionStorageSource.js';

package/dist/esm/hooks/useDataPersist/sources/sessionStorageSource.d.ts

@@ -0,0 +1,5 @@
+import { BaseSource } from './baseSource.js';
+export declare class SessionStorageSource<TData> extends BaseSource<TData> {
+    getFromSource(): string;
+    setToSource(value: string): void;
+}

package/dist/esm/hooks/useDataPersist/sources/sessionStorageSource.js

@@ -0,0 +1,15 @@
+import { isBrowser } from '../../../utils/index.js';
+import { BaseSource } from './baseSource.js';
+export class SessionStorageSource extends BaseSource {
+    getFromSource() {
+        if (isBrowser()) {
+            return sessionStorage.getItem(this.filterKey) || '';
+        }
+        return '';
+    }
+    setToSource(value) {
+        if (isBrowser()) {
+            sessionStorage.setItem(this.filterKey, value);
+        }
+    }
+}

package/dist/esm/hooks/useDataPersist/useDataPersist.d.ts

@@ -1,5 +1,7 @@
 import { type StateProps } from './useSource.js';
+export type DataPersistStorage = 'queryParams' | 'localStorage' | 'sessionStorage';
 export type DataPersistOptions<T> = {
+    storages?: DataPersistStorage[];
     queryKey: string;
     localStorageKey: string;
     validateData(value: unknown): value is T;

package/dist/esm/hooks/useDataPersist/useDataPersist.js

@@ -1,9 +1,21 @@
 import { useCallback, useMemo } from 'react';
-import { LocalStorageSource, QueryParamSource } from './sources/index.js';
+import { LocalStorageSource, QueryParamSource, SessionStorageSource } from './sources/index.js';
 import { useSource } from './useSource.js';
+const DEFAULT_STORAGES = ['queryParams', 'localStorage'];
 export const useDataPersist = ({ options, parser, serializer }) => {
-    const querySource = useMemo(() => options ? new QueryParamSource(options.queryKey, options.validateData, parser, serializer) : undefined, [options, parser, serializer]);
-    const localStorageSource = useMemo(() => (options ? new LocalStorageSource(options.localStorageKey, options.validateData) : undefined), [options]);
+    const storages = options?.storages ?? DEFAULT_STORAGES;
+    const querySource = useMemo(() => options && storages.includes('queryParams')
+        ? new QueryParamSource(options.queryKey, options.validateData, parser, serializer)
+        : undefined, [options, parser, serializer, storages]);
+    const localStorageSource = useMemo(() => options && storages.includes('localStorage')
+        ? new LocalStorageSource(options.localStorageKey, options.validateData)
+        : undefined, [options, storages]);
+    const sessionStorageSource = useMemo(() => options && storages.includes('sessionStorage')
+        ? new SessionStorageSource(options.localStorageKey, options.validateData)
+        : undefined, [options, storages]);
+    const { getData: getSessionStorageData, setData: setSessionStorageData } = useSource({
+        source: sessionStorageSource,
+    });
     const { getData: getLocalStorageData, setData: setLocalStorageData } = useSource({
         source: localStorageSource,
     });
@@ -12,11 +24,12 @@ export const useDataPersist = ({ options, parser, serializer }) => {
     });
     const setDataToStorages = useCallback((data) => {
         setLocalStorageData(data);
+        setSessionStorageData(data);
         setQueryParamsData(data);
-    }, [setLocalStorageData, setQueryParamsData]);
+    }, [setLocalStorageData, setSessionStorageData, setQueryParamsData]);
     const getDefaultData = useCallback(() => {
         const queryData = getQueryParamsData();
-        return queryData ?? getLocalStorageData();
-    }, [getLocalStorageData, getQueryParamsData]);
+        return queryData ?? getSessionStorageData() ?? getLocalStorageData();
+    }, [getLocalStorageData, getSessionStorageData, getQueryParamsData]);
     return { getDefaultData, setDataToStorages };
 };

package/dist/esm/hooks/useDataPersist/useSource.js

@@ -4,7 +4,12 @@ export const useSource = ({ source }) => {
         if (!source) {
             return;
         }
-        source.setData(data);
+        try {
+            source.setData(data);
+        }
+        catch {
+            // Ошибка одного хранилища не должна прерывать запись в остальные.
+        }
     }, [source]);
     const getData = useCallback(() => source?.getData() ?? undefined, [source]);
     return { getData, setData };

package/dist/esm/utils/componentPropsProcessors.d.ts

@@ -6,14 +6,14 @@ export type WithSupportProps<T> = {
  * Функция для исключения вспомогательных свойств (data-test-id & aria-*)
  * @function helper
  */
-export declare function excludeSupportProps<T extends Record<string, unknown>>(props: T): {};
+export declare function excludeSupportProps<T extends Record<string, unknown>>(props: T): Omit<T, `data-${string}` | `aria-${string}`>;
 /**
  * Функция для отбора свойства data-test-id
  * @function helper
  */
-export declare function extractDataTestProps<T extends Record<string, unknown>>(props: T): Record<string, unknown>;
+export declare function extractDataTestProps<T extends Record<string, unknown>>(props: T): Pick<T, `data-test-${string}`>;
 /**
  * Функция для отбора вспомогательных свойств (data-test-id & aria-*)
  * @function helper
  */
-export declare function extractSupportProps<T extends Record<string, unknown>>(props: T): Record<string, unknown>;
+export declare function extractSupportProps<T extends Record<string, unknown>>(props: T): Pick<T, Extract<keyof T, `data-${string}` | `aria-${string}`>>;