kk-vue-hooks 1.0.3 → 1.0.7

package/dist/index.cjs.js

@@ -1,5 +1,107 @@
 'use strict';
 
+var vue = require('vue');
+
+/*
+ * @Author: 你的名字
+ * @LastEditors: 你的名字
+ * @Description: Blob流导出工具，用于处理后端返回的文件流并触发下载
+ */
+// 从响应头获取文件名
+function getFileNameFromHeader(headers, defaultName) {
+    if (!headers)
+        return defaultName;
+    // 处理不同可能的header键名（考虑大小写）
+    const contentDisposition = headers['content-disposition']
+        || headers['Content-Disposition']
+        || '';
+    if (!contentDisposition)
+        return defaultName;
+    // 匹配文件名（处理带引号和不带引号的情况）
+    const match = contentDisposition.match(/filename=("([^"]+)"|([^;]+))/i);
+    if (match) {
+        // 优先取带引号的内容，没有则取普通内容
+        const fileName = match[2] || match[3];
+        if (fileName) {
+            return decodeURIComponent(fileName);
+        }
+    }
+    return defaultName;
+}
+// 验证Blob对象有效性
+function isValidBlob(blob) {
+    return blob !== null && blob !== undefined && blob instanceof Blob;
+}
+// 处理Blob流并下载
+function useBlobExport() {
+    // 导出状态
+    const isExporting = vue.ref(false);
+    // 核心导出方法
+    const exportFromBlob = (blob, headers, defaultFileName) => {
+        try {
+            // 验证Blob对象有效性
+            if (!isValidBlob(blob)) {
+                console.error('无效的Blob对象，无法导出:', blob);
+                return false;
+            }
+            // 验证Blob大小，避免空文件
+            if (blob.size <= 0) {
+                console.error('Blob内容为空，无法导出');
+                return false;
+            }
+            isExporting.value = true;
+            // 生成默认文件名
+            const baseName = defaultFileName || `导出文件_${new Date().toLocaleDateString().replace(/\//g, '-')}`;
+            // 从响应头获取文件名（如果有）
+            const fileName = getFileNameFromHeader(headers || {}, baseName);
+            // 创建下载链接
+            const url = window.URL.createObjectURL(blob);
+            const a = document.createElement('a');
+            a.href = url;
+            a.download = fileName;
+            // 触发下载
+            document.body.appendChild(a);
+            a.click();
+            // 清理资源 - 使用更合理的延迟时间
+            setTimeout(() => {
+                document.body.removeChild(a);
+                window.URL.revokeObjectURL(url);
+                isExporting.value = false;
+            }, 500); // 延长延迟确保下载完成
+            return true;
+        }
+        catch (error) {
+            console.error('文件导出失败:', error);
+            isExporting.value = false;
+            return false;
+        }
+    };
+    // 处理可能的JSON错误流（后端可能在错误时返回JSON格式的错误信息）
+    const handleErrorBlob = async (blob) => {
+        // 先验证Blob有效性
+        if (!isValidBlob(blob)) {
+            return '无效的错误信息格式';
+        }
+        try {
+            // 将Blob转换为文本
+            const text = await new Response(blob).text();
+            // 尝试解析为JSON
+            const jsonData = JSON.parse(text);
+            // 返回错误信息
+            return jsonData.message || '导出失败，请重试';
+        }
+        catch (error) {
+            // 不是JSON格式，可能是其他错误
+            return '导出文件格式错误';
+        }
+    };
+    return {
+        isExporting,
+        exportFromBlob,
+        handleErrorBlob,
+    };
+}
+
 // src/hooks/useStorage.ts
 /**
  * 本地存储 Hook（localStorage 封装）
@@ -44,5 +146,6 @@ function useStorage(key, defaultValue) {
     };
 }
 
+exports.useBlobExport = useBlobExport;
 exports.useStorage = useStorage;
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":["../src/hooks/useStorage.ts"],"sourcesContent":["// src/hooks/useStorage.ts\n/**\n * 本地存储 Hook（localStorage 封装）\n * @param key 存储键名\n * @param defaultValue 默认值\n * @returns 获取值、设置值、删除值的方法\n */\nexport function useStorage<T>(key: string, defaultValue: T) {\n  // 获取存储值\n  const getStorage = (): T => {\n    try {\n      const value = localStorage.getItem(key)\n      return value ? JSON.parse(value) : defaultValue\n    }\n    catch (error) {\n      console.error('获取本地存储失败：', error)\n      return defaultValue\n    }\n  }\n\n  // 设置存储值\n  const setStorage = (value: T) => {\n    try {\n      localStorage.setItem(key, JSON.stringify(value))\n    }\n    catch (error) {\n      console.error('设置本地存储失败：', error)\n    }\n  }\n\n  // 删除存储值\n  const removeStorage = () => {\n    try {\n      localStorage.removeItem(key)\n    }\n    catch (error) {\n      console.error('删除本地存储失败：', error)\n    }\n  }\n\n  return {\n    value: getStorage(),\n    setStorage,\n    removeStorage,\n  }\n}\n"],"names":[],"mappings":";;AAAA;AACA;;;;;AAKG;AACG,SAAU,UAAU,CAAI,GAAW,EAAE,YAAe,EAAA;;IAExD,MAAM,UAAU,GAAG,MAAQ;AACzB,QAAA,IAAI;YACF,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC;AACvC,YAAA,OAAO,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,YAAY;QACjD;QACA,OAAO,KAAK,EAAE;AACZ,YAAA,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC;AACjC,YAAA,OAAO,YAAY;QACrB;AACF,IAAA,CAAC;;AAGD,IAAA,MAAM,UAAU,GAAG,CAAC,KAAQ,KAAI;AAC9B,QAAA,IAAI;AACF,YAAA,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClD;QACA,OAAO,KAAK,EAAE;AACZ,YAAA,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC;QACnC;AACF,IAAA,CAAC;;IAGD,MAAM,aAAa,GAAG,MAAK;AACzB,QAAA,IAAI;AACF,YAAA,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC;QAC9B;QACA,OAAO,KAAK,EAAE;AACZ,YAAA,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC;QACnC;AACF,IAAA,CAAC;IAED,OAAO;QACL,KAAK,EAAE,UAAU,EAAE;QACnB,UAAU;QACV,aAAa;KACd;AACH;;;;"}
+{"version":3,"file":"index.cjs.js","sources":["../src/hooks/useBlobExport.ts","../src/hooks/useStorage.ts"],"sourcesContent":["/*\n * @Author: 你的名字\n * @LastEditors: 你的名字\n * @Description: Blob流导出工具，用于处理后端返回的文件流并触发下载\n */\nimport { ref } from 'vue'\n\n// 从响应头获取文件名\nfunction getFileNameFromHeader(headers: Record<string, string>, defaultName: string): string {\n  if (!headers)\n    return defaultName\n\n  // 处理不同可能的header键名（考虑大小写）\n  const contentDisposition = headers['content-disposition']\n    || headers['Content-Disposition']\n    || ''\n\n  if (!contentDisposition)\n    return defaultName\n\n  // 匹配文件名（处理带引号和不带引号的情况）\n  const match = contentDisposition.match(/filename=(\"([^\"]+)\"|([^;]+))/i)\n  if (match) {\n    // 优先取带引号的内容，没有则取普通内容\n    const fileName = match[2] || match[3]\n    if (fileName) {\n      return decodeURIComponent(fileName)\n    }\n  }\n\n  return defaultName\n}\n\n// 验证Blob对象有效性\nfunction isValidBlob(blob: unknown): blob is Blob {\n  return blob !== null && blob !== undefined && blob instanceof Blob\n}\n\n// 处理Blob流并下载\nexport function useBlobExport() {\n  // 导出状态\n  const isExporting = ref(false)\n\n  // 核心导出方法\n  const exportFromBlob = (\n    blob: Blob,\n    headers?: Record<string, string>,\n    defaultFileName?: string,\n  ): boolean => {\n    try {\n      // 验证Blob对象有效性\n      if (!isValidBlob(blob)) {\n        console.error('无效的Blob对象，无法导出:', blob)\n        return false\n      }\n\n      // 验证Blob大小，避免空文件\n      if (blob.size <= 0) {\n        console.error('Blob内容为空，无法导出')\n        return false\n      }\n\n      isExporting.value = true\n\n      // 生成默认文件名\n      const baseName = defaultFileName || `导出文件_${new Date().toLocaleDateString().replace(/\\//g, '-')}`\n\n      // 从响应头获取文件名（如果有）\n      const fileName = getFileNameFromHeader(headers || {}, baseName)\n\n      // 创建下载链接\n      const url = window.URL.createObjectURL(blob)\n      const a = document.createElement('a')\n\n      a.href = url\n      a.download = fileName\n\n      // 触发下载\n      document.body.appendChild(a)\n      a.click()\n\n      // 清理资源 - 使用更合理的延迟时间\n      setTimeout(() => {\n        document.body.removeChild(a)\n        window.URL.revokeObjectURL(url)\n        isExporting.value = false\n      }, 500) // 延长延迟确保下载完成\n\n      return true\n    }\n    catch (error) {\n      console.error('文件导出失败:', error)\n      isExporting.value = false\n      return false\n    }\n  }\n\n  // 处理可能的JSON错误流（后端可能在错误时返回JSON格式的错误信息）\n  const handleErrorBlob = async (blob: Blob): Promise<string | null> => {\n    // 先验证Blob有效性\n    if (!isValidBlob(blob)) {\n      return '无效的错误信息格式'\n    }\n\n    try {\n      // 将Blob转换为文本\n      const text = await new Response(blob).text()\n\n      // 尝试解析为JSON\n      const jsonData = JSON.parse(text)\n\n      // 返回错误信息\n      return jsonData.message || '导出失败，请重试'\n    }\n    catch (error) {\n      // 不是JSON格式，可能是其他错误\n      return '导出文件格式错误'\n    }\n  }\n\n  return {\n    isExporting,\n    exportFromBlob,\n    handleErrorBlob,\n  }\n}\n","// src/hooks/useStorage.ts\n/**\n * 本地存储 Hook（localStorage 封装）\n * @param key 存储键名\n * @param defaultValue 默认值\n * @returns 获取值、设置值、删除值的方法\n */\nexport function useStorage<T>(key: string, defaultValue: T) {\n  // 获取存储值\n  const getStorage = (): T => {\n    try {\n      const value = localStorage.getItem(key)\n      return value ? JSON.parse(value) : defaultValue\n    }\n    catch (error) {\n      console.error('获取本地存储失败：', error)\n      return defaultValue\n    }\n  }\n\n  // 设置存储值\n  const setStorage = (value: T) => {\n    try {\n      localStorage.setItem(key, JSON.stringify(value))\n    }\n    catch (error) {\n      console.error('设置本地存储失败：', error)\n    }\n  }\n\n  // 删除存储值\n  const removeStorage = () => {\n    try {\n      localStorage.removeItem(key)\n    }\n    catch (error) {\n      console.error('删除本地存储失败：', error)\n    }\n  }\n\n  return {\n    value: getStorage(),\n    setStorage,\n    removeStorage,\n  }\n}\n"],"names":["ref"],"mappings":"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"}

package/dist/index.esm.js

@@ -1,3 +1,105 @@
+import { ref } from 'vue';
+
+/*
+ * @Author: 你的名字
+ * @LastEditors: 你的名字
+ * @Description: Blob流导出工具，用于处理后端返回的文件流并触发下载
+ */
+// 从响应头获取文件名
+function getFileNameFromHeader(headers, defaultName) {
+    if (!headers)
+        return defaultName;
+    // 处理不同可能的header键名（考虑大小写）
+    const contentDisposition = headers['content-disposition']
+        || headers['Content-Disposition']
+        || '';
+    if (!contentDisposition)
+        return defaultName;
+    // 匹配文件名（处理带引号和不带引号的情况）
+    const match = contentDisposition.match(/filename=("([^"]+)"|([^;]+))/i);
+    if (match) {
+        // 优先取带引号的内容，没有则取普通内容
+        const fileName = match[2] || match[3];
+        if (fileName) {
+            return decodeURIComponent(fileName);
+        }
+    }
+    return defaultName;
+}
+// 验证Blob对象有效性
+function isValidBlob(blob) {
+    return blob !== null && blob !== undefined && blob instanceof Blob;
+}
+// 处理Blob流并下载
+function useBlobExport() {
+    // 导出状态
+    const isExporting = ref(false);
+    // 核心导出方法
+    const exportFromBlob = (blob, headers, defaultFileName) => {
+        try {
+            // 验证Blob对象有效性
+            if (!isValidBlob(blob)) {
+                console.error('无效的Blob对象，无法导出:', blob);
+                return false;
+            }
+            // 验证Blob大小，避免空文件
+            if (blob.size <= 0) {
+                console.error('Blob内容为空，无法导出');
+                return false;
+            }
+            isExporting.value = true;
+            // 生成默认文件名
+            const baseName = defaultFileName || `导出文件_${new Date().toLocaleDateString().replace(/\//g, '-')}`;
+            // 从响应头获取文件名（如果有）
+            const fileName = getFileNameFromHeader(headers || {}, baseName);
+            // 创建下载链接
+            const url = window.URL.createObjectURL(blob);
+            const a = document.createElement('a');
+            a.href = url;
+            a.download = fileName;
+            // 触发下载
+            document.body.appendChild(a);
+            a.click();
+            // 清理资源 - 使用更合理的延迟时间
+            setTimeout(() => {
+                document.body.removeChild(a);
+                window.URL.revokeObjectURL(url);
+                isExporting.value = false;
+            }, 500); // 延长延迟确保下载完成
+            return true;
+        }
+        catch (error) {
+            console.error('文件导出失败:', error);
+            isExporting.value = false;
+            return false;
+        }
+    };
+    // 处理可能的JSON错误流（后端可能在错误时返回JSON格式的错误信息）
+    const handleErrorBlob = async (blob) => {
+        // 先验证Blob有效性
+        if (!isValidBlob(blob)) {
+            return '无效的错误信息格式';
+        }
+        try {
+            // 将Blob转换为文本
+            const text = await new Response(blob).text();
+            // 尝试解析为JSON
+            const jsonData = JSON.parse(text);
+            // 返回错误信息
+            return jsonData.message || '导出失败，请重试';
+        }
+        catch (error) {
+            // 不是JSON格式，可能是其他错误
+            return '导出文件格式错误';
+        }
+    };
+    return {
+        isExporting,
+        exportFromBlob,
+        handleErrorBlob,
+    };
+}
+
 // src/hooks/useStorage.ts
 /**
  * 本地存储 Hook（localStorage 封装）
@@ -42,5 +144,5 @@ function useStorage(key, defaultValue) {
     };
 }
 
-export { useStorage };
+export { useBlobExport, useStorage };
 //# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":["../src/hooks/useStorage.ts"],"sourcesContent":["// src/hooks/useStorage.ts\n/**\n * 本地存储 Hook（localStorage 封装）\n * @param key 存储键名\n * @param defaultValue 默认值\n * @returns 获取值、设置值、删除值的方法\n */\nexport function useStorage<T>(key: string, defaultValue: T) {\n  // 获取存储值\n  const getStorage = (): T => {\n    try {\n      const value = localStorage.getItem(key)\n      return value ? JSON.parse(value) : defaultValue\n    }\n    catch (error) {\n      console.error('获取本地存储失败：', error)\n      return defaultValue\n    }\n  }\n\n  // 设置存储值\n  const setStorage = (value: T) => {\n    try {\n      localStorage.setItem(key, JSON.stringify(value))\n    }\n    catch (error) {\n      console.error('设置本地存储失败：', error)\n    }\n  }\n\n  // 删除存储值\n  const removeStorage = () => {\n    try {\n      localStorage.removeItem(key)\n    }\n    catch (error) {\n      console.error('删除本地存储失败：', error)\n    }\n  }\n\n  return {\n    value: getStorage(),\n    setStorage,\n    removeStorage,\n  }\n}\n"],"names":[],"mappings":"AAAA;AACA;;;;;AAKG;AACG,SAAU,UAAU,CAAI,GAAW,EAAE,YAAe,EAAA;;IAExD,MAAM,UAAU,GAAG,MAAQ;AACzB,QAAA,IAAI;YACF,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC;AACvC,YAAA,OAAO,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,YAAY;QACjD;QACA,OAAO,KAAK,EAAE;AACZ,YAAA,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC;AACjC,YAAA,OAAO,YAAY;QACrB;AACF,IAAA,CAAC;;AAGD,IAAA,MAAM,UAAU,GAAG,CAAC,KAAQ,KAAI;AAC9B,QAAA,IAAI;AACF,YAAA,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClD;QACA,OAAO,KAAK,EAAE;AACZ,YAAA,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC;QACnC;AACF,IAAA,CAAC;;IAGD,MAAM,aAAa,GAAG,MAAK;AACzB,QAAA,IAAI;AACF,YAAA,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC;QAC9B;QACA,OAAO,KAAK,EAAE;AACZ,YAAA,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC;QACnC;AACF,IAAA,CAAC;IAED,OAAO;QACL,KAAK,EAAE,UAAU,EAAE;QACnB,UAAU;QACV,aAAa;KACd;AACH;;;;"}
+{"version":3,"file":"index.esm.js","sources":["../src/hooks/useBlobExport.ts","../src/hooks/useStorage.ts"],"sourcesContent":["/*\n * @Author: 你的名字\n * @LastEditors: 你的名字\n * @Description: Blob流导出工具，用于处理后端返回的文件流并触发下载\n */\nimport { ref } from 'vue'\n\n// 从响应头获取文件名\nfunction getFileNameFromHeader(headers: Record<string, string>, defaultName: string): string {\n  if (!headers)\n    return defaultName\n\n  // 处理不同可能的header键名（考虑大小写）\n  const contentDisposition = headers['content-disposition']\n    || headers['Content-Disposition']\n    || ''\n\n  if (!contentDisposition)\n    return defaultName\n\n  // 匹配文件名（处理带引号和不带引号的情况）\n  const match = contentDisposition.match(/filename=(\"([^\"]+)\"|([^;]+))/i)\n  if (match) {\n    // 优先取带引号的内容，没有则取普通内容\n    const fileName = match[2] || match[3]\n    if (fileName) {\n      return decodeURIComponent(fileName)\n    }\n  }\n\n  return defaultName\n}\n\n// 验证Blob对象有效性\nfunction isValidBlob(blob: unknown): blob is Blob {\n  return blob !== null && blob !== undefined && blob instanceof Blob\n}\n\n// 处理Blob流并下载\nexport function useBlobExport() {\n  // 导出状态\n  const isExporting = ref(false)\n\n  // 核心导出方法\n  const exportFromBlob = (\n    blob: Blob,\n    headers?: Record<string, string>,\n    defaultFileName?: string,\n  ): boolean => {\n    try {\n      // 验证Blob对象有效性\n      if (!isValidBlob(blob)) {\n        console.error('无效的Blob对象，无法导出:', blob)\n        return false\n      }\n\n      // 验证Blob大小，避免空文件\n      if (blob.size <= 0) {\n        console.error('Blob内容为空，无法导出')\n        return false\n      }\n\n      isExporting.value = true\n\n      // 生成默认文件名\n      const baseName = defaultFileName || `导出文件_${new Date().toLocaleDateString().replace(/\\//g, '-')}`\n\n      // 从响应头获取文件名（如果有）\n      const fileName = getFileNameFromHeader(headers || {}, baseName)\n\n      // 创建下载链接\n      const url = window.URL.createObjectURL(blob)\n      const a = document.createElement('a')\n\n      a.href = url\n      a.download = fileName\n\n      // 触发下载\n      document.body.appendChild(a)\n      a.click()\n\n      // 清理资源 - 使用更合理的延迟时间\n      setTimeout(() => {\n        document.body.removeChild(a)\n        window.URL.revokeObjectURL(url)\n        isExporting.value = false\n      }, 500) // 延长延迟确保下载完成\n\n      return true\n    }\n    catch (error) {\n      console.error('文件导出失败:', error)\n      isExporting.value = false\n      return false\n    }\n  }\n\n  // 处理可能的JSON错误流（后端可能在错误时返回JSON格式的错误信息）\n  const handleErrorBlob = async (blob: Blob): Promise<string | null> => {\n    // 先验证Blob有效性\n    if (!isValidBlob(blob)) {\n      return '无效的错误信息格式'\n    }\n\n    try {\n      // 将Blob转换为文本\n      const text = await new Response(blob).text()\n\n      // 尝试解析为JSON\n      const jsonData = JSON.parse(text)\n\n      // 返回错误信息\n      return jsonData.message || '导出失败，请重试'\n    }\n    catch (error) {\n      // 不是JSON格式，可能是其他错误\n      return '导出文件格式错误'\n    }\n  }\n\n  return {\n    isExporting,\n    exportFromBlob,\n    handleErrorBlob,\n  }\n}\n","// src/hooks/useStorage.ts\n/**\n * 本地存储 Hook（localStorage 封装）\n * @param key 存储键名\n * @param defaultValue 默认值\n * @returns 获取值、设置值、删除值的方法\n */\nexport function useStorage<T>(key: string, defaultValue: T) {\n  // 获取存储值\n  const getStorage = (): T => {\n    try {\n      const value = localStorage.getItem(key)\n      return value ? JSON.parse(value) : defaultValue\n    }\n    catch (error) {\n      console.error('获取本地存储失败：', error)\n      return defaultValue\n    }\n  }\n\n  // 设置存储值\n  const setStorage = (value: T) => {\n    try {\n      localStorage.setItem(key, JSON.stringify(value))\n    }\n    catch (error) {\n      console.error('设置本地存储失败：', error)\n    }\n  }\n\n  // 删除存储值\n  const removeStorage = () => {\n    try {\n      localStorage.removeItem(key)\n    }\n    catch (error) {\n      console.error('删除本地存储失败：', error)\n    }\n  }\n\n  return {\n    value: getStorage(),\n    setStorage,\n    removeStorage,\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/types/hooks/index.d.ts

@@ -1 +1,2 @@
+export * from './useBlobExport';
 export * from './useStorage';

package/dist/types/hooks/useBlobExport.d.ts

@@ -0,0 +1,5 @@
+export declare function useBlobExport(): {
+    isExporting: import("vue").Ref<boolean, boolean>;
+    exportFromBlob: (blob: Blob, headers?: Record<string, string>, defaultFileName?: string) => boolean;
+    handleErrorBlob: (blob: Blob) => Promise<string | null>;
+};

package/dist/types/hooks/useDateRange.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 处理时间范围选择的公共Hook
+ * @param {object} options - 配置项
+ * @param {string} [options.startKey] - 接口所需的开始时间字段名
+ * @param {string} [options.endKey] - 接口所需的结束时间字段名
+ * @returns {object} { dateRange, formattedParams, reset }
+ */
+export declare function useDateRange(options?: {
+    startKey?: string;
+    endKey?: string;
+}): {
+    dateRange: import("vue").Ref<never[], never[]>;
+    formattedParams: import("vue").Ref<{
+        [x: string]: null;
+    }, {
+        [x: string]: null;
+    }>;
+    reset: () => void;
+};

package/dist/types/hooks/useLoading.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 通用 loading 状态管理 Hook
+ * @param {Array<string>} buttonKeys - 按钮唯一标识列表（如 ['submit', 'reset']）
+ * @returns {object} { loading, setLoading, toggleLoading }
+ * - loading: 响应式对象，存储各按钮的 loading 状态（如 { submit: true, reset: false }）
+ * - setLoading: 手动设置某个按钮的 loading 状态（key, status）
+ * - toggleLoading: 切换某个按钮的 loading 状态（key）
+ */
+export declare function useLoading(buttonKeys?: string[]): {
+    loading: {
+        value: Record<string, boolean>;
+    };
+    setLoading: (key: string, status: boolean) => void;
+    toggleLoading: (key: string) => void;
+};

package/dist/types/hooks/useRouteParams.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 路由参数处理 Hook
+ * 同时支持 params（动态路由参数）和 query（查询字符串参数）
+ */
+export declare function useRouteParams(): {
+    routeParams: import("vue").Ref<{
+        [x: string]: string | string[];
+    }, {
+        [x: string]: string | string[];
+    }>;
+    routeQuery: import("vue").Ref<{
+        [x: string]: import("vue-router").LocationQueryValue | import("vue-router").LocationQueryValue[];
+    }, {
+        [x: string]: import("vue-router").LocationQueryValue | import("vue-router").LocationQueryValue[];
+    }>;
+    getParam: <T = string>(key: string, defaultValue?: T) => T | string | undefined;
+    getQuery: <T = string>(key: string, defaultValue?: T) => T | string | undefined;
+    hasParam: (key: string) => boolean;
+    hasQuery: (key: string) => boolean;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kk-vue-hooks",
-  "version": "1.0.3",
+  "version": "1.0.7",
   "type": "module",
   "description": "自定义 Vue/React Hooks 集合",
   "main": "dist/index.cjs.js",
@@ -11,6 +11,9 @@
     "README.md",
     "LICENSE"
   ],
+  "publishConfig": {
+      "access": "public"
+  },
   "keywords": [
     "vue-hooks",
     "react-hooks",
@@ -24,10 +27,10 @@
     "lint:fix": "eslint src --ext .ts --fix",
     "lint:style": "stylelint \"src/**/*.{css,scss}\"",
     "pack:check": "npm pack",
-    "publish:pkg": "npm run lint && npm run build && npm run pack:check && npm publish",
-    "publish:patch": "npm version patch && npm run publish:pkg",
-    "publish:minor": "npm version minor && npm run publish:pkg",
-    "publish:major": "npm version major && npm run publish:pkg",
+    "publish:pkg": "npm run lint:fix && npm run build && npm run pack:check && npm publish",
+    "publish:patch": "npm version patch",
+    "publish:minor": "npm version minor",
+    "publish:major": "npm version major",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "author": "kk",
@@ -49,6 +52,7 @@
   },
   "dependencies": {
     "tslib": "^2.8.1",
-    "vue": "^3.5.26"
+    "vue": "^3.5.26",
+	"vue-router": "^4.6.4"
   }
 }