tiny-essentials 1.12.1 → 1.12.2

package/dist/v1/{basics/fileManager.mjs → fileManager/normalFuncs.mjs}

@@ -1,6 +1,6 @@
-import fs from 'fs';
-import path from 'path';
-import { toTitleCase } from './text.mjs';
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, lstatSync, rmSync, unlinkSync, copyFileSync, statSync, renameSync, } from 'fs';
+import { join, dirname, basename, extname } from 'path';
+import { toTitleCase } from '../basics/text.mjs';
 /*========================*
  * JSON Operations
  *========================*/
@@ -11,9 +11,9 @@ import { toTitleCase } from './text.mjs';
  * @returns {any}
  */
 export function readJsonFile(filePath) {
-    if (!fs.existsSync(filePath))
+    if (!existsSync(filePath))
         throw new Error(`File not found: ${filePath}`);
-    const content = fs.readFileSync(filePath, 'utf-8');
+    const content = readFileSync(filePath, 'utf-8');
     return JSON.parse(content);
 }
 /**
@@ -25,31 +25,7 @@ export function readJsonFile(filePath) {
  */
 export function writeJsonFile(filePath, data, spaces = 2) {
     const json = JSON.stringify(data, null, spaces);
-    fs.writeFileSync(filePath, json, 'utf-8');
-}
-/**
- * Reads and parses a JSON file.
- * Throws an error if the file content is not valid JSON.
- * @param {string} filePath
- * @returns {Promise<any>}
- */
-export async function readJsonFileAsync(filePath) {
-    if (!fs.existsSync(filePath))
-        throw new Error(`File not found: ${filePath}`);
-    const content = await fs.promises.readFile(filePath, 'utf-8');
-    return JSON.parse(content);
-}
-/**
- * Saves an object as JSON to a file.
- * Automatically creates the directory if it does not exist.
- * @param {string} filePath
- * @param {any} data
- * @param {number} [spaces=2]
- * @returns {Promise<void>}
- */
-export function writeJsonFileAsync(filePath, data, spaces = 2) {
-    const json = JSON.stringify(data, null, spaces);
-    return fs.promises.writeFile(filePath, json, 'utf-8');
+    writeFileSync(filePath, json, 'utf-8');
 }
 /*========================*
  * Directory Management
@@ -59,8 +35,8 @@ export function writeJsonFileAsync(filePath, data, spaces = 2) {
  * @param {string} dirPath
  */
 export function ensureDirectory(dirPath) {
-    if (!fs.existsSync(dirPath)) {
-        fs.mkdirSync(dirPath, { recursive: true });
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
     }
 }
 /**
@@ -68,17 +44,17 @@ export function ensureDirectory(dirPath) {
  * @param {string} dirPath
  */
 export function clearDirectory(dirPath) {
-    if (!fs.existsSync(dirPath))
+    if (!existsSync(dirPath))
         return;
-    const files = fs.readdirSync(dirPath);
+    const files = readdirSync(dirPath);
     for (const file of files) {
-        const fullPath = path.join(dirPath, file);
-        const stat = fs.lstatSync(fullPath);
-        if (stat.isDirectory()) {
-            fs.rmSync(fullPath, { recursive: true, force: true });
+        const fullPath = join(dirPath, file);
+        const statData = lstatSync(fullPath);
+        if (statData.isDirectory()) {
+            rmSync(fullPath, { recursive: true, force: true });
         }
         else {
-            fs.unlinkSync(fullPath);
+            unlinkSync(fullPath);
         }
     }
 }
@@ -91,7 +67,7 @@ export function clearDirectory(dirPath) {
  * @returns {boolean}
  */
 export function fileExists(filePath) {
-    return fs.existsSync(filePath) && fs.lstatSync(filePath).isFile();
+    return existsSync(filePath) && lstatSync(filePath).isFile();
 }
 /**
  * Checks whether a directory exists.
@@ -99,7 +75,7 @@ export function fileExists(filePath) {
  * @returns {boolean}
  */
 export function dirExists(dirPath) {
-    return fs.existsSync(dirPath) && fs.lstatSync(dirPath).isDirectory();
+    return existsSync(dirPath) && lstatSync(dirPath).isDirectory();
 }
 /**
  * Checks whether a directory is empty.
@@ -107,7 +83,7 @@ export function dirExists(dirPath) {
  * @returns {boolean}
  */
 export function isDirEmpty(dirPath) {
-    return fs.existsSync(dirPath) && fs.readdirSync(dirPath).length === 0;
+    return readdirSync(dirPath).length === 0;
 }
 /*========================*
  * File Operations
@@ -119,8 +95,8 @@ export function isDirEmpty(dirPath) {
  * @param {number} [mode]
  */
 export function ensureCopyFile(src, dest, mode) {
-    ensureDirectory(path.dirname(dest));
-    fs.copyFileSync(src, dest, mode);
+    ensureDirectory(dirname(dest));
+    copyFileSync(src, dest, mode);
 }
 /**
  * Deletes a file (If the file exists).
@@ -129,30 +105,7 @@ export function ensureCopyFile(src, dest, mode) {
  */
 export function tryDeleteFile(filePath) {
     if (fileExists(filePath)) {
-        fs.unlinkSync(filePath);
-        return true;
-    }
-    return false;
-}
-/**
- * Copies a file to a destination.
- * @param {string} src
- * @param {string} dest
- * @param {number} [mode]
- * @returns {Promise<void>}
- */
-export function ensureCopyFileAsync(src, dest, mode) {
-    ensureDirectory(path.dirname(dest));
-    return fs.promises.copyFile(src, dest, mode);
-}
-/**
- * Deletes a file (If the file exists).
- * @param {string} filePath
- * @returns {Promise<boolean>}
- */
-export async function tryDeleteFileAsync(filePath) {
-    if (fileExists(filePath)) {
-        await fs.promises.unlink(filePath);
+        unlinkSync(filePath);
         return true;
     }
     return false;
@@ -164,24 +117,12 @@ export async function tryDeleteFileAsync(filePath) {
  * Writes text to a file (Ensures that the directory exists, creating it recursively if needed).
  * @param {string} filePath
  * @param {string} content
- * @param {fs.WriteFileOptions} [ops='utf-8']
+ * @param {import('fs').WriteFileOptions} [ops='utf-8']
  */
 export function writeTextFile(filePath, content, ops = 'utf-8') {
-    const dir = path.dirname(filePath);
-    ensureDirectory(dir);
-    fs.writeFileSync(filePath, content, ops);
-}
-/**
- * Writes text to a file (Ensures that the directory exists, creating it recursively if needed).
- * @param {string} filePath
- * @param {string} content
- * @param {fs.WriteFileOptions} [ops='utf-8']
- * @returns {Promise<void>}
- */
-export function writeTextFileAsync(filePath, content, ops = 'utf-8') {
-    const dir = path.dirname(filePath);
+    const dir = dirname(filePath);
     ensureDirectory(dir);
-    return fs.promises.writeFile(filePath, content, ops);
+    writeFileSync(filePath, content, ops);
 }
 /*========================*
  * Directory Listings
@@ -197,11 +138,11 @@ export function listFiles(dirPath, recursive = false) {
     const results = { files: [], dirs: [] };
     if (!dirExists(dirPath))
         return results;
-    const entries = fs.readdirSync(dirPath);
+    const entries = readdirSync(dirPath);
     for (const entry of entries) {
-        const fullPath = path.join(dirPath, entry);
-        const stat = fs.lstatSync(fullPath);
-        if (stat.isDirectory()) {
+        const fullPath = join(dirPath, entry);
+        const statData = lstatSync(fullPath);
+        if (statData.isDirectory()) {
             results.dirs.push(fullPath);
             if (recursive) {
                 const results2 = listFiles(fullPath, true);
@@ -226,11 +167,11 @@ export function listDirs(dirPath, recursive = false) {
     const results = [];
     if (!dirExists(dirPath))
         return results;
-    const entries = fs.readdirSync(dirPath);
+    const entries = readdirSync(dirPath);
     for (const entry of entries) {
-        const fullPath = path.join(dirPath, entry);
-        const stat = fs.lstatSync(fullPath);
-        if (stat.isDirectory()) {
+        const fullPath = join(dirPath, entry);
+        const statData = lstatSync(fullPath);
+        if (statData.isDirectory()) {
             results.push(fullPath);
             if (recursive) {
                 results.push(...listDirs(fullPath, true));
@@ -250,7 +191,7 @@ export function listDirs(dirPath, recursive = false) {
 export function fileSize(filePath) {
     if (!fileExists(filePath))
         return 0;
-    const stats = fs.statSync(filePath);
+    const stats = statSync(filePath);
     return stats.size;
 }
 /**
@@ -288,16 +229,15 @@ export function backupFile(filePath, ext = 'bak') {
  * @returns {string} Full path to the most recent backup
  */
 export function getLatestBackupPath(filePath, ext = 'bak') {
-    const dir = path.dirname(filePath);
-    const baseName = path.basename(filePath);
-    const backups = fs
-        .readdirSync(dir)
+    const dir = dirname(filePath);
+    const baseName = basename(filePath);
+    const backups = readdirSync(dir)
         .filter((name) => name.startsWith(`${baseName}.${ext}.`))
         .sort()
         .reverse();
     if (backups.length === 0)
         throw new Error(`No backups found for ${filePath}`);
-    return path.join(dir, backups[0]);
+    return join(dir, backups[0]);
 }
 /**
  * Restores the most recent backup of a file.
@@ -308,29 +248,6 @@ export function restoreLatestBackup(filePath, ext = 'bak') {
     const latestBackup = getLatestBackupPath(filePath, ext);
     ensureCopyFile(latestBackup, filePath);
 }
-/**
- * Restores the most recent backup of a file.
- * @param {string} filePath
- * @param {string} [ext='bak']
- * @returns {Promise<void>}
- */
-export function restoreLatestBackupAsync(filePath, ext = 'bak') {
-    const latestBackup = getLatestBackupPath(filePath, ext);
-    return ensureCopyFileAsync(latestBackup, filePath);
-}
-/**
- * Creates a backup copy of a file with .bak timestamp suffix.
- * @param {string} filePath
- * @param {string} [ext='bak']
- * @returns {Promise<void>}
- */
-export async function backupFileAsync(filePath, ext = 'bak') {
-    if (!fileExists(filePath))
-        return;
-    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-    const backupPath = `${filePath}.${ext}.${timestamp}`;
-    return ensureCopyFileAsync(filePath, backupPath);
-}
 /*========================*
  * Rename Utilities
  *========================*/
@@ -351,7 +268,7 @@ export function renameFileBatch(dirPath, renameFn, extensions = []) {
         throw new TypeError('renameFn must be a function');
     if (!Array.isArray(extensions))
         throw new TypeError('extensions must be an array of strings');
-    if (!fs.existsSync(dirPath) || !fs.statSync(dirPath).isDirectory())
+    if (!existsSync(dirPath) || !statSync(dirPath).isDirectory())
         throw new Error(`Directory not found or invalid: ${dirPath}`);
     for (const ext of extensions) {
         if (typeof ext !== 'string' || !ext.startsWith('.'))
@@ -360,15 +277,15 @@ export function renameFileBatch(dirPath, renameFn, extensions = []) {
     const files = listFiles(dirPath).files;
     let index = 0;
     for (const file of files) {
-        const ext = path.extname(file);
+        const ext = extname(file);
         if (extensions.length && !extensions.includes(ext))
             continue;
-        const originalName = path.basename(file);
+        const originalName = basename(file);
         const newName = renameFn(originalName, index++);
-        const newPath = path.join(dirPath, newName);
+        const newPath = join(dirPath, newName);
         if (originalName === newName)
             continue;
-        fs.renameSync(file, newPath);
+        renameSync(file, newPath);
     }
 }
 /**
@@ -380,8 +297,8 @@ export function renameFileBatch(dirPath, renameFn, extensions = []) {
  */
 export function renameFileRegex(dirPath, pattern, replacement, extensions = []) {
     renameFileBatch(dirPath, (filename) => {
-        const ext = path.extname(filename);
-        const name = path.basename(filename, ext).replace(pattern, replacement);
+        const ext = extname(filename);
+        const name = basename(filename, ext).replace(pattern, replacement);
         return `${name}${ext}`;
     }, extensions);
 }
@@ -393,8 +310,8 @@ export function renameFileRegex(dirPath, pattern, replacement, extensions = [])
  */
 export function renameFileAddPrefixSuffix(dirPath, { prefix = '', suffix = '' }, extensions = []) {
     renameFileBatch(dirPath, (filename) => {
-        const ext = path.extname(filename);
-        const name = path.basename(filename, ext);
+        const ext = extname(filename);
+        const name = basename(filename, ext);
         return `${prefix}${name}${suffix}${ext}`;
     }, extensions);
 }
@@ -424,9 +341,9 @@ export function renameFileNormalizeCase(dirPath, mode = 'lower', extensions = []
             else
                 return text;
         };
-        const rawExt = path.extname(filename);
+        const rawExt = extname(filename);
         const ext = normalizeExt ? changeToMode(rawExt) : rawExt;
-        const name = changeToMode(path.basename(filename, rawExt));
+        const name = changeToMode(basename(filename, rawExt));
         return `${name}${ext}`;
     }, extensions);
 }

package/dist/v1/index.cjs

@@ -16,7 +16,8 @@ var TinyNotifyCenter = require('./libs/TinyNotifyCenter.cjs');
 var TinyToastNotify = require('./libs/TinyToastNotify.cjs');
 var html = require('./basics/html.cjs');
 var TinyDragDropDetector = require('./libs/TinyDragDropDetector.cjs');
-var fileManager = require('./basics/fileManager.cjs');
+var normalFuncs = require('./fileManager/normalFuncs.cjs');
+var asyncFuncs = require('./fileManager/asyncFuncs.cjs');
 var TinyDragger = require('./libs/TinyDragger.cjs');
 
 
@@ -64,26 +65,32 @@ exports.getHtmlElPadding = html.getHtmlElPadding;
 exports.readJsonBlob = html.readJsonBlob;
 exports.saveJsonFile = html.saveJsonFile;
 exports.TinyDragDropDetector = TinyDragDropDetector;
-exports.backupFile = fileManager.backupFile;
-exports.clearDirectory = fileManager.clearDirectory;
-exports.dirExists = fileManager.dirExists;
-exports.dirSize = fileManager.dirSize;
-exports.ensureCopyFile = fileManager.ensureCopyFile;
-exports.ensureDirectory = fileManager.ensureDirectory;
-exports.fileExists = fileManager.fileExists;
-exports.fileSize = fileManager.fileSize;
-exports.getLatestBackupPath = fileManager.getLatestBackupPath;
-exports.isDirEmpty = fileManager.isDirEmpty;
-exports.listDirs = fileManager.listDirs;
-exports.listFiles = fileManager.listFiles;
-exports.readJsonFile = fileManager.readJsonFile;
-exports.renameFileAddPrefixSuffix = fileManager.renameFileAddPrefixSuffix;
-exports.renameFileBatch = fileManager.renameFileBatch;
-exports.renameFileNormalizeCase = fileManager.renameFileNormalizeCase;
-exports.renameFilePadNumbers = fileManager.renameFilePadNumbers;
-exports.renameFileRegex = fileManager.renameFileRegex;
-exports.restoreLatestBackup = fileManager.restoreLatestBackup;
-exports.tryDeleteFile = fileManager.tryDeleteFile;
-exports.writeJsonFile = fileManager.writeJsonFile;
-exports.writeTextFile = fileManager.writeTextFile;
+exports.backupFile = normalFuncs.backupFile;
+exports.clearDirectory = normalFuncs.clearDirectory;
+exports.dirExists = normalFuncs.dirExists;
+exports.dirSize = normalFuncs.dirSize;
+exports.ensureCopyFile = normalFuncs.ensureCopyFile;
+exports.ensureDirectory = normalFuncs.ensureDirectory;
+exports.fileExists = normalFuncs.fileExists;
+exports.fileSize = normalFuncs.fileSize;
+exports.getLatestBackupPath = normalFuncs.getLatestBackupPath;
+exports.isDirEmpty = normalFuncs.isDirEmpty;
+exports.listDirs = normalFuncs.listDirs;
+exports.listFiles = normalFuncs.listFiles;
+exports.readJsonFile = normalFuncs.readJsonFile;
+exports.renameFileAddPrefixSuffix = normalFuncs.renameFileAddPrefixSuffix;
+exports.renameFileBatch = normalFuncs.renameFileBatch;
+exports.renameFileNormalizeCase = normalFuncs.renameFileNormalizeCase;
+exports.renameFilePadNumbers = normalFuncs.renameFilePadNumbers;
+exports.renameFileRegex = normalFuncs.renameFileRegex;
+exports.restoreLatestBackup = normalFuncs.restoreLatestBackup;
+exports.tryDeleteFile = normalFuncs.tryDeleteFile;
+exports.writeJsonFile = normalFuncs.writeJsonFile;
+exports.writeTextFile = normalFuncs.writeTextFile;
+exports.clearDirectoryAsync = asyncFuncs.clearDirectoryAsync;
+exports.dirSizeAsync = asyncFuncs.dirSizeAsync;
+exports.fileSizeAsync = asyncFuncs.fileSizeAsync;
+exports.isDirEmptyAsync = asyncFuncs.isDirEmptyAsync;
+exports.listDirsAsync = asyncFuncs.listDirsAsync;
+exports.listFilesAsync = asyncFuncs.listFilesAsync;
 exports.TinyDragger = TinyDragger;

package/dist/v1/index.d.mts

@@ -6,35 +6,41 @@ import TinyRateLimiter from './libs/TinyRateLimiter.mjs';
 import ColorSafeStringify from './libs/ColorSafeStringify.mjs';
 import TinyPromiseQueue from './libs/TinyPromiseQueue.mjs';
 import TinyLevelUp from '../legacy/libs/userLevel.mjs';
+import { isDirEmptyAsync } from './fileManager/asyncFuncs.mjs';
+import { fileSizeAsync } from './fileManager/asyncFuncs.mjs';
+import { dirSizeAsync } from './fileManager/asyncFuncs.mjs';
+import { listFilesAsync } from './fileManager/asyncFuncs.mjs';
+import { listDirsAsync } from './fileManager/asyncFuncs.mjs';
 import { getHtmlElBorders } from './basics/html.mjs';
 import { getHtmlElBordersWidth } from './basics/html.mjs';
 import { getHtmlElMargin } from './basics/html.mjs';
 import { getHtmlElPadding } from './basics/html.mjs';
-import { getLatestBackupPath } from './basics/fileManager.mjs';
+import { getLatestBackupPath } from './fileManager/normalFuncs.mjs';
 import { fetchJson } from './basics/html.mjs';
 import { readJsonBlob } from './basics/html.mjs';
 import { saveJsonFile } from './basics/html.mjs';
-import { readJsonFile } from './basics/fileManager.mjs';
-import { writeJsonFile } from './basics/fileManager.mjs';
-import { ensureDirectory } from './basics/fileManager.mjs';
-import { clearDirectory } from './basics/fileManager.mjs';
-import { fileExists } from './basics/fileManager.mjs';
-import { dirExists } from './basics/fileManager.mjs';
-import { isDirEmpty } from './basics/fileManager.mjs';
-import { ensureCopyFile } from './basics/fileManager.mjs';
-import { tryDeleteFile } from './basics/fileManager.mjs';
-import { writeTextFile } from './basics/fileManager.mjs';
-import { listFiles } from './basics/fileManager.mjs';
-import { listDirs } from './basics/fileManager.mjs';
-import { fileSize } from './basics/fileManager.mjs';
-import { dirSize } from './basics/fileManager.mjs';
-import { backupFile } from './basics/fileManager.mjs';
-import { restoreLatestBackup } from './basics/fileManager.mjs';
-import { renameFileBatch } from './basics/fileManager.mjs';
-import { renameFileRegex } from './basics/fileManager.mjs';
-import { renameFileAddPrefixSuffix } from './basics/fileManager.mjs';
-import { renameFileNormalizeCase } from './basics/fileManager.mjs';
-import { renameFilePadNumbers } from './basics/fileManager.mjs';
+import { readJsonFile } from './fileManager/normalFuncs.mjs';
+import { writeJsonFile } from './fileManager/normalFuncs.mjs';
+import { ensureDirectory } from './fileManager/normalFuncs.mjs';
+import { clearDirectoryAsync } from './fileManager/asyncFuncs.mjs';
+import { clearDirectory } from './fileManager/normalFuncs.mjs';
+import { fileExists } from './fileManager/normalFuncs.mjs';
+import { dirExists } from './fileManager/normalFuncs.mjs';
+import { isDirEmpty } from './fileManager/normalFuncs.mjs';
+import { ensureCopyFile } from './fileManager/normalFuncs.mjs';
+import { tryDeleteFile } from './fileManager/normalFuncs.mjs';
+import { writeTextFile } from './fileManager/normalFuncs.mjs';
+import { listFiles } from './fileManager/normalFuncs.mjs';
+import { listDirs } from './fileManager/normalFuncs.mjs';
+import { fileSize } from './fileManager/normalFuncs.mjs';
+import { dirSize } from './fileManager/normalFuncs.mjs';
+import { backupFile } from './fileManager/normalFuncs.mjs';
+import { restoreLatestBackup } from './fileManager/normalFuncs.mjs';
+import { renameFileBatch } from './fileManager/normalFuncs.mjs';
+import { renameFileRegex } from './fileManager/normalFuncs.mjs';
+import { renameFileAddPrefixSuffix } from './fileManager/normalFuncs.mjs';
+import { renameFileNormalizeCase } from './fileManager/normalFuncs.mjs';
+import { renameFilePadNumbers } from './fileManager/normalFuncs.mjs';
 import { documentIsFullScreen } from './basics/fullScreen.mjs';
 import { isScreenFilled } from './basics/fullScreen.mjs';
 import { requestFullScreen } from './basics/fullScreen.mjs';
@@ -64,5 +70,5 @@ import { getTimeDuration } from './basics/clock.mjs';
 import { shuffleArray } from './basics/array.mjs';
 import { toTitleCase } from './basics/text.mjs';
 import { toTitleCaseLowerFirst } from './basics/text.mjs';
-export { TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
+export { TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
 //# sourceMappingURL=index.d.mts.map

package/dist/v1/index.mjs

@@ -14,6 +14,7 @@ import TinyNotifyCenter from './libs/TinyNotifyCenter.mjs';
 import TinyToastNotify from './libs/TinyToastNotify.mjs';
 import { areHtmlElsColliding, readJsonBlob, saveJsonFile, fetchJson, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, } from './basics/html.mjs';
 import TinyDragDropDetector from './libs/TinyDragDropDetector.mjs';
-import { readJsonFile, writeJsonFile, ensureDirectory, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, getLatestBackupPath, } from './basics/fileManager.mjs';
+import { readJsonFile, writeJsonFile, ensureDirectory, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, getLatestBackupPath, } from './fileManager/normalFuncs.mjs';
+import { listFilesAsync, listDirsAsync, clearDirectoryAsync, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, } from './fileManager/asyncFuncs.mjs';
 import TinyDragger from './libs/TinyDragger.mjs';
-export { TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+export { TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, getLatestBackupPath, fetchJson, readJsonBlob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/dist/v1/libs/TinyUploadClicker.cjs

@@ -3,6 +3,7 @@
 var objFilter = require('../basics/objFilter.cjs');
 require('fs');
 require('path');
+require('fs/promises');
 
 /**
  * @typedef {Object} UploaderConfig

package/docs/v1/README.md

@@ -20,7 +20,6 @@ This folder contains the core scripts we have worked on so far. Each file is a m
 - 🔄 **[asyncReplace](./basics/asyncReplace.md)** — Asynchronously replaces matches in a string using a regex and an async function.
 - 🖼️ **[html](./basics/html.md)** — Utilities for handling DOM element interactions like collision detection and basic element manipulation.
 - 📺 **[fullScreen](./basics/fullScreen.md)** — A complete fullscreen API manager with detection, event handling, and cross-browser compatibility.
-* 📁 **[fileManager](./basics/fileManager.mjs.md)** — A Node.js file/directory utility module with support for JSON, backups, renaming, size analysis, and more.
 
 ### 2. **`libs/`**
 - 🗂️ **[TinyPromiseQueue](./libs/TinyPromiseQueue.md)** — A class that allows sequential execution of asynchronous tasks, supporting task delays, cancellation, and queue management.
@@ -33,6 +32,9 @@ This folder contains the core scripts we have worked on so far. Each file is a m
 * 📂 **[TinyUploadClicker](./libs/TinyUploadClicker.md)** — A minimal utility to bind any clickable element to a hidden file input, offering full control over styling, behavior, and upload event hooks.
 * 🧲 **[TinyDragger](./libs/TinyDragger.md)** — A flexible drag-and-drop manager with collision detection, jail constraints, vibration feedback, visual proxies, revert-on-drop, and full custom event support.
 
+### 3. **`fileManager/`**
+* 📁 **[main](./fileManager/main.md)** — A Node.js file/directory utility module with support for JSON, backups, renaming, size analysis, and more.
+
 ---
 
 ## 🚀 Usage

package/docs/v1/{basics/fileManager.md → fileManager/main.md}

@@ -32,6 +32,8 @@ A powerful and flexible utility toolkit for managing files and directories in No
 
 🧹 Deletes all contents inside a directory while keeping the directory itself.
 
+* Async version: `clearDirectoryAsync`.
+
 ---
 
 ## 🧪 File Checks
@@ -48,6 +50,8 @@ A powerful and flexible utility toolkit for managing files and directories in No
 
 📭 Checks if a directory is empty.
 
+* Async version: `isDirEmptyAsync`.
+
 ---
 
 ## 📄 File Operations
@@ -82,10 +86,14 @@ A powerful and flexible utility toolkit for managing files and directories in No
 
 📃 Lists all files and dirs in a directory. Can be recursive.
 
+* Async version: `listFilesAsync`.
+
 ### `listDirs(dirPath: string, recursive?: boolean): string[]`
 
 📁 Lists all directories in a directory. Can be recursive.
 
+* Async version: `listDirsAsync`.
+
 ---
 
 ## 📏 File Info
@@ -94,10 +102,14 @@ A powerful and flexible utility toolkit for managing files and directories in No
 
 ⚖️ Gets the size of a single file in bytes.
 
+* Async version: `fileSizeAsync`.
+
 ### `dirSize(dirPath: string): number`
 
 📦 Gets the total size of all files inside a directory (recursive).
 
+* Async version: `dirSizeAsync`.
+
 ---
 
 ## 💾 Backup Utilities

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-essentials",
-  "version": "1.12.1",
+  "version": "1.12.2",
   "description": "Collection of small, essential scripts designed to be used across various projects. These simple utilities are crafted for speed, ease of use, and versatility.",
   "scripts": {
     "test": "npm run test:mjs && npm run test:cjs && npm run test:js",
@@ -46,6 +46,10 @@
     "./basics": {
       "require": "./dist/v1/basics/index.cjs",
       "import": "./dist/v1/basics/index.mjs"
+    },
+    "./fileManager": {
+      "require": "./dist/v1/fileManager/index.cjs",
+      "import": "./dist/v1/fileManager/index.mjs"
     }
   },
   "repository": {