@escapenavigator/hooks 1.10.107 → 1.10.109

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './players-and-variation-picker';
+export * from './use-debounced-value';
 export * from './use-localstore-state';
 export * from './use-players-and-variation-picker';

package/dist/index.js

@@ -15,5 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./players-and-variation-picker"), exports);
+__exportStar(require("./use-debounced-value"), exports);
 __exportStar(require("./use-localstore-state"), exports);
 __exportStar(require("./use-players-and-variation-picker"), exports);

package/dist/use-debounced-value/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Возвращает значение с задержкой `delayMs`. Полезно для эффектов,
+ * которые не должны срабатывать на каждое нажатие клавиши: например,
+ * `countFetch(values)` в модалках фильтров (UTM-автокомплиты × 5 полей
+ * × побуквенный ввод = десятки HTTP-запросов в секунду).
+ *
+ * Использовать с зависимостями `useEffect`:
+ *
+ * ```ts
+ * const debouncedValues = useDebouncedValue(values, 300);
+ * useEffect(() => {
+ *     countFetch(debouncedValues);
+ * }, [debouncedValues, countFetch]);
+ * ```
+ *
+ * Cancel-семантика — на стороне `useApiMethod` (axios CancelToken):
+ * даже если мы успели стартовать запрос, новый вызов отменит предыдущий.
+ * Debounce здесь экономит TCP-коннекты и работу PG-pool на тех запросах,
+ * которые точно никому не нужны.
+ */
+export declare function useDebouncedValue<T>(value: T, delayMs: number): T;

package/dist/use-debounced-value/index.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDebouncedValue = useDebouncedValue;
+const react_1 = require("react");
+/**
+ * Возвращает значение с задержкой `delayMs`. Полезно для эффектов,
+ * которые не должны срабатывать на каждое нажатие клавиши: например,
+ * `countFetch(values)` в модалках фильтров (UTM-автокомплиты × 5 полей
+ * × побуквенный ввод = десятки HTTP-запросов в секунду).
+ *
+ * Использовать с зависимостями `useEffect`:
+ *
+ * ```ts
+ * const debouncedValues = useDebouncedValue(values, 300);
+ * useEffect(() => {
+ *     countFetch(debouncedValues);
+ * }, [debouncedValues, countFetch]);
+ * ```
+ *
+ * Cancel-семантика — на стороне `useApiMethod` (axios CancelToken):
+ * даже если мы успели стартовать запрос, новый вызов отменит предыдущий.
+ * Debounce здесь экономит TCP-коннекты и работу PG-pool на тех запросах,
+ * которые точно никому не нужны.
+ */
+function useDebouncedValue(value, delayMs) {
+    const [debounced, setDebounced] = (0, react_1.useState)(value);
+    (0, react_1.useEffect)(() => {
+        const id = setTimeout(() => setDebounced(value), delayMs);
+        return () => clearTimeout(id);
+    }, [value, delayMs]);
+    return debounced;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@escapenavigator/hooks",
-  "version": "1.10.107",
+  "version": "1.10.109",
   "publishConfig": {
     "access": "public"
   },
@@ -14,9 +14,9 @@
     "test": "jest"
   },
   "dependencies": {
-    "@escapenavigator/services": "^1.10.115",
-    "@escapenavigator/types": "^1.10.106",
-    "@escapenavigator/utils": "^1.10.110",
+    "@escapenavigator/services": "^1.10.117",
+    "@escapenavigator/types": "^1.10.108",
+    "@escapenavigator/utils": "^1.10.112",
     "react": "19.2.6"
   },
   "peerDependencies": {
@@ -30,5 +30,5 @@
     "ts-jest": "^29.1.1",
     "typescript": "^5.6"
   },
-  "gitHead": "1224f2af8858d8339e46d67041b7cbbce5dc7920"
+  "gitHead": "d95804850eb38fdcf09cf48ef4bfcdf933c53e88"
 }