fezbox 0.0.1-security → 1.2.0

package/README.md

@@ -1,5 +1,322 @@
-# Security holding package
+# FezBox
 
-This package contained malicious code and was removed from the registry by the npm security team. A placeholder was published to ensure users are not affected in the future.
+[![npm version](https://badge.fury.io/js/fezbox.svg)](https://badge.fury.io/js/fezbox)
+[![Test Coverage](https://img.shields.io/badge/coverage-90.96%25-brightgreen.svg)]
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
 
-Please refer to www.npmjs.com/advisories?search=fezbox for more information.
+一个包含常用工具函数的 JavaScript/TypeScript 库，按功能模块分类，便于按需引入。
+
+## ✨ 特性
+
+- 📦 **模块化设计** - 支持按需引入，减少包体积
+- 🔒 **完整 TypeScript 支持** - 提供准确的类型定义
+- 🧪 **高测试覆盖率** - 102个测试用例覆盖所有核心功能
+- 🎯 **轻量级** - 仅依赖必要的 peer dependencies
+- 📚 **详细文档** - 包含完整的使用示例和 API 说明
+- 🚀 **高性能** - 优化的算法和实现
+- 🔧 **易维护** - 清晰的代码结构和完整的测试
+
+## 安装
+
+```bash
+# 使用 npm
+npm install fezbox
+
+# 使用 pnpm
+pnpm add fezbox
+
+# 使用 yarn
+yarn add fezbox
+```
+
+## 🚀 快速开始
+
+### 完整引入
+
+```typescript
+import { deepClone, formatFileSize, relativeTime, outsideClick, getQueryObject } from 'fezbox'
+
+// 深拷贝对象
+const original = { a: 1, b: { c: 2 } }
+const cloned = deepClone(original)
+
+// 格式化文件大小
+const size = formatFileSize(1048576) // "1.00 Mb"
+
+// 相对时间格式化
+const time = relativeTime(new Date(Date.now() - 3600000)) // "1小时前"
+
+// 获取所有查询参数
+const params = getQueryObject('https://example.com?id=123&name=test')
+console.log(params) // { id: '123', name: 'test' }
+
+// 外部点击监听
+const element = document.getElementById('myElement')
+const unlisten = outsideClick.listen({
+  domRefs: element,
+  handler: () => console.log('点击了外部区域')
+})
+```
+
+### 按需引入（推荐）
+
+```typescript
+// 只引入需要的模块，减少包体积
+import { deepClone } from 'fezbox/data'
+import { formatFileSize, fetchFile, uploadFileByUrl } from 'fezbox/file'
+import { relativeTime } from 'fezbox/time'
+import { getQueryParam, getQueryObject } from 'fezbox/url'
+import { decryptAES } from 'fezbox/crypto'
+import { outsideClick } from 'fezbox/dom'
+import { QRCodeScriptLoader } from 'fezbox/qr'
+import { getLocalStorage, setCookie, getSessionStorage } from 'fezbox/storage'
+```
+
+## 📚 API 文档
+
+### 📊 Data 模块
+
+深拷贝函数，基于 JSON 序列化实现，支持对象和数组的深度复制。
+
+```typescript
+import { deepClone } from 'fezbox/data'
+
+const obj = { a: 1, b: { c: 2 } }
+const cloned = deepClone(obj)
+```
+
+### 📁 File 模块
+
+文件操作相关工具，包括文件大小格式化、文件获取和上传。
+
+```typescript
+import { formatFileSize, fetchFile, uploadFileByUrl } from 'fezbox/file'
+
+// 格式化文件大小
+formatFileSize(1048576) // "1.00 Mb"
+
+// 获取文件
+const file = await fetchFile('https://example.com/image.jpg', 'image.jpg')
+
+// 上传文件
+const uploadedUrl = await uploadFileByUrl(
+  'https://example.com/image.jpg',
+  async (formData) => {
+    const response = await fetch('/upload', { method: 'POST', body: formData })
+    return await response.json()
+  }
+)
+```
+
+### ⏰ Time 模块
+
+相对时间格式化，支持多种输入格式。
+
+```typescript
+import { relativeTime } from 'fezbox/time'
+
+relativeTime(new Date()) // "刚刚"
+relativeTime(new Date(Date.now() - 3600000)) // "1小时前"
+relativeTime(new Date(Date.now() - 86400000)) // "1天前"
+```
+
+### 🔗 URL 模块
+
+URL 查询参数处理工具。
+
+```typescript
+import { getQueryObject, getQueryParam } from 'fezbox/url'
+
+// 获取所有查询参数
+const params = getQueryObject('https://example.com?id=123&name=test')
+// 返回: { id: '123', name: 'test' }
+
+// 获取单个参数
+const id = getQueryParam('id', 'https://example.com?id=123&name=test') // "123"
+```
+
+### 🔐 Crypto 模块
+
+AES 解密功能。
+
+```typescript
+import { decryptAES } from 'fezbox/crypto'
+
+const decrypted = decryptAES('encryptedData', 'my-secret-key')
+```
+
+### 🎯 DOM 模块
+
+DOM 操作相关工具。
+
+```typescript
+import { outsideClick } from 'fezbox/dom'
+
+const element = document.getElementById('dropdown')
+const unlisten = outsideClick.listen({
+  domRefs: element,
+  handler: () => {
+    console.log('点击了下拉菜单外部')
+    element.classList.remove('open')
+  }
+})
+```
+
+### 🔲 QR Code 模块
+
+二维码与 JavaScript 代码的双向转换工具，支持自动依赖管理。
+
+**特性：**
+- 🚀 **零配置启动** - 自动检测并加载缺失的依赖
+- 📊 **渐进式功能** - 根据可用依赖启用不同功能  
+- 🔐 **沙箱执行** - 安全的代码执行环境
+- 🗜️ **智能压缩** - 自动选择最优的数据压缩方案
+
+```typescript
+import { QRCodeScriptLoader } from 'fezbox/qr'
+
+// 零配置使用，依赖会自动加载
+const loader = new QRCodeScriptLoader({
+  sandbox: true,        // 沙箱模式（推荐）
+  autoCompress: true,   // 自动压缩
+  debug: true          // 调试模式
+})
+
+// 生成二维码数据
+const result = await loader.generateQRCodeData('Hello World')
+if (result.success) {
+  console.log('生成成功:', result.data)
+} else {
+  console.log('生成失败:', result.error)
+}
+
+// 检查功能可用性
+console.log('生成功能:', loader.isFeatureAvailable('generate'))
+console.log('解析功能:', loader.isFeatureAvailable('parse'))
+console.log('压缩功能:', loader.isFeatureAvailable('compress'))
+
+// 从图片解析二维码
+const code = await loader.parseQRCodeFromImageData(imageData)
+
+```
+
+### 💾 Storage 模块
+
+提供统一的本地存储解决方案，包括 localStorage、sessionStorage 和 Cookie 的操作。
+
+**特性：**
+- 统一的 API 设计
+- 自动 JSON 序列化/反序列化  
+- 过期时间支持（localStorage 和 Cookie）
+- SSR 兼容性
+- 完整的错误处理
+- TypeScript 类型安全
+
+```typescript
+import { getLocalStorage, setLocalStorage, setSessionStorage, getSessionStorage, setCookie, getCookie } from 'fezbox/storage'
+
+// localStorage 基本操作
+setLocalStorage('user', { name: 'John', age: 25 })
+const user = getLocalStorage('user')
+
+// 带过期时间的存储（1小时后过期）
+setLocalStorage('tempData', { session: 'abc123' }, { 
+  expires: Date.now() + 60 * 60 * 1000 
+})
+
+// sessionStorage 操作
+setSessionStorage('formData', { name: 'John', email: 'john@example.com' })
+const formData = getSessionStorage('formData')
+
+// Cookie 操作
+setCookie('theme', 'dark', { expires: 7, secure: true })
+const theme = getCookie('theme')
+
+// 类型安全
+interface UserInfo { id: number; name: string }
+const userInfo = getLocalStorage<UserInfo>('userInfo')
+```
+
+> 📖 **完整API文档**: [查看 docs/api/ 目录](./docs/api/) 了解每个模块的详细使用说明
+
+## 📦 依赖
+
+### 运行时依赖
+- `crypto-js` (用于加密功能)
+- `dayjs` (用于时间处理)
+
+### 开发依赖
+- `vitest` (测试框架)
+- `typescript` (类型支持)
+- `vite` (构建工具)
+- `eslint` + `prettier` (代码质量)
+
+## 🛠️ 开发
+
+```bash
+# 安装依赖
+pnpm install
+
+# 开发模式 (监听文件变化)
+pnpm run dev
+
+# 构建
+pnpm run build
+
+# 运行测试
+pnpm test
+
+# 生成覆盖率报告
+pnpm run test:coverage
+
+# 类型检查
+pnpm run typecheck
+
+# 代码格式化
+pnpm run format
+
+# 代码检查
+pnpm run lint
+
+# 修复代码问题
+pnpm run lint:fix
+```
+
+## 📊 测试
+
+项目包含完整的测试覆盖：
+
+- **102个测试用例** 覆盖所有核心功能
+- **高代码覆盖率** 确保代码质量
+- **10个测试文件** 按模块组织
+- **自动化的 CI/CD** 集成
+
+运行测试并查看覆盖率报告：
+
+```bash
+pnpm run test:coverage
+```
+
+覆盖率报告会生成在 `coverage/` 目录下。
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+### 开发流程
+1. Fork 项目
+2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 创建 Pull Request
+
+### 代码规范
+- 使用 TypeScript 编写
+- 遵循 ESLint 和 Prettier 规范
+- 编写对应的测试用例
+- 确保所有测试通过
+
+## 许可证
+
+MIT

package/crypto.d.ts

@@ -0,0 +1 @@
+export * from './dist/crypto/index';

package/crypto.js

@@ -0,0 +1 @@
+module.exports = require('./dist/crypto/index.cjs');

package/data.d.ts

@@ -0,0 +1 @@
+export * from './dist/data/index';

package/data.js

@@ -0,0 +1 @@
+module.exports = require('./dist/data/index.cjs');

package/dist/crypto/decrypt.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AES 解密函数
+ * @param data - 加密的数据字符串
+ * @param key - 解密密钥，会自动截取前16位
+ * @returns 解密后的字符串
+ */
+export declare const decryptAES: (data: string, key: string | number) => string;
+//# sourceMappingURL=decrypt.d.ts.map

package/dist/crypto/decrypt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decrypt.d.ts","sourceRoot":"","sources":["../../src/crypto/decrypt.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,KAAK,MAAM,GAAG,MAAM,KAAG,MAO/D,CAAA"}

package/dist/crypto/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../decrypt-B6fiICsn.js");exports.decryptAES=e.decryptAES;

package/dist/crypto/index.d.ts

@@ -0,0 +1,2 @@
+export { decryptAES } from './decrypt';
+//# sourceMappingURL=index.d.ts.map

package/dist/crypto/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/crypto/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA"}

package/dist/crypto/index.js

@@ -0,0 +1,4 @@
+import { d as e } from "../decrypt-DwrxsWcv.mjs";
+export {
+  e as decryptAES
+};

package/dist/crypto.d.ts

@@ -0,0 +1,2 @@
+export * from './crypto/index'
+export {}

package/dist/data/clone.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 深拷贝函数
+ * @param data - 需要深拷贝的数据，可以是对象或对象数组
+ * @returns 深拷贝后的数据
+ */
+export declare const deepClone: <T>(data: T) => T;
+//# sourceMappingURL=clone.d.ts.map

package/dist/data/clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../../src/data/clone.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,MAAM,CAAC,KAAG,CAKtC,CAAA"}

package/dist/data/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=e=>e==null?e:JSON.parse(JSON.stringify(e));exports.deepClone=r;

package/dist/data/index.d.ts

@@ -0,0 +1,2 @@
+export { deepClone } from './clone';
+//# sourceMappingURL=index.d.ts.map

package/dist/data/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA"}

package/dist/data/index.js

@@ -0,0 +1,4 @@
+const r = (e) => e == null ? e : JSON.parse(JSON.stringify(e));
+export {
+  r as deepClone
+};

package/dist/data.d.ts

@@ -0,0 +1,2 @@
+export * from './data/index'
+export {}

package/dist/decrypt-B6fiICsn.js

@@ -0,0 +1 @@
+"use strict";const t=require("crypto-js"),n=(e,c)=>{const r=t.enc.Utf8.parse(String(c).slice(0,16)),s=t.AES.decrypt(e,r,{mode:t.mode.ECB,padding:t.pad.Pkcs7});return t.enc.Utf8.stringify(s)};exports.decryptAES=n;

package/dist/decrypt-DwrxsWcv.mjs

@@ -0,0 +1,11 @@
+import t from "crypto-js";
+const s = (e, r) => {
+  const c = t.enc.Utf8.parse(String(r).slice(0, 16)), n = t.AES.decrypt(e, c, {
+    mode: t.mode.ECB,
+    padding: t.pad.Pkcs7
+  });
+  return t.enc.Utf8.stringify(n);
+};
+export {
+  s as d
+};

package/dist/dom/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n={listeners:new WeakMap,listen({domRefs:e,handler:t}){if(this.listeners.has(t))return()=>this.unlisten(t);const i=s=>{e&&!(e===s.target||e.contains(s.target))&&t()};return document.addEventListener("click",i),this.listeners.set(t,i),()=>this.unlisten(t)},unlisten(e){const t=this.listeners.get(e);t&&(document.removeEventListener("click",t),this.listeners.delete(e))}};exports.outsideClick=n;

package/dist/dom/index.d.ts

@@ -0,0 +1,2 @@
+export { outsideClick } from './outsideClick';
+//# sourceMappingURL=index.d.ts.map

package/dist/dom/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dom/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/dom/index.js

@@ -0,0 +1,28 @@
+const n = {
+  listeners: /* @__PURE__ */ new WeakMap(),
+  // 存储 handler 和对应的 listener
+  /**
+   * 监听外部点击事件
+   * @param {OutsideClickListener} param0 - 包含 domRefs 和 handler 的对象
+   * @returns {() => void} 返回一个解绑函数，用于在不需要监听时解绑事件
+   */
+  listen({ domRefs: e, handler: t }) {
+    if (this.listeners.has(t))
+      return () => this.unlisten(t);
+    const s = (i) => {
+      e && !(e === i.target || e.contains(i.target)) && t();
+    };
+    return document.addEventListener("click", s), this.listeners.set(t, s), () => this.unlisten(t);
+  },
+  /**
+   * 解绑外部点击事件
+   * @param {() => void} handler - 需要解绑的处理函数
+   */
+  unlisten(e) {
+    const t = this.listeners.get(e);
+    t && (document.removeEventListener("click", t), this.listeners.delete(e));
+  }
+};
+export {
+  n as outsideClick
+};

package/dist/dom/outsideClick.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 外部点击监听器接口
+ */
+interface OutsideClickListener {
+    domRefs: HTMLElement | null;
+    handler: () => void;
+}
+/**
+ * outsideClick 工具方法
+ * 用于监听外部点击事件，并在点击外部时执行指定的处理函数。
+ */
+export declare const outsideClick: {
+    listeners: WeakMap<() => void, (event: Event) => void>;
+    /**
+     * 监听外部点击事件
+     * @param {OutsideClickListener} param0 - 包含 domRefs 和 handler 的对象
+     * @returns {() => void} 返回一个解绑函数，用于在不需要监听时解绑事件
+     */
+    listen({ domRefs, handler }: OutsideClickListener): () => void;
+    /**
+     * 解绑外部点击事件
+     * @param {() => void} handler - 需要解绑的处理函数
+     */
+    unlisten(handler: () => void): void;
+};
+export {};
+//# sourceMappingURL=outsideClick.d.ts.map

package/dist/dom/outsideClick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outsideClick.d.ts","sourceRoot":"","sources":["../../src/dom/outsideClick.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,UAAU,oBAAoB;IAC5B,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IAC3B,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;6BACM,IAAI,UAAU,KAAK,KAAK,IAAI;IAEzD;;;;OAIG;iCAC0B,oBAAoB,GAAG,MAAM,IAAI;IAkB9D;;;OAGG;sBACe,MAAM,IAAI;CAO7B,CAAA"}

package/dist/dom.d.ts

@@ -0,0 +1,2 @@
+export * from './dom/index'
+export {}

package/dist/fezbox.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=require("./decrypt-B6fiICsn.js"),m=require("./data/index.cjs"),p=require("./dom/index.cjs"),i=require("./file/index.cjs"),y=require("./relative-5TnWB4bl.js"),u=require("./url/index.cjs"),h=require("./qr/index.cjs"),w=(e,t)=>{if(typeof window=="undefined")return t;try{const r=localStorage.getItem(e);if(!r)return t;const o=JSON.parse(r);return typeof o=="object"&&o!==null&&"expires"in o?o.expires&&Date.now()>o.expires?(localStorage.removeItem(e),t):o.value:o}catch(r){return t}},C=(e,t,r={})=>{if(typeof window=="undefined")return!1;try{const o=r.expires?{value:t,expires:r.expires}:t;return localStorage.setItem(e,JSON.stringify(o)),!0}catch(o){return!1}},v=e=>{if(typeof window=="undefined")return!1;try{return localStorage.removeItem(e),!0}catch(t){return!1}},k=()=>{if(typeof window=="undefined")return!1;try{return localStorage.clear(),!0}catch(e){return!1}},x=e=>{if(typeof window=="undefined")return!1;try{const t=localStorage.getItem(e);if(!t)return!1;const r=JSON.parse(t);return typeof r=="object"&&r!==null&&"expires"in r&&r.expires&&Date.now()>r.expires?(localStorage.removeItem(e),!1):!0}catch(t){return!1}},I=(e,t)=>{if(typeof window=="undefined")return t;try{const r=sessionStorage.getItem(e);return r?JSON.parse(r):t}catch(r){return t}},L=(e,t)=>{if(typeof window=="undefined")return!1;try{return sessionStorage.setItem(e,JSON.stringify(t)),!0}catch(r){return!1}},O=e=>{if(typeof window=="undefined")return!1;try{return sessionStorage.removeItem(e),!0}catch(t){return!1}},q=()=>{if(typeof window=="undefined")return!1;try{return sessionStorage.clear(),!0}catch(e){return!1}},$=e=>{if(typeof window=="undefined")return!1;try{return sessionStorage.getItem(e)!==null}catch(t){return!1}},f=(e,t)=>{if(typeof document=="undefined")return t;try{const r=document.cookie.match(new RegExp(`(?:^|; )${e}=([^;]*)`));return r?decodeURIComponent(r[1]):t}catch(r){return t}},l=(e,t,r={})=>{if(typeof document=="undefined")return!1;try{const{expires:o,path:s="/",domain:a,secure:d,sameSite:c,httpOnly:S}=r;let n=`${e}=${encodeURIComponent(t)}`;return o&&(n+=`; expires=${new Date(Date.now()+o*864e5).toUTCString()}`),s&&(n+=`; path=${s}`),a&&(n+=`; domain=${a}`),d&&(n+="; secure"),c&&(n+=`; samesite=${c}`),S&&(n+="; httponly"),document.cookie=n,!0}catch(o){return!1}},b=(e,t={})=>l(e,"",{...t,expires:-1}),F=()=>{if(typeof document=="undefined")return{};try{const e={};return document.cookie&&document.cookie.split(";").forEach(t=>{const[r,o]=t.trim().split("=");r&&o!==void 0&&(e[r]=o?decodeURIComponent(o):"")}),e}catch(e){return{}}},Q=e=>f(e)!==void 0;exports.decryptAES=g.decryptAES;exports.deepClone=m.deepClone;exports.outsideClick=p.outsideClick;exports.fetchFile=i.fetchFile;exports.formatFileSize=i.formatFileSize;exports.uploadFileByUrl=i.uploadFileByUrl;exports.relativeTime=y.relativeTime;exports.getQueryObject=u.getQueryObject;exports.getQueryParam=u.getQueryParam;exports.QRCodeScriptLoader=h.QRCodeScriptLoader;exports.clearLocalStorage=k;exports.clearSessionStorage=q;exports.getAllCookies=F;exports.getCookie=f;exports.getLocalStorage=w;exports.getSessionStorage=I;exports.hasCookie=Q;exports.hasLocalStorage=x;exports.hasSessionStorage=$;exports.removeCookie=b;exports.removeLocalStorage=v;exports.removeSessionStorage=O;exports.setCookie=l;exports.setLocalStorage=C;exports.setSessionStorage=L;

package/dist/fezbox.js

@@ -0,0 +1,141 @@
+import { d as L } from "./decrypt-DwrxsWcv.mjs";
+import { deepClone as N } from "./data/index.js";
+import { outsideClick as U } from "./dom/index.js";
+import { fetchFile as b, formatFileSize as j, uploadFileByUrl as E } from "./file/index.js";
+import { r as Q } from "./relative-D0OTNLYG.mjs";
+import { getQueryObject as T, getQueryParam as z } from "./url/index.js";
+import { QRCodeScriptLoader as P } from "./qr/index.js";
+const l = (e, t) => {
+  if (typeof window == "undefined") return t;
+  try {
+    const r = localStorage.getItem(e);
+    if (!r) return t;
+    const o = JSON.parse(r);
+    return typeof o == "object" && o !== null && "expires" in o ? o.expires && Date.now() > o.expires ? (localStorage.removeItem(e), t) : o.value : o;
+  } catch (r) {
+    return t;
+  }
+}, p = (e, t, r = {}) => {
+  if (typeof window == "undefined") return !1;
+  try {
+    const o = r.expires ? { value: t, expires: r.expires } : t;
+    return localStorage.setItem(e, JSON.stringify(o)), !0;
+  } catch (o) {
+    return !1;
+  }
+}, m = (e) => {
+  if (typeof window == "undefined") return !1;
+  try {
+    return localStorage.removeItem(e), !0;
+  } catch (t) {
+    return !1;
+  }
+}, S = () => {
+  if (typeof window == "undefined") return !1;
+  try {
+    return localStorage.clear(), !0;
+  } catch (e) {
+    return !1;
+  }
+}, g = (e) => {
+  if (typeof window == "undefined") return !1;
+  try {
+    const t = localStorage.getItem(e);
+    if (!t) return !1;
+    const r = JSON.parse(t);
+    return typeof r == "object" && r !== null && "expires" in r && r.expires && Date.now() > r.expires ? (localStorage.removeItem(e), !1) : !0;
+  } catch (t) {
+    return !1;
+  }
+}, y = (e, t) => {
+  if (typeof window == "undefined") return t;
+  try {
+    const r = sessionStorage.getItem(e);
+    return r ? JSON.parse(r) : t;
+  } catch (r) {
+    return t;
+  }
+}, w = (e, t) => {
+  if (typeof window == "undefined") return !1;
+  try {
+    return sessionStorage.setItem(e, JSON.stringify(t)), !0;
+  } catch (r) {
+    return !1;
+  }
+}, h = (e) => {
+  if (typeof window == "undefined") return !1;
+  try {
+    return sessionStorage.removeItem(e), !0;
+  } catch (t) {
+    return !1;
+  }
+}, x = () => {
+  if (typeof window == "undefined") return !1;
+  try {
+    return sessionStorage.clear(), !0;
+  } catch (e) {
+    return !1;
+  }
+}, I = (e) => {
+  if (typeof window == "undefined") return !1;
+  try {
+    return sessionStorage.getItem(e) !== null;
+  } catch (t) {
+    return !1;
+  }
+}, u = (e, t) => {
+  if (typeof document == "undefined") return t;
+  try {
+    const r = document.cookie.match(new RegExp(`(?:^|; )${e}=([^;]*)`));
+    return r ? decodeURIComponent(r[1]) : t;
+  } catch (r) {
+    return t;
+  }
+}, d = (e, t, r = {}) => {
+  if (typeof document == "undefined") return !1;
+  try {
+    const { expires: o, path: i = "/", domain: s, secure: a, sameSite: c, httpOnly: f } = r;
+    let n = `${e}=${encodeURIComponent(t)}`;
+    return o && (n += `; expires=${new Date(Date.now() + o * 864e5).toUTCString()}`), i && (n += `; path=${i}`), s && (n += `; domain=${s}`), a && (n += "; secure"), c && (n += `; samesite=${c}`), f && (n += "; httponly"), document.cookie = n, !0;
+  } catch (o) {
+    return !1;
+  }
+}, C = (e, t = {}) => d(e, "", { ...t, expires: -1 }), v = () => {
+  if (typeof document == "undefined") return {};
+  try {
+    const e = {};
+    return document.cookie && document.cookie.split(";").forEach((t) => {
+      const [r, o] = t.trim().split("=");
+      r && o !== void 0 && (e[r] = o ? decodeURIComponent(o) : "");
+    }), e;
+  } catch (e) {
+    return {};
+  }
+}, k = (e) => u(e) !== void 0;
+export {
+  P as QRCodeScriptLoader,
+  S as clearLocalStorage,
+  x as clearSessionStorage,
+  L as decryptAES,
+  N as deepClone,
+  b as fetchFile,
+  j as formatFileSize,
+  v as getAllCookies,
+  u as getCookie,
+  l as getLocalStorage,
+  T as getQueryObject,
+  z as getQueryParam,
+  y as getSessionStorage,
+  k as hasCookie,
+  g as hasLocalStorage,
+  I as hasSessionStorage,
+  U as outsideClick,
+  Q as relativeTime,
+  C as removeCookie,
+  m as removeLocalStorage,
+  h as removeSessionStorage,
+  d as setCookie,
+  p as setLocalStorage,
+  w as setSessionStorage,
+  E as uploadFileByUrl
+};

package/dist/file/fetch.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 通过 URL 获取文件
+ * @param url - 文件 URL
+ * @param fileName - 文件名
+ * @param fetchFn - 自定义 fetch 函数，可选
+ * @returns Promise<File> 返回文件对象
+ */
+export declare const fetchFile: (url: string, fileName: string, fetchFn?: typeof fetch) => Promise<File>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/file/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/file/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GACpB,KAAK,MAAM,EACX,UAAU,MAAM,EAChB,UAAS,OAAO,KAAwB,KACvC,OAAO,CAAC,IAAI,CAYd,CAAA"}

package/dist/file/format.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 格式化文件大小
+ * @param sizeInBytes - 文件大小（字节），可以是字符串或数字
+ * @returns 格式化后的文件大小字符串
+ */
+export declare const formatFileSize: (sizeInBytes: string | number) => string;
+//# sourceMappingURL=format.d.ts.map

package/dist/file/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/file/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,GAAG,MAAM,KAAG,MAe7D,CAAA"}