ly-utils-lib 1.0.12 → 2.5.0

package/dist/pdf.js

@@ -0,0 +1,173 @@
+import html2canvas from 'html2canvas';
+export { default as html2canvas } from 'html2canvas';
+import { jsPDF } from 'jspdf';
+export { jsPDF } from 'jspdf';
+
+// src/modules/pdf/index.ts
+var captureToPDF = async (element, options = {}) => {
+  const {
+    filename = "download.pdf",
+    scale = 2,
+    useCORS = true,
+    backgroundColor = "#ffffff",
+    logging = false,
+    margin = 10
+  } = options;
+  const canvas = await html2canvas(element, {
+    scale,
+    useCORS,
+    backgroundColor,
+    logging
+  });
+  const imgData = canvas.toDataURL("image/png");
+  const imgWidth = canvas.width;
+  const imgHeight = canvas.height;
+  const pdfWidth = imgWidth / scale;
+  const pdfHeight = imgHeight / scale;
+  const pdf = new jsPDF({
+    orientation: pdfWidth > pdfHeight ? "l" : "p",
+    unit: "pt",
+    format: [pdfWidth + margin * 2, pdfHeight + margin * 2]
+  });
+  pdf.addImage(imgData, "PNG", margin, margin, pdfWidth, pdfHeight);
+  pdf.save(filename);
+};
+var captureToPDFWithPagination = async (element, options = {}) => {
+  const {
+    filename = "download.pdf",
+    scale = 2,
+    useCORS = true,
+    backgroundColor = "#ffffff",
+    logging = false,
+    margin = 10
+  } = options;
+  const canvas = await html2canvas(element, {
+    scale,
+    useCORS,
+    backgroundColor,
+    logging
+  });
+  const imgData = canvas.toDataURL("image/png");
+  const imgWidth = canvas.width;
+  const imgHeight = canvas.height;
+  const pdf = new jsPDF("p", "pt", "a4");
+  const pdfWidth = pdf.internal.pageSize.getWidth();
+  const pdfHeight = pdf.internal.pageSize.getHeight();
+  const imgWidthInPDF = pdfWidth - margin * 2;
+  const imgHeightInPDF = imgHeight / imgWidth * imgWidthInPDF;
+  let heightLeft = imgHeightInPDF;
+  let position = margin;
+  pdf.addImage(imgData, "PNG", margin, position, imgWidthInPDF, imgHeightInPDF);
+  heightLeft -= pdfHeight - margin * 2;
+  while (heightLeft > 0) {
+    position = heightLeft - imgHeightInPDF + margin;
+    pdf.addPage();
+    pdf.addImage(imgData, "PNG", margin, position, imgWidthInPDF, imgHeightInPDF);
+    heightLeft -= pdfHeight - margin * 2;
+  }
+  pdf.save(filename);
+};
+var captureToImage = async (element, options = {}) => {
+  const canvas = await html2canvas(element, {
+    scale: 2,
+    useCORS: true,
+    backgroundColor: "#ffffff",
+    logging: false,
+    ...options
+  });
+  return canvas.toDataURL("image/png");
+};
+var captureToImageDownload = async (element, filename = "screenshot.png", options = {}) => {
+  const dataUrl = await captureToImage(element, options);
+  const link = document.createElement("a");
+  link.href = dataUrl;
+  link.download = filename;
+  link.click();
+};
+var createPDF = (options = {}) => {
+  return new jsPDF(options);
+};
+var addTextToPDF = (pdf, text, x, y, options = {}) => {
+  const { maxWidth, align = "left", fontSize = 12, fontStyle = "normal" } = options;
+  pdf.setFontSize(fontSize);
+  pdf.setFont("helvetica", fontStyle);
+  pdf.text(text, x, y, { maxWidth, align });
+};
+var addImageToPDF = (pdf, imageData, x, y, width, height) => {
+  pdf.addImage(imageData, "PNG", x, y, width, height);
+};
+var addTableToPDF = (pdf, headers, data, options = {}) => {
+  const {
+    x = 10,
+    y = 10,
+    cellWidth = 50,
+    cellHeight = 20,
+    headerBackgroundColor = "#4472C4",
+    headerTextColor = "#ffffff",
+    textColor = "#000000",
+    fontSize = 10,
+    lineWidth = 0.1,
+    lineColor = [200, 200, 200]
+  } = options;
+  pdf.setFontSize(fontSize);
+  let currentY = y;
+  headers.forEach((header, index) => {
+    const cellX = x + index * cellWidth;
+    pdf.setFillColor(
+      parseInt(headerBackgroundColor.slice(1, 3), 16),
+      parseInt(headerBackgroundColor.slice(3, 5), 16),
+      parseInt(headerBackgroundColor.slice(5, 7), 16)
+    );
+    pdf.rect(cellX, currentY, cellWidth, cellHeight, "F");
+    pdf.setDrawColor(lineColor[0], lineColor[1], lineColor[2]);
+    pdf.setLineWidth(lineWidth);
+    pdf.rect(cellX, currentY, cellWidth, cellHeight, "S");
+    pdf.setTextColor(
+      parseInt(headerTextColor.slice(1, 3), 16),
+      parseInt(headerTextColor.slice(3, 5), 16),
+      parseInt(headerTextColor.slice(5, 7), 16)
+    );
+    pdf.text(header, cellX + cellWidth / 2, currentY + cellHeight / 2 + fontSize / 4, {
+      align: "center"
+    });
+  });
+  currentY += cellHeight;
+  pdf.setTextColor(
+    parseInt(textColor.slice(1, 3), 16),
+    parseInt(textColor.slice(3, 5), 16),
+    parseInt(textColor.slice(5, 7), 16)
+  );
+  data.forEach((row) => {
+    row.forEach((cell, index) => {
+      const cellX = x + index * cellWidth;
+      pdf.setDrawColor(lineColor[0], lineColor[1], lineColor[2]);
+      pdf.setLineWidth(lineWidth);
+      pdf.rect(cellX, currentY, cellWidth, cellHeight, "S");
+      pdf.text(cell, cellX + cellWidth / 2, currentY + cellHeight / 2 + fontSize / 4, {
+        align: "center"
+      });
+    });
+    currentY += cellHeight;
+  });
+};
+var addPage = (pdf) => {
+  pdf.addPage();
+};
+var savePDF = (pdf, filename = "download.pdf") => {
+  pdf.save(filename);
+};
+var pdfToDataURL = (pdf) => {
+  return pdf.output("dataurlstring");
+};
+var pdfToBlob = (pdf) => {
+  return pdf.output("blob");
+};
+var mergePDFs = (_pdfs) => {
+  return Promise.reject(
+    new Error("mergePDFs \u529F\u80FD\u9700\u8981\u4F7F\u7528 pdf-lib \u5E93\u5B9E\u73B0\u3002\u8BF7\u5B89\u88C5 pdf-lib \u5E76\u4F7F\u7528\u5176\u63D0\u4F9B\u7684\u5408\u5E76\u529F\u80FD\u3002")
+  );
+};
+
+export { addImageToPDF, addPage, addTableToPDF, addTextToPDF, captureToImage, captureToImageDownload, captureToPDF, captureToPDFWithPagination, createPDF, mergePDFs, pdfToBlob, pdfToDataURL, savePDF };
+//# sourceMappingURL=pdf.js.map
+//# sourceMappingURL=pdf.js.map

package/dist/pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/modules/pdf/index.ts"],"names":[],"mappings":"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","file":"pdf.js","sourcesContent":["/**\n * PDF 工具模块\n * 基于 html2canvas 和 jspdf 封装，提供常用的 PDF 处理功能\n */\n\nimport html2canvas, { type Options as Html2CanvasOptions } from 'html2canvas'\nimport { jsPDF } from 'jspdf'\n\nexport interface CaptureToPDFOptions {\n  filename?: string\n  scale?: number\n  useCORS?: boolean\n  backgroundColor?: string\n  logging?: boolean\n  pagebreak?: { mode?: string; before?: string; after?: string }\n  margin?: number\n}\n\nexport interface PDFOptions {\n  orientation?: 'p' | 'portrait' | 'l' | 'landscape'\n  unit?: 'pt' | 'mm' | 'cm' | 'in'\n  format?: 'a0' | 'a1' | 'a2' | 'a3' | 'a4' | 'legal' | 'letter' | [number, number]\n}\n\n/**\n * 将 DOM 元素转换为 PDF\n * @param element DOM 元素\n * @param options 选项\n */\nexport const captureToPDF = async (\n  element: HTMLElement,\n  options: CaptureToPDFOptions = {}\n): Promise<void> => {\n  const {\n    filename = 'download.pdf',\n    scale = 2,\n    useCORS = true,\n    backgroundColor = '#ffffff',\n    logging = false,\n    margin = 10,\n  } = options\n\n  // 使用 html2canvas 将 DOM 转换为 canvas\n  const canvas = await html2canvas(element, {\n    scale,\n    useCORS,\n    backgroundColor,\n    logging,\n  })\n\n  // 获取 canvas 的尺寸\n  const imgData = canvas.toDataURL('image/png')\n  const imgWidth = canvas.width\n  const imgHeight = canvas.height\n\n  // 计算 PDF 尺寸\n  const pdfWidth = imgWidth / scale\n  const pdfHeight = imgHeight / scale\n\n  // 创建 PDF\n  const pdf = new jsPDF({\n    orientation: pdfWidth > pdfHeight ? 'l' : 'p',\n    unit: 'pt',\n    format: [pdfWidth + margin * 2, pdfHeight + margin * 2],\n  })\n\n  // 添加图片到 PDF\n  pdf.addImage(imgData, 'PNG', margin, margin, pdfWidth, pdfHeight)\n  pdf.save(filename)\n}\n\n/**\n * 将 DOM 元素转换为 PDF（分页）\n * @param element DOM 元素\n * @param options 选项\n */\nexport const captureToPDFWithPagination = async (\n  element: HTMLElement,\n  options: CaptureToPDFOptions = {}\n): Promise<void> => {\n  const {\n    filename = 'download.pdf',\n    scale = 2,\n    useCORS = true,\n    backgroundColor = '#ffffff',\n    logging = false,\n    margin = 10,\n  } = options\n\n  // 使用 html2canvas 将 DOM 转换为 canvas\n  const canvas = await html2canvas(element, {\n    scale,\n    useCORS,\n    backgroundColor,\n    logging,\n  })\n\n  // 获取 canvas 的尺寸\n  const imgData = canvas.toDataURL('image/png')\n  const imgWidth = canvas.width\n  const imgHeight = canvas.height\n\n  // 创建 PDF (A4)\n  const pdf = new jsPDF('p', 'pt', 'a4')\n  const pdfWidth = pdf.internal.pageSize.getWidth()\n  const pdfHeight = pdf.internal.pageSize.getHeight()\n\n  // 计算图片在 PDF 中的尺寸\n  const imgWidthInPDF = pdfWidth - margin * 2\n  const imgHeightInPDF = (imgHeight / imgWidth) * imgWidthInPDF\n\n  let heightLeft = imgHeightInPDF\n  let position = margin\n\n  // 第一页\n  pdf.addImage(imgData, 'PNG', margin, position, imgWidthInPDF, imgHeightInPDF)\n  heightLeft -= pdfHeight - margin * 2\n\n  // 分页\n  while (heightLeft > 0) {\n    position = heightLeft - imgHeightInPDF + margin\n    pdf.addPage()\n    pdf.addImage(imgData, 'PNG', margin, position, imgWidthInPDF, imgHeightInPDF)\n    heightLeft -= pdfHeight - margin * 2\n  }\n\n  pdf.save(filename)\n}\n\n/**\n * 截取 DOM 元素为图片\n * @param element DOM 元素\n * @param options html2canvas 选项\n */\nexport const captureToImage = async (\n  element: HTMLElement,\n  options: Partial<Html2CanvasOptions> = {}\n): Promise<string> => {\n  const canvas = await html2canvas(element, {\n    scale: 2,\n    useCORS: true,\n    backgroundColor: '#ffffff',\n    logging: false,\n    ...options,\n  })\n\n  return canvas.toDataURL('image/png')\n}\n\n/**\n * 截取 DOM 元素并下载为图片\n * @param element DOM 元素\n * @param filename 文件名\n * @param options html2canvas 选项\n */\nexport const captureToImageDownload = async (\n  element: HTMLElement,\n  filename = 'screenshot.png',\n  options: Partial<Html2CanvasOptions> = {}\n): Promise<void> => {\n  const dataUrl = await captureToImage(element, options)\n\n  const link = document.createElement('a')\n  link.href = dataUrl\n  link.download = filename\n  link.click()\n}\n\n/**\n * 创建空白 PDF\n * @param options PDF 选项\n */\nexport const createPDF = (options: PDFOptions = {}): jsPDF => {\n  return new jsPDF(options)\n}\n\n/**\n * 添加文本到 PDF\n * @param pdf PDF 实例\n * @param text 文本\n * @param x X 坐标\n * @param y Y 坐标\n * @param options 选项\n */\nexport const addTextToPDF = (\n  pdf: jsPDF,\n  text: string,\n  x: number,\n  y: number,\n  options: {\n    maxWidth?: number\n    align?: 'left' | 'center' | 'right'\n    fontSize?: number\n    fontStyle?: 'normal' | 'bold' | 'italic' | 'bolditalic'\n  } = {}\n): void => {\n  const { maxWidth, align = 'left', fontSize = 12, fontStyle = 'normal' } = options\n\n  pdf.setFontSize(fontSize)\n  pdf.setFont('helvetica', fontStyle)\n  pdf.text(text, x, y, { maxWidth, align })\n}\n\n/**\n * 添加图片到 PDF\n * @param pdf PDF 实例\n * @param imageData 图片数据（DataURL 或 URL）\n * @param x X 坐标\n * @param y Y 坐标\n * @param width 宽度\n * @param height 高度\n */\nexport const addImageToPDF = (\n  pdf: jsPDF,\n  imageData: string,\n  x: number,\n  y: number,\n  width: number,\n  height: number\n): void => {\n  pdf.addImage(imageData, 'PNG', x, y, width, height)\n}\n\n/**\n * 添加表格到 PDF\n * @param pdf PDF 实例\n * @param headers 表头\n * @param data 数据\n * @param options 选项\n */\nexport const addTableToPDF = (\n  pdf: jsPDF,\n  headers: string[],\n  data: string[][],\n  options: {\n    x?: number\n    y?: number\n    cellWidth?: number\n    cellHeight?: number\n    headerBackgroundColor?: string\n    headerTextColor?: string\n    textColor?: string\n    fontSize?: number\n    lineWidth?: number\n    lineColor?: number[]\n  } = {}\n): void => {\n  const {\n    x = 10,\n    y = 10,\n    cellWidth = 50,\n    cellHeight = 20,\n    headerBackgroundColor = '#4472C4',\n    headerTextColor = '#ffffff',\n    textColor = '#000000',\n    fontSize = 10,\n    lineWidth = 0.1,\n    lineColor = [200, 200, 200],\n  } = options\n\n  pdf.setFontSize(fontSize)\n  let currentY = y\n\n  // 绘制表头\n  headers.forEach((header, index) => {\n    const cellX = x + index * cellWidth\n\n    // 绘制背景\n    pdf.setFillColor(\n      parseInt(headerBackgroundColor.slice(1, 3), 16),\n      parseInt(headerBackgroundColor.slice(3, 5), 16),\n      parseInt(headerBackgroundColor.slice(5, 7), 16)\n    )\n    pdf.rect(cellX, currentY, cellWidth, cellHeight, 'F')\n\n    // 绘制边框\n    pdf.setDrawColor(lineColor[0], lineColor[1], lineColor[2])\n    pdf.setLineWidth(lineWidth)\n    pdf.rect(cellX, currentY, cellWidth, cellHeight, 'S')\n\n    // 绘制文本\n    pdf.setTextColor(\n      parseInt(headerTextColor.slice(1, 3), 16),\n      parseInt(headerTextColor.slice(3, 5), 16),\n      parseInt(headerTextColor.slice(5, 7), 16)\n    )\n    pdf.text(header, cellX + cellWidth / 2, currentY + cellHeight / 2 + fontSize / 4, {\n      align: 'center',\n    })\n  })\n\n  currentY += cellHeight\n\n  // 绘制数据\n  pdf.setTextColor(\n    parseInt(textColor.slice(1, 3), 16),\n    parseInt(textColor.slice(3, 5), 16),\n    parseInt(textColor.slice(5, 7), 16)\n  )\n\n  data.forEach(row => {\n    row.forEach((cell, index) => {\n      const cellX = x + index * cellWidth\n\n      // 绘制边框\n      pdf.setDrawColor(lineColor[0], lineColor[1], lineColor[2])\n      pdf.setLineWidth(lineWidth)\n      pdf.rect(cellX, currentY, cellWidth, cellHeight, 'S')\n\n      // 绘制文本\n      pdf.text(cell, cellX + cellWidth / 2, currentY + cellHeight / 2 + fontSize / 4, {\n        align: 'center',\n      })\n    })\n    currentY += cellHeight\n  })\n}\n\n/**\n * 添加新页面\n * @param pdf PDF 实例\n */\nexport const addPage = (pdf: jsPDF): void => {\n  pdf.addPage()\n}\n\n/**\n * 保存 PDF\n * @param pdf PDF 实例\n * @param filename 文件名\n */\nexport const savePDF = (pdf: jsPDF, filename = 'download.pdf'): void => {\n  pdf.save(filename)\n}\n\n/**\n * PDF 转 DataURL\n * @param pdf PDF 实例\n */\nexport const pdfToDataURL = (pdf: jsPDF): string => {\n  return pdf.output('dataurlstring')\n}\n\n/**\n * PDF 转 Blob\n * @param pdf PDF 实例\n */\nexport const pdfToBlob = (pdf: jsPDF): Blob => {\n  return pdf.output('blob')\n}\n\n/**\n * 合并多个 PDF（需要使用 pdf-lib 库实现）\n * @param _pdfs PDF 实例数组\n */\nexport const mergePDFs = (_pdfs: jsPDF[]): Promise<jsPDF> => {\n  return Promise.reject(\n    new Error('mergePDFs 功能需要使用 pdf-lib 库实现。请安装 pdf-lib 并使用其提供的合并功能。')\n  )\n}\n\n/**\n * 导出 jsPDF 和 html2canvas 原始对象，方便高级用法\n */\nexport { jsPDF, html2canvas }\n"]}

package/dist/storage.cjs

@@ -0,0 +1,255 @@
+'use strict';
+
+var Cookies = require('js-cookie');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var Cookies__default = /*#__PURE__*/_interopDefault(Cookies);
+
+// src/modules/storage/index.ts
+function safeParse(json) {
+  if (!json || json === "undefined" || json === "null") {
+    return void 0;
+  }
+  try {
+    return JSON.parse(json);
+  } catch {
+    return json;
+  }
+}
+function isStorageAvailable(storage) {
+  try {
+    const testKey = "__storage_test__";
+    storage.setItem(testKey, testKey);
+    storage.removeItem(testKey);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function setLocal(key, value, options) {
+  if (!isStorageAvailable(window.localStorage)) {
+    console.warn("LocalStorage is not available");
+    return;
+  }
+  const data = options?.ttl ? {
+    value,
+    expires: Date.now() + options.ttl
+  } : value;
+  window.localStorage.setItem(key, JSON.stringify(data));
+}
+function getLocal(key) {
+  if (!isStorageAvailable(window.localStorage)) {
+    return void 0;
+  }
+  const json = window.localStorage.getItem(key);
+  if (!json) {
+    return void 0;
+  }
+  const data = safeParse(json);
+  if (data && typeof data === "object" && "expires" in data && "value" in data) {
+    if (data.expires && Date.now() > data.expires) {
+      removeLocal(key);
+      return void 0;
+    }
+    return data.value;
+  }
+  return data;
+}
+function removeLocal(key) {
+  if (isStorageAvailable(window.localStorage)) {
+    window.localStorage.removeItem(key);
+  }
+}
+function clearLocal() {
+  if (isStorageAvailable(window.localStorage)) {
+    window.localStorage.clear();
+  }
+}
+function getLocalKeys() {
+  if (!isStorageAvailable(window.localStorage)) {
+    return [];
+  }
+  return Object.keys(window.localStorage);
+}
+function getLocalSize() {
+  return getLocalKeys().length;
+}
+function setSession(key, value, options) {
+  if (!isStorageAvailable(window.sessionStorage)) {
+    console.warn("SessionStorage is not available");
+    return;
+  }
+  const data = options?.ttl ? {
+    value,
+    expires: Date.now() + options.ttl
+  } : value;
+  window.sessionStorage.setItem(key, JSON.stringify(data));
+}
+function getSession(key) {
+  if (!isStorageAvailable(window.sessionStorage)) {
+    return void 0;
+  }
+  const json = window.sessionStorage.getItem(key);
+  if (!json) {
+    return void 0;
+  }
+  const data = safeParse(json);
+  if (data && typeof data === "object" && "expires" in data && "value" in data) {
+    if (data.expires && Date.now() > data.expires) {
+      removeSession(key);
+      return void 0;
+    }
+    return data.value;
+  }
+  return data;
+}
+function removeSession(key) {
+  if (isStorageAvailable(window.sessionStorage)) {
+    window.sessionStorage.removeItem(key);
+  }
+}
+function clearSession() {
+  if (isStorageAvailable(window.sessionStorage)) {
+    window.sessionStorage.clear();
+  }
+}
+function getSessionKeys() {
+  if (!isStorageAvailable(window.sessionStorage)) {
+    return [];
+  }
+  return Object.keys(window.sessionStorage);
+}
+function getSessionSize() {
+  return getSessionKeys().length;
+}
+function setCookie(key, value, options) {
+  const cookieOptions = {};
+  if (options?.days) {
+    cookieOptions.expires = options.days;
+  } else if (options?.expires !== void 0) {
+    cookieOptions.expires = options.expires;
+  }
+  if (options?.path !== void 0) {
+    cookieOptions.path = options.path;
+  }
+  if (options?.domain !== void 0) {
+    cookieOptions.domain = options.domain;
+  }
+  if (options?.secure !== void 0) {
+    cookieOptions.secure = options.secure;
+  }
+  if (options?.sameSite !== void 0) {
+    cookieOptions.sameSite = options.sameSite;
+  }
+  Cookies__default.default.set(key, value, cookieOptions);
+}
+function getCookie(key) {
+  return Cookies__default.default.get(key);
+}
+function removeCookie(key, options) {
+  Cookies__default.default.remove(key, options);
+}
+function getAllCookies() {
+  return Cookies__default.default.get() || {};
+}
+function hasCookie(key) {
+  return Cookies__default.default.get(key) !== void 0;
+}
+function getCookieJSON(key) {
+  const value = Cookies__default.default.get(key);
+  if (!value) {
+    return void 0;
+  }
+  try {
+    return JSON.parse(value);
+  } catch {
+    return void 0;
+  }
+}
+function setCookieJSON(key, value, options) {
+  setCookie(key, JSON.stringify(value), options);
+}
+function getCookieSize() {
+  return Object.keys(getAllCookies()).length;
+}
+function setStorage(type, key, value, options) {
+  switch (type) {
+    case "local":
+      setLocal(key, value, options);
+      break;
+    case "session":
+      setSession(key, value, options);
+      break;
+    case "cookie":
+      setCookie(key, value, options);
+      break;
+  }
+}
+function getStorage(type, key) {
+  switch (type) {
+    case "local":
+      return getLocal(key);
+    case "session":
+      return getSession(key);
+    case "cookie":
+      return getCookie(key);
+  }
+}
+function removeStorage(type, key) {
+  switch (type) {
+    case "local":
+      removeLocal(key);
+      break;
+    case "session":
+      removeSession(key);
+      break;
+    case "cookie":
+      removeCookie(key);
+      break;
+  }
+}
+function clearStorage(type) {
+  switch (type) {
+    case "local":
+      clearLocal();
+      break;
+    case "session":
+      clearSession();
+      break;
+    case "cookie": {
+      const cookies = getAllCookies();
+      for (const key of Object.keys(cookies)) {
+        removeCookie(key);
+      }
+      break;
+    }
+  }
+}
+
+exports.clearLocal = clearLocal;
+exports.clearSession = clearSession;
+exports.clearStorage = clearStorage;
+exports.getAllCookies = getAllCookies;
+exports.getCookie = getCookie;
+exports.getCookieJSON = getCookieJSON;
+exports.getCookieSize = getCookieSize;
+exports.getLocal = getLocal;
+exports.getLocalKeys = getLocalKeys;
+exports.getLocalSize = getLocalSize;
+exports.getSession = getSession;
+exports.getSessionKeys = getSessionKeys;
+exports.getSessionSize = getSessionSize;
+exports.getStorage = getStorage;
+exports.hasCookie = hasCookie;
+exports.removeCookie = removeCookie;
+exports.removeLocal = removeLocal;
+exports.removeSession = removeSession;
+exports.removeStorage = removeStorage;
+exports.setCookie = setCookie;
+exports.setCookieJSON = setCookieJSON;
+exports.setLocal = setLocal;
+exports.setSession = setSession;
+exports.setStorage = setStorage;
+//# sourceMappingURL=storage.cjs.map
+//# sourceMappingURL=storage.cjs.map

package/dist/storage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/modules/storage/index.ts"],"names":["Cookies"],"mappings":"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","file":"storage.cjs","sourcesContent":["/**\n * Storage Module - 浏览器存储工具\n *\n * 提供统一的浏览器存储操作 API\n */\n\nimport Cookies from 'js-cookie'\n\n// ==================== 类型定义 ====================\n\n/**\n * 存储数据类型\n */\nexport type StorageValue = string | number | boolean | null | undefined | object | unknown[]\n\n/**\n * 存储选项\n */\nexport interface StorageOptions {\n  /** 过期时间（毫秒），0 表示永不过期 */\n  ttl?: number\n}\n\n/**\n * Cookie 选项\n */\nexport interface CookieOptions extends Cookies.CookieAttributes {\n  /** 过期天数 */\n  days?: number\n}\n\n// ==================== 工具函数 ====================\n\n/**\n * 安全解析 JSON\n */\nfunction safeParse<T = StorageValue>(json: string | null): T | undefined {\n  if (!json || json === 'undefined' || json === 'null') {\n    return undefined\n  }\n  try {\n    return JSON.parse(json) as T\n  } catch {\n    return json as T\n  }\n}\n\n/**\n * 检查存储是否可用\n */\nfunction isStorageAvailable(storage: Storage): boolean {\n  try {\n    const testKey = '__storage_test__'\n    storage.setItem(testKey, testKey)\n    storage.removeItem(testKey)\n    return true\n  } catch {\n    return false\n  }\n}\n\n// ==================== LocalStorage ====================\n\n/**\n * 设置永久缓存\n * @param key - 缓存名称\n * @param value - 缓存内容\n * @param options - 存储选项\n * @example\n * ```ts\n * setLocal('user', { name: 'Alice', age: 25 })\n * setLocal('token', 'abc123', { ttl: 3600000 }) // 1小时后过期\n * ```\n */\nexport function setLocal<T = StorageValue>(key: string, value: T, options?: StorageOptions): void {\n  if (!isStorageAvailable(window.localStorage)) {\n    console.warn('LocalStorage is not available')\n    return\n  }\n\n  const data = options?.ttl\n    ? {\n        value,\n        expires: Date.now() + options.ttl,\n      }\n    : value\n\n  window.localStorage.setItem(key, JSON.stringify(data))\n}\n\n/**\n * 获取永久缓存\n * @param key - 缓存名称\n * @returns 缓存内容，不存在或已过期返回 undefined\n * @example\n * ```ts\n * const user = getLocal<{ name: string; age: number }>('user')\n * console.log(user?.name) // 'Alice'\n * ```\n */\nexport function getLocal<T = StorageValue>(key: string): T | undefined {\n  if (!isStorageAvailable(window.localStorage)) {\n    return undefined\n  }\n\n  const json = window.localStorage.getItem(key)\n  if (!json) {\n    return undefined\n  }\n\n  const data = safeParse<{ value: T; expires?: number }>(json)\n\n  // 检查是否有过期时间\n  if (data && typeof data === 'object' && 'expires' in data && 'value' in data) {\n    if (data.expires && Date.now() > data.expires) {\n      removeLocal(key)\n      return undefined\n    }\n    return data.value\n  }\n\n  return data as T\n}\n\n/**\n * 移除永久缓存\n * @param key - 缓存名称\n * @example\n * ```ts\n * removeLocal('user')\n * ```\n */\nexport function removeLocal(key: string): void {\n  if (isStorageAvailable(window.localStorage)) {\n    window.localStorage.removeItem(key)\n  }\n}\n\n/**\n * 移除全部永久缓存\n * @example\n * ```ts\n * clearLocal()\n * ```\n */\nexport function clearLocal(): void {\n  if (isStorageAvailable(window.localStorage)) {\n    window.localStorage.clear()\n  }\n}\n\n/**\n * 获取所有 localStorage 的键\n * @returns 键数组\n */\nexport function getLocalKeys(): string[] {\n  if (!isStorageAvailable(window.localStorage)) {\n    return []\n  }\n  return Object.keys(window.localStorage)\n}\n\n/**\n * 获取 localStorage 中键的数量\n * @returns 键的数量\n */\nexport function getLocalSize(): number {\n  return getLocalKeys().length\n}\n\n// ==================== SessionStorage ====================\n\n/**\n * 设置临时缓存\n * @param key - 缓存名称\n * @param value - 缓存内容\n * @param options - 存储选项\n * @example\n * ```ts\n * setSession('temp', { data: [1, 2, 3] })\n * setSession('session', 'abc123', { ttl: 60000 }) // 1分钟后过期\n * ```\n */\nexport function setSession<T = StorageValue>(\n  key: string,\n  value: T,\n  options?: StorageOptions\n): void {\n  if (!isStorageAvailable(window.sessionStorage)) {\n    console.warn('SessionStorage is not available')\n    return\n  }\n\n  const data = options?.ttl\n    ? {\n        value,\n        expires: Date.now() + options.ttl,\n      }\n    : value\n\n  window.sessionStorage.setItem(key, JSON.stringify(data))\n}\n\n/**\n * 获取临时缓存\n * @param key - 缓存名称\n * @returns 缓存内容，不存在或已过期返回 undefined\n * @example\n * ```ts\n * const temp = getSession<{ data: number[] }>('temp')\n * console.log(temp?.data) // [1, 2, 3]\n * ```\n */\nexport function getSession<T = StorageValue>(key: string): T | undefined {\n  if (!isStorageAvailable(window.sessionStorage)) {\n    return undefined\n  }\n\n  const json = window.sessionStorage.getItem(key)\n  if (!json) {\n    return undefined\n  }\n\n  const data = safeParse<{ value: T; expires?: number }>(json)\n\n  // 检查是否有过期时间\n  if (data && typeof data === 'object' && 'expires' in data && 'value' in data) {\n    if (data.expires && Date.now() > data.expires) {\n      removeSession(key)\n      return undefined\n    }\n    return data.value\n  }\n\n  return data as T\n}\n\n/**\n * 移除临时缓存\n * @param key - 缓存名称\n * @example\n * ```ts\n * removeSession('temp')\n * ```\n */\nexport function removeSession(key: string): void {\n  if (isStorageAvailable(window.sessionStorage)) {\n    window.sessionStorage.removeItem(key)\n  }\n}\n\n/**\n * 移除全部临时缓存\n * @example\n * ```ts\n * clearSession()\n * ```\n */\nexport function clearSession(): void {\n  if (isStorageAvailable(window.sessionStorage)) {\n    window.sessionStorage.clear()\n  }\n}\n\n/**\n * 获取所有 sessionStorage 的键\n * @returns 键数组\n */\nexport function getSessionKeys(): string[] {\n  if (!isStorageAvailable(window.sessionStorage)) {\n    return []\n  }\n  return Object.keys(window.sessionStorage)\n}\n\n/**\n * 获取 sessionStorage 中键的数量\n * @returns 键的数量\n */\nexport function getSessionSize(): number {\n  return getSessionKeys().length\n}\n\n// ==================== Cookie ====================\n\n/**\n * 设置 Cookie\n * @param key - Cookie 名称\n * @param value - Cookie 值\n * @param options - Cookie 选项\n * @example\n * ```ts\n * setCookie('token', 'abc123', { days: 7 })\n * setCookie('user', { name: 'Alice' }, { secure: true }) // 自动序列化对象\n * ```\n */\nexport function setCookie(key: string, value: string | object, options?: CookieOptions): void {\n  const cookieOptions: Cookies.CookieAttributes = {}\n\n  // 处理过期时间\n  if (options?.days) {\n    cookieOptions.expires = options.days\n  } else if (options?.expires !== undefined) {\n    cookieOptions.expires = options.expires\n  }\n\n  // 复制其他选项\n  if (options?.path !== undefined) {\n    cookieOptions.path = options.path\n  }\n  if (options?.domain !== undefined) {\n    cookieOptions.domain = options.domain\n  }\n  if (options?.secure !== undefined) {\n    cookieOptions.secure = options.secure\n  }\n  if (options?.sameSite !== undefined) {\n    cookieOptions.sameSite = options.sameSite\n  }\n\n  // 设置 cookie\n  Cookies.set(key, value as any, cookieOptions)\n}\n\n/**\n * 获取 Cookie\n * @param key - Cookie 名称\n * @returns Cookie 值，不存在返回 undefined\n * @example\n * ```ts\n * const token = getCookie('token')\n * console.log(token) // 'abc123'\n * ```\n */\nexport function getCookie(key: string): string | undefined {\n  return Cookies.get(key)\n}\n\n/**\n * 移除 Cookie\n * @param key - Cookie 名称\n * @param options - Cookie 选项（需要匹配设置时的 path 和 domain）\n * @example\n * ```ts\n * removeCookie('token')\n * removeCookie('user', { path: '/', domain: '.example.com' })\n * ```\n */\nexport function removeCookie(key: string, options?: CookieOptions): void {\n  Cookies.remove(key, options)\n}\n\n/**\n * 获取所有 Cookie\n * @returns Cookie 对象\n * @example\n * ```ts\n * const cookies = getAllCookies()\n * console.log(cookies) // { token: 'abc123', user: '{\"name\":\"Alice\"}' }\n * ```\n */\nexport function getAllCookies(): Record<string, string> {\n  return Cookies.get() || {}\n}\n\n/**\n * 检查 Cookie 是否存在\n * @param key - Cookie 名称\n * @returns 是否存在\n * @example\n * ```ts\n * if (hasCookie('token')) {\n *   console.log('Token exists')\n * }\n * ```\n */\nexport function hasCookie(key: string): boolean {\n  return Cookies.get(key) !== undefined\n}\n\n/**\n * 获取 JSON 格式的 Cookie\n * @param key - Cookie 名称\n * @returns 解析后的对象，不存在或解析失败返回 undefined\n * @example\n * ```ts\n * const user = getCookieJSON<{ name: string; age: number }>('user')\n * console.log(user?.name) // 'Alice'\n * ```\n */\nexport function getCookieJSON<T = object>(key: string): T | undefined {\n  const value = Cookies.get(key)\n  if (!value) {\n    return undefined\n  }\n  try {\n    return JSON.parse(value) as T\n  } catch {\n    return undefined\n  }\n}\n\n/**\n * 设置 JSON 格式的 Cookie（自动序列化）\n * @param key - Cookie 名称\n * @param value - 对象值\n * @param options - Cookie 选项\n * @example\n * ```ts\n * setCookieJSON('user', { name: 'Alice', age: 25 }, { days: 7 })\n * ```\n */\nexport function setCookieJSON<T = object>(key: string, value: T, options?: CookieOptions): void {\n  setCookie(key, JSON.stringify(value), options)\n}\n\n/**\n * 获取所有 Cookie 的数量\n * @returns Cookie 数量\n * @example\n * ```ts\n * console.log(getCookieSize()) // 3\n * ```\n */\nexport function getCookieSize(): number {\n  return Object.keys(getAllCookies()).length\n}\n\n// ==================== 统一接口 ====================\n\n/**\n * 存储类型\n */\nexport type StorageType = 'local' | 'session' | 'cookie'\n\n/**\n * 统一设置存储\n * @param type - 存储类型\n * @param key - 键\n * @param value - 值\n * @param options - 选项\n * @example\n * ```ts\n * setStorage('local', 'user', { name: 'Alice' })\n * setStorage('cookie', 'token', 'abc123', { days: 7 })\n * ```\n */\nexport function setStorage<T extends string | object>(\n  type: 'local',\n  key: string,\n  value: T,\n  options?: StorageOptions\n): void\nexport function setStorage<T extends string | object>(\n  type: 'session',\n  key: string,\n  value: T,\n  options?: StorageOptions\n): void\nexport function setStorage<T extends string | object>(\n  type: 'cookie',\n  key: string,\n  value: T,\n  options?: CookieOptions\n): void\nexport function setStorage<T extends string | object>(\n  type: StorageType,\n  key: string,\n  value: T,\n  options?: StorageOptions | CookieOptions\n): void {\n  switch (type) {\n    case 'local':\n      setLocal(key, value, options as StorageOptions)\n      break\n    case 'session':\n      setSession(key, value, options as StorageOptions)\n      break\n    case 'cookie':\n      setCookie(key, value, options as CookieOptions)\n      break\n  }\n}\n\n/**\n * 统一获取存储\n * @param type - 存储类型\n * @param key - 键\n * @returns 值\n * @example\n * ```ts\n * const user = getStorage<{ name: string }>('local', 'user')\n * const token = getStorage('cookie', 'token')\n * ```\n */\nexport function getStorage<T = StorageValue>(type: 'local', key: string): T | undefined\nexport function getStorage<T = StorageValue>(type: 'session', key: string): T | undefined\nexport function getStorage(type: 'cookie', key: string): string | undefined\nexport function getStorage<T = StorageValue>(\n  type: StorageType,\n  key: string\n): T | string | undefined {\n  switch (type) {\n    case 'local':\n      return getLocal<T>(key)\n    case 'session':\n      return getSession<T>(key)\n    case 'cookie':\n      return getCookie(key)\n  }\n}\n\n/**\n * 统一移除存储\n * @param type - 存储类型\n * @param key - 键\n * @example\n * ```ts\n * removeStorage('local', 'user')\n * removeStorage('cookie', 'token')\n * ```\n */\nexport function removeStorage(type: StorageType, key: string): void {\n  switch (type) {\n    case 'local':\n      removeLocal(key)\n      break\n    case 'session':\n      removeSession(key)\n      break\n    case 'cookie':\n      removeCookie(key)\n      break\n  }\n}\n\n/**\n * 统一清除存储\n * @param type - 存储类型\n * @example\n * ```ts\n * clearStorage('local')\n * clearStorage('session')\n * clearStorage('cookie') // 注意：cookie 只能逐个删除\n * ```\n */\nexport function clearStorage(type: StorageType): void {\n  switch (type) {\n    case 'local':\n      clearLocal()\n      break\n    case 'session':\n      clearSession()\n      break\n    case 'cookie': {\n      const cookies = getAllCookies()\n      for (const key of Object.keys(cookies)) {\n        removeCookie(key)\n      }\n      break\n    }\n  }\n}\n"]}

package/dist/storage.d.cts

@@ -0,0 +1 @@
+export { C as CookieOptions, S as StorageOptions, a as StorageType, b as StorageValue, c as clearLocal, d as clearSession, e as clearStorage, g as getAllCookies, f as getCookie, h as getCookieJSON, j as getCookieSize, k as getLocal, l as getLocalKeys, m as getLocalSize, n as getSession, o as getSessionKeys, p as getSessionSize, q as getStorage, r as hasCookie, s as removeCookie, t as removeLocal, u as removeSession, v as removeStorage, w as setCookie, x as setCookieJSON, y as setLocal, z as setSession, A as setStorage } from './index-Ba1rjTzj.cjs';

package/dist/storage.d.ts

@@ -0,0 +1 @@
+export { C as CookieOptions, S as StorageOptions, a as StorageType, b as StorageValue, c as clearLocal, d as clearSession, e as clearStorage, g as getAllCookies, f as getCookie, h as getCookieJSON, j as getCookieSize, k as getLocal, l as getLocalKeys, m as getLocalSize, n as getSession, o as getSessionKeys, p as getSessionSize, q as getStorage, r as hasCookie, s as removeCookie, t as removeLocal, u as removeSession, v as removeStorage, w as setCookie, x as setCookieJSON, y as setLocal, z as setSession, A as setStorage } from './index-Ba1rjTzj.js';