@visulima/fs 5.0.0-alpha.2 → 5.0.0-alpha.21

package/dist/packem_shared/walkSync-DDBq95s8.js

@@ -1,114 +0,0 @@
-import { createRequire as __cjs_createRequire } from "node:module";
-
-const __cjs_require = __cjs_createRequire(import.meta.url);
-
-const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
-
-const __cjs_getBuiltinModule = (module) => {
-    // Check if we're in Node.js and version supports getBuiltinModule
-    if (typeof __cjs_getProcess !== "undefined" && __cjs_getProcess.versions && __cjs_getProcess.versions.node) {
-        const [major, minor] = __cjs_getProcess.versions.node.split(".").map(Number);
-        // Node.js 20.16.0+ and 22.3.0+
-        if (major > 22 || (major === 22 && minor >= 3) || (major === 20 && minor >= 16)) {
-            return __cjs_getProcess.getBuiltinModule(module);
-        }
-    }
-    // Fallback to createRequire
-    return __cjs_require(module);
-};
-
-const {
-  readdirSync,
-  realpathSync,
-  statSync
-} = __cjs_getBuiltinModule("node:fs");
-import { resolve, join, normalize, basename } from '@visulima/path';
-import { toPath } from '@visulima/path/utils';
-import WalkError from './WalkError-DUdQd6FT.js';
-import assertValidFileOrDirectoryPath from './assertValidFileOrDirectoryPath-8HANmVjk.js';
-import { g as globToRegExp, w as walkInclude } from './walk-include-CZco7BvN.js';
-
-const _createWalkEntry = (path) => {
-  const normalizePath = normalize(path);
-  const info = statSync(normalizePath);
-  return {
-    isDirectory: info.isDirectory,
-    isFile: info.isFile,
-    isSymbolicLink: info.isSymbolicLink,
-    name: basename(normalizePath),
-    path: normalizePath
-  };
-};
-function* walkSync(directory, {
-  extensions,
-  followSymlinks = false,
-  includeDirs: includeDirectories = true,
-  includeFiles = true,
-  includeSymlinks = true,
-  match,
-  maxDepth = Number.POSITIVE_INFINITY,
-  skip
-} = {}) {
-  assertValidFileOrDirectoryPath(directory);
-  if (maxDepth < 0) {
-    return;
-  }
-  const mappedMatch = match ? match.map((pattern) => typeof pattern === "string" ? globToRegExp(pattern) : pattern) : void 0;
-  const mappedSkip = skip ? skip.map((pattern) => typeof pattern === "string" ? globToRegExp(pattern) : pattern) : void 0;
-  directory = resolve(toPath(directory));
-  if (includeDirectories && walkInclude(directory, extensions, mappedMatch, mappedSkip)) {
-    yield _createWalkEntry(directory);
-  }
-  if (maxDepth < 1 || !walkInclude(directory, void 0, void 0, mappedSkip)) {
-    return;
-  }
-  try {
-    for (const entry of readdirSync(directory, {
-      withFileTypes: true
-    })) {
-      let path = join(directory, entry.name);
-      if (entry.isSymbolicLink()) {
-        if (followSymlinks) {
-          path = realpathSync(path);
-        } else if (includeSymlinks && walkInclude(path, extensions, mappedMatch, mappedSkip)) {
-          yield {
-            isDirectory: entry.isDirectory,
-            isFile: entry.isFile,
-            isSymbolicLink: entry.isSymbolicLink,
-            name: entry.name,
-            path: normalize(path)
-          };
-        } else {
-          continue;
-        }
-      }
-      if (entry.isSymbolicLink() || entry.isDirectory()) {
-        yield* walkSync(path, {
-          extensions,
-          followSymlinks,
-          includeDirs: includeDirectories,
-          includeFiles,
-          includeSymlinks,
-          match: mappedMatch,
-          maxDepth: maxDepth - 1,
-          skip: mappedSkip
-        });
-      } else if (entry.isFile() && includeFiles && walkInclude(path, extensions, mappedMatch, mappedSkip)) {
-        yield {
-          isDirectory: entry.isDirectory,
-          isFile: entry.isFile,
-          isSymbolicLink: entry.isSymbolicLink,
-          name: entry.name,
-          path: normalize(path)
-        };
-      }
-    }
-  } catch (error) {
-    if (error instanceof WalkError) {
-      throw error;
-    }
-    throw new WalkError(error, directory);
-  }
-}
-
-export { walkSync as default };

package/dist/packem_shared/writeFile-DSHERs0Z.js

@@ -1,83 +0,0 @@
-import { createRequire as __cjs_createRequire } from "node:module";
-
-const __cjs_require = __cjs_createRequire(import.meta.url);
-
-const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
-
-const __cjs_getBuiltinModule = (module) => {
-    // Check if we're in Node.js and version supports getBuiltinModule
-    if (typeof __cjs_getProcess !== "undefined" && __cjs_getProcess.versions && __cjs_getProcess.versions.node) {
-        const [major, minor] = __cjs_getProcess.versions.node.split(".").map(Number);
-        // Node.js 20.16.0+ and 22.3.0+
-        if (major > 22 || (major === 22 && minor >= 3) || (major === 20 && minor >= 16)) {
-            return __cjs_getProcess.getBuiltinModule(module);
-        }
-    }
-    // Fallback to createRequire
-    return __cjs_require(module);
-};
-
-const {
-  mkdir,
-  writeFile: writeFile$1,
-  stat,
-  rename,
-  chown,
-  chmod,
-  unlink
-} = __cjs_getBuiltinModule("node:fs/promises");
-import { dirname } from '@visulima/path';
-import { toPath } from '@visulima/path/utils';
-import { F_OK } from './F_OK-MldBaGxb.js';
-import isAccessible from './isAccessible-DuVrTNFV.js';
-import assertValidFileContents from './assertValidFileContents-BmcLtsGd.js';
-import assertValidFileOrDirectoryPath from './assertValidFileOrDirectoryPath-8HANmVjk.js';
-import { t as toUint8Array } from './to-uint-8-array-Dz2nF1y1.js';
-
-const writeFile = async (path, content, options) => {
-  options = {
-    encoding: "utf8",
-    flag: "w",
-    overwrite: true,
-    recursive: true,
-    ...options
-  };
-  assertValidFileOrDirectoryPath(path);
-  assertValidFileContents(content);
-  path = toPath(path);
-  const temporaryPath = `${path}.tmp`;
-  try {
-    const pathExists = await isAccessible(path, F_OK);
-    if (!pathExists && options.recursive) {
-      const directory = dirname(path);
-      if (!await isAccessible(directory, F_OK)) {
-        await mkdir(directory, { recursive: true });
-      }
-    }
-    let stat$1;
-    await writeFile$1(temporaryPath, toUint8Array(content), { encoding: options.encoding, flag: options.flag });
-    if (pathExists && !options.overwrite) {
-      stat$1 = await stat(path);
-      if (options.chown === void 0) {
-        options.chown = { gid: stat$1.gid, uid: stat$1.uid };
-      }
-      await rename(path, `${path}.bak`);
-    }
-    if (options.chown) {
-      try {
-        await chown(temporaryPath, options.chown.uid, options.chown.gid);
-      } catch {
-      }
-    }
-    await chmod(temporaryPath, stat$1 && !options.mode ? stat$1.mode : options.mode ?? 438);
-    await rename(temporaryPath, path);
-  } catch (error) {
-    throw new Error(`Failed to write file at: ${path} - ${error.message}`, { cause: error });
-  } finally {
-    if (await isAccessible(temporaryPath)) {
-      await unlink(`${path}.tmp`);
-    }
-  }
-};
-
-export { writeFile as default };

package/dist/packem_shared/writeFileSync-CJp1kXQR.js

@@ -1,83 +0,0 @@
-import { createRequire as __cjs_createRequire } from "node:module";
-
-const __cjs_require = __cjs_createRequire(import.meta.url);
-
-const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
-
-const __cjs_getBuiltinModule = (module) => {
-    // Check if we're in Node.js and version supports getBuiltinModule
-    if (typeof __cjs_getProcess !== "undefined" && __cjs_getProcess.versions && __cjs_getProcess.versions.node) {
-        const [major, minor] = __cjs_getProcess.versions.node.split(".").map(Number);
-        // Node.js 20.16.0+ and 22.3.0+
-        if (major > 22 || (major === 22 && minor >= 3) || (major === 20 && minor >= 16)) {
-            return __cjs_getProcess.getBuiltinModule(module);
-        }
-    }
-    // Fallback to createRequire
-    return __cjs_require(module);
-};
-
-const {
-  mkdirSync,
-  writeFileSync: writeFileSync$1,
-  statSync,
-  renameSync,
-  chownSync,
-  chmodSync,
-  unlinkSync
-} = __cjs_getBuiltinModule("node:fs");
-import { dirname } from '@visulima/path';
-import { toPath } from '@visulima/path/utils';
-import { F_OK } from './F_OK-MldBaGxb.js';
-import isAccessibleSync from './isAccessibleSync-DI8mM0fA.js';
-import assertValidFileContents from './assertValidFileContents-BmcLtsGd.js';
-import assertValidFileOrDirectoryPath from './assertValidFileOrDirectoryPath-8HANmVjk.js';
-import { t as toUint8Array } from './to-uint-8-array-Dz2nF1y1.js';
-
-const writeFileSync = (path, content, options) => {
-  options = {
-    encoding: "utf8",
-    flag: "w",
-    overwrite: true,
-    recursive: true,
-    ...options
-  };
-  assertValidFileOrDirectoryPath(path);
-  assertValidFileContents(content);
-  path = toPath(path);
-  const temporaryPath = `${path}.tmp`;
-  try {
-    const pathExists = isAccessibleSync(path, F_OK);
-    if (!pathExists && options.recursive) {
-      const directory = dirname(path);
-      if (!isAccessibleSync(directory, F_OK)) {
-        mkdirSync(directory, { recursive: true });
-      }
-    }
-    let stat;
-    writeFileSync$1(temporaryPath, toUint8Array(content), { encoding: options.encoding, flag: options.flag });
-    if (pathExists && !options.overwrite) {
-      stat = statSync(path);
-      if (options.chown === void 0) {
-        options.chown = { gid: stat.gid, uid: stat.uid };
-      }
-      renameSync(path, `${path}.bak`);
-    }
-    if (options.chown) {
-      try {
-        chownSync(temporaryPath, options.chown.uid, options.chown.gid);
-      } catch {
-      }
-    }
-    chmodSync(temporaryPath, stat && !options.mode ? stat.mode : options.mode ?? 438);
-    renameSync(temporaryPath, path);
-  } catch (error) {
-    throw new Error(`Failed to write file at: ${path} - ${error.message}`, { cause: error });
-  } finally {
-    if (isAccessibleSync(temporaryPath)) {
-      unlinkSync(`${path}.tmp`);
-    }
-  }
-};
-
-export { writeFileSync as default };

package/dist/packem_shared/writeJson-C0OfLDbe.js

@@ -1,50 +0,0 @@
-import { createRequire as __cjs_createRequire } from "node:module";
-
-const __cjs_require = __cjs_createRequire(import.meta.url);
-
-const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
-
-const __cjs_getBuiltinModule = (module) => {
-    // Check if we're in Node.js and version supports getBuiltinModule
-    if (typeof __cjs_getProcess !== "undefined" && __cjs_getProcess.versions && __cjs_getProcess.versions.node) {
-        const [major, minor] = __cjs_getProcess.versions.node.split(".").map(Number);
-        // Node.js 20.16.0+ and 22.3.0+
-        if (major > 22 || (major === 22 && minor >= 3) || (major === 20 && minor >= 16)) {
-            return __cjs_getProcess.getBuiltinModule(module);
-        }
-    }
-    // Fallback to createRequire
-    return __cjs_require(module);
-};
-
-const {
-  readFile
-} = __cjs_getBuiltinModule("node:fs/promises");
-import { d as detectIndent } from './index-CHM-in-V.js';
-import { R_OK } from './F_OK-MldBaGxb.js';
-import isAccessible from './isAccessible-DuVrTNFV.js';
-import writeFile from './writeFile-DSHERs0Z.js';
-
-const writeJson = async (path, data, options = {}) => {
-  const { detectIndent: detectIndent$1, indent: indentOption, replacer, stringify = JSON.stringify, ...writeOptions } = { indent: "	", ...options };
-  let indent = indentOption;
-  let trailingNewline = "\n";
-  if (await isAccessible(path, R_OK)) {
-    try {
-      const file = await readFile(path, "utf8");
-      if (detectIndent$1) {
-        const { indent: dIndent } = detectIndent(file);
-        indent = dIndent;
-      }
-      trailingNewline = file.endsWith("\n") ? "\n" : "";
-    } catch (error) {
-      if (error.code !== "ENOENT") {
-        throw error;
-      }
-    }
-  }
-  const json = stringify(data, replacer, indent);
-  await writeFile(path, `${json}${trailingNewline}`, writeOptions);
-};
-
-export { writeJson as default };

package/dist/packem_shared/writeJsonSync-Cs21FE7v.js

@@ -1,50 +0,0 @@
-import { createRequire as __cjs_createRequire } from "node:module";
-
-const __cjs_require = __cjs_createRequire(import.meta.url);
-
-const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
-
-const __cjs_getBuiltinModule = (module) => {
-    // Check if we're in Node.js and version supports getBuiltinModule
-    if (typeof __cjs_getProcess !== "undefined" && __cjs_getProcess.versions && __cjs_getProcess.versions.node) {
-        const [major, minor] = __cjs_getProcess.versions.node.split(".").map(Number);
-        // Node.js 20.16.0+ and 22.3.0+
-        if (major > 22 || (major === 22 && minor >= 3) || (major === 20 && minor >= 16)) {
-            return __cjs_getProcess.getBuiltinModule(module);
-        }
-    }
-    // Fallback to createRequire
-    return __cjs_require(module);
-};
-
-const {
-  readFileSync
-} = __cjs_getBuiltinModule("node:fs");
-import { d as detectIndent } from './index-CHM-in-V.js';
-import { R_OK } from './F_OK-MldBaGxb.js';
-import isAccessibleSync from './isAccessibleSync-DI8mM0fA.js';
-import writeFileSync from './writeFileSync-CJp1kXQR.js';
-
-const writeJsonSync = (path, data, options = {}) => {
-  const { detectIndent: detectIndent$1, indent: indentOption, replacer, stringify = JSON.stringify, ...writeOptions } = { indent: "	", ...options };
-  let indent = indentOption;
-  let trailingNewline = "\n";
-  if (isAccessibleSync(path, R_OK)) {
-    try {
-      const file = readFileSync(path, "utf8");
-      if (detectIndent$1) {
-        const { indent: dIndent } = detectIndent(file);
-        indent = dIndent;
-      }
-      trailingNewline = file.endsWith("\n") ? "\n" : "";
-    } catch (error) {
-      if (error.code !== "ENOENT") {
-        throw error;
-      }
-    }
-  }
-  const json = stringify(data, replacer, indent);
-  writeFileSync(path, `${json}${trailingNewline}`, writeOptions);
-};
-
-export { writeJsonSync as default };

package/dist/packem_shared/writeYaml-n4xzYN9a.js

@@ -1,24 +0,0 @@
-import { stringify } from 'yaml';
-import writeFile from './writeFile-DSHERs0Z.js';
-
-async function writeYaml(path, data, replacer, options) {
-  let stringifyOptions;
-  let effectiveReplacer;
-  let space;
-  if (typeof replacer === "object" && replacer !== null && !Array.isArray(replacer) && typeof replacer !== "function") {
-    stringifyOptions = replacer;
-    effectiveReplacer = stringifyOptions.replacer;
-    space = stringifyOptions.space;
-  } else if (typeof options === "object" && options !== null) {
-    stringifyOptions = options;
-    effectiveReplacer = replacer;
-    space = stringifyOptions.space ?? (typeof options === "number" || typeof options === "string" ? options : void 0);
-  } else {
-    effectiveReplacer = replacer;
-    space = options;
-  }
-  const content = stringify(data, effectiveReplacer, space ?? stringifyOptions);
-  await writeFile(path, content, stringifyOptions);
-}
-
-export { writeYaml as default };

package/dist/packem_shared/writeYamlSync-DnOEnP10.js

@@ -1,24 +0,0 @@
-import { stringify } from 'yaml';
-import writeFileSync from './writeFileSync-CJp1kXQR.js';
-
-function writeYamlSync(path, data, replacer, options) {
-  let stringifyOptions;
-  let effectiveReplacer;
-  let space;
-  if (typeof replacer === "object" && replacer !== null && !Array.isArray(replacer) && typeof replacer !== "function") {
-    stringifyOptions = replacer;
-    effectiveReplacer = stringifyOptions.replacer;
-    space = stringifyOptions.space;
-  } else if (typeof options === "object" && options !== null) {
-    stringifyOptions = options;
-    effectiveReplacer = replacer;
-    space = stringifyOptions.space ?? (typeof options === "number" || typeof options === "string" ? options : void 0);
-  } else {
-    effectiveReplacer = replacer;
-    space = options;
-  }
-  const content = stringify(data, effectiveReplacer, space ?? stringifyOptions);
-  writeFileSync(path, content, stringifyOptions);
-}
-
-export { writeYamlSync as default };

package/dist/read/read-file-sync.d.ts

@@ -1,37 +0,0 @@
-import type { ContentType, ReadFileOptions } from "../types.d.ts";
-type DecompressionMethod = (buffer: Buffer, callback: (error: Error | null, result: Buffer) => void) => void;
-declare const decompressionMethods: Record<string, DecompressionMethod>;
-/**
- * Synchronously reads the entire contents of a file.
- * It can also decompress the file content if a `compression` option is provided.
- * @template O - The type of the options object, extending {@link ReadFileOptions}.
- * @param path The path to the file to read. Can be a file URL or a string path.
- * @param options Optional configuration for reading the file. See {@link ReadFileOptions}.
- * Available `compression` methods: "brotli", "gzip", "none" (default).
- * @returns The file content. The type of the content (string or Buffer)
- * depends on the `buffer` option (defaults to string if `buffer` is false or not set).
- * @example
- * ```javascript
- * import { readFileSync } from "@visulima/fs";
- * import { join } from "node:path";
- *
- * try {
- *   // Read a regular text file
- *   const content = readFileSync(join("path", "to", "my-file.txt"));
- *   console.log("File content:", content);
- *
- *   // Read a file as a Buffer
- *   const bufferContent = readFileSync(join("path", "to", "another-file.bin"), { buffer: true });
- *   console.log("Buffer length:", bufferContent.length);
- *
- *   // Read and decompress a gzipped file
- *   // Assume my-archive.txt.gz exists
- *   // const decompressedContent = readFileSync(join("path", "to", "my-archive.txt.gz"), { compression: "gzip", encoding: "utf8" });
- *   // console.log("Decompressed content:", decompressedContent);
- * } catch (error) {
- *   console.error("Failed to read file:", error);
- * }
- * ```
- */
-declare const readFileSync: <O extends ReadFileOptions<keyof typeof decompressionMethods> | undefined = undefined>(path: URL | string, options?: O) => ContentType<O>;
-export default readFileSync;

package/dist/read/read-file.d.ts

@@ -1,41 +0,0 @@
-import type { ContentType, ReadFileOptions } from "../types.d.ts";
-type DecompressionMethod = (buffer: Buffer, callback: (error: Error | null, result: Buffer) => void) => void;
-declare const decompressionMethods: Record<string, DecompressionMethod>;
-/**
- * Asynchronously reads the entire contents of a file.
- * It can also decompress the file content if a `compression` option is provided.
- * @template O - The type of the options object, extending {@link ReadFileOptions}.
- * @param path The path to the file to read. Can be a file URL or a string path.
- * @param options Optional configuration for reading the file. See {@link ReadFileOptions}.
- * Available `compression` methods: "brotli", "gzip", "none" (default).
- * @returns A promise that resolves with the file content. The type of the content (string or Buffer)
- * depends on the `buffer` option (defaults to string if `buffer` is false or not set).
- * @example
- * ```javascript
- * import { readFile } from "@visulima/fs";
- * import { join } from "node:path";
- *
- * const readMyFile = async () => {
- *   try {
- *     // Read a regular text file
- *     const content = await readFile(join("path", "to", "my-file.txt"));
- *     console.log("File content:", content);
- *
- *     // Read a file as a Buffer
- *     const bufferContent = await readFile(join("path", "to", "another-file.bin"), { buffer: true });
- *     console.log("Buffer length:", bufferContent.length);
- *
- *     // Read and decompress a gzipped file
- *     // Assume my-archive.txt.gz exists
- *     // const decompressedContent = await readFile(join("path", "to", "my-archive.txt.gz"), { compression: "gzip", encoding: "utf8" });
- *     // console.log("Decompressed content:", decompressedContent);
- *   } catch (error) {
- *     console.error("Failed to read file:", error);
- *   }
- * };
- *
- * readMyFile();
- * ```
- */
-declare const readFile: <O extends ReadFileOptions<keyof typeof decompressionMethods> | undefined = undefined>(path: URL | string, options?: O) => Promise<ContentType<O>>;
-export default readFile;

package/dist/read/read-json-sync.d.ts

@@ -1,5 +0,0 @@
-import type { JsonValue } from "type-fest";
-import type { JsonReviver, ReadJsonOptions } from "../types.d.ts";
-declare function readJsonSync<T extends JsonValue>(path: URL | string, options?: ReadJsonOptions): T;
-declare function readJsonSync<T extends JsonValue>(path: URL | string, reviver: JsonReviver, options?: ReadJsonOptions): T;
-export default readJsonSync;

package/dist/read/read-json.d.ts

@@ -1,5 +0,0 @@
-import type { JsonValue } from "type-fest";
-import type { JsonReviver, ReadJsonOptions } from "../types.d.ts";
-declare function readJson<T extends JsonValue>(path: URL | string, options?: ReadJsonOptions): Promise<T>;
-declare function readJson<T extends JsonValue>(path: URL | string, reviver: JsonReviver, options?: ReadJsonOptions): Promise<T>;
-export default readJson;

package/dist/read/read-yaml-sync.d.ts

@@ -1,4 +0,0 @@
-import type { CompressionType, ReadYamlOptions, YamlReviver } from "../types.d.ts";
-declare function readYamlSync<R = Record<string, unknown>>(path: URL | string, options?: ReadYamlOptions<CompressionType>): R;
-declare function readYamlSync<R = Record<string, unknown>>(path: URL | string, reviver?: YamlReviver, options?: ReadYamlOptions<CompressionType>): R;
-export default readYamlSync;

package/dist/read/read-yaml.d.ts

@@ -1,4 +0,0 @@
-import type { CompressionType, ReadYamlOptions, YamlReviver } from "../types.d.ts";
-declare function readYaml<R = Record<string, unknown>>(path: URL | string, options?: ReadYamlOptions<CompressionType>): Promise<R>;
-declare function readYaml<R = Record<string, unknown>>(path: URL | string, reviver?: YamlReviver, options?: ReadYamlOptions<CompressionType>): Promise<R>;
-export default readYaml;

package/dist/remove/empty-dir-sync.d.ts

@@ -1,23 +0,0 @@
-import type { RetryOptions } from "../types.d.ts";
-/**
- * Ensures that a directory is empty.
- * Deletes directory contents if the directory is not empty.
- * If the directory does not exist, it is created.
- * The directory itself is not deleted.
- * @param dir The path to the directory to empty.
- * @param options Optional configuration for the operation. See {@link RetryOptions}.
- * @example
- * ```javascript
- * import { emptyDirSync } from "@visulima/fs";
- * import { join } from "node:path";
- *
- * try {
- *   emptyDirSync(join("/tmp", "my-app-temp"));
- *   console.log("Temporary directory emptied or created.");
- * } catch (error) {
- *   console.error("Failed to empty directory:", error);
- * }
- * ```
- */
-declare const emptyDirSync: (dir: URL | string, options?: RetryOptions) => void;
-export default emptyDirSync;

package/dist/remove/empty-dir.d.ts

@@ -1,28 +0,0 @@
-import type { RetryOptions } from "../types.d.ts";
-/**
- * Ensures that a directory is empty.
- * Deletes directory contents if the directory is not empty.
- * If the directory does not exist, it is created.
- * The directory itself is not deleted.
- * @param dir The path to the directory to empty.
- * @param options Optional configuration for the operation. See {@link RetryOptions}.
- * @returns A promise that resolves when the directory is empty.
- * @example
- * ```javascript
- * import { emptyDir } from "@visulima/fs";
- * import { join } from "node:path";
- *
- * const clearTempDir = async () => {
- *   try {
- *     await emptyDir(join("/tmp", "my-app-temp"));
- *     console.log("Temporary directory emptied or created.");
- *   } catch (error) {
- *     console.error("Failed to empty directory:", error);
- *   }
- * };
- *
- * clearTempDir();
- * ```
- */
-declare const emptyDir: (dir: URL | string, options?: RetryOptions) => Promise<void>;
-export default emptyDir;

package/dist/remove/remove-sync.d.ts

@@ -1,27 +0,0 @@
-import type { RetryOptions } from "../types.d.ts";
-/**
- * Synchronously removes a file or directory (recursively).
- * If the path does not exist, it does nothing.
- * @param path The path to the file or directory to remove.
- * @param options Optional configuration for the operation. See {@link RetryOptions}.
- * @example
- * ```javascript
- * import { removeSync } from "@visulima/fs";
- * import { join } from "node:path";
- *
- * try {
- *   removeSync(join("/tmp", "my-file.txt"));
- *   console.log("File /tmp/my-file.txt removed.");
- *
- *   removeSync(join("/tmp", "my-empty-dir"));
- *   console.log("Directory /tmp/my-empty-dir removed.");
- *
- *   removeSync(join("/tmp", "my-dir-with-contents"));
- *   console.log("Directory /tmp/my-dir-with-contents and its contents removed.");
- * } catch (error) {
- *   console.error("Failed to remove path:", error);
- * }
- * ```
- */
-declare const removeSync: (path: URL | string, options?: RetryOptions) => void;
-export default removeSync;

package/dist/remove/remove.d.ts

@@ -1,32 +0,0 @@
-import type { RetryOptions } from "../types.d.ts";
-/**
- * Asynchronously removes a file or directory (recursively).
- * If the path does not exist, it does nothing.
- * @param path The path to the file or directory to remove.
- * @param options Optional configuration for the operation. See {@link RetryOptions}.
- * @returns A promise that resolves when the path has been removed.
- * @example
- * ```javascript
- * import { remove } from "@visulima/fs";
- * import { join } from "node:path";
- *
- * const deleteFileOrDir = async () => {
- *   try {
- *     await remove(join("/tmp", "my-file.txt"));
- *     console.log("File /tmp/my-file.txt removed.");
- *
- *     await remove(join("/tmp", "my-empty-dir"));
- *     console.log("Directory /tmp/my-empty-dir removed.");
- *
- *     await remove(join("/tmp", "my-dir-with-contents"));
- *     console.log("Directory /tmp/my-dir-with-contents and its contents removed.");
- *   } catch (error) {
- *     console.error("Failed to remove path:", error);
- *   }
- * };
- *
- * deleteFileOrDir();
- * ```
- */
-declare const remove: (path: URL | string, options?: RetryOptions) => Promise<void>;
-export default remove;