@aiszlab/relax 1.2.19 → 1.2.20

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

@@ -1,14 +1,34 @@
 /// <reference types="react" />
+interface Props {
+    /**
+     * @description
+     * initial value
+     */
+    initialValue?: number;
+    /**
+     * @description
+     * max
+     */
+    max?: number;
+    /**
+     * @description
+     * min
+     */
+    min?: number;
+}
 /**
  * @author murukal
  *
  * @description
  * a number counter with some useful apis
  */
-export declare const useCounter: () => {
+export declare const useCounter: ({ max, min, ...props }?: Props) => {
     count: number;
-    next: () => void;
-    prev: () => void;
+    next: (step?: number) => void;
+    prev: (step?: number) => void;
     first: () => void;
+    last: () => void;
+    reset: () => void;
     setCount: import("react").Dispatch<import("react").SetStateAction<number>>;
 };
+export {};

package/dist/hooks/use-counter.mjs

@@ -1,4 +1,6 @@
-import { useState, useCallback } from 'react';
+import { __rest } from '../node_modules/tslib/tslib.es6.mjs';
+import { useMemo, useState, useCallback } from 'react';
+import { clamp } from '../utils/clamp.mjs';
 
 /**
  * @author murukal
@@ -6,22 +8,32 @@ import { useState, useCallback } from 'react';
  * @description
  * a number counter with some useful apis
  */
-const useCounter = () => {
-    const [count, setCount] = useState(0);
-    const next = useCallback(() => {
-        setCount((prev) => prev + 1);
-    }, []);
-    const prev = useCallback(() => {
-        setCount((prev) => prev - 1);
-    }, []);
+const useCounter = (_a = { initialValue: 0, max: Infinity, min: 0 }) => {
+    var { max = Infinity, min = 0 } = _a, props = __rest(_a, ["max", "min"]);
+    const initialValue = useMemo(() => { var _a; return clamp((_a = props.initialValue) !== null && _a !== void 0 ? _a : 0, min, max); }, [max, min, props.initialValue]);
+    const [count, setCount] = useState(initialValue);
+    const next = useCallback((step = 1) => {
+        setCount((prev) => Math.min(max, prev + step));
+    }, [max]);
+    const prev = useCallback((step = 1) => {
+        setCount((prev) => Math.max(prev - step));
+    }, [min]);
     const first = useCallback(() => {
-        setCount(0);
-    }, []);
+        setCount(min);
+    }, [min]);
+    const last = useCallback(() => {
+        setCount(max);
+    }, [max]);
+    const reset = useCallback(() => {
+        setCount(initialValue);
+    }, [initialValue]);
     return {
         count,
         next,
         prev,
         first,
+        last,
+        reset,
         setCount
     };
 };

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

@@ -1,4 +1,5 @@
 import { type MutableRefObject, type RefCallback } from 'react';
+import type { Nullable } from '../utils/null-able';
 type Refable<T> = RefCallback<T> | MutableRefObject<T>;
-export declare const useRefs: <T>(...refs: Refable<T>[]) => (trigger: T) => void;
+export declare const useRefs: <T>(...refs: Nullable<Refable<Nullable<T>>>[]) => (trigger: T) => void;
 export {};

package/dist/hooks/use-refs.mjs

@@ -12,6 +12,8 @@ const useRefs = (...refs) => {
     return useMemo(() => {
         return (trigger) => {
             refs.forEach((ref) => {
+                if (!ref)
+                    return;
                 mount(ref, trigger);
             });
         };

package/dist/index.d.ts

@@ -47,3 +47,5 @@ export { type RequiredIn } from './utils/required-in';
 export { type ThenableEffectCallback, callAsEffect } from './utils/thenable-effect-callback';
 export { unique, uniqueBy } from './utils/unique';
 export { range } from './utils/range';
+export { clamp } from './utils/clamp';
+export { chain } from './utils/chain';

package/dist/index.mjs

@@ -32,3 +32,5 @@ export { isThenable } from './is/is-thenable.mjs';
 export { callAsEffect } from './utils/thenable-effect-callback.mjs';
 export { unique, uniqueBy } from './utils/unique.mjs';
 export { range } from './utils/range.mjs';
+export { clamp } from './utils/clamp.mjs';
+export { chain } from './utils/chain.mjs';

package/dist/is/is-pointer-usable.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @description
+ * if pointer event is usable
+ */
+export declare const isPointerUsable: () => boolean;

package/dist/utils/chain.d.ts

@@ -0,0 +1,4 @@
+import type { Partialable } from '../utils/partial-able';
+type Callable<R> = (...args: R[]) => void;
+export declare const chain: <S>(...callbacks: Partialable<Callable<S>>[]) => Callable<S>;
+export {};

package/dist/utils/chain.mjs

@@ -0,0 +1,9 @@
+const chain = (...callbacks) => {
+    return (...args) => {
+        callbacks.forEach((callback) => {
+            callback === null || callback === void 0 ? void 0 : callback(...args);
+        });
+    };
+};
+
+export { chain };

package/dist/utils/clamp.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @description
+ * get mid value
+ * @param value number
+ * @param min number
+ * @param max number
+ * @returns number
+ */
+export declare const clamp: (value: number, min: number, max: number) => number;

package/dist/utils/clamp.mjs

@@ -0,0 +1,13 @@
+/**
+ * @description
+ * get mid value
+ * @param value number
+ * @param min number
+ * @param max number
+ * @returns number
+ */
+const clamp = (value, min, max) => {
+    return Math.min(Math.max(value, min), max);
+};
+
+export { clamp };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiszlab/relax",
-  "version": "1.2.19",
+  "version": "1.2.20",
   "description": "react utils collection",
   "type": "module",
   "exports": {