@aiszlab/relax 1.2.55 → 1.2.57

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiszlab/relax",
-  "version": "1.2.55",
+  "version": "1.2.57",
   "description": "react utils collection",
   "type": "module",
   "exports": {
@@ -26,14 +26,14 @@
     "rxjs": "^7.8.1"
   },
   "devDependencies": {
-    "@babel/core": "^7.24.0",
-    "@babel/preset-env": "^7.24.0",
-    "@babel/preset-typescript": "^7.24.1",
+    "@babel/core": "^7.24.7",
+    "@babel/preset-env": "^7.24.7",
+    "@babel/preset-typescript": "^7.24.7",
+    "@jest/globals": "^29.7.0",
     "@rollup/plugin-babel": "^6.0.4",
     "@rollup/plugin-node-resolve": "^15.1.0",
     "@rollup/plugin-typescript": "^11.1.6",
-    "@testing-library/react": "^15.0.7",
-    "@types/jest": "^29.5.12",
+    "@testing-library/react": "^16.0.0",
     "@types/react": "^18",
     "@types/react-dom": "^18",
     "@types/react-is": "^18",
@@ -41,8 +41,8 @@
     "jest-environment-jsdom": "^29.7.0",
     "react": "18",
     "react-dom": "18",
-    "rollup": "^4.17.2",
-    "typescript": "5.3.3"
+    "rollup": "^4.18.1",
+    "typescript": "5.5.3"
   },
   "peerDependencies": {
     "react": "18",

package/dist/__test__/hooks/use-boolean.test.d.ts

@@ -1,4 +0,0 @@
-/**
- * @jest-environment jsdom
- */
-export {};

package/dist/__test__/hooks/use-identity.test.d.ts

@@ -1,4 +0,0 @@
-/**
- * @jest-environment jsdom
- */
-export {};

package/dist/__test__/hooks/use-mount.test.d.ts

@@ -1,4 +0,0 @@
-/**
- * @jest-environment jsdom
- */
-export {};

package/dist/__test__/hooks/use-mounted.test.d.ts

@@ -1,4 +0,0 @@
-/**
- * @jest-environment jsdom
- */
-export {};

package/dist/__test__/hooks/use-timeout.test.d.ts

@@ -1,4 +0,0 @@
-/**
- * @jest-environment jsdom
- */
-export {};

package/dist/__test__/is/is-null.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__test__/is/is-thenable.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__test__/utils/chain.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__test__/utils/clamp.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__test__/utils/clone.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__test__/utils/debounce.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__test__/utils/effect.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__test__/utils/exclude.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__test__/utils/throttle.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__test__/utils/to-array.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__test__/utils/to-form-data.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/_virtual/_rollupPluginBabelHelpers.js

@@ -1,138 +0,0 @@
-function _arrayLikeToArray(r, a) {
-  (null == a || a > r.length) && (a = r.length);
-  for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
-  return n;
-}
-function _arrayWithHoles(r) {
-  if (Array.isArray(r)) return r;
-}
-function _arrayWithoutHoles(r) {
-  if (Array.isArray(r)) return _arrayLikeToArray(r);
-}
-function _assertClassBrand(e, t, n) {
-  if ("function" == typeof e ? e === t : e.has(t)) return arguments.length < 3 ? t : n;
-  throw new TypeError("Private element is not present on this object");
-}
-function _checkPrivateRedeclaration(e, t) {
-  if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object");
-}
-function _classCallCheck(a, n) {
-  if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function");
-}
-function _classPrivateFieldGet2(s, a) {
-  return s.get(_assertClassBrand(s, a));
-}
-function _classPrivateFieldInitSpec(e, t, a) {
-  _checkPrivateRedeclaration(e, t), t.set(e, a);
-}
-function _classPrivateFieldSet2(s, a, r) {
-  return s.set(_assertClassBrand(s, a), r), r;
-}
-function _classPrivateMethodInitSpec(e, a) {
-  _checkPrivateRedeclaration(e, a), a.add(e);
-}
-function _defineProperties(e, r) {
-  for (var t = 0; t < r.length; t++) {
-    var o = r[t];
-    o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o);
-  }
-}
-function _createClass(e, r, t) {
-  return r && _defineProperties(e.prototype, r), Object.defineProperty(e, "prototype", {
-    writable: !1
-  }), e;
-}
-function _iterableToArray(r) {
-  if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r);
-}
-function _iterableToArrayLimit(r, l) {
-  var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"];
-  if (null != t) {
-    var e,
-      n,
-      i,
-      u,
-      a = [],
-      f = !0,
-      o = !1;
-    try {
-      if (i = (t = t.call(r)).next, 0 === l) {
-        if (Object(t) !== t) return;
-        f = !1;
-      } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0);
-    } catch (r) {
-      o = !0, n = r;
-    } finally {
-      try {
-        if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return;
-      } finally {
-        if (o) throw n;
-      }
-    }
-    return a;
-  }
-}
-function _nonIterableRest() {
-  throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
-}
-function _nonIterableSpread() {
-  throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
-}
-function _objectWithoutProperties(e, t) {
-  if (null == e) return {};
-  var o,
-    r,
-    i = _objectWithoutPropertiesLoose(e, t);
-  if (Object.getOwnPropertySymbols) {
-    var n = Object.getOwnPropertySymbols(e);
-    for (r = 0; r < n.length; r++) o = n[r], t.indexOf(o) >= 0 || {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]);
-  }
-  return i;
-}
-function _objectWithoutPropertiesLoose(r, e) {
-  if (null == r) return {};
-  var t = {};
-  for (var n in r) if ({}.hasOwnProperty.call(r, n)) {
-    if (e.indexOf(n) >= 0) continue;
-    t[n] = r[n];
-  }
-  return t;
-}
-function _slicedToArray(r, e) {
-  return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest();
-}
-function _toConsumableArray(r) {
-  return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread();
-}
-function _toPrimitive(t, r) {
-  if ("object" != typeof t || !t) return t;
-  var e = t[Symbol.toPrimitive];
-  if (void 0 !== e) {
-    var i = e.call(t, r );
-    if ("object" != typeof i) return i;
-    throw new TypeError("@@toPrimitive must return a primitive value.");
-  }
-  return (String )(t);
-}
-function _toPropertyKey(t) {
-  var i = _toPrimitive(t, "string");
-  return "symbol" == typeof i ? i : i + "";
-}
-function _typeof(o) {
-  "@babel/helpers - typeof";
-
-  return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) {
-    return typeof o;
-  } : function (o) {
-    return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
-  }, _typeof(o);
-}
-function _unsupportedIterableToArray(r, a) {
-  if (r) {
-    if ("string" == typeof r) return _arrayLikeToArray(r, a);
-    var t = {}.toString.call(r).slice(8, -1);
-    return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0;
-  }
-}
-
-export { _arrayLikeToArray as arrayLikeToArray, _arrayWithHoles as arrayWithHoles, _arrayWithoutHoles as arrayWithoutHoles, _assertClassBrand as assertClassBrand, _checkPrivateRedeclaration as checkPrivateRedeclaration, _classCallCheck as classCallCheck, _classPrivateFieldGet2 as classPrivateFieldGet2, _classPrivateFieldInitSpec as classPrivateFieldInitSpec, _classPrivateFieldSet2 as classPrivateFieldSet2, _classPrivateMethodInitSpec as classPrivateMethodInitSpec, _createClass as createClass, _iterableToArray as iterableToArray, _iterableToArrayLimit as iterableToArrayLimit, _nonIterableRest as nonIterableRest, _nonIterableSpread as nonIterableSpread, _objectWithoutProperties as objectWithoutProperties, _objectWithoutPropertiesLoose as objectWithoutPropertiesLoose, _slicedToArray as slicedToArray, _toConsumableArray as toConsumableArray, _toPrimitive as toPrimitive, _toPropertyKey as toPropertyKey, _typeof as typeof, _unsupportedIterableToArray as unsupportedIterableToArray };

package/dist/dom/contains.d.ts

@@ -1 +0,0 @@
-export declare const contains: (root: Node | null | undefined, n?: Node | null) => boolean;

package/dist/dom/contains.js

@@ -1,20 +0,0 @@
-var contains = function contains(root, n) {
-  if (!root) {
-    return false;
-  }
-  // Use native if support
-  if (root.contains) {
-    return root.contains(n !== null && n !== void 0 ? n : null);
-  }
-  // `document.contains` not support with IE11
-  var node = n;
-  while (node) {
-    if (node === root) {
-      return true;
-    }
-    node = node.parentNode;
-  }
-  return false;
-};
-
-export { contains };

package/dist/dom/index.d.ts

@@ -1,3 +0,0 @@
-import { scrollTo } from './scroll-to';
-import { contains } from './contains';
-export { scrollTo, contains };

package/dist/dom/index.js

@@ -1,2 +0,0 @@
-export { scrollTo } from './scroll-to.js';
-export { contains } from './contains.js';

package/dist/dom/scroll-to.d.ts

@@ -1,19 +0,0 @@
-export type Direction = 'horizontal' | 'vertical';
-interface ScrollBy {
-    /**
-     * @description
-     * duration
-     */
-    duration: number;
-    /**
-     * @description
-     * direction
-     */
-    direction?: Direction;
-}
-/**
- * @description
- * scroll to for wrapper element
- */
-export declare const scrollTo: (target: HTMLElement, to: number, { duration, direction }?: ScrollBy) => void;
-export {};

package/dist/dom/scroll-to.js

@@ -1,69 +0,0 @@
-import { createClass as _createClass, classPrivateFieldGet2 as _classPrivateFieldGet2, classCallCheck as _classCallCheck, classPrivateFieldInitSpec as _classPrivateFieldInitSpec } from '../_virtual/_rollupPluginBabelHelpers.js';
-
-var _scrolled = /*#__PURE__*/new WeakMap();
-var Scroller = /*#__PURE__*/function () {
-  function Scroller() {
-    var _scroller$_;
-    _classCallCheck(this, Scroller);
-    _classPrivateFieldInitSpec(this, _scrolled, new Map());
-    return (_scroller$_ = _scroller._) !== null && _scroller$_ !== void 0 ? _scroller$_ : _scroller._ = this;
-  }
-  return _createClass(Scroller, [{
-    key: "scrolled",
-    get: function get() {
-      return _classPrivateFieldGet2(_scrolled, this);
-    }
-  }, {
-    key: "currentAt",
-    value: function currentAt(direction) {
-      return direction === 'vertical' ? 'scrollTop' : 'scrollLeft';
-    }
-  }]);
-}();
-/**
- * @description
- * scroll to for wrapper element
- */
-// singleton mode
-var _scroller = {
-  _: null
-};
-var scrollTo = function scrollTo(target, to) {
-  var _ref = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {
-      duration: 0,
-      direction: 'vertical'
-    },
-    _ref$duration = _ref.duration,
-    duration = _ref$duration === void 0 ? 0 : _ref$duration,
-    _ref$direction = _ref.direction,
-    direction = _ref$direction === void 0 ? 'vertical' : _ref$direction;
-  var scroller = new Scroller();
-  var scrolled = scroller.scrolled.get(target);
-  var currentAtProperty = scroller.currentAt(direction);
-  if (scrolled) {
-    cancelAnimationFrame(scrolled);
-    scroller.scrolled["delete"](target);
-  }
-  // if duration <= 0, jump immediately
-  if (duration <= 0) {
-    scroller.scrolled.set(target, requestAnimationFrame(function () {
-      target[currentAtProperty] = to;
-    }));
-    return;
-  }
-  // animate
-  var currentAt = target[currentAtProperty];
-  var difference = to - currentAt;
-  var step = difference / duration * 10;
-  scroller.scrolled.set(target, requestAnimationFrame(function () {
-    target[currentAtProperty] = currentAt + step;
-    // over end, stop any animation
-    if (target[currentAtProperty] === to) return;
-    scrollTo(target, to, {
-      duration: duration - 10,
-      direction: direction
-    });
-  }));
-};
-
-export { scrollTo };

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

@@ -1,19 +0,0 @@
-import { type Dispatch, type SetStateAction } from 'react';
-import type { State } from '../types';
-type UsedBoolean = [
-    boolean,
-    {
-        turnOn: () => void;
-        turnOff: () => void;
-        toggle: () => void;
-        setBoolean: Dispatch<SetStateAction<boolean>>;
-    }
-];
-/**
- * @author murukal
- *
- * @description
- * boolean state, in relax, we already create some api to easy use
- */
-export declare const useBoolean: (initialState?: State<boolean>) => UsedBoolean;
-export {};

package/dist/hooks/use-boolean.js

@@ -1,34 +0,0 @@
-import { slicedToArray as _slicedToArray } from '../_virtual/_rollupPluginBabelHelpers.js';
-import { useState, useCallback } from 'react';
-
-/**
- * @author murukal
- *
- * @description
- * boolean state, in relax, we already create some api to easy use
- */
-var useBoolean = function useBoolean(initialState) {
-  var _useState = useState(initialState !== null && initialState !== void 0 ? initialState : false),
-    _useState2 = _slicedToArray(_useState, 2),
-    isOn = _useState2[0],
-    setIsOn = _useState2[1];
-  var turnOn = useCallback(function () {
-    return setIsOn(true);
-  }, []);
-  var turnOff = useCallback(function () {
-    return setIsOn(false);
-  }, []);
-  var toggle = useCallback(function () {
-    return setIsOn(function (_isOn) {
-      return !_isOn;
-    });
-  }, []);
-  return [isOn, {
-    turnOn: turnOn,
-    turnOff: turnOff,
-    toggle: toggle,
-    setBoolean: setIsOn
-  }];
-};
-
-export { useBoolean };

package/dist/hooks/use-controlled-state.d.ts

@@ -1,17 +0,0 @@
-import { type Dispatch, type SetStateAction } from 'react';
-import type { State } from '../types';
-interface Props<T> {
-    /**
-     * @description
-     * default value
-     */
-    defaultState?: State<T>;
-}
-/**
- * @author murukal
- *
- * @description
- * controlled state
- */
-export declare const useControlledState: <T>(controlledState: T, { defaultState }?: Props<T>) => [T, Dispatch<SetStateAction<T>>];
-export {};

package/dist/hooks/use-controlled-state.js

@@ -1,40 +0,0 @@
-import { slicedToArray as _slicedToArray } from '../_virtual/_rollupPluginBabelHelpers.js';
-import { useState } from 'react';
-import { isStateGetter } from '../is/is-state-getter.js';
-import { isUndefined } from '../is/is-undefined.js';
-import { useUpdateEffect } from './use-update-effect.js';
-
-/**
- * @author murukal
- *
- * @description
- * controlled state
- */
-var useControlledState = function useControlledState(controlledState) {
-  var _ref = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
-    defaultState = _ref.defaultState;
-  /// initialize state
-  var _useState = useState(function () {
-      // default use controlled state
-      if (!isUndefined(controlledState)) {
-        return controlledState;
-      }
-      // not controlled use default prop
-      if (isUndefined(defaultState)) return controlledState;
-      if (isStateGetter(defaultState)) return defaultState();
-      return defaultState;
-    }),
-    _useState2 = _slicedToArray(_useState, 2),
-    _state = _useState2[0],
-    _setState = _useState2[1];
-  /// sync value back to `undefined` when it from control to un-control
-  useUpdateEffect(function () {
-    if (!isUndefined(controlledState)) return;
-    _setState(controlledState !== null && controlledState !== void 0 ? controlledState : defaultState);
-  }, [controlledState]);
-  /// use controlled
-  var state = !isUndefined(controlledState) ? controlledState : _state;
-  return [state, _setState];
-};
-
-export { useControlledState };

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

@@ -1,33 +0,0 @@
-import { type Dispatch, type SetStateAction } from 'react';
-import type { State } from '../types';
-type Props = {
-    /**
-     * @description
-     * max: count will not be greater than max
-     */
-    max?: number;
-    /**
-     * @description
-     * min: count will not be smaller than min
-     */
-    min?: number;
-};
-type UsedCounter = [
-    number,
-    {
-        add: (step?: number) => void;
-        subtract: (step?: number) => void;
-        first: () => void;
-        last: () => void;
-        reset: () => void;
-        setCount: Dispatch<SetStateAction<number>>;
-    }
-];
-/**
- * @author murukal
- *
- * @description
- * a number counter with some useful apis
- */
-export declare const useCounter: (initialState?: State<number>, { max, min }?: Props) => UsedCounter;
-export {};

package/dist/hooks/use-counter.js

@@ -1,59 +0,0 @@
-import { slicedToArray as _slicedToArray } from '../_virtual/_rollupPluginBabelHelpers.js';
-import { useState, useCallback, useMemo } from 'react';
-import { clamp } from '../utils/clamp.js';
-import { useDefault } from './use-default.js';
-
-/**
- * @author murukal
- *
- * @description
- * a number counter with some useful apis
- */
-var useCounter = function useCounter() {
-  var initialState = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
-  var _ref = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
-    _ref$max = _ref.max,
-    max = _ref$max === void 0 ? Infinity : _ref$max,
-    _ref$min = _ref.min,
-    min = _ref$min === void 0 ? -Infinity : _ref$min;
-  // memorized first time prop value
-  var defaultState = useDefault(initialState);
-  var _useState = useState(defaultState),
-    _useState2 = _slicedToArray(_useState, 2),
-    _count = _useState2[0],
-    _setCount = _useState2[1];
-  var add = useCallback(function () {
-    var step = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 1;
-    _setCount(function (prev) {
-      return Math.min(max, prev + step);
-    });
-  }, [max]);
-  var subtract = useCallback(function () {
-    var step = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 1;
-    _setCount(function (prev) {
-      return Math.max(min, prev - step);
-    });
-  }, [min]);
-  var first = useCallback(function () {
-    _setCount(min);
-  }, [min]);
-  var last = useCallback(function () {
-    _setCount(max);
-  }, [max]);
-  var reset = useCallback(function () {
-    _setCount(defaultState);
-  }, []);
-  var count = useMemo(function () {
-    return clamp(_count, min, max);
-  }, [_count, min, max]);
-  return [count, {
-    add: add,
-    subtract: subtract,
-    first: first,
-    last: last,
-    reset: reset,
-    setCount: _setCount
-  }];
-};
-
-export { useCounter };

package/dist/hooks/use-debounce-callback.d.ts

@@ -1,18 +0,0 @@
-import { type Debounced, type Debouncer } from '../utils/debounce';
-import { type Callable } from './use-event';
-/**
- * @author murukal
- *
- * @description
- * debounce callback
- *
- * @param callback
- * @param wait number
- * @description
- * The delay time (in milliseconds) until the debounce function is called.
- * default 1000
- *
- * @example
- * 1000
- */
-export declare const useDebounceCallback: <T extends Callable, R extends unknown[] = Parameters<T>>(debouncer: T | Debouncer<T, R>, wait?: number) => Debounced<T>;