@aiszlab/relax 2.1.3-beta.3 → 2.1.3-beta.4

package/dist/hooks/use-debounce-callback.cjs

@@ -5,7 +5,6 @@ var react = require('react');
 var debounce = require('../utils/debounce.cjs');
 var useEvent = require('./use-event.cjs');
 var isFunction = require('../is/is-function.cjs');
-var useDefault = require('./use-default.cjs');
 
 var useDebouncer = function useDebouncer(debouncer) {
   var _debouncer = react.useMemo(function () {
@@ -34,41 +33,22 @@ var useDebouncer = function useDebouncer(debouncer) {
 };
 function useDebounceCallback(debouncer) {
   var wait = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 1000;
-  var debounced = react.useRef(null);
   var _useDebouncer = useDebouncer(debouncer),
     callback = _useDebouncer.callback,
     pipe = _useDebouncer.pipe;
-  react.useEffect(function () {
-    var _debounced = debounce.debounce({
+  var _debounced = react.useMemo(function () {
+    return debounce.debounce({
       callback: callback,
       pipe: pipe
     }, wait);
-    debounced.current = _debounced;
+  }, [wait]);
+  react.useEffect(function () {
     // dispose
     return function () {
       _debounced.abort();
-      debounced.current = null;
     };
-  }, [wait]);
-  return useDefault.useDefault(function () {
-    return {
-      next: function next() {
-        var _debounced$current;
-        for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
-          args[_key2] = arguments[_key2];
-        }
-        return (_debounced$current = debounced.current) === null || _debounced$current === void 0 ? void 0 : _debounced$current.next.apply(_debounced$current, args);
-      },
-      flush: function flush() {
-        var _debounced$current2;
-        return (_debounced$current2 = debounced.current) === null || _debounced$current2 === void 0 ? void 0 : _debounced$current2.flush();
-      },
-      abort: function abort() {
-        var _debounced$current3;
-        return (_debounced$current3 = debounced.current) === null || _debounced$current3 === void 0 ? void 0 : _debounced$current3.abort();
-      }
-    };
-  });
+  }, [_debounced]);
+  return _debounced;
 }
 
 exports.useDebounceCallback = useDebounceCallback;

package/dist/hooks/use-debounce-callback.mjs

@@ -1,9 +1,8 @@
 import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
-import { useRef, useEffect, useMemo } from 'react';
+import { useMemo, useEffect } from 'react';
 import { debounce } from '../utils/debounce.mjs';
 import { useEvent } from './use-event.mjs';
 import { isFunction } from '../is/is-function.mjs';
-import { useDefault } from './use-default.mjs';
 
 var useDebouncer = function useDebouncer(debouncer) {
   var _debouncer = useMemo(function () {
@@ -32,41 +31,22 @@ var useDebouncer = function useDebouncer(debouncer) {
 };
 function useDebounceCallback(debouncer) {
   var wait = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 1000;
-  var debounced = useRef(null);
   var _useDebouncer = useDebouncer(debouncer),
     callback = _useDebouncer.callback,
     pipe = _useDebouncer.pipe;
-  useEffect(function () {
-    var _debounced = debounce({
+  var _debounced = useMemo(function () {
+    return debounce({
       callback: callback,
       pipe: pipe
     }, wait);
-    debounced.current = _debounced;
+  }, [wait]);
+  useEffect(function () {
     // dispose
     return function () {
       _debounced.abort();
-      debounced.current = null;
     };
-  }, [wait]);
-  return useDefault(function () {
-    return {
-      next: function next() {
-        var _debounced$current;
-        for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
-          args[_key2] = arguments[_key2];
-        }
-        return (_debounced$current = debounced.current) === null || _debounced$current === void 0 ? void 0 : _debounced$current.next.apply(_debounced$current, args);
-      },
-      flush: function flush() {
-        var _debounced$current2;
-        return (_debounced$current2 = debounced.current) === null || _debounced$current2 === void 0 ? void 0 : _debounced$current2.flush();
-      },
-      abort: function abort() {
-        var _debounced$current3;
-        return (_debounced$current3 = debounced.current) === null || _debounced$current3 === void 0 ? void 0 : _debounced$current3.abort();
-      }
-    };
-  });
+  }, [_debounced]);
+  return _debounced;
 }
 
 export { useDebounceCallback };

package/dist/hooks/use-request.cjs

@@ -6,13 +6,15 @@ var _slicedToArray = require('@babel/runtime/helpers/slicedToArray');
 var react = require('react');
 var useEvent = require('./use-event.cjs');
 var useMounted = require('./use-mounted.cjs');
+var useDebounceCallback = require('./use-debounce-callback.cjs');
 
 /**
  * @author murukal
  *
- * @description
  * wraps an async request function, tracking loading / error / data state.
  * when `auto` is true the request fires automatically on mount.
+ *
+ * supports debounce via `debounceWait` option which accepts dynamic updates.
  */
 var useRequest = function useRequest(request) {
   var _ref = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
@@ -20,7 +22,8 @@ var useRequest = function useRequest(request) {
     auto = _ref$auto === void 0 ? false : _ref$auto,
     thenCallback = _ref.then,
     catchCallback = _ref["catch"],
-    finallyCallback = _ref["finally"];
+    finallyCallback = _ref["finally"],
+    debounceWait = _ref.debounceWait;
   var _useState = react.useState(null),
     _useState2 = _slicedToArray(_useState, 2),
     data = _useState2[0],
@@ -47,7 +50,8 @@ var useRequest = function useRequest(request) {
   var _finally = useEvent.useEvent(function () {
     finallyCallback === null || finallyCallback === void 0 || finallyCallback();
   });
-  var run = react.useCallback(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
+  // ---- core execution (always stable) ----
+  var _execute = useEvent.useEvent(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
     var result,
       _args = arguments;
     return _regenerator().w(function (_context) {
@@ -65,12 +69,21 @@ var useRequest = function useRequest(request) {
           return _context.a(2);
       }
     }, _callee);
-  })), []);
+  })));
+  var debounced = useDebounceCallback.useDebounceCallback(_execute, debounceWait);
+  var run = useEvent.useEvent(function () {
+    if (!debounceWait) {
+      return _execute.apply(void 0, arguments);
+    }
+    return Promise.resolve(debounced.next.apply(debounced, arguments));
+  });
   useMounted.useMounted(function () {
     if (isMountedRef.current) return;
     if (!auto) return;
     isMountedRef.current = true;
-    run();
+    // auto-run always fires immediately — debounce only applies to
+    // manual run() calls
+    _execute();
   });
   return {
     data: data,

package/dist/hooks/use-request.d.ts

@@ -1,53 +1,57 @@
 type UsingRequest<T> = {
     /**
-     * @description
      * auto request when component mounts
      */
     auto?: boolean;
     /**
-     * @description
      * called when the request succeeds, like Promise.then
      */
     then?: (data: T) => void;
     /**
-     * @description
      * called when the request fails, like Promise.catch
      */
     catch?: (error: Error) => void;
     /**
-     * @description
      * called when the request completes (success or failure), like Promise.finally
      */
     finally?: () => void;
+    /**
+     * debounce delay in milliseconds. setting this enables debounce mode —
+     * rapid calls to `run` will be coalesced and only the last call within
+     * the window will execute.
+     *
+     * @zh 防抖延迟时间（毫秒）。设置后启用防抖模式——对 `run` 的快速调用
+     * 会被合并，在时间窗口内仅执行最后一次调用。
+     */
+    debounceWait?: number;
 };
 type UsedRequest<T> = {
     /**
-     * @description
      * response data
      */
     data: T | null;
     /**
-     * @description
      * error caught from the request
      */
     error: Error | null;
     /**
-     * @description
      * whether the request is in progress
      */
     loading: boolean;
     /**
-     * @description
-     * manually trigger the request with the same arguments as the source function
+     * manually trigger the request with the same arguments as the source function.
+     * when `debounceWait` is set calls are debounced — the returned Promise
+     * resolves only when the call is actually executed.
      */
     run: (...args: any[]) => Promise<void>;
 };
 /**
  * @author murukal
  *
- * @description
  * wraps an async request function, tracking loading / error / data state.
  * when `auto` is true the request fires automatically on mount.
+ *
+ * supports debounce via `debounceWait` option which accepts dynamic updates.
  */
-export declare const useRequest: <T>(request: (...args: any[]) => Promise<T>, { auto, then: thenCallback, catch: catchCallback, finally: finallyCallback, }?: UsingRequest<T>) => UsedRequest<T>;
+export declare const useRequest: <T>(request: (...args: any[]) => Promise<T>, { auto, then: thenCallback, catch: catchCallback, finally: finallyCallback, debounceWait, }?: UsingRequest<T>) => UsedRequest<T>;
 export {};

package/dist/hooks/use-request.mjs

@@ -1,16 +1,18 @@
 import _regenerator from '@babel/runtime/helpers/regenerator';
 import _asyncToGenerator from '@babel/runtime/helpers/asyncToGenerator';
 import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
-import { useState, useRef, useCallback } from 'react';
+import { useState, useRef } from 'react';
 import { useEvent } from './use-event.mjs';
 import { useMounted } from './use-mounted.mjs';
+import { useDebounceCallback } from './use-debounce-callback.mjs';
 
 /**
  * @author murukal
  *
- * @description
  * wraps an async request function, tracking loading / error / data state.
  * when `auto` is true the request fires automatically on mount.
+ *
+ * supports debounce via `debounceWait` option which accepts dynamic updates.
  */
 var useRequest = function useRequest(request) {
   var _ref = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
@@ -18,7 +20,8 @@ var useRequest = function useRequest(request) {
     auto = _ref$auto === void 0 ? false : _ref$auto,
     thenCallback = _ref.then,
     catchCallback = _ref["catch"],
-    finallyCallback = _ref["finally"];
+    finallyCallback = _ref["finally"],
+    debounceWait = _ref.debounceWait;
   var _useState = useState(null),
     _useState2 = _slicedToArray(_useState, 2),
     data = _useState2[0],
@@ -45,7 +48,8 @@ var useRequest = function useRequest(request) {
   var _finally = useEvent(function () {
     finallyCallback === null || finallyCallback === void 0 || finallyCallback();
   });
-  var run = useCallback(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
+  // ---- core execution (always stable) ----
+  var _execute = useEvent(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
     var result,
       _args = arguments;
     return _regenerator().w(function (_context) {
@@ -63,12 +67,21 @@ var useRequest = function useRequest(request) {
           return _context.a(2);
       }
     }, _callee);
-  })), []);
+  })));
+  var debounced = useDebounceCallback(_execute, debounceWait);
+  var run = useEvent(function () {
+    if (!debounceWait) {
+      return _execute.apply(void 0, arguments);
+    }
+    return Promise.resolve(debounced.next.apply(debounced, arguments));
+  });
   useMounted(function () {
     if (isMountedRef.current) return;
     if (!auto) return;
     isMountedRef.current = true;
-    run();
+    // auto-run always fires immediately — debounce only applies to
+    // manual run() calls
+    _execute();
   });
   return {
     data: data,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiszlab/relax",
-  "version": "2.1.3-beta.3",
+  "version": "2.1.3-beta.4",
   "description": "react utils collection",
   "exports": {
     ".": {