@snack-uikit/utils 3.10.2-preview-2ce82c96.0 → 4.0.1

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.
 
+## <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)
+
+
+### BREAKING CHANGES
+
+
+* **FF-6982:** rename type, props and returned getter name ([859a025](https://github.com/cloud-ru-tech/snack-uikit/commit/859a025bc670b7882d3286c123d243fc5df0a587))
+
+
+
+
 ## 3.10.1 (2025-07-16)
 
 

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/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/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": "3.10.2-preview-2ce82c96.0",
+  "version": "4.0.1",
   "sideEffects": [
     "*.css",
     "*.woff",
@@ -39,5 +39,5 @@
     "react-swipeable": "7.0.2",
     "uncontrollable": "8.0.4"
   },
-  "gitHead": "4f81feae0178988b62bc2554e85f9422b9c7f02e"
+  "gitHead": "84371bbf91915f650a852df849cd71d416c5b7b2"
 }