@yamada-ui/utils 0.1.1 → 0.1.2

package/dist/assertion.d.ts

@@ -6,7 +6,7 @@ declare const isNumeric: (value: any) => boolean;
 declare const isString: (value: any) => value is string;
 declare const isUndefined: (value: any) => value is undefined;
 declare const isNull: (value: any) => value is null;
-declare const isObject: <T extends Dict<any>>(value: any) => value is T;
+declare const isObject: <T extends Dict>(value: any) => value is T;
 declare const isArray: <T extends any[]>(value: any) => value is T;
 declare const isEmpty: (value: any) => boolean;
 declare const isFunction: <T extends Function = Function>(value: any) => value is T;

package/dist/{chunk-HUEOJZVC.mjs → chunk-VPOQGCMS.mjs}

@@ -118,6 +118,48 @@ var useUpdateEffect = (callback, deps) => {
     };
   }, []);
 };
+var useAsync = (func, deps = []) => {
+  const [state, callback] = useAsyncFunc(func, deps, { loading: true });
+  React.useEffect(() => {
+    callback();
+  }, [callback]);
+  return state;
+};
+var useAsyncFunc = (func, deps = [], initialState = { loading: false }) => {
+  const lastCallId = React.useRef(0);
+  const isMounted = useIsMounted();
+  const [state, setState] = React.useState(initialState);
+  const callback = React.useCallback((...args) => {
+    const callId = ++lastCallId.current;
+    if (!state.loading) {
+      setState((prevState) => ({ ...prevState, loading: true }));
+    }
+    return func(...args).then(
+      (value) => {
+        if (isMounted.current && callId === lastCallId.current)
+          setState({ value, loading: false });
+        return value;
+      },
+      (error) => {
+        if (isMounted.current && callId === lastCallId.current)
+          setState({ error, loading: false });
+        return error;
+      }
+    );
+  }, deps);
+  return [state, callback];
+};
+var useAsyncRetry = (func, deps = []) => {
+  const [attempt, setAttempt] = React.useState(0);
+  const state = useAsync(func, [...deps, attempt]);
+  const stateLoading = state.loading;
+  const retry = React.useCallback(() => {
+    if (stateLoading)
+      return;
+    setAttempt((currentAttempt) => currentAttempt + 1);
+  }, [...deps, stateLoading]);
+  return { ...state, retry };
+};
 
 // src/color.ts
 import { toHex, parseToRgba, transparentize, mix, darken, lighten } from "color2k";
@@ -389,6 +431,9 @@ export {
   useMergeRefs,
   useCallbackRef,
   useUpdateEffect,
+  useAsync,
+  useAsyncFunc,
+  useAsyncRetry,
   getColor,
   lightenColor,
   darkenColor,

package/dist/color.mjs

@@ -10,7 +10,7 @@ import {
   tintColor,
   toneColor,
   transparentizeColor
-} from "./chunk-HUEOJZVC.mjs";
+} from "./chunk-VPOQGCMS.mjs";
 import "./chunk-SLJ4M7XC.mjs";
 import "./chunk-VYMGBE25.mjs";
 import "./chunk-BZAW2D6U.mjs";

package/dist/function.mjs

@@ -3,7 +3,7 @@ import {
   handlerAll,
   noop,
   runIfFunc
-} from "./chunk-HUEOJZVC.mjs";
+} from "./chunk-VPOQGCMS.mjs";
 import "./chunk-SLJ4M7XC.mjs";
 import "./chunk-VYMGBE25.mjs";
 import "./chunk-BZAW2D6U.mjs";

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { Dict, DynamicRecord, Length, Path, StringLiteral, Union } from './index
 export { cast, isArray, isEmpty, isFunction, isNotNumber, isNull, isNumber, isNumeric, isObject, isString, isUndefined, isUnit } from './assertion.js';
 export { assignAfter, filterObject, filterUndefined, flattenObject, getMemoizedObject, getObject, keysFormObject, memoizeObject, merge, objectFromEntries, omitObject, pickObject, replaceObject, splitObject } from './object.js';
 export { funcAll, handlerAll, noop, runIfFunc } from './function.js';
-export { DOMAttributes, MaybeRenderProp, PropGetter, RequiredPropGetter, assignRef, createContext, cx, findChildren, getValidChildren, includesChildren, isRefObject, isValidElement, mergeRefs, omitChildren, pickChildren, useCallbackRef, useIsMounted, useMergeRefs, useSafeLayoutEffect, useUnmountEffect, useUpdateEffect } from './react.js';
+export { AsyncFnReturn, AsyncState, AsyncStateRetry, DOMAttributes, FunctionReturningPromise, MaybeRenderProp, PromiseType, PropGetter, RequiredPropGetter, assignRef, createContext, cx, findChildren, getValidChildren, includesChildren, isRefObject, isValidElement, mergeRefs, omitChildren, pickChildren, useAsync, useAsyncFunc, useAsyncRetry, useCallbackRef, useIsMounted, useMergeRefs, useSafeLayoutEffect, useUnmountEffect, useUpdateEffect } from './react.js';
 export { FocusableElement, ariaAttr, createdDom, dataAttr, getActiveElement, getAllFocusable, getEventRelatedTarget, getOwnerDocument, getOwnerWindow, getPlatform, hasNegativeTabIndex, hasTabIndex, isActiveElement, isApple, isContains, isContentEditable, isDisabled, isElement, isFocusable, isHTMLElement, isHidden, isMac, isSafari, isTabbable, platform, vendor } from './dom.js';
 export { escape } from './string.js';
 export { Operand, calc } from './calc.js';

package/dist/index.js

@@ -123,6 +123,9 @@ __export(src_exports, {
   toPrecision: () => toPrecision,
   toneColor: () => toneColor,
   transparentizeColor: () => transparentizeColor,
+  useAsync: () => useAsync,
+  useAsyncFunc: () => useAsyncFunc,
+  useAsyncRetry: () => useAsyncRetry,
   useCallbackRef: () => useCallbackRef,
   useIsMounted: () => useIsMounted,
   useMergeRefs: () => useMergeRefs,
@@ -392,6 +395,48 @@ var useUpdateEffect = (callback, deps) => {
     };
   }, []);
 };
+var useAsync = (func, deps = []) => {
+  const [state, callback] = useAsyncFunc(func, deps, { loading: true });
+  React.useEffect(() => {
+    callback();
+  }, [callback]);
+  return state;
+};
+var useAsyncFunc = (func, deps = [], initialState = { loading: false }) => {
+  const lastCallId = React.useRef(0);
+  const isMounted = useIsMounted();
+  const [state, setState] = React.useState(initialState);
+  const callback = React.useCallback((...args) => {
+    const callId = ++lastCallId.current;
+    if (!state.loading) {
+      setState((prevState) => ({ ...prevState, loading: true }));
+    }
+    return func(...args).then(
+      (value) => {
+        if (isMounted.current && callId === lastCallId.current)
+          setState({ value, loading: false });
+        return value;
+      },
+      (error) => {
+        if (isMounted.current && callId === lastCallId.current)
+          setState({ error, loading: false });
+        return error;
+      }
+    );
+  }, deps);
+  return [state, callback];
+};
+var useAsyncRetry = (func, deps = []) => {
+  const [attempt, setAttempt] = React.useState(0);
+  const state = useAsync(func, [...deps, attempt]);
+  const stateLoading = state.loading;
+  const retry = React.useCallback(() => {
+    if (stateLoading)
+      return;
+    setAttempt((currentAttempt) => currentAttempt + 1);
+  }, [...deps, stateLoading]);
+  return { ...state, retry };
+};
 
 // src/dom.ts
 var createdDom = () => !!(typeof window !== "undefined" && window.document && window.document.createElement);
@@ -787,6 +832,9 @@ var addPointerEvent = (target, type, cb, options) => addDomEvent(target, type, w
   toPrecision,
   toneColor,
   transparentizeColor,
+  useAsync,
+  useAsyncFunc,
+  useAsyncRetry,
   useCallbackRef,
   useIsMounted,
   useMergeRefs,

package/dist/index.mjs

@@ -39,13 +39,16 @@ import {
   tintColor,
   toneColor,
   transparentizeColor,
+  useAsync,
+  useAsyncFunc,
+  useAsyncRetry,
   useCallbackRef,
   useIsMounted,
   useMergeRefs,
   useSafeLayoutEffect,
   useUnmountEffect,
   useUpdateEffect
-} from "./chunk-HUEOJZVC.mjs";
+} from "./chunk-VPOQGCMS.mjs";
 import "./chunk-SLJ4M7XC.mjs";
 import {
   clampNumber,
@@ -210,6 +213,9 @@ export {
   toPrecision,
   toneColor,
   transparentizeColor,
+  useAsync,
+  useAsyncFunc,
+  useAsyncRetry,
   useCallbackRef,
   useIsMounted,
   useMergeRefs,

package/dist/object.d.ts

@@ -1,14 +1,14 @@
 import { Dict } from './index.types.js';
 
-declare const omitObject: <T extends Dict<any>, K extends keyof T>(obj: T, keys: K[]) => Omit<T, K>;
-declare const pickObject: <T extends Dict<any>, K extends keyof T>(obj: T, keys: K[]) => { [P in K]: T[P]; };
-declare const splitObject: <T extends Dict<any>, K extends keyof T>(obj: T, keys: K[]) => [{ [P in K]: T[P]; }, Omit<T, K>];
-declare const filterObject: <T extends Dict<any>, K extends Dict<any>>(obj: T, func: (key: keyof T, value: T[keyof T], obj: T) => boolean) => K;
-declare const filterUndefined: <T extends Dict<any>>(obj: T) => T;
-declare const merge: <T extends Dict<any>>(target: any, source: any, overrideArray?: boolean) => T;
-declare const flattenObject: <T extends Dict<any>>(obj: any, maxDepth?: number) => T;
-declare const objectFromEntries: <T extends Dict<any>>(entries: any[][]) => T;
-declare const keysFormObject: <T extends Dict<any>>(obj: T) => (keyof T)[];
+declare const omitObject: <T extends Dict, K extends keyof T>(obj: T, keys: K[]) => Omit<T, K>;
+declare const pickObject: <T extends Dict, K extends keyof T>(obj: T, keys: K[]) => { [P in K]: T[P]; };
+declare const splitObject: <T extends Dict, K extends keyof T>(obj: T, keys: K[]) => [{ [P in K]: T[P]; }, Omit<T, K>];
+declare const filterObject: <T extends Dict, K extends Dict>(obj: T, func: (key: keyof T, value: T[keyof T], obj: T) => boolean) => K;
+declare const filterUndefined: <T extends Dict>(obj: T) => T;
+declare const merge: <T extends Dict>(target: any, source: any, overrideArray?: boolean) => T;
+declare const flattenObject: <T extends Dict>(obj: any, maxDepth?: number) => T;
+declare const objectFromEntries: <T extends Dict>(entries: any[][]) => T;
+declare const keysFormObject: <T extends Dict>(obj: T) => (keyof T)[];
 declare const replaceObject: <T extends unknown>(objOrArray: T, callBack: (value: any) => any) => T;
 declare const getObject: (obj: Dict, path: string | number, fallback?: any, i?: number) => any;
 declare const memoizeObject: (func: typeof getObject) => (obj: Dict, path: string | number, fallback?: any, i?: number) => any;

package/dist/object.mjs

@@ -13,7 +13,7 @@ import {
   pickObject,
   replaceObject,
   splitObject
-} from "./chunk-HUEOJZVC.mjs";
+} from "./chunk-VPOQGCMS.mjs";
 import "./chunk-SLJ4M7XC.mjs";
 import "./chunk-VYMGBE25.mjs";
 import "./chunk-BZAW2D6U.mjs";

package/dist/react.d.ts

@@ -40,5 +40,55 @@ declare const mergeRefs: <T extends unknown = any>(...refs: (ReactRef<T> | undef
 declare const useMergeRefs: <T extends unknown = any>(...refs: (ReactRef<T> | undefined)[]) => (node: T | null) => void;
 declare const useCallbackRef: <T extends (...args: any[]) => any>(callback: T | undefined, deps?: React.DependencyList) => T;
 declare const useUpdateEffect: (callback: React.EffectCallback, deps: React.DependencyList) => void;
+type FunctionReturningPromise = (...args: any[]) => Promise<any>;
+declare const useAsync: <T extends FunctionReturningPromise>(func: T, deps?: React.DependencyList) => StateFromFunctionReturningPromise<T>;
+type AsyncState<T> = {
+    loading: boolean;
+    error?: undefined;
+    value?: undefined;
+} | {
+    loading: true;
+    error?: Error | undefined;
+    value?: T;
+} | {
+    loading: false;
+    error: Error;
+    value?: undefined;
+} | {
+    loading: false;
+    error?: undefined;
+    value: T;
+};
+type PromiseType<P extends Promise<any>> = P extends Promise<infer T> ? T : never;
+type StateFromFunctionReturningPromise<T extends FunctionReturningPromise> = AsyncState<PromiseType<ReturnType<T>>>;
+type AsyncFnReturn<T extends FunctionReturningPromise = FunctionReturningPromise> = [
+    StateFromFunctionReturningPromise<T>,
+    T
+];
+declare const useAsyncFunc: <T extends FunctionReturningPromise>(func: T, deps?: React.DependencyList, initialState?: StateFromFunctionReturningPromise<T>) => AsyncFnReturn<T>;
+type AsyncStateRetry<T> = AsyncState<T> & {
+    retry(): void;
+};
+declare const useAsyncRetry: <T>(func: () => Promise<T>, deps?: React.DependencyList) => {
+    retry: () => void;
+    loading: boolean;
+    error?: undefined;
+    value?: undefined;
+} | {
+    retry: () => void;
+    loading: false;
+    error: Error;
+    value?: undefined;
+} | {
+    retry: () => void;
+    loading: true;
+    error?: Error | undefined;
+    value?: T | undefined;
+} | {
+    retry: () => void;
+    loading: false;
+    error?: undefined;
+    value: T;
+};
 
-export { DOMAttributes, MaybeRenderProp, PropGetter, RequiredPropGetter, assignRef, createContext, cx, findChildren, getValidChildren, includesChildren, isRefObject, isValidElement, mergeRefs, omitChildren, pickChildren, useCallbackRef, useIsMounted, useMergeRefs, useSafeLayoutEffect, useUnmountEffect, useUpdateEffect };
+export { AsyncFnReturn, AsyncState, AsyncStateRetry, DOMAttributes, FunctionReturningPromise, MaybeRenderProp, PromiseType, PropGetter, RequiredPropGetter, assignRef, createContext, cx, findChildren, getValidChildren, includesChildren, isRefObject, isValidElement, mergeRefs, omitChildren, pickChildren, useAsync, useAsyncFunc, useAsyncRetry, useCallbackRef, useIsMounted, useMergeRefs, useSafeLayoutEffect, useUnmountEffect, useUpdateEffect };

package/dist/react.js

@@ -41,6 +41,9 @@ __export(react_exports, {
   mergeRefs: () => mergeRefs,
   omitChildren: () => omitChildren,
   pickChildren: () => pickChildren,
+  useAsync: () => useAsync,
+  useAsyncFunc: () => useAsyncFunc,
+  useAsyncRetry: () => useAsyncRetry,
   useCallbackRef: () => useCallbackRef,
   useIsMounted: () => useIsMounted,
   useMergeRefs: () => useMergeRefs,
@@ -154,6 +157,48 @@ var useUpdateEffect = (callback, deps) => {
     };
   }, []);
 };
+var useAsync = (func, deps = []) => {
+  const [state, callback] = useAsyncFunc(func, deps, { loading: true });
+  React.useEffect(() => {
+    callback();
+  }, [callback]);
+  return state;
+};
+var useAsyncFunc = (func, deps = [], initialState = { loading: false }) => {
+  const lastCallId = React.useRef(0);
+  const isMounted = useIsMounted();
+  const [state, setState] = React.useState(initialState);
+  const callback = React.useCallback((...args) => {
+    const callId = ++lastCallId.current;
+    if (!state.loading) {
+      setState((prevState) => ({ ...prevState, loading: true }));
+    }
+    return func(...args).then(
+      (value) => {
+        if (isMounted.current && callId === lastCallId.current)
+          setState({ value, loading: false });
+        return value;
+      },
+      (error) => {
+        if (isMounted.current && callId === lastCallId.current)
+          setState({ error, loading: false });
+        return error;
+      }
+    );
+  }, deps);
+  return [state, callback];
+};
+var useAsyncRetry = (func, deps = []) => {
+  const [attempt, setAttempt] = React.useState(0);
+  const state = useAsync(func, [...deps, attempt]);
+  const stateLoading = state.loading;
+  const retry = React.useCallback(() => {
+    if (stateLoading)
+      return;
+    setAttempt((currentAttempt) => currentAttempt + 1);
+  }, [...deps, stateLoading]);
+  return { ...state, retry };
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   assignRef,
@@ -167,6 +212,9 @@ var useUpdateEffect = (callback, deps) => {
   mergeRefs,
   omitChildren,
   pickChildren,
+  useAsync,
+  useAsyncFunc,
+  useAsyncRetry,
   useCallbackRef,
   useIsMounted,
   useMergeRefs,

package/dist/react.mjs

@@ -10,13 +10,16 @@ import {
   mergeRefs,
   omitChildren,
   pickChildren,
+  useAsync,
+  useAsyncFunc,
+  useAsyncRetry,
   useCallbackRef,
   useIsMounted,
   useMergeRefs,
   useSafeLayoutEffect,
   useUnmountEffect,
   useUpdateEffect
-} from "./chunk-HUEOJZVC.mjs";
+} from "./chunk-VPOQGCMS.mjs";
 import "./chunk-SLJ4M7XC.mjs";
 import "./chunk-VYMGBE25.mjs";
 import "./chunk-BZAW2D6U.mjs";
@@ -37,6 +40,9 @@ export {
   mergeRefs,
   omitChildren,
   pickChildren,
+  useAsync,
+  useAsyncFunc,
+  useAsyncRetry,
   useCallbackRef,
   useIsMounted,
   useMergeRefs,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yamada-ui/utils",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Yamada UI utils",
   "keywords": [
     "utils",