@visulima/fs 5.0.0-alpha.6 → 5.0.0-alpha.7

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+## @visulima/fs [5.0.0-alpha.7](https://github.com/visulima/visulima/compare/@visulima/fs@5.0.0-alpha.6...@visulima/fs@5.0.0-alpha.7) (2026-04-08)
+
+### Bug Fixes
+
+* **fs:** prevent walk/walkSync from crashing on symlinks pointing to files ([e6338b0](https://github.com/visulima/visulima/commit/e6338b0c169048240762d22fe14152e370f7e862))
+* **fs:** properly fix eslint errors in code ([da36de3](https://github.com/visulima/visulima/commit/da36de37493cdd65aa28505d5fbdd671ce842663))
+* **fs:** remove remaining eslint suppressions with proper code fixes ([cede286](https://github.com/visulima/visulima/commit/cede2869d5a31a3b2cd020f2050dddbfd742a619))
+* **fs:** resolve eslint errors ([817fd4d](https://github.com/visulima/visulima/commit/817fd4d0f5f74debaf222837b94bd1f3a16d66ae))
+
+### Miscellaneous Chores
+
+* **filesystem:** remove empty dependency objects from package.json ([76ffc54](https://github.com/visulima/visulima/commit/76ffc545660695dde19130d1c01d9bd1aaf2ca98))
+* **fs:** add tsconfig.eslint.json for type-aware linting ([701b2cb](https://github.com/visulima/visulima/commit/701b2cb4801dbefe12db85ff3c772c6a8a975539))
+* **fs:** apply prettier formatting ([29bc3ed](https://github.com/visulima/visulima/commit/29bc3eda63666c911c8810be20e3b550eaab7377))
+* **fs:** migrate .prettierrc.cjs to prettier.config.js ([fa37870](https://github.com/visulima/visulima/commit/fa37870179d8dbebe210229a9fd00296efac5f4d))
+
+
+### Dependencies
+
+* **@visulima/path:** upgraded to 3.0.0-alpha.8
+* **@visulima/error:** upgraded to 6.0.0-alpha.8
+
 ## @visulima/fs [5.0.0-alpha.6](https://github.com/visulima/visulima/compare/@visulima/fs@5.0.0-alpha.5...@visulima/fs@5.0.0-alpha.6) (2026-03-26)
 
 ### Features

package/dist/error/walk-error.d.ts

@@ -1,5 +1,5 @@
 /**
- * Error thrown in {@linkcode walk} or {@linkcode walkSync} during iteration.
+ * Error thrown in walk or walkSync during iteration.
  * @example
  * ```javascript
  * import { WalkError } from "@visulima/fs/error";

package/dist/error.js

@@ -4,4 +4,4 @@ export { default as JSONError } from './packem_shared/JSONError-BkHRnInH.js';
 export { default as NotEmptyError } from './packem_shared/NotEmptyError-B21RUlVr.js';
 export { default as NotFoundError } from './packem_shared/NotFoundError-BIp61X6k.js';
 export { default as PermissionError } from './packem_shared/PermissionError-CjoiJgip.js';
-export { default as WalkError } from './packem_shared/WalkError-DUdQd6FT.js';
+export { default as WalkError } from './packem_shared/WalkError-DER5A43G.js';

package/dist/find/walk-sync.d.ts

@@ -1,7 +1,7 @@
 import type { WalkEntry, WalkOptions } from "../types.d.ts";
 /**
  * Synchronously walks the file tree rooted at `directory`, yielding each file or directory that matches the criteria specified in `options`.
- * This is the synchronous version of the {@linkcode walk} function.
+ * This is the synchronous version of the async walk function.
  * @param directory The root directory to start walking from.
  * @param options Optional configuration to control the walking process. See {@link WalkOptions}.
  * @param options.extensions List of file extensions used to filter entries.

package/dist/index.js

@@ -1,33 +1,33 @@
 export { FIND_UP_STOP, F_OK, R_OK, W_OK, X_OK } from './packem_shared/F_OK-MldBaGxb.js';
-export { default as ensureDir } from './packem_shared/ensureDir-C_kuQ5Ik.js';
-export { default as ensureDirSync } from './packem_shared/ensureDirSync-CI5g-uBI.js';
-export { default as ensureFile } from './packem_shared/ensureFile-BUtXGlGT.js';
-export { default as ensureFileSync } from './packem_shared/ensureFileSync-C8hASR-1.js';
-export { default as ensureLink } from './packem_shared/ensureLink-BPnAG5-P.js';
-export { default as ensureLinkSync } from './packem_shared/ensureLinkSync-B-Z7X0ub.js';
-export { default as ensureSymlink } from './packem_shared/ensureSymlink-U5B6J0BN.js';
-export { default as ensureSymlinkSync } from './packem_shared/ensureSymlinkSync-DHnZj-9F.js';
+export { default as ensureDir } from './packem_shared/ensureDir-DNlPftys.js';
+export { default as ensureDirSync } from './packem_shared/ensureDirSync-DcPZFMy5.js';
+export { default as ensureFile } from './packem_shared/ensureFile-BRQpUOUM.js';
+export { default as ensureFileSync } from './packem_shared/ensureFileSync-SBY7A9-C.js';
+export { default as ensureLink } from './packem_shared/ensureLink-DJQeauEn.js';
+export { default as ensureLinkSync } from './packem_shared/ensureLinkSync-D9RVAglV.js';
+export { default as ensureSymlink } from './packem_shared/ensureSymlink-CoRYDRwr.js';
+export { default as ensureSymlinkSync } from './packem_shared/ensureSymlinkSync-CFimFlgh.js';
 export { CRLF, EOL, LF, detect, format } from './eol.js';
-export { default as collect } from './packem_shared/collect-DcBwsYYd.js';
-export { default as collectSync } from './packem_shared/collectSync-Bkjf9Dbm.js';
-export { default as findUp } from './packem_shared/findUp-BSnyGqer.js';
-export { default as findUpSync } from './packem_shared/findUpSync-jRHbSCMV.js';
-export { default as walk } from './packem_shared/walk-BhTbpr3y.js';
-export { default as walkSync } from './packem_shared/walkSync-DDBq95s8.js';
+export { default as collect } from './packem_shared/collect-BnUYRrRI.js';
+export { default as collectSync } from './packem_shared/collectSync-D5G2RGDI.js';
+export { default as findUp } from './packem_shared/findUp-YcNLKdfV.js';
+export { default as findUpSync } from './packem_shared/findUpSync-BfA5fheN.js';
+export { default as walk } from './packem_shared/walk-D5yHruvk.js';
+export { default as walkSync } from './packem_shared/walkSync-09nKPVw4.js';
 export { default as isAccessible } from './packem_shared/isAccessible-DuVrTNFV.js';
 export { default as isAccessibleSync } from './packem_shared/isAccessibleSync-DI8mM0fA.js';
 export { move, moveSync, rename, renameSync } from './packem_shared/move-DbpW5_vA.js';
 export { default as readFile } from './packem_shared/readFile-Iz7kvCCk.js';
-export { default as readFileSync } from './packem_shared/readFileSync-6GEIrOnl.js';
-export { default as readJson } from './packem_shared/readJson-CJF1t7xB.js';
-export { default as readJsonSync } from './packem_shared/readJsonSync-ciofT7AF.js';
-export { default as emptyDir } from './packem_shared/emptyDir-CYB5Tict.js';
+export { default as readFileSync } from './packem_shared/readFileSync-gm9yfIhh.js';
+export { default as readJson } from './packem_shared/readJson-D0G0ndHL.js';
+export { default as readJsonSync } from './packem_shared/readJsonSync-B7oicPaL.js';
+export { default as emptyDir } from './packem_shared/emptyDir-Df4Tfjtk.js';
 export { default as emptyDirSync } from './packem_shared/emptyDirSync-BD8-1Ytl.js';
-export { default as remove } from './packem_shared/remove-_oDY3uKo.js';
-export { default as removeSync } from './packem_shared/removeSync-DETRj7Qn.js';
-export { sanitize } from './packem_shared/sanitize-lOzE6k2A.js';
-export { default as writeFile } from './packem_shared/writeFile-DSHERs0Z.js';
-export { default as writeFileSync } from './packem_shared/writeFileSync-CJp1kXQR.js';
-export { default as writeJson } from './packem_shared/writeJson-C0OfLDbe.js';
-export { default as writeJsonSync } from './packem_shared/writeJsonSync-Cs21FE7v.js';
+export { default as remove } from './packem_shared/remove-CNkjFFkQ.js';
+export { default as removeSync } from './packem_shared/removeSync-AnawYpPv.js';
+export { sanitize } from './packem_shared/sanitize-BZoLN9Fg.js';
+export { default as writeFile } from './packem_shared/writeFile-B8HX0JIQ.js';
+export { default as writeFileSync } from './packem_shared/writeFileSync-DB8vv8xR.js';
+export { default as writeJson } from './packem_shared/writeJson-Bo7C2UHw.js';
+export { default as writeJsonSync } from './packem_shared/writeJsonSync-BKZ_9Acr.js';
 export { isFsCaseSensitive } from './packem_shared/isFsCaseSensitive-D-ayleCy.js';

package/dist/packem_shared/{WalkError-DUdQd6FT.js → WalkError-DER5A43G.js}

@@ -7,7 +7,7 @@ class WalkError extends Error {
    * @param root The root directory path where the walk operation started or encountered the error.
    */
   constructor(cause, root) {
-    super(`${cause instanceof Error ? cause.message : cause} for path "${root}"`);
+    super(`${cause instanceof Error ? cause.message : String(cause)} for path "${root}"`);
     this.cause = cause;
     this.root = root;
   }

package/dist/packem_shared/{collect-DcBwsYYd.js → collect-BnUYRrRI.js}

@@ -1,4 +1,4 @@
-import walk from './walk-BhTbpr3y.js';
+import walk from './walk-D5yHruvk.js';
 
 const collect = async (directory, options = {}) => {
   if (!Array.isArray(options.extensions)) {

package/dist/packem_shared/{collectSync-Bkjf9Dbm.js → collectSync-D5G2RGDI.js}

@@ -1,4 +1,4 @@
-import walkSync from './walkSync-DDBq95s8.js';
+import walkSync from './walkSync-09nKPVw4.js';
 
 const collectSync = (directory, options = {}) => {
   if (!Array.isArray(options.extensions)) {

package/dist/packem_shared/{emptyDir-CYB5Tict.js → emptyDir-Df4Tfjtk.js}

@@ -35,7 +35,8 @@ const emptyDir = async (dir, options) => {
     await mkdir(dir, { recursive: true });
     return;
   }
-  for await (const item of await readdir(dir)) {
+  const items = await readdir(dir);
+  for (const item of items) {
     await rm(join(toPath(dir), item), { ...options, force: true, recursive: true });
   }
 };

package/dist/packem_shared/{ensureDir-C_kuQ5Ik.js → ensureDir-DNlPftys.js}

@@ -29,7 +29,7 @@ const ensureDir = async (directory) => {
   try {
     const fileInfo = await lstat(directory);
     if (!fileInfo.isDirectory()) {
-      throw new Error(`Ensure path exists, expected 'dir', got '${getFileInfoType(fileInfo)}'`);
+      throw new Error(`Ensure path exists, expected 'dir', got '${String(getFileInfoType(fileInfo))}'`);
     }
     return;
   } catch (error) {
@@ -45,7 +45,7 @@ const ensureDir = async (directory) => {
     }
     const fileInfo = await lstat(directory);
     if (!fileInfo.isDirectory()) {
-      throw new Error(`Ensure path exists, expected 'dir', got '${getFileInfoType(fileInfo)}'`);
+      throw new Error(`Ensure path exists, expected 'dir', got '${String(getFileInfoType(fileInfo))}'`, { cause: error });
     }
   }
 };

package/dist/packem_shared/{ensureDirSync-CI5g-uBI.js → ensureDirSync-DcPZFMy5.js}

@@ -29,7 +29,7 @@ const ensureDirSync = (directory) => {
   try {
     const fileInfo = lstatSync(directory);
     if (!fileInfo.isDirectory()) {
-      throw new Error(`Ensure path exists, expected 'dir', got '${getFileInfoType(fileInfo)}'`);
+      throw new Error(`Ensure path exists, expected 'dir', got '${String(getFileInfoType(fileInfo))}'`);
     }
     return;
   } catch (error) {
@@ -45,7 +45,7 @@ const ensureDirSync = (directory) => {
     }
     const fileInfo = lstatSync(directory);
     if (!fileInfo.isDirectory()) {
-      throw new Error(`Ensure path exists, expected 'dir', got '${getFileInfoType(fileInfo)}'`);
+      throw new Error(`Ensure path exists, expected 'dir', got '${String(getFileInfoType(fileInfo))}'`, { cause: error });
     }
   }
 };

package/dist/packem_shared/{ensureFile-BUtXGlGT.js → ensureFile-BRQpUOUM.js}

@@ -24,7 +24,7 @@ const {
 import { dirname } from '@visulima/path';
 import { toPath } from '@visulima/path/utils';
 import assertValidFileOrDirectoryPath from './assertValidFileOrDirectoryPath-8HANmVjk.js';
-import ensureDir from './ensureDir-C_kuQ5Ik.js';
+import ensureDir from './ensureDir-DNlPftys.js';
 import { g as getFileInfoType } from './get-file-info-type-FD4-jsyg.js';
 
 const ensureFile = async (filePath) => {
@@ -32,7 +32,7 @@ const ensureFile = async (filePath) => {
   try {
     const stat = await lstat(filePath);
     if (!stat.isFile()) {
-      throw new Error(`Ensure path exists, expected 'file', got '${getFileInfoType(stat)}'`);
+      throw new Error(`Ensure path exists, expected 'file', got '${String(getFileInfoType(stat))}'`);
     }
   } catch (error) {
     if (error.code === "ENOENT") {

package/dist/packem_shared/{ensureFileSync-C8hASR-1.js → ensureFileSync-SBY7A9-C.js}

@@ -24,7 +24,7 @@ const {
 import { dirname } from '@visulima/path';
 import { toPath } from '@visulima/path/utils';
 import assertValidFileOrDirectoryPath from './assertValidFileOrDirectoryPath-8HANmVjk.js';
-import ensureDirSync from './ensureDirSync-CI5g-uBI.js';
+import ensureDirSync from './ensureDirSync-DcPZFMy5.js';
 import { g as getFileInfoType } from './get-file-info-type-FD4-jsyg.js';
 
 const ensureFileSync = (filePath) => {
@@ -32,7 +32,7 @@ const ensureFileSync = (filePath) => {
   try {
     const stat = lstatSync(filePath);
     if (!stat.isFile()) {
-      throw new Error(`Ensure path exists, expected 'file', got '${getFileInfoType(stat)}'`);
+      throw new Error(`Ensure path exists, expected 'file', got '${String(getFileInfoType(stat))}'`);
     }
   } catch (error) {
     if (error.code === "ENOENT") {

package/dist/packem_shared/{ensureLink-BPnAG5-P.js → ensureLink-DJQeauEn.js}

@@ -24,7 +24,7 @@ const {
 import { toNamespacedPath, dirname } from '@visulima/path';
 import { toPath } from '@visulima/path/utils';
 import assertValidFileOrDirectoryPath from './assertValidFileOrDirectoryPath-8HANmVjk.js';
-import ensureDir from './ensureDir-C_kuQ5Ik.js';
+import ensureDir from './ensureDir-DNlPftys.js';
 import { i as isStatsIdentical } from './is-stats-identical-D8FxpvQU.js';
 
 const ensureLink = async (source, destination) => {
@@ -41,8 +41,9 @@ const ensureLink = async (source, destination) => {
   try {
     sourceStat = await lstat(source);
   } catch (error) {
-    error.message = error.message.replace("lstat", "ensureLink");
-    throw error;
+    const nodeError = error;
+    nodeError.message = nodeError.message.replace("lstat", "ensureLink");
+    throw nodeError;
   }
   if (destinationStat && isStatsIdentical(sourceStat, destinationStat)) {
     return;

package/dist/packem_shared/{ensureLinkSync-B-Z7X0ub.js → ensureLinkSync-D9RVAglV.js}

@@ -24,7 +24,7 @@ const {
 import { toNamespacedPath, dirname } from '@visulima/path';
 import { toPath } from '@visulima/path/utils';
 import assertValidFileOrDirectoryPath from './assertValidFileOrDirectoryPath-8HANmVjk.js';
-import ensureDirSync from './ensureDirSync-CI5g-uBI.js';
+import ensureDirSync from './ensureDirSync-DcPZFMy5.js';
 import { i as isStatsIdentical } from './is-stats-identical-D8FxpvQU.js';
 
 const ensureLinkSync = (source, destination) => {
@@ -41,8 +41,9 @@ const ensureLinkSync = (source, destination) => {
   try {
     sourceStat = lstatSync(source);
   } catch (error) {
-    error.message = error.message.replace("lstat", "ensureLink");
-    throw error;
+    const nodeError = error;
+    nodeError.message = nodeError.message.replace("lstat", "ensureLink");
+    throw nodeError;
   }
   if (destinationStat && isStatsIdentical(sourceStat, destinationStat)) {
     return;

package/dist/packem_shared/{ensureSymlink-U5B6J0BN.js → ensureSymlink-CoRYDRwr.js}

@@ -26,7 +26,7 @@ const {
 import { toNamespacedPath, dirname, resolve } from '@visulima/path';
 import { toPath } from '@visulima/path/utils';
 import assertValidFileOrDirectoryPath from './assertValidFileOrDirectoryPath-8HANmVjk.js';
-import ensureDir from './ensureDir-C_kuQ5Ik.js';
+import ensureDir from './ensureDir-DNlPftys.js';
 import { g as getFileInfoType } from './get-file-info-type-FD4-jsyg.js';
 import { i as isStatsIdentical } from './is-stats-identical-D8FxpvQU.js';
 import { r as resolveSymlinkTarget } from './resolve-symlink-target-Kh4GovFf.js';
@@ -51,7 +51,14 @@ const ensureSymlink = async (target, linkName, type) => {
   const sourceStatInfo = await lstat(targetRealPath);
   const sourceFilePathType = getFileInfoType(sourceStatInfo);
   await ensureDir(dirname(linkName));
-  const symlinkType = type ?? (isWindows ? "junction" : sourceFilePathType === "dir" ? "dir" : "file");
+  let symlinkType = type ?? "file";
+  if (!type) {
+    if (isWindows) {
+      symlinkType = "junction";
+    } else {
+      symlinkType = sourceFilePathType === "dir" ? "dir" : "file";
+    }
+  }
   try {
     await symlink(toNamespacedPath(toPath(targetRealPath)), linkName, symlinkType);
   } catch (error) {
@@ -60,7 +67,7 @@ const ensureSymlink = async (target, linkName, type) => {
     }
     const linkStatInfo = await lstat(linkName);
     if (!linkStatInfo.isSymbolicLink()) {
-      throw new AlreadyExistsError(`A ${getFileInfoType(linkStatInfo)} already exists at the path: ${linkName}`);
+      throw new AlreadyExistsError(`A ${String(getFileInfoType(linkStatInfo))} already exists at the path: ${linkName}`);
     }
     const linkPath = await readlink(linkName);
     const linkRealPath = toNamespacedPath(resolve(linkPath));

package/dist/packem_shared/{ensureSymlinkSync-DHnZj-9F.js → ensureSymlinkSync-CFimFlgh.js}

@@ -26,7 +26,7 @@ const {
 import { toNamespacedPath, dirname, resolve } from '@visulima/path';
 import { toPath } from '@visulima/path/utils';
 import assertValidFileOrDirectoryPath from './assertValidFileOrDirectoryPath-8HANmVjk.js';
-import ensureDirSync from './ensureDirSync-CI5g-uBI.js';
+import ensureDirSync from './ensureDirSync-DcPZFMy5.js';
 import { g as getFileInfoType } from './get-file-info-type-FD4-jsyg.js';
 import { i as isStatsIdentical } from './is-stats-identical-D8FxpvQU.js';
 import { r as resolveSymlinkTarget } from './resolve-symlink-target-Kh4GovFf.js';
@@ -52,7 +52,14 @@ const ensureSymlinkSync = (target, linkName, type) => {
   const sourceStatInfo = lstatSync(targetRealPath);
   const sourceFilePathType = getFileInfoType(sourceStatInfo);
   ensureDirSync(dirname(linkName));
-  const symlinkType = type ?? (isWindows ? "junction" : sourceFilePathType === "dir" ? "dir" : "file");
+  let symlinkType = type ?? "file";
+  if (!type) {
+    if (isWindows) {
+      symlinkType = "junction";
+    } else {
+      symlinkType = sourceFilePathType === "dir" ? "dir" : "file";
+    }
+  }
   try {
     symlinkSync(toNamespacedPath(toPath(targetRealPath)), linkName, symlinkType);
   } catch (error) {
@@ -61,7 +68,7 @@ const ensureSymlinkSync = (target, linkName, type) => {
     }
     const linkStatInfo = lstatSync(linkName);
     if (!linkStatInfo.isSymbolicLink()) {
-      throw new AlreadyExistsError(`A ${getFileInfoType(linkStatInfo)} already exists at the path: ${linkName}`);
+      throw new AlreadyExistsError(`A ${String(getFileInfoType(linkStatInfo))} already exists at the path: ${linkName}`);
     }
     const linkPath = readlinkSync(linkName);
     const linkRealPath = toNamespacedPath(resolve(linkPath));

package/dist/packem_shared/{findUp-BSnyGqer.js → findUp-YcNLKdfV.js}

@@ -51,12 +51,11 @@ const findUp = async (name, options = {}) => {
     }
     return [name];
   };
-  if (options.allowSymlinks === void 0) {
-    options.allowSymlinks = true;
-  }
+  options.allowSymlinks ??= true;
   const statFunction = options.allowSymlinks ? stat : lstat;
   while (directory && directory !== stopAt && directory !== root) {
-    for await (let fileName of await getMatchers(directory)) {
+    const matchers = await getMatchers(directory);
+    for (let fileName of matchers) {
       if (fileName === FIND_UP_STOP) {
         return void 0;
       }

package/dist/packem_shared/{findUpSync-jRHbSCMV.js → findUpSync-BfA5fheN.js}

@@ -51,9 +51,7 @@ const findUpSync = (name, options = {}) => {
     }
     return [name];
   };
-  if (options.allowSymlinks === void 0) {
-    options.allowSymlinks = true;
-  }
+  options.allowSymlinks ??= true;
   const statFunction = options.allowSymlinks ? statSync : lstatSync;
   while (directory && directory !== stopAt && directory !== root) {
     for (let fileName of getMatchers(directory)) {

package/dist/packem_shared/{parseJson-Cnex0kz2.js → parseJson-BedVi91S.js}

@@ -1,11 +1,11 @@
 import JSONError from './JSONError-BkHRnInH.js';
 
 const normalizeLF = (code) => code.replaceAll(/\r\n|\r(?!\n)|\n/gu, "\n");
-const _process = globalThis.process || /* @__PURE__ */ Object.create(null);
+const rawProcess = globalThis.process ?? /* @__PURE__ */ Object.create(null);
 const processShims = {
   versions: {}
 };
-const process = /* @__PURE__ */ new Proxy(_process, {
+const process = /* @__PURE__ */ new Proxy(rawProcess, {
   get(target, property) {
     if (property in target) {
       return target[property];
@@ -80,9 +80,9 @@ const codeFrame = (source, loc, options) => {
       ...options?.color
     }
   };
-  const hasColumns = loc.start && typeof loc.start.column === "number";
+  const hasColumns = typeof loc.start.column === "number";
   let lines = normalizeLF(source).split("\n");
-  if (typeof config?.tabWidth === "number") {
+  if (typeof config.tabWidth === "number") {
     lines = lines.map((ln) => ln.replaceAll("	", " ".repeat(config.tabWidth)));
   }
   const { end, markerLines, start } = getMarkerLines(loc, lines, config.linesAbove, config.linesBelow);
@@ -91,7 +91,7 @@ const codeFrame = (source, loc, options) => {
   let frame = lines.slice(start, end).map((line, index) => {
     const number = start + 1 + index;
     const hasMarker = markerLines[number];
-    const paddedNumber = ` ${number}`.slice(-numberMaxWidth);
+    const paddedNumber = ` ${String(number)}`.slice(-numberMaxWidth);
     const lastMarkerLine = !markerLines[number + 1];
     const gutter = ` ${paddedNumber}${config.showGutter ? " |" : ""}`;
     if (hasMarker) {
@@ -137,9 +137,10 @@ const binarySearch = (element, array) => {
   }
   return m;
 };
+const LINE_BREAK_REGEX = /\n|\r(?!\n)/;
 const getLineStartIndexes = (string_) => (
   // eslint-disable-next-line unicorn/no-array-reduce
-  string_.split(/\n|\r(?!\n)/).reduce(
+  string_.split(LINE_BREAK_REGEX).reduce(
     (accumulator, current) => {
       accumulator.push(accumulator.at(-1) + current.length + 1);
       return accumulator;
@@ -178,25 +179,25 @@ const generateCodeFrame = (source, location, options) => codeFrame(
     ...options
   }
 );
+const JSON_POSITION_REGEX = /in JSON at position (\d+)(?: \(line (\d+) column (\d+)\))?$/;
 const getErrorLocation = (source, message) => {
-  const match = /in JSON at position (?<index>\d+)(?: \(line (?<line>\d+) column (?<column>\d+)\))?$/.exec(message);
+  const match = JSON_POSITION_REGEX.exec(message);
   if (!match) {
     return void 0;
   }
-  let { column, index, line } = match.groups;
-  if (line && column) {
-    return { column: Number(column), line: Number(line) };
+  const [, indexString, lineString, columnString] = match;
+  if (lineString && columnString) {
+    return { column: Number(columnString), line: Number(lineString) };
   }
-  index = Number(index);
+  let index = Number(indexString);
   if (index === source.length) {
     index = source.length - 1;
   }
   return indexToLineColumn(source, index);
 };
+const UNEXPECTED_TOKEN_REGEX = /(?<=^Unexpected token )(?<quote>')?(.)\k<quote>/;
 const addCodePointToUnexpectedToken = (message) => message.replace(
-  // The token is always quoted after Node.js 20, but we handle both cases for compatibility
-  // eslint-disable-next-line regexp/no-potentially-useless-backreference
-  /(?<=^Unexpected token )(?<quote>')?(.)\k<quote>/,
+  UNEXPECTED_TOKEN_REGEX,
   (_, _quote, token) => `"${token}"(${getCodePoint(token)})`
 );
 function parseJson(string, reviver, fileName, options) {

package/dist/packem_shared/{readFileSync-6GEIrOnl.js → readFileSync-gm9yfIhh.js}

@@ -46,7 +46,8 @@ const readFileSync = (path, options) => {
   }
   const { buffer, compression, encoding, flag } = options ?? {};
   const content = readFileSync$1(path, flag ? { encoding, flag } : { encoding });
-  const decompressed = decompressionMethods[compression ?? "none"](content);
+  const decompress = decompressionMethods[compression ?? "none"];
+  const decompressed = decompress(content);
   return buffer ? decompressed : decompressed.toString();
 };
 

package/dist/packem_shared/{readJson-CJF1t7xB.js → readJson-D0G0ndHL.js}

@@ -1,5 +1,5 @@
 import { toPath } from '@visulima/path/utils';
-import parseJson from './parseJson-Cnex0kz2.js';
+import parseJson from './parseJson-BedVi91S.js';
 import readFile from './readFile-Iz7kvCCk.js';
 
 async function readJson(path, reviver, options) {

package/dist/packem_shared/{readJsonSync-ciofT7AF.js → readJsonSync-B7oicPaL.js}

@@ -1,6 +1,6 @@
 import { toPath } from '@visulima/path/utils';
-import parseJson from './parseJson-Cnex0kz2.js';
-import readFileSync from './readFileSync-6GEIrOnl.js';
+import parseJson from './parseJson-BedVi91S.js';
+import readFileSync from './readFileSync-gm9yfIhh.js';
 
 function readJsonSync(path, reviver, options) {
   if (typeof reviver === "object") {

package/dist/packem_shared/{readYamlSync-DMV4U-gi.js → readYamlSync-BKX-PAfq.js}

@@ -1,5 +1,5 @@
 import { parse } from 'yaml';
-import readFileSync from './readFileSync-6GEIrOnl.js';
+import readFileSync from './readFileSync-gm9yfIhh.js';
 
 function readYamlSync(path, reviver, options) {
   const { buffer, compression, encoding = "utf8", flag, ...parseOptions } = options ?? {};

package/dist/packem_shared/{remove-_oDY3uKo.js → remove-CNkjFFkQ.js}

@@ -30,7 +30,7 @@ const remove = async (path, options = {}) => {
   } catch {
   }
   try {
-    await rm(path, { force: true, maxRetries: options?.maxRetries, recursive: true, retryDelay: options?.retryDelay });
+    await rm(path, { force: true, maxRetries: options.maxRetries, recursive: true, retryDelay: options.retryDelay });
   } catch {
   }
 };

package/dist/packem_shared/{removeSync-DETRj7Qn.js → removeSync-AnawYpPv.js}

@@ -30,7 +30,7 @@ const removeSync = (path, options = {}) => {
   } catch {
   }
   try {
-    rmSync(path, { force: true, maxRetries: options?.maxRetries, recursive: true, retryDelay: options?.retryDelay });
+    rmSync(path, { force: true, maxRetries: options.maxRetries, recursive: true, retryDelay: options.retryDelay });
   } catch {
   }
 };

package/dist/packem_shared/{sanitize-lOzE6k2A.js → sanitize-BZoLN9Fg.js}

@@ -73,7 +73,7 @@ const cleanWindowsName = (name) => {
     const extension = name.slice(lastDotIndex);
     let cleanedBaseName = baseName;
     while (cleanedBaseName.length > 0) {
-      const char = cleanedBaseName[cleanedBaseName.length - 1];
+      const char = cleanedBaseName.at(-1);
       if (char === void 0 || !TRIM_CHARS.has(char)) {
         break;
       }
@@ -86,7 +86,7 @@ const cleanWindowsName = (name) => {
   }
   let cleaned = name;
   while (cleaned.length > 0) {
-    const char = cleaned[cleaned.length - 1];
+    const char = cleaned.at(-1);
     if (char === void 0 || !TRIM_CHARS.has(char)) {
       break;
     }
@@ -104,7 +104,7 @@ const isWindowsReservedName = (name) => {
   }
   let trimmed = name;
   while (trimmed.length > 0) {
-    const char = trimmed[trimmed.length - 1];
+    const char = trimmed.at(-1);
     if (char === void 0 || !TRIM_CHARS.has(char)) {
       break;
     }

package/dist/packem_shared/{walk-BhTbpr3y.js → walk-D5yHruvk.js}

@@ -24,7 +24,7 @@ const {
 } = __cjs_getBuiltinModule("node:fs/promises");
 import { resolve, join, normalize, basename } from '@visulima/path';
 import { toPath } from '@visulima/path/utils';
-import WalkError from './WalkError-DUdQd6FT.js';
+import WalkError from './WalkError-DER5A43G.js';
 import assertValidFileOrDirectoryPath from './assertValidFileOrDirectoryPath-8HANmVjk.js';
 import { g as globToRegExp, w as walkInclude } from './walk-include-CZco7BvN.js';
 
@@ -64,26 +64,28 @@ async function* walk(directory, {
     return;
   }
   try {
-    for await (const entry of await readdir(directory, {
+    const entries = await readdir(directory, {
       withFileTypes: true
-    })) {
+    });
+    for (const entry of entries) {
       let path = join(directory, entry.name);
       if (entry.isSymbolicLink()) {
         if (followSymlinks) {
           path = await realpath(path);
         } else if (includeSymlinks && walkInclude(path, extensions, mappedMatch, mappedSkip)) {
           yield {
-            isDirectory: entry.isDirectory,
-            isFile: entry.isFile,
-            isSymbolicLink: entry.isSymbolicLink,
+            isDirectory: () => entry.isDirectory(),
+            isFile: () => entry.isFile(),
+            isSymbolicLink: () => entry.isSymbolicLink(),
             name: entry.name,
             path
           };
+          continue;
         } else {
           continue;
         }
       }
-      if (entry.isSymbolicLink() || entry.isDirectory()) {
+      if (entry.isDirectory()) {
         yield* walk(path, {
           extensions,
           followSymlinks,

package/dist/packem_shared/{walkSync-DDBq95s8.js → walkSync-09nKPVw4.js}

@@ -24,7 +24,7 @@ const {
 } = __cjs_getBuiltinModule("node:fs");
 import { resolve, join, normalize, basename } from '@visulima/path';
 import { toPath } from '@visulima/path/utils';
-import WalkError from './WalkError-DUdQd6FT.js';
+import WalkError from './WalkError-DER5A43G.js';
 import assertValidFileOrDirectoryPath from './assertValidFileOrDirectoryPath-8HANmVjk.js';
 import { g as globToRegExp, w as walkInclude } from './walk-include-CZco7BvN.js';
 
@@ -32,9 +32,9 @@ const _createWalkEntry = (path) => {
   const normalizePath = normalize(path);
   const info = statSync(normalizePath);
   return {
-    isDirectory: info.isDirectory,
-    isFile: info.isFile,
-    isSymbolicLink: info.isSymbolicLink,
+    isDirectory: () => info.isDirectory(),
+    isFile: () => info.isFile(),
+    isSymbolicLink: () => info.isSymbolicLink(),
     name: basename(normalizePath),
     path: normalizePath
   };
@@ -63,26 +63,28 @@ function* walkSync(directory, {
     return;
   }
   try {
-    for (const entry of readdirSync(directory, {
+    const entries = readdirSync(directory, {
       withFileTypes: true
-    })) {
+    });
+    for (const entry of entries) {
       let path = join(directory, entry.name);
       if (entry.isSymbolicLink()) {
         if (followSymlinks) {
           path = realpathSync(path);
         } else if (includeSymlinks && walkInclude(path, extensions, mappedMatch, mappedSkip)) {
           yield {
-            isDirectory: entry.isDirectory,
-            isFile: entry.isFile,
-            isSymbolicLink: entry.isSymbolicLink,
+            isDirectory: () => entry.isDirectory(),
+            isFile: () => entry.isFile(),
+            isSymbolicLink: () => entry.isSymbolicLink(),
             name: entry.name,
             path: normalize(path)
           };
+          continue;
         } else {
           continue;
         }
       }
-      if (entry.isSymbolicLink() || entry.isDirectory()) {
+      if (entry.isDirectory()) {
         yield* walkSync(path, {
           extensions,
           followSymlinks,
@@ -95,9 +97,9 @@ function* walkSync(directory, {
         });
       } else if (entry.isFile() && includeFiles && walkInclude(path, extensions, mappedMatch, mappedSkip)) {
         yield {
-          isDirectory: entry.isDirectory,
-          isFile: entry.isFile,
-          isSymbolicLink: entry.isSymbolicLink,
+          isDirectory: () => entry.isDirectory(),
+          isFile: () => entry.isFile(),
+          isSymbolicLink: () => entry.isSymbolicLink(),
           name: entry.name,
           path: normalize(path)
         };

package/dist/packem_shared/{writeFile-DSHERs0Z.js → writeFile-B8HX0JIQ.js}

@@ -58,9 +58,7 @@ const writeFile = async (path, content, options) => {
     await writeFile$1(temporaryPath, toUint8Array(content), { encoding: options.encoding, flag: options.flag });
     if (pathExists && !options.overwrite) {
       stat$1 = await stat(path);
-      if (options.chown === void 0) {
-        options.chown = { gid: stat$1.gid, uid: stat$1.uid };
-      }
+      options.chown ??= { gid: stat$1.gid, uid: stat$1.uid };
       await rename(path, `${path}.bak`);
     }
     if (options.chown) {

package/dist/packem_shared/{writeFileSync-CJp1kXQR.js → writeFileSync-DB8vv8xR.js}

@@ -58,9 +58,7 @@ const writeFileSync = (path, content, options) => {
     writeFileSync$1(temporaryPath, toUint8Array(content), { encoding: options.encoding, flag: options.flag });
     if (pathExists && !options.overwrite) {
       stat = statSync(path);
-      if (options.chown === void 0) {
-        options.chown = { gid: stat.gid, uid: stat.uid };
-      }
+      options.chown ??= { gid: stat.gid, uid: stat.uid };
       renameSync(path, `${path}.bak`);
     }
     if (options.chown) {

package/dist/packem_shared/{writeJson-C0OfLDbe.js → writeJson-Bo7C2UHw.js}

@@ -23,7 +23,7 @@ const {
 import { d as detectIndent } from './index-CHM-in-V.js';
 import { R_OK } from './F_OK-MldBaGxb.js';
 import isAccessible from './isAccessible-DuVrTNFV.js';
-import writeFile from './writeFile-DSHERs0Z.js';
+import writeFile from './writeFile-B8HX0JIQ.js';
 
 const writeJson = async (path, data, options = {}) => {
   const { detectIndent: detectIndent$1, indent: indentOption, replacer, stringify = JSON.stringify, ...writeOptions } = { indent: "	", ...options };

package/dist/packem_shared/{writeJsonSync-Cs21FE7v.js → writeJsonSync-BKZ_9Acr.js}

@@ -23,7 +23,7 @@ const {
 import { d as detectIndent } from './index-CHM-in-V.js';
 import { R_OK } from './F_OK-MldBaGxb.js';
 import isAccessibleSync from './isAccessibleSync-DI8mM0fA.js';
-import writeFileSync from './writeFileSync-CJp1kXQR.js';
+import writeFileSync from './writeFileSync-DB8vv8xR.js';
 
 const writeJsonSync = (path, data, options = {}) => {
   const { detectIndent: detectIndent$1, indent: indentOption, replacer, stringify = JSON.stringify, ...writeOptions } = { indent: "	", ...options };

package/dist/packem_shared/{writeYaml-n4xzYN9a.js → writeYaml-BWCOome-.js}

@@ -1,5 +1,5 @@
 import { stringify } from 'yaml';
-import writeFile from './writeFile-DSHERs0Z.js';
+import writeFile from './writeFile-B8HX0JIQ.js';
 
 async function writeYaml(path, data, replacer, options) {
   let stringifyOptions;
@@ -9,10 +9,10 @@ async function writeYaml(path, data, replacer, options) {
     stringifyOptions = replacer;
     effectiveReplacer = stringifyOptions.replacer;
     space = stringifyOptions.space;
-  } else if (typeof options === "object" && options !== null) {
+  } else if (typeof options === "object") {
     stringifyOptions = options;
     effectiveReplacer = replacer;
-    space = stringifyOptions.space ?? (typeof options === "number" || typeof options === "string" ? options : void 0);
+    space = stringifyOptions.space;
   } else {
     effectiveReplacer = replacer;
     space = options;

package/dist/packem_shared/{writeYamlSync-DnOEnP10.js → writeYamlSync-DBVnXmuY.js}

@@ -1,5 +1,5 @@
 import { stringify } from 'yaml';
-import writeFileSync from './writeFileSync-CJp1kXQR.js';
+import writeFileSync from './writeFileSync-DB8vv8xR.js';
 
 function writeYamlSync(path, data, replacer, options) {
   let stringifyOptions;
@@ -9,10 +9,10 @@ function writeYamlSync(path, data, replacer, options) {
     stringifyOptions = replacer;
     effectiveReplacer = stringifyOptions.replacer;
     space = stringifyOptions.space;
-  } else if (typeof options === "object" && options !== null) {
+  } else if (typeof options === "object") {
     stringifyOptions = options;
     effectiveReplacer = replacer;
-    space = stringifyOptions.space ?? (typeof options === "number" || typeof options === "string" ? options : void 0);
+    space = stringifyOptions.space;
   } else {
     effectiveReplacer = replacer;
     space = options;

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

@@ -1,5 +1,5 @@
 import type { ContentType, ReadFileOptions } from "../types.d.ts";
-type DecompressionMethod = (buffer: Buffer, callback: (error: Error | null, result: Buffer) => void) => void;
+type DecompressionMethod = (buffer: Buffer) => Buffer;
 declare const decompressionMethods: Record<string, DecompressionMethod>;
 /**
  * Synchronously reads the entire contents of a file.

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

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

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

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

package/dist/size.js

@@ -67,7 +67,9 @@ const getCompressedStreamSizeEfficient = async (stream, createCompressor) => {
     compressor.on("data", (chunk) => {
       totalSize += chunk.length;
     });
-    compressor.on("end", () => resolve2(totalSize));
+    compressor.on("end", () => {
+      resolve2(totalSize);
+    });
     compressor.on("error", reject);
     stream.on("error", reject);
     stream.pipe(compressor);

package/dist/types.d.ts

@@ -83,11 +83,11 @@ export type ReadFileOptions<C> = {
      * The encoding to use. Default: `utf8`
      * @see https://nodejs.org/api/buffer.html#buffer_buffers_and_character_encodings
      */
-    encoding?: ReadFileEncoding | undefined;
+    encoding?: ReadFileEncoding;
     /**
      * The flag used to open the file. Default: `r`
      */
-    flag?: number | string | undefined;
+    flag?: number | string;
 };
 /**
  * Represents the content type of a read file, which can be a Buffer or a string based on options.
@@ -151,11 +151,11 @@ export type WriteFileOptions = {
     /**
      * The encoding to use. Default: `utf8`
      */
-    encoding?: BufferEncoding | null | undefined;
+    encoding?: BufferEncoding | null;
     /**
      * The flag used to write the file. Default: `w`
      */
-    flag?: string | undefined;
+    flag?: string;
     /**
      * The file mode (permission and sticky bits). Default: `0o666`
      */
@@ -196,7 +196,7 @@ export type WriteJsonOptions = WriteFileOptions & {
      *
      * Pass in `undefined` for no formatting.
      */
-    indent?: number | string | undefined;
+    indent?: number | string;
     /**
      * Passed into `JSON.stringify`.
      */
@@ -265,13 +265,13 @@ export type RetryOptions = {
      * `true` for operations that support it (like `rm`).
      * @default 0
      */
-    maxRetries?: number | undefined;
+    maxRetries?: number;
     /**
      * The amount of time in milliseconds to wait between retries.
      * This option is ignored if the `recursive` option is not `true` for operations that support it.
      * @default 100
      */
-    retryDelay?: number | undefined;
+    retryDelay?: number;
 };
 /**
  * Options for reading YAML files.
@@ -294,7 +294,7 @@ export type WriteYamlOptions = CreateNodeOptions & DocumentOptions & ParseOption
     /**
      * Passed into `yaml.stringify` as the replacer argument.
      */
-    replacer?: YamlReplacer;
+    replacer?: JsonReplacer;
     /**
      * Passed into `yaml.stringify` as the space argument for indentation.
      * Can be a number of spaces or a string (e.g., a tab character).

package/dist/utils/parse-json.d.ts

@@ -1,5 +1,5 @@
 import type { JsonValue } from "type-fest";
 import type { CodeFrameOptions, JsonReviver } from "../types.d.ts";
-declare function parseJson<T = JsonValue>(string: string, filename?: string, options?: CodeFrameOptions): T;
-declare function parseJson<T = JsonValue>(string: string, reviver: JsonReviver, fileName?: string, options?: CodeFrameOptions): T;
+declare function parseJson(string: string, filename?: string, options?: CodeFrameOptions): JsonValue;
+declare function parseJson(string: string, reviver: JsonReviver, fileName?: string, options?: CodeFrameOptions): JsonValue;
 export default parseJson;

package/dist/utils.js

@@ -1,6 +1,6 @@
 export { default as JSONError } from './packem_shared/JSONError-BkHRnInH.js';
 export { default as assertValidFileContents } from './packem_shared/assertValidFileContents-BmcLtsGd.js';
 export { default as assertValidFileOrDirectoryPath } from './packem_shared/assertValidFileOrDirectoryPath-8HANmVjk.js';
-export { default as parseJson } from './packem_shared/parseJson-Cnex0kz2.js';
+export { default as parseJson } from './packem_shared/parseJson-BedVi91S.js';
 export { default as stripJsonComments } from './packem_shared/stripJsonComments-vo4k0mpF.js';
 export { toPath } from '@visulima/path/utils';

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

@@ -1,4 +1,4 @@
-import type { WriteYamlOptions, YamlReplacer } from "../types.d.ts";
+import type { JsonReplacer, WriteYamlOptions } from "../types.d.ts";
 declare function writeYamlSync(path: URL | string, data: any, options?: WriteYamlOptions): void;
-declare function writeYamlSync(path: URL | string, data: any, replacer?: YamlReplacer, options?: WriteYamlOptions | number | string): void;
+declare function writeYamlSync(path: URL | string, data: any, replacer?: JsonReplacer, options?: WriteYamlOptions | number | string): void;
 export default writeYamlSync;

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

@@ -1,4 +1,4 @@
-import type { WriteYamlOptions, YamlReplacer } from "../types.d.ts";
+import type { JsonReplacer, WriteYamlOptions } from "../types.d.ts";
 declare function writeYaml(path: URL | string, data: any, options?: WriteYamlOptions): Promise<void>;
-declare function writeYaml(path: URL | string, data: any, replacer?: YamlReplacer, options?: WriteYamlOptions | number | string): Promise<void>;
+declare function writeYaml(path: URL | string, data: any, replacer?: JsonReplacer, options?: WriteYamlOptions | number | string): Promise<void>;
 export default writeYaml;

package/dist/yaml.js

@@ -1,4 +1,4 @@
 export { default as readYaml } from './packem_shared/readYaml-D5q2a0e1.js';
-export { default as readYamlSync } from './packem_shared/readYamlSync-DMV4U-gi.js';
-export { default as writeYaml } from './packem_shared/writeYaml-n4xzYN9a.js';
-export { default as writeYamlSync } from './packem_shared/writeYamlSync-DnOEnP10.js';
+export { default as readYamlSync } from './packem_shared/readYamlSync-BKX-PAfq.js';
+export { default as writeYaml } from './packem_shared/writeYaml-BWCOome-.js';
+export { default as writeYamlSync } from './packem_shared/writeYamlSync-DBVnXmuY.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/fs",
-  "version": "5.0.0-alpha.6",
+  "version": "5.0.0-alpha.7",
   "description": "Human friendly file system utilities for Node.js",
   "keywords": [
     "anolilab",
@@ -113,7 +113,7 @@
     "LICENSE.md"
   ],
   "dependencies": {
-    "@visulima/path": "3.0.0-alpha.7",
+    "@visulima/path": "3.0.0-alpha.8",
     "type-fest": "5.5.0"
   },
   "peerDependencies": {
@@ -124,7 +124,6 @@
       "optional": true
     }
   },
-  "optionalDependencies": {},
   "engines": {
     "node": ">=22.13 <=25.x"
   },