@zag-js/file-utils 0.22.0 → 0.24.0

package/dist/index.d.mts

@@ -1,4 +1,11 @@
-declare const formatBytes: (bytes: number, decimals?: number) => string;
+declare function downloadFile(fileOrUrl: File | string, win: typeof window): void;
+
+interface FormatByteOptions {
+    locale?: string;
+}
+declare const formatFileSize: (bytes: number, options?: FormatByteOptions) => string;
+
+declare function getAcceptAttrString(accept: Record<string, string[]> | string | undefined): string | undefined;
 
 declare const getFileDataUrl: (file: File | Blob) => Promise<string | undefined>;
 
@@ -6,4 +13,8 @@ declare const getTotalFileSize: (files: File[]) => number;
 
 declare const isFileEqual: (file1: File, file2: File) => boolean;
 
-export { formatBytes, getFileDataUrl, getTotalFileSize, isFileEqual };
+declare function isValidFileSize(file: File, minSize?: number, maxSize?: number): [boolean, string | null];
+
+declare function isValidFileType(file: File, accept: string | undefined): [boolean, string | null];
+
+export { downloadFile, formatFileSize, getAcceptAttrString, getFileDataUrl, getTotalFileSize, isFileEqual, isValidFileSize, isValidFileType };

package/dist/index.d.ts

@@ -1,4 +1,11 @@
-declare const formatBytes: (bytes: number, decimals?: number) => string;
+declare function downloadFile(fileOrUrl: File | string, win: typeof window): void;
+
+interface FormatByteOptions {
+    locale?: string;
+}
+declare const formatFileSize: (bytes: number, options?: FormatByteOptions) => string;
+
+declare function getAcceptAttrString(accept: Record<string, string[]> | string | undefined): string | undefined;
 
 declare const getFileDataUrl: (file: File | Blob) => Promise<string | undefined>;
 
@@ -6,4 +13,8 @@ declare const getTotalFileSize: (files: File[]) => number;
 
 declare const isFileEqual: (file1: File, file2: File) => boolean;
 
-export { formatBytes, getFileDataUrl, getTotalFileSize, isFileEqual };
+declare function isValidFileSize(file: File, minSize?: number, maxSize?: number): [boolean, string | null];
+
+declare function isValidFileType(file: File, accept: string | undefined): [boolean, string | null];
+
+export { downloadFile, formatFileSize, getAcceptAttrString, getFileDataUrl, getTotalFileSize, isFileEqual, isValidFileSize, isValidFileType };

package/dist/index.js

@@ -20,25 +20,63 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
-  formatBytes: () => formatBytes,
+  downloadFile: () => downloadFile,
+  formatFileSize: () => formatFileSize,
+  getAcceptAttrString: () => getAcceptAttrString,
   getFileDataUrl: () => getFileDataUrl,
   getTotalFileSize: () => getTotalFileSize,
-  isFileEqual: () => isFileEqual
+  isFileEqual: () => isFileEqual,
+  isValidFileSize: () => isValidFileSize,
+  isValidFileType: () => isValidFileType
 });
 module.exports = __toCommonJS(src_exports);
 
-// src/format-bytes.ts
-var SIZES = ["Bytes", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"];
+// src/download-file.ts
+function downloadFile(fileOrUrl, win) {
+  const doc = win.document;
+  const objectUrl = typeof fileOrUrl === "string" ? fileOrUrl : win.URL.createObjectURL(fileOrUrl);
+  const anchor = doc.createElement("a");
+  anchor.style.display = "none";
+  anchor.href = objectUrl;
+  anchor.download = typeof fileOrUrl === "string" ? objectUrl : fileOrUrl.name;
+  doc.body.appendChild(anchor);
+  anchor.click();
+  setTimeout(() => {
+    if (typeof fileOrUrl !== "string") {
+      win.URL.revokeObjectURL(objectUrl);
+    }
+    anchor?.parentNode?.removeChild(anchor);
+  }, 0);
+}
+
+// src/format-file-size.ts
+var SIZES = ["B", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"];
 var KILO = 1024;
-var formatBytes = (bytes, decimals = 2) => {
-  if (bytes === 0) {
-    return "0 Bytes";
-  }
-  const dm = decimals <= 0 ? 0 : decimals || 2;
+var formatFileSize = (bytes, options = {}) => {
+  const { locale = "en-US" } = options;
+  if (bytes === 0)
+    return "0 B";
   const i = Math.floor(Math.log(bytes) / Math.log(KILO));
-  return parseFloat((bytes / Math.pow(KILO, i)).toFixed(dm)) + " " + SIZES[i];
+  const fileSize = bytes / Math.pow(KILO, i);
+  const formattedSize = new Intl.NumberFormat(locale).format(fileSize);
+  return `${formattedSize} ${SIZES[i]}`;
 };
 
+// src/get-accept-attr.ts
+function isMIMEType(v) {
+  return v === "audio/*" || v === "video/*" || v === "image/*" || v === "text/*" || /\w+\/[-+.\w]+/g.test(v);
+}
+function isExt(v) {
+  return /^.*\.[\w]+$/.test(v);
+}
+function getAcceptAttrString(accept) {
+  if (!accept)
+    return;
+  if (typeof accept === "string")
+    return accept;
+  return Object.entries(accept).reduce((a, [mimeType, ext]) => [...a, mimeType, ...ext], []).filter((v) => isMIMEType(v) || isExt(v)).join(",");
+}
+
 // src/get-file-data-url.ts
 var getFileDataUrl = async (file) => {
   const reader = new FileReader();
@@ -68,11 +106,58 @@ var getTotalFileSize = (files) => {
 var isFileEqual = (file1, file2) => {
   return file1.name === file2.name && file1.size === file2.size && file1.type === file2.type;
 };
+
+// src/is-valid-file-size.ts
+var isDefined = (v) => v !== void 0 && v !== null;
+function isValidFileSize(file, minSize, maxSize) {
+  if (isDefined(file.size)) {
+    if (isDefined(minSize) && isDefined(maxSize)) {
+      if (file.size > maxSize)
+        return [false, "TOO_LARGE"];
+      if (file.size < minSize)
+        return [false, "TOO_SMALL"];
+    } else if (isDefined(minSize) && file.size < minSize) {
+      return [false, "TOO_SMALL"];
+    } else if (isDefined(maxSize) && file.size > maxSize) {
+      return [false, "TOO_LARGE"];
+    }
+  }
+  return [true, null];
+}
+
+// src/is-valid-file-type.ts
+function isFileAccepted(file, accept) {
+  if (file && accept) {
+    const types = Array.isArray(accept) ? accept : accept.split(",");
+    const fileName = file.name || "";
+    const mimeType = (file.type || "").toLowerCase();
+    const baseMimeType = mimeType.replace(/\/.*$/, "");
+    return types.some((type) => {
+      const validType = type.trim().toLowerCase();
+      if (validType.charAt(0) === ".") {
+        return fileName.toLowerCase().endsWith(validType);
+      }
+      if (validType.endsWith("/*")) {
+        return baseMimeType === validType.replace(/\/.*$/, "");
+      }
+      return mimeType === validType;
+    });
+  }
+  return true;
+}
+function isValidFileType(file, accept) {
+  const isAcceptable = file.type === "application/x-moz-file" || isFileAccepted(file, accept);
+  return [isAcceptable, isAcceptable ? null : "FILE_INVALID_TYPE"];
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  formatBytes,
+  downloadFile,
+  formatFileSize,
+  getAcceptAttrString,
   getFileDataUrl,
   getTotalFileSize,
-  isFileEqual
+  isFileEqual,
+  isValidFileSize,
+  isValidFileType
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/format-bytes.ts","../src/get-file-data-url.ts","../src/get-total-file-size.ts","../src/is-file-equal.ts"],"sourcesContent":["export * from \"./format-bytes\"\nexport * from \"./get-file-data-url\"\nexport * from \"./get-total-file-size\"\nexport * from \"./is-file-equal\"\n","const SIZES = [\"Bytes\", \"KB\", \"MB\", \"GB\", \"TB\", \"PB\", \"EB\", \"ZB\", \"YB\"]\nconst KILO = 1024\n\nexport const formatBytes = (bytes: number, decimals = 2) => {\n  if (bytes === 0) {\n    return \"0 Bytes\"\n  }\n  const dm = decimals <= 0 ? 0 : decimals || 2\n  const i = Math.floor(Math.log(bytes) / Math.log(KILO))\n  return parseFloat((bytes / Math.pow(KILO, i)).toFixed(dm)) + \" \" + SIZES[i]\n}\n","export const getFileDataUrl = async (file: File | Blob) => {\n  const reader = new FileReader()\n  return new Promise<string | undefined>((resolve, reject) => {\n    reader.onerror = () => {\n      reader.abort()\n      reject(new Error(\"There was an error reading a file\"))\n    }\n\n    reader.onloadend = () => {\n      const { result } = reader\n      if (result instanceof ArrayBuffer) {\n        reject(new Error(\"Expected DataURL as string from Blob/File, got ArrayBuffer\"))\n      } else {\n        resolve(result || undefined)\n      }\n    }\n\n    reader.readAsDataURL(file)\n  })\n}\n","export const getTotalFileSize = (files: File[]) => {\n  return files.reduce((acc, file) => acc + file.size, 0)\n}\n","export const isFileEqual = (file1: File, file2: File) => {\n  return file1.name === file2.name && file1.size === file2.size && file1.type === file2.type\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,IAAM,QAAQ,CAAC,SAAS,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,IAAI;AACtE,IAAM,OAAO;AAEN,IAAM,cAAc,CAAC,OAAe,WAAW,MAAM;AAC1D,MAAI,UAAU,GAAG;AACf,WAAO;AAAA,EACT;AACA,QAAM,KAAK,YAAY,IAAI,IAAI,YAAY;AAC3C,QAAM,IAAI,KAAK,MAAM,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,IAAI,CAAC;AACrD,SAAO,YAAY,QAAQ,KAAK,IAAI,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC,IAAI,MAAM,MAAM,CAAC;AAC5E;;;ACVO,IAAM,iBAAiB,OAAO,SAAsB;AACzD,QAAM,SAAS,IAAI,WAAW;AAC9B,SAAO,IAAI,QAA4B,CAAC,SAAS,WAAW;AAC1D,WAAO,UAAU,MAAM;AACrB,aAAO,MAAM;AACb,aAAO,IAAI,MAAM,mCAAmC,CAAC;AAAA,IACvD;AAEA,WAAO,YAAY,MAAM;AACvB,YAAM,EAAE,OAAO,IAAI;AACnB,UAAI,kBAAkB,aAAa;AACjC,eAAO,IAAI,MAAM,4DAA4D,CAAC;AAAA,MAChF,OAAO;AACL,gBAAQ,UAAU,MAAS;AAAA,MAC7B;AAAA,IACF;AAEA,WAAO,cAAc,IAAI;AAAA,EAC3B,CAAC;AACH;;;ACnBO,IAAM,mBAAmB,CAAC,UAAkB;AACjD,SAAO,MAAM,OAAO,CAAC,KAAK,SAAS,MAAM,KAAK,MAAM,CAAC;AACvD;;;ACFO,IAAM,cAAc,CAAC,OAAa,UAAgB;AACvD,SAAO,MAAM,SAAS,MAAM,QAAQ,MAAM,SAAS,MAAM,QAAQ,MAAM,SAAS,MAAM;AACxF;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/download-file.ts","../src/format-file-size.ts","../src/get-accept-attr.ts","../src/get-file-data-url.ts","../src/get-total-file-size.ts","../src/is-file-equal.ts","../src/is-valid-file-size.ts","../src/is-valid-file-type.ts"],"sourcesContent":["export * from \"./download-file\"\nexport * from \"./format-file-size\"\nexport * from \"./get-accept-attr\"\nexport * from \"./get-file-data-url\"\nexport * from \"./get-total-file-size\"\nexport * from \"./is-file-equal\"\nexport * from \"./is-valid-file-size\"\nexport * from \"./is-valid-file-type\"\n","export function downloadFile(fileOrUrl: File | string, win: typeof window) {\n  const doc = win.document\n  const objectUrl = typeof fileOrUrl === \"string\" ? fileOrUrl : win.URL.createObjectURL(fileOrUrl)\n\n  const anchor = doc.createElement(\"a\")\n  anchor.style.display = \"none\"\n  anchor.href = objectUrl\n  anchor.download = typeof fileOrUrl === \"string\" ? objectUrl : fileOrUrl.name\n\n  doc.body.appendChild(anchor)\n  anchor.click()\n\n  setTimeout(() => {\n    if (typeof fileOrUrl !== \"string\") {\n      win.URL.revokeObjectURL(objectUrl)\n    }\n    anchor?.parentNode?.removeChild(anchor)\n  }, 0)\n}\n","const SIZES = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\", \"PB\", \"EB\", \"ZB\", \"YB\"]\nconst KILO = 1024\n\ninterface FormatByteOptions {\n  locale?: string\n}\n\nexport const formatFileSize = (bytes: number, options: FormatByteOptions = {}) => {\n  const { locale = \"en-US\" } = options\n  if (bytes === 0) return \"0 B\"\n\n  const i = Math.floor(Math.log(bytes) / Math.log(KILO))\n  const fileSize = bytes / Math.pow(KILO, i)\n\n  const formattedSize = new Intl.NumberFormat(locale).format(fileSize)\n  return `${formattedSize} ${SIZES[i]}`\n}\n","function isMIMEType(v: string) {\n  return v === \"audio/*\" || v === \"video/*\" || v === \"image/*\" || v === \"text/*\" || /\\w+\\/[-+.\\w]+/g.test(v)\n}\n\nfunction isExt(v: string) {\n  return /^.*\\.[\\w]+$/.test(v)\n}\n\nexport function getAcceptAttrString(accept: Record<string, string[]> | string | undefined) {\n  if (!accept) return\n  if (typeof accept === \"string\") return accept\n  return Object.entries(accept)\n    .reduce((a, [mimeType, ext]) => [...a, mimeType, ...ext], [] as string[])\n    .filter((v) => isMIMEType(v) || isExt(v))\n    .join(\",\")\n}\n","export const getFileDataUrl = async (file: File | Blob) => {\n  const reader = new FileReader()\n  return new Promise<string | undefined>((resolve, reject) => {\n    reader.onerror = () => {\n      reader.abort()\n      reject(new Error(\"There was an error reading a file\"))\n    }\n\n    reader.onloadend = () => {\n      const { result } = reader\n      if (result instanceof ArrayBuffer) {\n        reject(new Error(\"Expected DataURL as string from Blob/File, got ArrayBuffer\"))\n      } else {\n        resolve(result || undefined)\n      }\n    }\n\n    reader.readAsDataURL(file)\n  })\n}\n","export const getTotalFileSize = (files: File[]) => {\n  return files.reduce((acc, file) => acc + file.size, 0)\n}\n","export const isFileEqual = (file1: File, file2: File) => {\n  return file1.name === file2.name && file1.size === file2.size && file1.type === file2.type\n}\n","const isDefined = <T>(v: T | undefined): v is T => v !== undefined && v !== null\n\nexport function isValidFileSize(file: File, minSize?: number, maxSize?: number): [boolean, string | null] {\n  if (isDefined(file.size)) {\n    if (isDefined(minSize) && isDefined(maxSize)) {\n      if (file.size > maxSize) return [false, \"TOO_LARGE\"]\n      if (file.size < minSize) return [false, \"TOO_SMALL\"]\n    } else if (isDefined(minSize) && file.size < minSize) {\n      return [false, \"TOO_SMALL\"]\n    } else if (isDefined(maxSize) && file.size > maxSize) {\n      return [false, \"TOO_LARGE\"]\n    }\n  }\n  return [true, null]\n}\n","function isFileAccepted(file: File | null, accept: string[] | string | undefined) {\n  if (file && accept) {\n    const types = Array.isArray(accept) ? accept : accept.split(\",\")\n\n    const fileName = file.name || \"\"\n    const mimeType = (file.type || \"\").toLowerCase()\n    const baseMimeType = mimeType.replace(/\\/.*$/, \"\")\n\n    return types.some((type) => {\n      const validType = type.trim().toLowerCase()\n\n      if (validType.charAt(0) === \".\") {\n        return fileName.toLowerCase().endsWith(validType)\n      }\n\n      if (validType.endsWith(\"/*\")) {\n        return baseMimeType === validType.replace(/\\/.*$/, \"\")\n      }\n\n      return mimeType === validType\n    })\n  }\n  return true\n}\n\nexport function isValidFileType(file: File, accept: string | undefined): [boolean, string | null] {\n  const isAcceptable = file.type === \"application/x-moz-file\" || isFileAccepted(file, accept)\n  return [isAcceptable, isAcceptable ? null : \"FILE_INVALID_TYPE\"]\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -1,15 +1,49 @@
-// src/format-bytes.ts
-var SIZES = ["Bytes", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"];
+// src/download-file.ts
+function downloadFile(fileOrUrl, win) {
+  const doc = win.document;
+  const objectUrl = typeof fileOrUrl === "string" ? fileOrUrl : win.URL.createObjectURL(fileOrUrl);
+  const anchor = doc.createElement("a");
+  anchor.style.display = "none";
+  anchor.href = objectUrl;
+  anchor.download = typeof fileOrUrl === "string" ? objectUrl : fileOrUrl.name;
+  doc.body.appendChild(anchor);
+  anchor.click();
+  setTimeout(() => {
+    if (typeof fileOrUrl !== "string") {
+      win.URL.revokeObjectURL(objectUrl);
+    }
+    anchor?.parentNode?.removeChild(anchor);
+  }, 0);
+}
+
+// src/format-file-size.ts
+var SIZES = ["B", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"];
 var KILO = 1024;
-var formatBytes = (bytes, decimals = 2) => {
-  if (bytes === 0) {
-    return "0 Bytes";
-  }
-  const dm = decimals <= 0 ? 0 : decimals || 2;
+var formatFileSize = (bytes, options = {}) => {
+  const { locale = "en-US" } = options;
+  if (bytes === 0)
+    return "0 B";
   const i = Math.floor(Math.log(bytes) / Math.log(KILO));
-  return parseFloat((bytes / Math.pow(KILO, i)).toFixed(dm)) + " " + SIZES[i];
+  const fileSize = bytes / Math.pow(KILO, i);
+  const formattedSize = new Intl.NumberFormat(locale).format(fileSize);
+  return `${formattedSize} ${SIZES[i]}`;
 };
 
+// src/get-accept-attr.ts
+function isMIMEType(v) {
+  return v === "audio/*" || v === "video/*" || v === "image/*" || v === "text/*" || /\w+\/[-+.\w]+/g.test(v);
+}
+function isExt(v) {
+  return /^.*\.[\w]+$/.test(v);
+}
+function getAcceptAttrString(accept) {
+  if (!accept)
+    return;
+  if (typeof accept === "string")
+    return accept;
+  return Object.entries(accept).reduce((a, [mimeType, ext]) => [...a, mimeType, ...ext], []).filter((v) => isMIMEType(v) || isExt(v)).join(",");
+}
+
 // src/get-file-data-url.ts
 var getFileDataUrl = async (file) => {
   const reader = new FileReader();
@@ -39,10 +73,57 @@ var getTotalFileSize = (files) => {
 var isFileEqual = (file1, file2) => {
   return file1.name === file2.name && file1.size === file2.size && file1.type === file2.type;
 };
+
+// src/is-valid-file-size.ts
+var isDefined = (v) => v !== void 0 && v !== null;
+function isValidFileSize(file, minSize, maxSize) {
+  if (isDefined(file.size)) {
+    if (isDefined(minSize) && isDefined(maxSize)) {
+      if (file.size > maxSize)
+        return [false, "TOO_LARGE"];
+      if (file.size < minSize)
+        return [false, "TOO_SMALL"];
+    } else if (isDefined(minSize) && file.size < minSize) {
+      return [false, "TOO_SMALL"];
+    } else if (isDefined(maxSize) && file.size > maxSize) {
+      return [false, "TOO_LARGE"];
+    }
+  }
+  return [true, null];
+}
+
+// src/is-valid-file-type.ts
+function isFileAccepted(file, accept) {
+  if (file && accept) {
+    const types = Array.isArray(accept) ? accept : accept.split(",");
+    const fileName = file.name || "";
+    const mimeType = (file.type || "").toLowerCase();
+    const baseMimeType = mimeType.replace(/\/.*$/, "");
+    return types.some((type) => {
+      const validType = type.trim().toLowerCase();
+      if (validType.charAt(0) === ".") {
+        return fileName.toLowerCase().endsWith(validType);
+      }
+      if (validType.endsWith("/*")) {
+        return baseMimeType === validType.replace(/\/.*$/, "");
+      }
+      return mimeType === validType;
+    });
+  }
+  return true;
+}
+function isValidFileType(file, accept) {
+  const isAcceptable = file.type === "application/x-moz-file" || isFileAccepted(file, accept);
+  return [isAcceptable, isAcceptable ? null : "FILE_INVALID_TYPE"];
+}
 export {
-  formatBytes,
+  downloadFile,
+  formatFileSize,
+  getAcceptAttrString,
   getFileDataUrl,
   getTotalFileSize,
-  isFileEqual
+  isFileEqual,
+  isValidFileSize,
+  isValidFileType
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/format-bytes.ts","../src/get-file-data-url.ts","../src/get-total-file-size.ts","../src/is-file-equal.ts"],"sourcesContent":["const SIZES = [\"Bytes\", \"KB\", \"MB\", \"GB\", \"TB\", \"PB\", \"EB\", \"ZB\", \"YB\"]\nconst KILO = 1024\n\nexport const formatBytes = (bytes: number, decimals = 2) => {\n  if (bytes === 0) {\n    return \"0 Bytes\"\n  }\n  const dm = decimals <= 0 ? 0 : decimals || 2\n  const i = Math.floor(Math.log(bytes) / Math.log(KILO))\n  return parseFloat((bytes / Math.pow(KILO, i)).toFixed(dm)) + \" \" + SIZES[i]\n}\n","export const getFileDataUrl = async (file: File | Blob) => {\n  const reader = new FileReader()\n  return new Promise<string | undefined>((resolve, reject) => {\n    reader.onerror = () => {\n      reader.abort()\n      reject(new Error(\"There was an error reading a file\"))\n    }\n\n    reader.onloadend = () => {\n      const { result } = reader\n      if (result instanceof ArrayBuffer) {\n        reject(new Error(\"Expected DataURL as string from Blob/File, got ArrayBuffer\"))\n      } else {\n        resolve(result || undefined)\n      }\n    }\n\n    reader.readAsDataURL(file)\n  })\n}\n","export const getTotalFileSize = (files: File[]) => {\n  return files.reduce((acc, file) => acc + file.size, 0)\n}\n","export const isFileEqual = (file1: File, file2: File) => {\n  return file1.name === file2.name && file1.size === file2.size && file1.type === file2.type\n}\n"],"mappings":";AAAA,IAAM,QAAQ,CAAC,SAAS,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,IAAI;AACtE,IAAM,OAAO;AAEN,IAAM,cAAc,CAAC,OAAe,WAAW,MAAM;AAC1D,MAAI,UAAU,GAAG;AACf,WAAO;AAAA,EACT;AACA,QAAM,KAAK,YAAY,IAAI,IAAI,YAAY;AAC3C,QAAM,IAAI,KAAK,MAAM,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,IAAI,CAAC;AACrD,SAAO,YAAY,QAAQ,KAAK,IAAI,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC,IAAI,MAAM,MAAM,CAAC;AAC5E;;;ACVO,IAAM,iBAAiB,OAAO,SAAsB;AACzD,QAAM,SAAS,IAAI,WAAW;AAC9B,SAAO,IAAI,QAA4B,CAAC,SAAS,WAAW;AAC1D,WAAO,UAAU,MAAM;AACrB,aAAO,MAAM;AACb,aAAO,IAAI,MAAM,mCAAmC,CAAC;AAAA,IACvD;AAEA,WAAO,YAAY,MAAM;AACvB,YAAM,EAAE,OAAO,IAAI;AACnB,UAAI,kBAAkB,aAAa;AACjC,eAAO,IAAI,MAAM,4DAA4D,CAAC;AAAA,MAChF,OAAO;AACL,gBAAQ,UAAU,MAAS;AAAA,MAC7B;AAAA,IACF;AAEA,WAAO,cAAc,IAAI;AAAA,EAC3B,CAAC;AACH;;;ACnBO,IAAM,mBAAmB,CAAC,UAAkB;AACjD,SAAO,MAAM,OAAO,CAAC,KAAK,SAAS,MAAM,KAAK,MAAM,CAAC;AACvD;;;ACFO,IAAM,cAAc,CAAC,OAAa,UAAgB;AACvD,SAAO,MAAM,SAAS,MAAM,QAAQ,MAAM,SAAS,MAAM,QAAQ,MAAM,SAAS,MAAM;AACxF;","names":[]}
+{"version":3,"sources":["../src/download-file.ts","../src/format-file-size.ts","../src/get-accept-attr.ts","../src/get-file-data-url.ts","../src/get-total-file-size.ts","../src/is-file-equal.ts","../src/is-valid-file-size.ts","../src/is-valid-file-type.ts"],"sourcesContent":["export function downloadFile(fileOrUrl: File | string, win: typeof window) {\n  const doc = win.document\n  const objectUrl = typeof fileOrUrl === \"string\" ? fileOrUrl : win.URL.createObjectURL(fileOrUrl)\n\n  const anchor = doc.createElement(\"a\")\n  anchor.style.display = \"none\"\n  anchor.href = objectUrl\n  anchor.download = typeof fileOrUrl === \"string\" ? objectUrl : fileOrUrl.name\n\n  doc.body.appendChild(anchor)\n  anchor.click()\n\n  setTimeout(() => {\n    if (typeof fileOrUrl !== \"string\") {\n      win.URL.revokeObjectURL(objectUrl)\n    }\n    anchor?.parentNode?.removeChild(anchor)\n  }, 0)\n}\n","const SIZES = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\", \"PB\", \"EB\", \"ZB\", \"YB\"]\nconst KILO = 1024\n\ninterface FormatByteOptions {\n  locale?: string\n}\n\nexport const formatFileSize = (bytes: number, options: FormatByteOptions = {}) => {\n  const { locale = \"en-US\" } = options\n  if (bytes === 0) return \"0 B\"\n\n  const i = Math.floor(Math.log(bytes) / Math.log(KILO))\n  const fileSize = bytes / Math.pow(KILO, i)\n\n  const formattedSize = new Intl.NumberFormat(locale).format(fileSize)\n  return `${formattedSize} ${SIZES[i]}`\n}\n","function isMIMEType(v: string) {\n  return v === \"audio/*\" || v === \"video/*\" || v === \"image/*\" || v === \"text/*\" || /\\w+\\/[-+.\\w]+/g.test(v)\n}\n\nfunction isExt(v: string) {\n  return /^.*\\.[\\w]+$/.test(v)\n}\n\nexport function getAcceptAttrString(accept: Record<string, string[]> | string | undefined) {\n  if (!accept) return\n  if (typeof accept === \"string\") return accept\n  return Object.entries(accept)\n    .reduce((a, [mimeType, ext]) => [...a, mimeType, ...ext], [] as string[])\n    .filter((v) => isMIMEType(v) || isExt(v))\n    .join(\",\")\n}\n","export const getFileDataUrl = async (file: File | Blob) => {\n  const reader = new FileReader()\n  return new Promise<string | undefined>((resolve, reject) => {\n    reader.onerror = () => {\n      reader.abort()\n      reject(new Error(\"There was an error reading a file\"))\n    }\n\n    reader.onloadend = () => {\n      const { result } = reader\n      if (result instanceof ArrayBuffer) {\n        reject(new Error(\"Expected DataURL as string from Blob/File, got ArrayBuffer\"))\n      } else {\n        resolve(result || undefined)\n      }\n    }\n\n    reader.readAsDataURL(file)\n  })\n}\n","export const getTotalFileSize = (files: File[]) => {\n  return files.reduce((acc, file) => acc + file.size, 0)\n}\n","export const isFileEqual = (file1: File, file2: File) => {\n  return file1.name === file2.name && file1.size === file2.size && file1.type === file2.type\n}\n","const isDefined = <T>(v: T | undefined): v is T => v !== undefined && v !== null\n\nexport function isValidFileSize(file: File, minSize?: number, maxSize?: number): [boolean, string | null] {\n  if (isDefined(file.size)) {\n    if (isDefined(minSize) && isDefined(maxSize)) {\n      if (file.size > maxSize) return [false, \"TOO_LARGE\"]\n      if (file.size < minSize) return [false, \"TOO_SMALL\"]\n    } else if (isDefined(minSize) && file.size < minSize) {\n      return [false, \"TOO_SMALL\"]\n    } else if (isDefined(maxSize) && file.size > maxSize) {\n      return [false, \"TOO_LARGE\"]\n    }\n  }\n  return [true, null]\n}\n","function isFileAccepted(file: File | null, accept: string[] | string | undefined) {\n  if (file && accept) {\n    const types = Array.isArray(accept) ? accept : accept.split(\",\")\n\n    const fileName = file.name || \"\"\n    const mimeType = (file.type || \"\").toLowerCase()\n    const baseMimeType = mimeType.replace(/\\/.*$/, \"\")\n\n    return types.some((type) => {\n      const validType = type.trim().toLowerCase()\n\n      if (validType.charAt(0) === \".\") {\n        return fileName.toLowerCase().endsWith(validType)\n      }\n\n      if (validType.endsWith(\"/*\")) {\n        return baseMimeType === validType.replace(/\\/.*$/, \"\")\n      }\n\n      return mimeType === validType\n    })\n  }\n  return true\n}\n\nexport function isValidFileType(file: File, accept: string | undefined): [boolean, string | null] {\n  const isAcceptable = file.type === \"application/x-moz-file\" || isFileAccepted(file, accept)\n  return [isAcceptable, isAcceptable ? null : \"FILE_INVALID_TYPE\"]\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zag-js/file-utils",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "JS File API utilities",
   "keywords": [
     "js",