@jakubmazanec/fs-utils 0.2.16-next.fac374fa → 0.2.16-unstable.2468857d

package/build/createTempDirectory.js

@@ -1,8 +1,17 @@
-"use strict";
 import fs from "fs-extra";
 import os from "node:os";
 import path from "node:path";
-export async function createTempDirectory(prefix) {
-  return fs.mkdtemp(path.join(os.tmpdir(), prefix ?? "/"));
+
+//#region source/createTempDirectory.ts
+/**
+* Creates a unique temporary directory in the operating system's default directory for temporary files. The name of the directory is random, but can be prefixed with a custom string.
+*
+* @param prefix The new directory name prefix.
+* @returns The new directory name.
+* */
+async function createTempDirectory(prefix) {
+	return fs.mkdtemp(path.join(os.tmpdir(), prefix ?? "/"));
 }
-//# sourceMappingURL=createTempDirectory.js.map
+
+//#endregion
+export { createTempDirectory };

package/build/ensureEmptyDirectory.js

@@ -1,23 +1,23 @@
-"use strict";
+import { isEmptyDirectory } from "./isEmptyDirectory.js";
 import fs from "fs-extra";
 import path from "node:path";
-import { isEmptyDirectory } from "./isEmptyDirectory.js";
-export async function ensureEmptyDirectory(targetPath, { allowGit } = {}) {
-  await fs.ensureDir(targetPath);
-  if (!await isEmptyDirectory(targetPath)) {
-    if (!allowGit) {
-      throw new Error(`Directory "${targetPath}" must be empty.`);
-    }
-    let files = await fs.readdir(targetPath);
-    if (files.length !== 1) {
-      throw new Error(`Directory "${targetPath}" can contain only ".git" directory.`);
-    }
-    if (files[0] !== ".git") {
-      throw new Error(`Directory "${targetPath}" can contain only ".git" directory.`);
-    }
-    if (!(await fs.stat(path.join(targetPath, files[0]))).isDirectory()) {
-      throw new Error(`Directory "${targetPath}" can contain only ".git" directory.`);
-    }
-  }
+
+//#region source/ensureEmptyDirectory.ts
+/**
+* Ensures that a path is actually an empty directory. If the path doesn't exist, the directory is created; if the path exists but isn't an ampty directory, error is thrown.
+*
+* @param path The target path.
+*/
+async function ensureEmptyDirectory(targetPath, { allowGit } = {}) {
+	await fs.ensureDir(targetPath);
+	if (!await isEmptyDirectory(targetPath)) {
+		if (!allowGit) throw new Error(`Directory "${targetPath}" must be empty.`);
+		let files = await fs.readdir(targetPath);
+		if (files.length !== 1) throw new Error(`Directory "${targetPath}" can contain only ".git" directory.`);
+		if (files[0] !== ".git") throw new Error(`Directory "${targetPath}" can contain only ".git" directory.`);
+		if (!(await fs.stat(path.join(targetPath, files[0]))).isDirectory()) throw new Error(`Directory "${targetPath}" can contain only ".git" directory.`);
+	}
 }
-//# sourceMappingURL=ensureEmptyDirectory.js.map
+
+//#endregion
+export { ensureEmptyDirectory };

package/build/findDirectories.js

@@ -1,6 +1,15 @@
-"use strict";
 import fs from "fs-extra";
-export async function findDirectories(searchPath) {
-  return (await fs.readdir(searchPath, { withFileTypes: true })).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
+
+//#region source/findDirectories.ts
+/**
+* Finds all directories that are direct sub-directories of a path.
+*
+* @param searchPath Search path.
+* @returns The list of directory names.
+*/
+async function findDirectories(searchPath) {
+	return (await fs.readdir(searchPath, { withFileTypes: true })).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
 }
-//# sourceMappingURL=findDirectories.js.map
+
+//#endregion
+export { findDirectories };

package/build/findExistingDirectory.js

@@ -1,18 +1,27 @@
-"use strict";
+import { isDirectory } from "./isDirectory.js";
 import fs from "fs-extra";
 import path from "node:path";
-import { isDirectory } from "./isDirectory.js";
-export async function findExistingDirectory(searchPath) {
-  let result = searchPath;
-  let pathExists = await fs.pathExists(result);
-  while (!pathExists) {
-    result = path.dirname(result);
-    pathExists = await fs.pathExists(result);
-  }
-  let isResultDirectory = await isDirectory(result);
-  if (!isResultDirectory) {
-    result = path.dirname(result);
-  }
-  return result;
+
+//#region source/findExistingDirectory.ts
+/**
+* Travels up the file system tree from a starting path and returns path of the first existing directory.
+*
+* ```TypeScript
+* let result = findExistingDirectory('/foo/bar/baz'); // if there is no `bar` directory, `result` is `'/foo'`
+* ```
+*
+* @param searchPath Search path.
+*/
+async function findExistingDirectory(searchPath) {
+	let result = searchPath;
+	let pathExists = await fs.pathExists(result);
+	while (!pathExists) {
+		result = path.dirname(result);
+		pathExists = await fs.pathExists(result);
+	}
+	if (!await isDirectory(result)) result = path.dirname(result);
+	return result;
 }
-//# sourceMappingURL=findExistingDirectory.js.map
+
+//#endregion
+export { findExistingDirectory };

package/build/isDirectory.js

@@ -1,7 +1,15 @@
-"use strict";
 import fs from "fs-extra";
-export async function isDirectory(path) {
-  let stat = await fs.lstat(path);
-  return stat.isDirectory();
+
+//#region source/isDirectory.ts
+/**
+* Checks if a path is a directory.
+*
+* @param path The path to check.
+* @returns `true` if path is a directory, `false` otherwise.
+*/
+async function isDirectory(path) {
+	return (await fs.lstat(path)).isDirectory();
 }
-//# sourceMappingURL=isDirectory.js.map
+
+//#endregion
+export { isDirectory };

package/build/isEmptyDirectory.js

@@ -1,13 +1,22 @@
-"use strict";
 import fs from "fs-extra";
-export async function isEmptyDirectory(path) {
-  try {
-    let directory = await fs.opendir(path);
-    let entry = await directory.read();
-    await directory.close();
-    return entry === null;
-  } catch {
-    return false;
-  }
+
+//#region source/isEmptyDirectory.ts
+/**
+* Checks if a path is an empty directory.
+*
+* @param path The path to check.
+* @returns `true` if path is an empty directory, `false` otherwise.
+*/
+async function isEmptyDirectory(path) {
+	try {
+		let directory = await fs.opendir(path);
+		let entry = await directory.read();
+		await directory.close();
+		return entry === null;
+	} catch {
+		return false;
+	}
 }
-//# sourceMappingURL=isEmptyDirectory.js.map
+
+//#endregion
+export { isEmptyDirectory };

package/build/isRootPath.js

@@ -1,6 +1,15 @@
-"use strict";
 import path from "node:path";
-export function isRootPath(value) {
-  return value.toLowerCase() === path.parse(value).root.toLowerCase();
+
+//#region source/isRootPath.ts
+/**
+* Checks if a path is a file system root path.
+*
+* @param path The path to check.
+* @returns `true` if path is the root, `false` otherwise.
+*/
+function isRootPath(value) {
+	return value.toLowerCase() === path.parse(value).root.toLowerCase();
 }
-//# sourceMappingURL=isRootPath.js.map
+
+//#endregion
+export { isRootPath };

package/build/main.js

@@ -1,10 +1,10 @@
-"use strict";
-export * from "./createTempDirectory.js";
-export * from "./ensureEmptyDirectory.js";
-export * from "./findDirectories.js";
-export * from "./findExistingDirectory.js";
-export * from "./isDirectory.js";
-export * from "./isEmptyDirectory.js";
-export * from "./isRootPath.js";
-export * from "./pathToPosixPath.js";
-//# sourceMappingURL=main.js.map
+import { createTempDirectory } from "./createTempDirectory.js";
+import { isEmptyDirectory } from "./isEmptyDirectory.js";
+import { ensureEmptyDirectory } from "./ensureEmptyDirectory.js";
+import { findDirectories } from "./findDirectories.js";
+import { isDirectory } from "./isDirectory.js";
+import { findExistingDirectory } from "./findExistingDirectory.js";
+import { isRootPath } from "./isRootPath.js";
+import { pathToPosixPath } from "./pathToPosixPath.js";
+
+export { createTempDirectory, ensureEmptyDirectory, findDirectories, findExistingDirectory, isDirectory, isEmptyDirectory, isRootPath, pathToPosixPath };

package/build/pathToPosixPath.js

@@ -1,6 +1,15 @@
-"use strict";
 import path from "node:path";
-export function pathToPosixPath(value) {
-  return value.split(path.win32.sep).join(path.posix.sep);
+
+//#region source/pathToPosixPath.ts
+/**
+* Converts path to POSIX path.
+*
+* @param value The path to convert.
+* @returns The converted path.
+*/
+function pathToPosixPath(value) {
+	return value.split(path.win32.sep).join(path.posix.sep);
 }
-//# sourceMappingURL=pathToPosixPath.js.map
+
+//#endregion
+export { pathToPosixPath };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jakubmazanec/fs-utils",
-  "version": "0.2.16-next.fac374fa",
+  "version": "0.2.16-unstable.2468857d",
   "description": "Collection of utilities for working with file system.",
   "repository": {
     "type": "git",
@@ -17,9 +17,9 @@
     "source"
   ],
   "scripts": {
-    "build": "del-cli build tsconfig.tsbuildinfo && esbuild \"source/**/*\" --platform=node --target=node24.3 --outdir=build --sourcemap && tsc",
+    "build": "del-cli build tsconfig.tsbuildinfo && tsdown && tsc",
     "clean": "del-cli coverage build *.tsbuildinfo",
-    "develop": "concurrently \"esbuild \"source/**/*\" --platform=node --target=node24.3 --outdir=build --sourcemap --watch\" \"tsc --watch\"",
+    "develop": "concurrently \"tsdown --watch\" \"tsc --watch\"",
     "document": "del-cli docs && typedoc --options typedoc.config.cjs",
     "format": "prettier . --write --ignore-unknown",
     "lint": "eslint .",
@@ -30,18 +30,18 @@
     "fs-extra": "^11.3.2"
   },
   "devDependencies": {
-    "@jakubmazanec/eslint-config": "4.1.10-next.fac374fa",
+    "@jakubmazanec/eslint-config": "4.1.10-unstable.2468857d",
     "@types/fs-extra": "^11.0.4",
     "@types/lodash": "^4.17.21",
     "@types/node": "^24.0.4",
     "@vitest/coverage-v8": "^3.2.4",
     "concurrently": "^9.2.1",
     "del-cli": "^6.0.0",
-    "esbuild": "^0.27.0",
     "eslint": "^9.33.0",
     "lodash": "^4.17.21",
     "prettier": "^3.6.2",
     "prettier-plugin-packagejson": "^2.5.19",
+    "tsdown": "^0.17.2",
     "typedoc": "^0.28.14",
     "typedoc-plugin-markdown": "^4.9.0",
     "typescript": "^5.9.3",

package/build/createTempDirectory.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/createTempDirectory.ts"],
-  "sourcesContent": ["import fs from 'fs-extra';\nimport os from 'node:os';\nimport path from 'node:path';\n\n/**\n * Creates a unique temporary directory in the operating system's default directory for temporary files. The name of the directory is random, but can be prefixed with a custom string.\n *\n * @param prefix The new directory name prefix.\n * @returns The new directory name.\n * */\nexport async function createTempDirectory(prefix?: string) {\n  return fs.mkdtemp(path.join(os.tmpdir(), prefix ?? '/'));\n}\n"],
-  "mappings": ";AAAA,OAAO,QAAQ;AACf,OAAO,QAAQ;AACf,OAAO,UAAU;AAQjB,sBAAsB,oBAAoB,QAAiB;AACzD,SAAO,GAAG,QAAQ,KAAK,KAAK,GAAG,OAAO,GAAG,UAAU,GAAG,CAAC;AACzD;",
-  "names": []
-}

package/build/ensureEmptyDirectory.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/ensureEmptyDirectory.ts"],
-  "sourcesContent": ["import fs from 'fs-extra';\nimport path from 'node:path';\n\nimport {isEmptyDirectory} from './isEmptyDirectory.js';\n\n/**\n * {@link ensureEmptyDirectory} options parameter.\n */\nexport type EnsureEmptyDirectoryOptions = {\n  /** Allows presence of a `.git` directory */\n  allowGit?: boolean | undefined;\n};\n\n/**\n * Ensures that a path is actually an empty directory. If the path doesn't exist, the directory is created; if the path exists but isn't an ampty directory, error is thrown.\n *\n * @param path The target path.\n */\nexport async function ensureEmptyDirectory(\n  targetPath: string,\n  {allowGit}: EnsureEmptyDirectoryOptions = {},\n) {\n  await fs.ensureDir(targetPath);\n\n  if (!(await isEmptyDirectory(targetPath))) {\n    if (!allowGit) {\n      throw new Error(`Directory \"${targetPath}\" must be empty.`);\n    }\n\n    let files = await fs.readdir(targetPath);\n\n    if (files.length !== 1) {\n      throw new Error(`Directory \"${targetPath}\" can contain only \".git\" directory.`);\n    }\n\n    if (files[0] !== '.git') {\n      throw new Error(`Directory \"${targetPath}\" can contain only \".git\" directory.`);\n    }\n\n    if (!(await fs.stat(path.join(targetPath, files[0] as string))).isDirectory()) {\n      throw new Error(`Directory \"${targetPath}\" can contain only \".git\" directory.`);\n    }\n  }\n}\n"],
-  "mappings": ";AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AAEjB,SAAQ,wBAAuB;AAe/B,sBAAsB,qBACpB,YACA,EAAC,SAAQ,IAAiC,CAAC,GAC3C;AACA,QAAM,GAAG,UAAU,UAAU;AAE7B,MAAI,CAAE,MAAM,iBAAiB,UAAU,GAAI;AACzC,QAAI,CAAC,UAAU;AACb,YAAM,IAAI,MAAM,cAAc,UAAU,kBAAkB;AAAA,IAC5D;AAEA,QAAI,QAAQ,MAAM,GAAG,QAAQ,UAAU;AAEvC,QAAI,MAAM,WAAW,GAAG;AACtB,YAAM,IAAI,MAAM,cAAc,UAAU,sCAAsC;AAAA,IAChF;AAEA,QAAI,MAAM,CAAC,MAAM,QAAQ;AACvB,YAAM,IAAI,MAAM,cAAc,UAAU,sCAAsC;AAAA,IAChF;AAEA,QAAI,EAAE,MAAM,GAAG,KAAK,KAAK,KAAK,YAAY,MAAM,CAAC,CAAW,CAAC,GAAG,YAAY,GAAG;AAC7E,YAAM,IAAI,MAAM,cAAc,UAAU,sCAAsC;AAAA,IAChF;AAAA,EACF;AACF;",
-  "names": []
-}

package/build/findDirectories.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/findDirectories.ts"],
-  "sourcesContent": ["import fs from 'fs-extra';\n\n/**\n * Finds all directories that are direct sub-directories of a path.\n *\n * @param searchPath Search path.\n * @returns The list of directory names.\n */\nexport async function findDirectories(searchPath: string): Promise<string[]> {\n  return (await fs.readdir(searchPath, {withFileTypes: true}))\n    .filter((dirent) => dirent.isDirectory())\n    .map((dirent) => dirent.name);\n}\n"],
-  "mappings": ";AAAA,OAAO,QAAQ;AAQf,sBAAsB,gBAAgB,YAAuC;AAC3E,UAAQ,MAAM,GAAG,QAAQ,YAAY,EAAC,eAAe,KAAI,CAAC,GACvD,OAAO,CAAC,WAAW,OAAO,YAAY,CAAC,EACvC,IAAI,CAAC,WAAW,OAAO,IAAI;AAChC;",
-  "names": []
-}

package/build/findExistingDirectory.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/findExistingDirectory.ts"],
-  "sourcesContent": ["import fs from 'fs-extra';\nimport path from 'node:path';\n\nimport {isDirectory} from './isDirectory.js';\n\n/**\n * Travels up the file system tree from a starting path and returns path of the first existing directory.\n *\n * ```TypeScript\n * let result = findExistingDirectory('/foo/bar/baz'); // if there is no `bar` directory, `result` is `'/foo'`\n * ```\n *\n * @param searchPath Search path.\n */\nexport async function findExistingDirectory(searchPath: string) {\n  let result = searchPath;\n  let pathExists = await fs.pathExists(result);\n\n  while (!pathExists) {\n    result = path.dirname(result);\n    pathExists = await fs.pathExists(result);\n  }\n\n  let isResultDirectory = await isDirectory(result);\n\n  if (!isResultDirectory) {\n    result = path.dirname(result);\n  }\n\n  return result;\n}\n"],
-  "mappings": ";AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AAEjB,SAAQ,mBAAkB;AAW1B,sBAAsB,sBAAsB,YAAoB;AAC9D,MAAI,SAAS;AACb,MAAI,aAAa,MAAM,GAAG,WAAW,MAAM;AAE3C,SAAO,CAAC,YAAY;AAClB,aAAS,KAAK,QAAQ,MAAM;AAC5B,iBAAa,MAAM,GAAG,WAAW,MAAM;AAAA,EACzC;AAEA,MAAI,oBAAoB,MAAM,YAAY,MAAM;AAEhD,MAAI,CAAC,mBAAmB;AACtB,aAAS,KAAK,QAAQ,MAAM;AAAA,EAC9B;AAEA,SAAO;AACT;",
-  "names": []
-}

package/build/isDirectory.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/isDirectory.ts"],
-  "sourcesContent": ["import fs from 'fs-extra';\n\n/**\n * Checks if a path is a directory.\n *\n * @param path The path to check.\n * @returns `true` if path is a directory, `false` otherwise.\n */\nexport async function isDirectory(path: string): Promise<boolean> {\n  let stat = await fs.lstat(path);\n\n  return stat.isDirectory();\n}\n"],
-  "mappings": ";AAAA,OAAO,QAAQ;AAQf,sBAAsB,YAAY,MAAgC;AAChE,MAAI,OAAO,MAAM,GAAG,MAAM,IAAI;AAE9B,SAAO,KAAK,YAAY;AAC1B;",
-  "names": []
-}

package/build/isEmptyDirectory.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/isEmptyDirectory.ts"],
-  "sourcesContent": ["import fs from 'fs-extra';\n\n/**\n * Checks if a path is an empty directory.\n *\n * @param path The path to check.\n * @returns `true` if path is an empty directory, `false` otherwise.\n */\nexport async function isEmptyDirectory(path: string) {\n  try {\n    let directory = await fs.opendir(path);\n    let entry = await directory.read();\n\n    await directory.close();\n\n    return entry === null;\n  } catch {\n    return false;\n  }\n}\n"],
-  "mappings": ";AAAA,OAAO,QAAQ;AAQf,sBAAsB,iBAAiB,MAAc;AACnD,MAAI;AACF,QAAI,YAAY,MAAM,GAAG,QAAQ,IAAI;AACrC,QAAI,QAAQ,MAAM,UAAU,KAAK;AAEjC,UAAM,UAAU,MAAM;AAEtB,WAAO,UAAU;AAAA,EACnB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;",
-  "names": []
-}

package/build/isRootPath.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/isRootPath.ts"],
-  "sourcesContent": ["import path from 'node:path';\n\n/**\n * Checks if a path is a file system root path.\n *\n * @param path The path to check.\n * @returns `true` if path is the root, `false` otherwise.\n */\nexport function isRootPath(value: string) {\n  return value.toLowerCase() === path.parse(value).root.toLowerCase();\n}\n"],
-  "mappings": ";AAAA,OAAO,UAAU;AAQV,gBAAS,WAAW,OAAe;AACxC,SAAO,MAAM,YAAY,MAAM,KAAK,MAAM,KAAK,EAAE,KAAK,YAAY;AACpE;",
-  "names": []
-}

package/build/main.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/main.ts"],
-  "sourcesContent": ["export * from './createTempDirectory.js';\nexport * from './ensureEmptyDirectory.js';\nexport * from './findDirectories.js';\nexport * from './findExistingDirectory.js';\nexport * from './isDirectory.js';\nexport * from './isEmptyDirectory.js';\nexport * from './isRootPath.js';\nexport * from './pathToPosixPath.js';\n"],
-  "mappings": ";AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
-  "names": []
-}

package/build/pathToPosixPath.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/pathToPosixPath.ts"],
-  "sourcesContent": ["import path from 'node:path';\n\n/**\n * Converts path to POSIX path.\n *\n * @param value The path to convert.\n * @returns The converted path.\n */\nexport function pathToPosixPath(value: string): string {\n  return value.split(path.win32.sep).join(path.posix.sep);\n}\n"],
-  "mappings": ";AAAA,OAAO,UAAU;AAQV,gBAAS,gBAAgB,OAAuB;AACrD,SAAO,MAAM,MAAM,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,MAAM,GAAG;AACxD;",
-  "names": []
-}