@gateweb/react-utils 1.16.0 → 1.17.0

package/dist/cjs/index.js

@@ -1,762 +1,18 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
+var webStorage12s = require('./webStorage-12s-P8HpaTRP.js');
 var dayjs = require('dayjs');
 var queryStore12s = require('./queryStore-12s-q_SLGgYH.js');
 var React = require('react');
 var useCountdown12s = require('./useCountdown-12s-uiqhgllY.js');
 var useDisclosure12s = require('./useDisclosure-12s-SZtbSE4A.js');
 var download12s = require('./download-12s-DKxkL92w.js');
-var webStorage12s = require('./webStorage-12s-DHr9PcPl.js');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var dayjs__default = /*#__PURE__*/_interopDefault(dayjs);
 var React__default = /*#__PURE__*/_interopDefault(React);
 
-const FILE_SIZE_UNITS$1 = [
-    'Bytes',
-    'KB',
-    'MB',
-    'GB',
-    'TB',
-    'PB',
-    'EB',
-    'ZB',
-    'YB'
-];
-/**
- * 代表字節大小的類，提供各種格式化和轉換方法
- */ class ByteSize {
-    /**
-   * 建立一個新的 ByteSize 實例
-   * @param bytes 位元組數值
-   */ constructor(bytes){
-        this.bytes = bytes;
-    }
-    /**
-   * 取得原始位元組數值
-   */ get value() {
-        return this.bytes;
-    }
-    /**
-   * 將位元組轉換為指定單位的數值
-   *
-   * @param unit 目標單位 (例如 'KB', 'MB', 'GB')
-   * @returns 轉換後的數值
-   *
-   * @example
-   * ```ts
-   * const size = createByteSize(1024);
-   * size.to('KB'); // 1
-   * size.to('MB'); // 0.0009765625
-   * ```
-   */ to(unit) {
-        if (!FILE_SIZE_UNITS$1.includes(unit)) {
-            console.warn(`Invalid unit: ${unit}. Valid units are: ${FILE_SIZE_UNITS$1.join(', ')}`);
-            return this.bytes;
-        }
-        const k = 1024;
-        const i = FILE_SIZE_UNITS$1.indexOf(unit);
-        return this.bytes / k ** i;
-    }
-    /**
-   * 轉換為適當單位的可讀字符串
-   *
-   * @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, decimals = 2) {
-        if (this.bytes === 0) return `0 ${unit || 'Bytes'}`;
-        const k = 1024;
-        // 如果指定了有效單位，則使用；否則，計算最適合的單位
-        const i = unit && FILE_SIZE_UNITS$1.includes(unit) ? FILE_SIZE_UNITS$1.indexOf(unit) : Math.floor(Math.log(this.bytes) / Math.log(k));
-        return `${(this.bytes / k ** i).toFixed(decimals)} ${FILE_SIZE_UNITS$1[i]}`;
-    }
-    /**
-   * 比較兩個 ByteSize 實例
-   *
-   * @param other 要比較的另一個 ByteSize 實例
-   * @returns 比較結果：-1 表示小於，0 表示等於，1 表示大於
-   */ compareTo(other) {
-        if (this.bytes < other.value) return -1;
-        if (this.bytes > other.value) return 1;
-        return 0;
-    }
-    /**
-   * 轉換為字符串表示
-   * @returns 預設格式化的字符串
-   */ toString() {
-        return this.format();
-    }
-}
-/**
- * 將位元組轉換為可讀字符串 (保留舊的 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'
- * ```
- */ const convertBytes = (bytes, unit, decimals = 2)=>new ByteSize(bytes).format(unit, decimals);
-
-/**
- * 檢查兩個值是否相等（包含陣列等引用型別）
- * - 支援基本型別的直接比較
- * - 特別處理空陣列比較
- * - 支援非空陣列的深度比較
- *
- * @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
- */ const isEqual = (value1, value2)=>{
-    // 處理基本型別
-    if (value1 === value2) {
-        return true;
-    }
-    // 處理空陣列
-    if (Array.isArray(value1) && Array.isArray(value2) && value1.length === 0 && value2.length === 0) {
-        return true;
-    }
-    // 兩者都是非 null 的物件（包含陣列）
-    if (value1 !== null && value2 !== null && typeof value1 === 'object' && typeof value2 === 'object') {
-        // 處理非空陣列
-        if (Array.isArray(value1) && Array.isArray(value2)) {
-            if (value1.length !== value2.length) {
-                return false;
-            }
-            return value1.every((item, index)=>isEqual(item, value2[index]));
-        }
-    // 未來可以擴展這裡，增加其他物件型別的深度比較
-    }
-    return false;
-};
-
-/**
- * 將指定格式的物件轉換成類似 enum 的物件
- *
- * @param enumObject enum 物件
- * @param valueKey value 的 key
- *
- * @example
- * const myObj = {
- *   A: { value: 'a' },
- *   B: { value: 'b', other: 'other' },
- * } as const;
- * const enumCode = extractEnumLikeObject(myObj, 'value');
- * // => { A: 'a', B: 'b' }
- */ const extractEnumLikeObject = (enumObject, valueKey)=>Object.entries(enumObject).reduce((acc, [key, value])=>({
-            ...acc,
-            [key]: value[valueKey]
-        }), {});
-// 實作
-function createEnumLikeObject(obj, options) {
-    const name = options?.name;
-    const scene = options?.scene;
-    const valueKey = options?.valueKey ?? 'value';
-    const Enum = extractEnumLikeObject(obj, valueKey);
-    // List：根據有無 scene 做不同處理
-    let list;
-    if (scene) {
-        // scenes 版本：解構指定 scene 的 label
-        list = Object.entries(obj).map(([key, item])=>({
-                key,
-                value: item?.[valueKey],
-                ...item.scenes?.[scene] ?? {}
-            }));
-    } else {
-        // label only 版本
-        list = Object.entries(obj).map(([key, item])=>({
-                key,
-                value: item?.[valueKey],
-                ...item
-            }));
-    }
-    function getLabel(value) {
-        const targetItem = list.find((item)=>// 如果 list 項目內含有 valueKey 對應欄位，優先以該欄位比對；否則以 value 欄位比對
-            valueKey in item ? item[valueKey] === value : item.value === value);
-        if (!targetItem) return String(value);
-        if ('label' in targetItem) return targetItem.label;
-        return String(value);
-    }
-    if (name) {
-        // 命名版：使用 Enum${name}, ${name}List, get${name}Label 鍵名
-        return {
-            [`Enum${name}`]: Enum,
-            [`${name}List`]: list,
-            [`get${name}Label`]: getLabel
-        };
-    }
-    // 未命名：提供預設鍵名 Enum, List, getLabel
-    return {
-        Enum,
-        List: list,
-        getLabel
-    };
-}
-
-/**
- * simulate a fake api request
- *
- * @param returnValue the value to return
- * @param result the result of the request
- * @param time the time to wait before resolving
- *
- * @example
- *
- * const result = await fakeApi({ foo: 'bar' });
- * console.log(result); // { result: true, data: { foo: 'bar' } }
- */ const fakeApi = (returnValue, result = true, time = 1000)=>new Promise((resolve)=>{
-        setTimeout(()=>{
-            if (result) resolve({
-                result,
-                data: returnValue
-            });
-            else resolve({
-                result,
-                message: 'error'
-            });
-        }, time);
-    });
-
-const MimeTypeMap = {
-    jpeg: 'image/jpeg',
-    jpg: 'image/jpeg',
-    gif: 'image/gif',
-    png: 'image/png',
-    pdf: 'application/pdf',
-    zip: 'application/zip',
-    csv: 'text/csv',
-    ppt: 'application/vnd.ms-powerpoint',
-    pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
-    xls: 'application/vnd.ms-excel',
-    xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
-    doc: 'application/msword',
-    docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
-    txt: 'text/plain'
-};
-const OtherMimeType = 'application/octet-stream';
-
-/**
- * 檢查檔案是否為合法的檔案類型
- *
- * `accepts` 可同時接受副檔名以及 MIME 類型
- *
- * @param file 檔案
- * @param accepts 允許的類型
- *
- * @example
- *
- * ```js
- * validateFileType({ type: 'image/png' }, ['image/png', 'image/jpeg']) // true
- * validateFileType({ type: 'image/png' }, ['image/jpeg']) // false
- * validateFileType({ type: 'image/png' }, ['image/*']) // true
- * validateFileType({ name: '圖片.png', type: 'image/png' }, ['.png']) // true
- * ```
- */ const validateFileType = (file, accepts)=>{
-    if (accepts.length === 0) return true;
-    // 獲取文件的MIME類型
-    const fileMimeType = file.type;
-    // 提取副檔名（含 .，且轉小寫）
-    const fileExt = file.name.includes('.') ? `.${file.name.split('.').pop().toLowerCase()}` : '';
-    return accepts.some((accept)=>{
-        if (accept.startsWith('.')) {
-            // 以副檔名檢查，忽略大小寫
-            return fileExt === accept.toLowerCase();
-        }
-        if (accept === fileMimeType) {
-            return true;
-        }
-        if (accept.endsWith('/*')) {
-            return accept.split('/')[0] === fileMimeType.split('/')[0];
-        }
-        return false;
-    });
-};
-/**
- * 根據檔案副檔名取得對應的 MIME Type
- *
- * 目前支援的副檔名有：pdf, csv, jpeg, jpg, png, zip, txt
- * 除此之外的副檔名皆回傳 application/octet-stream
- *
- * @param fileExtension 檔案副檔名
- *
- * @example
- *
- * getMimeType('pdf') // 'application/pdf'
- * getMimeType('csv') // 'text/csv'
- * getMimeType('jpeg') // 'image/jpeg'
- * getMimeType('jpg') // 'image/jpeg'
- * getMimeType('png') // 'image/png'
- * getMimeType('txt') // 'text/plain'
- * getMimeType('zip') // 'application/zip'
- * getMimeType('mp4') // 'application/octet-stream'
- * getMimeType('xls') // 'application/vnd.ms-excel'
- * getMimeType('xlsx') // 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
- * getMimeType('doc') // 'application/msword'
- * getMimeType('docx') // 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
- *
- * @deprecated use `parseFileInfoFromFilename` instead
- */ const getMimeType = (fileName)=>{
-    const ext = (fileName.split('.').pop() || '').toLowerCase();
-    return MimeTypeMap[ext] ?? OtherMimeType;
-};
-/**
- * 用來解析後端在 response header content-disposition 的內容
- *
- * 一般來說格式會有以下兩種
- *
- * - Content-Disposition: attachment; filename="file name.jpg"
- * - Content-Disposition: attachment; filename*=UTF-8''file%20name2.jpg
- *
- * 如果格式正確就會取得檔案名稱(包含副檔名)，優先取 filename* 內的內容
- *
- * @param disposition Content-Disposition
- *
- * @example
- *
- * parseFilenameFromDisposition('attachment; filename="file name1.jpg') // file name.jpg
- * parseFilenameFromDisposition('attachment; filename*=UTF-8''file%20name2.jpg') // file name2.jpg
- * parseFilenameFromDisposition('attachment; filename="file name.jpg; filename*=UTF-8''file%20name2.jpg') // file name2.jpg
- */ const parseFilenameFromDisposition = (disposition)=>{
-    // 1. 先找 filename*
-    const filenameStarMatch = disposition.match(/filename\*\s*=\s*(?:UTF-8'')?([^;]+)/i);
-    if (filenameStarMatch && filenameStarMatch[1]) {
-        // 依 RFC 5987 格式（UTF-8''URL-ENCODED），要先 decode
-        try {
-            return decodeURIComponent(filenameStarMatch[1].replace(/(^['"]|['"]$)/g, ''));
-        } catch  {
-            // fallback，如果 decode 失敗，直接傳回原值
-            return filenameStarMatch[1];
-        }
-    }
-    // 2. 沒有 filename*，再找 filename
-    const filenameMatch = disposition.match(/filename\s*=\s*("?)([^";]+)\1/i);
-    if (filenameMatch && filenameMatch[2]) {
-        return filenameMatch[2];
-    }
-    // 3. 都沒有則 undefined
-    return undefined;
-};
-/**
- * 解析 `filename` 回傳檔名、副檔名、MIME type
- *
- * @param filename 檔案名稱
- *
- * @example
- *
- * parseFileInfoFromFilename('image.jpg') // ['image', 'jpg', 'image/jpeg']
- * parseFileInfoFromFilename('image') // ['image', '', 'application/octet-stream']
- */ const parseFileInfoFromFilename = (filename)=>{
-    const lastDot = filename.lastIndexOf('.');
-    if (lastDot === -1) return [
-        filename,
-        '',
-        OtherMimeType
-    ]; // 沒有副檔名
-    return [
-        filename.slice(0, lastDot),
-        filename.slice(lastDot + 1),
-        MimeTypeMap[filename.slice(lastDot + 1)] ?? OtherMimeType
-    ];
-};
-
-// const isProduction: boolean = process.env.NODE_ENV === 'production';
-const prefix = 'Invariant failed';
-// Throw an error if the condition fails
-// Strip out error messages for production
-// > Not providing an inline default argument for message as the result is smaller
-function invariant(condition, // Can provide a string, or a function that returns a string for cases where
-// the message takes a fair amount of effort to compute
-message) {
-    if (condition) {
-        return;
-    }
-    // Condition not passed
-    // In production we strip the message but still throw
-    if (process.env.NODE_ENV === 'production') {
-        throw new Error(prefix);
-    }
-    // When not in production we allow the message to pass through
-    // *This block will be removed in production builds*
-    const provided = typeof message === 'function' ? message() : message;
-    // Options:
-    // 1. message provided: `${prefix}: ${provided}`
-    // 2. message not provided: prefix
-    const value = provided ? `${prefix}: ${provided}` : prefix;
-    throw new Error(value);
-}
-
-/**
- * 判斷執行環境是否為 Server(node.js) 端
- */ const isServer = ()=>typeof window === 'undefined';
-
-/**
- * 將物件中的某些 key 排除
- *
- * @param object 原始物件
- * @param keys 要排除的 key
- *
- * @example
- * const a = { a: 1, b: 2, c: 3, d: 4 };
- * const b = omit(a, 'a', 'b'); // { c: 3, d: 4 }
- */ const omit = (object, ...keys)=>Object.keys(object).reduce((acc, cur)=>{
-        if (keys.includes(cur)) {
-            return acc;
-        }
-        return {
-            ...acc,
-            [cur]: object[cur]
-        };
-    }, {});
-/**
- * 將物件中的某些 value 排除
- *
- * @param object 原始物件
- * @param values 要排除的 value
- *
- * @example
- * const a = { a: undefined, b: null, c: 3, d: 4, e: [] };
- * const b = omitByValue(a, undefined, null, []); // { c: 3, d: 4 }
- */ const omitByValue = (object, ...values)=>Object.entries(object).reduce((acc, [key, value])=>{
-        // 使用深度比較檢查值是否應該被排除
-        const shouldOmit = values.some((excludeValue)=>isEqual(value, excludeValue));
-        if (shouldOmit) {
-            return acc;
-        }
-        return {
-            ...acc,
-            [key]: value
-        };
-    }, {});
-/**
- * extract the object fields by the given keys
- *
- * @param object - the object to pick fields from
- * @param keys - the keys to pick
- *
- * @example
- *
- * const a = { a: 1, b: 2, c: 3, d: 4 };
- * const b = pick(a, 'a', 'b'); // { a: 1, b: 2 }
- */ const pick = (object, ...keys)=>keys.reduce((acc, cur)=>({
-            ...acc,
-            [cur]: object[cur]
-        }), {});
-/**
- * extract the object fields by the given values
- *
- * @param object - the object to pick fields from
- * @param values - the values to pick
- *
- * @example
- *
- * const a = { a: 1, b: 2, c: 3, d: 4, e: [] };
- * const b = pickByValue(a, 1, 2, []); // { a: 1, b: 2, e: [] }
- */ const pickByValue = (object, ...values)=>Object.entries(object).reduce((acc, [key, value])=>{
-        // 使用深度比較檢查值是否應該被選擇
-        const shouldPick = values.some((pickValue)=>isEqual(value, pickValue));
-        if (shouldPick) {
-            return {
-                ...acc,
-                [key]: value
-            };
-        }
-        return acc;
-    }, {});
-const isObject = (value)=>value !== null && typeof value === 'object';
-/**
- * merge two objects deeply
- *
- * @param target - the target object
- * @param source - the source object
- *
- * @example
- *
- * const obja = { a: { a1: { a11: 'value 1', a12: 'value 2' }, a2: 'value 3' }, b: 'value 4' };
- * const objb = { a: { a1: { a13: 'value 5', a14: 'value 6' }, a3: 'value 7' }};
- *
- * const mergeResult = deepMerge(obja, objb); // { a: { a1: { a11: 'value 1', a12: 'value 2', a13: 'value 5', a14: 'value 6' }, a2: 'value 3', a3: 'value 7' }, b: 'value 4' }
- *
- */ const deepMerge = (target, source)=>Object.entries(source).reduce((acc, [key, value])=>{
-        if (isObject(value)) {
-            acc[key] = key in target && isObject(target[key]) ? deepMerge(target[key], value) : value;
-        } else {
-            acc[key] = value;
-        }
-        return acc;
-    }, {
-        ...target
-    });
-/**
- * A utility function to deeply clone an object.
- * @param obj - The object to clone.
- *
- * @example
- *
- * const original = { a: 1, b: { c: 2 } };
- * const cloned = deepClone(original);
- * console.log(cloned); // { a: 1, b: { c: 2 } }
- *
- */ const deepClone = (obj)=>{
-    if (obj === null || typeof obj !== 'object') {
-        return obj;
-    }
-    if (obj instanceof Date) {
-        return new Date(obj.getTime());
-    }
-    if (Array.isArray(obj)) {
-        return obj.map((item)=>deepClone(item));
-    }
-    const cloned = Object.keys(obj).reduce((acc, key)=>{
-        acc[key] = deepClone(obj[key]);
-        return acc;
-    }, {});
-    return cloned;
-};
-/**
- * A utility function to rename a key in an object.
- *
- * @param obj - The object to modify.
- * @param oldKey - The key to rename.
- * @param newKey - The new key name.
- *
- * @example
- *
- * const obj = { a: 1, b: 2 };
- * const newObj = renameKey(obj, 'a', 'c');
- * console.log(newObj); // { c: 1, b: 2 }
- */ const renameKey = (obj, oldKey, newKey)=>{
-    // 建立一個淺拷貝，避免修改原始物件
-    const { [oldKey]: oldValue, ...rest } = obj;
-    // 回傳新的物件：用新 key 存舊值，其他 key 保留
-    return {
-        ...rest,
-        [newKey]: oldValue
-    };
-};
-
-/**
- * 將嵌套物件的所有屬性設為指定的布林值
- * @param obj - 目標物件
- * @param boolValue - 布林值
- *
- * @example
- * const obj = { a: { b: 1, c: 2 }, d: 3 };
- * const result = setBooleanToNestedObject(obj, true);
- * console.log(result); // { a: { b: true, c: true }, d: true }
- */ const setBooleanToNestedObject = (obj, boolValue)=>Object.entries(obj).reduce((acc, [key, value])=>{
-        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
-            // 如果是嵌套物件，遞歸處理
-            acc[key] = setBooleanToNestedObject(value, boolValue);
-        } else {
-            // 如果是基本類型，設為布林值
-            acc[key] = boolValue;
-        }
-        return acc;
-    }, {});
-/**
- * 深度合併配置物件的通用工具
- *
- * @param defaultConfig - 預設配置
- * @param customConfig - 自訂配置
- *
- * @example
- * const defaultConfig = { a: true, b: { b1: true, b2: true, b3: false }, c: true, d: false };
- * mergeConfig(defaultConfig, { b: { b1: false }, d: true }); // { a: true, b: { b1: false, b2: true, b3: false }, c: true, d: true }
- * mergeConfig(defaultConfig, { b: false }); // { a: true, b: { b1: false, b2: false, b3: false }, c: true, d: false }
- * mergeConfig(defaultConfig, { b: true }); // { a: true, b: { b1: true, b2: true, b3: true }, c: true, d: false }
- */ const mergeConfig = (defaultConfig, customConfig = {})=>{
-    // 深拷貝預設配置以避免修改原始物件
-    const result = deepClone(defaultConfig);
-    return Object.entries(customConfig).reduce((acc, [key, sourceValue])=>{
-        const targetValue = acc[key];
-        // 如果來源值為 null 或 undefined，跳過
-        if (sourceValue === null || sourceValue === undefined) {
-            return acc;
-        }
-        // 如果目標物件中對應的值是物件，且來源值是布林值
-        // 這是特殊情況：用布林值覆蓋整個嵌套物件
-        if (typeof targetValue === 'object' && targetValue !== null && !Array.isArray(targetValue) && typeof sourceValue === 'boolean') {
-            // 將嵌套物件的所有屬性設為該布林值
-            acc[key] = setBooleanToNestedObject(targetValue, sourceValue);
-        } else if (typeof targetValue === 'object' && targetValue !== null && !Array.isArray(targetValue) && typeof sourceValue === 'object' && sourceValue !== null && !Array.isArray(sourceValue)) {
-            acc[key] = mergeConfig(targetValue, sourceValue);
-        } else {
-            acc[key] = sourceValue;
-        }
-        return acc;
-    }, result);
-};
-
-/**
- * debounce function
- *
- * @param {Function} fn function to be executed
- * @param {number} delay time to wait before executing the function
- *
- * @example
- * const debouncedFunction = debounce((a: number, b: number) => console.log(a + b), 1000);
- * debouncedFunction(1, 2);
- * debouncedFunction(3, 4);
- * // after 1 second
- * // 7
- */ const debounce = (fn, delay)=>{
-    let timeout;
-    // if (isAsync) {
-    //   return (...args: P[]) =>
-    //     new Promise((resolve) => {
-    //       if (timeout) {
-    //         clearTimeout(timeout);
-    //       }
-    //       timeout = setTimeout(() => {
-    //         resolve(fn(...args));
-    //       }, delay);
-    //     });
-    // }
-    return (...args)=>{
-        if (timeout) {
-            clearTimeout(timeout);
-        }
-        timeout = setTimeout(()=>{
-            fn(...args);
-        }, delay);
-    };
-};
-/**
- * throttle function
- *
- * @param {Function} fn function to be executed
- * @param {number} delay time to wait before executing the function
- *
- * @example
- * const throttledFunction = throttle((a: number, b: number) => a + b, 1000);
- * throttledFunction(1, 2); // 3
- * throttledFunction(3, 4); // undefined
- * setTimeout(() => {
- *  throttledFunction(5, 6); // 11
- * }, 2000);
- */ const throttle = (fn, delay)=>{
-    let wait = false;
-    return (...args)=>{
-        if (wait) return undefined;
-        const val = fn(...args);
-        wait = true;
-        setTimeout(()=>{
-            wait = false;
-        }, delay);
-        return val;
-    };
-};
-
-/**
- * Wait for a given amount of time
- * @param ms time to wait in milliseconds
- */ const wait = (ms)=>{
-};
-
-/**
- * 將單層物件轉換為 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'
- */ const objectToSearchParams = (obj)=>{
-    const searchParams = new URLSearchParams();
-    if (!obj || typeof obj !== 'object' || Array.isArray(obj)) {
-        return searchParams;
-    }
-    Object.entries(omitByValue(obj, undefined, null, '', [])).forEach(([key, value])=>{
-        // 如果是陣列，則以逗號連接
-        const paramValue = Array.isArray(value) ? value.join(',') : String(value);
-        searchParams.append(key, paramValue);
-    });
-    return searchParams;
-};
-/**
- * 將字串值轉換為指定的型別
- *
- * @param value - 要轉換的字串值
- * @param targetType - 目標型別
- * @returns 轉換後的值
- */ const convertValueByType = (value, targetType)=>{
-    switch(targetType){
-        case 'number':
-            return value ? Number(value) : 0;
-        case 'boolean':
-            return value === 'true' || value === '1';
-        case 'array':
-            return value ? value.split(',') : [];
-        case 'string':
-        default:
-            // 預設為字串，不需要轉換
-            return value;
-    }
-};
-/**
- * 將 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 }
- */ const searchParamsToObject = (searchParams, typeMap = {})=>{
-    const searchParamsInstance = typeof searchParams === 'string' ? new URLSearchParams(searchParams) : searchParams;
-    const result = {};
-    // 從 URLSearchParams 取得所有參數
-    searchParamsInstance.forEach((value, key)=>{
-        if (!key) {
-            return;
-        }
-        const targetType = typeMap[key];
-        result[key] = convertValueByType(value, targetType);
-    });
-    return result;
-};
-
 /**
  * convert CamelCase string to PascalCase string
  * @param str the string to convert
@@ -1421,77 +677,81 @@ function mergeRefs(refs) {
     return dayjs__default.default(endMonth, 'YYYYMM').subtract(1911, 'year').format('YYYYMM').substring(1);
 };
 
+exports.ByteSize = webStorage12s.ByteSize;
+exports.MimeTypeMap = webStorage12s.MimeTypeMap;
+exports.OtherMimeType = webStorage12s.OtherMimeType;
+exports.convertBytes = webStorage12s.convertBytes;
+exports.createEnumLikeObject = webStorage12s.createEnumLikeObject;
+exports.debounce = webStorage12s.debounce;
+exports.decodeBase64 = webStorage12s.decodeBase64;
+exports.decodeJson = webStorage12s.decodeJson;
+exports.deepClone = webStorage12s.deepClone;
+exports.deepMerge = webStorage12s.deepMerge;
+exports.encodeBase64 = webStorage12s.encodeBase64;
+exports.encodeJson = webStorage12s.encodeJson;
+exports.extractEnumLikeObject = webStorage12s.extractEnumLikeObject;
+exports.fakeApi = webStorage12s.fakeApi;
+exports.getLocalStorage = webStorage12s.getLocalStorage;
+exports.getMimeType = webStorage12s.getMimeType;
+exports.invariant = webStorage12s.invariant;
+exports.isEqual = webStorage12s.isEqual;
+exports.isServer = webStorage12s.isServer;
+exports.mergeConfig = webStorage12s.mergeConfig;
+exports.objectToSearchParams = webStorage12s.objectToSearchParams;
+exports.omit = webStorage12s.omit;
+exports.omitByValue = webStorage12s.omitByValue;
+exports.parseFileInfoFromFilename = webStorage12s.parseFileInfoFromFilename;
+exports.parseFilenameFromDisposition = webStorage12s.parseFilenameFromDisposition;
+exports.pick = webStorage12s.pick;
+exports.pickByValue = webStorage12s.pickByValue;
+exports.renameKey = webStorage12s.renameKey;
+exports.searchParamsToObject = webStorage12s.searchParamsToObject;
+exports.setLocalStorage = webStorage12s.setLocalStorage;
+exports.throttle = webStorage12s.throttle;
+exports.validateFileType = webStorage12s.validateFileType;
+exports.wait = webStorage12s.wait;
 exports.QueryProvider = queryStore12s.QueryProvider;
 exports.useQueryContext = queryStore12s.useQueryContext;
 exports.useCountdown = useCountdown12s.useCountdown;
 exports.useDisclosure = useDisclosure12s.useDisclosure;
 exports.downloadFile = download12s.downloadFile;
-exports.getLocalStorage = webStorage12s.getLocalStorage;
-exports.setLocalStorage = webStorage12s.setLocalStorage;
-exports.ByteSize = ByteSize;
-exports.MimeTypeMap = MimeTypeMap;
-exports.OtherMimeType = OtherMimeType;
 exports.adToRocEra = adToRocEra;
 exports.camelCase2PascalCase = camelCase2PascalCase;
 exports.camelCase2SnakeCase = camelCase2SnakeCase;
 exports.camelString2PascalString = camelString2PascalString;
 exports.camelString2SnakeString = camelString2SnakeString;
-exports.convertBytes = convertBytes;
 exports.createDataContext = createDataContext;
-exports.createEnumLikeObject = createEnumLikeObject;
-exports.debounce = debounce;
-exports.deepClone = deepClone;
-exports.deepMerge = deepMerge;
-exports.extractEnumLikeObject = extractEnumLikeObject;
-exports.fakeApi = fakeApi;
 exports.formatAmount = formatAmount;
 exports.formatBytes = formatBytes;
 exports.formatStarMask = formatStarMask;
 exports.generatePeriodArray = generatePeriodArray;
 exports.getCurrentPeriod = getCurrentPeriod;
-exports.getMimeType = getMimeType;
-exports.invariant = invariant;
 exports.isChinese = isChinese;
 exports.isDateString = isDateString;
 exports.isDateTimeString = isDateTimeString;
 exports.isEmail = isEmail;
 exports.isEnglish = isEnglish;
-exports.isEqual = isEqual;
 exports.isNil = isNil;
 exports.isNonZeroStart = isNonZeroStart;
 exports.isNumber = isNumber;
 exports.isNumberAtLeastN = isNumberAtLeastN;
 exports.isNumberN = isNumberN;
 exports.isNumberNM = isNumberNM;
-exports.isServer = isServer;
 exports.isTWMobile = isTWMobile;
 exports.isTWPhone = isTWPhone;
 exports.isTimeString = isTimeString;
 exports.isValidPassword = isValidPassword;
 exports.maskString = maskString;
-exports.mergeConfig = mergeConfig;
 exports.mergeRefs = mergeRefs;
-exports.objectToSearchParams = objectToSearchParams;
-exports.omit = omit;
-exports.omitByValue = omitByValue;
-exports.parseFileInfoFromFilename = parseFileInfoFromFilename;
-exports.parseFilenameFromDisposition = parseFilenameFromDisposition;
 exports.pascalCase2CamelCase = pascalCase2CamelCase;
 exports.pascalCase2SnakeCase = pascalCase2SnakeCase;
 exports.pascalString2CamelString = pascalString2CamelString;
 exports.pascalString2SnakeString = pascalString2SnakeString;
-exports.pick = pick;
-exports.pickByValue = pickByValue;
-exports.renameKey = renameKey;
 exports.rocEraToAd = rocEraToAd;
-exports.searchParamsToObject = searchParamsToObject;
 exports.snakeCase2CamelCase = snakeCase2CamelCase;
 exports.snakeCase2PascalCase = snakeCase2PascalCase;
 exports.snakeString2CamelString = snakeString2CamelString;
 exports.snakeString2PascalString = snakeString2PascalString;
-exports.throttle = throttle;
 exports.useValue = useValue;
 exports.validTaxId = validTaxId;
 exports.validateDateString = validateDateString;
-exports.validateFileType = validateFileType;
-exports.wait = wait;