@gateweb/react-utils 1.7.0 → 1.8.0

package/dist/cjs/queryStore-client-q_SLGgYH.js

@@ -0,0 +1,77 @@
+'use client';
+var React = require('react');
+var zustand = require('zustand');
+var traditional = require('zustand/traditional');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React__default = /*#__PURE__*/_interopDefault(React);
+
+const createQueryStore = ({ query, handleChangeQuery })=>zustand.createStore()((set)=>({
+            query: {
+                ...query
+            },
+            changeQuery: (newQuery)=>{
+                set((pre)=>{
+                    if (handleChangeQuery) {
+                        return {
+                            query: handleChangeQuery(pre.query, newQuery)
+                        };
+                    }
+                    return {
+                        query: {
+                            ...pre.query,
+                            ...newQuery
+                        }
+                    };
+                });
+            }
+        }));
+const QueryContext = /*#__PURE__*/ React.createContext(null);
+/**
+ * Provider to provide the store to the context
+ */ const QueryProvider = ({ children, query, handleChangeQuery })=>{
+    const storeRef = React.useRef(null);
+    if (!storeRef.current) {
+        storeRef.current = createQueryStore({
+            query,
+            handleChangeQuery
+        });
+    }
+    return /*#__PURE__*/ React__default.default.createElement(QueryContext.Provider, {
+        value: storeRef.current
+    }, children);
+};
+/**
+ * hook to get the store from the context
+ *
+ * because we want the return type of `selector` to be inferred by ts, we use HOF to implement the hook
+ *
+ * so you should use it like this:
+ *
+ * ```tsx
+ * const useQuery = useQueryContext<MyObject>(); // => will return the store hook
+ * const result = useQuery(q => q.query); // => will return the query object
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * const result1 = useQueryContext<MyObject>()(q => '1234');
+ * const result2 = useQueryContext<MyObject>()(q => q.changeQuery);
+ * const result3 = useQueryContext<MyObject>()(q => q.query);
+ * ```
+ */ const useQueryContext = ()=>{
+    const store = React.useContext(QueryContext);
+    if (!store) throw new Error('Missing QueryContext.Provider in the tree');
+    /**
+   *  the hook to get the store
+   *
+   * @param selector - the selector to get the state from the store
+   * @param equalityFn - the equality function to compare the previous and next state, if it returns `true`, the component will not re-render
+   */ const useStore = (selector, equalityFn)=>traditional.useStoreWithEqualityFn(store, selector, equalityFn);
+    return useStore;
+};
+
+exports.QueryProvider = QueryProvider;
+exports.useQueryContext = useQueryContext;

package/dist/cjs/{useCountdown-client-CNjGBIUB.js → useCountdown-client-uiqhgllY.js}

@@ -1,5 +1,5 @@
 'use client';
-var react = require('react');
+var React = require('react');
 
 /**
  * 倒數計時器
@@ -11,17 +11,17 @@ var react = require('react');
  * @param initialCountdown 倒數計時器初始值
  * @param enableReinitialize 允許重設初始值
  */ const useCountdown = (initialCountdown, enableReinitialize = false)=>{
-    const [countdown, setCountdown] = react.useState(initialCountdown);
-    const [isCounting, setIsCounting] = react.useState(false);
-    const initialValues = react.useRef(initialCountdown);
-    const isMounted = react.useRef(false);
-    react.useEffect(()=>{
+    const [countdown, setCountdown] = React.useState(initialCountdown);
+    const [isCounting, setIsCounting] = React.useState(false);
+    const initialValues = React.useRef(initialCountdown);
+    const isMounted = React.useRef(false);
+    React.useEffect(()=>{
         isMounted.current = true;
         return ()=>{
             isMounted.current = false;
         };
     }, []);
-    react.useEffect(()=>{
+    React.useEffect(()=>{
         if (isMounted.current && initialValues.current !== initialCountdown && enableReinitialize) {
             initialValues.current = initialCountdown;
             setCountdown(initialCountdown);
@@ -30,7 +30,7 @@ var react = require('react');
         initialCountdown,
         enableReinitialize
     ]);
-    react.useEffect(()=>{
+    React.useEffect(()=>{
         let timer;
         if (isCounting && countdown > 0) {
             timer = setTimeout(()=>{

package/dist/es/index.d.mts

@@ -2,6 +2,130 @@ import { TExtractValueType, AtLeastOne } from './types.mjs';
 export * from './types.mjs';
 import React from 'react';
 
+declare const FILE_SIZE_UNITS: readonly ["Bytes", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"];
+type FileSizeUnit = (typeof FILE_SIZE_UNITS)[number];
+/**
+ * 代表字節大小的類，提供各種格式化和轉換方法
+ */
+declare class ByteSize {
+    private readonly bytes;
+    /**
+     * 建立一個新的 ByteSize 實例
+     * @param bytes 位元組數值
+     */
+    constructor(bytes: number);
+    /**
+     * 取得原始位元組數值
+     */
+    get value(): number;
+    /**
+     * 將位元組轉換為指定單位的數值
+     *
+     * @param unit 目標單位 (例如 'KB', 'MB', 'GB')
+     * @returns 轉換後的數值
+     *
+     * @example
+     * ```ts
+     * const size = createByteSize(1024);
+     * size.to('KB'); // 1
+     * size.to('MB'); // 0.0009765625
+     * ```
+     */
+    to(unit: FileSizeUnit): number;
+    /**
+     * 轉換為適當單位的可讀字符串
+     *
+     * @param unit 指定單位 (例如 'KB', 'MB', 'GB')，不指定則自動選擇最適合的單位
+     * @param decimals 小數點位數 (預設為 2)
+     * @returns 格式化後的字符串
+     *
+     * @example
+     * ```ts
+     * const size = createByteSize(1024);
+     * size.format(); // '1.00 KB'
+     * size.format('KB'); // '1.00 KB'
+     * size.format('MB', 3); // '0.001 MB'
+     * ```
+     */
+    format(unit?: FileSizeUnit, decimals?: number): string;
+    /**
+     * 比較兩個 ByteSize 實例
+     *
+     * @param other 要比較的另一個 ByteSize 實例
+     * @returns 比較結果：-1 表示小於，0 表示等於，1 表示大於
+     */
+    compareTo(other: ByteSize): number;
+    /**
+     * 轉換為字符串表示
+     * @returns 預設格式化的字符串
+     */
+    toString(): string;
+}
+/**
+ * 將位元組轉換為可讀字符串 (保留舊的 API 以確保向後兼容)
+ *
+ * @param bytes 位元組數值
+ * @param unit 目標單位 (例如 'KB', 'MB', 'GB')，不指定則自動選擇最適合的單位
+ * @param decimals 小數點位數 (預設為 2)
+ * @returns 格式化後的字符串
+ *
+ * @example
+ * ```ts
+ * convertBytes(0) // '0 Bytes'
+ * convertBytes(1024, 'KB') // '1 KB'
+ * convertBytes(1024, 'KB', 2) // '1.00 KB'
+ * convertBytes(1024 * 1024, 'MB') // '1 MB'
+ * convertBytes(1024 * 1024, 'KB') // '1024 KB'
+ * ```
+ */
+declare const convertBytes: (bytes: number, unit?: FileSizeUnit, decimals?: number) => string;
+
+type SearchParamsObject = Record<string, string | number | boolean | null | undefined | (string | number | boolean)[]>;
+/**
+ * 將單層物件轉換為 URLSearchParams 物件
+ * - 會自動排除 null、undefined、空字串和空陣列的值
+ * - 陣列會以逗號連接為字串
+ *
+ * @param obj - 要轉換的物件，只支援單層物件，其中值可以是 string、number、boolean、null、undefined 或字串陣列
+ * @returns URLSearchParams 實例
+ *
+ * @example
+ * const params = { a: '1', b: 123, c: false, d: ['1','2'], e: null, f: undefined, g: '', h: [] };
+ * objectToSearchParams(params).toString(); // 'a=1&b=123&c=false&d=1%2C2'
+ */
+declare const objectToSearchParams: <T extends SearchParamsObject>(obj: T) => URLSearchParams;
+/**
+ * 支援的型別轉換器類型
+ */
+type TypeConverter = 'string' | 'number' | 'boolean' | 'array';
+/**
+ * 型別轉換映射表
+ */
+type TypeConverterMap<T extends object = Record<string, unknown>> = {
+    [K in keyof T]?: TypeConverter;
+};
+/**
+ * 將 URLSearchParams 或字串轉換為物件
+ *
+ * @param searchParams - 要轉換的搜尋參數字串或 URLSearchParams 實例
+ * @param typeMap - 可選的型別轉換映射表，用於指定每個參數的目標型別
+ * @returns
+ *
+ * @example
+ * const queryString = 'a=1&b=123&c=true&d=1,2,3&e=false';
+ * const result = searchParamsToObject(queryString);
+ * // result: { a: '1', b: '123', c: 'true', d: '1,2,3', e: 'false' }
+ * const result = searchParamsToObject(queryString, {
+ *   a: 'string',
+ *   b: 'number',
+ *   c: 'boolean',
+ *   d: 'array',
+ *   e: 'boolean',
+ * });
+ * // result: { a: '1', b: 123, c: true, d: ['1', '2', '3'], e: false }
+ */
+declare const searchParamsToObject: <T extends object = SearchParamsObject>(searchParams: string | URLSearchParams, typeMap?: TypeConverterMap<T>) => Partial<T>;
+
 type CamelToPascal<S extends string> = S extends `${infer Head}${infer Tail}` ? `${Uppercase<Head>}${Tail}` : S;
 /**
  * convert CamelCase string to PascalCase string
@@ -158,54 +282,69 @@ declare const snakeCase2CamelCase: <T extends Record<string, any>>(obj: T) => Tr
 declare const snakeCase2PascalCase: <T extends Record<string, any>>(obj: T) => TransformObjectKey<T, "SnakeToPascal">;
 
 /**
- * 取得去年今年以及明年期別陣列
+ * 將數字轉換成金額千分位格式
+ *
+ * @param num - 數字
  *
  * @example
- * // 假設 今年為 112 年
- * generatePeriodArray() // 11102 ~ 11312
+ *
+ * formatAmount(1234567) // '1,234,567'
  */
-declare const generatePeriodArray: () => string[];
+declare const formatAmount: (num: number) => string;
 /**
- * 取得當前期別
- *
- * 報稅期限次期開始15日內
- *
- * 雙數月沒有特殊規則，期別皆為當月開頭
+ * 將字串的第 n - m 個字轉換成星號
  *
- * 單數月15號以前，期別為上個月否則為下個月開頭
+ * @param str - 字串
+ * @param n - 起始位置
+ * @param m - 結束位置
  *
  * @example
  *
- * // 假設今天是 111-02-15
- * getCurrentPeriod() // 11102
- * // 假設今天是 111-02-16
- * getCurrentPeriod() // 11102
- * // 假設今天是 111-03-15
- * getCurrentPeriod() // 11102
- * // 假設今天是 111-03-16
- * getCurrentPeriod() // 11104
+ * formatString('123456', 1, 4) // '1****6'
  */
-declare const getCurrentPeriod: () => string;
+declare const formatStarMask: (str: string, n: number, m: number) => string;
 /**
- * 民國年轉西元年
- * @param dateString 日期字串
- * @param format 日期格式
+ * format file size to human readable string
+ *
+ * it will convert bytes to KB, MB, GB, TB, PB, EB, ZB, YB
+ *
+ * @param bytes file size in bytes
+ * @param decimals number of decimal places (default is 2)
+ *
  * @example
  *
- * rocEraToAd('1100201') // 20210201
- * rocEraToAd('11002', 'YYYYMM') // 202102
+ * ```js
+ * formatBytes(0) // 0 Bytes
+ * formatBytes(1024) // 1 KB
+ * formatBytes(1024, 2) // 1.00 KB
+ * formatBytes(1024 * 1024) // 1 MB
+ * ```
+ * @deprecated use `convertBytes` instead
  */
-declare const rocEraToAd: (dateString: string, format?: string) => string;
+declare const formatBytes: (bytes: number, decimals?: number) => string;
+
 /**
- * 西元年轉民國年
- * @param dateString 日期字串
- * @param format 日期格式
- * @example
+ * 檢查兩個值是否相等（包含陣列等引用型別）
+ * - 支援基本型別的直接比較
+ * - 特別處理空陣列比較
+ * - 支援非空陣列的深度比較
  *
- * adToRocEra('20210201') // 1100201
- * adToRocEra('202102', 'YYYYMM') // 11002
+ * @param value1 - 第一個值
+ * @param value2 - 第二個值
+ * @returns 如果值相等則返回 true
+ *
+ * @example
+ * // 基本型別比較
+ * isEqual(1, 1); // true
+ * isEqual('abc', 'abc'); // true
+ * isEqual(null, null); // true
+ *
+ * // 陣列比較
+ * isEqual([], []); // true
+ * isEqual([1, 2], [1, 2]); // true
+ * isEqual([1, 2], [1, 3]); // false
  */
-declare const adToRocEra: (dateString: string, format?: string) => string;
+declare const isEqual: (value1: unknown, value2: unknown) => boolean;
 
 /**
  * 將指定格式的物件轉換成類似 enum 的物件
@@ -323,53 +462,6 @@ declare const validateFileType: (file: File, accepts: string[]) => boolean;
  */
 declare const getMimeType: (fileName: string) => "image/jpeg" | "image/png" | "application/pdf" | "application/zip" | "text/csv" | "text/plain" | "application/octet-stream";
 
-type TCountdownActions = {
-    /** 目前秒數 */
-    countdown: number;
-    /** 是否正在倒數計時 */
-    isCounting: boolean;
-    /** 開始倒數計時 */
-    start: () => void;
-    /** 停止倒數計時 */
-    stop: () => void;
-    /** 重置倒數計時 */
-    reset: () => void;
-};
-/**
- * 倒數計時器
- *
- * 可以透過 start() 來啟動倒數計時器
- * 可以透過 stop() 來停止倒數計時器
- * 可以透過 reset() 來重置倒數計時器
- *
- * @param initialCountdown 倒數計時器初始值
- * @param enableReinitialize 允許重設初始值
- */
-declare const useCountdown: (initialCountdown: number, enableReinitialize?: boolean) => TCountdownActions;
-
-type TValueOptions<T> = AtLeastOne<{
-    /**
-     * The controlled value.
-     */
-    value?: T;
-    /**
-     * The default value.
-     */
-    defaultValue?: T;
-}>;
-/**
- * A hook to manage a value.
- *
- * @example
- *
- * ```tsx
- * const MyComponent = ({ value }: { value?: number }) => {
- *    const [currentValue, setCurrentValue] = useValue({ value });
- * };
- * ```
- */
-declare const useValue: <T>({ value, defaultValue }: TValueOptions<T>) => readonly [T, (newValue: T) => void];
-
 declare function invariant(condition: any, message?: string | (() => string)): asserts condition;
 
 /**
@@ -395,8 +487,8 @@ declare const omit: <T extends object, K extends [...(keyof T)[]]>(object: T, ..
  * @param values 要排除的 value
  *
  * @example
- * const a = { a: undefined, b: null, c: 3, d: 4 };
- * const b = omitByValue(a, undefined, null); // { c: 3, d: 4 }
+ * const a = { a: undefined, b: null, c: 3, d: 4, e: [] };
+ * const b = omitByValue(a, undefined, null, []); // { c: 3, d: 4 }
  */
 declare const omitByValue: <T extends object, K extends any[]>(object: T, ...values: K) => Pick<T, { [K2 in keyof T]: T[K2] extends K[number] ? never : K2; }[keyof T]>;
 /**
@@ -419,8 +511,8 @@ declare const pick: <T extends object, K extends [...(keyof T)[]]>(object: T, ..
  *
  * @example
  *
- * const a = { a: 1, b: 2, c: 3, d: 4 };
- * const b = pickByValue(a, 1, 2); // { a: 1, b: 2 }
+ * const a = { a: 1, b: 2, c: 3, d: 4, e: [] };
+ * const b = pickByValue(a, 1, 2, []); // { a: 1, b: 2, e: [] }
  */
 declare const pickByValue: <T extends object, K extends any[]>(object: T, ...values: K) => Pick<T, { [K2 in keyof T]: T[K2] extends K[number] ? K2 : never; }[keyof T]>;
 /**
@@ -503,7 +595,11 @@ declare const debounce: <P, R>(fn: (...args: P[]) => R, delay: number) => (...ar
  */
 declare const throttle: <P, R>(fn: (...args: P[]) => R, delay: number) => (...args: P[]) => R | undefined;
 
-declare function mergeRefs<T = any>(refs: Array<React.MutableRefObject<T> | React.LegacyRef<T> | undefined | null>): React.RefCallback<T>;
+/**
+ * Wait for a given amount of time
+ * @param ms time to wait in milliseconds
+ */
+declare const wait: (ms: number) => void;
 
 /**
  * 中文
@@ -737,47 +833,6 @@ declare const isTWMobile: () => RegExp;
  */
 declare const isTWPhone: () => RegExp;
 
-/**
- * 將數字轉換成金額千分位格式
- *
- * @param num - 數字
- *
- * @example
- *
- * formatAmount(1234567) // '1,234,567'
- */
-declare const formatAmount: (num: number) => string;
-/**
- * 將字串的第 n - m 個字轉換成星號
- *
- * @param str - 字串
- * @param n - 起始位置
- * @param m - 結束位置
- *
- * @example
- *
- * formatString('123456', 1, 4) // '1****6'
- */
-declare const formatStarMask: (str: string, n: number, m: number) => string;
-/**
- * format file size to human readable string
- *
- * it will convert bytes to KB, MB, GB, TB, PB, EB, ZB, YB
- *
- * @param bytes file size in bytes
- * @param decimals number of decimal places (default is 2)
- *
- * @example
- *
- * ```js
- * formatBytes(0) // 0 Bytes
- * formatBytes(1024) // 1 KB
- * formatBytes(1024, 2) // 1.00 KB
- * formatBytes(1024 * 1024) // 1 MB
- * ```
- */
-declare const formatBytes: (bytes: number, decimals?: number) => string;
-
 /**
  * 檢查稅務編號是否符合正確的編號規則。
  *
@@ -822,11 +877,155 @@ declare const validTaxId: (taxId: string) => boolean;
  */
 declare const validateDateString: (dateString: string, format: string) => boolean;
 
+type TQueryProps<Q> = {
+    /**
+     * the query object
+     */
+    query: Partial<Q>;
+};
+type TQueryState<Q> = {
+    /**
+     * trigger the change of query
+     *
+     * @param query - the new query
+     */
+    changeQuery: (query: TQueryProps<Q>['query']) => void;
+} & TQueryProps<Q>;
+type TInitialProps<Q> = Partial<TQueryProps<Q> & {
+    /**
+     * handle the change of query when calling `changeQuery`
+     *
+     * @param preQuery - the previous query
+     * @param newQuery - the new query
+     * @returns the custom new query
+     */
+    handleChangeQuery: (preQuery: TQueryProps<Q>['query'], newQuery: TQueryProps<Q>['query']) => TQueryProps<Q>['query'];
+}>;
 /**
- * Wait for a given amount of time
- * @param ms time to wait in milliseconds
+ * Provider to provide the store to the context
  */
-declare const wait: (ms: number) => void;
+declare const QueryProvider: <Q>({ children, query, handleChangeQuery, }: React.PropsWithChildren<TInitialProps<Q>>) => React.JSX.Element;
+/**
+ * hook to get the store from the context
+ *
+ * because we want the return type of `selector` to be inferred by ts, we use HOF to implement the hook
+ *
+ * so you should use it like this:
+ *
+ * ```tsx
+ * const useQuery = useQueryContext<MyObject>(); // => will return the store hook
+ * const result = useQuery(q => q.query); // => will return the query object
+ * ```
+ *
+ * @example
+ *
+ * ```tsx
+ * const result1 = useQueryContext<MyObject>()(q => '1234');
+ * const result2 = useQueryContext<MyObject>()(q => q.changeQuery);
+ * const result3 = useQueryContext<MyObject>()(q => q.query);
+ * ```
+ */
+declare const useQueryContext: <Q>() => <T>(selector: (state: TQueryState<Q>) => T, equalityFn?: (left: T, right: T) => boolean) => T;
+
+type TCountdownActions = {
+    /** 目前秒數 */
+    countdown: number;
+    /** 是否正在倒數計時 */
+    isCounting: boolean;
+    /** 開始倒數計時 */
+    start: () => void;
+    /** 停止倒數計時 */
+    stop: () => void;
+    /** 重置倒數計時 */
+    reset: () => void;
+};
+/**
+ * 倒數計時器
+ *
+ * 可以透過 start() 來啟動倒數計時器
+ * 可以透過 stop() 來停止倒數計時器
+ * 可以透過 reset() 來重置倒數計時器
+ *
+ * @param initialCountdown 倒數計時器初始值
+ * @param enableReinitialize 允許重設初始值
+ */
+declare const useCountdown: (initialCountdown: number, enableReinitialize?: boolean) => TCountdownActions;
+
+type TValueOptions<T> = AtLeastOne<{
+    /**
+     * The controlled value.
+     */
+    value?: T;
+    /**
+     * The default value.
+     */
+    defaultValue?: T;
+}>;
+/**
+ * A hook to manage a value.
+ *
+ * @example
+ *
+ * ```tsx
+ * const MyComponent = ({ value }: { value?: number }) => {
+ *    const [currentValue, setCurrentValue] = useValue({ value });
+ * };
+ * ```
+ */
+declare const useValue: <T>({ value, defaultValue }: TValueOptions<T>) => readonly [T, (newValue: T) => void];
+
+declare function mergeRefs<T = any>(refs: Array<React.MutableRefObject<T> | React.LegacyRef<T> | undefined | null>): React.RefCallback<T>;
+
+/**
+ * 民國年轉西元年
+ * @param dateString 日期字串
+ * @param format 日期格式
+ * @example
+ *
+ * rocEraToAd('1100201') // 20210201
+ * rocEraToAd('11002', 'YYYYMM') // 202102
+ */
+declare const rocEraToAd: (dateString: string, format?: string) => string;
+/**
+ * 西元年轉民國年
+ * @param dateString 日期字串
+ * @param format 日期格式
+ * @example
+ *
+ * adToRocEra('20210201') // 1100201
+ * adToRocEra('202102', 'YYYYMM') // 11002
+ */
+declare const adToRocEra: (dateString: string, format?: string) => string;
+
+/**
+ * 取得去年今年以及明年期別陣列
+ *
+ * @example
+ * // 假設 今年為 112 年
+ * generatePeriodArray() // 11102 ~ 11312
+ */
+declare const generatePeriodArray: () => string[];
+/**
+ * 取得當前期別
+ *
+ * 報稅期限次期開始15日內
+ *
+ * 雙數月沒有特殊規則，期別皆為當月開頭
+ *
+ * 單數月15號以前，期別為上個月否則為下個月開頭
+ *
+ * @example
+ *
+ * // 假設今天是 111-02-15
+ * getCurrentPeriod() // 11102
+ * // 假設今天是 111-02-16
+ * getCurrentPeriod() // 11102
+ * // 假設今天是 111-03-15
+ * getCurrentPeriod() // 11102
+ * // 假設今天是 111-03-16
+ * getCurrentPeriod() // 11104
+ */
+declare const getCurrentPeriod: () => string;
 
 /**
  * Downloads a file from a given source.
@@ -861,5 +1060,4 @@ declare const getLocalStorage: <T>(key: string, deCode?: boolean) => T | undefin
  */
 declare const setLocalStorage: (key: string, value: Record<string, any>, enCode?: boolean) => void;
 
-export { adToRocEra, camelCase2PascalCase, camelCase2SnakeCase, camelString2PascalString, camelString2SnakeString, createEnumLikeObject, debounce, deepMerge, downloadFile, extractEnumLikeObject, fakeApi, formatAmount, formatBytes, formatStarMask, generatePeriodArray, getCurrentPeriod, getLocalStorage, getMimeType, invariant, isChinese, isDateString, isDateTimeString, isEmail, isEnglish, isNonZeroStart, isNumber, isNumberAtLeastN, isNumberN, isNumberNM, isServer, isTWMobile, isTWPhone, isTimeString, isValidPassword, mergeRefs, omit, omitByValue, pascalCase2CamelCase, pascalCase2SnakeCase, pascalString2CamelString, pascalString2SnakeString, pick, pickByValue, rocEraToAd, setLocalStorage, snakeCase2CamelCase, snakeCase2PascalCase, snakeString2CamelString, snakeString2PascalString, throttle, useCountdown, useValue, validTaxId, validateDateString, validateFileType, wait };
-export type { PartialBy, RequiredBy, TCountdownActions };
+export { ByteSize, type PartialBy, QueryProvider, type RequiredBy, type TCountdownActions, adToRocEra, camelCase2PascalCase, camelCase2SnakeCase, camelString2PascalString, camelString2SnakeString, convertBytes, createEnumLikeObject, debounce, deepMerge, downloadFile, extractEnumLikeObject, fakeApi, formatAmount, formatBytes, formatStarMask, generatePeriodArray, getCurrentPeriod, getLocalStorage, getMimeType, invariant, isChinese, isDateString, isDateTimeString, isEmail, isEnglish, isEqual, isNonZeroStart, isNumber, isNumberAtLeastN, isNumberN, isNumberNM, isServer, isTWMobile, isTWPhone, isTimeString, isValidPassword, mergeRefs, objectToSearchParams, omit, omitByValue, pascalCase2CamelCase, pascalCase2SnakeCase, pascalString2CamelString, pascalString2SnakeString, pick, pickByValue, rocEraToAd, searchParamsToObject, setLocalStorage, snakeCase2CamelCase, snakeCase2PascalCase, snakeString2CamelString, snakeString2PascalString, throttle, useCountdown, useQueryContext, useValue, validTaxId, validateDateString, validateFileType, wait };