@snack-uikit/utils 4.0.0 → 4.0.2

package/CHANGELOG.md

@@ -3,6 +3,26 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 4.0.2 (2026-05-18)
+
+
+### Bug Fixes
+
+* **PDS-3818:** swap places for useDataPersist so that URL > localStorage ([4018a25](https://github.com/cloud-ru-tech/snack-uikit/commit/4018a2536565b8fb85da1f26b22234806812ef56))
+
+
+
+
+
+## <small>4.0.1 (2026-01-19)</small>
+
+* chore(FF-6693): tune test configs ([d194f4d](https://github.com/cloud-ru-tech/snack-uikit/commit/d194f4d))
+* docs(FF-7788): readme update ([e3142b8](https://github.com/cloud-ru-tech/snack-uikit/commit/e3142b8))
+
+
+
+
+
 # 4.0.0 (2025-09-01)
 
 

package/README.md

@@ -1,15 +1,51 @@
 # Utils
 
-## TODO
-
-- Increase coverage
-
 ## Installation
 
 `npm i @snack-uikit/utils`
 
 [Changelog](./CHANGELOG.md)
 
+## Description
+
+- Пакет `@snack-uikit/utils` предоставляет набор утилит для разработки React-компонентов: React-хуки для работы с состоянием, событиями, темами и другими задачами, а также вспомогательные функции для обработки пропов компонентов и определения окружения выполнения.
+- Хуки поддерживают различные сценарии использования: управление темами (`useThemeConfig`, `ThemeProvider`), работа с контролируемым и неконтролируемым состоянием (`useValueControl`), обработка событий с дебаунсом (`useDebounce`), управление динамическими списками (`useDynamicList`), обработка свайпов (`useSwipeable`), управление состоянием модальных окон (`useModalOpenState`), сохранение данных (`useDataPersist`), а также SSR-совместимые хуки (`useIsomorphicLayoutEffect`, `isBrowser`).
+- Вспомогательные функции помогают работать с пропами компонентов: исключать или извлекать вспомогательные свойства (`excludeSupportProps`, `extractSupportProps`, `extractDataTestProps`) для корректной передачи пропов в DOM-элементы.
+- Хуки оптимизированы для работы в SSR-окружении и поддерживают современные браузерные API (например, `CloseWatcher` для модальных окон).
+
+## Example
+
+```tsx
+import { useThemeConfig } from '@snack-uikit/utils';
+
+enum Theme {
+  Light = 'Light',
+  Dark = 'Dark',
+}
+
+const themeMap = {
+  [Theme.Light]: 'light-theme-class',
+  [Theme.Dark]: 'dark-theme-class',
+};
+
+function Example() {
+  const theme = useThemeConfig({ 
+    themeMap, 
+    defaultTheme: Theme.Light 
+  });
+
+  return (
+    <div className={theme.themeClassName}>
+      <button onClick={() => theme.changeTheme(Theme.Dark)}>
+        Переключить на тёмную тему
+      </button>
+      <button onClick={() => theme.changeTheme(Theme.Light)}>
+        Переключить на светлую тему
+      </button>
+    </div>
+  );
+}
+```
 
 [//]: DOCUMENTATION_SECTION_START
 [//]: THIS_SECTION_IS_AUTOGENERATED_PLEASE_DONT_EDIT_IT

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

@@ -19,13 +19,13 @@ const useDataPersist = _ref => {
     getData: getLocalStorageData,
     setData: setLocalStorageData
   } = (0, useSource_1.useSource)({
-    source: querySource
+    source: localStorageSource
   });
   const {
     getData: getQueryParamsData,
     setData: setQueryParamsData
   } = (0, useSource_1.useSource)({
-    source: localStorageSource
+    source: querySource
   });
   const setDataToStorages = (0, react_1.useCallback)(data => {
     setLocalStorageData(data);

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

@@ -16,5 +16,5 @@ type UseValueControl<TValue> = {
  * Хук для работы с состоянием.
  * Нужен для поддержки controlled/uncontrolled поведения, в зависимости от того были ли переданы входные аргументы
  */
-export declare function useValueControl<TValue>({ value, onChange, defaultValue }: UseValueControl<TValue>): readonly [TValue | undefined, (value: any, ...args: any[]) => ReturnType<import("uncontrollable").Handler> | void];
+export declare function useValueControl<TValue>({ value, onChange, defaultValue }: UseValueControl<TValue>): readonly [TValue | undefined, (value: any, ...args: any[]) => any];
 export {};

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

@@ -5,10 +5,10 @@ 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 { getData: getLocalStorageData, setData: setLocalStorageData } = useSource({
-        source: querySource,
+        source: localStorageSource,
     });
     const { getData: getQueryParamsData, setData: setQueryParamsData } = useSource({
-        source: localStorageSource,
+        source: querySource,
     });
     const setDataToStorages = useCallback((data) => {
         setLocalStorageData(data);

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

@@ -16,5 +16,5 @@ type UseValueControl<TValue> = {
  * Хук для работы с состоянием.
  * Нужен для поддержки controlled/uncontrolled поведения, в зависимости от того были ли переданы входные аргументы
  */
-export declare function useValueControl<TValue>({ value, onChange, defaultValue }: UseValueControl<TValue>): readonly [TValue | undefined, (value: any, ...args: any[]) => ReturnType<import("uncontrollable").Handler> | void];
+export declare function useValueControl<TValue>({ value, onChange, defaultValue }: UseValueControl<TValue>): readonly [TValue | undefined, (value: any, ...args: any[]) => any];
 export {};

package/package.json

@@ -4,7 +4,7 @@
     "access": "public"
   },
   "title": "Utils",
-  "version": "4.0.0",
+  "version": "4.0.2",
   "sideEffects": [
     "*.css",
     "*.woff",
@@ -39,5 +39,5 @@
     "react-swipeable": "7.0.2",
     "uncontrollable": "8.0.4"
   },
-  "gitHead": "881a16cd10831b0effaacb06c506521c8705d9ca"
+  "gitHead": "a9f6571146845d828e00206abdedb160980cff97"
 }

package/src/hooks/useDataPersist/useDataPersist.ts

@@ -27,11 +27,11 @@ export const useDataPersist = <TData>({ options, parser, serializer }: DataPersi
   );
 
   const { getData: getLocalStorageData, setData: setLocalStorageData } = useSource<TData>({
-    source: querySource,
+    source: localStorageSource,
   });
 
   const { getData: getQueryParamsData, setData: setQueryParamsData } = useSource<TData>({
-    source: localStorageSource,
+    source: querySource,
   });
 
   const setDataToStorages = useCallback(