qsu 1.6.5 → 1.7.0

package/README.md

@@ -15,13 +15,6 @@
 
 Installing and using the package and defining all the utility methods can be found on the documentation page below: https://qsu.cdget.com/getting-started/installation-javascript
 
-## Family Packages
-
-As a family package of `qsu`, it can be installed and used independently of the `qsu` package.
-
-- **[qsu-fs](https://github.com/jooy2/qsu-fs)**: File listing and management utilities
-- **[qsu-web](https://github.com/jooy2/qsu-web)**: Utilities for website front-end & back-end services
-
 In addition, `qsu` is also available for the Dart language: https://github.com/jooy2/qsu-dart
 
 ## Contributing

package/dist/_types/global.d.ts

@@ -0,0 +1,33 @@
+export type PositiveNumber<N extends number> = number extends N ? N : `${N}` extends `-${string}` ? never : N;
+export type NumberValueObject = {
+    [key: string]: number;
+};
+export type AnyValueObject = {
+    [key: string]: any;
+};
+export type DurationOptions = {
+    useShortString?: boolean;
+    useSpace?: boolean;
+    withZeroValue?: boolean;
+    separator?: string;
+};
+export interface FileInfo {
+    success: boolean;
+    isDirectory: boolean;
+    size: number;
+    sizeHumanized: string;
+    name: string;
+    dirname: string;
+    path: string;
+    ext: string | null;
+    created: number;
+    modified: number;
+}
+export interface LicenseOption {
+    author: string;
+    email?: string;
+    yearStart: string | number;
+    yearEnd?: string;
+    htmlBr?: boolean;
+    type: 'mit' | 'apache20';
+}

package/dist/array/arrCount.d.ts

@@ -0,0 +1,2 @@
+import type { NumberValueObject } from '../_types/global';
+export declare function arrCount(array: string[] | number[]): NumberValueObject;

package/dist/array/arrCount.js

@@ -0,0 +1 @@
+export function arrCount(t){const n={};for(let o=0;o<t.length;o+=1){const r=t[o];n[r]=(n[r]||0)+1}return n}

package/dist/array/arrGroupByMaxCount.d.ts

@@ -0,0 +1 @@
+export declare function arrGroupByMaxCount(array: any[], maxLengthPerGroup?: number): any[];

package/dist/array/arrGroupByMaxCount.js

@@ -0,0 +1 @@
+export function arrGroupByMaxCount(t,n=1){const e=[],r=t.length;let u=[];for(let h=0;h<r;h+=1)u.length===n&&(e.push(u),u=[]),u.push(t[h]);return u.length>0&&e.push(u),e}

package/dist/array/arrMove.d.ts

@@ -0,0 +1,2 @@
+import { PositiveNumber } from '../_types/global';
+export declare function arrMove<N extends number>(array: any[], from: PositiveNumber<N>, to: PositiveNumber<N>): any[];

package/dist/array/arrMove.js

@@ -0,0 +1 @@
+export function arrMove(r,e,n){const o=r.length;if(o<=e||o<=n)throw new Error("Invalid move params");return r.splice(n,0,r.splice(e,1)[0]),r}

package/dist/array/arrRepeat.d.ts

@@ -0,0 +1,2 @@
+import { PositiveNumber } from '../_types/global';
+export declare function arrRepeat<N extends number>(array: any, count: PositiveNumber<N>): any[];

package/dist/array/arrRepeat.js

@@ -0,0 +1 @@
+import{isObject as r}from"../verify/isObject.js";export function arrRepeat(t,e){if(!t||e<1||"object"!=typeof t)return[];const o=r(t),f=[];for(let r=0,p=e;r<p;r+=1)o?f.push(t):f.push(...t);return f}

package/dist/array/arrShuffle.d.ts

@@ -0,0 +1 @@
+export declare function arrShuffle(array: any[]): any[];

package/dist/array/arrShuffle.js

@@ -0,0 +1 @@
+export function arrShuffle(t){if(1===t.length)return t[0];const r=t;for(let n=t.length-1;n>0;n-=1){const o=Math.floor(Math.random()*(n+1));[r[n],r[o]]=[t[o],t[n]]}return r}

package/dist/array/arrTo1dArray.d.ts

@@ -0,0 +1 @@
+export declare function arrTo1dArray(array: any[]): any[];

package/dist/array/arrTo1dArray.js

@@ -0,0 +1 @@
+import{is2dArray as r}from"../verify/is2dArray.js";export function arrTo1dArray(t){const o=t=>{const e=[],n=t.length;for(let s=0;s<n;s+=1)"object"!=typeof t[s]?e.push(t[s]):r(t[s])?e.push(...o(t[s])):e.push(...t[s]);return e};return o(t)}

package/dist/array/arrUnique.d.ts

@@ -0,0 +1 @@
+export declare function arrUnique(array: any[]): any[];

package/dist/array/arrUnique.js

@@ -0,0 +1 @@
+import{is2dArray as r}from"../verify/is2dArray.js";export function arrUnique(e){return r(e)?Array.from(new Set(e.map((r=>JSON.stringify(r)))),(r=>JSON.parse(r))):[...new Set(e)]}

package/dist/array/arrWithDefault.d.ts

@@ -0,0 +1 @@
+export declare function arrWithDefault(defaultValue: any, length?: number): any[];

package/dist/array/arrWithDefault.js

@@ -0,0 +1 @@
+export function arrWithDefault(r,t=0){return t<1?[]:Array(t).fill(r)}

package/dist/array/arrWithNumber.d.ts

@@ -0,0 +1 @@
+export declare function arrWithNumber(start: number, end: number): number[];

package/dist/array/arrWithNumber.js

@@ -0,0 +1 @@
+export function arrWithNumber(r,t){if(r>t)throw new Error("`end` is greater than `start`.");return Array.from({length:t-r+1},((t,e)=>e+r))}

package/dist/array/average.d.ts

@@ -0,0 +1 @@
+export declare function average(array: number[]): number;

package/dist/array/average.js

@@ -0,0 +1 @@
+export function average(e){return e.reduce(((e,r)=>e+r),0)/e.length}

package/dist/array/index.d.ts

@@ -0,0 +1,12 @@
+export { arrCount } from './arrCount.js';
+export { arrGroupByMaxCount } from './arrGroupByMaxCount.js';
+export { arrMove } from './arrMove.js';
+export { arrRepeat } from './arrRepeat.js';
+export { arrShuffle } from './arrShuffle.js';
+export { arrTo1dArray } from './arrTo1dArray.js';
+export { arrUnique } from './arrUnique.js';
+export { arrWithDefault } from './arrWithDefault.js';
+export { arrWithNumber } from './arrWithNumber.js';
+export { average } from './average.js';
+export { sortByObjectKey } from './sortByObjectKey.js';
+export { sortNumeric } from './sortNumeric.js';

package/dist/array/index.js

@@ -0,0 +1 @@
+export{arrCount}from"./arrCount.js";export{arrGroupByMaxCount}from"./arrGroupByMaxCount.js";export{arrMove}from"./arrMove.js";export{arrRepeat}from"./arrRepeat.js";export{arrShuffle}from"./arrShuffle.js";export{arrTo1dArray}from"./arrTo1dArray.js";export{arrUnique}from"./arrUnique.js";export{arrWithDefault}from"./arrWithDefault.js";export{arrWithNumber}from"./arrWithNumber.js";export{average}from"./average.js";export{sortByObjectKey}from"./sortByObjectKey.js";export{sortNumeric}from"./sortNumeric.js";

package/dist/array/sortByObjectKey.d.ts

@@ -0,0 +1 @@
+export declare function sortByObjectKey(array: any[], key: string, descending?: boolean, numerically?: boolean): any[];

package/dist/array/sortByObjectKey.js

@@ -0,0 +1 @@
+export function sortByObjectKey(r,e,t=!1,o=!1){if(o){const o=new Intl.Collator([],{numeric:!0}),n=r.sort(((r,t)=>o.compare(r[e],t[e])));return t?n.reverse():n}return r.sort(((r,o)=>t?r[e]>o[e]?-1:r[e]<o[e]?1:0:r[e]<o[e]?-1:r[e]>o[e]?1:0))}

package/dist/array/sortNumeric.d.ts

@@ -0,0 +1 @@
+export declare function sortNumeric(array: string[], descending?: boolean): string[];

package/dist/array/sortNumeric.js

@@ -0,0 +1 @@
+export function sortNumeric(r,e=!1){const o=new Intl.Collator([],{numeric:!0}),t=r.sort(((r,e)=>o.compare(r,e)));return e?t.reverse():t}

package/dist/date/createDateListFromRange.d.ts

@@ -0,0 +1 @@
+export declare function createDateListFromRange(startDate: Date, endDate: Date): string[];

package/dist/date/createDateListFromRange.js

@@ -0,0 +1 @@
+import{dateToYYYYMMDD as t}from"./dateToYYYYMMDD.js";import{isValidDate as e}from"./isValidDate.js";export function createDateListFromRange(r,a){if(!e(t(r))||!e(t(a)))throw new Error("Either the start date or end date is an invalid date.");if(Math.floor((Date.parse(a.toString())-Date.parse(r.toString()))/864e5)<0)throw new Error("The start date is more recent than the end date.");const o=t(a),n=[];let i=r.getFullYear(),s=r.getMonth()+1,d=r.getDate(),h="";const f=(t,e,r)=>`${t}-${e<10?"0":""}${e}-${r<10?"0":""}${r}`;for(;o!==h;){/[0-9]{4}-12-31/g.test(h)&&(i+=1,s=1,d=1);const t=f(i,s,d);e(t)?(d+=1,n.push(t),h=t):(s+=1,d=1,h=f(i,s,d))}return n}

package/dist/date/dateToYYYYMMDD.d.ts

@@ -0,0 +1 @@
+export declare function dateToYYYYMMDD(date: Date, separator?: string): string;

package/dist/date/dateToYYYYMMDD.js

@@ -0,0 +1 @@
+export function dateToYYYYMMDD(t,e="-"){const $=t.getMonth()+1,n=t.getDate();return`${t.getFullYear()}${e}${$<10?`0${$}`:$}${e}${n<10?`0${n}`:n}`}

package/dist/date/dayDiff.d.ts

@@ -0,0 +1 @@
+export declare function dayDiff(date1: Date, date2?: Date): number;

package/dist/date/dayDiff.js

@@ -0,0 +1 @@
+export function dayDiff(e,t){const a=t||new Date;return Math.ceil(Math.abs(a.getTime()-e.getTime())/864e5)}

package/dist/date/index.d.ts

@@ -0,0 +1,5 @@
+export { createDateListFromRange } from './createDateListFromRange.js';
+export { dateToYYYYMMDD } from './dateToYYYYMMDD.js';
+export { dayDiff } from './dayDiff.js';
+export { isValidDate } from './isValidDate.js';
+export { today } from './today.js';

package/dist/date/index.js

@@ -0,0 +1 @@
+export{createDateListFromRange}from"./createDateListFromRange.js";export{dateToYYYYMMDD}from"./dateToYYYYMMDD.js";export{dayDiff}from"./dayDiff.js";export{isValidDate}from"./isValidDate.js";export{today}from"./today.js";

package/dist/date/isValidDate.d.ts

@@ -0,0 +1 @@
+export declare function isValidDate(dateYYYYMMDD: string): boolean;

package/dist/date/isValidDate.js

@@ -0,0 +1 @@
+export function isValidDate(t){if(!/^[0-9]{4}-[0-9]{2}-[0-9]{2}$/.test(t))throw new Error("The date format must be 'YYYY-MM-DD'");const d=t.split("-");return/^(?=\d)(?:(?:31(?!.(?:0?[2469]|11))|(?:30|29)(?!.0?2)|29(?=.0?2.(?:(?:1[6-9]|[2-9]\d)?(?:0[48]|[2468][048]|[13579][26])|(?:16|[2468][048]|[3579][26])00)(?:\x20|$))|(?:2[0-8]|1\d|0?[1-9]))([-./])(?:1[012]|0?[1-9])\1(?:1[6-9]|[2-9]\d)?\d\d(?:(?=\x20\d)\x20|$))?(((0?[1-9]|1[012])(:[0-5]\d){0,2}(\x20[AP]M))|([01]\d|2[0-3])(:[0-5]\d){1,2})?$/.test(`${parseInt(d[2],10)}-${parseInt(d[1],10)}-${parseInt(d[0],10)}`)}

package/dist/date/today.d.ts

@@ -0,0 +1 @@
+export declare function today(separator?: string, yearFirst?: boolean): string;

package/dist/date/today.js

@@ -0,0 +1 @@
+export function today(t="-",e=!0){const n=new Date,o=n.getMonth()+1,r=n.getDate(),g=[`${o<10?"0":""}${o}`,`${r<10?"0":""}${r}`];return e?g.unshift(n.getFullYear().toString()):g.push(n.getFullYear().toString()),g.join(t)}

package/dist/encrypt/decodeBase64.d.ts

@@ -0,0 +1 @@
+export declare function decodeBase64(encodedStr: string): string;

package/dist/encrypt/decodeBase64.js

@@ -0,0 +1 @@
+export function decodeBase64(e){return Buffer.from(e,"base64").toString("utf8")}

package/dist/encrypt/decrypt.d.ts

@@ -0,0 +1 @@
+export declare function decrypt(str: string, secret: string, algorithm?: string, toBase64?: boolean): string;

package/dist/encrypt/decrypt.js

@@ -0,0 +1 @@
+import{createDecipheriv as t}from"crypto";export function decrypt(r,e,f="aes-256-cbc",o=!1){if(!r||r.length<1)return"";const n=o?"base64":"hex",c=r.split(":"),i=t(f,e,Buffer.from(c.shift(),n));let u=i.update(Buffer.from(c.join(":"),n));return u=Buffer.concat([u,i.final()]),u.toString()}

package/dist/encrypt/encodeBase64.d.ts

@@ -0,0 +1 @@
+export declare function encodeBase64(str: string): string;

package/dist/encrypt/encodeBase64.js

@@ -0,0 +1 @@
+export function encodeBase64(e){return Buffer.from(e,"utf8").toString("base64")}

package/dist/encrypt/encrypt.d.ts

@@ -0,0 +1 @@
+export declare function encrypt(str: string, secret: string, algorithm?: string, ivSize?: number, toBase64?: boolean): string;

package/dist/encrypt/encrypt.js

@@ -0,0 +1 @@
+import{createCipheriv as t,randomBytes as n}from"crypto";export function encrypt(r,e,o="aes-256-cbc",c=16,f=!1){if(!r||r.length<1)return"";const i=n(c),a=t(o,e,i);let p=a.update(r);p=Buffer.concat([p,a.final()]);const u=f?"base64":"hex";return`${i.toString(u)}:${p.toString(u)}`}

package/dist/encrypt/index.d.ts

@@ -0,0 +1,9 @@
+export { decodeBase64 } from './decodeBase64.js';
+export { decrypt } from './decrypt.js';
+export { encodeBase64 } from './encodeBase64.js';
+export { encrypt } from './encrypt.js';
+export { md5Hash } from './md5Hash.js';
+export { objectId } from './objectId.js';
+export { sha1Hash } from './sha1Hash.js';
+export { sha256Hash } from './sha256Hash.js';
+export { strToNumberHash } from './strToNumberHash.js';

package/dist/encrypt/index.js

@@ -0,0 +1 @@
+export{decodeBase64}from"./decodeBase64.js";export{decrypt}from"./decrypt.js";export{encodeBase64}from"./encodeBase64.js";export{encrypt}from"./encrypt.js";export{md5Hash}from"./md5Hash.js";export{objectId}from"./objectId.js";export{sha1Hash}from"./sha1Hash.js";export{sha256Hash}from"./sha256Hash.js";export{strToNumberHash}from"./strToNumberHash.js";

package/dist/encrypt/md5Hash.d.ts

@@ -0,0 +1 @@
+export declare function md5Hash(str: string): string;

package/dist/encrypt/md5Hash.js

@@ -0,0 +1 @@
+import{createHash as t}from"crypto";export function md5Hash(r){return t("md5").update(r).digest("hex")}

package/dist/encrypt/objectId.d.ts

@@ -0,0 +1 @@
+export declare function objectId(): string;

package/dist/encrypt/objectId.js

@@ -0,0 +1 @@
+export function objectId(){return Math.floor(Date.now()/1e3).toString(16)+"x".repeat(16).replace(/x/g,(()=>Math.floor(16*Math.random()).toString(16)))}

package/dist/encrypt/sha1Hash.d.ts

@@ -0,0 +1 @@
+export declare function sha1Hash(str: string): string;

package/dist/encrypt/sha1Hash.js

@@ -0,0 +1 @@
+import{createHash as t}from"crypto";export function sha1Hash(r){return t("sha1").update(r).digest("hex")}

package/dist/encrypt/sha256Hash.d.ts

@@ -0,0 +1 @@
+export declare function sha256Hash(str: string): string;

package/dist/encrypt/sha256Hash.js

@@ -0,0 +1 @@
+import{createHash as t}from"crypto";export function sha256Hash(r){return t("sha256").update(r).digest("hex")}

package/dist/encrypt/strToNumberHash.d.ts

@@ -0,0 +1 @@
+export declare function strToNumberHash(str: string): number;

package/dist/encrypt/strToNumberHash.js

@@ -0,0 +1 @@
+export function strToNumberHash(r){if(!r)return 0;let t=0;for(let e=0;e<r.length;e+=1)t=(t<<5)-t+r.charCodeAt(e),t|=0;return t}

package/dist/file/createDirectory.d.ts

@@ -0,0 +1 @@
+export declare function createDirectory(filePath: string, recursive?: boolean): Promise<void>;

package/dist/file/createDirectory.js

@@ -0,0 +1 @@
+import{mkdir as r}from"fs/promises";import{isFileExists as i}from"./isFileExists.js";export async function createDirectory(t,e=!0){try{await i(t)||await r(t,{recursive:e})}catch(r){if(r instanceof Error)throw new Error(r.message)}}

package/dist/file/createFile.d.ts

@@ -0,0 +1 @@
+export declare function createFile(filePath: string): Promise<void>;

package/dist/file/createFile.js

@@ -0,0 +1 @@
+import{open as t,utimes as a}from"fs/promises";export async function createFile(e){if(!e)return;const c=new Date;try{await a(e,c,c)}catch(a){const c=await t(e,"a");await c.close()}}

package/dist/file/createFileWithDummy.d.ts

@@ -0,0 +1 @@
+export declare function createFileWithDummy(filePath: string, size: number): Promise<boolean>;

package/dist/file/createFileWithDummy.js

@@ -0,0 +1 @@
+import{open as r}from"fs/promises";import{createFile as t}from"./createFile.js";export async function createFileWithDummy(e,i){if(!i||i<0)throw new Error("Size is required");try{if(0===i)return await t(e),!0;const a=await r(e,"w");return await a.write(Buffer.alloc(1),0,1,i-1),await a.close(),!0}catch(r){return!1}}

package/dist/file/deleteAllFileFromDirectory.d.ts

@@ -0,0 +1 @@
+export declare function deleteAllFileFromDirectory(directoryPath: string): Promise<void>;

package/dist/file/deleteAllFileFromDirectory.js

@@ -0,0 +1 @@
+import{readdir as t}from"fs/promises";import{join as e}from"path";import{deleteFile as o}from"./deleteFile.js";export async function deleteAllFileFromDirectory(r){let i=[];try{i=await t(r)}catch{}const l=i.length;for(let t=0;t<l;t+=1)await o(e(r,i[t]))}

package/dist/file/deleteFile.d.ts

@@ -0,0 +1 @@
+export declare function deleteFile(filePath: string): Promise<void>;

package/dist/file/deleteFile.js

@@ -0,0 +1 @@
+import{rm as e}from"fs/promises";export async function deleteFile(r){if(r)try{await e(r,{recursive:!0,force:!0})}catch{}}

package/dist/file/getFileExtension.d.ts

@@ -0,0 +1 @@
+export declare function getFileExtension(filePath: string, isWindows?: boolean): string | null;

package/dist/file/getFileExtension.js

@@ -0,0 +1 @@
+import{extname as t}from"path";export function getFileExtension(l,e){let n=l.split(e?"\\":"/").pop();return n?(n=t(n)||n,-1===n.indexOf(".")?null:n.split(".")?.pop()?.toLowerCase()||null):null}

package/dist/file/getFileHash.d.ts

@@ -0,0 +1 @@
+export declare function getFileHash(filePath: string, algorithm?: 'md5' | 'sha1' | 'sha256' | 'sha512'): Promise<string>;

package/dist/file/getFileHash.js

@@ -0,0 +1 @@
+import{createHash as r}from"crypto";import{createReadStream as o}from"fs";export async function getFileHash(e,n="md5"){return new Promise(((t,i)=>{if(!e)return void i(new Error("Invalid path"));const a=r(n),d=o(e);d.on("error",(r=>{i(r)})),d.on("data",(r=>{a.update(r)})),d.on("end",(()=>{t(a.digest("hex"))}))}))}

package/dist/file/getFileInfo.d.ts

@@ -0,0 +1,2 @@
+import { FileInfo } from '../_types/global';
+export declare function getFileInfo(filePath: string): Promise<FileInfo>;

package/dist/file/getFileInfo.js

@@ -0,0 +1 @@
+import{stat as e}from"fs/promises";import{dirname as i,resolve as t}from"path";import{getFileExtension as r}from"./getFileExtension.js";import{getFileSize as s}from"./getFileSize.js";import{getFileName as o}from"./getFileName.js";export async function getFileInfo(m){const n=e=>Math.floor(new Date(e).getTime()/1e3);try{const a=await e(m);return{success:!0,isDirectory:a.isDirectory(),ext:r(m),size:a.size,sizeHumanized:s(a.size),name:o(m),dirname:i(m),path:t(m),created:n(a.ctime),modified:n(a.mtime)}}catch(e){if(e instanceof Error)throw new Error(e.message)}return{success:!1,isDirectory:!1,ext:null,size:0,sizeHumanized:"0 Bytes",name:"unknown",dirname:i(m),path:m,created:-1,modified:-1}}

package/dist/file/getFileName.d.ts

@@ -0,0 +1 @@
+export declare function getFileName(filePath: string, withExtension?: boolean): string;

package/dist/file/getFileName.js

@@ -0,0 +1 @@
+import{basename as e,extname as n,win32 as a}from"path";export function getFileName(t,i=!1){return t?-1===t.indexOf("/")&&-1!==t.indexOf("\\")?i?a.basename(t):a.basename(t,n(t)):i?e(t):e(t,n(t)):""}

package/dist/file/getFilePathLevel.d.ts

@@ -0,0 +1 @@
+export declare function getFilePathLevel(filePath: string): number;

package/dist/file/getFilePathLevel.js

@@ -0,0 +1 @@
+import{posix as t}from"path";import{toPosixFilePath as e}from"./toPosixFilePath.js";export function getFilePathLevel(o){return o?"/"===o?1:e(o.replace(/\\+$/,"")).split(t.sep).length:-1}

package/dist/file/getFileSize.d.ts

@@ -0,0 +1,2 @@
+import type { PositiveNumber } from '../_types/global';
+export declare function getFileSize<N extends number>(bytes: PositiveNumber<N>, decimals?: number): string;

package/dist/file/getFileSize.js

@@ -0,0 +1 @@
+export function getFileSize(t,o=2){const e=["Bytes","KB","MB","GB","TB","PB","EB","ZB","YB"];if(t<1)return`0 ${e[0]}`;const B=Math.floor(Math.log(t)/Math.log(1024));return`${parseFloat((t/1024**B).toFixed(o<0?0:o))} ${e[B]}`}

package/dist/file/getParentFilePath.d.ts

@@ -0,0 +1 @@
+export declare function getParentFilePath(filePath: string, isWindows?: boolean): string;

package/dist/file/getParentFilePath.js

@@ -0,0 +1 @@
+import{toValidFilePath as t}from"./toValidFilePath.js";export function getParentFilePath(e,o){const i=e.split(o?"\\":"/");let n;return i.pop(),n=1===i.length?o?"C:\\":"/":i.join(o?"\\":"/"),t(n,o)}

package/dist/file/headFile.d.ts

@@ -0,0 +1 @@
+export declare function headFile(filePath: string, length?: number): Promise<string | null>;

package/dist/file/headFile.js

@@ -0,0 +1 @@
+import{readFile as r}from"fs/promises";export async function headFile(t,n=1){try{const e=(await r(t,"utf-8")).split("\n");let o="";for(let r=0,t=n;r<t;r+=1)o+=`${e[r]}${n<2||r===t-1?"":"\n"}`;return o.length<1?null:o}catch(r){if(r instanceof Error)throw new Error(r.message)}return null}

package/dist/file/index.d.ts

@@ -0,0 +1,22 @@
+export { createDirectory } from './createDirectory.js';
+export { createFile } from './createFile.js';
+export { createFileWithDummy } from './createFileWithDummy.js';
+export { deleteAllFileFromDirectory } from './deleteAllFileFromDirectory.js';
+export { deleteFile } from './deleteFile.js';
+export { getFileExtension } from './getFileExtension.js';
+export { getFileHash } from './getFileHash.js';
+export { getFileInfo } from './getFileInfo.js';
+export { getFileName } from './getFileName.js';
+export { getFilePathLevel } from './getFilePathLevel.js';
+export { getFileSize } from './getFileSize.js';
+export { getParentFilePath } from './getParentFilePath.js';
+export { headFile } from './headFile.js';
+export { isFileExists } from './isFileExists.js';
+export { isFileHidden } from './isFileHidden.js';
+export { isValidFileName } from './isValidFileName.js';
+export { joinFilePath } from './joinFilePath.js';
+export { moveFile } from './moveFile.js';
+export { normalizeFile } from './normalizeFile.js';
+export { tailFile } from './tailFile.js';
+export { toPosixFilePath } from './toPosixFilePath.js';
+export { toValidFilePath } from './toValidFilePath.js';

package/dist/file/index.js

@@ -0,0 +1 @@
+export{createDirectory}from"./createDirectory.js";export{createFile}from"./createFile.js";export{createFileWithDummy}from"./createFileWithDummy.js";export{deleteAllFileFromDirectory}from"./deleteAllFileFromDirectory.js";export{deleteFile}from"./deleteFile.js";export{getFileExtension}from"./getFileExtension.js";export{getFileHash}from"./getFileHash.js";export{getFileInfo}from"./getFileInfo.js";export{getFileName}from"./getFileName.js";export{getFilePathLevel}from"./getFilePathLevel.js";export{getFileSize}from"./getFileSize.js";export{getParentFilePath}from"./getParentFilePath.js";export{headFile}from"./headFile.js";export{isFileExists}from"./isFileExists.js";export{isFileHidden}from"./isFileHidden.js";export{isValidFileName}from"./isValidFileName.js";export{joinFilePath}from"./joinFilePath.js";export{moveFile}from"./moveFile.js";export{normalizeFile}from"./normalizeFile.js";export{tailFile}from"./tailFile.js";export{toPosixFilePath}from"./toPosixFilePath.js";export{toValidFilePath}from"./toValidFilePath.js";

package/dist/file/isFileExists.d.ts

@@ -0,0 +1 @@
+export declare function isFileExists(filePath: string): Promise<boolean>;

package/dist/file/isFileExists.js

@@ -0,0 +1 @@
+import{access as r}from"fs/promises";import{constants as t}from"fs";export async function isFileExists(i){try{return await r(i,t.F_OK),!0}catch(r){return!1}}

package/dist/file/isFileHidden.d.ts

@@ -0,0 +1 @@
+export declare function isFileHidden(filePath: string, isWindows?: boolean): Promise<boolean>;

package/dist/file/isFileHidden.js

@@ -0,0 +1 @@
+import{exec as e}from"child_process";export function isFileHidden(i,r=!1){return new Promise((t=>{r?e(`attrib "${i}"`,((e,r,o)=>{t(!(e||o||!r)&&r.replace(i,"").includes("H"))})):t(/(^|\/)\.[^/.]/.test(i.split("/")?.pop()||"/"))}))}

package/dist/file/isValidFileName.d.ts

@@ -0,0 +1 @@
+export declare function isValidFileName(filePath: string, unixType?: boolean): boolean;

package/dist/file/isValidFileName.js

@@ -0,0 +1 @@
+import{getFileName as e}from"./getFileName.js";export function isValidFileName(t,i){let s;const l=e(t);return s=i?/(^\s+$)|(^\.+$)|([:/]+)/:/(^\s+$)|(^\.+$)|([<>:"/\\|?*]+)/,!s.test(l)&&l.length<=255}

package/dist/file/joinFilePath.d.ts

@@ -0,0 +1 @@
+export declare function joinFilePath(isWindows: boolean, ...paths: string[]): string;

package/dist/file/joinFilePath.js

@@ -0,0 +1 @@
+import{posix as o,win32 as i}from"path";import{toValidFilePath as t}from"./toValidFilePath.js";export function joinFilePath(r,...n){return r?t(i.join(...n),!0):t(o.join(...n),!1)}

package/dist/file/moveFile.d.ts

@@ -0,0 +1 @@
+export declare function moveFile(filePath: string, targetFilePath: string): Promise<void>;

package/dist/file/moveFile.js

@@ -0,0 +1 @@
+import{rename as o}from"fs/promises";export async function moveFile(i,e){i&&e&&await o(i,e)}

package/dist/file/normalizeFile.d.ts

@@ -0,0 +1 @@
+export declare function normalizeFile(filePath: string, normalizationForm?: 'NFD' | 'NFC' | 'NFKC' | 'NFKD' | undefined): string;

package/dist/file/normalizeFile.js

@@ -0,0 +1 @@
+export function normalizeFile(e,n){return!e||e.length<1?"":e.normalize(n)}

package/dist/file/tailFile.d.ts

@@ -0,0 +1 @@
+export declare function tailFile(filePath: string, length?: number): Promise<string | null>;

package/dist/file/tailFile.js

@@ -0,0 +1 @@
+import{readFile as t}from"fs/promises";export async function tailFile(n,e=1){try{const r=(await t(n,"utf-8")).split("\n");let l="";r[r.length-1].length<1&&r.pop();for(let t=r.length,n=r.length-e;t>n;t-=1)l=`${r[t-1]}${l.length<1||t-1===n?"":"\n"}${l}`;return l.length<1?null:l}catch(t){if(t instanceof Error)throw new Error(t.message)}return null}

package/dist/file/toPosixFilePath.d.ts

@@ -0,0 +1 @@
+export declare function toPosixFilePath(filePath: string): string;

package/dist/file/toPosixFilePath.js

@@ -0,0 +1 @@
+export function toPosixFilePath(e){return e.replace(/^\\\\\?\\/,"").replace(/\\/g,"/").replace(/\/\/+/g,"/")}

package/dist/file/toValidFilePath.d.ts

@@ -0,0 +1 @@
+export declare function toValidFilePath(filePath: string, isWindows?: boolean): string;

package/dist/file/toValidFilePath.js

@@ -0,0 +1 @@
+export function toValidFilePath(e,t){if(t){let t=e;return t.length>2&&!/^[a-zA-Z]:/.test(t)&&(t=`\\${t}`),(t.match(/\\/g)||[]).length>1&&/\\$/.test(t)&&(t=t.replace(/\\$/,"")),/^[a-zA-Z]:$/.test(t)&&(t=`${t}\\`),t.replace(/\\{2,}/g,"\\")}let l=e;return/^\//.test(l)||(l=`/${l}`),l=l.replace(/\/{2,}/g,"/"),l.length>1&&(l=l.replace(/\/$/,"")),l}

package/dist/format/duration.d.ts

@@ -0,0 +1,2 @@
+import type { DurationOptions } from '../_types/global';
+export declare function duration(milliseconds: number, options?: DurationOptions): string;

package/dist/format/duration.js

@@ -0,0 +1 @@
+export function duration(e,r){const{useShortString:t=!1,useSpace:i=!0,withZeroValue:n=!1,separator:o=" "}={...r},d=[{name:"Millisecond",short:"ms",divider:1e3},{name:"Second",short:"S",divider:60},{name:"Minute",short:"M",divider:60},{name:"Hour",short:"H",divider:24},{name:"Day",short:"D",divider:31}],s=[];let a=e;for(let e=0;e<d.length;e+=1){const r=d[e];let o=a%r.divider;e===d.length-1?o=Math.trunc(a):a=(a-o)/r.divider,(n||!n&&0!==o)&&s.push(`${o}${i?" ":""}${t?r.short:`${r.name}${o<2?"":"s"}`}`)}return s.reverse().join(o)}

package/dist/format/index.d.ts

@@ -0,0 +1,4 @@
+export { duration } from './duration.js';
+export { numberFormat } from './numberFormat.js';
+export { safeJSONParse } from './safeJSONParse.js';
+export { safeParseInt } from './safeParseInt.js';

package/dist/format/index.js

@@ -0,0 +1 @@
+export{duration}from"./duration.js";export{numberFormat}from"./numberFormat.js";export{safeJSONParse}from"./safeJSONParse.js";export{safeParseInt}from"./safeParseInt.js";

package/dist/format/numberFormat.d.ts

@@ -0,0 +1 @@
+export declare function numberFormat(number: number | string): string;

package/dist/format/numberFormat.js

@@ -0,0 +1 @@
+export function numberFormat(r){return new Intl.NumberFormat("en-US",{roundingPriority:"morePrecision"}).format(r)}

package/dist/format/safeJSONParse.d.ts

@@ -0,0 +1,2 @@
+import type { AnyValueObject } from '../_types/global';
+export declare function safeJSONParse(jsonString: any, fallback?: {}): AnyValueObject;

package/dist/format/safeJSONParse.js

@@ -0,0 +1 @@
+export function safeJSONParse(r,t={}){if(!r)return t;if(Array.isArray(r)||"object"==typeof r)try{return JSON.parse(JSON.stringify(r))}catch(r){return t}try{return JSON.parse(r)}catch(r){return t}}

package/dist/format/safeParseInt.d.ts

@@ -0,0 +1 @@
+export declare function safeParseInt(value: any, fallback?: number, radix?: number): number;

package/dist/format/safeParseInt.js

@@ -0,0 +1 @@
+export function safeParseInt(t,r=0,n=10){if(!t||t.toString().length<1)return r;try{return parseInt(t.toString().split(".")[0],n)}catch(t){return r}}

package/dist/index.d.ts

@@ -1,9 +1,11 @@
-export * from './array.js';
-export * from './encrypt.js';
-export * from './date.js';
-export * from './format.js';
-export * from './math.js';
-export * from './misc.js';
-export * from './object.js';
-export * from './string.js';
-export * from './verify.js';
+export * from './array/index.js';
+export * from './encrypt/index.js';
+export * from './date/index.js';
+export * from './file/index.js';
+export * from './format/index.js';
+export * from './math/index.js';
+export * from './misc/index.js';
+export * from './object/index.js';
+export * from './string/index.js';
+export * from './verify/index.js';
+export * from './web/index.js';

package/dist/index.js

@@ -1 +1 @@
-export*from"./array.js";export*from"./encrypt.js";export*from"./date.js";export*from"./format.js";export*from"./math.js";export*from"./misc.js";export*from"./object.js";export*from"./string.js";export*from"./verify.js";
+export*from"./array/index.js";export*from"./encrypt/index.js";export*from"./date/index.js";export*from"./file/index.js";export*from"./format/index.js";export*from"./math/index.js";export*from"./misc/index.js";export*from"./object/index.js";export*from"./string/index.js";export*from"./verify/index.js";export*from"./web/index.js";

package/dist/math/div.d.ts

@@ -0,0 +1,2 @@
+export declare function div(...args: any[]): number;
+export declare function div(...args: Array<number>): number;

package/dist/math/div.js

@@ -0,0 +1 @@
+export function div(...t){const e=t.length>0&&"object"==typeof t[0]?t[0]:t;let n=e[0];for(let t=1,o=e.length;t<o;t+=1)"number"==typeof e[t]&&(n/=e[t]);return n}

package/dist/math/index.d.ts

@@ -0,0 +1,5 @@
+export { div } from './div.js';
+export { mul } from './mul.js';
+export { numRandom } from './numRandom.js';
+export { sub } from './sub.js';
+export { sum } from './sum.js';

package/dist/math/index.js

@@ -0,0 +1 @@
+export{div}from"./div.js";export{mul}from"./mul.js";export{numRandom}from"./numRandom.js";export{sub}from"./sub.js";export{sum}from"./sum.js";

package/dist/math/mul.d.ts

@@ -0,0 +1,2 @@
+export declare function mul(...args: any[]): number;
+export declare function mul(...args: Array<number>): number;

package/dist/math/mul.js

@@ -0,0 +1 @@
+export function mul(...t){const e=t.length>0&&"object"==typeof t[0]?t[0]:t;let n=e[0];for(let t=1,o=e.length;t<o;t+=1)"number"==typeof e[t]&&(n*=e[t]);return n}

package/dist/math/numRandom.d.ts

@@ -0,0 +1 @@
+export declare function numRandom(min: number, max: number): number;

package/dist/math/numRandom.js

@@ -0,0 +1 @@
+export function numRandom(n,o){if(!n&&!o)return Math.random()>.5?1:0;const r=o||n,t=!o||n>=o?null:n;return Math.floor(Math.random()*(t?r-t+1:r+1))+(t||0)}

package/dist/math/sub.d.ts

@@ -0,0 +1,2 @@
+export declare function sub(...args: any[]): number;
+export declare function sub(...args: Array<number>): number;

package/dist/math/sub.js

@@ -0,0 +1 @@
+export function sub(...t){const e=t.length>0&&"object"==typeof t[0]?t[0]:t;let n=e[0];for(let t=1,o=e.length;t<o;t+=1)"number"==typeof e[t]&&(n-=e[t]);return n}

package/dist/math/sum.d.ts

@@ -0,0 +1,2 @@
+export declare function sum(...args: any[]): number;
+export declare function sum(...args: Array<number>): number;