path-class 0.14.0 → 0.15.0

package/dist/lib/path-class/Path.d.ts

@@ -1,4 +1,5 @@
 import { appendFile, chmod, cp, mkdir, rm, symlink, writeFile } from "node:fs/promises";
+import { type IgnoreAutoGeneratedFilesOptions } from "./emptyish";
 import { type WriteJSONOptions } from "./json";
 import type { lstatType, readDirType, readFileType, statType } from "./modifiedNodeTypes";
 type WritableData = Parameters<typeof writeFile>[1] | ReadableStream | Response;
@@ -275,6 +276,52 @@ export declare class Path {
      */
     writeJSON<T>(data: T, options?: WriteJSONOptions): Promise<Path>;
     readDir: typeof readDirType;
+    /**
+     * - Returns false if the path does not exists.
+     * - Throws an error if the path exists as a file rather than a dir.
+     */
+    isEmptyDir(options?: IgnoreAutoGeneratedFilesOptions): Promise<boolean>;
+    /**
+     * Equivalent to:
+     *
+     * ```
+     * .isEmptyDir({
+     *   ignoreOSAutogeneratedFiles: true,
+     * })
+     * ```
+     *
+     * Note that this ignores common files automatically created by the operating
+     * system. These are *often* vestigial and unnecessary, but may occasionally
+     * be important to the user (e.g. an icon for an empty folder, or folder
+     * layout information that will be used once files are added atain).
+     *
+     * There is no general way to tell whether a given folder is "safe" to delete,
+     * but this can be a useful heuristic to tell whether a folder is "actually"
+     * empty when it is fully managed by the calling program and otherwise empty.
+     *
+     * - Returns `false` if the path does not exists.
+     * - Throws an error if the path exists as a file rather than a dir.
+     */
+    isEmptyishDir(): Promise<boolean>;
+    /**
+     * A wrapper around `.rmDir()` that ignores files according to
+     * `.isEmptyishDir()`.
+     *
+     * Note that this ignores common files automatically created by the operating
+     * system. These are *often* vestigial and unnecessary, but may occasionally
+     * be important to the user (e.g. an icon for an empty folder, or folder
+     * layout information that will be used once files are added atain).
+     *
+     * There is no general way to tell whether a given folder is "safe" to delete,
+     * but this can be a useful heuristic to tell whether a folder is "actually"
+     * empty when it is fully managed by the calling program and otherwise empty.
+     *
+     * - Returns `true` if the directory was removed.
+     * - Returns `false` if the directory is not emptyish.
+     * - Returns `false` if the path does not exists.
+     * - Throws an error if the path exists as a file rather than a dir.
+     */
+    rmDirIfEmptyish(): Promise<boolean>;
     /** Returns the destination path. */
     symlink(target: string | URL | Path, type?: Parameters<typeof symlink>[2]): Promise<Path>;
     realpath(): Promise<Path>;

package/dist/lib/path-class/chunks/{chunk-THKWY3VT.js → chunk-DIQ7KWIN.js}

@@ -25,6 +25,42 @@ import { createInterface } from "node:readline/promises";
 import { Readable } from "node:stream";
 import { fileURLToPath, pathToFileURL } from "node:url";
 
+// src/emptyish.ts
+var MACOS_DOT_DS_STORE = ".DS_Store";
+var MACOS_ICON_PATH = "Icon\r";
+var WINDOWS_THUMBS_DOT_DB = "Thumbs.db";
+var WINDOWS_DESKTOP_INI = "Desktop.ini";
+var ALL_KNOWN_AUTOGENERATED_FILES = [
+  MACOS_DOT_DS_STORE,
+  MACOS_ICON_PATH,
+  WINDOWS_THUMBS_DOT_DB,
+  WINDOWS_DESKTOP_INI
+];
+function removeAutogeneratedFileEntries(entries, options) {
+  const ignore = options?.ignoreOSAutogeneratedFiles ?? {};
+  {
+    if (ignore === true || ignore?.macOS === true || ignore.macOS?.dotDSStore) {
+      entries.delete(MACOS_DOT_DS_STORE);
+    }
+    if (ignore === true || ignore?.macOS === true || ignore.macOS?.iconPath) {
+      entries.delete(MACOS_ICON_PATH);
+    }
+  }
+  {
+    if (ignore === true || ignore?.windows === true || ignore.windows?.ThumbsDotDB) {
+      entries.delete(WINDOWS_THUMBS_DOT_DB);
+    }
+    if (ignore === true || ignore?.windows === true || ignore.windows?.DesktopDotIni) {
+      entries.delete(WINDOWS_DESKTOP_INI);
+    }
+  }
+}
+function isEmptyExceptForAutoGeneratedFiles(entries, options) {
+  const entriesSet = new Set(entries);
+  removeAutogeneratedFileEntries(entriesSet, options);
+  return entriesSet.size === 0;
+}
+
 // src/json.ts
 var JSON_WRITE_DEFAULTS = {
   replacer: null,
@@ -674,6 +710,73 @@ var Path = class _Path {
     // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.
     readdir(this.#path, options)
   );
+  /**
+   * - Returns false if the path does not exists.
+   * - Throws an error if the path exists as a file rather than a dir.
+   */
+  // TODO: return `false` when the path is a file?
+  async isEmptyDir(options) {
+    if (!this.existsAsDir()) {
+      return false;
+    }
+    return isEmptyExceptForAutoGeneratedFiles(await this.readDir(), options);
+  }
+  /**
+   * Equivalent to:
+   *
+   * ```
+   * .isEmptyDir({
+   *   ignoreOSAutogeneratedFiles: true,
+   * })
+   * ```
+   *
+   * Note that this ignores common files automatically created by the operating
+   * system. These are *often* vestigial and unnecessary, but may occasionally
+   * be important to the user (e.g. an icon for an empty folder, or folder
+   * layout information that will be used once files are added atain).
+   *
+   * There is no general way to tell whether a given folder is "safe" to delete,
+   * but this can be a useful heuristic to tell whether a folder is "actually"
+   * empty when it is fully managed by the calling program and otherwise empty.
+   *
+   * - Returns `false` if the path does not exists.
+   * - Throws an error if the path exists as a file rather than a dir.
+   */
+  async isEmptyishDir() {
+    return this.isEmptyDir({
+      ignoreOSAutogeneratedFiles: true
+    });
+  }
+  /**
+   * A wrapper around `.rmDir()` that ignores files according to
+   * `.isEmptyishDir()`.
+   *
+   * Note that this ignores common files automatically created by the operating
+   * system. These are *often* vestigial and unnecessary, but may occasionally
+   * be important to the user (e.g. an icon for an empty folder, or folder
+   * layout information that will be used once files are added atain).
+   *
+   * There is no general way to tell whether a given folder is "safe" to delete,
+   * but this can be a useful heuristic to tell whether a folder is "actually"
+   * empty when it is fully managed by the calling program and otherwise empty.
+   *
+   * - Returns `true` if the directory was removed.
+   * - Returns `false` if the directory is not emptyish.
+   * - Returns `false` if the path does not exists.
+   * - Throws an error if the path exists as a file rather than a dir.
+   */
+  async rmDirIfEmptyish() {
+    if (await this.isEmptyishDir()) {
+      await Promise.all([
+        ALL_KNOWN_AUTOGENERATED_FILES.map(
+          (path) => this.join(path).rm({ force: true })
+        )
+      ]);
+      await this.rmDir();
+      return true;
+    }
+    return false;
+  }
   /** Returns the destination path. */
   async symlink(target, type) {
     const targetPath = new _Path(target);
@@ -776,6 +879,8 @@ function stringifyIfPath(value) {
 }
 
 export {
+  ALL_KNOWN_AUTOGENERATED_FILES,
+  isEmptyExceptForAutoGeneratedFiles,
   jsonChunks,
   stringifyIfPath,
   ResolutionPrefix,
@@ -783,4 +888,4 @@ export {
   AsyncDisposablePath,
   mustNotHaveTrailingSlash
 };
-//# sourceMappingURL=chunk-THKWY3VT.js.map
+//# sourceMappingURL=chunk-DIQ7KWIN.js.map

package/dist/lib/path-class/chunks/chunk-DIQ7KWIN.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/Path.ts", "../../../../src/emptyish.ts", "../../../../src/json.ts", "../../../../src/xdg.ts", "../../../../src/stringifyfIfPath.ts"],
+  "sourcesContent": ["import { createReadStream } from \"node:fs\";\nimport {\n  appendFile,\n  chmod,\n  constants,\n  cp,\n  lstat,\n  mkdir,\n  mkdtemp,\n  readdir,\n  readFile,\n  realpath,\n  rename,\n  rm,\n  rmdir,\n  stat,\n  symlink,\n  writeFile,\n} from \"node:fs/promises\";\nimport { homedir, tmpdir } from \"node:os\";\nimport { basename, dirname, extname, join } from \"node:path\";\nimport { cwd } from \"node:process\";\nimport { createInterface } from \"node:readline/promises\";\nimport { Readable } from \"node:stream\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport {\n  ALL_KNOWN_AUTOGENERATED_FILES,\n  type IgnoreAutoGeneratedFilesOptions,\n  isEmptyExceptForAutoGeneratedFiles,\n} from \"./emptyish\";\nimport { jsonChunks, type WriteJSONOptions } from \"./json\";\nimport type {\n  lstatType,\n  readDirType,\n  readFileType,\n  statType,\n} from \"./modifiedNodeTypes\";\nimport { stringifyIfPath } from \"./stringifyfIfPath\";\nimport { xdg } from \"./xdg\";\n\n// Note that (non-static) functions in this file are defined using `function(\u2026)\n// { \u2026 }` rather than arrow functions, specifically because we want `this` to\n// operate on the `Path` instance.\n\ntype WritableData = Parameters<typeof writeFile>[1] | ReadableStream | Response;\nasync function wrangleWritableData(\n  data: WritableData | Promise<WritableData>,\n): Promise<Parameters<typeof writeFile>[1]> {\n  data = await data;\n  if (data instanceof Response) {\n    data = data.body ? Readable.fromWeb(data.body) : new Uint8Array(0);\n  }\n  if (data instanceof ReadableStream) {\n    data = Readable.fromWeb(data);\n  }\n  return data;\n}\n\nexport enum ResolutionPrefix {\n  Absolute = \"absolute\",\n  Relative = \"relative\",\n  Bare = \"bare\",\n}\n\nexport function resolutionPrefix(pathString: string): ResolutionPrefix {\n  if (pathString.startsWith(\"/\")) {\n    return ResolutionPrefix.Absolute;\n  } else if (pathString.startsWith(\"./\")) {\n    return ResolutionPrefix.Relative;\n  } else if (pathString.startsWith(\"../\")) {\n    return ResolutionPrefix.Relative;\n  } else if (pathString === \".\") {\n    return ResolutionPrefix.Relative;\n  } else if (pathString === \"..\") {\n    return ResolutionPrefix.Relative;\n  }\n  return ResolutionPrefix.Bare;\n}\n\nconst DEFAULT_TEMP_PREFIX = \"js-temp-\";\nconst DEFAULT_TEMP_FILE_NAME = \"file\";\n\nfunction preserveRelativeResolutionPrefix(\n  pathString: string,\n  from: string,\n): string {\n  if (\n    resolutionPrefix(from) === ResolutionPrefix.Relative &&\n    resolutionPrefix(pathString) !== ResolutionPrefix.Relative\n  ) {\n    // We don't have to handle the case of `\".\"`, as it already starts with `\".\"`\n    return `./${pathString}`;\n  }\n  return pathString;\n}\n\nfunction joinPreservingRelativeResolutionPrefix(\n  base: string,\n  relative: string[],\n): string {\n  return preserveRelativeResolutionPrefix(join(base, ...relative), base);\n}\n\nexport class Path {\n  // @ts-expect-error ts(2564): False positive. https://github.com/microsoft/TypeScript/issues/32194\n  #path: string;\n  /**\n   * If `path` is a string starting with `file:///`, it will be parsed as a file URL.\n   */\n  constructor(path: string | URL | Path) {\n    const s = Path.#pathlikeToString(path);\n    this.#setNormalizedPath(s);\n  }\n\n  static #pathlikeToString(path: string | URL | Path): string {\n    if (path instanceof Path) {\n      return path.#path;\n    }\n    if (path instanceof URL) {\n      return fileURLToPath(path);\n    }\n    if (typeof path === \"string\") {\n      // TODO: allow turning off this heuristic?\n      if (path.startsWith(\"file:///\")) {\n        return fileURLToPath(path);\n      }\n      return path;\n    }\n    throw new Error(\"Invalid path\");\n  }\n\n  // Preserves the `ResolutionPrefix` status when possible.\n  #setNormalizedPath(path: string): void {\n    this.#path = joinPreservingRelativeResolutionPrefix(path, []);\n  }\n  static fromString(s: string): Path {\n    if (typeof s !== \"string\") {\n      throw new Error(\n        \"Invalid argument to `Path.fromString(\u2026)` \u2014 expected a string.\",\n      );\n    }\n    return new Path(s);\n  }\n\n  get resolutionPrefix(): ResolutionPrefix {\n    return resolutionPrefix(this.#path);\n  }\n\n  /**\n   * Similar to `new URL(path, base)`, but accepting and returning `Path` objects.\n   * Note that `base` must be one of:\n   *\n   * - a valid second argument to `new URL(\u2026)`.\n   * - a `Path` representing an absolute path.\n   *\n   */\n  static resolve(path: string | URL | Path, base: string | URL | Path): Path {\n    const baseURL = (() => {\n      if (!(base instanceof Path)) {\n        if (typeof base === \"string\" && !base.startsWith(\"file://\")) {\n          return pathToFileURL(base);\n        }\n        return base;\n      }\n      if (!base.isAbsolutePath()) {\n        throw new Error(\n          \"The `base` arg to `Path.resolve(\u2026)` must be an absolute path.\",\n        );\n      }\n      return pathToFileURL(base.#path);\n    })();\n    return new Path(new URL(Path.#pathlikeToString(path), baseURL));\n  }\n\n  /**\n   * Convenience function. The following are equivalent:\n   *\n   *     B.resolve(A);\n   *     Path.resolve(A, B);\n   *\n   */\n  resolve(path: string | URL | Path): Path {\n    return Path.resolve(path, this);\n  }\n\n  /**\n   * Computes the relative path from an ancestor (this) to another path.\n   *\n   * - If the path is a descendant *or is the same path*, this returns a\n   *   relative path. Call {@link Path.asBare `.asBare()`} on the output if\n   *   needed.\n   * - The output is `null` unless the input paths are:\n   *   - Both absolute paths.\n   *   - Both relative paths. Resolve the paths before passing to this function\n   *     if needed.\n   * - Trailing slashes:\n   *   - By default, the ancestor path must have a trailing slash for the\n   *     function to be called. Pass `{ requireTrailingSlashForAncestor: false\n   *     }` if needed. Note that recombining the ancestor path with the output\n   *     using {@link Path.prototype.resolve `.resolve(\u2026)` } does not result in\n   *     the original input path if the ancestor path did not have a trailing\n   *     slash.\n   *   - For the descendant/same path check, trailing slashes are ignored. In\n   *     particular, if the ancestor path has a trailing slash and the\n   *     descendant path is the same path without a trailing slash, this is\n   *     still considered to be the same path.\n   *   - The output has trailing slash if and only if:\n   *       - the input descendant does, or\n   *       - the output is the absolute path `/`.\n   */\n  descendantRelativePath(\n    potentialDescendant: string | URL | Path,\n    options?: { requireTrailingSlashForAncestor: boolean },\n  ): Path | null {\n    const requireTrailingSlashForAncestor =\n      options?.requireTrailingSlashForAncestor ?? true;\n    if (requireTrailingSlashForAncestor && !this.hasTrailingSlash()) {\n      throw new Error(\n        \"Ancestor must have a trailing slash. Pass `{ requireTrailingSlashForAncestor: false }` if needed.\",\n      );\n    }\n\n    const other = new Path(potentialDescendant);\n    if (this.isAbsolutePath() !== other.isAbsolutePath()) {\n      return null;\n    }\n\n    // Leading slashes are okay, as they will result in a `\"\"` component for\n    // absolute paths (and we don't compare absolute paths to relative paths.)\n    const thisParts = this.toggleTrailingSlash(false).#path.split(\"/\");\n    const otherParts = other.toggleTrailingSlash(false).#path.split(\"/\");\n\n    if (otherParts.length < thisParts.length) {\n      return null;\n    }\n    for (let i = 0; i < thisParts.length; i++) {\n      if (thisParts[i] !== otherParts[i]) {\n        return null;\n      }\n    }\n    return new Path(\"./\")\n      .join(...otherParts.slice(thisParts.length))\n      .toggleTrailingSlash(other.hasTrailingSlash());\n  }\n\n  unresolve(path: string | URL | Path): Path {\n    return Path.resolve(path, this);\n  }\n\n  isAbsolutePath(): boolean {\n    return this.resolutionPrefix === ResolutionPrefix.Absolute;\n  }\n\n  toFileURL(): URL {\n    if (!this.isAbsolutePath()) {\n      throw new Error(\n        \"Tried to convert to file URL when the path is not absolute.\",\n      );\n    }\n    return pathToFileURL(this.#path);\n  }\n\n  /**\n   * The `Path` can have a trailing slash, indicating that it represents a\n   * directory. (If there is no trailing slash, it can represent either a file\n   * or a directory.)\n   *\n   * Some operations will refuse to treat a directory path as a file path. This\n   * function identifies such paths.\n   */\n  hasTrailingSlash(): boolean {\n    // TODO: handle Windows semantically\n    return this.#path.endsWith(\"/\");\n  }\n\n  /**\n   * Toggles or sets a trailing slash as specified.\n   * If the path is `/`, it will always be left as-is.\n   */\n  // Similar convention to:\n  // https://developer.mozilla.org/en-US/docs/Web/API/DOMTokenList/toggle Most\n  // use cases will probably use the `force` parameters, but supporting the\n  // \"toggle\" use case is easy to implement and hopefully will make the name\n  // and API more familiar to web devs.\n  toggleTrailingSlash(force?: boolean): Path {\n    if (this.#path === \"/\") {\n      return this;\n    }\n    const wantTrailingSlash = force ?? !this.hasTrailingSlash();\n    if (wantTrailingSlash) {\n      return this.hasTrailingSlash() ? this : this.join(\"./\");\n    } else {\n      return this.hasTrailingSlash() ? new Path(this.#path.slice(0, -1)) : this;\n    }\n  }\n\n  /**\n   * Same as `.toString()`, but more concise.\n   */\n  get path() {\n    return this.#path;\n  }\n\n  toString(): string {\n    return this.#path;\n  }\n\n  /**\n   * Format this with the escape codes for printing to the shell in bold blue.\n   *\n   * Example usage:\n   *\n   *     console.log(`Processing: ${path.blue}`)\n   *\n   */\n  get blue() {\n    const { styleText } = globalThis.process.getBuiltinModule(\"node:util\");\n    return styleText([\"bold\", \"blue\"], this.#path);\n  }\n\n  /** Constructs a new path by appending the given path segments.\n   * This follows `node` semantics for absolute paths: leading slashes in the given descendant segments are ignored.\n   */\n  join(...segments: (string | Path)[]): Path {\n    const segmentStrings = segments.map((segment) => {\n      const s = stringifyIfPath(segment);\n      if (resolutionPrefix(s) === ResolutionPrefix.Absolute) {\n        throw new Error(\n          \"Arguments to `.join(\u2026)` cannot be absolute. Use `.asRelative()` to convert them first if needed.\",\n        );\n      }\n      return s;\n    });\n    return new Path(\n      joinPreservingRelativeResolutionPrefix(this.#path, segmentStrings),\n    );\n  }\n\n  /**\n   * Adjust the prefix to construct a relative path.\n   *\n   * | Example input   | Output          |\n   * |-----------------|-----------------|\n   * | `\"bare\"`        | `\"./bare\"`      |\n   * | `\"./relative\"`  | `\"./relative\"`  |\n   * | `\"../up-first\"` | `\"../up-first\"` |\n   * | `\"/absolute\"`   | `\"./absolute\"`  |\n   *\n   */\n  asRelative(): Path {\n    return new Path(`./${this.#path}`);\n  }\n\n  /**\n   * Adjust the prefix to construct an absolute path.\n   *\n   * | Example input   | Output        |\n   * |-----------------|---------------|\n   * | `\"bare\"`        | `\"/bare\"`     |\n   * | `\"./relative\"`  | `\"/relative\"` |\n   * | `\"../up-first\"` | `\"/up-first\"` |\n   * | `\"/absolute\"`   | `\"/absolute\"` |\n   *\n   */\n  asAbsolute(): Path {\n    return new Path(join(\"/\", this.#path));\n  }\n\n  /**\n   * Adjust the prefix to construct a bare path. Note that this returns `\".\"` if\n   * there are no named paths left.\n   *\n   * | Example input     | Output       |\n   * |-------------------|--------------|\n   * | `\"bare\"`          | `\"bare\"`     |\n   * | `\"./relative\"  `  | `\"relative\"` |\n   * | `\"/absolute\"`     | `\"absolute\"` |\n   * | `\".\"`             | `\".\"`        |\n   * | `\"down-first/..\"` | `\".\"`        |\n   * | `\"../up-first\"`   | (error)      |\n   * | `\"..\"`            | (error)      |\n   *\n   * Specify `parentTraversalPrefixHandling` in the `options` if you would like\n   * to strip or keep resolution prefixes like `../` rather than erroring.\n   *\n   * | Example input        | Output with `{ parentTraversalPrefixHandling: \"strip\" }` |\n   * |----------------------|----------------------------------------------------------|\n   * | `\"../up-first\"`      | `\"up-first\"`                                             |\n   * | `\"..\"`               | `\".\"`                                                    |\n   *\n   * | Example input        | Output with `{ parentTraversalPrefixHandling: \"keep\" }` |\n   * |----------------------|---------------------------------------------------------|\n   * | `\"../up-first\"`      | `\"../up-first\"`                                         |\n   * | `\"..\"`               | `\"..\"`                                                  |\n   *\n   * If you need the output to start with a named component and return values\n   * like `.`, `..`, `../`, or `../\u2026` are not okay, pass\n   * `requireNamedComponentPrefix: true`. This is useful if the path represents\n   * an `npm`-style package name (e.g. `\"typescript\"`, `\"@biomejs/biome\"`).\n   *\n   */\n  asBare(options?: {\n    parentTraversalPrefixHandling?: \"error\" | \"strip\" | \"keep\";\n    requireNamedComponentPrefix?: boolean;\n  }): Path {\n    const path = new Path(join(\".\", this.#path));\n    if (!path.#path.startsWith(\"../\") && path.#path !== \"..\") {\n      if (\n        options?.requireNamedComponentPrefix &&\n        path.resolutionPrefix === ResolutionPrefix.Relative\n      ) {\n        throw new Error(\"Output does not start with a named component.\");\n      }\n      return path;\n    }\n    const parentTraversalHandling =\n      options?.parentTraversalPrefixHandling ?? \"error\";\n    switch (parentTraversalHandling) {\n      case \"error\": {\n        throw new Error(\n          'Converting path to a bare path resulted in a `..` traversal prefix. Pass `\"strip\"` or `\"keep\"` as the `parentTraversalHandling` option to avoid an error.',\n        );\n      }\n      case \"strip\": {\n        let newPath = path.#path.replace(/^(\\.\\.\\/)+/, \"\");\n        if ([\"\", \"..\"].includes(newPath)) {\n          newPath = \".\";\n        }\n        const output = new Path(newPath);\n        if (\n          options?.requireNamedComponentPrefix &&\n          output.resolutionPrefix === ResolutionPrefix.Relative\n        ) {\n          throw new Error(\"Output does not start with a named component.\");\n        }\n        return new Path(newPath);\n      }\n      case \"keep\": {\n        if (options?.requireNamedComponentPrefix) {\n          throw new Error(\"Output does not start with a named component.\");\n        }\n        return path;\n      }\n    }\n  }\n\n  extendBasename(suffix: string): Path {\n    const joinedSuffix = join(suffix);\n    if (joinedSuffix !== basename(joinedSuffix)) {\n      throw new Error(\"Invalid suffix to extend file name.\");\n    }\n    // TODO: join basename and dirname instead?\n    return new Path(this.#path + joinedSuffix);\n  }\n\n  get parent(): Path {\n    return new Path(dirname(this.#path));\n  }\n\n  // Normally I'd stick with `node`'s name, but I think `.dirname` is a\n  // particularly poor name. So we support `.dirname` for discovery but mark it\n  // as deprecated, even if it will never be removed.\n  /** @deprecated Alias for `.parent`. */\n  get dirname(): Path {\n    return this.parent;\n  }\n\n  get basename(): Path {\n    return new Path(basename(this.#path));\n  }\n\n  get extension(): string {\n    mustNotHaveTrailingSlash(this);\n    return extname(this.#path);\n  }\n\n  // Normally I'd stick with `node`'s name, but I think `.extname` is a\n  // particularly poor name. So we support `.extname` for discovery but mark it\n  // as deprecated, even if it will never be removed.\n  /** @deprecated Alias for `.extension`. */\n  get extname(): string {\n    return this.extension;\n  }\n\n  // TODO: find a neat way to dedup with the sync version?\n  async exists(constraints?: {\n    mustBe: \"file\" | \"directory\";\n  }): Promise<boolean> {\n    if (constraints?.mustBe === \"file\") {\n      mustNotHaveTrailingSlash(this);\n    }\n    let stats: Awaited<ReturnType<typeof stat>>;\n    try {\n      stats = await stat(this.#path);\n      // biome-ignore lint/suspicious/noExplicitAny: TypeScript limitation\n    } catch (e: any) {\n      if (e.code === \"ENOENT\") {\n        return false;\n      }\n      throw e;\n    }\n    if (!constraints?.mustBe) {\n      return true;\n    }\n    switch (constraints?.mustBe) {\n      case \"file\": {\n        if (stats.isFile()) {\n          return true;\n        }\n        throw new Error(`Path exists but is not a file: ${this.#path}`);\n      }\n      case \"directory\": {\n        if (stats.isDirectory()) {\n          return true;\n        }\n        throw new Error(`Path exists but is not a directory: ${this.#path}`);\n      }\n      default: {\n        throw new Error(\"Invalid path type constraint\");\n      }\n    }\n  }\n\n  async existsAsFile(): Promise<boolean> {\n    return this.exists({ mustBe: \"file\" });\n  }\n\n  async existsAsDir(): Promise<boolean> {\n    return this.exists({ mustBe: \"directory\" });\n  }\n\n  // I don't think `mkdir` is a great name, but it does match the\n  // well-established canonical commandline name. So in this case we keep the\n  // awkward abbreviation.\n  /** Defaults to `recursive: true`. */\n  async mkdir(options?: Parameters<typeof mkdir>[1]): Promise<Path> {\n    const optionsObject = (() => {\n      if (typeof options === \"string\" || typeof options === \"number\") {\n        return { mode: options };\n      }\n      return options ?? {};\n    })();\n    await mkdir(this.#path, { recursive: true, ...optionsObject });\n    return this;\n  }\n\n  // TODO: check idempotency semantics when the destination exists and is a folder.\n  /** Returns the destination path. */\n  async cp(\n    destination: string | URL | Path,\n    options?: Parameters<typeof cp>[2] & { createIntermediateDirs?: boolean },\n  ): Promise<Path> {\n    const { createIntermediateDirs, ...cpOptions } = options ?? {};\n    const destinationPath = new Path(destination);\n    if (createIntermediateDirs ?? true) {\n      await destinationPath.parent.mkdir();\n    }\n    await cp(this.#path, destinationPath.#path, cpOptions);\n    return destinationPath;\n  }\n\n  // TODO: check idempotency semantics when the destination exists and is a folder.\n  async rename(\n    destination: string | URL | Path,\n    options?: { createIntermediateDirs?: boolean },\n  ): Promise<Path> {\n    const destinationPath = new Path(destination);\n    if (options?.createIntermediateDirs ?? true) {\n      await destinationPath.parent.mkdir();\n    }\n    await rename(this.#path, destinationPath.#path);\n    return destinationPath;\n  }\n\n  /**\n   * Create a temporary dir inside the global temp dir for the current user.\n   *\n   * This can be used with [`await\n   * using`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/await_using)\n   * to automatically delete the dir when it goes out of scope.\n   *\n   *     {\n   *       await using tempDir = await Path.makeTempDir();\n   *       // Temporary dir exists while we're inside this block.\n   *     }\n   *     // Temporary dir has now been deleted.\n   *\n   * Note that (due to the semantics of JS runtime implementations) this does\n   * not delete the temp dir if the process calls `exit(\u2026)` before the `using`\n   * goes out of scope.\n   *\n   * */\n  static async makeTempDir(prefix?: string): Promise<AsyncDisposablePath> {\n    return new AsyncDisposablePath(\n      await mkdtemp(\n        new Path(tmpdir()).join(prefix ?? DEFAULT_TEMP_PREFIX).toString(),\n      ),\n    );\n  }\n\n  /**\n   * Return a path:\n   *\n   * - whose parent dir is a temp dir that *has* been created, but\n   * - which has itself not yet been created.\n   *\n   * Note that this path can actually also be used to create dir, but it is most\n   * convenient to get a path for a temporary file that can be written to, while\n   * having a disposal implementation that cleans everything up:\n   *\n   *     await using tempFile = await Path.tempFilePath({ basename: \"foo.txt\" });\n   *     await tempFile.write(\"hello world!\");\n   *     // \u2026\n   *\n   * Note that that the following are equivalent when *not* using `await using`:\n   *\n   *     await Path.tempFilePath({ basename: \"foo.txt\" });\n   *     (await Path.makeTempDir()).join(\"file.txt\");\n   *\n   * However, it is recommended to use `await using` to ensure cleanup.\n   */\n  static async tempFilePath(options: {\n    tempDirPrefix?: string;\n    basename?: string | Path;\n  }): Promise<AsyncDisposablePath> {\n    const tempDir = new Path(\n      await mkdtemp(\n        new Path(tmpdir())\n          .join(options?.tempDirPrefix ?? DEFAULT_TEMP_PREFIX)\n          .toString(),\n      ),\n    );\n    return new AsyncDisposablePath(\n      tempDir.join(options?.basename ?? DEFAULT_TEMP_FILE_NAME),\n      { disposePathInstead: tempDir },\n    );\n  }\n\n  async rm(options?: Parameters<typeof rm>[1]): Promise<void> {\n    await rm(this.#path, options);\n  }\n\n  async rmDir(): Promise<void> {\n    await rmdir(this.#path);\n  }\n\n  /**\n   * Equivalent to:\n   *\n   *     .rm({ recursive: true, force: true, ...(options ?? {}) })\n   *\n   */\n  async rm_rf(options?: Parameters<typeof rm>[1]): Promise<void> {\n    await this.rm({ recursive: true, force: true, ...(options ?? {}) });\n  }\n\n  read: typeof readFileType = (options) =>\n    // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.\n    readFile(this.#path, options as any) as any;\n\n  async readText(): Promise<string> {\n    return readFile(this.#path, \"utf-8\");\n  }\n\n  /**\n   * Yields one line from the text of the line at a time.\n   *\n   * This uses streams, so it can be considerably more efficient than calling e.g. `.split(\"\\n\")` on the output of {@link readText `.readText()`}.\n   *\n   * Note that this function does not have a `.readLinesSync()` counterpart.\n   */\n  async *readLines(): AsyncIterable<string> {\n    const stream = createReadStream(this.#path, \"utf-8\");\n    yield* createInterface({ input: stream, terminal: false });\n  }\n\n  /**\n   * Reads JSON from the given file and parses it. No validation is performed\n   * (beyond JSON parsing).\n   *\n   * An optional `fallback` value can be specified. It will be used if (and only\n   * if) the file does not exist.\n   *\n   */\n\n  // biome-ignore lint/suspicious/noExplicitAny: Allow a default of `any` to match `JSON.parse(\u2026)`.\n  async readJSON<T = any>(options?: { fallback?: T }): Promise<T> {\n    try {\n      return JSON.parse(await this.readText());\n    } catch (e) {\n      if (\n        (e as { code?: string }).code === \"ENOENT\" &&\n        options &&\n        \"fallback\" in options\n      ) {\n        return options.fallback as T;\n      }\n      throw e;\n    }\n  }\n\n  /**\n   * Returns the original `Path` (for chaining).\n   */\n  async appendFile(\n    data: Parameters<typeof appendFile>[1],\n    options?: Parameters<typeof appendFile>[2],\n  ): Promise<Path> {\n    await appendFile(this.#path, data, options);\n    return this;\n  }\n\n  /** Creates intermediate directories if they do not exist.\n   *\n   * Returns the original `Path` (for chaining).\n   */\n  async write(\n    data: WritableData | Promise<WritableData>,\n    options?: Parameters<typeof writeFile>[2],\n  ): Promise<Path> {\n    await this.parent.mkdir();\n    await writeFile(this.#path, await wrangleWritableData(data), options);\n    return this;\n  }\n\n  /**\n   * If only `data` is provided, this is equivalent to:\n   *\n   *     .write(JSON.stringify(data, null, \"  \"));\n   *\n   * `replacer` and `space` can also be specified, making this equivalent to:\n   *\n   *     .write(JSON.stringify(data, replacer, space));\n   *\n   * Returns the original `Path` (for chaining).\n   */\n  async writeJSON<T>(data: T, options?: WriteJSONOptions): Promise<Path> {\n    // TODO: file handle mechanism to avoid JSON serialization in memory.\n    await this.write(jsonChunks(data, options));\n    return this;\n  }\n\n  // Normally we'd add a `@deprecated` alias named `.readdir`, but that would\n  // differ only by capitalization of a single non-leading character. This can\n  // be a bit confusing, especially when autocompleting. So for this function in\n  // particular we don't include an alias.\n  readDir: typeof readDirType = (options) =>\n    // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.\n    readdir(this.#path, options as any) as any;\n\n  /**\n   * - Returns false if the path does not exists.\n   * - Throws an error if the path exists as a file rather than a dir.\n   */\n  // TODO: return `false` when the path is a file?\n  async isEmptyDir(\n    options?: IgnoreAutoGeneratedFilesOptions,\n  ): Promise<boolean> {\n    if (!this.existsAsDir()) {\n      return false;\n    }\n    return isEmptyExceptForAutoGeneratedFiles(await this.readDir(), options);\n  }\n\n  /**\n   * Equivalent to:\n   *\n   * ```\n   * .isEmptyDir({\n   *   ignoreOSAutogeneratedFiles: true,\n   * })\n   * ```\n   *\n   * Note that this ignores common files automatically created by the operating\n   * system. These are *often* vestigial and unnecessary, but may occasionally\n   * be important to the user (e.g. an icon for an empty folder, or folder\n   * layout information that will be used once files are added atain).\n   *\n   * There is no general way to tell whether a given folder is \"safe\" to delete,\n   * but this can be a useful heuristic to tell whether a folder is \"actually\"\n   * empty when it is fully managed by the calling program and otherwise empty.\n   *\n   * - Returns `false` if the path does not exists.\n   * - Throws an error if the path exists as a file rather than a dir.\n   */\n  async isEmptyishDir(): Promise<boolean> {\n    return this.isEmptyDir({\n      ignoreOSAutogeneratedFiles: true,\n    });\n  }\n\n  /**\n   * A wrapper around `.rmDir()` that ignores files according to\n   * `.isEmptyishDir()`.\n   *\n   * Note that this ignores common files automatically created by the operating\n   * system. These are *often* vestigial and unnecessary, but may occasionally\n   * be important to the user (e.g. an icon for an empty folder, or folder\n   * layout information that will be used once files are added atain).\n   *\n   * There is no general way to tell whether a given folder is \"safe\" to delete,\n   * but this can be a useful heuristic to tell whether a folder is \"actually\"\n   * empty when it is fully managed by the calling program and otherwise empty.\n   *\n   * - Returns `true` if the directory was removed.\n   * - Returns `false` if the directory is not emptyish.\n   * - Returns `false` if the path does not exists.\n   * - Throws an error if the path exists as a file rather than a dir.\n   */\n  async rmDirIfEmptyish(): Promise<boolean> {\n    if (await this.isEmptyishDir()) {\n      // TODO: doos any OS cause a race condition here, in practice?\n      await Promise.all([\n        ALL_KNOWN_AUTOGENERATED_FILES.map((path) =>\n          this.join(path).rm({ force: true }),\n        ),\n      ]);\n      await this.rmDir();\n      return true;\n    }\n    return false;\n  }\n\n  /** Returns the destination path. */\n  async symlink(\n    target: string | URL | Path,\n    type?: Parameters<typeof symlink>[2],\n  ): Promise<Path> {\n    const targetPath = new Path(target);\n    await symlink(\n      this.path,\n      targetPath.path,\n      type as Exclude<Parameters<typeof symlink>[2], undefined>, // \uD83E\uDD37\n    );\n    return targetPath;\n  }\n\n  // I don't think `realpath` is a great name, but it does match the\n  // well-established canonical commandline name. So in this case we keep the\n  // name instead of using `realPath`.\n  //\n  // Note: There are no options in our API, because the only option is an\n  // encoding. We set the encoding to construct the returned `Path`.\n  async realpath(): Promise<Path> {\n    return new Path(await realpath(this.#path, \"utf-8\"));\n  }\n\n  // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.\n  stat: typeof statType = (...options) => stat(this.#path, ...options) as any;\n\n  // I don't think `lstat` is a great name, but it does match the\n  // well-established canonical system call. So in this case we keep the\n  // awkward abbreviation.\n  lstat: typeof lstatType = (...options) =>\n    // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.\n    lstat(this.#path, ...options) as any;\n\n  async chmod(mode: Parameters<typeof chmod>[1]): Promise<Path> {\n    await chmod(this.#path, mode);\n    return this;\n  }\n\n  /**\n   * Add the executable bit (for everyone) to the given path without modifying other bits (`chmod +x`).\n   */\n  async chmodX(): Promise<Path> {\n    const { mode } = await this.stat();\n    await this.chmod(\n      mode | constants.S_IXUSR | constants.S_IXGRP | constants.S_IXOTH,\n    );\n    return this;\n  }\n\n  static get homedir(): Path {\n    return new Path(homedir());\n  }\n\n  /**\n   * Get the current working directory as a path. Always includes a trailing slash.\n   * Note that this computes the `cwd` from fresh every time, in case it has changed for the current process.\n   */\n  static get cwd(): Path {\n    return new Path(cwd()).toggleTrailingSlash(true);\n  }\n\n  static xdg = xdg;\n\n  /** Chainable function to print the path. Prints the same as:\n   *\n   *     if (args.length > 0) {\n   *      console.log(...args);\n   *     }\n   *     console.log(this.path);\n   *\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: This is the correct type, based on `console.log(\u2026)`.\n  debugPrint(...args: any[]): Path {\n    if (args.length > 0) {\n      console.log(...args);\n    }\n    console.log(this.#path);\n    return this;\n  }\n}\n\nexport class AsyncDisposablePath extends Path {\n  #options?: { disposePathInstead: Path };\n  constructor(\n    path: ConstructorParameters<typeof Path>[0],\n    options?: { disposePathInstead: Path | string },\n  ) {\n    super(path);\n    if (options) {\n      this.#options = {\n        disposePathInstead: new Path(options.disposePathInstead),\n      };\n    }\n  }\n\n  async [Symbol.asyncDispose]() {\n    await (this.#options?.disposePathInstead ?? this).rm_rf();\n  }\n}\n\nexport function mustNotHaveTrailingSlash(path: Path): void {\n  if (path.hasTrailingSlash()) {\n    throw new Error(\n      \"Path ends with a slash, which cannot be treated as a file.\",\n    );\n  }\n}\n", "const MACOS_DOT_DS_STORE = \".DS_Store\";\nconst MACOS_ICON_PATH = \"Icon\\r\";\nconst WINDOWS_THUMBS_DOT_DB = \"Thumbs.db\";\nconst WINDOWS_DESKTOP_INI = \"Desktop.ini\";\n\nexport const ALL_KNOWN_AUTOGENERATED_FILES = [\n  MACOS_DOT_DS_STORE,\n  MACOS_ICON_PATH,\n  WINDOWS_THUMBS_DOT_DB,\n  WINDOWS_DESKTOP_INI,\n];\n\nexport interface IgnoreAutoGeneratedFilesOptions {\n  ignoreOSAutogeneratedFiles?:\n    | true\n    | {\n        macOS?:\n          | true\n          | {\n              dotDSStore?: boolean;\n              iconPath?: boolean;\n            };\n        windows?:\n          | true\n          | {\n              // TODO: this can have alternative names?\n              ThumbsDotDB?: boolean;\n              DesktopDotIni?: boolean;\n            };\n        // TODO: anything common on Linux?\n      };\n}\n\n/**\n * Modifies the input `entries`.\n */\nfunction removeAutogeneratedFileEntries(\n  entries: Set<string>,\n  options?: IgnoreAutoGeneratedFilesOptions,\n) {\n  const ignore = options?.ignoreOSAutogeneratedFiles ?? {};\n\n  // biome-ignore lint/complexity/noUselessLoneBlockStatements: Grouping for legibility.\n  {\n    if (ignore === true || ignore?.macOS === true || ignore.macOS?.dotDSStore) {\n      entries.delete(MACOS_DOT_DS_STORE);\n    }\n    if (ignore === true || ignore?.macOS === true || ignore.macOS?.iconPath) {\n      entries.delete(MACOS_ICON_PATH);\n    }\n  }\n\n  // biome-ignore lint/complexity/noUselessLoneBlockStatements: Grouping for legibility.\n  {\n    if (\n      ignore === true ||\n      ignore?.windows === true ||\n      ignore.windows?.ThumbsDotDB\n    ) {\n      entries.delete(WINDOWS_THUMBS_DOT_DB);\n    }\n    if (\n      ignore === true ||\n      ignore?.windows === true ||\n      ignore.windows?.DesktopDotIni\n    ) {\n      entries.delete(WINDOWS_DESKTOP_INI);\n    }\n  }\n}\n\nexport function isEmptyExceptForAutoGeneratedFiles(\n  entries: Iterable<string>,\n  options?: IgnoreAutoGeneratedFilesOptions,\n) {\n  const entriesSet = new Set(entries);\n  removeAutogeneratedFileEntries(entriesSet, options);\n  return entriesSet.size === 0;\n}\n", "export interface WriteJSONOptions {\n  replacer?: Parameters<typeof JSON.stringify>[1];\n  space?: Parameters<typeof JSON.stringify>[2];\n  trailingNewline?: boolean;\n}\n\nconst JSON_WRITE_DEFAULTS: WriteJSONOptions = {\n  replacer: null,\n  space: \"  \",\n  trailingNewline: true,\n};\n\n/**\n * Returns an array of chunks, to ensure we don't perforn unnecessary in-memory concatenation before writing.\n */\nexport function jsonChunks<T>(data: T, options?: WriteJSONOptions): string[] {\n  const { replacer, space, trailingNewline } = {\n    ...JSON_WRITE_DEFAULTS,\n    ...options,\n  };\n  return [JSON.stringify(data, replacer, space), trailingNewline ? \"\\n\" : \"\"];\n}\n", "/** biome-ignore-all lint/complexity/useLiteralKeys: TODO: https://github.com/biomejs/biome/discussions/7572 */\n\nimport { Path } from \"./Path\";\n\nfunction env(): typeof import(\"node:process\").env {\n  const { env } = globalThis.process.getBuiltinModule(\"node:process\");\n  return env;\n}\n\nfunction varWithoutFallback(envVar: `XDG_${string}`): Path | undefined {\n  const value = env()[envVar];\n  return value ? Path.fromString(value) : undefined;\n}\n\nfunction varWithFallback(\n  envVar: `XDG_${string}`,\n  fallbackInHomeDir: string,\n): Path {\n  return varWithoutFallback(envVar) ?? Path.homedir.join(fallbackInHomeDir);\n}\n\n// This is a level of indirection to avoid accessing env vars or `homedir()`\n// until needed, to avoid permissions prompts / flags for `deno` when these are\n// not needed for the calling code.\n//\n// TODO: cache values?\nclass XDG {\n  get cache() {\n    return varWithFallback(\"XDG_CACHE_HOME\", \".cache\");\n  }\n  get config() {\n    return varWithFallback(\"XDG_CONFIG_HOME\", \".config\");\n  }\n  get data() {\n    return varWithFallback(\"XDG_DATA_HOME\", \".local/share\");\n  }\n  get state() {\n    return varWithFallback(\"XDG_STATE_HOME\", \".local/state\");\n  }\n  /**\n   * {@link Path.xdg.runtime} does not have a default value. Consider\n   * {@link Path.xdg.runtimeWithStateFallback} if you need a fallback but do not have a particular fallback in mind.\n   */\n  get runtime() {\n    return varWithoutFallback(\"XDG_RUNTIME_DIR\");\n  }\n  get runtimeWithStateFallback() {\n    return varWithoutFallback(\"XDG_RUNTIME_DIR\") ?? this.state;\n  }\n}\n\nexport const xdg = new XDG();\n", "import { Path } from \"./Path\";\n\n/**\n * This function is useful to serialize any `Path`s in a structure to pass on to\n * functions that do not know about the `Path` class, e.g.\n *\n *     function process(args: (string | Path)[]) {\n *       const argsAsStrings = args.map(stringifyIfPath);\n *     }\n *\n */\nexport function stringifyIfPath<T>(value: Exclude<T, Path> | Path): T | string {\n  if (value instanceof Path) {\n    return value.toString();\n  }\n  return value;\n}\n"],
+  "mappings": "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",
+  "names": ["env", "ResolutionPrefix"]
+}

package/dist/lib/path-class/emptyish.d.ts

@@ -0,0 +1,14 @@
+export declare const ALL_KNOWN_AUTOGENERATED_FILES: string[];
+export interface IgnoreAutoGeneratedFilesOptions {
+    ignoreOSAutogeneratedFiles?: true | {
+        macOS?: true | {
+            dotDSStore?: boolean;
+            iconPath?: boolean;
+        };
+        windows?: true | {
+            ThumbsDotDB?: boolean;
+            DesktopDotIni?: boolean;
+        };
+    };
+}
+export declare function isEmptyExceptForAutoGeneratedFiles(entries: Iterable<string>, options?: IgnoreAutoGeneratedFilesOptions): boolean;

package/dist/lib/path-class/index.js

@@ -3,7 +3,7 @@ import {
   Path,
   ResolutionPrefix,
   stringifyIfPath
-} from "./chunks/chunk-THKWY3VT.js";
+} from "./chunks/chunk-DIQ7KWIN.js";
 export {
   AsyncDisposablePath,
   Path,

package/dist/lib/path-class/sync/PathSync.d.ts

@@ -1,4 +1,5 @@
 import { appendFileSync, chmodSync, cpSync, mkdirSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
+import { type IgnoreAutoGeneratedFilesOptions } from "../emptyish";
 import { type WriteJSONOptions } from "../json";
 import { Path } from "../Path";
 import type { lstatSyncType, readDirSyncType, readFileSyncType, statSyncType } from "./modifiedNodeTypes";
@@ -69,6 +70,55 @@ export declare class PathSync extends Path {
     writeSync(data: Parameters<typeof writeFileSync>[1], options?: Parameters<typeof writeFileSync>[2]): PathSync;
     writeJSONSync<T>(data: T, options?: WriteJSONOptions): PathSync;
     readDirSync: typeof readDirSyncType;
+    /**
+     * - Returns false if the path does not exists.
+     * - Throws an error if the path exists as a file rather than a dir.
+     */
+    isEmptyDirSync(options?: IgnoreAutoGeneratedFilesOptions): boolean;
+    /**
+     * Equivalent to:
+     *
+     * ```
+     * .isEmptyDir({
+     *   ignoreOSAutogeneratedFiles: {
+     *     macOS: true,
+     *     windows: true,
+     *   },
+     * })
+     * ```
+     *
+     * Note that this ignores common files automatically created by the operating
+     * system. These are *often* vestigial and unnecessary, but may occasionally
+     * be important to the user (e.g. an icon for an empty folder, or folder
+     * layout information that will be used once files are added atain).
+     *
+     * There is no general way to tell whether a given folder is "safe" to delete,
+     * but this can be a useful heuristic to tell whether a folder is "actually"
+     * empty when it is fully managed by the calling program and otherwise empty.
+     *
+     * - Returns `false` if the path does not exists.
+     * - Throws an error if the path exists as a file rather than a dir.
+     */
+    isEmptyishDirSync(): boolean;
+    /**
+     * A wrapper around `.rmDir()` that ignores files according to
+     * `.isEmptyishDir()`.
+     *
+     * Note that this ignores common files automatically created by the operating
+     * system. These are *often* vestigial and unnecessary, but may occasionally
+     * be important to the user (e.g. an icon for an empty folder, or folder
+     * layout information that will be used once files are added atain).
+     *
+     * There is no general way to tell whether a given folder is "safe" to delete,
+     * but this can be a useful heuristic to tell whether a folder is "actually"
+     * empty when it is fully managed by the calling program and otherwise empty.
+     *
+     * - Returns `true` if the directory was removed.
+     * - Returns `false` if the directory is not emptyish.
+     * - Returns `false` if the path does not exists.
+     * - Throws an error if the path exists as a file rather than a dir.
+     */
+    rmDirIfEmptyishSync(): boolean;
     symlinkSync(target: string | URL | Path, type?: Parameters<typeof symlinkSync>[2]): PathSync;
     realpathSync(): PathSync;
     statSync: typeof statSyncType;

package/dist/lib/path-class/sync/index.js

@@ -1,8 +1,10 @@
 import {
+  ALL_KNOWN_AUTOGENERATED_FILES,
   Path,
+  isEmptyExceptForAutoGeneratedFiles,
   jsonChunks,
   mustNotHaveTrailingSlash
-} from "../chunks/chunk-THKWY3VT.js";
+} from "../chunks/chunk-DIQ7KWIN.js";
 
 // src/sync/PathSync.ts
 import {
@@ -227,6 +229,77 @@ var PathSync = class _PathSync extends Path {
     // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.
     readdirSync(this.path, options)
   );
+  /**
+   * - Returns false if the path does not exists.
+   * - Throws an error if the path exists as a file rather than a dir.
+   */
+  // TODO: return `false` when the path is a file?
+  isEmptyDirSync(options) {
+    if (!this.existsAsDirSync()) {
+      return false;
+    }
+    return isEmptyExceptForAutoGeneratedFiles(this.readDirSync(), options);
+  }
+  /**
+   * Equivalent to:
+   *
+   * ```
+   * .isEmptyDir({
+   *   ignoreOSAutogeneratedFiles: {
+   *     macOS: true,
+   *     windows: true,
+   *   },
+   * })
+   * ```
+   *
+   * Note that this ignores common files automatically created by the operating
+   * system. These are *often* vestigial and unnecessary, but may occasionally
+   * be important to the user (e.g. an icon for an empty folder, or folder
+   * layout information that will be used once files are added atain).
+   *
+   * There is no general way to tell whether a given folder is "safe" to delete,
+   * but this can be a useful heuristic to tell whether a folder is "actually"
+   * empty when it is fully managed by the calling program and otherwise empty.
+   *
+   * - Returns `false` if the path does not exists.
+   * - Throws an error if the path exists as a file rather than a dir.
+   */
+  isEmptyishDirSync() {
+    return this.isEmptyDirSync({
+      ignoreOSAutogeneratedFiles: {
+        macOS: true,
+        windows: true
+      }
+    });
+  }
+  /**
+   * A wrapper around `.rmDir()` that ignores files according to
+   * `.isEmptyishDir()`.
+   *
+   * Note that this ignores common files automatically created by the operating
+   * system. These are *often* vestigial and unnecessary, but may occasionally
+   * be important to the user (e.g. an icon for an empty folder, or folder
+   * layout information that will be used once files are added atain).
+   *
+   * There is no general way to tell whether a given folder is "safe" to delete,
+   * but this can be a useful heuristic to tell whether a folder is "actually"
+   * empty when it is fully managed by the calling program and otherwise empty.
+   *
+   * - Returns `true` if the directory was removed.
+   * - Returns `false` if the directory is not emptyish.
+   * - Returns `false` if the path does not exists.
+   * - Throws an error if the path exists as a file rather than a dir.
+   */
+  rmDirIfEmptyishSync() {
+    if (this.isEmptyishDirSync()) {
+      ALL_KNOWN_AUTOGENERATED_FILES.map(
+        (path) => this.join(path).rmSync({ force: true })
+      );
+      this.rmDirSync();
+      return true;
+    }
+    return false;
+  }
   symlinkSync(target, type) {
     const targetPath = new _PathSync(target);
     symlinkSync(

package/dist/lib/path-class/sync/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/sync/PathSync.ts"],
-  "sourcesContent": ["import {\n  appendFileSync,\n  chmodSync,\n  cpSync,\n  lstatSync,\n  mkdirSync,\n  mkdtempSync,\n  readdirSync,\n  readFileSync,\n  realpathSync,\n  renameSync,\n  rmdirSync,\n  rmSync,\n  statSync,\n  symlinkSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { constants } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport { jsonChunks, type WriteJSONOptions } from \"../json\";\nimport { mustNotHaveTrailingSlash, Path } from \"../Path\";\nimport type {\n  lstatSyncType,\n  readDirSyncType,\n  readFileSyncType,\n  statSyncType,\n} from \"./modifiedNodeTypes\";\n\nconst DEFAULT_TEMP_PREFIX = \"js-temp-sync-\";\nconst DEFAULT_TEMP_FILE_NAME = \"file\";\n\nexport class PathSync extends Path {\n  static override fromString(s: string): PathSync {\n    return new PathSync(s);\n  }\n\n  static override resolve(...args: Parameters<typeof Path.resolve>): PathSync {\n    return new PathSync(Path.resolve(...args));\n  }\n\n  override resolve(...args: Parameters<Path[\"resolve\"]>): PathSync {\n    return new PathSync(super.resolve(...args));\n  }\n\n  override descendantRelativePath(\n    ...args: Parameters<Path[\"descendantRelativePath\"]>\n  ): PathSync | null {\n    const v = super.descendantRelativePath(...args);\n    if (v === null) {\n      return null;\n    }\n    return new PathSync(v);\n  }\n\n  override toggleTrailingSlash(\n    ...args: Parameters<Path[\"toggleTrailingSlash\"]>\n  ): PathSync {\n    return new PathSync(super.toggleTrailingSlash(...args));\n  }\n\n  override join(...args: Parameters<Path[\"join\"]>): PathSync {\n    return new PathSync(super.join(...args));\n  }\n\n  override asRelative(...args: Parameters<Path[\"asRelative\"]>): PathSync {\n    return new PathSync(super.asRelative(...args));\n  }\n\n  override asAbsolute(...args: Parameters<Path[\"asAbsolute\"]>): PathSync {\n    return new PathSync(super.asAbsolute(...args));\n  }\n\n  override asBare(...args: Parameters<Path[\"asBare\"]>): PathSync {\n    return new PathSync(super.asBare(...args));\n  }\n\n  override extendBasename(\n    ...args: Parameters<Path[\"extendBasename\"]>\n  ): PathSync {\n    return new PathSync(super.extendBasename(...args));\n  }\n\n  override get parent(): PathSync {\n    return new PathSync(super.parent);\n  }\n\n  override get dirname(): PathSync {\n    return new PathSync(super.dirname);\n  }\n\n  override get basename(): PathSync {\n    return new PathSync(super.basename);\n  }\n\n  static override get homedir(): PathSync {\n    return new PathSync(Path.homedir);\n  }\n\n  static override get cwd(): PathSync {\n    return new PathSync(Path.cwd);\n  }\n\n  override debugPrint(...args: Parameters<Path[\"debugPrint\"]>): PathSync {\n    return new PathSync(super.debugPrint(...args));\n  }\n\n  // TODO: find a neat way to dedup with the async version? // lint-sync-code-expect-error\n  existsSync(constraints?: { mustBe: \"file\" | \"directory\" }): boolean {\n    if (constraints?.mustBe === \"file\") {\n      mustNotHaveTrailingSlash(this);\n    }\n    let stats: ReturnType<typeof statSync>;\n    try {\n      stats = statSync(this.path);\n      // biome-ignore lint/suspicious/noExplicitAny: TypeScript limitation\n    } catch (e: any) {\n      if (e.code === \"ENOENT\") {\n        return false;\n      }\n      throw e;\n    }\n    if (!constraints?.mustBe) {\n      return true;\n    }\n    switch (constraints?.mustBe) {\n      case \"file\": {\n        if (stats.isFile()) {\n          return true;\n        }\n        throw new Error(`PathSync exists but is not a file: ${this.path}`);\n      }\n      case \"directory\": {\n        if (stats.isDirectory()) {\n          return true;\n        }\n        throw new Error(`PathSync exists but is not a directory: ${this.path}`);\n      }\n      default: {\n        throw new Error(\"Invalid path type constraint\");\n      }\n    }\n  }\n\n  existsAsFileSync(): boolean {\n    return this.existsSync({ mustBe: \"file\" });\n  }\n\n  existsAsDirSync(): boolean {\n    return this.existsSync({ mustBe: \"directory\" });\n  }\n\n  mkdirSync(options?: Parameters<typeof mkdirSync>[1]): PathSync {\n    const optionsObject = (() => {\n      if (typeof options === \"string\" || typeof options === \"number\") {\n        return { mode: options };\n      }\n      return options ?? {};\n    })();\n    mkdirSync(this.path, { recursive: true, ...optionsObject });\n    return this;\n  }\n\n  cpSync(\n    destination: string | URL | Path,\n    options?: Parameters<typeof cpSync>[2] & {\n      createIntermediateDirs?: boolean;\n    },\n  ): PathSync {\n    const { createIntermediateDirs, ...cpOptions } = options ?? {};\n    const destinationPath = new PathSync(destination);\n    if (createIntermediateDirs ?? true) {\n      destinationPath.parent.mkdirSync();\n    }\n    cpSync(this.path, destinationPath.path, cpOptions);\n    return destinationPath;\n  }\n\n  renameSync(\n    destination: string | URL | Path,\n    options?: { createIntermediateDirs?: boolean },\n  ): PathSync {\n    const destinationPath = new PathSync(destination);\n    if (options?.createIntermediateDirs ?? true) {\n      destinationPath.parent.mkdirSync();\n    }\n    renameSync(this.path, destinationPath.path);\n    return destinationPath;\n  }\n\n  static makeTempDirSync(prefix?: string): DisposablePathSync {\n    return new DisposablePathSync(\n      mkdtempSync(\n        new Path(tmpdir()).join(prefix ?? DEFAULT_TEMP_PREFIX).toString(),\n      ),\n    );\n  }\n\n  /**\n   * Return a path:\n   *\n   * - whose parent dir is a temp dir that *has* been created, but\n   * - which has itself not yet been created.\n   *\n   * Note that this path can actually also be used to create dir, but it is most\n   * convenient to get a path for a temporary file that can be written to, while\n   * having a disposal implementation that cleans everything up:\n   *\n   *     using tempFile = PathSync.tempFilePathSync({ basename: \"foo.txt\" });\n   *     tempFile.writeSync(\"hello world!\");\n   *     // \u2026\n   *\n   * Note that that the following are equivalent when *not* using `using`:\n   *\n   *     PathSync.tempFilePathSync({ basename: \"foo.txt\" });\n   *     PathSync.makeTempDirSync().join(\"file.txt\");\n   *\n   * However, it is recommended to use `using` to ensure cleanup.\n   */\n  static tempFilePathSync(options: {\n    tempDirPrefix?: string;\n    basename?: string | Path;\n  }): DisposablePathSync {\n    const tempDir = PathSync.makeTempDirSync(options?.tempDirPrefix);\n    return new DisposablePathSync(\n      tempDir.join(options?.basename ?? DEFAULT_TEMP_FILE_NAME),\n      { disposePathInstead: tempDir },\n    );\n  }\n\n  rmSync(options?: Parameters<typeof rmSync>[1]): void {\n    rmSync(this.path, options);\n  }\n\n  rmDirSync(): void {\n    rmdirSync(this.path);\n  }\n\n  rm_rfSync(options?: Parameters<typeof rmSync>[1]): void {\n    this.rmSync({ recursive: true, force: true, ...(options ?? {}) });\n  }\n\n  readSync: typeof readFileSyncType = (options) =>\n    // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.\n    readFileSync(this.path, options) as any;\n\n  readTextSync(): string {\n    return readFileSync(this.path, \"utf-8\");\n  }\n\n  readJSONSync<T>(options?: { fallback?: T }): T {\n    try {\n      return JSON.parse(this.readTextSync());\n    } catch (e) {\n      if (\n        (e as { code?: string }).code === \"ENOENT\" &&\n        options &&\n        \"fallback\" in options\n      ) {\n        return options.fallback as T;\n      }\n      throw e;\n    }\n  }\n\n  appendFileSync(\n    data: Parameters<typeof appendFileSync>[1],\n    options?: Parameters<typeof appendFileSync>[2],\n  ): PathSync {\n    appendFileSync(this.path, data, options);\n    return this;\n  }\n\n  writeSync(\n    data: Parameters<typeof writeFileSync>[1],\n    options?: Parameters<typeof writeFileSync>[2],\n  ): PathSync {\n    this.parent.mkdirSync();\n    writeFileSync(this.path, data, options);\n    return this;\n  }\n\n  writeJSONSync<T>(data: T, options?: WriteJSONOptions): PathSync {\n    this.parent.mkdirSync();\n    // TODO: use a file handle to avoid concatenation.\n    this.writeSync(jsonChunks(data, options).join(\"\"));\n    return this;\n  }\n\n  // biome-ignore lint/suspicious/noExplicitAny: Type wrangling.\n  readDirSync: typeof readDirSyncType = (options: any) =>\n    // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.\n    readdirSync(this.path, options) as any;\n\n  symlinkSync(\n    target: string | URL | Path,\n    type?: Parameters<typeof symlinkSync>[2],\n  ): PathSync {\n    const targetPath = new PathSync(target);\n    symlinkSync(\n      this.path,\n      targetPath.path,\n      type as Exclude<Parameters<typeof symlinkSync>[2], undefined>, // \uD83E\uDD37\n    );\n    return targetPath;\n  }\n\n  realpathSync(): PathSync {\n    return new PathSync(realpathSync(this.path));\n  }\n\n  statSync: typeof statSyncType = (options) =>\n    // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.\n    statSync(this.path, options) as any;\n\n  lstatSync: typeof lstatSyncType = (options) =>\n    // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.\n    lstatSync(this.path, options) as any;\n\n  chmodSync(mode: Parameters<typeof chmodSync>[1]): PathSync {\n    chmodSync(this.path, mode);\n    return this;\n  }\n\n  chmodXSync(): PathSync {\n    const { mode } = this.statSync();\n    this.chmodSync(\n      mode | constants.S_IXUSR | constants.S_IXGRP | constants.S_IXOTH,\n    );\n    return this;\n  }\n}\n\nexport class DisposablePathSync extends PathSync {\n  #options?: { disposePathInstead: PathSync };\n  constructor(\n    path: ConstructorParameters<typeof Path>[0],\n    options?: { disposePathInstead: Path | string },\n  ) {\n    super(path);\n    if (options) {\n      this.#options = {\n        disposePathInstead: new PathSync(options.disposePathInstead),\n      };\n    }\n  }\n\n  [Symbol.dispose]() {\n    (this.#options?.disposePathInstead ?? this).rm_rfSync();\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  appendFileSync,\n  chmodSync,\n  cpSync,\n  lstatSync,\n  mkdirSync,\n  mkdtempSync,\n  readdirSync,\n  readFileSync,\n  realpathSync,\n  renameSync,\n  rmdirSync,\n  rmSync,\n  statSync,\n  symlinkSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { constants } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport {\n  ALL_KNOWN_AUTOGENERATED_FILES,\n  type IgnoreAutoGeneratedFilesOptions,\n  isEmptyExceptForAutoGeneratedFiles,\n} from \"../emptyish\";\nimport { jsonChunks, type WriteJSONOptions } from \"../json\";\nimport { mustNotHaveTrailingSlash, Path } from \"../Path\";\nimport type {\n  lstatSyncType,\n  readDirSyncType,\n  readFileSyncType,\n  statSyncType,\n} from \"./modifiedNodeTypes\";\n\nconst DEFAULT_TEMP_PREFIX = \"js-temp-sync-\";\nconst DEFAULT_TEMP_FILE_NAME = \"file\";\n\nexport class PathSync extends Path {\n  static override fromString(s: string): PathSync {\n    return new PathSync(s);\n  }\n\n  static override resolve(...args: Parameters<typeof Path.resolve>): PathSync {\n    return new PathSync(Path.resolve(...args));\n  }\n\n  override resolve(...args: Parameters<Path[\"resolve\"]>): PathSync {\n    return new PathSync(super.resolve(...args));\n  }\n\n  override descendantRelativePath(\n    ...args: Parameters<Path[\"descendantRelativePath\"]>\n  ): PathSync | null {\n    const v = super.descendantRelativePath(...args);\n    if (v === null) {\n      return null;\n    }\n    return new PathSync(v);\n  }\n\n  override toggleTrailingSlash(\n    ...args: Parameters<Path[\"toggleTrailingSlash\"]>\n  ): PathSync {\n    return new PathSync(super.toggleTrailingSlash(...args));\n  }\n\n  override join(...args: Parameters<Path[\"join\"]>): PathSync {\n    return new PathSync(super.join(...args));\n  }\n\n  override asRelative(...args: Parameters<Path[\"asRelative\"]>): PathSync {\n    return new PathSync(super.asRelative(...args));\n  }\n\n  override asAbsolute(...args: Parameters<Path[\"asAbsolute\"]>): PathSync {\n    return new PathSync(super.asAbsolute(...args));\n  }\n\n  override asBare(...args: Parameters<Path[\"asBare\"]>): PathSync {\n    return new PathSync(super.asBare(...args));\n  }\n\n  override extendBasename(\n    ...args: Parameters<Path[\"extendBasename\"]>\n  ): PathSync {\n    return new PathSync(super.extendBasename(...args));\n  }\n\n  override get parent(): PathSync {\n    return new PathSync(super.parent);\n  }\n\n  override get dirname(): PathSync {\n    return new PathSync(super.dirname);\n  }\n\n  override get basename(): PathSync {\n    return new PathSync(super.basename);\n  }\n\n  static override get homedir(): PathSync {\n    return new PathSync(Path.homedir);\n  }\n\n  static override get cwd(): PathSync {\n    return new PathSync(Path.cwd);\n  }\n\n  override debugPrint(...args: Parameters<Path[\"debugPrint\"]>): PathSync {\n    return new PathSync(super.debugPrint(...args));\n  }\n\n  // TODO: find a neat way to dedup with the async version? // lint-sync-code-expect-error\n  existsSync(constraints?: { mustBe: \"file\" | \"directory\" }): boolean {\n    if (constraints?.mustBe === \"file\") {\n      mustNotHaveTrailingSlash(this);\n    }\n    let stats: ReturnType<typeof statSync>;\n    try {\n      stats = statSync(this.path);\n      // biome-ignore lint/suspicious/noExplicitAny: TypeScript limitation\n    } catch (e: any) {\n      if (e.code === \"ENOENT\") {\n        return false;\n      }\n      throw e;\n    }\n    if (!constraints?.mustBe) {\n      return true;\n    }\n    switch (constraints?.mustBe) {\n      case \"file\": {\n        if (stats.isFile()) {\n          return true;\n        }\n        throw new Error(`PathSync exists but is not a file: ${this.path}`);\n      }\n      case \"directory\": {\n        if (stats.isDirectory()) {\n          return true;\n        }\n        throw new Error(`PathSync exists but is not a directory: ${this.path}`);\n      }\n      default: {\n        throw new Error(\"Invalid path type constraint\");\n      }\n    }\n  }\n\n  existsAsFileSync(): boolean {\n    return this.existsSync({ mustBe: \"file\" });\n  }\n\n  existsAsDirSync(): boolean {\n    return this.existsSync({ mustBe: \"directory\" });\n  }\n\n  mkdirSync(options?: Parameters<typeof mkdirSync>[1]): PathSync {\n    const optionsObject = (() => {\n      if (typeof options === \"string\" || typeof options === \"number\") {\n        return { mode: options };\n      }\n      return options ?? {};\n    })();\n    mkdirSync(this.path, { recursive: true, ...optionsObject });\n    return this;\n  }\n\n  cpSync(\n    destination: string | URL | Path,\n    options?: Parameters<typeof cpSync>[2] & {\n      createIntermediateDirs?: boolean;\n    },\n  ): PathSync {\n    const { createIntermediateDirs, ...cpOptions } = options ?? {};\n    const destinationPath = new PathSync(destination);\n    if (createIntermediateDirs ?? true) {\n      destinationPath.parent.mkdirSync();\n    }\n    cpSync(this.path, destinationPath.path, cpOptions);\n    return destinationPath;\n  }\n\n  renameSync(\n    destination: string | URL | Path,\n    options?: { createIntermediateDirs?: boolean },\n  ): PathSync {\n    const destinationPath = new PathSync(destination);\n    if (options?.createIntermediateDirs ?? true) {\n      destinationPath.parent.mkdirSync();\n    }\n    renameSync(this.path, destinationPath.path);\n    return destinationPath;\n  }\n\n  static makeTempDirSync(prefix?: string): DisposablePathSync {\n    return new DisposablePathSync(\n      mkdtempSync(\n        new Path(tmpdir()).join(prefix ?? DEFAULT_TEMP_PREFIX).toString(),\n      ),\n    );\n  }\n\n  /**\n   * Return a path:\n   *\n   * - whose parent dir is a temp dir that *has* been created, but\n   * - which has itself not yet been created.\n   *\n   * Note that this path can actually also be used to create dir, but it is most\n   * convenient to get a path for a temporary file that can be written to, while\n   * having a disposal implementation that cleans everything up:\n   *\n   *     using tempFile = PathSync.tempFilePathSync({ basename: \"foo.txt\" });\n   *     tempFile.writeSync(\"hello world!\");\n   *     // \u2026\n   *\n   * Note that that the following are equivalent when *not* using `using`:\n   *\n   *     PathSync.tempFilePathSync({ basename: \"foo.txt\" });\n   *     PathSync.makeTempDirSync().join(\"file.txt\");\n   *\n   * However, it is recommended to use `using` to ensure cleanup.\n   */\n  static tempFilePathSync(options: {\n    tempDirPrefix?: string;\n    basename?: string | Path;\n  }): DisposablePathSync {\n    const tempDir = PathSync.makeTempDirSync(options?.tempDirPrefix);\n    return new DisposablePathSync(\n      tempDir.join(options?.basename ?? DEFAULT_TEMP_FILE_NAME),\n      { disposePathInstead: tempDir },\n    );\n  }\n\n  rmSync(options?: Parameters<typeof rmSync>[1]): void {\n    rmSync(this.path, options);\n  }\n\n  rmDirSync(): void {\n    rmdirSync(this.path);\n  }\n\n  rm_rfSync(options?: Parameters<typeof rmSync>[1]): void {\n    this.rmSync({ recursive: true, force: true, ...(options ?? {}) });\n  }\n\n  readSync: typeof readFileSyncType = (options) =>\n    // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.\n    readFileSync(this.path, options) as any;\n\n  readTextSync(): string {\n    return readFileSync(this.path, \"utf-8\");\n  }\n\n  readJSONSync<T>(options?: { fallback?: T }): T {\n    try {\n      return JSON.parse(this.readTextSync());\n    } catch (e) {\n      if (\n        (e as { code?: string }).code === \"ENOENT\" &&\n        options &&\n        \"fallback\" in options\n      ) {\n        return options.fallback as T;\n      }\n      throw e;\n    }\n  }\n\n  appendFileSync(\n    data: Parameters<typeof appendFileSync>[1],\n    options?: Parameters<typeof appendFileSync>[2],\n  ): PathSync {\n    appendFileSync(this.path, data, options);\n    return this;\n  }\n\n  writeSync(\n    data: Parameters<typeof writeFileSync>[1],\n    options?: Parameters<typeof writeFileSync>[2],\n  ): PathSync {\n    this.parent.mkdirSync();\n    writeFileSync(this.path, data, options);\n    return this;\n  }\n\n  writeJSONSync<T>(data: T, options?: WriteJSONOptions): PathSync {\n    this.parent.mkdirSync();\n    // TODO: use a file handle to avoid concatenation.\n    this.writeSync(jsonChunks(data, options).join(\"\"));\n    return this;\n  }\n\n  // biome-ignore lint/suspicious/noExplicitAny: Type wrangling.\n  readDirSync: typeof readDirSyncType = (options: any) =>\n    // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.\n    readdirSync(this.path, options) as any;\n\n  /**\n   * - Returns false if the path does not exists.\n   * - Throws an error if the path exists as a file rather than a dir.\n   */\n  // TODO: return `false` when the path is a file?\n  isEmptyDirSync(options?: IgnoreAutoGeneratedFilesOptions): boolean {\n    if (!this.existsAsDirSync()) {\n      return false;\n    }\n    return isEmptyExceptForAutoGeneratedFiles(this.readDirSync(), options);\n  }\n\n  /**\n   * Equivalent to:\n   *\n   * ```\n   * .isEmptyDir({\n   *   ignoreOSAutogeneratedFiles: {\n   *     macOS: true,\n   *     windows: true,\n   *   },\n   * })\n   * ```\n   *\n   * Note that this ignores common files automatically created by the operating\n   * system. These are *often* vestigial and unnecessary, but may occasionally\n   * be important to the user (e.g. an icon for an empty folder, or folder\n   * layout information that will be used once files are added atain).\n   *\n   * There is no general way to tell whether a given folder is \"safe\" to delete,\n   * but this can be a useful heuristic to tell whether a folder is \"actually\"\n   * empty when it is fully managed by the calling program and otherwise empty.\n   *\n   * - Returns `false` if the path does not exists.\n   * - Throws an error if the path exists as a file rather than a dir.\n   */\n  isEmptyishDirSync(): boolean {\n    return this.isEmptyDirSync({\n      ignoreOSAutogeneratedFiles: {\n        macOS: true,\n        windows: true,\n      },\n    });\n  }\n\n  /**\n   * A wrapper around `.rmDir()` that ignores files according to\n   * `.isEmptyishDir()`.\n   *\n   * Note that this ignores common files automatically created by the operating\n   * system. These are *often* vestigial and unnecessary, but may occasionally\n   * be important to the user (e.g. an icon for an empty folder, or folder\n   * layout information that will be used once files are added atain).\n   *\n   * There is no general way to tell whether a given folder is \"safe\" to delete,\n   * but this can be a useful heuristic to tell whether a folder is \"actually\"\n   * empty when it is fully managed by the calling program and otherwise empty.\n   *\n   * - Returns `true` if the directory was removed.\n   * - Returns `false` if the directory is not emptyish.\n   * - Returns `false` if the path does not exists.\n   * - Throws an error if the path exists as a file rather than a dir.\n   */\n  rmDirIfEmptyishSync(): boolean {\n    if (this.isEmptyishDirSync()) {\n      ALL_KNOWN_AUTOGENERATED_FILES.map((path) =>\n        this.join(path).rmSync({ force: true }),\n      );\n      this.rmDirSync();\n      return true;\n    }\n    return false;\n  }\n\n  symlinkSync(\n    target: string | URL | Path,\n    type?: Parameters<typeof symlinkSync>[2],\n  ): PathSync {\n    const targetPath = new PathSync(target);\n    symlinkSync(\n      this.path,\n      targetPath.path,\n      type as Exclude<Parameters<typeof symlinkSync>[2], undefined>, // \uD83E\uDD37\n    );\n    return targetPath;\n  }\n\n  realpathSync(): PathSync {\n    return new PathSync(realpathSync(this.path));\n  }\n\n  statSync: typeof statSyncType = (options) =>\n    // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.\n    statSync(this.path, options) as any;\n\n  lstatSync: typeof lstatSyncType = (options) =>\n    // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.\n    lstatSync(this.path, options) as any;\n\n  chmodSync(mode: Parameters<typeof chmodSync>[1]): PathSync {\n    chmodSync(this.path, mode);\n    return this;\n  }\n\n  chmodXSync(): PathSync {\n    const { mode } = this.statSync();\n    this.chmodSync(\n      mode | constants.S_IXUSR | constants.S_IXGRP | constants.S_IXOTH,\n    );\n    return this;\n  }\n}\n\nexport class DisposablePathSync extends PathSync {\n  #options?: { disposePathInstead: PathSync };\n  constructor(\n    path: ConstructorParameters<typeof Path>[0],\n    options?: { disposePathInstead: Path | string },\n  ) {\n    super(path);\n    if (options) {\n      this.#options = {\n        disposePathInstead: new PathSync(options.disposePathInstead),\n      };\n    }\n  }\n\n  [Symbol.dispose]() {\n    (this.#options?.disposePathInstead ?? this).rm_rfSync();\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "path-class",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "A semantic `Path` class for `node` and `bun`. Inspired by `bun`'s [`file(…)`](https://bun.com/docs/runtime/file-io) API, but `node`-compatible.",
   "author": "Lucas Garron <code@garron.net>",
   "license": "MIT",
@@ -28,8 +28,8 @@
   "devDependencies": {
     "@biomejs/biome": "^2.4.8",
     "@cubing/dev-config": ">=0.9.4",
-    "@types/bun": "^1.3.13",
-    "@typescript/native-preview": "^7.0.0-dev.20260506.1",
+    "@types/bun": "^1.3.14",
+    "@typescript/native-preview": "^7.0.0-dev.20260512.1",
     "bun-dx": ">=0.1.3",
     "ergonomic-date": "^0.1.3",
     "esbuild": "^0.25.10",
@@ -42,8 +42,5 @@
   ],
   "scripts": {
     "prepublishOnly": "make prepublishOnly"
-  },
-  "patchedDependencies": {
-    "bun-types@1.3.13": "patches/bun-types@1.3.13.patch"
   }
 }

package/src/Path.test.ts

@@ -713,6 +713,28 @@ test.concurrent(".readDir(…)", async () => {
   );
 });
 
+test.concurrent(".isEmptyDir(…), .isEmptyishDir(…), and .rmDirIfEmptyish()", async () => {
+  await using dir = await Path.makeTempDir();
+
+  expect(await dir.isEmptyDir()).toBe(true);
+  expect(await dir.isEmptyishDir()).toBe(true);
+
+  await dir.join(".DS_Store").write("");
+  expect(await dir.isEmptyDir()).toBe(false);
+  expect(await dir.isEmptyishDir()).toBe(true);
+
+  await dir.join("foo.txt").write("");
+  expect(await dir.isEmptyDir()).toBe(false);
+  expect(await dir.isEmptyishDir()).toBe(false);
+
+  expect(await dir.rmDirIfEmptyish()).toBe(false);
+  expect(await dir.exists()).toBe(true);
+
+  await dir.join("foo.txt").rm();
+  expect(await dir.rmDirIfEmptyish()).toBe(true);
+  expect(await dir.exists()).toBe(false);
+});
+
 test.concurrent(".symlink(…)", async () => {
   await using tempDir = await Path.makeTempDir();
   const source = tempDir.join("foo.txt");

package/src/Path.ts

@@ -23,6 +23,11 @@ import { cwd } from "node:process";
 import { createInterface } from "node:readline/promises";
 import { Readable } from "node:stream";
 import { fileURLToPath, pathToFileURL } from "node:url";
+import {
+  ALL_KNOWN_AUTOGENERATED_FILES,
+  type IgnoreAutoGeneratedFilesOptions,
+  isEmptyExceptForAutoGeneratedFiles,
+} from "./emptyish";
 import { jsonChunks, type WriteJSONOptions } from "./json";
 import type {
   lstatType,
@@ -743,6 +748,79 @@ export class Path {
     // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.
     readdir(this.#path, options as any) as any;
 
+  /**
+   * - Returns false if the path does not exists.
+   * - Throws an error if the path exists as a file rather than a dir.
+   */
+  // TODO: return `false` when the path is a file?
+  async isEmptyDir(
+    options?: IgnoreAutoGeneratedFilesOptions,
+  ): Promise<boolean> {
+    if (!this.existsAsDir()) {
+      return false;
+    }
+    return isEmptyExceptForAutoGeneratedFiles(await this.readDir(), options);
+  }
+
+  /**
+   * Equivalent to:
+   *
+   * ```
+   * .isEmptyDir({
+   *   ignoreOSAutogeneratedFiles: true,
+   * })
+   * ```
+   *
+   * Note that this ignores common files automatically created by the operating
+   * system. These are *often* vestigial and unnecessary, but may occasionally
+   * be important to the user (e.g. an icon for an empty folder, or folder
+   * layout information that will be used once files are added atain).
+   *
+   * There is no general way to tell whether a given folder is "safe" to delete,
+   * but this can be a useful heuristic to tell whether a folder is "actually"
+   * empty when it is fully managed by the calling program and otherwise empty.
+   *
+   * - Returns `false` if the path does not exists.
+   * - Throws an error if the path exists as a file rather than a dir.
+   */
+  async isEmptyishDir(): Promise<boolean> {
+    return this.isEmptyDir({
+      ignoreOSAutogeneratedFiles: true,
+    });
+  }
+
+  /**
+   * A wrapper around `.rmDir()` that ignores files according to
+   * `.isEmptyishDir()`.
+   *
+   * Note that this ignores common files automatically created by the operating
+   * system. These are *often* vestigial and unnecessary, but may occasionally
+   * be important to the user (e.g. an icon for an empty folder, or folder
+   * layout information that will be used once files are added atain).
+   *
+   * There is no general way to tell whether a given folder is "safe" to delete,
+   * but this can be a useful heuristic to tell whether a folder is "actually"
+   * empty when it is fully managed by the calling program and otherwise empty.
+   *
+   * - Returns `true` if the directory was removed.
+   * - Returns `false` if the directory is not emptyish.
+   * - Returns `false` if the path does not exists.
+   * - Throws an error if the path exists as a file rather than a dir.
+   */
+  async rmDirIfEmptyish(): Promise<boolean> {
+    if (await this.isEmptyishDir()) {
+      // TODO: doos any OS cause a race condition here, in practice?
+      await Promise.all([
+        ALL_KNOWN_AUTOGENERATED_FILES.map((path) =>
+          this.join(path).rm({ force: true }),
+        ),
+      ]);
+      await this.rmDir();
+      return true;
+    }
+    return false;
+  }
+
   /** Returns the destination path. */
   async symlink(
     target: string | URL | Path,

package/src/emptyish.ts

@@ -0,0 +1,79 @@
+const MACOS_DOT_DS_STORE = ".DS_Store";
+const MACOS_ICON_PATH = "Icon\r";
+const WINDOWS_THUMBS_DOT_DB = "Thumbs.db";
+const WINDOWS_DESKTOP_INI = "Desktop.ini";
+
+export const ALL_KNOWN_AUTOGENERATED_FILES = [
+  MACOS_DOT_DS_STORE,
+  MACOS_ICON_PATH,
+  WINDOWS_THUMBS_DOT_DB,
+  WINDOWS_DESKTOP_INI,
+];
+
+export interface IgnoreAutoGeneratedFilesOptions {
+  ignoreOSAutogeneratedFiles?:
+    | true
+    | {
+        macOS?:
+          | true
+          | {
+              dotDSStore?: boolean;
+              iconPath?: boolean;
+            };
+        windows?:
+          | true
+          | {
+              // TODO: this can have alternative names?
+              ThumbsDotDB?: boolean;
+              DesktopDotIni?: boolean;
+            };
+        // TODO: anything common on Linux?
+      };
+}
+
+/**
+ * Modifies the input `entries`.
+ */
+function removeAutogeneratedFileEntries(
+  entries: Set<string>,
+  options?: IgnoreAutoGeneratedFilesOptions,
+) {
+  const ignore = options?.ignoreOSAutogeneratedFiles ?? {};
+
+  // biome-ignore lint/complexity/noUselessLoneBlockStatements: Grouping for legibility.
+  {
+    if (ignore === true || ignore?.macOS === true || ignore.macOS?.dotDSStore) {
+      entries.delete(MACOS_DOT_DS_STORE);
+    }
+    if (ignore === true || ignore?.macOS === true || ignore.macOS?.iconPath) {
+      entries.delete(MACOS_ICON_PATH);
+    }
+  }
+
+  // biome-ignore lint/complexity/noUselessLoneBlockStatements: Grouping for legibility.
+  {
+    if (
+      ignore === true ||
+      ignore?.windows === true ||
+      ignore.windows?.ThumbsDotDB
+    ) {
+      entries.delete(WINDOWS_THUMBS_DOT_DB);
+    }
+    if (
+      ignore === true ||
+      ignore?.windows === true ||
+      ignore.windows?.DesktopDotIni
+    ) {
+      entries.delete(WINDOWS_DESKTOP_INI);
+    }
+  }
+}
+
+export function isEmptyExceptForAutoGeneratedFiles(
+  entries: Iterable<string>,
+  options?: IgnoreAutoGeneratedFilesOptions,
+) {
+  const entriesSet = new Set(entries);
+  removeAutogeneratedFileEntries(entriesSet, options);
+  return entriesSet.size === 0;
+}

package/src/sync/PathSync.test.ts

@@ -348,6 +348,28 @@ test.concurrent(".readDirSync(…)", () => {
   );
 });
 
+test.concurrent(".isEmptyDir(…), .isEmptyishDir(…), and .rmDirIfEmptyish()", () => {
+  using dir = PathSync.makeTempDirSync();
+
+  expect(dir.isEmptyDirSync()).toBe(true);
+  expect(dir.isEmptyishDirSync()).toBe(true);
+
+  dir.join(".DS_Store").writeSync("");
+  expect(dir.isEmptyDirSync()).toBe(false);
+  expect(dir.isEmptyishDirSync()).toBe(true);
+
+  dir.join("foo.txt").writeSync("");
+  expect(dir.isEmptyDirSync()).toBe(false);
+  expect(dir.isEmptyishDirSync()).toBe(false);
+
+  expect(dir.rmDirIfEmptyishSync()).toBe(false);
+  expect(dir.existsSync()).toBe(true);
+
+  dir.join("foo.txt").rmSync();
+  expect(dir.rmDirIfEmptyishSync()).toBe(true);
+  expect(dir.existsSync()).toBe(false);
+});
+
 test.concurrent(".symlinkSync(…)", () => {
   using tempDir = PathSync.makeTempDirSync();
   const source = tempDir.join("foo.txt");

package/src/sync/PathSync.ts

@@ -17,6 +17,11 @@ import {
 } from "node:fs";
 import { constants } from "node:fs/promises";
 import { tmpdir } from "node:os";
+import {
+  ALL_KNOWN_AUTOGENERATED_FILES,
+  type IgnoreAutoGeneratedFilesOptions,
+  isEmptyExceptForAutoGeneratedFiles,
+} from "../emptyish";
 import { jsonChunks, type WriteJSONOptions } from "../json";
 import { mustNotHaveTrailingSlash, Path } from "../Path";
 import type {
@@ -291,6 +296,80 @@ export class PathSync extends Path {
     // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.
     readdirSync(this.path, options) as any;
 
+  /**
+   * - Returns false if the path does not exists.
+   * - Throws an error if the path exists as a file rather than a dir.
+   */
+  // TODO: return `false` when the path is a file?
+  isEmptyDirSync(options?: IgnoreAutoGeneratedFilesOptions): boolean {
+    if (!this.existsAsDirSync()) {
+      return false;
+    }
+    return isEmptyExceptForAutoGeneratedFiles(this.readDirSync(), options);
+  }
+
+  /**
+   * Equivalent to:
+   *
+   * ```
+   * .isEmptyDir({
+   *   ignoreOSAutogeneratedFiles: {
+   *     macOS: true,
+   *     windows: true,
+   *   },
+   * })
+   * ```
+   *
+   * Note that this ignores common files automatically created by the operating
+   * system. These are *often* vestigial and unnecessary, but may occasionally
+   * be important to the user (e.g. an icon for an empty folder, or folder
+   * layout information that will be used once files are added atain).
+   *
+   * There is no general way to tell whether a given folder is "safe" to delete,
+   * but this can be a useful heuristic to tell whether a folder is "actually"
+   * empty when it is fully managed by the calling program and otherwise empty.
+   *
+   * - Returns `false` if the path does not exists.
+   * - Throws an error if the path exists as a file rather than a dir.
+   */
+  isEmptyishDirSync(): boolean {
+    return this.isEmptyDirSync({
+      ignoreOSAutogeneratedFiles: {
+        macOS: true,
+        windows: true,
+      },
+    });
+  }
+
+  /**
+   * A wrapper around `.rmDir()` that ignores files according to
+   * `.isEmptyishDir()`.
+   *
+   * Note that this ignores common files automatically created by the operating
+   * system. These are *often* vestigial and unnecessary, but may occasionally
+   * be important to the user (e.g. an icon for an empty folder, or folder
+   * layout information that will be used once files are added atain).
+   *
+   * There is no general way to tell whether a given folder is "safe" to delete,
+   * but this can be a useful heuristic to tell whether a folder is "actually"
+   * empty when it is fully managed by the calling program and otherwise empty.
+   *
+   * - Returns `true` if the directory was removed.
+   * - Returns `false` if the directory is not emptyish.
+   * - Returns `false` if the path does not exists.
+   * - Throws an error if the path exists as a file rather than a dir.
+   */
+  rmDirIfEmptyishSync(): boolean {
+    if (this.isEmptyishDirSync()) {
+      ALL_KNOWN_AUTOGENERATED_FILES.map((path) =>
+        this.join(path).rmSync({ force: true }),
+      );
+      this.rmDirSync();
+      return true;
+    }
+    return false;
+  }
+
   symlinkSync(
     target: string | URL | Path,
     type?: Parameters<typeof symlinkSync>[2],

package/dist/lib/path-class/chunks/chunk-THKWY3VT.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/Path.ts", "../../../../src/json.ts", "../../../../src/xdg.ts", "../../../../src/stringifyfIfPath.ts"],
-  "sourcesContent": ["import { createReadStream } from \"node:fs\";\nimport {\n  appendFile,\n  chmod,\n  constants,\n  cp,\n  lstat,\n  mkdir,\n  mkdtemp,\n  readdir,\n  readFile,\n  realpath,\n  rename,\n  rm,\n  rmdir,\n  stat,\n  symlink,\n  writeFile,\n} from \"node:fs/promises\";\nimport { homedir, tmpdir } from \"node:os\";\nimport { basename, dirname, extname, join } from \"node:path\";\nimport { cwd } from \"node:process\";\nimport { createInterface } from \"node:readline/promises\";\nimport { Readable } from \"node:stream\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { jsonChunks, type WriteJSONOptions } from \"./json\";\nimport type {\n  lstatType,\n  readDirType,\n  readFileType,\n  statType,\n} from \"./modifiedNodeTypes\";\nimport { stringifyIfPath } from \"./stringifyfIfPath\";\nimport { xdg } from \"./xdg\";\n\n// Note that (non-static) functions in this file are defined using `function(\u2026)\n// { \u2026 }` rather than arrow functions, specifically because we want `this` to\n// operate on the `Path` instance.\n\ntype WritableData = Parameters<typeof writeFile>[1] | ReadableStream | Response;\nasync function wrangleWritableData(\n  data: WritableData | Promise<WritableData>,\n): Promise<Parameters<typeof writeFile>[1]> {\n  data = await data;\n  if (data instanceof Response) {\n    data = data.body ? Readable.fromWeb(data.body) : new Uint8Array(0);\n  }\n  if (data instanceof ReadableStream) {\n    data = Readable.fromWeb(data);\n  }\n  return data;\n}\n\nexport enum ResolutionPrefix {\n  Absolute = \"absolute\",\n  Relative = \"relative\",\n  Bare = \"bare\",\n}\n\nexport function resolutionPrefix(pathString: string): ResolutionPrefix {\n  if (pathString.startsWith(\"/\")) {\n    return ResolutionPrefix.Absolute;\n  } else if (pathString.startsWith(\"./\")) {\n    return ResolutionPrefix.Relative;\n  } else if (pathString.startsWith(\"../\")) {\n    return ResolutionPrefix.Relative;\n  } else if (pathString === \".\") {\n    return ResolutionPrefix.Relative;\n  } else if (pathString === \"..\") {\n    return ResolutionPrefix.Relative;\n  }\n  return ResolutionPrefix.Bare;\n}\n\nconst DEFAULT_TEMP_PREFIX = \"js-temp-\";\nconst DEFAULT_TEMP_FILE_NAME = \"file\";\n\nfunction preserveRelativeResolutionPrefix(\n  pathString: string,\n  from: string,\n): string {\n  if (\n    resolutionPrefix(from) === ResolutionPrefix.Relative &&\n    resolutionPrefix(pathString) !== ResolutionPrefix.Relative\n  ) {\n    // We don't have to handle the case of `\".\"`, as it already starts with `\".\"`\n    return `./${pathString}`;\n  }\n  return pathString;\n}\n\nfunction joinPreservingRelativeResolutionPrefix(\n  base: string,\n  relative: string[],\n): string {\n  return preserveRelativeResolutionPrefix(join(base, ...relative), base);\n}\n\nexport class Path {\n  // @ts-expect-error ts(2564): False positive. https://github.com/microsoft/TypeScript/issues/32194\n  #path: string;\n  /**\n   * If `path` is a string starting with `file:///`, it will be parsed as a file URL.\n   */\n  constructor(path: string | URL | Path) {\n    const s = Path.#pathlikeToString(path);\n    this.#setNormalizedPath(s);\n  }\n\n  static #pathlikeToString(path: string | URL | Path): string {\n    if (path instanceof Path) {\n      return path.#path;\n    }\n    if (path instanceof URL) {\n      return fileURLToPath(path);\n    }\n    if (typeof path === \"string\") {\n      // TODO: allow turning off this heuristic?\n      if (path.startsWith(\"file:///\")) {\n        return fileURLToPath(path);\n      }\n      return path;\n    }\n    throw new Error(\"Invalid path\");\n  }\n\n  // Preserves the `ResolutionPrefix` status when possible.\n  #setNormalizedPath(path: string): void {\n    this.#path = joinPreservingRelativeResolutionPrefix(path, []);\n  }\n  static fromString(s: string): Path {\n    if (typeof s !== \"string\") {\n      throw new Error(\n        \"Invalid argument to `Path.fromString(\u2026)` \u2014 expected a string.\",\n      );\n    }\n    return new Path(s);\n  }\n\n  get resolutionPrefix(): ResolutionPrefix {\n    return resolutionPrefix(this.#path);\n  }\n\n  /**\n   * Similar to `new URL(path, base)`, but accepting and returning `Path` objects.\n   * Note that `base` must be one of:\n   *\n   * - a valid second argument to `new URL(\u2026)`.\n   * - a `Path` representing an absolute path.\n   *\n   */\n  static resolve(path: string | URL | Path, base: string | URL | Path): Path {\n    const baseURL = (() => {\n      if (!(base instanceof Path)) {\n        if (typeof base === \"string\" && !base.startsWith(\"file://\")) {\n          return pathToFileURL(base);\n        }\n        return base;\n      }\n      if (!base.isAbsolutePath()) {\n        throw new Error(\n          \"The `base` arg to `Path.resolve(\u2026)` must be an absolute path.\",\n        );\n      }\n      return pathToFileURL(base.#path);\n    })();\n    return new Path(new URL(Path.#pathlikeToString(path), baseURL));\n  }\n\n  /**\n   * Convenience function. The following are equivalent:\n   *\n   *     B.resolve(A);\n   *     Path.resolve(A, B);\n   *\n   */\n  resolve(path: string | URL | Path): Path {\n    return Path.resolve(path, this);\n  }\n\n  /**\n   * Computes the relative path from an ancestor (this) to another path.\n   *\n   * - If the path is a descendant *or is the same path*, this returns a\n   *   relative path. Call {@link Path.asBare `.asBare()`} on the output if\n   *   needed.\n   * - The output is `null` unless the input paths are:\n   *   - Both absolute paths.\n   *   - Both relative paths. Resolve the paths before passing to this function\n   *     if needed.\n   * - Trailing slashes:\n   *   - By default, the ancestor path must have a trailing slash for the\n   *     function to be called. Pass `{ requireTrailingSlashForAncestor: false\n   *     }` if needed. Note that recombining the ancestor path with the output\n   *     using {@link Path.prototype.resolve `.resolve(\u2026)` } does not result in\n   *     the original input path if the ancestor path did not have a trailing\n   *     slash.\n   *   - For the descendant/same path check, trailing slashes are ignored. In\n   *     particular, if the ancestor path has a trailing slash and the\n   *     descendant path is the same path without a trailing slash, this is\n   *     still considered to be the same path.\n   *   - The output has trailing slash if and only if:\n   *       - the input descendant does, or\n   *       - the output is the absolute path `/`.\n   */\n  descendantRelativePath(\n    potentialDescendant: string | URL | Path,\n    options?: { requireTrailingSlashForAncestor: boolean },\n  ): Path | null {\n    const requireTrailingSlashForAncestor =\n      options?.requireTrailingSlashForAncestor ?? true;\n    if (requireTrailingSlashForAncestor && !this.hasTrailingSlash()) {\n      throw new Error(\n        \"Ancestor must have a trailing slash. Pass `{ requireTrailingSlashForAncestor: false }` if needed.\",\n      );\n    }\n\n    const other = new Path(potentialDescendant);\n    if (this.isAbsolutePath() !== other.isAbsolutePath()) {\n      return null;\n    }\n\n    // Leading slashes are okay, as they will result in a `\"\"` component for\n    // absolute paths (and we don't compare absolute paths to relative paths.)\n    const thisParts = this.toggleTrailingSlash(false).#path.split(\"/\");\n    const otherParts = other.toggleTrailingSlash(false).#path.split(\"/\");\n\n    if (otherParts.length < thisParts.length) {\n      return null;\n    }\n    for (let i = 0; i < thisParts.length; i++) {\n      if (thisParts[i] !== otherParts[i]) {\n        return null;\n      }\n    }\n    return new Path(\"./\")\n      .join(...otherParts.slice(thisParts.length))\n      .toggleTrailingSlash(other.hasTrailingSlash());\n  }\n\n  unresolve(path: string | URL | Path): Path {\n    return Path.resolve(path, this);\n  }\n\n  isAbsolutePath(): boolean {\n    return this.resolutionPrefix === ResolutionPrefix.Absolute;\n  }\n\n  toFileURL(): URL {\n    if (!this.isAbsolutePath()) {\n      throw new Error(\n        \"Tried to convert to file URL when the path is not absolute.\",\n      );\n    }\n    return pathToFileURL(this.#path);\n  }\n\n  /**\n   * The `Path` can have a trailing slash, indicating that it represents a\n   * directory. (If there is no trailing slash, it can represent either a file\n   * or a directory.)\n   *\n   * Some operations will refuse to treat a directory path as a file path. This\n   * function identifies such paths.\n   */\n  hasTrailingSlash(): boolean {\n    // TODO: handle Windows semantically\n    return this.#path.endsWith(\"/\");\n  }\n\n  /**\n   * Toggles or sets a trailing slash as specified.\n   * If the path is `/`, it will always be left as-is.\n   */\n  // Similar convention to:\n  // https://developer.mozilla.org/en-US/docs/Web/API/DOMTokenList/toggle Most\n  // use cases will probably use the `force` parameters, but supporting the\n  // \"toggle\" use case is easy to implement and hopefully will make the name\n  // and API more familiar to web devs.\n  toggleTrailingSlash(force?: boolean): Path {\n    if (this.#path === \"/\") {\n      return this;\n    }\n    const wantTrailingSlash = force ?? !this.hasTrailingSlash();\n    if (wantTrailingSlash) {\n      return this.hasTrailingSlash() ? this : this.join(\"./\");\n    } else {\n      return this.hasTrailingSlash() ? new Path(this.#path.slice(0, -1)) : this;\n    }\n  }\n\n  /**\n   * Same as `.toString()`, but more concise.\n   */\n  get path() {\n    return this.#path;\n  }\n\n  toString(): string {\n    return this.#path;\n  }\n\n  /**\n   * Format this with the escape codes for printing to the shell in bold blue.\n   *\n   * Example usage:\n   *\n   *     console.log(`Processing: ${path.blue}`)\n   *\n   */\n  get blue() {\n    const { styleText } = globalThis.process.getBuiltinModule(\"node:util\");\n    return styleText([\"bold\", \"blue\"], this.#path);\n  }\n\n  /** Constructs a new path by appending the given path segments.\n   * This follows `node` semantics for absolute paths: leading slashes in the given descendant segments are ignored.\n   */\n  join(...segments: (string | Path)[]): Path {\n    const segmentStrings = segments.map((segment) => {\n      const s = stringifyIfPath(segment);\n      if (resolutionPrefix(s) === ResolutionPrefix.Absolute) {\n        throw new Error(\n          \"Arguments to `.join(\u2026)` cannot be absolute. Use `.asRelative()` to convert them first if needed.\",\n        );\n      }\n      return s;\n    });\n    return new Path(\n      joinPreservingRelativeResolutionPrefix(this.#path, segmentStrings),\n    );\n  }\n\n  /**\n   * Adjust the prefix to construct a relative path.\n   *\n   * | Example input   | Output          |\n   * |-----------------|-----------------|\n   * | `\"bare\"`        | `\"./bare\"`      |\n   * | `\"./relative\"`  | `\"./relative\"`  |\n   * | `\"../up-first\"` | `\"../up-first\"` |\n   * | `\"/absolute\"`   | `\"./absolute\"`  |\n   *\n   */\n  asRelative(): Path {\n    return new Path(`./${this.#path}`);\n  }\n\n  /**\n   * Adjust the prefix to construct an absolute path.\n   *\n   * | Example input   | Output        |\n   * |-----------------|---------------|\n   * | `\"bare\"`        | `\"/bare\"`     |\n   * | `\"./relative\"`  | `\"/relative\"` |\n   * | `\"../up-first\"` | `\"/up-first\"` |\n   * | `\"/absolute\"`   | `\"/absolute\"` |\n   *\n   */\n  asAbsolute(): Path {\n    return new Path(join(\"/\", this.#path));\n  }\n\n  /**\n   * Adjust the prefix to construct a bare path. Note that this returns `\".\"` if\n   * there are no named paths left.\n   *\n   * | Example input     | Output       |\n   * |-------------------|--------------|\n   * | `\"bare\"`          | `\"bare\"`     |\n   * | `\"./relative\"  `  | `\"relative\"` |\n   * | `\"/absolute\"`     | `\"absolute\"` |\n   * | `\".\"`             | `\".\"`        |\n   * | `\"down-first/..\"` | `\".\"`        |\n   * | `\"../up-first\"`   | (error)      |\n   * | `\"..\"`            | (error)      |\n   *\n   * Specify `parentTraversalPrefixHandling` in the `options` if you would like\n   * to strip or keep resolution prefixes like `../` rather than erroring.\n   *\n   * | Example input        | Output with `{ parentTraversalPrefixHandling: \"strip\" }` |\n   * |----------------------|----------------------------------------------------------|\n   * | `\"../up-first\"`      | `\"up-first\"`                                             |\n   * | `\"..\"`               | `\".\"`                                                    |\n   *\n   * | Example input        | Output with `{ parentTraversalPrefixHandling: \"keep\" }` |\n   * |----------------------|---------------------------------------------------------|\n   * | `\"../up-first\"`      | `\"../up-first\"`                                         |\n   * | `\"..\"`               | `\"..\"`                                                  |\n   *\n   * If you need the output to start with a named component and return values\n   * like `.`, `..`, `../`, or `../\u2026` are not okay, pass\n   * `requireNamedComponentPrefix: true`. This is useful if the path represents\n   * an `npm`-style package name (e.g. `\"typescript\"`, `\"@biomejs/biome\"`).\n   *\n   */\n  asBare(options?: {\n    parentTraversalPrefixHandling?: \"error\" | \"strip\" | \"keep\";\n    requireNamedComponentPrefix?: boolean;\n  }): Path {\n    const path = new Path(join(\".\", this.#path));\n    if (!path.#path.startsWith(\"../\") && path.#path !== \"..\") {\n      if (\n        options?.requireNamedComponentPrefix &&\n        path.resolutionPrefix === ResolutionPrefix.Relative\n      ) {\n        throw new Error(\"Output does not start with a named component.\");\n      }\n      return path;\n    }\n    const parentTraversalHandling =\n      options?.parentTraversalPrefixHandling ?? \"error\";\n    switch (parentTraversalHandling) {\n      case \"error\": {\n        throw new Error(\n          'Converting path to a bare path resulted in a `..` traversal prefix. Pass `\"strip\"` or `\"keep\"` as the `parentTraversalHandling` option to avoid an error.',\n        );\n      }\n      case \"strip\": {\n        let newPath = path.#path.replace(/^(\\.\\.\\/)+/, \"\");\n        if ([\"\", \"..\"].includes(newPath)) {\n          newPath = \".\";\n        }\n        const output = new Path(newPath);\n        if (\n          options?.requireNamedComponentPrefix &&\n          output.resolutionPrefix === ResolutionPrefix.Relative\n        ) {\n          throw new Error(\"Output does not start with a named component.\");\n        }\n        return new Path(newPath);\n      }\n      case \"keep\": {\n        if (options?.requireNamedComponentPrefix) {\n          throw new Error(\"Output does not start with a named component.\");\n        }\n        return path;\n      }\n    }\n  }\n\n  extendBasename(suffix: string): Path {\n    const joinedSuffix = join(suffix);\n    if (joinedSuffix !== basename(joinedSuffix)) {\n      throw new Error(\"Invalid suffix to extend file name.\");\n    }\n    // TODO: join basename and dirname instead?\n    return new Path(this.#path + joinedSuffix);\n  }\n\n  get parent(): Path {\n    return new Path(dirname(this.#path));\n  }\n\n  // Normally I'd stick with `node`'s name, but I think `.dirname` is a\n  // particularly poor name. So we support `.dirname` for discovery but mark it\n  // as deprecated, even if it will never be removed.\n  /** @deprecated Alias for `.parent`. */\n  get dirname(): Path {\n    return this.parent;\n  }\n\n  get basename(): Path {\n    return new Path(basename(this.#path));\n  }\n\n  get extension(): string {\n    mustNotHaveTrailingSlash(this);\n    return extname(this.#path);\n  }\n\n  // Normally I'd stick with `node`'s name, but I think `.extname` is a\n  // particularly poor name. So we support `.extname` for discovery but mark it\n  // as deprecated, even if it will never be removed.\n  /** @deprecated Alias for `.extension`. */\n  get extname(): string {\n    return this.extension;\n  }\n\n  // TODO: find a neat way to dedup with the sync version?\n  async exists(constraints?: {\n    mustBe: \"file\" | \"directory\";\n  }): Promise<boolean> {\n    if (constraints?.mustBe === \"file\") {\n      mustNotHaveTrailingSlash(this);\n    }\n    let stats: Awaited<ReturnType<typeof stat>>;\n    try {\n      stats = await stat(this.#path);\n      // biome-ignore lint/suspicious/noExplicitAny: TypeScript limitation\n    } catch (e: any) {\n      if (e.code === \"ENOENT\") {\n        return false;\n      }\n      throw e;\n    }\n    if (!constraints?.mustBe) {\n      return true;\n    }\n    switch (constraints?.mustBe) {\n      case \"file\": {\n        if (stats.isFile()) {\n          return true;\n        }\n        throw new Error(`Path exists but is not a file: ${this.#path}`);\n      }\n      case \"directory\": {\n        if (stats.isDirectory()) {\n          return true;\n        }\n        throw new Error(`Path exists but is not a directory: ${this.#path}`);\n      }\n      default: {\n        throw new Error(\"Invalid path type constraint\");\n      }\n    }\n  }\n\n  async existsAsFile(): Promise<boolean> {\n    return this.exists({ mustBe: \"file\" });\n  }\n\n  async existsAsDir(): Promise<boolean> {\n    return this.exists({ mustBe: \"directory\" });\n  }\n\n  // I don't think `mkdir` is a great name, but it does match the\n  // well-established canonical commandline name. So in this case we keep the\n  // awkward abbreviation.\n  /** Defaults to `recursive: true`. */\n  async mkdir(options?: Parameters<typeof mkdir>[1]): Promise<Path> {\n    const optionsObject = (() => {\n      if (typeof options === \"string\" || typeof options === \"number\") {\n        return { mode: options };\n      }\n      return options ?? {};\n    })();\n    await mkdir(this.#path, { recursive: true, ...optionsObject });\n    return this;\n  }\n\n  // TODO: check idempotency semantics when the destination exists and is a folder.\n  /** Returns the destination path. */\n  async cp(\n    destination: string | URL | Path,\n    options?: Parameters<typeof cp>[2] & { createIntermediateDirs?: boolean },\n  ): Promise<Path> {\n    const { createIntermediateDirs, ...cpOptions } = options ?? {};\n    const destinationPath = new Path(destination);\n    if (createIntermediateDirs ?? true) {\n      await destinationPath.parent.mkdir();\n    }\n    await cp(this.#path, destinationPath.#path, cpOptions);\n    return destinationPath;\n  }\n\n  // TODO: check idempotency semantics when the destination exists and is a folder.\n  async rename(\n    destination: string | URL | Path,\n    options?: { createIntermediateDirs?: boolean },\n  ): Promise<Path> {\n    const destinationPath = new Path(destination);\n    if (options?.createIntermediateDirs ?? true) {\n      await destinationPath.parent.mkdir();\n    }\n    await rename(this.#path, destinationPath.#path);\n    return destinationPath;\n  }\n\n  /**\n   * Create a temporary dir inside the global temp dir for the current user.\n   *\n   * This can be used with [`await\n   * using`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/await_using)\n   * to automatically delete the dir when it goes out of scope.\n   *\n   *     {\n   *       await using tempDir = await Path.makeTempDir();\n   *       // Temporary dir exists while we're inside this block.\n   *     }\n   *     // Temporary dir has now been deleted.\n   *\n   * Note that (due to the semantics of JS runtime implementations) this does\n   * not delete the temp dir if the process calls `exit(\u2026)` before the `using`\n   * goes out of scope.\n   *\n   * */\n  static async makeTempDir(prefix?: string): Promise<AsyncDisposablePath> {\n    return new AsyncDisposablePath(\n      await mkdtemp(\n        new Path(tmpdir()).join(prefix ?? DEFAULT_TEMP_PREFIX).toString(),\n      ),\n    );\n  }\n\n  /**\n   * Return a path:\n   *\n   * - whose parent dir is a temp dir that *has* been created, but\n   * - which has itself not yet been created.\n   *\n   * Note that this path can actually also be used to create dir, but it is most\n   * convenient to get a path for a temporary file that can be written to, while\n   * having a disposal implementation that cleans everything up:\n   *\n   *     await using tempFile = await Path.tempFilePath({ basename: \"foo.txt\" });\n   *     await tempFile.write(\"hello world!\");\n   *     // \u2026\n   *\n   * Note that that the following are equivalent when *not* using `await using`:\n   *\n   *     await Path.tempFilePath({ basename: \"foo.txt\" });\n   *     (await Path.makeTempDir()).join(\"file.txt\");\n   *\n   * However, it is recommended to use `await using` to ensure cleanup.\n   */\n  static async tempFilePath(options: {\n    tempDirPrefix?: string;\n    basename?: string | Path;\n  }): Promise<AsyncDisposablePath> {\n    const tempDir = new Path(\n      await mkdtemp(\n        new Path(tmpdir())\n          .join(options?.tempDirPrefix ?? DEFAULT_TEMP_PREFIX)\n          .toString(),\n      ),\n    );\n    return new AsyncDisposablePath(\n      tempDir.join(options?.basename ?? DEFAULT_TEMP_FILE_NAME),\n      { disposePathInstead: tempDir },\n    );\n  }\n\n  async rm(options?: Parameters<typeof rm>[1]): Promise<void> {\n    await rm(this.#path, options);\n  }\n\n  async rmDir(): Promise<void> {\n    await rmdir(this.#path);\n  }\n\n  /**\n   * Equivalent to:\n   *\n   *     .rm({ recursive: true, force: true, ...(options ?? {}) })\n   *\n   */\n  async rm_rf(options?: Parameters<typeof rm>[1]): Promise<void> {\n    await this.rm({ recursive: true, force: true, ...(options ?? {}) });\n  }\n\n  read: typeof readFileType = (options) =>\n    // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.\n    readFile(this.#path, options as any) as any;\n\n  async readText(): Promise<string> {\n    return readFile(this.#path, \"utf-8\");\n  }\n\n  /**\n   * Yields one line from the text of the line at a time.\n   *\n   * This uses streams, so it can be considerably more efficient than calling e.g. `.split(\"\\n\")` on the output of {@link readText `.readText()`}.\n   *\n   * Note that this function does not have a `.readLinesSync()` counterpart.\n   */\n  async *readLines(): AsyncIterable<string> {\n    const stream = createReadStream(this.#path, \"utf-8\");\n    yield* createInterface({ input: stream, terminal: false });\n  }\n\n  /**\n   * Reads JSON from the given file and parses it. No validation is performed\n   * (beyond JSON parsing).\n   *\n   * An optional `fallback` value can be specified. It will be used if (and only\n   * if) the file does not exist.\n   *\n   */\n\n  // biome-ignore lint/suspicious/noExplicitAny: Allow a default of `any` to match `JSON.parse(\u2026)`.\n  async readJSON<T = any>(options?: { fallback?: T }): Promise<T> {\n    try {\n      return JSON.parse(await this.readText());\n    } catch (e) {\n      if (\n        (e as { code?: string }).code === \"ENOENT\" &&\n        options &&\n        \"fallback\" in options\n      ) {\n        return options.fallback as T;\n      }\n      throw e;\n    }\n  }\n\n  /**\n   * Returns the original `Path` (for chaining).\n   */\n  async appendFile(\n    data: Parameters<typeof appendFile>[1],\n    options?: Parameters<typeof appendFile>[2],\n  ): Promise<Path> {\n    await appendFile(this.#path, data, options);\n    return this;\n  }\n\n  /** Creates intermediate directories if they do not exist.\n   *\n   * Returns the original `Path` (for chaining).\n   */\n  async write(\n    data: WritableData | Promise<WritableData>,\n    options?: Parameters<typeof writeFile>[2],\n  ): Promise<Path> {\n    await this.parent.mkdir();\n    await writeFile(this.#path, await wrangleWritableData(data), options);\n    return this;\n  }\n\n  /**\n   * If only `data` is provided, this is equivalent to:\n   *\n   *     .write(JSON.stringify(data, null, \"  \"));\n   *\n   * `replacer` and `space` can also be specified, making this equivalent to:\n   *\n   *     .write(JSON.stringify(data, replacer, space));\n   *\n   * Returns the original `Path` (for chaining).\n   */\n  async writeJSON<T>(data: T, options?: WriteJSONOptions): Promise<Path> {\n    // TODO: file handle mechanism to avoid JSON serialization in memory.\n    await this.write(jsonChunks(data, options));\n    return this;\n  }\n\n  // Normally we'd add a `@deprecated` alias named `.readdir`, but that would\n  // differ only by capitalization of a single non-leading character. This can\n  // be a bit confusing, especially when autocompleting. So for this function in\n  // particular we don't include an alias.\n  readDir: typeof readDirType = (options) =>\n    // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.\n    readdir(this.#path, options as any) as any;\n\n  /** Returns the destination path. */\n  async symlink(\n    target: string | URL | Path,\n    type?: Parameters<typeof symlink>[2],\n  ): Promise<Path> {\n    const targetPath = new Path(target);\n    await symlink(\n      this.path,\n      targetPath.path,\n      type as Exclude<Parameters<typeof symlink>[2], undefined>, // \uD83E\uDD37\n    );\n    return targetPath;\n  }\n\n  // I don't think `realpath` is a great name, but it does match the\n  // well-established canonical commandline name. So in this case we keep the\n  // name instead of using `realPath`.\n  //\n  // Note: There are no options in our API, because the only option is an\n  // encoding. We set the encoding to construct the returned `Path`.\n  async realpath(): Promise<Path> {\n    return new Path(await realpath(this.#path, \"utf-8\"));\n  }\n\n  // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.\n  stat: typeof statType = (...options) => stat(this.#path, ...options) as any;\n\n  // I don't think `lstat` is a great name, but it does match the\n  // well-established canonical system call. So in this case we keep the\n  // awkward abbreviation.\n  lstat: typeof lstatType = (...options) =>\n    // biome-ignore lint/suspicious/noExplicitAny: Needed to wrangle the types.\n    lstat(this.#path, ...options) as any;\n\n  async chmod(mode: Parameters<typeof chmod>[1]): Promise<Path> {\n    await chmod(this.#path, mode);\n    return this;\n  }\n\n  /**\n   * Add the executable bit (for everyone) to the given path without modifying other bits (`chmod +x`).\n   */\n  async chmodX(): Promise<Path> {\n    const { mode } = await this.stat();\n    await this.chmod(\n      mode | constants.S_IXUSR | constants.S_IXGRP | constants.S_IXOTH,\n    );\n    return this;\n  }\n\n  static get homedir(): Path {\n    return new Path(homedir());\n  }\n\n  /**\n   * Get the current working directory as a path. Always includes a trailing slash.\n   * Note that this computes the `cwd` from fresh every time, in case it has changed for the current process.\n   */\n  static get cwd(): Path {\n    return new Path(cwd()).toggleTrailingSlash(true);\n  }\n\n  static xdg = xdg;\n\n  /** Chainable function to print the path. Prints the same as:\n   *\n   *     if (args.length > 0) {\n   *      console.log(...args);\n   *     }\n   *     console.log(this.path);\n   *\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: This is the correct type, based on `console.log(\u2026)`.\n  debugPrint(...args: any[]): Path {\n    if (args.length > 0) {\n      console.log(...args);\n    }\n    console.log(this.#path);\n    return this;\n  }\n}\n\nexport class AsyncDisposablePath extends Path {\n  #options?: { disposePathInstead: Path };\n  constructor(\n    path: ConstructorParameters<typeof Path>[0],\n    options?: { disposePathInstead: Path | string },\n  ) {\n    super(path);\n    if (options) {\n      this.#options = {\n        disposePathInstead: new Path(options.disposePathInstead),\n      };\n    }\n  }\n\n  async [Symbol.asyncDispose]() {\n    await (this.#options?.disposePathInstead ?? this).rm_rf();\n  }\n}\n\nexport function mustNotHaveTrailingSlash(path: Path): void {\n  if (path.hasTrailingSlash()) {\n    throw new Error(\n      \"Path ends with a slash, which cannot be treated as a file.\",\n    );\n  }\n}\n", "export interface WriteJSONOptions {\n  replacer?: Parameters<typeof JSON.stringify>[1];\n  space?: Parameters<typeof JSON.stringify>[2];\n  trailingNewline?: boolean;\n}\n\nconst JSON_WRITE_DEFAULTS: WriteJSONOptions = {\n  replacer: null,\n  space: \"  \",\n  trailingNewline: true,\n};\n\n/**\n * Returns an array of chunks, to ensure we don't perforn unnecessary in-memory concatenation before writing.\n */\nexport function jsonChunks<T>(data: T, options?: WriteJSONOptions): string[] {\n  const { replacer, space, trailingNewline } = {\n    ...JSON_WRITE_DEFAULTS,\n    ...options,\n  };\n  return [JSON.stringify(data, replacer, space), trailingNewline ? \"\\n\" : \"\"];\n}\n", "/** biome-ignore-all lint/complexity/useLiteralKeys: TODO: https://github.com/biomejs/biome/discussions/7572 */\n\nimport { Path } from \"./Path\";\n\nfunction env(): typeof import(\"node:process\").env {\n  const { env } = globalThis.process.getBuiltinModule(\"node:process\");\n  return env;\n}\n\nfunction varWithoutFallback(envVar: `XDG_${string}`): Path | undefined {\n  const value = env()[envVar];\n  return value ? Path.fromString(value) : undefined;\n}\n\nfunction varWithFallback(\n  envVar: `XDG_${string}`,\n  fallbackInHomeDir: string,\n): Path {\n  return varWithoutFallback(envVar) ?? Path.homedir.join(fallbackInHomeDir);\n}\n\n// This is a level of indirection to avoid accessing env vars or `homedir()`\n// until needed, to avoid permissions prompts / flags for `deno` when these are\n// not needed for the calling code.\n//\n// TODO: cache values?\nclass XDG {\n  get cache() {\n    return varWithFallback(\"XDG_CACHE_HOME\", \".cache\");\n  }\n  get config() {\n    return varWithFallback(\"XDG_CONFIG_HOME\", \".config\");\n  }\n  get data() {\n    return varWithFallback(\"XDG_DATA_HOME\", \".local/share\");\n  }\n  get state() {\n    return varWithFallback(\"XDG_STATE_HOME\", \".local/state\");\n  }\n  /**\n   * {@link Path.xdg.runtime} does not have a default value. Consider\n   * {@link Path.xdg.runtimeWithStateFallback} if you need a fallback but do not have a particular fallback in mind.\n   */\n  get runtime() {\n    return varWithoutFallback(\"XDG_RUNTIME_DIR\");\n  }\n  get runtimeWithStateFallback() {\n    return varWithoutFallback(\"XDG_RUNTIME_DIR\") ?? this.state;\n  }\n}\n\nexport const xdg = new XDG();\n", "import { Path } from \"./Path\";\n\n/**\n * This function is useful to serialize any `Path`s in a structure to pass on to\n * functions that do not know about the `Path` class, e.g.\n *\n *     function process(args: (string | Path)[]) {\n *       const argsAsStrings = args.map(stringifyIfPath);\n *     }\n *\n */\nexport function stringifyIfPath<T>(value: Exclude<T, Path> | Path): T | string {\n  if (value instanceof Path) {\n    return value.toString();\n  }\n  return value;\n}\n"],
-  "mappings": "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",
-  "names": ["env", "ResolutionPrefix"]
-}