@md-oss/common 0.1.6 → 0.1.7

package/dist/files-m1nnj5gT.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"files-m1nnj5gT.cjs","sources":["../src/utils/files.ts"],"sourcesContent":["import { readdirSync, statSync } from 'node:fs';\nimport {\n\tbasename,\n\tdirname,\n\textname,\n\tjoin,\n\tparse as pathParse,\n\trelative,\n\tresolve,\n} from 'node:path';\nimport { ByteMagic } from '../constants';\n\n/**\n * Regular expression pattern for parsing byte strings\n *\n * Matches strings in the format: `<number> <unit>` where:\n * - `<number>` is an integer or decimal number\n * - `<unit>` is an optional unit (b, kb, mb, gb, tb, pb, eb, zb, yb)\n *\n * @example\n * ```ts\n * '1024'.match(BYTE_STRING_PATTERN) // ['1024', '1024', undefined]\n * '1.5 MB'.match(BYTE_STRING_PATTERN) // ['1.5 MB', '1.5', 'MB']\n * '100 KB'.match(BYTE_STRING_PATTERN) // ['100 KB', '100', 'KB']\n * '2.5gb'.match(BYTE_STRING_PATTERN) // ['2.5gb', '2.5', 'gb']\n * '500'.match(BYTE_STRING_PATTERN) // ['500', '500', undefined]\n * ```\n */\nconst BYTE_STRING_PATTERN = /^(\\d+(?:\\.\\d+)?)\\s*([a-z]+)?$/i;\n\n/**\n * Format bytes to human readable format\n * @param bytes - Number of bytes\n * @param decimals - Number of decimal places (default: 2)\n * @returns Formatted string (e.g., \"1.5 MB\")\n */\nfunction formatBytes(bytes: number, decimals = 2): string {\n\tif (bytes === 0) return '0 Bytes';\n\tif (bytes < 0) return `-${formatBytes(-bytes, decimals)}`;\n\n\tconst k = ByteMagic.BYTES_PER_KILOBYTE;\n\tconst dm = decimals < 0 ? 0 : decimals;\n\tconst sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];\n\n\tconst i = Math.floor(Math.log(bytes) / Math.log(k));\n\n\treturn `${Number.parseFloat((bytes / k ** i).toFixed(dm))} ${sizes[i]}`;\n}\n\n/**\n * Parse bytes from human readable format\n * @param value - String value (e.g., \"1.5 MB\")\n * @returns Number of bytes\n */\nfunction parseBytes(value: string): number {\n\tconst units: Record<string, number> = {\n\t\tb: ByteMagic.BYTE,\n\t\tbytes: ByteMagic.BYTE,\n\t\tkb: ByteMagic.KILOBYTE,\n\t\tmb: ByteMagic.MEGABYTE,\n\t\tgb: ByteMagic.GIGABYTE,\n\t\ttb: ByteMagic.TERABYTE,\n\t\tpb: ByteMagic.PETABYTE,\n\t\teb: ByteMagic.EXABYTE,\n\t\tzb: ByteMagic.ZETTABYTE,\n\t\tyb: ByteMagic.YOTTABYTE,\n\t};\n\n\tconst match = value.trim().match(BYTE_STRING_PATTERN);\n\tif (!match) throw new Error(`Invalid byte string: ${value}`);\n\n\tconst [, num, unit = 'b'] = match;\n\tconst multiplier = units[unit.toLowerCase()];\n\n\tif (!multiplier) throw new Error(`Unknown unit: ${unit}`);\n\n\treturn Math.floor(Number.parseFloat(num) * multiplier);\n}\n\ninterface GetFilesOptions {\n\t/**\n\t * File extensions to include (e.g., ['.ts', '.js'])\n\t * If not provided, all files are included\n\t */\n\textensions?: string[];\n\n\t/**\n\t * Whether to include dotfiles (default: false)\n\t */\n\tincludeDotFiles?: boolean;\n\n\t/**\n\t * Whether to search recursively (default: true)\n\t */\n\trecursive?: boolean;\n\n\t/**\n\t * Maximum depth for recursive search (default: Infinity)\n\t */\n\tmaxDepth?: number;\n\n\t/**\n\t * Directories to exclude from search\n\t */\n\texcludeDirs?: string[];\n\n\t/**\n\t * Pattern to match file names (regex or string)\n\t */\n\tpattern?: string | RegExp;\n\n\t/**\n\t * Whether to return absolute paths (default: false)\n\t */\n\tabsolutePaths?: boolean;\n\n\t/**\n\t * Custom filter function\n\t */\n\tfilter?: (filePath: string, stats: ReturnType<typeof statSync>) => boolean;\n}\n\n/**\n * Get files from a directory with various filtering options\n * @param dirPath - Directory path to search\n * @param options - Options for filtering files\n * @returns Array of file paths\n */\nfunction getFiles(dirPath: string, options: GetFilesOptions = {}): string[] {\n\tconst {\n\t\textensions,\n\t\tincludeDotFiles = false,\n\t\trecursive = true,\n\t\tmaxDepth = Number.POSITIVE_INFINITY,\n\t\texcludeDirs = ['node_modules', '.git', 'dist', 'build', 'coverage'],\n\t\tpattern,\n\t\tabsolutePaths = false,\n\t\tfilter,\n\t} = options;\n\n\tconst results: string[] = [];\n\tconst basePath = resolve(dirPath);\n\n\tfunction traverse(currentPath: string, depth = 0): void {\n\t\tif (depth > maxDepth) return;\n\n\t\ttry {\n\t\t\tconst entries = readdirSync(currentPath, { withFileTypes: true });\n\n\t\t\tfor (const entry of entries) {\n\t\t\t\tconst fullPath = join(currentPath, entry.name);\n\n\t\t\t\t// Skip dotfiles if not included\n\t\t\t\tif (!includeDotFiles && entry.name.startsWith('.')) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tif (entry.isDirectory()) {\n\t\t\t\t\t// Skip excluded directories\n\t\t\t\t\tif (excludeDirs.includes(entry.name)) {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\t// Recurse into subdirectories\n\t\t\t\t\tif (recursive) {\n\t\t\t\t\t\ttraverse(fullPath, depth + 1);\n\t\t\t\t\t}\n\t\t\t\t} else if (entry.isFile()) {\n\t\t\t\t\tconst stats = statSync(fullPath);\n\n\t\t\t\t\t// Apply extension filter\n\t\t\t\t\tif (extensions) {\n\t\t\t\t\t\tconst ext = extname(entry.name);\n\t\t\t\t\t\tif (!extensions.includes(ext)) {\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\t// Apply pattern filter\n\t\t\t\t\tif (pattern) {\n\t\t\t\t\t\tconst regex =\n\t\t\t\t\t\t\ttypeof pattern === 'string' ? new RegExp(pattern) : pattern;\n\t\t\t\t\t\tif (!regex.test(entry.name)) {\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\t// Apply custom filter\n\t\t\t\t\tif (filter && !filter(fullPath, stats)) {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tconst resultPath = absolutePaths\n\t\t\t\t\t\t? fullPath\n\t\t\t\t\t\t: relative(basePath, fullPath);\n\t\t\t\t\tresults.push(resultPath);\n\t\t\t\t}\n\t\t\t}\n\t\t} catch (error) {\n\t\t\t// Skip directories we don't have permission to read\n\t\t\tconsole.error(`Error reading directory ${currentPath}:`, error);\n\t\t}\n\t}\n\n\ttraverse(dirPath);\n\treturn results;\n}\n\n/**\n * Get file extension including the dot (e.g., \".ts\")\n * @param filePath - File path\n * @returns File extension\n */\nfunction getExtension(filePath: string): string {\n\treturn extname(filePath);\n}\n\n/**\n * Get file name without parent directories, optionally including the extension\n * @param filePath - File path\n * @param includeExtension - Whether to include the file extension (default: true)\n * @returns File name without directories (e.g., \"index.ts\" or \"index\" if includeExtension is false)\n */\nfunction getBaseName(filePath: string, includeExtension = true): string {\n\treturn includeExtension\n\t\t? basename(filePath)\n\t\t: basename(filePath, extname(filePath));\n}\n\n/**\n * Get directory name from file path\n * @param filePath - File path\n * @returns Directory name\n */\nfunction getDirName(filePath: string): string {\n\treturn dirname(filePath);\n}\n\n/**\n * Parse file path into components\n * @param filePath - File path\n * @returns Parsed path object\n */\nfunction parseFilePath(filePath: string) {\n\tconst parsed = pathParse(filePath);\n\treturn {\n\t\troot: parsed.root,\n\t\tdir: parsed.dir,\n\t\tbase: parsed.base,\n\t\text: parsed.ext,\n\t\tname: parsed.name,\n\t};\n}\n\n/**\n * Get file size in bytes\n * @param filePath - File path\n * @returns File size in bytes\n */\nfunction getFileSize(filePath: string): number {\n\ttry {\n\t\treturn statSync(filePath).size;\n\t} catch {\n\t\treturn 0;\n\t}\n}\n\n/**\n * Get human readable file size\n * @param filePath - File path\n * @param decimals - Number of decimal places (default: 2)\n * @returns Formatted file size\n */\nfunction getFileSizeFormatted(filePath: string, decimals = 2): string {\n\treturn formatBytes(getFileSize(filePath), decimals);\n}\n\n/**\n * Check if path is a directory\n * @param path - Path to check\n * @returns True if path is a directory\n */\nfunction isDirectory(path: string): boolean {\n\ttry {\n\t\treturn statSync(path).isDirectory();\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Check if path is a file\n * @param path - Path to check\n * @returns True if path is a file\n */\nfunction isFile(path: string): boolean {\n\ttry {\n\t\treturn statSync(path).isFile();\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Check if file is a dotfile\n * @param filePath - File path\n * @returns True if file is a dotfile\n */\nfunction isDotFile(filePath: string): boolean {\n\tconst fileName = basename(filePath);\n\treturn fileName.startsWith('.');\n}\n\n/**\n * Normalize file extension (ensure it starts with a dot)\n * @param ext - File extension\n * @returns Normalized extension\n */\nfunction normalizeExtension(ext: string): string {\n\treturn ext.startsWith('.') ? ext : `.${ext}`;\n}\n\n/**\n * Check if file has specific extension\n * @param filePath - File path\n * @param extensions - Extension or array of extensions to check\n * @returns True if file has one of the extensions\n */\nfunction hasExtension(\n\tfilePath: string,\n\textensions: string | string[]\n): boolean {\n\tconst fileExt = extname(filePath).toLowerCase();\n\tconst exts = Array.isArray(extensions) ? extensions : [extensions];\n\n\treturn exts.some((ext) => normalizeExtension(ext).toLowerCase() === fileExt);\n}\n\n/**\n * Group files by extension\n * @param filePaths - Array of file paths\n * @returns Object with extensions as keys and file paths as values\n */\nfunction groupByExtension(filePaths: string[]): Record<string, string[]> {\n\treturn filePaths.reduce(\n\t\t(acc, filePath) => {\n\t\t\tconst ext = extname(filePath) || 'no-extension';\n\t\t\tif (!acc[ext]) {\n\t\t\t\tacc[ext] = [];\n\t\t\t}\n\t\t\tacc[ext].push(filePath);\n\t\t\treturn acc;\n\t\t},\n\t\t{} as Record<string, string[]>\n\t);\n}\n\nexport {\n\tBYTE_STRING_PATTERN,\n\tformatBytes,\n\tparseBytes,\n\tgetFiles,\n\tgetExtension,\n\tgetBaseName,\n\tgetDirName,\n\tparseFilePath,\n\tgetFileSize,\n\tgetFileSizeFormatted,\n\tisDirectory,\n\tisFile,\n\tisDotFile,\n\tnormalizeExtension,\n\thasExtension,\n\tgroupByExtension,\n\ttype GetFilesOptions,\n};\n"],"names":["BYTE_STRING_PATTERN","formatBytes","bytes","decimals","k","ByteMagic","dm","sizes","i","__name","parseBytes","value","units","match","num","unit","multiplier","getFiles","dirPath","options","extensions","includeDotFiles","recursive","maxDepth","excludeDirs","pattern","absolutePaths","filter","results","basePath","resolve","traverse","currentPath","depth","entries","readdirSync","entry","fullPath","join","stats","statSync","ext","extname","resultPath","relative","error","getExtension","filePath","getBaseName","includeExtension","basename","getDirName","dirname","parseFilePath","parsed","pathParse","getFileSize","getFileSizeFormatted","isDirectory","path","isFile","isDotFile","normalizeExtension","hasExtension","fileExt","groupByExtension","filePaths","acc"],"mappings":"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"}

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";var e=require("./api/errors.cjs"),i=require("./api/status-codes.cjs"),s=require("./constants/bytes.cjs"),t=require("./constants/discord.cjs"),a=require("./constants/time.cjs"),r=require("./schemas.cjs"),u=require("./arrays-DaB1Xn47.cjs"),o=require("./mime-types-BmvBrrZ7.cjs"),m=require("./numbers-Du__2-8Y.cjs"),n=require("./objects-CnGoVkh6.cjs"),d=require("./random-D1e1NTOt.cjs"),c=require("./runtime-peVFcWot.cjs"),l=require("./strings-DV446vv-.cjs"),q=require("./time-yNkQSJnQ.cjs");require("zod/v4"),exports.APIError=e.APIError,exports.isAPIError=e.isAPIError,exports.isAPIErrorResponse=e.isAPIErrorResponse,exports.parseError=e.parseError,exports.isStatusCodeText=i.isStatusCodeText,exports.resolveStatusCode=i.resolveStatusCode,exports.statusCodes=i.statusCodes,exports.ByteMagic=s.ByteMagic,exports.DiscordMagic=t.DiscordMagic,exports.TimeMagic=a.TimeMagic,exports.isFieldRequired=r.isFieldRequired,exports.paginationQuerySchema=r.paginationQuerySchema,exports.requiredKeys=r.requiredKeys,exports.signedUrlSchema=r.signedUrlSchema,exports.zodEnumFromObjectKeys=r.zodEnumFromObjectKeys,exports.ArrayUtils=u.arrays,exports.MimeTypeUtils=o.mimeTypes,exports.NumberUtils=m.numbers,exports.ObjectUtils=n.objects,exports.RandomUtils=d.random,exports.RuntimeUtils=c.runtime,exports.StringUtils=l.strings,exports.TimeUtils=q.time;
+"use strict";var e=require("./api/errors.cjs"),i=require("./api/status-codes.cjs"),s=require("./constants/bytes.cjs"),t=require("./constants/discord.cjs"),a=require("./constants/time.cjs"),r=require("./schemas.cjs"),u=require("./arrays-bgbansWs.cjs"),o=require("./files-m1nnj5gT.cjs"),m=require("./mime-types-BmvBrrZ7.cjs"),n=require("./numbers-B_mptknO.cjs"),l=require("./objects-wcO6hNA8.cjs"),d=require("./random-668tofPV.cjs"),c=require("./runtime-Bfs-yn_-.cjs"),q=require("./strings-_1vAPvzS.cjs"),v=require("./time-yNkQSJnQ.cjs");require("zod/v4"),require("node:fs"),require("node:path"),exports.APIError=e.APIError,exports.isAPIError=e.isAPIError,exports.isAPIErrorResponse=e.isAPIErrorResponse,exports.parseError=e.parseError,exports.isStatusCodeText=i.isStatusCodeText,exports.resolveStatusCode=i.resolveStatusCode,exports.statusCodes=i.statusCodes,exports.ByteMagic=s.ByteMagic,exports.DiscordMagic=t.DiscordMagic,exports.TimeMagic=a.TimeMagic,exports.isFieldRequired=r.isFieldRequired,exports.paginationQuerySchema=r.paginationQuerySchema,exports.requiredKeys=r.requiredKeys,exports.signedUrlSchema=r.signedUrlSchema,exports.zodEnumFromObjectKeys=r.zodEnumFromObjectKeys,exports.ArrayUtils=u.arrays,exports.FileUtils=o.files,exports.MimeTypeUtils=m.mimeTypes,exports.NumberUtils=n.numbers,exports.ObjectUtils=l.objects,exports.RandomUtils=d.random,exports.RuntimeUtils=c.runtime,exports.StringUtils=q.strings,exports.TimeUtils=v.time;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -5,13 +5,15 @@ export { ByteMagic } from './constants/bytes.cjs';
 export { DiscordMagic } from './constants/discord.cjs';
 export { TimeMagic } from './constants/time.cjs';
 export { FormDataFromSchema, Pagination, SignedUrlSchema, isFieldRequired, paginationQuerySchema, requiredKeys, signedUrlSchema, zodEnumFromObjectKeys } from './schemas.cjs';
-export { a as ArrayUtils } from './arrays-CElcW69H.cjs';
-export { m as MimeTypeUtils } from './mime-types-Bjt4NvnE.cjs';
-export { n as NumberUtils } from './numbers-CtAqd3eH.cjs';
-export { o as ObjectUtils } from './objects-cf8j7rS8.cjs';
-export { r as RandomUtils } from './random-DpNyGGAZ.cjs';
-export { r as RuntimeUtils } from './runtime-T8Kcf7Af.cjs';
-export { s as StringUtils } from './strings-DhPbrpq7.cjs';
-export { t as TimeUtils } from './time-8KLG8kBO.cjs';
+export { a as ArrayUtils } from './arrays-DvPJ1GeR.cjs';
+export { FileUtils } from './utils/index.cjs';
+export { m as MimeTypeUtils } from './mime-types-Dajfhq2c.cjs';
+export { n as NumberUtils } from './numbers-C2680fmA.cjs';
+export { o as ObjectUtils } from './objects-fiFExjsf.cjs';
+export { r as RandomUtils } from './random-BqJDZAPb.cjs';
+export { r as RuntimeUtils } from './runtime-7fkN5_oL.cjs';
+export { s as StringUtils } from './strings-jE1j-qqa.cjs';
+export { t as TimeUtils } from './time-ufhllID1.cjs';
 import 'qs';
 import 'zod/v4';
+import 'node:fs';

package/dist/index.d.mts

@@ -5,13 +5,15 @@ export { ByteMagic } from './constants/bytes.mjs';
 export { DiscordMagic } from './constants/discord.mjs';
 export { TimeMagic } from './constants/time.mjs';
 export { FormDataFromSchema, Pagination, SignedUrlSchema, isFieldRequired, paginationQuerySchema, requiredKeys, signedUrlSchema, zodEnumFromObjectKeys } from './schemas.mjs';
-export { a as ArrayUtils } from './arrays-CElcW69H.mjs';
-export { m as MimeTypeUtils } from './mime-types-Bjt4NvnE.mjs';
-export { n as NumberUtils } from './numbers-CtAqd3eH.mjs';
-export { o as ObjectUtils } from './objects-cf8j7rS8.mjs';
-export { r as RandomUtils } from './random-DpNyGGAZ.mjs';
-export { r as RuntimeUtils } from './runtime-T8Kcf7Af.mjs';
-export { s as StringUtils } from './strings-DhPbrpq7.mjs';
-export { t as TimeUtils } from './time-D8Wfqzu6.mjs';
+export { a as ArrayUtils } from './arrays-DvPJ1GeR.mjs';
+export { FileUtils } from './utils/index.mjs';
+export { m as MimeTypeUtils } from './mime-types-Dajfhq2c.mjs';
+export { n as NumberUtils } from './numbers-C2680fmA.mjs';
+export { o as ObjectUtils } from './objects-fiFExjsf.mjs';
+export { r as RandomUtils } from './random-BqJDZAPb.mjs';
+export { r as RuntimeUtils } from './runtime-7fkN5_oL.mjs';
+export { s as StringUtils } from './strings-jE1j-qqa.mjs';
+export { t as TimeUtils } from './time-BrLHgSth.mjs';
 import 'qs';
 import 'zod/v4';
+import 'node:fs';

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import{APIError as t,isAPIError as s,isAPIErrorResponse as i,parseError as m}from"./api/errors.mjs";import{isStatusCodeText as p,resolveStatusCode as x,statusCodes as f}from"./api/status-codes.mjs";import{ByteMagic as d}from"./constants/bytes.mjs";import{DiscordMagic as u}from"./constants/discord.mjs";import{TimeMagic as c}from"./constants/time.mjs";import{isFieldRequired as y,paginationQuerySchema as E,requiredKeys as S,signedUrlSchema as A,zodEnumFromObjectKeys as M}from"./schemas.mjs";import{a as T}from"./arrays-BkHBzTDO.mjs";import{m as C}from"./mime-types-D_K53zgk.mjs";import{n as P}from"./numbers-D2K-8sJL.mjs";import{o as j}from"./objects--cO_X3EV.mjs";import{r as F}from"./random-DbidGSrQ.mjs";import{r as O}from"./runtime-DY-8W6Jr.mjs";import{s as z}from"./strings-B0BRwNX9.mjs";import{t as D}from"./time-DmJNWZeL.mjs";import"zod/v4";export{t as APIError,T as ArrayUtils,d as ByteMagic,u as DiscordMagic,C as MimeTypeUtils,P as NumberUtils,j as ObjectUtils,F as RandomUtils,O as RuntimeUtils,z as StringUtils,c as TimeMagic,D as TimeUtils,s as isAPIError,i as isAPIErrorResponse,y as isFieldRequired,p as isStatusCodeText,E as paginationQuerySchema,m as parseError,S as requiredKeys,x as resolveStatusCode,A as signedUrlSchema,f as statusCodes,M as zodEnumFromObjectKeys};
+import{APIError as i,isAPIError as m,isAPIErrorResponse as a,parseError as p}from"./api/errors.mjs";import{isStatusCodeText as x,resolveStatusCode as l,statusCodes as d}from"./api/status-codes.mjs";import{ByteMagic as n}from"./constants/bytes.mjs";import{DiscordMagic as c}from"./constants/discord.mjs";import{TimeMagic as y}from"./constants/time.mjs";import{isFieldRequired as S,paginationQuerySchema as A,requiredKeys as M,signedUrlSchema as R,zodEnumFromObjectKeys as T}from"./schemas.mjs";import{a as C}from"./arrays-6DA6GfsQ.mjs";import{f as I}from"./files-DzKYei0a.mjs";import{m as h}from"./mime-types-D_K53zgk.mjs";import{n as q}from"./numbers-lJ6gwIpk.mjs";import{o as O}from"./objects-VXf3mqE5.mjs";import{r as z}from"./random-ihslkInn.mjs";import{r as D}from"./runtime-CE36Va0l.mjs";import{s as Q}from"./strings-CrzGdnZH.mjs";import{t as w}from"./time-DmJNWZeL.mjs";import"zod/v4";import"node:fs";import"node:path";export{i as APIError,C as ArrayUtils,n as ByteMagic,c as DiscordMagic,I as FileUtils,h as MimeTypeUtils,q as NumberUtils,O as ObjectUtils,z as RandomUtils,D as RuntimeUtils,Q as StringUtils,y as TimeMagic,w as TimeUtils,m as isAPIError,a as isAPIErrorResponse,S as isFieldRequired,x as isStatusCodeText,A as paginationQuerySchema,p as parseError,M as requiredKeys,l as resolveStatusCode,R as signedUrlSchema,d as statusCodes,T as zodEnumFromObjectKeys};
 //# sourceMappingURL=index.mjs.map

package/dist/mime-types-BmvBrrZ7.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mime-types-BmvBrrZ7.cjs","sources":["../src/utils/mime-types.ts"],"sourcesContent":["type MimeKind = 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT' | 'ARCHIVE' | 'OTHER';\ntype MimeKindWithSafe = MimeKind | 'SAFE';\n\nconst imageMimeTypes = [\n\t'image/png',\n\t'image/jpeg',\n\t'image/webp',\n\t'image/gif',\n\t'image/bmp',\n\t'image/svg+xml',\n\t'image/x-icon',\n\t'image/tiff',\n\t'image/heic',\n\t'image/avif',\n\t'image/apng',\n\t'image/jpg',\n] as const;\n\nconst videoMimeTypes = [\n\t'video/mp4',\n\t'video/webm',\n\t'video/ogg',\n\t'video/avi',\n\t'video/mpeg',\n\t'video/quicktime',\n\t'video/x-msvideo',\n\t'video/x-matroska',\n\t'video/x-flv',\n\t'video/x-ms-wmv',\n\t'video/x-mpeg',\n\t'video/x-ms-asf',\n\t'video/x-ms-wmx',\n\t'video/x-ms-wvx',\n\t'video/x-matroska',\n\t'video/x-flash-video',\n] as const;\n\nconst audioMimeTypes = [\n\t'audio/mpeg',\n\t'audio/wav',\n\t'audio/ogg',\n\t'audio/aac',\n\t'audio/flac',\n\t'audio/mp3',\n\t'audio/x-wav',\n\t'audio/x-aiff',\n\t'audio/x-m4a',\n\t'audio/x-ms-wma',\n\t'audio/x-ms-wax',\n\t'audio/x-matroska',\n\t'audio/x-flac',\n\t'audio/x-aac',\n] as const;\n\nconst documentMimeTypes = [\n\t'text/plain',\n\t'text/csv',\n\t'text/rtf',\n\t'text/markdown',\n\t'text/x-markdown',\n\t'text/x-log',\n\t'text/x-ini',\n\t'text/x-yaml',\n\t'text/xml',\n\t'application/x-yaml',\n\t'application/xml',\n\t'application/rtf',\n\t'application/pdf',\n\t'application/msword',\n\t'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n\t'application/vnd.ms-excel',\n\t'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n\t'application/vnd.oasis.opendocument.text',\n\t'application/vnd.oasis.opendocument.spreadsheet',\n] as const;\n\nconst archiveMimeTypes = [\n\t'application/zip',\n\t'application/x-7z-compressed',\n\t'application/x-rar-compressed',\n\t'application/x-tar',\n\t'application/gzip',\n\t'application/x-bzip2',\n\t'application/x-xz',\n\t'application/x-compress',\n\t'application/x-archive',\n\t'application/x-zip-compressed',\n\t'application/x-rar',\n\t'application/x-gzip',\n\t'application/x-bzip',\n] as const;\n\nconst webAssetTypes = [\n\t'text/html',\n\t'text/css',\n\t'text/javascript',\n\t'application/json',\n\t'application/xml',\n\t'application/x-javascript',\n\t'application/x-web-app-manifest+json',\n\t'application/x-font-woff',\n\t'application/x-font-woff2',\n\t'image/svg+xml',\n\t'image/x-icon',\n] as const;\n\nconst safeMimeTypes = [\n\t...imageMimeTypes,\n\t...videoMimeTypes,\n\t...audioMimeTypes,\n\t...documentMimeTypes,\n\t...archiveMimeTypes,\n\t...webAssetTypes,\n] as Array<\n\t| (typeof imageMimeTypes)[number]\n\t| (typeof videoMimeTypes)[number]\n\t| (typeof audioMimeTypes)[number]\n\t| (typeof documentMimeTypes)[number]\n\t| (typeof archiveMimeTypes)[number]\n\t| (typeof webAssetTypes)[number]\n>;\n\nconst mimeTypeMap: Record<MimeKindWithSafe, readonly string[]> = {\n\tIMAGE: imageMimeTypes,\n\tVIDEO: videoMimeTypes,\n\tAUDIO: audioMimeTypes,\n\tDOCUMENT: documentMimeTypes,\n\tARCHIVE: archiveMimeTypes,\n\tSAFE: safeMimeTypes,\n\tOTHER: [],\n};\n\n/**\n * Returns a comma-separated accept string for input elements based on the specified kind\n * @param kind The type of MIME kind to get the accept string for\n */\nconst getInputAccept = (kind: MimeKindWithSafe = 'SAFE'): string => {\n\treturn mimeTypeMap[kind].join(',');\n};\n\nconst isAllowedMimeType = (\n\tmimeType: string,\n\tkind: MimeKindWithSafe = 'SAFE'\n): boolean => {\n\tif (!mimeType || typeof mimeType !== 'string') {\n\t\treturn false;\n\t}\n\n\tconst lowerMimeType = mimeType.toLowerCase().split(';')[0].trim();\n\n\treturn mimeTypeMap[kind].includes(lowerMimeType);\n};\n\nconst inlineContentDispositionMimeTypes = [\n\t'text/plain',\n\t'text/xml',\n\t'application/json',\n\t'application/pdf',\n] as const;\n\nconst isInlineContentDisposition = (mimeType: string): boolean => {\n\tconst lowerMimeType = mimeType.toLowerCase().split(';')[0].trim();\n\treturn (\n\t\tinlineContentDispositionMimeTypes.includes(\n\t\t\tlowerMimeType as (typeof inlineContentDispositionMimeTypes)[number]\n\t\t) ||\n\t\tlowerMimeType.startsWith('image/') ||\n\t\tlowerMimeType.startsWith('video/') ||\n\t\tlowerMimeType.startsWith('audio/')\n\t);\n};\n\nconst mimeTypeResolver = (_mimeType: string): MimeKind => {\n\tconst mimeType = _mimeType.toLowerCase().split(';')[0].trim();\n\n\tif (mimeType.startsWith('image/')) {\n\t\treturn 'IMAGE';\n\t} else if (mimeType.startsWith('video/')) {\n\t\treturn 'VIDEO';\n\t} else if (mimeType.startsWith('audio/')) {\n\t\treturn 'AUDIO';\n\t} else if (\n\t\tdocumentMimeTypes.includes(mimeType as (typeof documentMimeTypes)[number])\n\t) {\n\t\treturn 'DOCUMENT';\n\t} else if (\n\t\tarchiveMimeTypes.includes(mimeType as (typeof archiveMimeTypes)[number])\n\t) {\n\t\treturn 'ARCHIVE';\n\t} else {\n\t\treturn 'OTHER';\n\t}\n};\n\nexport {\n\ttype MimeKind,\n\ttype MimeKindWithSafe,\n\timageMimeTypes,\n\tvideoMimeTypes,\n\taudioMimeTypes,\n\tdocumentMimeTypes,\n\tarchiveMimeTypes,\n\tsafeMimeTypes,\n\tmimeTypeMap,\n\tgetInputAccept,\n\tisAllowedMimeType,\n\tisInlineContentDisposition,\n\tmimeTypeResolver,\n\tinlineContentDispositionMimeTypes,\n};\n"],"names":["imageMimeTypes","videoMimeTypes","audioMimeTypes","documentMimeTypes","archiveMimeTypes","webAssetTypes","safeMimeTypes","mimeTypeMap","getInputAccept","__name","kind","isAllowedMimeType","mimeType","lowerMimeType","inlineContentDispositionMimeTypes","isInlineContentDisposition","mimeTypeResolver","_mimeType"],"mappings":"4FAGA,MAAMA,EAAiB,CACtB,YACA,aACA,aACA,YACA,YACA,gBACA,eACA,aACA,aACA,aACA,aACA,WACD,EAEMC,EAAiB,CACtB,YACA,aACA,YACA,YACA,aACA,kBACA,kBACA,mBACA,cACA,iBACA,eACA,iBACA,iBACA,iBACA,mBACA,qBACD,EAEMC,EAAiB,CACtB,aACA,YACA,YACA,YACA,aACA,YACA,cACA,eACA,cACA,iBACA,iBACA,mBACA,eACA,aACD,EAEMC,EAAoB,CACzB,aACA,WACA,WACA,gBACA,kBACA,aACA,aACA,cACA,WACA,qBACA,kBACA,kBACA,kBACA,qBACA,0EACA,2BACA,oEACA,0CACA,gDACD,EAEMC,EAAmB,CACxB,kBACA,8BACA,+BACA,oBACA,mBACA,sBACA,mBACA,yBACA,wBACA,+BACA,oBACA,qBACA,oBACD,EAEMC,EAAgB,CACrB,YACA,WACA,kBACA,mBACA,kBACA,2BACA,sCACA,0BACA,2BACA,gBACA,cACD,EAEMC,EAAgB,CACrB,GAAGN,EACH,GAAGC,EACH,GAAGC,EACH,GAAGC,EACH,GAAGC,EACH,GAAGC,CACJ,EASME,EAA2D,CAChE,MAAOP,EACP,MAAOC,EACP,MAAOC,EACP,SAAUC,EACV,QAASC,EACT,KAAME,EACN,MAAO,CAAA,CACR,EAMME,EAAiBC,EAAA,CAACC,EAAyB,SACzCH,EAAYG,CAAI,EAAE,KAAK,GAAG,EADX,kBAIjBC,EAAoBF,EAAA,CACzBG,EACAF,EAAyB,SACZ,CACb,GAAI,CAACE,GAAY,OAAOA,GAAa,SACpC,MAAO,GAGR,MAAMC,EAAgBD,EAAS,YAAA,EAAc,MAAM,GAAG,EAAE,CAAC,EAAE,KAAA,EAE3D,OAAOL,EAAYG,CAAI,EAAE,SAASG,CAAa,CAChD,EAX0B,qBAapBC,EAAoC,CACzC,aACA,WACA,mBACA,iBACD,EAEMC,EAA6BN,EAACG,GAA8B,CACjE,MAAMC,EAAgBD,EAAS,YAAA,EAAc,MAAM,GAAG,EAAE,CAAC,EAAE,KAAA,EAC3D,OACCE,EAAkC,SACjCD,CAAA,GAEDA,EAAc,WAAW,QAAQ,GACjCA,EAAc,WAAW,QAAQ,GACjCA,EAAc,WAAW,QAAQ,CAEnC,EAVmC,8BAY7BG,EAAmBP,EAACQ,GAAgC,CACzD,MAAML,EAAWK,EAAU,YAAA,EAAc,MAAM,GAAG,EAAE,CAAC,EAAE,KAAA,EAEvD,OAAIL,EAAS,WAAW,QAAQ,EACxB,QACGA,EAAS,WAAW,QAAQ,EAC/B,QACGA,EAAS,WAAW,QAAQ,EAC/B,QAEPT,EAAkB,SAASS,CAA8C,EAElE,WAEPR,EAAiB,SAASQ,CAA6C,EAEhE,UAEA,OAET,EApByB"}
+{"version":3,"file":"mime-types-BmvBrrZ7.cjs","sources":["../src/utils/mime-types.ts"],"sourcesContent":["/**\n * MIME type category\n */\ntype MimeKind = 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT' | 'ARCHIVE' | 'OTHER';\n\n/**\n * MIME type category including SAFE (all safe types combined)\n */\ntype MimeKindWithSafe = MimeKind | 'SAFE';\n\n/**\n * List of common image MIME types\n */\nconst imageMimeTypes = [\n\t'image/png',\n\t'image/jpeg',\n\t'image/webp',\n\t'image/gif',\n\t'image/bmp',\n\t'image/svg+xml',\n\t'image/x-icon',\n\t'image/tiff',\n\t'image/heic',\n\t'image/avif',\n\t'image/apng',\n\t'image/jpg',\n] as const;\n\n/**\n * List of common video MIME types\n */\nconst videoMimeTypes = [\n\t'video/mp4',\n\t'video/webm',\n\t'video/ogg',\n\t'video/avi',\n\t'video/mpeg',\n\t'video/quicktime',\n\t'video/x-msvideo',\n\t'video/x-matroska',\n\t'video/x-flv',\n\t'video/x-ms-wmv',\n\t'video/x-mpeg',\n\t'video/x-ms-asf',\n\t'video/x-ms-wmx',\n\t'video/x-ms-wvx',\n\t'video/x-matroska',\n\t'video/x-flash-video',\n] as const;\n\n/**\n * List of common audio MIME types\n */\nconst audioMimeTypes = [\n\t'audio/mpeg',\n\t'audio/wav',\n\t'audio/ogg',\n\t'audio/aac',\n\t'audio/flac',\n\t'audio/mp3',\n\t'audio/x-wav',\n\t'audio/x-aiff',\n\t'audio/x-m4a',\n\t'audio/x-ms-wma',\n\t'audio/x-ms-wax',\n\t'audio/x-matroska',\n\t'audio/x-flac',\n\t'audio/x-aac',\n] as const;\n\n/**\n * List of common document MIME types\n */\nconst documentMimeTypes = [\n\t'text/plain',\n\t'text/csv',\n\t'text/rtf',\n\t'text/markdown',\n\t'text/x-markdown',\n\t'text/x-log',\n\t'text/x-ini',\n\t'text/x-yaml',\n\t'text/xml',\n\t'application/x-yaml',\n\t'application/xml',\n\t'application/rtf',\n\t'application/pdf',\n\t'application/msword',\n\t'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n\t'application/vnd.ms-excel',\n\t'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n\t'application/vnd.oasis.opendocument.text',\n\t'application/vnd.oasis.opendocument.spreadsheet',\n] as const;\n\n/**\n * List of common archive/compression MIME types\n */\nconst archiveMimeTypes = [\n\t'application/zip',\n\t'application/x-7z-compressed',\n\t'application/x-rar-compressed',\n\t'application/x-tar',\n\t'application/gzip',\n\t'application/x-bzip2',\n\t'application/x-xz',\n\t'application/x-compress',\n\t'application/x-archive',\n\t'application/x-zip-compressed',\n\t'application/x-rar',\n\t'application/x-gzip',\n\t'application/x-bzip',\n] as const;\n\n/**\n * List of web asset MIME types (HTML, CSS, JS, fonts, etc.)\n */\nconst webAssetTypes = [\n\t'text/html',\n\t'text/css',\n\t'text/javascript',\n\t'application/json',\n\t'application/xml',\n\t'application/x-javascript',\n\t'application/x-web-app-manifest+json',\n\t'application/x-font-woff',\n\t'application/x-font-woff2',\n\t'image/svg+xml',\n\t'image/x-icon',\n] as const;\n\n/**\n * Combined list of all safe MIME types\n */\nconst safeMimeTypes = [\n\t...imageMimeTypes,\n\t...videoMimeTypes,\n\t...audioMimeTypes,\n\t...documentMimeTypes,\n\t...archiveMimeTypes,\n\t...webAssetTypes,\n] as Array<\n\t| (typeof imageMimeTypes)[number]\n\t| (typeof videoMimeTypes)[number]\n\t| (typeof audioMimeTypes)[number]\n\t| (typeof documentMimeTypes)[number]\n\t| (typeof archiveMimeTypes)[number]\n\t| (typeof webAssetTypes)[number]\n>;\n\n/**\n * Map of MIME kind to list of MIME types\n */\nconst mimeTypeMap: Record<MimeKindWithSafe, readonly string[]> = {\n\tIMAGE: imageMimeTypes,\n\tVIDEO: videoMimeTypes,\n\tAUDIO: audioMimeTypes,\n\tDOCUMENT: documentMimeTypes,\n\tARCHIVE: archiveMimeTypes,\n\tSAFE: safeMimeTypes,\n\tOTHER: [],\n};\n\n/**\n * Returns a comma-separated accept string for input elements based on the specified kind\n * @param kind - The type of MIME kind to get the accept string for\n * @returns Comma-separated MIME types string\n * @example getInputAccept('IMAGE') // \"image/png,image/jpeg,...\"\n */\nconst getInputAccept = (kind: MimeKindWithSafe = 'SAFE'): string => {\n\treturn mimeTypeMap[kind].join(',');\n};\n\n/**\n * Check if a MIME type is allowed for a given kind\n * @param mimeType - MIME type to check\n * @param kind - The type of MIME kind to check against (default: 'SAFE')\n * @returns True if MIME type is allowed\n * @example isAllowedMimeType('image/png', 'IMAGE') // true\n * @example isAllowedMimeType('application/exe', 'SAFE') // false\n */\nconst isAllowedMimeType = (\n\tmimeType: string,\n\tkind: MimeKindWithSafe = 'SAFE'\n): boolean => {\n\tif (!mimeType || typeof mimeType !== 'string') {\n\t\treturn false;\n\t}\n\n\tconst lowerMimeType = mimeType.toLowerCase().split(';')[0].trim();\n\n\treturn mimeTypeMap[kind].includes(lowerMimeType);\n};\n\n/**\n * List of MIME types that should use inline Content-Disposition\n */\nconst inlineContentDispositionMimeTypes = [\n\t'text/plain',\n\t'text/xml',\n\t'application/json',\n\t'application/pdf',\n] as const;\n\n/**\n * Check if a MIME type should use inline Content-Disposition\n * @param mimeType - MIME type to check\n * @returns True if should be inline\n * @example isInlineContentDisposition('image/png') // true\n * @example isInlineContentDisposition('application/zip') // false\n */\nconst isInlineContentDisposition = (mimeType: string): boolean => {\n\tconst lowerMimeType = mimeType.toLowerCase().split(';')[0].trim();\n\treturn (\n\t\tinlineContentDispositionMimeTypes.includes(\n\t\t\tlowerMimeType as (typeof inlineContentDispositionMimeTypes)[number]\n\t\t) ||\n\t\tlowerMimeType.startsWith('image/') ||\n\t\tlowerMimeType.startsWith('video/') ||\n\t\tlowerMimeType.startsWith('audio/')\n\t);\n};\n\n/**\n * Resolve a MIME type to its category\n * @param _mimeType - MIME type to resolve\n * @returns The MIME kind category\n * @example mimeTypeResolver('image/png') // 'IMAGE'\n * @example mimeTypeResolver('video/mp4') // 'VIDEO'\n */\nconst mimeTypeResolver = (_mimeType: string): MimeKind => {\n\tconst mimeType = _mimeType.toLowerCase().split(';')[0].trim();\n\n\tif (mimeType.startsWith('image/')) {\n\t\treturn 'IMAGE';\n\t} else if (mimeType.startsWith('video/')) {\n\t\treturn 'VIDEO';\n\t} else if (mimeType.startsWith('audio/')) {\n\t\treturn 'AUDIO';\n\t} else if (\n\t\tdocumentMimeTypes.includes(mimeType as (typeof documentMimeTypes)[number])\n\t) {\n\t\treturn 'DOCUMENT';\n\t} else if (\n\t\tarchiveMimeTypes.includes(mimeType as (typeof archiveMimeTypes)[number])\n\t) {\n\t\treturn 'ARCHIVE';\n\t} else {\n\t\treturn 'OTHER';\n\t}\n};\n\nexport {\n\ttype MimeKind,\n\ttype MimeKindWithSafe,\n\timageMimeTypes,\n\tvideoMimeTypes,\n\taudioMimeTypes,\n\tdocumentMimeTypes,\n\tarchiveMimeTypes,\n\tsafeMimeTypes,\n\tmimeTypeMap,\n\tgetInputAccept,\n\tisAllowedMimeType,\n\tisInlineContentDisposition,\n\tmimeTypeResolver,\n\tinlineContentDispositionMimeTypes,\n};\n"],"names":["imageMimeTypes","videoMimeTypes","audioMimeTypes","documentMimeTypes","archiveMimeTypes","webAssetTypes","safeMimeTypes","mimeTypeMap","getInputAccept","__name","kind","isAllowedMimeType","mimeType","lowerMimeType","inlineContentDispositionMimeTypes","isInlineContentDisposition","mimeTypeResolver","_mimeType"],"mappings":"4FAaA,MAAMA,EAAiB,CACtB,YACA,aACA,aACA,YACA,YACA,gBACA,eACA,aACA,aACA,aACA,aACA,WACD,EAKMC,EAAiB,CACtB,YACA,aACA,YACA,YACA,aACA,kBACA,kBACA,mBACA,cACA,iBACA,eACA,iBACA,iBACA,iBACA,mBACA,qBACD,EAKMC,EAAiB,CACtB,aACA,YACA,YACA,YACA,aACA,YACA,cACA,eACA,cACA,iBACA,iBACA,mBACA,eACA,aACD,EAKMC,EAAoB,CACzB,aACA,WACA,WACA,gBACA,kBACA,aACA,aACA,cACA,WACA,qBACA,kBACA,kBACA,kBACA,qBACA,0EACA,2BACA,oEACA,0CACA,gDACD,EAKMC,EAAmB,CACxB,kBACA,8BACA,+BACA,oBACA,mBACA,sBACA,mBACA,yBACA,wBACA,+BACA,oBACA,qBACA,oBACD,EAKMC,EAAgB,CACrB,YACA,WACA,kBACA,mBACA,kBACA,2BACA,sCACA,0BACA,2BACA,gBACA,cACD,EAKMC,EAAgB,CACrB,GAAGN,EACH,GAAGC,EACH,GAAGC,EACH,GAAGC,EACH,GAAGC,EACH,GAAGC,CACJ,EAYME,EAA2D,CAChE,MAAOP,EACP,MAAOC,EACP,MAAOC,EACP,SAAUC,EACV,QAASC,EACT,KAAME,EACN,MAAO,CAAA,CACR,EAQME,EAAiBC,EAAA,CAACC,EAAyB,SACzCH,EAAYG,CAAI,EAAE,KAAK,GAAG,EADX,kBAYjBC,EAAoBF,EAAA,CACzBG,EACAF,EAAyB,SACZ,CACb,GAAI,CAACE,GAAY,OAAOA,GAAa,SACpC,MAAO,GAGR,MAAMC,EAAgBD,EAAS,YAAA,EAAc,MAAM,GAAG,EAAE,CAAC,EAAE,KAAA,EAE3D,OAAOL,EAAYG,CAAI,EAAE,SAASG,CAAa,CAChD,EAX0B,qBAgBpBC,EAAoC,CACzC,aACA,WACA,mBACA,iBACD,EASMC,EAA6BN,EAACG,GAA8B,CACjE,MAAMC,EAAgBD,EAAS,YAAA,EAAc,MAAM,GAAG,EAAE,CAAC,EAAE,KAAA,EAC3D,OACCE,EAAkC,SACjCD,CAAA,GAEDA,EAAc,WAAW,QAAQ,GACjCA,EAAc,WAAW,QAAQ,GACjCA,EAAc,WAAW,QAAQ,CAEnC,EAVmC,8BAmB7BG,EAAmBP,EAACQ,GAAgC,CACzD,MAAML,EAAWK,EAAU,YAAA,EAAc,MAAM,GAAG,EAAE,CAAC,EAAE,KAAA,EAEvD,OAAIL,EAAS,WAAW,QAAQ,EACxB,QACGA,EAAS,WAAW,QAAQ,EAC/B,QACGA,EAAS,WAAW,QAAQ,EAC/B,QAEPT,EAAkB,SAASS,CAA8C,EAElE,WAEPR,EAAiB,SAASQ,CAA6C,EAEhE,UAEA,OAET,EApByB"}

package/dist/mime-types-D_K53zgk.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mime-types-D_K53zgk.mjs","sources":["../src/utils/mime-types.ts"],"sourcesContent":["type MimeKind = 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT' | 'ARCHIVE' | 'OTHER';\ntype MimeKindWithSafe = MimeKind | 'SAFE';\n\nconst imageMimeTypes = [\n\t'image/png',\n\t'image/jpeg',\n\t'image/webp',\n\t'image/gif',\n\t'image/bmp',\n\t'image/svg+xml',\n\t'image/x-icon',\n\t'image/tiff',\n\t'image/heic',\n\t'image/avif',\n\t'image/apng',\n\t'image/jpg',\n] as const;\n\nconst videoMimeTypes = [\n\t'video/mp4',\n\t'video/webm',\n\t'video/ogg',\n\t'video/avi',\n\t'video/mpeg',\n\t'video/quicktime',\n\t'video/x-msvideo',\n\t'video/x-matroska',\n\t'video/x-flv',\n\t'video/x-ms-wmv',\n\t'video/x-mpeg',\n\t'video/x-ms-asf',\n\t'video/x-ms-wmx',\n\t'video/x-ms-wvx',\n\t'video/x-matroska',\n\t'video/x-flash-video',\n] as const;\n\nconst audioMimeTypes = [\n\t'audio/mpeg',\n\t'audio/wav',\n\t'audio/ogg',\n\t'audio/aac',\n\t'audio/flac',\n\t'audio/mp3',\n\t'audio/x-wav',\n\t'audio/x-aiff',\n\t'audio/x-m4a',\n\t'audio/x-ms-wma',\n\t'audio/x-ms-wax',\n\t'audio/x-matroska',\n\t'audio/x-flac',\n\t'audio/x-aac',\n] as const;\n\nconst documentMimeTypes = [\n\t'text/plain',\n\t'text/csv',\n\t'text/rtf',\n\t'text/markdown',\n\t'text/x-markdown',\n\t'text/x-log',\n\t'text/x-ini',\n\t'text/x-yaml',\n\t'text/xml',\n\t'application/x-yaml',\n\t'application/xml',\n\t'application/rtf',\n\t'application/pdf',\n\t'application/msword',\n\t'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n\t'application/vnd.ms-excel',\n\t'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n\t'application/vnd.oasis.opendocument.text',\n\t'application/vnd.oasis.opendocument.spreadsheet',\n] as const;\n\nconst archiveMimeTypes = [\n\t'application/zip',\n\t'application/x-7z-compressed',\n\t'application/x-rar-compressed',\n\t'application/x-tar',\n\t'application/gzip',\n\t'application/x-bzip2',\n\t'application/x-xz',\n\t'application/x-compress',\n\t'application/x-archive',\n\t'application/x-zip-compressed',\n\t'application/x-rar',\n\t'application/x-gzip',\n\t'application/x-bzip',\n] as const;\n\nconst webAssetTypes = [\n\t'text/html',\n\t'text/css',\n\t'text/javascript',\n\t'application/json',\n\t'application/xml',\n\t'application/x-javascript',\n\t'application/x-web-app-manifest+json',\n\t'application/x-font-woff',\n\t'application/x-font-woff2',\n\t'image/svg+xml',\n\t'image/x-icon',\n] as const;\n\nconst safeMimeTypes = [\n\t...imageMimeTypes,\n\t...videoMimeTypes,\n\t...audioMimeTypes,\n\t...documentMimeTypes,\n\t...archiveMimeTypes,\n\t...webAssetTypes,\n] as Array<\n\t| (typeof imageMimeTypes)[number]\n\t| (typeof videoMimeTypes)[number]\n\t| (typeof audioMimeTypes)[number]\n\t| (typeof documentMimeTypes)[number]\n\t| (typeof archiveMimeTypes)[number]\n\t| (typeof webAssetTypes)[number]\n>;\n\nconst mimeTypeMap: Record<MimeKindWithSafe, readonly string[]> = {\n\tIMAGE: imageMimeTypes,\n\tVIDEO: videoMimeTypes,\n\tAUDIO: audioMimeTypes,\n\tDOCUMENT: documentMimeTypes,\n\tARCHIVE: archiveMimeTypes,\n\tSAFE: safeMimeTypes,\n\tOTHER: [],\n};\n\n/**\n * Returns a comma-separated accept string for input elements based on the specified kind\n * @param kind The type of MIME kind to get the accept string for\n */\nconst getInputAccept = (kind: MimeKindWithSafe = 'SAFE'): string => {\n\treturn mimeTypeMap[kind].join(',');\n};\n\nconst isAllowedMimeType = (\n\tmimeType: string,\n\tkind: MimeKindWithSafe = 'SAFE'\n): boolean => {\n\tif (!mimeType || typeof mimeType !== 'string') {\n\t\treturn false;\n\t}\n\n\tconst lowerMimeType = mimeType.toLowerCase().split(';')[0].trim();\n\n\treturn mimeTypeMap[kind].includes(lowerMimeType);\n};\n\nconst inlineContentDispositionMimeTypes = [\n\t'text/plain',\n\t'text/xml',\n\t'application/json',\n\t'application/pdf',\n] as const;\n\nconst isInlineContentDisposition = (mimeType: string): boolean => {\n\tconst lowerMimeType = mimeType.toLowerCase().split(';')[0].trim();\n\treturn (\n\t\tinlineContentDispositionMimeTypes.includes(\n\t\t\tlowerMimeType as (typeof inlineContentDispositionMimeTypes)[number]\n\t\t) ||\n\t\tlowerMimeType.startsWith('image/') ||\n\t\tlowerMimeType.startsWith('video/') ||\n\t\tlowerMimeType.startsWith('audio/')\n\t);\n};\n\nconst mimeTypeResolver = (_mimeType: string): MimeKind => {\n\tconst mimeType = _mimeType.toLowerCase().split(';')[0].trim();\n\n\tif (mimeType.startsWith('image/')) {\n\t\treturn 'IMAGE';\n\t} else if (mimeType.startsWith('video/')) {\n\t\treturn 'VIDEO';\n\t} else if (mimeType.startsWith('audio/')) {\n\t\treturn 'AUDIO';\n\t} else if (\n\t\tdocumentMimeTypes.includes(mimeType as (typeof documentMimeTypes)[number])\n\t) {\n\t\treturn 'DOCUMENT';\n\t} else if (\n\t\tarchiveMimeTypes.includes(mimeType as (typeof archiveMimeTypes)[number])\n\t) {\n\t\treturn 'ARCHIVE';\n\t} else {\n\t\treturn 'OTHER';\n\t}\n};\n\nexport {\n\ttype MimeKind,\n\ttype MimeKindWithSafe,\n\timageMimeTypes,\n\tvideoMimeTypes,\n\taudioMimeTypes,\n\tdocumentMimeTypes,\n\tarchiveMimeTypes,\n\tsafeMimeTypes,\n\tmimeTypeMap,\n\tgetInputAccept,\n\tisAllowedMimeType,\n\tisInlineContentDisposition,\n\tmimeTypeResolver,\n\tinlineContentDispositionMimeTypes,\n};\n"],"names":["imageMimeTypes","videoMimeTypes","audioMimeTypes","documentMimeTypes","archiveMimeTypes","webAssetTypes","safeMimeTypes","mimeTypeMap","getInputAccept","__name","kind","isAllowedMimeType","mimeType","lowerMimeType","inlineContentDispositionMimeTypes","isInlineContentDisposition","mimeTypeResolver","_mimeType"],"mappings":"+EAGA,MAAMA,EAAiB,CACtB,YACA,aACA,aACA,YACA,YACA,gBACA,eACA,aACA,aACA,aACA,aACA,WACD,EAEMC,EAAiB,CACtB,YACA,aACA,YACA,YACA,aACA,kBACA,kBACA,mBACA,cACA,iBACA,eACA,iBACA,iBACA,iBACA,mBACA,qBACD,EAEMC,EAAiB,CACtB,aACA,YACA,YACA,YACA,aACA,YACA,cACA,eACA,cACA,iBACA,iBACA,mBACA,eACA,aACD,EAEMC,EAAoB,CACzB,aACA,WACA,WACA,gBACA,kBACA,aACA,aACA,cACA,WACA,qBACA,kBACA,kBACA,kBACA,qBACA,0EACA,2BACA,oEACA,0CACA,gDACD,EAEMC,EAAmB,CACxB,kBACA,8BACA,+BACA,oBACA,mBACA,sBACA,mBACA,yBACA,wBACA,+BACA,oBACA,qBACA,oBACD,EAEMC,EAAgB,CACrB,YACA,WACA,kBACA,mBACA,kBACA,2BACA,sCACA,0BACA,2BACA,gBACA,cACD,EAEMC,EAAgB,CACrB,GAAGN,EACH,GAAGC,EACH,GAAGC,EACH,GAAGC,EACH,GAAGC,EACH,GAAGC,CACJ,EASME,EAA2D,CAChE,MAAOP,EACP,MAAOC,EACP,MAAOC,EACP,SAAUC,EACV,QAASC,EACT,KAAME,EACN,MAAO,CAAA,CACR,EAMME,EAAiBC,EAAA,CAACC,EAAyB,SACzCH,EAAYG,CAAI,EAAE,KAAK,GAAG,EADX,kBAIjBC,EAAoBF,EAAA,CACzBG,EACAF,EAAyB,SACZ,CACb,GAAI,CAACE,GAAY,OAAOA,GAAa,SACpC,MAAO,GAGR,MAAMC,EAAgBD,EAAS,YAAA,EAAc,MAAM,GAAG,EAAE,CAAC,EAAE,KAAA,EAE3D,OAAOL,EAAYG,CAAI,EAAE,SAASG,CAAa,CAChD,EAX0B,qBAapBC,EAAoC,CACzC,aACA,WACA,mBACA,iBACD,EAEMC,EAA6BN,EAACG,GAA8B,CACjE,MAAMC,EAAgBD,EAAS,YAAA,EAAc,MAAM,GAAG,EAAE,CAAC,EAAE,KAAA,EAC3D,OACCE,EAAkC,SACjCD,CAAA,GAEDA,EAAc,WAAW,QAAQ,GACjCA,EAAc,WAAW,QAAQ,GACjCA,EAAc,WAAW,QAAQ,CAEnC,EAVmC,8BAY7BG,EAAmBP,EAACQ,GAAgC,CACzD,MAAML,EAAWK,EAAU,YAAA,EAAc,MAAM,GAAG,EAAE,CAAC,EAAE,KAAA,EAEvD,OAAIL,EAAS,WAAW,QAAQ,EACxB,QACGA,EAAS,WAAW,QAAQ,EAC/B,QACGA,EAAS,WAAW,QAAQ,EAC/B,QAEPT,EAAkB,SAASS,CAA8C,EAElE,WAEPR,EAAiB,SAASQ,CAA6C,EAEhE,UAEA,OAET,EApByB"}
+{"version":3,"file":"mime-types-D_K53zgk.mjs","sources":["../src/utils/mime-types.ts"],"sourcesContent":["/**\n * MIME type category\n */\ntype MimeKind = 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT' | 'ARCHIVE' | 'OTHER';\n\n/**\n * MIME type category including SAFE (all safe types combined)\n */\ntype MimeKindWithSafe = MimeKind | 'SAFE';\n\n/**\n * List of common image MIME types\n */\nconst imageMimeTypes = [\n\t'image/png',\n\t'image/jpeg',\n\t'image/webp',\n\t'image/gif',\n\t'image/bmp',\n\t'image/svg+xml',\n\t'image/x-icon',\n\t'image/tiff',\n\t'image/heic',\n\t'image/avif',\n\t'image/apng',\n\t'image/jpg',\n] as const;\n\n/**\n * List of common video MIME types\n */\nconst videoMimeTypes = [\n\t'video/mp4',\n\t'video/webm',\n\t'video/ogg',\n\t'video/avi',\n\t'video/mpeg',\n\t'video/quicktime',\n\t'video/x-msvideo',\n\t'video/x-matroska',\n\t'video/x-flv',\n\t'video/x-ms-wmv',\n\t'video/x-mpeg',\n\t'video/x-ms-asf',\n\t'video/x-ms-wmx',\n\t'video/x-ms-wvx',\n\t'video/x-matroska',\n\t'video/x-flash-video',\n] as const;\n\n/**\n * List of common audio MIME types\n */\nconst audioMimeTypes = [\n\t'audio/mpeg',\n\t'audio/wav',\n\t'audio/ogg',\n\t'audio/aac',\n\t'audio/flac',\n\t'audio/mp3',\n\t'audio/x-wav',\n\t'audio/x-aiff',\n\t'audio/x-m4a',\n\t'audio/x-ms-wma',\n\t'audio/x-ms-wax',\n\t'audio/x-matroska',\n\t'audio/x-flac',\n\t'audio/x-aac',\n] as const;\n\n/**\n * List of common document MIME types\n */\nconst documentMimeTypes = [\n\t'text/plain',\n\t'text/csv',\n\t'text/rtf',\n\t'text/markdown',\n\t'text/x-markdown',\n\t'text/x-log',\n\t'text/x-ini',\n\t'text/x-yaml',\n\t'text/xml',\n\t'application/x-yaml',\n\t'application/xml',\n\t'application/rtf',\n\t'application/pdf',\n\t'application/msword',\n\t'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n\t'application/vnd.ms-excel',\n\t'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n\t'application/vnd.oasis.opendocument.text',\n\t'application/vnd.oasis.opendocument.spreadsheet',\n] as const;\n\n/**\n * List of common archive/compression MIME types\n */\nconst archiveMimeTypes = [\n\t'application/zip',\n\t'application/x-7z-compressed',\n\t'application/x-rar-compressed',\n\t'application/x-tar',\n\t'application/gzip',\n\t'application/x-bzip2',\n\t'application/x-xz',\n\t'application/x-compress',\n\t'application/x-archive',\n\t'application/x-zip-compressed',\n\t'application/x-rar',\n\t'application/x-gzip',\n\t'application/x-bzip',\n] as const;\n\n/**\n * List of web asset MIME types (HTML, CSS, JS, fonts, etc.)\n */\nconst webAssetTypes = [\n\t'text/html',\n\t'text/css',\n\t'text/javascript',\n\t'application/json',\n\t'application/xml',\n\t'application/x-javascript',\n\t'application/x-web-app-manifest+json',\n\t'application/x-font-woff',\n\t'application/x-font-woff2',\n\t'image/svg+xml',\n\t'image/x-icon',\n] as const;\n\n/**\n * Combined list of all safe MIME types\n */\nconst safeMimeTypes = [\n\t...imageMimeTypes,\n\t...videoMimeTypes,\n\t...audioMimeTypes,\n\t...documentMimeTypes,\n\t...archiveMimeTypes,\n\t...webAssetTypes,\n] as Array<\n\t| (typeof imageMimeTypes)[number]\n\t| (typeof videoMimeTypes)[number]\n\t| (typeof audioMimeTypes)[number]\n\t| (typeof documentMimeTypes)[number]\n\t| (typeof archiveMimeTypes)[number]\n\t| (typeof webAssetTypes)[number]\n>;\n\n/**\n * Map of MIME kind to list of MIME types\n */\nconst mimeTypeMap: Record<MimeKindWithSafe, readonly string[]> = {\n\tIMAGE: imageMimeTypes,\n\tVIDEO: videoMimeTypes,\n\tAUDIO: audioMimeTypes,\n\tDOCUMENT: documentMimeTypes,\n\tARCHIVE: archiveMimeTypes,\n\tSAFE: safeMimeTypes,\n\tOTHER: [],\n};\n\n/**\n * Returns a comma-separated accept string for input elements based on the specified kind\n * @param kind - The type of MIME kind to get the accept string for\n * @returns Comma-separated MIME types string\n * @example getInputAccept('IMAGE') // \"image/png,image/jpeg,...\"\n */\nconst getInputAccept = (kind: MimeKindWithSafe = 'SAFE'): string => {\n\treturn mimeTypeMap[kind].join(',');\n};\n\n/**\n * Check if a MIME type is allowed for a given kind\n * @param mimeType - MIME type to check\n * @param kind - The type of MIME kind to check against (default: 'SAFE')\n * @returns True if MIME type is allowed\n * @example isAllowedMimeType('image/png', 'IMAGE') // true\n * @example isAllowedMimeType('application/exe', 'SAFE') // false\n */\nconst isAllowedMimeType = (\n\tmimeType: string,\n\tkind: MimeKindWithSafe = 'SAFE'\n): boolean => {\n\tif (!mimeType || typeof mimeType !== 'string') {\n\t\treturn false;\n\t}\n\n\tconst lowerMimeType = mimeType.toLowerCase().split(';')[0].trim();\n\n\treturn mimeTypeMap[kind].includes(lowerMimeType);\n};\n\n/**\n * List of MIME types that should use inline Content-Disposition\n */\nconst inlineContentDispositionMimeTypes = [\n\t'text/plain',\n\t'text/xml',\n\t'application/json',\n\t'application/pdf',\n] as const;\n\n/**\n * Check if a MIME type should use inline Content-Disposition\n * @param mimeType - MIME type to check\n * @returns True if should be inline\n * @example isInlineContentDisposition('image/png') // true\n * @example isInlineContentDisposition('application/zip') // false\n */\nconst isInlineContentDisposition = (mimeType: string): boolean => {\n\tconst lowerMimeType = mimeType.toLowerCase().split(';')[0].trim();\n\treturn (\n\t\tinlineContentDispositionMimeTypes.includes(\n\t\t\tlowerMimeType as (typeof inlineContentDispositionMimeTypes)[number]\n\t\t) ||\n\t\tlowerMimeType.startsWith('image/') ||\n\t\tlowerMimeType.startsWith('video/') ||\n\t\tlowerMimeType.startsWith('audio/')\n\t);\n};\n\n/**\n * Resolve a MIME type to its category\n * @param _mimeType - MIME type to resolve\n * @returns The MIME kind category\n * @example mimeTypeResolver('image/png') // 'IMAGE'\n * @example mimeTypeResolver('video/mp4') // 'VIDEO'\n */\nconst mimeTypeResolver = (_mimeType: string): MimeKind => {\n\tconst mimeType = _mimeType.toLowerCase().split(';')[0].trim();\n\n\tif (mimeType.startsWith('image/')) {\n\t\treturn 'IMAGE';\n\t} else if (mimeType.startsWith('video/')) {\n\t\treturn 'VIDEO';\n\t} else if (mimeType.startsWith('audio/')) {\n\t\treturn 'AUDIO';\n\t} else if (\n\t\tdocumentMimeTypes.includes(mimeType as (typeof documentMimeTypes)[number])\n\t) {\n\t\treturn 'DOCUMENT';\n\t} else if (\n\t\tarchiveMimeTypes.includes(mimeType as (typeof archiveMimeTypes)[number])\n\t) {\n\t\treturn 'ARCHIVE';\n\t} else {\n\t\treturn 'OTHER';\n\t}\n};\n\nexport {\n\ttype MimeKind,\n\ttype MimeKindWithSafe,\n\timageMimeTypes,\n\tvideoMimeTypes,\n\taudioMimeTypes,\n\tdocumentMimeTypes,\n\tarchiveMimeTypes,\n\tsafeMimeTypes,\n\tmimeTypeMap,\n\tgetInputAccept,\n\tisAllowedMimeType,\n\tisInlineContentDisposition,\n\tmimeTypeResolver,\n\tinlineContentDispositionMimeTypes,\n};\n"],"names":["imageMimeTypes","videoMimeTypes","audioMimeTypes","documentMimeTypes","archiveMimeTypes","webAssetTypes","safeMimeTypes","mimeTypeMap","getInputAccept","__name","kind","isAllowedMimeType","mimeType","lowerMimeType","inlineContentDispositionMimeTypes","isInlineContentDisposition","mimeTypeResolver","_mimeType"],"mappings":"+EAaA,MAAMA,EAAiB,CACtB,YACA,aACA,aACA,YACA,YACA,gBACA,eACA,aACA,aACA,aACA,aACA,WACD,EAKMC,EAAiB,CACtB,YACA,aACA,YACA,YACA,aACA,kBACA,kBACA,mBACA,cACA,iBACA,eACA,iBACA,iBACA,iBACA,mBACA,qBACD,EAKMC,EAAiB,CACtB,aACA,YACA,YACA,YACA,aACA,YACA,cACA,eACA,cACA,iBACA,iBACA,mBACA,eACA,aACD,EAKMC,EAAoB,CACzB,aACA,WACA,WACA,gBACA,kBACA,aACA,aACA,cACA,WACA,qBACA,kBACA,kBACA,kBACA,qBACA,0EACA,2BACA,oEACA,0CACA,gDACD,EAKMC,EAAmB,CACxB,kBACA,8BACA,+BACA,oBACA,mBACA,sBACA,mBACA,yBACA,wBACA,+BACA,oBACA,qBACA,oBACD,EAKMC,EAAgB,CACrB,YACA,WACA,kBACA,mBACA,kBACA,2BACA,sCACA,0BACA,2BACA,gBACA,cACD,EAKMC,EAAgB,CACrB,GAAGN,EACH,GAAGC,EACH,GAAGC,EACH,GAAGC,EACH,GAAGC,EACH,GAAGC,CACJ,EAYME,EAA2D,CAChE,MAAOP,EACP,MAAOC,EACP,MAAOC,EACP,SAAUC,EACV,QAASC,EACT,KAAME,EACN,MAAO,CAAA,CACR,EAQME,EAAiBC,EAAA,CAACC,EAAyB,SACzCH,EAAYG,CAAI,EAAE,KAAK,GAAG,EADX,kBAYjBC,EAAoBF,EAAA,CACzBG,EACAF,EAAyB,SACZ,CACb,GAAI,CAACE,GAAY,OAAOA,GAAa,SACpC,MAAO,GAGR,MAAMC,EAAgBD,EAAS,YAAA,EAAc,MAAM,GAAG,EAAE,CAAC,EAAE,KAAA,EAE3D,OAAOL,EAAYG,CAAI,EAAE,SAASG,CAAa,CAChD,EAX0B,qBAgBpBC,EAAoC,CACzC,aACA,WACA,mBACA,iBACD,EASMC,EAA6BN,EAACG,GAA8B,CACjE,MAAMC,EAAgBD,EAAS,YAAA,EAAc,MAAM,GAAG,EAAE,CAAC,EAAE,KAAA,EAC3D,OACCE,EAAkC,SACjCD,CAAA,GAEDA,EAAc,WAAW,QAAQ,GACjCA,EAAc,WAAW,QAAQ,GACjCA,EAAc,WAAW,QAAQ,CAEnC,EAVmC,8BAmB7BG,EAAmBP,EAACQ,GAAgC,CACzD,MAAML,EAAWK,EAAU,YAAA,EAAc,MAAM,GAAG,EAAE,CAAC,EAAE,KAAA,EAEvD,OAAIL,EAAS,WAAW,QAAQ,EACxB,QACGA,EAAS,WAAW,QAAQ,EAC/B,QACGA,EAAS,WAAW,QAAQ,EAC/B,QAEPT,EAAkB,SAASS,CAA8C,EAElE,WAEPR,EAAiB,SAASQ,CAA6C,EAEhE,UAEA,OAET,EApByB"}

package/dist/{mime-types-Bjt4NvnE.d.cts → mime-types-Dajfhq2c.d.cts}

@@ -1,21 +1,78 @@
+/**
+ * MIME type category
+ */
 type MimeKind = 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT' | 'ARCHIVE' | 'OTHER';
+/**
+ * MIME type category including SAFE (all safe types combined)
+ */
 type MimeKindWithSafe = MimeKind | 'SAFE';
+/**
+ * List of common image MIME types
+ */
 declare const imageMimeTypes: readonly ["image/png", "image/jpeg", "image/webp", "image/gif", "image/bmp", "image/svg+xml", "image/x-icon", "image/tiff", "image/heic", "image/avif", "image/apng", "image/jpg"];
+/**
+ * List of common video MIME types
+ */
 declare const videoMimeTypes: readonly ["video/mp4", "video/webm", "video/ogg", "video/avi", "video/mpeg", "video/quicktime", "video/x-msvideo", "video/x-matroska", "video/x-flv", "video/x-ms-wmv", "video/x-mpeg", "video/x-ms-asf", "video/x-ms-wmx", "video/x-ms-wvx", "video/x-matroska", "video/x-flash-video"];
+/**
+ * List of common audio MIME types
+ */
 declare const audioMimeTypes: readonly ["audio/mpeg", "audio/wav", "audio/ogg", "audio/aac", "audio/flac", "audio/mp3", "audio/x-wav", "audio/x-aiff", "audio/x-m4a", "audio/x-ms-wma", "audio/x-ms-wax", "audio/x-matroska", "audio/x-flac", "audio/x-aac"];
+/**
+ * List of common document MIME types
+ */
 declare const documentMimeTypes: readonly ["text/plain", "text/csv", "text/rtf", "text/markdown", "text/x-markdown", "text/x-log", "text/x-ini", "text/x-yaml", "text/xml", "application/x-yaml", "application/xml", "application/rtf", "application/pdf", "application/msword", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "application/vnd.ms-excel", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "application/vnd.oasis.opendocument.text", "application/vnd.oasis.opendocument.spreadsheet"];
+/**
+ * List of common archive/compression MIME types
+ */
 declare const archiveMimeTypes: readonly ["application/zip", "application/x-7z-compressed", "application/x-rar-compressed", "application/x-tar", "application/gzip", "application/x-bzip2", "application/x-xz", "application/x-compress", "application/x-archive", "application/x-zip-compressed", "application/x-rar", "application/x-gzip", "application/x-bzip"];
+/**
+ * List of web asset MIME types (HTML, CSS, JS, fonts, etc.)
+ */
 declare const webAssetTypes: readonly ["text/html", "text/css", "text/javascript", "application/json", "application/xml", "application/x-javascript", "application/x-web-app-manifest+json", "application/x-font-woff", "application/x-font-woff2", "image/svg+xml", "image/x-icon"];
+/**
+ * Combined list of all safe MIME types
+ */
 declare const safeMimeTypes: Array<(typeof imageMimeTypes)[number] | (typeof videoMimeTypes)[number] | (typeof audioMimeTypes)[number] | (typeof documentMimeTypes)[number] | (typeof archiveMimeTypes)[number] | (typeof webAssetTypes)[number]>;
+/**
+ * Map of MIME kind to list of MIME types
+ */
 declare const mimeTypeMap: Record<MimeKindWithSafe, readonly string[]>;
 /**
  * Returns a comma-separated accept string for input elements based on the specified kind
- * @param kind The type of MIME kind to get the accept string for
+ * @param kind - The type of MIME kind to get the accept string for
+ * @returns Comma-separated MIME types string
+ * @example getInputAccept('IMAGE') // "image/png,image/jpeg,..."
  */
 declare const getInputAccept: (kind?: MimeKindWithSafe) => string;
+/**
+ * Check if a MIME type is allowed for a given kind
+ * @param mimeType - MIME type to check
+ * @param kind - The type of MIME kind to check against (default: 'SAFE')
+ * @returns True if MIME type is allowed
+ * @example isAllowedMimeType('image/png', 'IMAGE') // true
+ * @example isAllowedMimeType('application/exe', 'SAFE') // false
+ */
 declare const isAllowedMimeType: (mimeType: string, kind?: MimeKindWithSafe) => boolean;
+/**
+ * List of MIME types that should use inline Content-Disposition
+ */
 declare const inlineContentDispositionMimeTypes: readonly ["text/plain", "text/xml", "application/json", "application/pdf"];
+/**
+ * Check if a MIME type should use inline Content-Disposition
+ * @param mimeType - MIME type to check
+ * @returns True if should be inline
+ * @example isInlineContentDisposition('image/png') // true
+ * @example isInlineContentDisposition('application/zip') // false
+ */
 declare const isInlineContentDisposition: (mimeType: string) => boolean;
+/**
+ * Resolve a MIME type to its category
+ * @param _mimeType - MIME type to resolve
+ * @returns The MIME kind category
+ * @example mimeTypeResolver('image/png') // 'IMAGE'
+ * @example mimeTypeResolver('video/mp4') // 'VIDEO'
+ */
 declare const mimeTypeResolver: (_mimeType: string) => MimeKind;
 
 type mimeTypes_MimeKind = MimeKind;

package/dist/{mime-types-Bjt4NvnE.d.mts → mime-types-Dajfhq2c.d.mts}

@@ -1,21 +1,78 @@
+/**
+ * MIME type category
+ */
 type MimeKind = 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT' | 'ARCHIVE' | 'OTHER';
+/**
+ * MIME type category including SAFE (all safe types combined)
+ */
 type MimeKindWithSafe = MimeKind | 'SAFE';
+/**
+ * List of common image MIME types
+ */
 declare const imageMimeTypes: readonly ["image/png", "image/jpeg", "image/webp", "image/gif", "image/bmp", "image/svg+xml", "image/x-icon", "image/tiff", "image/heic", "image/avif", "image/apng", "image/jpg"];
+/**
+ * List of common video MIME types
+ */
 declare const videoMimeTypes: readonly ["video/mp4", "video/webm", "video/ogg", "video/avi", "video/mpeg", "video/quicktime", "video/x-msvideo", "video/x-matroska", "video/x-flv", "video/x-ms-wmv", "video/x-mpeg", "video/x-ms-asf", "video/x-ms-wmx", "video/x-ms-wvx", "video/x-matroska", "video/x-flash-video"];
+/**
+ * List of common audio MIME types
+ */
 declare const audioMimeTypes: readonly ["audio/mpeg", "audio/wav", "audio/ogg", "audio/aac", "audio/flac", "audio/mp3", "audio/x-wav", "audio/x-aiff", "audio/x-m4a", "audio/x-ms-wma", "audio/x-ms-wax", "audio/x-matroska", "audio/x-flac", "audio/x-aac"];
+/**
+ * List of common document MIME types
+ */
 declare const documentMimeTypes: readonly ["text/plain", "text/csv", "text/rtf", "text/markdown", "text/x-markdown", "text/x-log", "text/x-ini", "text/x-yaml", "text/xml", "application/x-yaml", "application/xml", "application/rtf", "application/pdf", "application/msword", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "application/vnd.ms-excel", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "application/vnd.oasis.opendocument.text", "application/vnd.oasis.opendocument.spreadsheet"];
+/**
+ * List of common archive/compression MIME types
+ */
 declare const archiveMimeTypes: readonly ["application/zip", "application/x-7z-compressed", "application/x-rar-compressed", "application/x-tar", "application/gzip", "application/x-bzip2", "application/x-xz", "application/x-compress", "application/x-archive", "application/x-zip-compressed", "application/x-rar", "application/x-gzip", "application/x-bzip"];
+/**
+ * List of web asset MIME types (HTML, CSS, JS, fonts, etc.)
+ */
 declare const webAssetTypes: readonly ["text/html", "text/css", "text/javascript", "application/json", "application/xml", "application/x-javascript", "application/x-web-app-manifest+json", "application/x-font-woff", "application/x-font-woff2", "image/svg+xml", "image/x-icon"];
+/**
+ * Combined list of all safe MIME types
+ */
 declare const safeMimeTypes: Array<(typeof imageMimeTypes)[number] | (typeof videoMimeTypes)[number] | (typeof audioMimeTypes)[number] | (typeof documentMimeTypes)[number] | (typeof archiveMimeTypes)[number] | (typeof webAssetTypes)[number]>;
+/**
+ * Map of MIME kind to list of MIME types
+ */
 declare const mimeTypeMap: Record<MimeKindWithSafe, readonly string[]>;
 /**
  * Returns a comma-separated accept string for input elements based on the specified kind
- * @param kind The type of MIME kind to get the accept string for
+ * @param kind - The type of MIME kind to get the accept string for
+ * @returns Comma-separated MIME types string
+ * @example getInputAccept('IMAGE') // "image/png,image/jpeg,..."
  */
 declare const getInputAccept: (kind?: MimeKindWithSafe) => string;
+/**
+ * Check if a MIME type is allowed for a given kind
+ * @param mimeType - MIME type to check
+ * @param kind - The type of MIME kind to check against (default: 'SAFE')
+ * @returns True if MIME type is allowed
+ * @example isAllowedMimeType('image/png', 'IMAGE') // true
+ * @example isAllowedMimeType('application/exe', 'SAFE') // false
+ */
 declare const isAllowedMimeType: (mimeType: string, kind?: MimeKindWithSafe) => boolean;
+/**
+ * List of MIME types that should use inline Content-Disposition
+ */
 declare const inlineContentDispositionMimeTypes: readonly ["text/plain", "text/xml", "application/json", "application/pdf"];
+/**
+ * Check if a MIME type should use inline Content-Disposition
+ * @param mimeType - MIME type to check
+ * @returns True if should be inline
+ * @example isInlineContentDisposition('image/png') // true
+ * @example isInlineContentDisposition('application/zip') // false
+ */
 declare const isInlineContentDisposition: (mimeType: string) => boolean;
+/**
+ * Resolve a MIME type to its category
+ * @param _mimeType - MIME type to resolve
+ * @returns The MIME kind category
+ * @example mimeTypeResolver('image/png') // 'IMAGE'
+ * @example mimeTypeResolver('video/mp4') // 'VIDEO'
+ */
 declare const mimeTypeResolver: (_mimeType: string) => MimeKind;
 
 type mimeTypes_MimeKind = MimeKind;

package/dist/numbers-B_mptknO.cjs

@@ -0,0 +1,2 @@
+"use strict";var X=Object.defineProperty;var r=(n,e)=>X(n,"name",{value:e,configurable:!0});const s=r(n=>Number.isInteger(n),"isInt"),I=r(n=>!s(n),"isFloat"),l=r(n=>n%2===0,"isEven"),d=r(n=>n%2!==0,"isOdd"),u=r((n,e=2)=>{const t=10**e;return Math.round(n*t)/t},"roundTo"),M=r((n,e,t)=>Math.min(Math.max(n,e),t),"clamp"),m=r((n,e,t=2)=>e===0?0:u(n/e*100,t),"percentage"),N=r((n,e)=>n/100*e,"percentageOf"),p=r((n,e,t)=>n>=e&&n<=t,"inRange"),f=r((n,e,t)=>n+(e-n)*t,"lerp"),_=r(n=>n.reduce((e,t)=>e+t,0),"sum"),T=r(n=>c(n),"average"),h=2**31-1,b=-2147483648,v=BigInt(2)**BigInt(63)-BigInt(1),A=-(BigInt(2)**BigInt(63)),c=r(n=>n.length===0?null:n.reduce((i,a)=>i+a,0)/n.length,"calculateMean"),E=r(n=>{if(n.length===0)return null;const e=[...n].sort((a,o)=>a-o),t=Math.floor(e.length/2);if(l(e.length)){const a=e[t],o=e[t-1];return(a+o)/2}else return e.length===1?e[0]:e[t]},"calculateMedian"),g=r(n=>{if(n.length===0)return null;const e=c(n);if(typeof e!="number")return null;const t=n.map(a=>(a-e)**2);return c(t)},"calculateVariance"),S=r(n=>{const e=g(n);return typeof e!="number"?null:Math.sqrt(e)},"calculateStandardDeviation"),O=r((n,e)=>typeof e=="bigint"?e>BigInt(Number.MAX_SAFE_INTEGER)?e.toString():Number(e):e,"bigIntSerializationHelper");var B=Object.freeze({__proto__:null,INT32_MAX:h,INT32_MIN:b,INT64_MAX:v,INT64_MIN:A,average:T,bigIntSerializationHelper:O,calculateMean:c,calculateMedian:E,calculateStandardDeviation:S,calculateVariance:g,clamp:M,inRange:p,isEven:l,isFloat:I,isInt:s,isOdd:d,lerp:f,percentage:m,percentageOf:N,roundTo:u,sum:_});exports.INT32_MAX=h,exports.INT32_MIN=b,exports.INT64_MAX=v,exports.INT64_MIN=A,exports.average=T,exports.bigIntSerializationHelper=O,exports.calculateMean=c,exports.calculateMedian=E,exports.calculateStandardDeviation=S,exports.calculateVariance=g,exports.clamp=M,exports.inRange=p,exports.isEven=l,exports.isFloat=I,exports.isInt=s,exports.isOdd=d,exports.lerp=f,exports.numbers=B,exports.percentage=m,exports.percentageOf=N,exports.roundTo=u,exports.sum=_;
+//# sourceMappingURL=numbers-B_mptknO.cjs.map

package/dist/numbers-B_mptknO.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers-B_mptknO.cjs","sources":["../src/utils/numbers.ts"],"sourcesContent":["/**\n * Check if a number is an integer\n * @param n - Number to check\n * @returns True if number is an integer\n * @example isInt(5) // true, isInt(5.5) // false\n */\nconst isInt = (n: number): boolean => Number.isInteger(n);\n\n/**\n * Check if a number is a float (has decimal places)\n * @param n - Number to check\n * @returns True if number is a float\n * @example isFloat(5.5) // true, isFloat(5) // false\n */\nconst isFloat = (n: number): boolean => !isInt(n);\n\n/**\n * Check if a number is even\n * @param n - Number to check\n * @returns True if number is even\n * @example isEven(4) // true, isEven(5) // false\n */\nconst isEven = (n: number): boolean => n % 2 === 0;\n\n/**\n * Check if a number is odd\n * @param n - Number to check\n * @returns True if number is odd\n * @example isOdd(5) // true, isOdd(4) // false\n */\nconst isOdd = (n: number): boolean => n % 2 !== 0;\n\n/**\n * Round a number to a specific number of decimal places\n * @param value - Number to round\n * @param decimals - Number of decimal places (default: 2)\n * @returns Rounded number\n * @example roundTo(3.14159, 2) // 3.14\n */\nconst roundTo = (value: number, decimals = 2): number => {\n\tconst factor = 10 ** decimals;\n\treturn Math.round(value * factor) / factor;\n};\n\n/**\n * Clamp a number between min and max values\n * @param value - Number to clamp\n * @param min - Minimum value\n * @param max - Maximum value\n * @returns Clamped number\n * @example clamp(15, 0, 10) // 10, clamp(-5, 0, 10) // 0\n */\nconst clamp = (value: number, min: number, max: number): number => {\n\treturn Math.min(Math.max(value, min), max);\n};\n\n/**\n * Calculate percentage of a value relative to a total\n * @param value - The value\n * @param total - The total\n * @param decimals - Number of decimal places (default: 2)\n * @returns Percentage (0-100)\n * @example percentage(25, 100) // 25, percentage(1, 3, 1) // 33.3\n */\nconst percentage = (value: number, total: number, decimals = 2): number => {\n\tif (total === 0) return 0;\n\treturn roundTo((value / total) * 100, decimals);\n};\n\n/**\n * Calculate what value a percentage represents\n * @param percent - Percentage (0-100)\n * @param total - The total\n * @returns The value\n * @example percentageOf(25, 100) // 25, percentageOf(50, 200) // 100\n */\nconst percentageOf = (percent: number, total: number): number => {\n\treturn (percent / 100) * total;\n};\n\n/**\n * Check if a number is within a range (inclusive)\n * @param value - Number to check\n * @param min - Minimum value\n * @param max - Maximum value\n * @returns True if value is in range\n * @example inRange(5, 0, 10) // true, inRange(15, 0, 10) // false\n */\nconst inRange = (value: number, min: number, max: number): boolean => {\n\treturn value >= min && value <= max;\n};\n\n/**\n * Linear interpolation between two values\n * @param start - Start value\n * @param end - End value\n * @param t - Interpolation factor (0-1)\n * @returns Interpolated value\n * @example lerp(0, 100, 0.5) // 50, lerp(0, 100, 0.25) // 25\n */\nconst lerp = (start: number, end: number, t: number): number => {\n\treturn start + (end - start) * t;\n};\n\n/**\n * Sum an array of numbers\n * @param values - Numbers to sum\n * @returns Sum of all values\n * @example sum([1, 2, 3, 4]) // 10\n */\nconst sum = (values: number[]): number => {\n\treturn values.reduce((a, b) => a + b, 0);\n};\n\n/**\n * Get the average (mean) of an array of numbers\n * @param values - Numbers to average\n * @returns Average or null if empty\n * @example average([1, 2, 3, 4]) // 2.5\n */\nconst average = (values: number[]): number | null => calculateMean(values);\n\nconst INT32_MAX: number = 2 ** 31 - 1;\nconst INT32_MIN: number = -(2 ** 31);\nconst INT64_MAX: bigint = BigInt(2) ** BigInt(63) - BigInt(1);\nconst INT64_MIN: bigint = -(BigInt(2) ** BigInt(63));\n\n/**\n * Calculate the mean (average) of an array of numbers\n * @param values - Numbers to calculate mean of\n * @returns Mean or null if empty\n * @example calculateMean([1, 2, 3, 4]) // 2.5\n */\nconst calculateMean = (values: number[]): number | null => {\n\tif (values.length === 0) return null;\n\tconst sum = values.reduce((a, b) => a + b, 0);\n\tconst average = sum / values.length;\n\treturn average;\n};\n\n/**\n * Calculate the median (middle value) of an array of numbers\n * @param values - Numbers to calculate median of\n * @returns Median or null if empty\n * @example calculateMedian([1, 2, 3, 4, 5]) // 3\n */\nconst calculateMedian = (values: number[]): number | null => {\n\tif (values.length === 0) return null;\n\tconst sorted = [...values].sort((a, b) => a - b);\n\tconst middleIndex = Math.floor(sorted.length / 2);\n\tconst isEvenLength = isEven(sorted.length);\n\tif (isEvenLength) {\n\t\tconst a = sorted[middleIndex] as number;\n\t\tconst b = sorted[middleIndex - 1] as number;\n\t\tconst average = (a + b) / 2;\n\t\treturn average;\n\t} else {\n\t\tif (sorted.length === 1) return sorted[0] as number;\n\t\tconst median = sorted[middleIndex] as number;\n\t\treturn median;\n\t}\n};\n\n/**\n * Calculate the variance of an array of numbers\n * @param values - Numbers to calculate variance of\n * @returns Variance or null if empty\n * @example calculateVariance([2, 4, 6, 8]) // 5\n */\nconst calculateVariance = (values: number[]): number | null => {\n\tif (values.length === 0) return null;\n\tconst mean = calculateMean(values);\n\tif (typeof mean !== 'number') return null;\n\tconst squaredDifferences = values.map((value) => (value - mean) ** 2);\n\tconst variance = calculateMean(squaredDifferences);\n\treturn variance;\n};\n\n/**\n * Calculate the standard deviation of an array of numbers\n * @param values - Numbers to calculate standard deviation of\n * @returns Standard deviation or null if empty\n * @example calculateStandardDeviation([2, 4, 6, 8]) // ~2.24\n */\nconst calculateStandardDeviation = (values: number[]): number | null => {\n\tconst variance = calculateVariance(values);\n\tif (typeof variance !== 'number') return null;\n\treturn Math.sqrt(variance);\n};\n\n/**\n * Helper for JSON.stringify to handle BigInt serialization\n * Converts large bigints to strings and small ones to numbers\n * @param _ - Key (unused)\n * @param value - Value to serialize\n * @returns Serializable value\n * @example JSON.stringify({big: 9007199254740992n}, bigIntSerializationHelper)\n */\nconst bigIntSerializationHelper = (_: string, value: unknown): unknown =>\n\ttypeof value === 'bigint'\n\t\t? value > BigInt(Number.MAX_SAFE_INTEGER)\n\t\t\t? value.toString() // Convert large bigints to strings\n\t\t\t: Number(value) // Convert small/safe bigints to numbers\n\t\t: value; // Return other values as is\n\nexport {\n\tisInt,\n\tisFloat,\n\tisEven,\n\tisOdd,\n\troundTo,\n\tclamp,\n\tpercentage,\n\tpercentageOf,\n\tinRange,\n\tlerp,\n\tsum,\n\taverage,\n\tINT32_MAX,\n\tINT32_MIN,\n\tINT64_MAX,\n\tINT64_MIN,\n\tcalculateMean,\n\tcalculateMedian,\n\tcalculateVariance,\n\tcalculateStandardDeviation,\n\tbigIntSerializationHelper,\n};\n"],"names":["isInt","__name","isFloat","isEven","isOdd","roundTo","value","decimals","factor","clamp","min","max","percentage","total","percentageOf","percent","inRange","lerp","start","end","sum","values","a","b","average","calculateMean","INT32_MAX","INT32_MIN","INT64_MAX","INT64_MIN","calculateMedian","sorted","middleIndex","calculateVariance","mean","squaredDifferences","calculateStandardDeviation","variance","bigIntSerializationHelper","_"],"mappings":"4FAMA,MAAMA,EAAQC,EAAC,GAAuB,OAAO,UAAU,CAAC,EAA1C,SAQRC,EAAUD,EAAC,GAAuB,CAACD,EAAM,CAAC,EAAhC,WAQVG,EAASF,EAAC,GAAuB,EAAI,IAAM,EAAlC,UAQTG,EAAQH,EAAC,GAAuB,EAAI,IAAM,EAAlC,SASRI,EAAUJ,EAAA,CAACK,EAAeC,EAAW,IAAc,CACxD,MAAMC,EAAS,IAAMD,EACrB,OAAO,KAAK,MAAMD,EAAQE,CAAM,EAAIA,CACrC,EAHgB,WAaVC,EAAQR,EAAA,CAACK,EAAeI,EAAaC,IACnC,KAAK,IAAI,KAAK,IAAIL,EAAOI,CAAG,EAAGC,CAAG,EAD5B,SAYRC,EAAaX,EAAA,CAACK,EAAeO,EAAeN,EAAW,IACxDM,IAAU,EAAU,EACjBR,EAASC,EAAQO,EAAS,IAAKN,CAAQ,EAF5B,cAYbO,EAAeb,EAAA,CAACc,EAAiBF,IAC9BE,EAAU,IAAOF,EADL,gBAYfG,EAAUf,EAAA,CAACK,EAAeI,EAAaC,IACrCL,GAASI,GAAOJ,GAASK,EADjB,WAYVM,EAAOhB,EAAA,CAACiB,EAAeC,EAAa,IAClCD,GAASC,EAAMD,GAAS,EADnB,QAUPE,EAAMnB,EAACoB,GACLA,EAAO,OAAO,CAACC,EAAGC,IAAMD,EAAIC,EAAG,CAAC,EAD5B,OAUNC,EAAUvB,EAACoB,GAAoCI,EAAcJ,CAAM,EAAzD,WAEVK,EAAoB,GAAK,GAAK,EAC9BC,EAAoB,YACpBC,EAAoB,OAAO,CAAC,GAAK,OAAO,EAAE,EAAI,OAAO,CAAC,EACtDC,EAAoB,EAAE,OAAO,CAAC,GAAK,OAAO,EAAE,GAQ5CJ,EAAgBxB,EAACoB,GAClBA,EAAO,SAAW,EAAU,KACpBA,EAAO,OAAO,CAACC,EAAGC,IAAMD,EAAIC,EAAG,CAAC,EACtBF,EAAO,OAHR,iBAahBS,EAAkB7B,EAACoB,GAAoC,CAC5D,GAAIA,EAAO,SAAW,EAAG,OAAO,KAChC,MAAMU,EAAS,CAAC,GAAGV,CAAM,EAAE,KAAK,CAAC,EAAGE,IAAM,EAAIA,CAAC,EACzCS,EAAc,KAAK,MAAMD,EAAO,OAAS,CAAC,EAEhD,GADqB5B,EAAO4B,EAAO,MAAM,EACvB,CACjB,MAAM,EAAIA,EAAOC,CAAW,EACtBT,EAAIQ,EAAOC,EAAc,CAAC,EAEhC,OADiB,EAAIT,GAAK,CAE3B,KACC,QAAIQ,EAAO,SAAW,EAAUA,EAAO,CAAC,EACzBA,EAAOC,CAAW,CAGnC,EAfwB,mBAuBlBC,EAAoBhC,EAACoB,GAAoC,CAC9D,GAAIA,EAAO,SAAW,EAAG,OAAO,KAChC,MAAMa,EAAOT,EAAcJ,CAAM,EACjC,GAAI,OAAOa,GAAS,SAAU,OAAO,KACrC,MAAMC,EAAqBd,EAAO,IAAKf,IAAWA,EAAQ4B,IAAS,CAAC,EAEpE,OADiBT,EAAcU,CAAkB,CAElD,EAP0B,qBAepBC,EAA6BnC,EAACoB,GAAoC,CACvE,MAAMgB,EAAWJ,EAAkBZ,CAAM,EACzC,OAAI,OAAOgB,GAAa,SAAiB,KAClC,KAAK,KAAKA,CAAQ,CAC1B,EAJmC,8BAc7BC,EAA4BrC,EAAA,CAACsC,EAAWjC,IAC7C,OAAOA,GAAU,SACdA,EAAQ,OAAO,OAAO,gBAAgB,EACrCA,EAAM,WACN,OAAOA,CAAK,EACbA,EAL8B"}

package/dist/numbers-C2680fmA.d.cts

@@ -0,0 +1,184 @@
+/**
+ * Check if a number is an integer
+ * @param n - Number to check
+ * @returns True if number is an integer
+ * @example isInt(5) // true, isInt(5.5) // false
+ */
+declare const isInt: (n: number) => boolean;
+/**
+ * Check if a number is a float (has decimal places)
+ * @param n - Number to check
+ * @returns True if number is a float
+ * @example isFloat(5.5) // true, isFloat(5) // false
+ */
+declare const isFloat: (n: number) => boolean;
+/**
+ * Check if a number is even
+ * @param n - Number to check
+ * @returns True if number is even
+ * @example isEven(4) // true, isEven(5) // false
+ */
+declare const isEven: (n: number) => boolean;
+/**
+ * Check if a number is odd
+ * @param n - Number to check
+ * @returns True if number is odd
+ * @example isOdd(5) // true, isOdd(4) // false
+ */
+declare const isOdd: (n: number) => boolean;
+/**
+ * Round a number to a specific number of decimal places
+ * @param value - Number to round
+ * @param decimals - Number of decimal places (default: 2)
+ * @returns Rounded number
+ * @example roundTo(3.14159, 2) // 3.14
+ */
+declare const roundTo: (value: number, decimals?: number) => number;
+/**
+ * Clamp a number between min and max values
+ * @param value - Number to clamp
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @returns Clamped number
+ * @example clamp(15, 0, 10) // 10, clamp(-5, 0, 10) // 0
+ */
+declare const clamp: (value: number, min: number, max: number) => number;
+/**
+ * Calculate percentage of a value relative to a total
+ * @param value - The value
+ * @param total - The total
+ * @param decimals - Number of decimal places (default: 2)
+ * @returns Percentage (0-100)
+ * @example percentage(25, 100) // 25, percentage(1, 3, 1) // 33.3
+ */
+declare const percentage: (value: number, total: number, decimals?: number) => number;
+/**
+ * Calculate what value a percentage represents
+ * @param percent - Percentage (0-100)
+ * @param total - The total
+ * @returns The value
+ * @example percentageOf(25, 100) // 25, percentageOf(50, 200) // 100
+ */
+declare const percentageOf: (percent: number, total: number) => number;
+/**
+ * Check if a number is within a range (inclusive)
+ * @param value - Number to check
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @returns True if value is in range
+ * @example inRange(5, 0, 10) // true, inRange(15, 0, 10) // false
+ */
+declare const inRange: (value: number, min: number, max: number) => boolean;
+/**
+ * Linear interpolation between two values
+ * @param start - Start value
+ * @param end - End value
+ * @param t - Interpolation factor (0-1)
+ * @returns Interpolated value
+ * @example lerp(0, 100, 0.5) // 50, lerp(0, 100, 0.25) // 25
+ */
+declare const lerp: (start: number, end: number, t: number) => number;
+/**
+ * Sum an array of numbers
+ * @param values - Numbers to sum
+ * @returns Sum of all values
+ * @example sum([1, 2, 3, 4]) // 10
+ */
+declare const sum: (values: number[]) => number;
+/**
+ * Get the average (mean) of an array of numbers
+ * @param values - Numbers to average
+ * @returns Average or null if empty
+ * @example average([1, 2, 3, 4]) // 2.5
+ */
+declare const average: (values: number[]) => number | null;
+declare const INT32_MAX: number;
+declare const INT32_MIN: number;
+declare const INT64_MAX: bigint;
+declare const INT64_MIN: bigint;
+/**
+ * Calculate the mean (average) of an array of numbers
+ * @param values - Numbers to calculate mean of
+ * @returns Mean or null if empty
+ * @example calculateMean([1, 2, 3, 4]) // 2.5
+ */
+declare const calculateMean: (values: number[]) => number | null;
+/**
+ * Calculate the median (middle value) of an array of numbers
+ * @param values - Numbers to calculate median of
+ * @returns Median or null if empty
+ * @example calculateMedian([1, 2, 3, 4, 5]) // 3
+ */
+declare const calculateMedian: (values: number[]) => number | null;
+/**
+ * Calculate the variance of an array of numbers
+ * @param values - Numbers to calculate variance of
+ * @returns Variance or null if empty
+ * @example calculateVariance([2, 4, 6, 8]) // 5
+ */
+declare const calculateVariance: (values: number[]) => number | null;
+/**
+ * Calculate the standard deviation of an array of numbers
+ * @param values - Numbers to calculate standard deviation of
+ * @returns Standard deviation or null if empty
+ * @example calculateStandardDeviation([2, 4, 6, 8]) // ~2.24
+ */
+declare const calculateStandardDeviation: (values: number[]) => number | null;
+/**
+ * Helper for JSON.stringify to handle BigInt serialization
+ * Converts large bigints to strings and small ones to numbers
+ * @param _ - Key (unused)
+ * @param value - Value to serialize
+ * @returns Serializable value
+ * @example JSON.stringify({big: 9007199254740992n}, bigIntSerializationHelper)
+ */
+declare const bigIntSerializationHelper: (_: string, value: unknown) => unknown;
+
+declare const numbers_INT32_MAX: typeof INT32_MAX;
+declare const numbers_INT32_MIN: typeof INT32_MIN;
+declare const numbers_INT64_MAX: typeof INT64_MAX;
+declare const numbers_INT64_MIN: typeof INT64_MIN;
+declare const numbers_average: typeof average;
+declare const numbers_bigIntSerializationHelper: typeof bigIntSerializationHelper;
+declare const numbers_calculateMean: typeof calculateMean;
+declare const numbers_calculateMedian: typeof calculateMedian;
+declare const numbers_calculateStandardDeviation: typeof calculateStandardDeviation;
+declare const numbers_calculateVariance: typeof calculateVariance;
+declare const numbers_clamp: typeof clamp;
+declare const numbers_inRange: typeof inRange;
+declare const numbers_isEven: typeof isEven;
+declare const numbers_isFloat: typeof isFloat;
+declare const numbers_isInt: typeof isInt;
+declare const numbers_isOdd: typeof isOdd;
+declare const numbers_lerp: typeof lerp;
+declare const numbers_percentage: typeof percentage;
+declare const numbers_percentageOf: typeof percentageOf;
+declare const numbers_roundTo: typeof roundTo;
+declare const numbers_sum: typeof sum;
+declare namespace numbers {
+  export {
+    numbers_INT32_MAX as INT32_MAX,
+    numbers_INT32_MIN as INT32_MIN,
+    numbers_INT64_MAX as INT64_MAX,
+    numbers_INT64_MIN as INT64_MIN,
+    numbers_average as average,
+    numbers_bigIntSerializationHelper as bigIntSerializationHelper,
+    numbers_calculateMean as calculateMean,
+    numbers_calculateMedian as calculateMedian,
+    numbers_calculateStandardDeviation as calculateStandardDeviation,
+    numbers_calculateVariance as calculateVariance,
+    numbers_clamp as clamp,
+    numbers_inRange as inRange,
+    numbers_isEven as isEven,
+    numbers_isFloat as isFloat,
+    numbers_isInt as isInt,
+    numbers_isOdd as isOdd,
+    numbers_lerp as lerp,
+    numbers_percentage as percentage,
+    numbers_percentageOf as percentageOf,
+    numbers_roundTo as roundTo,
+    numbers_sum as sum,
+  };
+}
+
+export { INT32_MAX as I, isFloat as a, isEven as b, isOdd as c, clamp as d, percentageOf as e, inRange as f, average as g, INT32_MIN as h, isInt as i, INT64_MAX as j, INT64_MIN as k, lerp as l, calculateMean as m, numbers as n, calculateMedian as o, percentage as p, calculateVariance as q, roundTo as r, sum as s, calculateStandardDeviation as t, bigIntSerializationHelper as u };