@giszhc/file-utils 0.0.1 → 0.0.4

package/README.md

@@ -8,8 +8,9 @@
 - **文件下载**：支持从 URL、Blob、Base64 等多种方式下载文件
 - **文件转换**：支持文件格式转换（如 Base64 转 Blob、File 转 Base64 等）
 - **文件压缩**：支持图片压缩处理
-- **文件生成**：支持生成 TXT、CSV、JSON 格式文件
+- **文件生成**：支持生成 TXT、CSV、JSON 格式文件，可选择返回 File 对象而不下载
 - **文件验证**：提供完整的文件验证和类型判断功能
+- **剪贴板操作**：支持一键复制文本到剪贴板，并支持成功/失败回调
 - **自动清理**：自动管理临时创建的 Blob URL，防止内存泄漏
 - **TypeScript**：完善的类型定义支持
 
@@ -167,6 +168,12 @@ generateTxtFile('Hello World!', 'hello.txt');
 // 生成多行文本
 const lines = ['第一行', '第二行', '第三行'].join('\n');
 generateTxtFile(lines, 'multiline.txt');
+
+// 生成文件但不下载，返回 File 对象
+const file = generateTxtFile('Hello World!', 'hello.txt', { download: false });
+console.log(file.name); // "hello.txt"
+console.log(file.type); // "text/plain;charset=utf-8"
+console.log(file.size); // 文件大小（字节）
 ```
 
 ### 9. 生成 CSV 文件
@@ -192,6 +199,12 @@ generateCsvFile(data, 'data.csv');
 
 // 自定义分隔符（制表符 TSV）
 generateCsvFile(data, 'data.tsv', { separator: '\t' });
+
+// 生成文件但不下载，返回 File 对象
+const csvFile = generateCsvFile(users, 'users.csv', { download: false });
+console.log(csvFile.name); // "users.csv"
+console.log(csvFile.type); // "text/csv;charset=utf-8"
+console.log(csvFile.size); // 文件大小（字节）
 ```
 
 ### 10. 生成 JSON 文件
@@ -215,6 +228,12 @@ generateJsonFile(data, 'data.min.json', { pretty: false });
 
 // 自定义缩进
 generateJsonFile(data, 'data.json', { spaces: 4 });
+
+// 生成文件但不下载，返回 File 对象
+const file = generateJsonFile(data, 'user.json', { download: false });
+console.log(file.name); // "user.json"
+console.log(file.type); // "application/json;charset=utf-8"
+console.log(file.size); // 文件大小（字节）
 ```
 
 ### 11. 获取文件扩展名和文件名
@@ -336,6 +355,31 @@ console.log(data.name);
 console.log(data.age);
 ```
 
+### 19. 一键复制文本到剪贴板
+
+```ts
+import { copyToClipboard } from '@giszhc/file-utils';
+
+// 基本使用
+await copyToClipboard('Hello World!');
+
+// 带回调的使用
+await copyToClipboard('这是一段文本', {
+  onSuccess: () => console.log('复制成功！'),
+  onError: (error) => console.error('复制失败:', error)
+});
+```
+
+### 20. 从剪贴板读取文本
+
+```ts
+import { pasteFromClipboard } from '@giszhc/file-utils';
+
+// 读取剪贴板内容
+const text = await pasteFromClipboard();
+console.log('剪贴板内容:', text);
+```
+
 ------
 
 ## 使用方法

package/dist/file-utils.js

@@ -1,7 +1,7 @@
-function p(e, t = "text") {
-  return new Promise((n, r) => {
+function y(e, r = "text") {
+  return new Promise((t, n) => {
     const o = new FileReader();
-    switch (t) {
+    switch (r) {
       case "text":
         o.readAsText(e);
         break;
@@ -19,203 +19,252 @@ function p(e, t = "text") {
     }
     o.onload = (i) => {
       const a = i.target?.result;
-      a !== void 0 ? n(a) : r(new Error("文件读取失败"));
+      a !== void 0 ? t(a) : n(new Error("文件读取失败"));
     }, o.onerror = () => {
-      r(new Error("文件读取错误"));
+      n(new Error("文件读取错误"));
     }, o.onabort = () => {
-      r(new Error("文件读取被中止"));
+      n(new Error("文件读取被中止"));
     };
   });
 }
-async function S(e, t = "utf-8") {
-  return new Promise((n, r) => {
+async function T(e, r = "utf-8") {
+  return new Promise((t, n) => {
     const o = new FileReader();
-    o.readAsText(e, t), o.onload = (i) => {
+    o.readAsText(e, r), o.onload = (i) => {
       const a = i.target?.result;
-      a !== void 0 ? n(a) : r(new Error("文件读取失败"));
+      a !== void 0 ? t(a) : n(new Error("文件读取失败"));
     }, o.onerror = () => {
-      r(new Error("文件读取错误"));
+      n(new Error("文件读取错误"));
     }, o.onabort = () => {
-      r(new Error("文件读取被中止"));
+      n(new Error("文件读取被中止"));
     };
   });
 }
-async function W(e, t = {}) {
-  const { separator: n = ",", hasHeader: r = !0 } = t, o = await p(e, "text");
+async function $(e, r = {}) {
+  const { separator: t = ",", hasHeader: n = !0 } = r, o = await y(e, "text");
   if (!o.trim())
     return [];
   const i = o.split(/\r?\n/).filter((h) => h.trim() !== "");
   if (i.length === 0)
     return [];
   let a = [], s = 0;
-  r && (a = b(i[0], n), s = 1);
-  const d = [];
+  n && (a = F(i[0], t), s = 1);
+  const l = [];
   for (let h = s; h < i.length; h++) {
-    const l = b(i[h], n);
-    if (r && a.length > 0) {
-      const u = {};
-      a.forEach((c, f) => {
-        u[c] = l[f] || "";
-      }), d.push(u);
+    const w = F(i[h], t);
+    if (n && a.length > 0) {
+      const d = {};
+      a.forEach((u, c) => {
+        d[u] = w[c] || "";
+      }), l.push(d);
     } else
-      d.push(l);
+      l.push(w);
   }
-  return d;
+  return l;
 }
-function b(e, t) {
-  const n = [];
-  let r = "", o = !1;
+function F(e, r) {
+  const t = [];
+  let n = "", o = !1;
   for (let i = 0; i < e.length; i++) {
     const a = e[i], s = e[i + 1];
-    a === '"' ? o && s === '"' ? (r += '"', i++) : o = !o : a === t && !o ? (n.push(r.trim()), r = "") : r += a;
+    a === '"' ? o && s === '"' ? (n += '"', i++) : o = !o : a === r && !o ? (t.push(n.trim()), n = "") : n += a;
   }
-  return n.push(r.trim()), n;
+  return t.push(n.trim()), t;
 }
-async function k(e) {
-  const t = await p(e, "text");
+async function W(e) {
+  const r = await y(e, "text");
   try {
-    return JSON.parse(t);
-  } catch (n) {
-    throw new Error(`JSON 解析失败：${n instanceof Error ? n.message : "未知错误"}`);
+    return JSON.parse(r);
+  } catch (t) {
+    throw new Error(`JSON 解析失败：${t instanceof Error ? t.message : "未知错误"}`);
   }
 }
-async function F(e, t, n) {
+async function v(e, r, t) {
   try {
-    const r = await fetch(e, n?.fetchOptions);
-    if (!r.ok)
-      throw new Error(`下载失败：${r.status} ${r.statusText}`);
-    const o = await r.blob();
-    let i = t;
+    const n = await fetch(e, t?.fetchOptions);
+    if (!n.ok)
+      throw new Error(`下载失败：${n.status} ${n.statusText}`);
+    const o = await n.blob();
+    let i = r;
     if (!i) {
-      const a = r.headers.get("Content-Disposition");
+      const a = n.headers.get("Content-Disposition");
       if (a) {
         const s = /filename[^;=\n]*=((['"]).*?\2|[^;\n]*)/.exec(a);
         s && s[1] && (i = decodeURIComponent(s[1].replace(/['"]/g, "")));
       }
       i || (i = e.split("/").pop() || "download");
     }
-    g(o, i, n);
-  } catch (r) {
-    throw console.error("文件下载失败:", r), r;
+    f(o, i, t);
+  } catch (n) {
+    throw console.error("文件下载失败:", n), n;
   }
 }
-function g(e, t, n) {
-  const r = URL.createObjectURL(e), o = document.createElement("a");
-  o.href = r, o.download = t, n?.newWindow && (o.target = "_blank"), document.body.appendChild(o), o.click(), document.body.removeChild(o), URL.revokeObjectURL(r);
+function f(e, r, t) {
+  const n = URL.createObjectURL(e), o = document.createElement("a");
+  o.href = n, o.download = r, t?.newWindow && (o.target = "_blank"), document.body.appendChild(o), o.click(), document.body.removeChild(o), URL.revokeObjectURL(n);
 }
-function $(e, t, n) {
-  e.startsWith("data:") ? (n = e.split(",")[0].split(":")[1].split(";")[0], e = e.split(",")[1]) : n || (n = "application/octet-stream");
+function k(e, r, t) {
+  e.startsWith("data:") ? (t = e.split(",")[0].split(":")[1].split(";")[0], e = e.split(",")[1]) : t || (t = "application/octet-stream");
   const o = atob(e), i = new Array(o.length);
-  for (let d = 0; d < o.length; d++)
-    i[d] = o.charCodeAt(d);
-  const a = new Uint8Array(i), s = new Blob([a], { type: n });
-  g(s, t);
+  for (let l = 0; l < o.length; l++)
+    i[l] = o.charCodeAt(l);
+  const a = new Uint8Array(i), s = new Blob([a], { type: t });
+  f(s, r);
 }
-async function I(e, t = 500) {
-  for (let n = 0; n < e.length; n++)
+async function I(e, r = 500) {
+  for (let t = 0; t < e.length; t++)
     try {
-      await F(e[n]), n < e.length - 1 && await new Promise((r) => setTimeout(r, t));
-    } catch (r) {
-      console.error(`第 ${n + 1} 个文件下载失败:`, r);
+      await v(e[t]), t < e.length - 1 && await new Promise((n) => setTimeout(n, r));
+    } catch (n) {
+      console.error(`第 ${t + 1} 个文件下载失败:`, n);
     }
 }
 function L(e) {
-  return p(e, "dataURL");
+  return y(e, "dataURL");
 }
-function O(e, t) {
-  e.startsWith("data:") ? (t = e.split(",")[0].split(":")[1].split(";")[0], e = e.split(",")[1]) : t || (t = "application/octet-stream");
-  const r = atob(e), o = new Array(r.length);
-  for (let a = 0; a < r.length; a++)
-    o[a] = r.charCodeAt(a);
+function O(e, r) {
+  e.startsWith("data:") ? (r = e.split(",")[0].split(":")[1].split(";")[0], e = e.split(",")[1]) : r || (r = "application/octet-stream");
+  const n = atob(e), o = new Array(n.length);
+  for (let a = 0; a < n.length; a++)
+    o[a] = n.charCodeAt(a);
   const i = new Uint8Array(o);
-  return new Blob([i], { type: t });
+  return new Blob([i], { type: r });
 }
-function R(e, t, n = "utf-8") {
-  const r = new Blob([e], { type: `text/plain;charset=${n}` });
-  g(r, t);
+async function R(e, r) {
+  try {
+    if (navigator.clipboard && navigator.clipboard.writeText) {
+      await navigator.clipboard.writeText(e), r?.onSuccess && r.onSuccess(e);
+      return;
+    }
+    const t = document.createElement("textarea");
+    t.value = e, t.style.position = "fixed", t.style.top = "0", t.style.left = "0", t.style.width = "2em", t.style.height = "2em", t.style.padding = "0", t.style.border = "none", t.style.outline = "none", t.style.boxShadow = "none", t.style.background = "transparent", t.style.opacity = "0", document.body.appendChild(t), t.focus(), t.select();
+    try {
+      if (document.execCommand("copy"))
+        r?.onSuccess && r.onSuccess(e);
+      else
+        throw new Error("execCommand 复制失败");
+    } catch {
+      throw new Error("无法使用 execCommand 复制文本");
+    } finally {
+      document.body.removeChild(t);
+    }
+  } catch (t) {
+    const n = t instanceof Error ? t : new Error("未知错误");
+    throw r?.onError ? r.onError(n) : console.error("复制到剪贴板失败:", n), n;
+  }
+}
+async function j() {
+  try {
+    if (navigator.clipboard && navigator.clipboard.readText)
+      return await navigator.clipboard.readText();
+    throw new Error("当前浏览器不支持读取剪贴板");
+  } catch (e) {
+    throw console.error("从剪贴板读取失败:", e), new Error("无法从剪贴板读取内容，请检查浏览器权限");
+  }
 }
-function w(e, t) {
+function z(e, r, t) {
+  const {
+    download: n = !0,
+    encoding: o = "utf-8"
+  } = t || {}, i = new Blob([e], { type: `text/plain;charset=${o}` });
+  if (n) {
+    f(i, r);
+    return;
+  }
+  return new File([i], r, { type: `text/plain;charset=${o}` });
+}
+function p(e, r) {
   if (e == null)
     return "";
-  const n = String(e);
-  return n.includes(t) || n.includes('"') || n.includes(`
-`) || n.includes("\r") ? `"${n.replace(/"/g, '""')}"` : n;
+  const t = String(e);
+  return t.includes(r) || t.includes('"') || t.includes(`
+`) || t.includes("\r") ? `"${t.replace(/"/g, '""')}"` : t;
 }
-function T(e, t, n = {}) {
+function U(e, r, t = {}) {
   const {
-    separator: r = ",",
+    separator: n = ",",
     includeHeader: o = !0,
-    encoding: i = "utf-8"
-  } = n;
+    download: i = !0,
+    encoding: a = "utf-8"
+  } = t;
   if (e.length === 0)
     throw new Error("数据不能为空");
-  let a = "";
+  let s = "";
   if (typeof e[0] == "object" && !Array.isArray(e[0])) {
-    const l = e, u = Array.from(
-      new Set(l.flatMap((c) => Object.keys(c)))
+    const d = e, u = Array.from(
+      new Set(d.flatMap((c) => Object.keys(c)))
     );
-    o && (a += u.join(r) + `
-`), l.forEach((c) => {
-      const f = u.map((x) => {
-        const C = c[x];
-        return w(C, r);
+    o && (s += u.join(n) + `
+`), d.forEach((c) => {
+      const g = u.map((b) => {
+        const A = c[b];
+        return p(A, n);
       });
-      a += f.join(r) + `
+      s += g.join(n) + `
 `;
     });
   } else {
-    const l = e;
-    if (o && l.length > 0) {
-      const u = l[0].map(
-        (c) => w(c, r)
+    const d = e;
+    if (o && d.length > 0) {
+      const u = d[0].map(
+        (c) => p(c, n)
       );
-      a += u.join(r) + `
+      s += u.join(n) + `
 `;
-      for (let c = 1; c < l.length; c++) {
-        const f = l[c].map(
-          (x) => w(x, r)
+      for (let c = 1; c < d.length; c++) {
+        const g = d[c].map(
+          (b) => p(b, n)
         );
-        a += f.join(r) + `
+        s += g.join(n) + `
 `;
       }
-    } else o || l.forEach((u) => {
+    } else o || d.forEach((u) => {
       const c = u.map(
-        (f) => w(f, r)
+        (g) => p(g, n)
       );
-      a += c.join(r) + `
+      s += c.join(n) + `
 `;
     });
   }
-  a = a.trimEnd();
-  const d = "\uFEFF", h = new Blob([d + a], {
-    type: `text/csv;charset=${i}`
+  s = s.trimEnd();
+  const h = "\uFEFF", w = new Blob([h + s], {
+    type: `text/csv;charset=${a}`
   });
-  g(h, t);
+  if (i) {
+    f(w, r);
+    return;
+  }
+  return new File([w], r, { type: `text/csv;charset=${a}` });
 }
-function z(e, t, n = {}) {
+function H(e, r, t = {}) {
   const {
-    pretty: r = !0,
+    pretty: n = !0,
     spaces: o = 2,
-    encoding: i = "utf-8"
-  } = n;
+    download: i = !0,
+    encoding: a = "utf-8"
+  } = t;
   try {
-    const a = r ? JSON.stringify(e, null, o) : JSON.stringify(e), s = new Blob([a], {
-      type: `application/json;charset=${i}`
+    const s = n ? JSON.stringify(e, null, o) : JSON.stringify(e), l = new Blob([s], {
+      type: `application/json;charset=${a}`
     });
-    g(s, t);
-  } catch (a) {
-    throw console.error("JSON 序列化失败:", a), new Error("数据无法序列化为 JSON");
+    if (i) {
+      f(l, r);
+      return;
+    }
+    return new File([l], r, { type: `application/json;charset=${a}` });
+  } catch (s) {
+    throw console.error("JSON 序列化失败:", s), new Error("数据无法序列化为 JSON");
   }
 }
-function y(e) {
-  const t = typeof e == "string" ? e : e.name, n = t.lastIndexOf(".");
-  return n === -1 || n === t.length - 1 ? "" : t.slice(n).toLowerCase();
+function x(e) {
+  const r = typeof e == "string" ? e : e.name, t = r.lastIndexOf(".");
+  return t === -1 || t === r.length - 1 ? "" : r.slice(t).toLowerCase();
 }
-function U(e) {
-  const t = typeof e == "string" ? e : e.name, n = t.lastIndexOf(".");
-  return n === -1 ? t : t.slice(0, n);
+function J(e) {
+  const r = typeof e == "string" ? e : e.name, t = r.lastIndexOf(".");
+  return t === -1 ? r : r.slice(0, t);
 }
-function j(e) {
+function M(e) {
   return {
     name: e.name,
     size: e.size,
@@ -223,127 +272,132 @@ function j(e) {
     lastModified: e.lastModified
   };
 }
-function v(e, t) {
-  if (!e || !t || t.length === 0)
+function E(e, r) {
+  if (!e || !r || r.length === 0)
     return !1;
-  const n = e.type.toLowerCase(), r = y(e).toLowerCase();
-  return t.some((o) => {
+  const t = e.type.toLowerCase(), n = x(e).toLowerCase();
+  return r.some((o) => {
     const i = o.toLowerCase();
     if (i.endsWith("/*")) {
       const a = i.split("/")[0];
-      return n.startsWith(`${a}/`);
+      return t.startsWith(`${a}/`);
     }
-    return i.startsWith(".") ? r === i : n === i;
+    return i.startsWith(".") ? n === i : t === i;
   });
 }
-function E(e, t) {
-  return e ? e.size <= t : !1;
+function C(e, r) {
+  return e ? e.size <= r : !1;
 }
 function m(e) {
   if (!e)
     return !1;
   if (e.type.startsWith("image/"))
     return !0;
-  const t = [".jpg", ".jpeg", ".png", ".gif", ".bmp", ".webp", ".svg", ".ico"], n = y(e);
-  return t.includes(n);
+  const r = [".jpg", ".jpeg", ".png", ".gif", ".bmp", ".webp", ".svg", ".ico"], t = x(e);
+  return r.includes(t);
 }
 function B(e) {
-  return new Promise((t, n) => {
+  return new Promise((r, t) => {
     if (!m(e)) {
-      n(new Error("文件不是有效的图片格式"));
+      t(new Error("文件不是有效的图片格式"));
       return;
     }
-    const r = new FileReader();
-    r.onload = (o) => {
+    const n = new FileReader();
+    n.onload = (o) => {
       const i = new Image();
       i.onload = () => {
-        t({
+        r({
           width: i.width,
           height: i.height
         });
       }, i.onerror = () => {
-        n(new Error("图片加载失败"));
+        t(new Error("图片加载失败"));
       }, i.src = o.target?.result;
-    }, r.onerror = () => {
-      n(new Error("文件读取失败"));
-    }, r.readAsDataURL(e);
+    }, n.onerror = () => {
+      t(new Error("文件读取失败"));
+    }, n.readAsDataURL(e);
   });
 }
-async function H(e, t = {}) {
-  const n = [];
-  if (t.acceptTypes && t.acceptTypes.length > 0 && (v(e, t.acceptTypes) || n.push(`不支持的文件类型。接受：${t.acceptTypes.join(", ")}`)), t.maxSize !== void 0 && !E(e, t.maxSize)) {
-    const r = A(t.maxSize);
-    n.push(`文件过大。最大允许：${r}`);
+async function N(e, r = {}) {
+  const t = [];
+  if (r.acceptTypes && r.acceptTypes.length > 0 && (E(e, r.acceptTypes) || t.push(`不支持的文件类型。接受：${r.acceptTypes.join(", ")}`)), r.maxSize !== void 0 && !C(e, r.maxSize)) {
+    const n = S(r.maxSize);
+    t.push(`文件过大。最大允许：${n}`);
   }
-  if (t.mustBeImage && !m(e) && n.push("文件必须是图片格式"), m(e) && (t.minWidth !== void 0 || t.maxWidth !== void 0 || t.minHeight !== void 0 || t.maxHeight !== void 0))
+  if (r.mustBeImage && !m(e) && t.push("文件必须是图片格式"), m(e) && (r.minWidth !== void 0 || r.maxWidth !== void 0 || r.minHeight !== void 0 || r.maxHeight !== void 0))
     try {
-      const r = await B(e);
-      t.minWidth !== void 0 && r.width < t.minWidth && n.push(`图片宽度过小。最小宽度：${t.minWidth}px`), t.maxWidth !== void 0 && r.width > t.maxWidth && n.push(`图片宽度过大。最大宽度：${t.maxWidth}px`), t.minHeight !== void 0 && r.height < t.minHeight && n.push(`图片高度过小。最小高度：${t.minHeight}px`), t.maxHeight !== void 0 && r.height > t.maxHeight && n.push(`图片高度过大。最大高度：${t.maxHeight}px`);
+      const n = await B(e);
+      r.minWidth !== void 0 && n.width < r.minWidth && t.push(`图片宽度过小。最小宽度：${r.minWidth}px`), r.maxWidth !== void 0 && n.width > r.maxWidth && t.push(`图片宽度过大。最大宽度：${r.maxWidth}px`), r.minHeight !== void 0 && n.height < r.minHeight && t.push(`图片高度过小。最小高度：${r.minHeight}px`), r.maxHeight !== void 0 && n.height > r.maxHeight && t.push(`图片高度过大。最大高度：${r.maxHeight}px`);
     } catch {
-      n.push("无法获取图片尺寸");
+      t.push("无法获取图片尺寸");
     }
   return {
-    valid: n.length === 0,
-    errors: n
+    valid: t.length === 0,
+    errors: t
   };
 }
-function A(e, t = 2) {
+function S(e, r = 2) {
   if (e === 0) return "0 B";
-  const n = ["B", "KB", "MB", "GB", "TB"], r = 1024, o = Math.floor(Math.log(e) / Math.log(r));
-  return parseFloat((e / Math.pow(r, o)).toFixed(t)) + " " + n[o];
+  const t = ["B", "KB", "MB", "GB", "TB"], n = 1024, o = Math.floor(Math.log(e) / Math.log(n));
+  return parseFloat((e / Math.pow(n, o)).toFixed(r)) + " " + t[o];
 }
-const J = {
+const D = {
   // 读取
-  readFile: p,
-  readTxtFile: S,
-  readCsvFile: W,
-  readJsonFile: k,
+  readFile: y,
+  readTxtFile: T,
+  readCsvFile: $,
+  readJsonFile: W,
   // 下载
-  downloadFile: F,
-  downloadBlob: g,
-  downloadBase64: $,
+  downloadFile: v,
+  downloadBlob: f,
+  downloadBase64: k,
   downloadMultiple: I,
   // 转换
   fileToBase64: L,
   base64ToBlob: O,
+  // 剪贴板
+  copyToClipboard: R,
+  pasteFromClipboard: j,
   // 生成
-  generateTxtFile: R,
-  generateCsvFile: T,
-  generateJsonFile: z,
+  generateTxtFile: z,
+  generateCsvFile: U,
+  generateJsonFile: H,
   // 验证
-  checkFileType: v,
-  checkFileSize: E,
+  checkFileType: E,
+  checkFileSize: C,
   isImage: m,
   getImageDimensions: B,
-  validateFile: H,
-  formatFileSize: A,
+  validateFile: N,
+  formatFileSize: S,
   // 工具
-  getFileExtension: y,
-  getFileNameWithoutExtension: U,
-  getFileInfo: j
+  getFileExtension: x,
+  getFileNameWithoutExtension: J,
+  getFileInfo: M
 };
 export {
   O as base64ToBlob,
-  E as checkFileSize,
-  v as checkFileType,
-  J as default,
-  $ as downloadBase64,
-  g as downloadBlob,
-  F as downloadFile,
+  C as checkFileSize,
+  E as checkFileType,
+  R as copyToClipboard,
+  D as default,
+  k as downloadBase64,
+  f as downloadBlob,
+  v as downloadFile,
   I as downloadMultiple,
   L as fileToBase64,
-  A as formatFileSize,
-  T as generateCsvFile,
-  z as generateJsonFile,
-  R as generateTxtFile,
-  y as getFileExtension,
-  j as getFileInfo,
-  U as getFileNameWithoutExtension,
+  S as formatFileSize,
+  U as generateCsvFile,
+  H as generateJsonFile,
+  z as generateTxtFile,
+  x as getFileExtension,
+  M as getFileInfo,
+  J as getFileNameWithoutExtension,
   B as getImageDimensions,
   m as isImage,
-  W as readCsvFile,
-  p as readFile,
-  k as readJsonFile,
-  S as readTxtFile,
-  H as validateFile
+  j as pasteFromClipboard,
+  $ as readCsvFile,
+  y as readFile,
+  W as readJsonFile,
+  T as readTxtFile,
+  N as validateFile
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@giszhc/file-utils",
-  "version": "0.0.1",
+  "version": "0.0.4",
   "type": "module",
   "files": [
     "dist",

package/types/copy.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 剪贴板复制相关方法
+ */
+import type { CopyOptions } from './types';
+/**
+ * 一键复制文本到剪贴板
+ *
+ * @param text - 要复制的文本内容
+ * @param options - 复制选项配置（可选）
+ * @returns Promise<void>
+ *
+ * @example
+ * // 基本使用
+ * copyToClipboard('Hello World!');
+ *
+ * @example
+ * // 带回调的使用
+ * copyToClipboard('Hello World!', {
+ *   onSuccess: () => console.log('复制成功！'),
+ *   onError: (error) => console.error('复制失败:', error)
+ * });
+ *
+ * @remarks
+ * - 优先使用现代的 navigator.clipboard API
+ * - 自动降级到传统的 execCommand 方式以兼容旧浏览器
+ * - 需要用户授权才能访问剪贴板
+ */
+export declare function copyToClipboard(text: string, options?: CopyOptions): Promise<void>;
+/**
+ * 从剪贴板读取文本
+ *
+ * @returns Promise<string> - 剪贴板中的文本内容
+ *
+ * @example
+ * // 读取剪贴板内容
+ * const text = await pasteFromClipboard();
+ * console.log('剪贴板内容:', text);
+ *
+ * @remarks
+ * - 需要用户授权才能访问剪贴板
+ * - 在某些浏览器中可能需要 HTTPS 环境
+ */
+export declare function pasteFromClipboard(): Promise<string>;

package/types/generate.d.ts

@@ -1,12 +1,17 @@
 /**
  * 文件生成相关方法
  */
+import type { GenerateOptions } from './types';
 /**
  * 生成并下载 TXT 文件
  *
  * @param content - 文本内容
  * @param filename - 文件名（包含 .txt 扩展名）
- * @param encoding - 字符编码，默认 'utf-8'
+ * @param options - 生成选项配置（可选）
+ *                - download: 是否直接下载，默认 true
+ *                - encoding: 字符编码，默认 'utf-8'
+ *
+ * @returns 如果 options.download 为 false，返回 File 对象；否则返回 void
  *
  * @example
  * // 生成简单的文本文件
@@ -16,8 +21,12 @@
  * // 生成多行文本
  * const lines = ['第一行', '第二行', '第三行'].join('\n');
  * generateTxtFile(lines, 'multiline.txt');
+ *
+ * @example
+ * // 生成文件但不下载，返回 File 对象
+ * const file = generateTxtFile('Hello World!', 'hello.txt', { download: false });
  */
-export declare function generateTxtFile(content: string, filename: string, encoding?: string): void;
+export declare function generateTxtFile(content: string, filename: string, options?: GenerateOptions): File | void;
 /**
  * 生成并下载 CSV 文件
  *
@@ -26,8 +35,11 @@ export declare function generateTxtFile(content: string, filename: string, encod
  * @param options - CSV 选项配置（可选）
  *                - separator: 字段分隔符，默认 ','
  *                - includeHeader: 是否包含表头，默认 true
+ *                - download: 是否直接下载，默认 true
  *                - encoding: 字符编码，默认 'utf-8'
  *
+ * @returns 如果 options.download 为 false，返回 File 对象；否则返回 void
+ *
  * @example
  * // 使用对象数组生成 CSV
  * const users = [
@@ -49,12 +61,17 @@ export declare function generateTxtFile(content: string, filename: string, encod
  * @example
  * // 自定义分隔符（制表符）
  * generateCsvFile(data, 'data.tsv', { separator: '\t' });
+ *
+ * @example
+ * // 生成文件但不下载，返回 File 对象
+ * const file = generateCsvFile(users, 'users.csv', { download: false });
  */
 export declare function generateCsvFile(data: Record<string, any>[] | any[][], filename: string, options?: {
     separator?: string;
     includeHeader?: boolean;
+    download?: boolean;
     encoding?: string;
-}): void;
+}): File | void;
 /**
  * 生成并下载 JSON 文件
  *
@@ -63,8 +80,11 @@ export declare function generateCsvFile(data: Record<string, any>[] | any[][], f
  * @param options - JSON 选项配置（可选）
  *                - pretty: 是否格式化输出，默认 true
  *                - spaces: 缩进空格数，默认 2
+ *                - download: 是否直接下载，默认 true
  *                - encoding: 字符编码，默认 'utf-8'
  *
+ * @returns 如果 options.download 为 false，返回 File 对象；否则返回 void
+ *
  * @example
  * // 生成简单的 JSON 文件
  * const data = { name: '张三', age: 25 };
@@ -85,9 +105,14 @@ export declare function generateCsvFile(data: Record<string, any>[] | any[][], f
  * @example
  * // 自定义缩进
  * generateJsonFile(data, 'data.json', { spaces: 4 });
+ *
+ * @example
+ * // 生成文件但不下载，返回 File 对象
+ * const file = generateJsonFile(data, 'user.json', { download: false });
  */
 export declare function generateJsonFile(data: any, filename: string, options?: {
     pretty?: boolean;
     spaces?: number;
+    download?: boolean;
     encoding?: string;
-}): void;
+}): File | void;

package/types/index.d.ts

@@ -4,16 +4,18 @@
  * 提供常用的文件处理功能：读取、下载、转换、生成、验证等
  * 支持 Tree Shaking，按需引入
  */
-export type { ReadFileType, CompressOptions, DownloadOptions, IFileInfo, IValidationResult, IFileValidationOptions } from './types';
+export type { ReadFileType, CompressOptions, DownloadOptions, CopyOptions, IFileInfo, IValidationResult, IFileValidationOptions } from './types';
 export { readFile, readTxtFile, readCsvFile, readJsonFile } from './read';
 export { downloadFile, downloadBlob, downloadBase64, downloadMultiple } from './download';
 export { fileToBase64, base64ToBlob } from './convert';
+export { copyToClipboard, pasteFromClipboard } from './copy';
 export { generateTxtFile, generateCsvFile, generateJsonFile } from './generate';
 export { checkFileType, checkFileSize, isImage, getImageDimensions, validateFile, formatFileSize } from './validators';
 export { getFileExtension, getFileNameWithoutExtension, getFileInfo } from './utils';
 import { readFile, readTxtFile, readCsvFile, readJsonFile } from './read';
 import { downloadFile, downloadBlob, downloadBase64, downloadMultiple } from './download';
 import { fileToBase64, base64ToBlob } from './convert';
+import { copyToClipboard, pasteFromClipboard } from './copy';
 import { generateTxtFile, generateCsvFile, generateJsonFile } from './generate';
 import { checkFileType, checkFileSize, isImage, getImageDimensions, validateFile, formatFileSize } from './validators';
 import { getFileExtension, getFileNameWithoutExtension, getFileInfo } from './utils';
@@ -28,6 +30,8 @@ declare const _default: {
     downloadMultiple: typeof downloadMultiple;
     fileToBase64: typeof fileToBase64;
     base64ToBlob: typeof base64ToBlob;
+    copyToClipboard: typeof copyToClipboard;
+    pasteFromClipboard: typeof pasteFromClipboard;
     generateTxtFile: typeof generateTxtFile;
     generateCsvFile: typeof generateCsvFile;
     generateJsonFile: typeof generateJsonFile;

package/types/types.d.ts

@@ -0,0 +1,165 @@
+/**
+ * 文件读取类型定义
+ * - text: 读取为文本内容
+ * - arrayBuffer: 读取为 ArrayBuffer（二进制数据）
+ * - dataURL: 读取为 Data URL（Base64 编码）
+ * - binaryString: 读取为二进制字符串
+ */
+export type ReadFileType = 'text' | 'arrayBuffer' | 'dataURL' | 'binaryString';
+/**
+ * 图片压缩选项配置
+ */
+export interface CompressOptions {
+    /**
+     * 压缩质量
+     * 范围：0.1 - 1.0
+     * 默认值：0.8（80% 质量）
+     * @example 0.5 表示 50% 质量
+     */
+    quality?: number;
+    /**
+     * 最大宽度（像素）
+     * 如果原图宽度超过此值，将等比例缩放
+     * 默认值：无限制
+     */
+    maxWidth?: number;
+    /**
+     * 最大高度（像素）
+     * 如果原图高度超过此值，将等比例缩放
+     * 默认值：无限制
+     */
+    maxHeight?: number;
+    /**
+     * 输出图片的 MIME 类型
+     * 默认值：'image/jpeg'
+     * 支持的值：'image/jpeg', 'image/png', 'image/webp' 等
+     */
+    mimeType?: string;
+}
+/**
+ * 下载选项配置
+ */
+export interface DownloadOptions {
+    /**
+     * 目标文件名（包含扩展名）
+     * 如果不指定，将尝试从 URL 或 Content-Disposition 头中提取
+     */
+    filename?: string;
+    /**
+     * 是否在新窗口打开
+     * 默认值：false（直接下载）
+     */
+    newWindow?: boolean;
+    /**
+     * Fetch API 的 RequestInit 配置
+     * 可用于设置请求头、授权信息、请求方法等
+     * @example
+     * // 设置授权请求头
+     * fetchOptions: {
+     *  headers: {
+     *     'Authorization': 'Bearer token123'
+     *   }
+     * }
+     *
+     * @example
+     * // 设置 POST 请求和请求体
+     * fetchOptions: {
+     *  method: 'POST',
+     *   body: JSON.stringify({ id: 123 })
+     * }
+     */
+    fetchOptions?: RequestInit;
+}
+/**
+ * 文件生成选项配置
+ * 用于控制文件生成后的行为
+ */
+export interface GenerateOptions {
+    /**
+     * 是否直接下载生成的文件
+     * 默认值：true（直接下载）
+     * 如果设置为 false，将返回 File 对象而不触发下载
+     */
+    download?: boolean;
+    /**
+     * 字符编码
+     * 默认值：'utf-8'
+     */
+    encoding?: string;
+}
+/**
+ * 文件信息接口
+ * 用于描述文件的基本属性
+ */
+export interface IFileInfo {
+    /** 文件名 */
+    name: string;
+    /** 文件大小（字节） */
+    size: number;
+    /** MIME 类型 */
+    type: string;
+    /** 最后修改时间戳 */
+    lastModified: number;
+}
+/**
+ * 文件验证结果接口
+ * 用于返回文件验证的结果
+ */
+export interface IValidationResult {
+    /** 是否通过验证 */
+    valid: boolean;
+    /** 错误信息列表 */
+    errors: string[];
+}
+/**
+ * 文件验证选项配置
+ * 用于指定文件验证的规则
+ */
+export interface IFileValidationOptions {
+    /**
+     * 接受的文件类型数组
+     * 支持：MIME 类型（'image/jpeg'）、通配符（'image/*'）、扩展名（'.jpg'）
+     */
+    acceptTypes?: string[];
+    /**
+     * 最大文件大小（字节）
+     * @example 2 * 1024 * 1024 表示 2MB
+     */
+    maxSize?: number;
+    /**
+     * 是否必须为图片
+     * 默认值：false
+     */
+    mustBeImage?: boolean;
+    /**
+     * 最小宽度（像素，仅对图片有效）
+     */
+    minWidth?: number;
+    /**
+     * 最大宽度（像素，仅对图片有效）
+     */
+    maxWidth?: number;
+    /**
+     * 最小高度（像素，仅对图片有效）
+     */
+    minHeight?: number;
+    /**
+     * 最大高度（像素，仅对图片有效）
+     */
+    maxHeight?: number;
+}
+/**
+ * 复制选项配置
+ */
+export interface CopyOptions {
+    /**
+    * 复制成功时的回调函数
+    * @param text - 被复制的文本
+    */
+    onSuccess?: (text: string) => void;
+    /**
+    * 复制失败时的回调函数
+    * @param error - 错误信息
+    */
+    onError?: (error: Error) => void;
+}