json-sort-cli 4.1.0 → 4.2.0

package/CHANGELOG.md

@@ -3,11 +3,21 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## 4.1.0 (2025-10-15)
+## 4.2.0 (2026-08-19)
+
+### Bug Fixes
+
+- retire direct publish aliases ([f98e31e](https://github.com/codsen/codsen/commit/f98e31eb89bc185471225664e610b55f34fbf648))
 
 ### Features
 
-- if value to be added is a number, keep it as is, don't stringify ([ce3e1a5](https://github.com/codsen/codsen/commit/ce3e1a525998ca3c0abf0142affef95b14cd1990))
+- add codsen-glob and migrate glob consumers ([5595a2b](https://github.com/codsen/codsen/commit/5595a2b267eaa6cb60072d037aef00b7a28edd42))
+- refresh the tooling and generate with the latest dependencies ([781f802](https://github.com/codsen/codsen/commit/781f802911066a82a4533b0e5a3fcbd742d0dd83))
+
+### Reverts
+
+- Revert "Merge pull request #128 from codsen/release/npm-32198404552-1" ([5baeeaa](https://github.com/codsen/codsen/commit/5baeeaaa677b86f1eaa6396cadf3aea32b06416e)), closes [#128](https://github.com/codsen/codsen/issues/128)
+- Revert "Merge pull request #127 from codsen/release/npm-32194020886-1" ([5f1e94d](https://github.com/codsen/codsen/commit/5f1e94deef910ce735266b16aeee08a76de7a862)), closes [#127](https://github.com/codsen/codsen/issues/127)
 
 ## 4.0.0 (2024-01-05)
 

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright © 2010-2025 Roy Revelt and other contributors
+Copyright © 2010-2026 Roy Revelt and other contributors
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

package/README.md

@@ -46,6 +46,6 @@ To report bugs or request features or assistance, [raise an issue](https://githu
 
 MIT License
 
-Copyright © 2010-2025 Roy Revelt and other contributors
+Copyright © 2010-2026 Roy Revelt and other contributors
 
 <p align="center"><img src="https://codsen.com/images/png-codsen-ok.png" width="98" alt="ok" align="center"> <img src="https://codsen.com/images/png-codsen-1.png" width="148" alt="codsen" align="center"> <img src="https://codsen.com/images/png-codsen-star-small.png" width="32" alt="star" align="center"></p>

package/cli.js

@@ -3,59 +3,31 @@
 // VARS
 // -----------------------------------------------------------------------------
 
-import meow from "meow";
-import path from "path";
-import fs from "fs-extra";
-import chalk from "chalk";
-import isDirectory from "is-d";
-import pReduce from "p-reduce";
-import pFilter from "p-filter";
-import { globby } from "globby";
-import { createRequire } from "module";
-import { isPlainObject, resolveEolSetting } from "codsen-utils";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { glob } from "codsen-glob";
+import { codsenCLI } from "codsen-utils";
 import updateNotifier from "update-notifier";
-import { traverse } from "ast-monkey-traverse";
-import sortPackageJson, { sortOrder } from "sort-package-json";
+import { ProcessingError, processFiles } from "./process-files.js";
 
 const require1 = createRequire(import.meta.url);
 const pkg = require1("./package.json");
 
-function isStr(something) {
-  return typeof something === "string";
-}
-function format(obj) {
-  if (typeof obj !== "object") {
-    return obj;
-  }
-  let newSortOrder = sortOrder
-    // 1. delete tap and lect fields
-    .filter((field) => !["lect", "tap"].includes(field));
-
-  // 2. then, insert both after resolutions, first tap then lect
-  let idxOfResolutions = newSortOrder.indexOf("resolutions");
-  // console.log(idxOfResolutions);
-  // => 63
-
-  newSortOrder.splice(idxOfResolutions, 0, "tap", "lect");
+const colours = {
+  green: 32,
+  grey: 90,
+  red: 31,
+  white: 37,
+  yellow: 33,
+};
 
-  // use custom array for sorting order:
-  return sortPackageJson(obj, {
-    sortOrder: newSortOrder,
-  });
-}
-function sortObj(obj) {
-  let res = {};
-  Object.keys(obj)
-    .sort()
-    .forEach((key) => {
-      res[key] = obj[key];
-    });
-  return res;
+function colour(str, colourCode) {
+  return `\u001b[${colourCode}m${str}\u001b[39m`;
 }
 
 const prefix = "✨ json-sort-cli: ";
 const { log } = console;
-const cli = meow(
+const cli = codsenCLI(
   `
   Usage
     $ jsonsort YOURFILE.json
@@ -82,7 +54,7 @@ const cli = meow(
     will parse globs. If you put as system globs without quotes, your shell will expand them.
 `,
   {
-    importMeta: import.meta,
+    pkg,
     flags: {
       nodemodules: {
         type: "boolean",
@@ -164,152 +136,8 @@ if (cli.flags.indentationCount) {
   indentationCount = +cli.flags.indentationCount;
 }
 
-// FUNCTIONS
-// -----------------------------------------------------------------------------
-
-function readSortAndWriteOverFile(oneOfPaths) {
-  return fs
-    .readFile(oneOfPaths, "utf8")
-    .then((filesContent) => {
-      let eolChar = resolveEolSetting(filesContent, cli.flags.lineEnding);
-
-      let parsedJson;
-      try {
-        // try to parse JSON
-        parsedJson = JSON.parse(filesContent);
-      } catch (err) {
-        // if it is not parseable, stop
-        if (!cli.flags.silent) {
-          log(`${chalk.grey(prefix)}${oneOfPaths} - ${chalk.red(err)}`);
-        }
-        return Promise.resolve(null);
-      }
-      let result;
-
-      if (isPlainObject(parsedJson)) {
-        result = sortObj(parsedJson);
-      } else if (
-        cli.flags.arrays &&
-        Array.isArray(parsedJson) &&
-        parsedJson.length &&
-        parsedJson.every(isStr)
-      ) {
-        // if it was an array full of strings, it's an early ending:
-        return fs.writeJson(
-          oneOfPaths,
-          parsedJson.sort((a, b) => a.localeCompare(b)),
-          {
-            spaces: cli.flags.tabs
-              ? "\t".repeat(indentationCount)
-              : indentationCount,
-            EOL: eolChar,
-          },
-        );
-      } else {
-        result = parsedJson;
-      }
-
-      return Promise.resolve(
-        !cli.flags.pack && path.basename(oneOfPaths) === "package.json"
-          ? format(result)
-          : result,
-      ).then((obj) => {
-        if (cli.flags.ci) {
-          // if it's CI mode, we only gather a list of files that differ from
-          // input after processing, then we return an array.
-          // In this function, readSortAndWriteOverFile(), path came in,
-          // we read it, now we return true if result differs after processing
-
-          let stringified = JSON.stringify(
-            // The traversal below will mutate, not just traverse, -
-            // whatever you return from the callback below, gets written
-            traverse(obj, (key, val) => {
-              let current = val !== undefined ? val : key;
-              if (isPlainObject(current)) {
-                return sortObj(current);
-              }
-              if (
-                cli.flags.arrays &&
-                Array.isArray(current) &&
-                current.length > 1 &&
-                current.every(isStr)
-              ) {
-                // alphabetical sort, this value gets written
-                return current.sort((a, b) => a.localeCompare(b));
-              }
-              return current;
-            }),
-            null,
-            cli.flags.tabs ? "\t".repeat(indentationCount) : indentationCount,
-          );
-
-          if (eolChar === "\r\n") {
-            // CRLF
-            stringified = stringified
-              .replaceAll(/(?<!\r)\n/g, "\r\n")
-              .replaceAll(/\r(?!\n)/g, "\n");
-          } else {
-            // LF or CR
-            stringified = stringified.replaceAll(/(?:\r?\n)|\r/g, eolChar);
-          }
-
-          return (
-            stringified
-              .replaceAll(
-                /\r\n/g,
-                resolveEolSetting(filesContent, cli.flags.lineEnding),
-              )
-              .trimEnd() !== filesContent.trimEnd()
-          );
-        }
-
-        // ELSE,
-        return fs
-          .writeJson(
-            oneOfPaths,
-            traverse(obj, (key, val) => {
-              let current = val !== undefined ? val : key;
-              if (isPlainObject(current)) {
-                return sortObj(current);
-              }
-              if (
-                cli.flags.arrays &&
-                Array.isArray(current) &&
-                current.length > 1 &&
-                current.every(isStr)
-              ) {
-                // alphabetical sort
-                return current.sort((a, b) => a.localeCompare(b));
-              }
-              return current;
-            }),
-            {
-              spaces: cli.flags.tabs
-                ? "\t".repeat(indentationCount)
-                : indentationCount,
-              EOL: resolveEolSetting(filesContent, cli.flags.lineEnding),
-            },
-          )
-          .then(() => {
-            if (!cli.flags.silent) {
-              log(
-                `${chalk.grey(
-                  prefix,
-                )}${oneOfPaths} - ${`\u001b[${32}m${"OK"}\u001b[${39}m`}`,
-              );
-            }
-            return true;
-          });
-      });
-    })
-    .catch((err) => {
-      console.log(
-        `${oneOfPaths} - ${`\u001b[${31}m${"BAD"}\u001b[${39}m`} - ${err}`,
-      );
-    });
-}
-
-// Step #0. take care of -v and -h flags that are left out in meow.
+// Step #0. take care of the short -v and -h flags, which codsenCLI leaves
+// to us (it answers the long --version and --help on its own).
 // -----------------------------------------------------------------------------
 
 if (cli.flags.version) {
@@ -331,46 +159,32 @@ if (Array.isArray(input) && !input.length) {
 // Step #2. query the glob and follow the pipeline
 // -----------------------------------------------------------------------------
 
-globby(input, { dot: true })
+glob(
+  [
+    ...input,
+    "!**/package-lock.json",
+    "!**/yarn.lock",
+    ...(cli.flags.nodemodules ? [] : ["!**/node_modules/**"]),
+    ...(cli.flags.pack ? ["!**/package.json"] : []),
+  ],
+  {
+    dot: true,
+    expandDirectories: { files: [".*", "*.json"] },
+  },
+)
   .then((paths) => {
     // flip out of the pipeline if there are no paths resolved
     if (paths.length === 0 && !cli.flags.silent) {
       log(
-        `${chalk.grey(prefix)}${chalk.red(
+        `${colour(prefix, colours.grey)}${colour(
           "The inputs don't lead to any json files! Exiting.",
+          colours.red,
         )}`,
       );
       process.exit(0);
     }
     return paths;
   })
-  // glob each directory, reduce'ing all results (in promise shape) until all are resolved
-  .then((paths) =>
-    pReduce(
-      paths,
-      (concatTotal, singleDirOrFilePath) =>
-        concatTotal.concat(
-          isDirectory(singleDirOrFilePath).then((bool) =>
-            bool
-              ? globby(
-                  cli.flags.nodemodules
-                    ? singleDirOrFilePath
-                    : [singleDirOrFilePath, "!**/node_modules/**"],
-                  {
-                    expandDirectories: {
-                      files: [".*", "*.json"],
-                    },
-                  },
-                )
-              : [singleDirOrFilePath],
-          ),
-        ),
-      [],
-      // then reduce again, now actually concatenating them all together
-    ).then((received) =>
-      pReduce(received, (total, single) => total.concat(single), []),
-    ),
-  )
   .then((paths) =>
     paths.filter(
       (oneOfPaths) =>
@@ -407,84 +221,139 @@ globby(input, { dot: true })
   .then((paths) => {
     if (cli.flags.dry && !cli.flags.silent) {
       log(
-        `${chalk.grey(prefix)}${chalk.yellow(
+        `${colour(prefix, colours.grey)}${colour(
           "We'd try to sort the following files:",
+          colours.yellow,
         )}\n${paths.join("\n")}`,
       );
-    } else {
-      if (cli.flags.ci) {
-        // CI setting
-        return pFilter(paths, (currentPath) =>
-          readSortAndWriteOverFile(currentPath),
-        ).then((received2) => {
-          if (received2.length && !cli.flags.silent) {
+      return;
+    }
+
+    const options = {
+      arrays: cli.flags.arrays,
+      ci: cli.flags.ci,
+      indentationCount,
+      lineEnding: cli.flags.lineEnding,
+      pack: cli.flags.pack,
+      tabs: cli.flags.tabs,
+      onOutcome(outcome) {
+        if (cli.flags.silent) {
+          return;
+        }
+        if (outcome.status === "failure") {
+          log(
+            `${colour(prefix, colours.grey)}${outcome.path} - ${colour(
+              "BAD",
+              colours.red,
+            )} (${outcome.stage}) - ${outcome.error}`,
+          );
+        } else if (!cli.flags.ci) {
+          log(
+            `${colour(prefix, colours.grey)}${outcome.path} - ${colour(
+              "OK",
+              colours.green,
+            )}`,
+          );
+        }
+      },
+    };
+
+    return processFiles(paths, options)
+      .then(({ successful, unsorted }) => {
+        if (cli.flags.silent) {
+          if (cli.flags.ci && unsorted.length) {
+            process.exitCode = 9;
+          }
+          return;
+        }
+        if (cli.flags.ci) {
+          if (unsorted.length) {
             log(
-              `${chalk.grey(prefix)}${chalk.red(
+              `${colour(prefix, colours.grey)}${colour(
                 "Unsorted files:",
-              )}\n${received2.join("\n")}`,
+                colours.red,
+              )}\n${unsorted.join("\n")}`,
             );
-            process.exit(9);
-          } else if (!cli.flags.silent) {
+            process.exitCode = 9;
+          } else {
             log(
-              `${chalk.grey(prefix)}${chalk.white(
+              `${colour(prefix, colours.grey)}${colour(
                 "All files were already sorted:",
-              )}\n${paths.join("\n")}`,
+                colours.white,
+              )}\n${successful.join("\n")}`,
             );
-            process.exit(0);
           }
-        });
-      }
-      // not a CI setting
-      return pReduce(
-        paths,
-        (counter, currentPath) =>
-          readSortAndWriteOverFile(currentPath)
-            .then((res) =>
-              res
-                ? {
-                    good: counter.good.concat([currentPath]),
-                    bad: counter.bad,
-                  }
-                : {
-                    good: counter.good,
-                    bad: counter.bad.concat([currentPath]),
-                  },
-            )
-            .catch((err) => {
-              if (!cli.flags.silent) {
-                log(
-                  `${chalk.grey(prefix)}${chalk.red(
-                    "Could not write out the sorted file:",
-                  )} ${err}`,
-                );
-              }
-            }),
-        { good: [], bad: [] },
-      ).then((counter) => {
+          return;
+        }
+        log(
+          `\n${colour(prefix, colours.grey)}${colour(
+            `All ${successful.length} file${
+              successful.length === 1 ? "" : "s"
+            } sorted`,
+            colours.green,
+          )}`,
+        );
+      })
+      .catch((error) => {
+        if (!(error instanceof ProcessingError)) {
+          throw error;
+        }
         if (!cli.flags.silent) {
+          if (cli.flags.ci) {
+            const unsorted = new Set(error.unsorted);
+            const alreadySorted = error.successful.filter(
+              (filePath) => !unsorted.has(filePath),
+            );
+            if (alreadySorted.length) {
+              log(
+                `${colour(prefix, colours.grey)}${colour(
+                  `${alreadySorted.length} file${
+                    alreadySorted.length === 1 ? "" : "s"
+                  } already sorted:`,
+                  colours.green,
+                )}\n${alreadySorted.join("\n")}`,
+              );
+            }
+            if (error.unsorted.length) {
+              log(
+                `${colour(prefix, colours.grey)}${colour(
+                  "Unsorted files:",
+                  colours.red,
+                )}\n${error.unsorted.join("\n")}`,
+              );
+            }
+          } else if (error.successful.length) {
+            log(
+              `\n${colour(prefix, colours.grey)}${colour(
+                `${error.successful.length} file${
+                  error.successful.length === 1 ? "" : "s"
+                } sorted`,
+                colours.green,
+              )}`,
+            );
+          }
           log(
-            `\n${chalk.grey(prefix)}${chalk.green(
-              `${counter?.bad.length === 0 ? "All " : ""}${
-                counter.good.length
-              } files sorted`,
-            )}${
-              counter?.bad.length
-                ? `\n${chalk.grey(prefix)}${chalk.red(
-                    `${counter.bad.length} file${
-                      counter.bad.length === 1 ? "" : "s"
-                    } could not be sorted`,
-                  )} ${`\u001b[${90}m - ${counter.bad.join(
-                    " - ",
-                  )}\u001b[${39}m`}`
-                : ""
-            }`,
+            `${colour(prefix, colours.grey)}${colour(
+              `${error.failures.length} file${
+                error.failures.length === 1 ? "" : "s"
+              } could not be ${cli.flags.ci ? "checked" : "sorted"}`,
+              colours.red,
+            )} ${colour(
+              ` - ${error.failures
+                .map(({ path: failedPath }) => failedPath)
+                .join(" - ")}`,
+              colours.grey,
+            )}`,
           );
         }
+        process.exitCode = 1;
       });
-    }
   })
   .catch((err) => {
     if (!cli.flags.silent) {
-      log(`${chalk.grey(prefix)}${chalk.red("Oops!")} ${err}`);
+      log(
+        `${colour(prefix, colours.grey)}${colour("Oops!", colours.red)} ${err}`,
+      );
     }
+    process.exitCode = 1;
   });

package/json-file.js

@@ -0,0 +1,42 @@
+import { readFile, writeFile } from "node:fs/promises";
+
+export async function readJson(file, options = {}) {
+  if (typeof options === "string") {
+    options = { encoding: options };
+  }
+
+  const shouldThrow = "throws" in options ? options.throws : true;
+  let content = await readFile(file, options);
+
+  if (Buffer.isBuffer(content)) {
+    content = content.toString("utf8");
+  }
+
+  try {
+    return JSON.parse(content.replace(/^\uFEFF/, ""), options.reviver);
+  } catch (error) {
+    if (!shouldThrow) {
+      return null;
+    }
+
+    error.message = `${file}: ${error.message}`;
+    throw error;
+  }
+}
+
+export async function writeJson(file, value, options = {}) {
+  const { EOL = "\n", finalEOL = true, replacer = null, spaces } = options;
+  const stringified = JSON.stringify(value, replacer, spaces);
+
+  if (stringified === undefined) {
+    throw new TypeError(
+      `json-sort-cli/writeJson(): [THROW_ID_01] Converting ${typeof value} value to JSON is not supported`,
+    );
+  }
+
+  await writeFile(
+    file,
+    stringified.replaceAll("\n", EOL) + (finalEOL ? EOL : ""),
+    options,
+  );
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "json-sort-cli",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "description": "Command line app to deep sort JSON files, retains package.json special key order",
   "keywords": [
     "app",
@@ -33,54 +33,46 @@
   },
   "scripts": {
     "build": "exit 0",
-    "cjs-off": "exit 0",
-    "cjs-on": "exit 0",
+    "coverage": "c8 uvu test",
     "dev": "exit 0",
     "devtest": "npm run test",
     "dts": "exit 0",
     "examples": "exit 0",
     "lect": "node '../../ops/lect/lect.js'",
-    "letspublish": "npm publish --provenance || :",
-    "lint": "eslint . --fix --concurrency=auto --cache",
+    "lect:check": "node '../../ops/lect/lect.js' --check",
+    "lint": "biome lint --error-on-warnings .",
+    "lint:fix": "biome lint --write --error-on-warnings .",
     "perf": "exit 0",
     "prep": "echo 'ready'",
-    "prettier": "prettier",
-    "prettier:format": "npm run prettier -- --write '**/*.{js,md}' --no-error-on-unmatched-pattern --log-level 'silent'",
-    "pretest": "exit 0",
+    "prettier": "biome format",
+    "prettier:format": "biome format --write .",
+    "pretest": "npm run lect:check",
     "test": "c8 npm run unit && npm run lint",
     "unit": "uvu test"
   },
-  "engines": {
-    "node": ">=18"
-  },
   "c8": {
-    "check-coverage": false,
-    "exclude": [
-      "**/test/**/*.*"
-    ]
+    "all": true,
+    "check-coverage": true,
+    "exclude": ["**/test/**/*.*"],
+    "lines": 97
   },
   "lect": {
     "licence": {
-      "extras": [
-        ""
-      ]
+      "extras": [""]
     }
   },
   "dependencies": {
-    "ast-monkey-traverse": "^4.1.0",
-    "chalk": "^5.6.2",
-    "codsen-utils": "^1.7.0",
-    "fs-extra": "^11.3.2",
-    "globby": "^15.0.0",
-    "is-d": "^1.0.0",
-    "meow": "^14.0.0",
-    "p-filter": "^4.1.0",
-    "p-reduce": "^3.0.0",
-    "sort-package-json": "^3.4.0",
+    "ast-monkey-traverse": "^4.2.0",
+    "codsen-glob": "^1.1.0",
+    "codsen-utils": "^1.8.0",
+    "sort-package-json": "^2.15.1",
     "update-notifier": "^7.3.1"
   },
   "devDependencies": {
-    "p-map": "^7.0.3"
+    "p-map": "^7.0.4"
+  },
+  "engines": {
+    "node": ">=18.20.8"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"

package/process-files.js

@@ -0,0 +1,247 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { traverse } from "ast-monkey-traverse";
+import { isPlainObject, resolveEolSetting } from "codsen-utils";
+import sortPackageJson, { sortOrder } from "sort-package-json";
+import { writeJson } from "./json-file.js";
+
+function asError(error) {
+  return error instanceof Error ? error : new Error(String(error));
+}
+
+function sortObject(object) {
+  const result = {};
+  for (const key of Object.keys(object).sort()) {
+    result[key] = object[key];
+  }
+  return result;
+}
+
+function formatPackageJson(object) {
+  if (typeof object !== "object") {
+    return object;
+  }
+  const customSortOrder = sortOrder.filter(
+    (field) => !["lect", "tap"].includes(field),
+  );
+  const resolutionsIndex = customSortOrder.indexOf("resolutions");
+  customSortOrder.splice(resolutionsIndex, 0, "tap", "lect");
+  return sortPackageJson(object, { sortOrder: customSortOrder });
+}
+
+function normalizeLineEndings(stringified, eolChar) {
+  if (eolChar === "\r\n") {
+    return stringified
+      .replaceAll(/(?<!\r)\n/g, "\r\n")
+      .replaceAll(/\r(?!\n)/g, "\n");
+  }
+  return stringified.replaceAll(/(?:\r?\n)|\r/g, eolChar);
+}
+
+function prepareJson(
+  parsedJson,
+  { arrays, contents, filePath, indentationCount, lineEnding, pack, tabs },
+) {
+  const eol = resolveEolSetting(contents, lineEnding);
+  let result = isPlainObject(parsedJson) ? sortObject(parsedJson) : parsedJson;
+  if (
+    arrays &&
+    Array.isArray(result) &&
+    result.length &&
+    result.every((item) => typeof item === "string")
+  ) {
+    result.sort((a, b) => a.localeCompare(b));
+  } else if (!pack && path.basename(filePath) === "package.json") {
+    result = formatPackageJson(result);
+  }
+
+  const value = traverse(result, (key, val) => {
+    const current = val !== undefined ? val : key;
+    if (isPlainObject(current)) {
+      return sortObject(current);
+    }
+    if (
+      arrays &&
+      Array.isArray(current) &&
+      current.length > 1 &&
+      current.every((item) => typeof item === "string")
+    ) {
+      return current.sort((a, b) => a.localeCompare(b));
+    }
+    return current;
+  });
+  const spaces = tabs ? "\t".repeat(indentationCount) : indentationCount;
+  const stringified = normalizeLineEndings(
+    JSON.stringify(value, null, spaces),
+    eol,
+  );
+
+  return {
+    changed: stringified.trimEnd() !== contents.trimEnd(),
+    eol,
+    spaces,
+    value,
+  };
+}
+
+export class FileProcessingError extends Error {
+  constructor(filePath, stage, error) {
+    const cause = asError(error);
+    super(`${filePath}: ${stage} failed: ${cause.message}`, { cause });
+    this.name = "FileProcessingError";
+    this.error = cause;
+    this.path = filePath;
+    this.stage = stage;
+  }
+}
+
+export class ProcessingError extends AggregateError {
+  constructor(failures, successful, unsorted) {
+    super(
+      failures.map(({ error }) => error),
+      `${failures.length} file${failures.length === 1 ? "" : "s"} could not be sorted`,
+    );
+    this.name = "ProcessingError";
+    this.failures = failures;
+    this.successful = successful;
+    this.unsorted = unsorted;
+  }
+}
+
+async function processFile(
+  filePath,
+  options,
+  { parse, read, transform, write },
+) {
+  let contents;
+  try {
+    contents = await read(filePath, "utf8");
+  } catch (error) {
+    throw new FileProcessingError(filePath, "read", error);
+  }
+
+  let parsedJson;
+  try {
+    parsedJson = parse(contents);
+  } catch (error) {
+    throw new FileProcessingError(filePath, "parse", error);
+  }
+
+  let prepared;
+  try {
+    prepared = transform(parsedJson, { contents, filePath, ...options });
+  } catch (error) {
+    throw new FileProcessingError(filePath, "transform", error);
+  }
+
+  if (!options.ci) {
+    try {
+      await write(filePath, prepared.value, {
+        EOL: prepared.eol,
+        spaces: prepared.spaces,
+      });
+    } catch (error) {
+      throw new FileProcessingError(filePath, "write", error);
+    }
+  }
+
+  return { changed: prepared.changed, path: filePath };
+}
+
+async function mapWithConcurrency(values, mapper, concurrency) {
+  const results = new Array(values.length);
+  let nextIndex = 0;
+
+  async function worker() {
+    while (nextIndex < values.length) {
+      const currentIndex = nextIndex;
+      nextIndex += 1;
+      results[currentIndex] = await mapper(values[currentIndex]);
+    }
+  }
+
+  await Promise.all(
+    Array.from({ length: Math.min(concurrency, values.length) }, () =>
+      worker(),
+    ),
+  );
+  return results;
+}
+
+export async function processFiles(
+  paths,
+  {
+    arrays = false,
+    ci = false,
+    indentationCount = 2,
+    lineEnding,
+    onOutcome = () => {},
+    pack = false,
+    parse = JSON.parse,
+    read = readFile,
+    tabs = false,
+    transform = prepareJson,
+    write = writeJson,
+  } = {},
+) {
+  const failures = [];
+  const successful = [];
+  const unsorted = [];
+  const options = {
+    arrays,
+    ci,
+    indentationCount,
+    lineEnding,
+    pack,
+    tabs,
+  };
+
+  async function captureOutcome(filePath) {
+    try {
+      const outcome = await processFile(filePath, options, {
+        parse,
+        read,
+        transform,
+        write,
+      });
+      return { ...outcome, status: "success" };
+    } catch (error) {
+      if (!(error instanceof FileProcessingError)) {
+        throw error;
+      }
+      return {
+        error: error.error,
+        failure: error,
+        path: error.path,
+        stage: error.stage,
+        status: "failure",
+      };
+    }
+  }
+
+  const outcomes = ci
+    ? await mapWithConcurrency(paths, captureOutcome, 16)
+    : [];
+  if (!ci) {
+    for (const filePath of paths) {
+      outcomes.push(await captureOutcome(filePath));
+    }
+  }
+
+  for (const outcome of outcomes) {
+    if (outcome.status === "failure") {
+      failures.push(outcome.failure);
+    } else {
+      successful.push(outcome.path);
+      if (ci && outcome.changed) {
+        unsorted.push(outcome.path);
+      }
+    }
+    onOutcome(outcome);
+  }
+
+  if (failures.length) {
+    throw new ProcessingError(failures, successful, unsorted);
+  }
+  return { failures, successful, unsorted };
+}

package/.eslintcache

@@ -1 +0,0 @@
-[{"/home/runner/work/codsen/codsen/packages/json-sort-cli/cli.js":"1","/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-a.js":"2","/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-c.js":"3","/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-h.js":"4","/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-i.js":"5","/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-l.js":"6","/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-n.js":"7","/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-p.js":"8","/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-s.js":"9","/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-t.js":"10","/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-v.js":"11","/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test.js":"12","/home/runner/work/codsen/codsen/packages/json-sort-cli/test/util/data.js":"13"},{"size":14281,"mtime":1760566739114,"results":"14","hashOfConfig":"15"},{"size":3523,"mtime":1760566739115,"results":"16","hashOfConfig":"17"},{"size":10425,"mtime":1760566739115,"results":"18","hashOfConfig":"17"},{"size":1798,"mtime":1760566739115,"results":"19","hashOfConfig":"17"},{"size":2722,"mtime":1760566739115,"results":"20","hashOfConfig":"17"},{"size":2792,"mtime":1760566739115,"results":"21","hashOfConfig":"17"},{"size":4392,"mtime":1760566739115,"results":"22","hashOfConfig":"17"},{"size":3500,"mtime":1760566739115,"results":"23","hashOfConfig":"17"},{"size":2667,"mtime":1760566739115,"results":"24","hashOfConfig":"17"},{"size":2079,"mtime":1760566739115,"results":"25","hashOfConfig":"17"},{"size":1434,"mtime":1760566739115,"results":"26","hashOfConfig":"17"},{"size":6679,"mtime":1760566739115,"results":"27","hashOfConfig":"17"},{"size":9635,"mtime":1760566739115,"results":"28","hashOfConfig":"17"},{"filePath":"29","messages":"30","suppressedMessages":"31","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},"vtm9kz",{"filePath":"32","messages":"33","suppressedMessages":"34","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},"nrihsz",{"filePath":"35","messages":"36","suppressedMessages":"37","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"38","messages":"39","suppressedMessages":"40","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"41","messages":"42","suppressedMessages":"43","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"44","messages":"45","suppressedMessages":"46","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"47","messages":"48","suppressedMessages":"49","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"50","messages":"51","suppressedMessages":"52","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"53","messages":"54","suppressedMessages":"55","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"56","messages":"57","suppressedMessages":"58","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"59","messages":"60","suppressedMessages":"61","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"62","messages":"63","suppressedMessages":"64","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},{"filePath":"65","messages":"66","suppressedMessages":"67","errorCount":0,"fatalErrorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0},"/home/runner/work/codsen/codsen/packages/json-sort-cli/cli.js",[],[],"/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-a.js",[],["68","69","70","71","72","73"],"/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-c.js",[],["74","75","76"],"/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-h.js",[],["77","78","79","80","81"],"/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-i.js",[],["82","83","84","85","86","87"],"/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-l.js",[],["88","89","90","91","92","93"],"/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-n.js",[],["94","95","96","97","98","99"],"/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-p.js",[],["100","101","102","103","104","105"],"/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-s.js",[],["106","107","108","109","110","111"],"/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-t.js",[],["112","113","114","115","116","117"],"/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test-v.js",[],["118","119","120","121","122"],"/home/runner/work/codsen/codsen/packages/json-sort-cli/test/test.js",[],["123","124","125","126","127"],"/home/runner/work/codsen/codsen/packages/json-sort-cli/test/util/data.js",[],[],{"ruleId":"128","severity":2,"message":"129","line":5,"column":17,"nodeType":null,"messageId":"130","endLine":5,"endColumn":19,"suppressions":"131"},{"ruleId":"128","severity":2,"message":"132","line":5,"column":21,"nodeType":null,"messageId":"130","endLine":5,"endColumn":23,"suppressions":"133"},{"ruleId":"128","severity":2,"message":"134","line":5,"column":25,"nodeType":null,"messageId":"130","endLine":5,"endColumn":31,"suppressions":"135"},{"ruleId":"128","severity":2,"message":"136","line":5,"column":33,"nodeType":null,"messageId":"130","endLine":5,"endColumn":37,"suppressions":"137"},{"ruleId":"128","severity":2,"message":"138","line":5,"column":39,"nodeType":null,"messageId":"130","endLine":5,"endColumn":42,"suppressions":"139"},{"ruleId":"128","severity":2,"message":"140","line":5,"column":44,"nodeType":null,"messageId":"130","endLine":5,"endColumn":49,"suppressions":"141"},{"ruleId":"128","severity":2,"message":"129","line":5,"column":17,"nodeType":null,"messageId":"130","endLine":5,"endColumn":19,"suppressions":"142"},{"ruleId":"128","severity":2,"message":"134","line":5,"column":25,"nodeType":null,"messageId":"130","endLine":5,"endColumn":31,"suppressions":"143"},{"ruleId":"128","severity":2,"message":"136","line":5,"column":33,"nodeType":null,"messageId":"130","endLine":5,"endColumn":37,"suppressions":"144"},{"ruleId":"128","severity":2,"message":"129","line":5,"column":17,"nodeType":null,"messageId":"130","endLine":5,"endColumn":19,"suppressions":"145"},{"ruleId":"128","severity":2,"message":"132","line":5,"column":21,"nodeType":null,"messageId":"130","endLine":5,"endColumn":23,"suppressions":"146"},{"ruleId":"128","severity":2,"message":"134","line":5,"column":25,"nodeType":null,"messageId":"130","endLine":5,"endColumn":31,"suppressions":"147"},{"ruleId":"128","severity":2,"message":"136","line":5,"column":33,"nodeType":null,"messageId":"130","endLine":5,"endColumn":37,"suppressions":"148"},{"ruleId":"128","severity":2,"message":"138","line":5,"column":39,"nodeType":null,"messageId":"130","endLine":5,"endColumn":42,"suppressions":"149"},{"ruleId":"128","severity":2,"message":"129","line":5,"column":17,"nodeType":null,"messageId":"130","endLine":5,"endColumn":19,"suppressions":"150"},{"ruleId":"128","severity":2,"message":"132","line":5,"column":21,"nodeType":null,"messageId":"130","endLine":5,"endColumn":23,"suppressions":"151"},{"ruleId":"128","severity":2,"message":"134","line":5,"column":25,"nodeType":null,"messageId":"130","endLine":5,"endColumn":31,"suppressions":"152"},{"ruleId":"128","severity":2,"message":"136","line":5,"column":33,"nodeType":null,"messageId":"130","endLine":5,"endColumn":37,"suppressions":"153"},{"ruleId":"128","severity":2,"message":"138","line":5,"column":39,"nodeType":null,"messageId":"130","endLine":5,"endColumn":42,"suppressions":"154"},{"ruleId":"128","severity":2,"message":"140","line":5,"column":44,"nodeType":null,"messageId":"130","endLine":5,"endColumn":49,"suppressions":"155"},{"ruleId":"128","severity":2,"message":"129","line":5,"column":17,"nodeType":null,"messageId":"130","endLine":5,"endColumn":19,"suppressions":"156"},{"ruleId":"128","severity":2,"message":"132","line":5,"column":21,"nodeType":null,"messageId":"130","endLine":5,"endColumn":23,"suppressions":"157"},{"ruleId":"128","severity":2,"message":"134","line":5,"column":25,"nodeType":null,"messageId":"130","endLine":5,"endColumn":31,"suppressions":"158"},{"ruleId":"128","severity":2,"message":"136","line":5,"column":33,"nodeType":null,"messageId":"130","endLine":5,"endColumn":37,"suppressions":"159"},{"ruleId":"128","severity":2,"message":"138","line":5,"column":39,"nodeType":null,"messageId":"130","endLine":5,"endColumn":42,"suppressions":"160"},{"ruleId":"128","severity":2,"message":"140","line":5,"column":44,"nodeType":null,"messageId":"130","endLine":5,"endColumn":49,"suppressions":"161"},{"ruleId":"128","severity":2,"message":"129","line":5,"column":17,"nodeType":null,"messageId":"130","endLine":5,"endColumn":19,"suppressions":"162"},{"ruleId":"128","severity":2,"message":"132","line":5,"column":21,"nodeType":null,"messageId":"130","endLine":5,"endColumn":23,"suppressions":"163"},{"ruleId":"128","severity":2,"message":"134","line":5,"column":25,"nodeType":null,"messageId":"130","endLine":5,"endColumn":31,"suppressions":"164"},{"ruleId":"128","severity":2,"message":"136","line":5,"column":33,"nodeType":null,"messageId":"130","endLine":5,"endColumn":37,"suppressions":"165"},{"ruleId":"128","severity":2,"message":"138","line":5,"column":39,"nodeType":null,"messageId":"130","endLine":5,"endColumn":42,"suppressions":"166"},{"ruleId":"128","severity":2,"message":"140","line":5,"column":44,"nodeType":null,"messageId":"130","endLine":5,"endColumn":49,"suppressions":"167"},{"ruleId":"128","severity":2,"message":"129","line":5,"column":17,"nodeType":null,"messageId":"130","endLine":5,"endColumn":19,"suppressions":"168"},{"ruleId":"128","severity":2,"message":"132","line":5,"column":21,"nodeType":null,"messageId":"130","endLine":5,"endColumn":23,"suppressions":"169"},{"ruleId":"128","severity":2,"message":"134","line":5,"column":25,"nodeType":null,"messageId":"130","endLine":5,"endColumn":31,"suppressions":"170"},{"ruleId":"128","severity":2,"message":"136","line":5,"column":33,"nodeType":null,"messageId":"130","endLine":5,"endColumn":37,"suppressions":"171"},{"ruleId":"128","severity":2,"message":"138","line":5,"column":39,"nodeType":null,"messageId":"130","endLine":5,"endColumn":42,"suppressions":"172"},{"ruleId":"128","severity":2,"message":"140","line":5,"column":44,"nodeType":null,"messageId":"130","endLine":5,"endColumn":49,"suppressions":"173"},{"ruleId":"128","severity":2,"message":"129","line":5,"column":17,"nodeType":null,"messageId":"130","endLine":5,"endColumn":19,"suppressions":"174"},{"ruleId":"128","severity":2,"message":"132","line":5,"column":21,"nodeType":null,"messageId":"130","endLine":5,"endColumn":23,"suppressions":"175"},{"ruleId":"128","severity":2,"message":"134","line":5,"column":25,"nodeType":null,"messageId":"130","endLine":5,"endColumn":31,"suppressions":"176"},{"ruleId":"128","severity":2,"message":"136","line":5,"column":33,"nodeType":null,"messageId":"130","endLine":5,"endColumn":37,"suppressions":"177"},{"ruleId":"128","severity":2,"message":"138","line":5,"column":39,"nodeType":null,"messageId":"130","endLine":5,"endColumn":42,"suppressions":"178"},{"ruleId":"128","severity":2,"message":"140","line":5,"column":44,"nodeType":null,"messageId":"130","endLine":5,"endColumn":49,"suppressions":"179"},{"ruleId":"128","severity":2,"message":"129","line":5,"column":17,"nodeType":null,"messageId":"130","endLine":5,"endColumn":19,"suppressions":"180"},{"ruleId":"128","severity":2,"message":"132","line":5,"column":21,"nodeType":null,"messageId":"130","endLine":5,"endColumn":23,"suppressions":"181"},{"ruleId":"128","severity":2,"message":"134","line":5,"column":25,"nodeType":null,"messageId":"130","endLine":5,"endColumn":31,"suppressions":"182"},{"ruleId":"128","severity":2,"message":"136","line":5,"column":33,"nodeType":null,"messageId":"130","endLine":5,"endColumn":37,"suppressions":"183"},{"ruleId":"128","severity":2,"message":"138","line":5,"column":39,"nodeType":null,"messageId":"130","endLine":5,"endColumn":42,"suppressions":"184"},{"ruleId":"128","severity":2,"message":"140","line":5,"column":44,"nodeType":null,"messageId":"130","endLine":5,"endColumn":49,"suppressions":"185"},{"ruleId":"128","severity":2,"message":"129","line":5,"column":17,"nodeType":null,"messageId":"130","endLine":5,"endColumn":19,"suppressions":"186"},{"ruleId":"128","severity":2,"message":"132","line":5,"column":21,"nodeType":null,"messageId":"130","endLine":5,"endColumn":23,"suppressions":"187"},{"ruleId":"128","severity":2,"message":"134","line":5,"column":25,"nodeType":null,"messageId":"130","endLine":5,"endColumn":31,"suppressions":"188"},{"ruleId":"128","severity":2,"message":"136","line":5,"column":33,"nodeType":null,"messageId":"130","endLine":5,"endColumn":37,"suppressions":"189"},{"ruleId":"128","severity":2,"message":"138","line":5,"column":39,"nodeType":null,"messageId":"130","endLine":5,"endColumn":42,"suppressions":"190"},{"ruleId":"128","severity":2,"message":"129","line":5,"column":17,"nodeType":null,"messageId":"130","endLine":5,"endColumn":19,"suppressions":"191"},{"ruleId":"128","severity":2,"message":"132","line":5,"column":21,"nodeType":null,"messageId":"130","endLine":5,"endColumn":23,"suppressions":"192"},{"ruleId":"128","severity":2,"message":"134","line":5,"column":25,"nodeType":null,"messageId":"130","endLine":5,"endColumn":31,"suppressions":"193"},{"ruleId":"128","severity":2,"message":"136","line":5,"column":33,"nodeType":null,"messageId":"130","endLine":5,"endColumn":37,"suppressions":"194"},{"ruleId":"128","severity":2,"message":"138","line":5,"column":39,"nodeType":null,"messageId":"130","endLine":5,"endColumn":42,"suppressions":"195"},"@typescript-eslint/no-unused-vars","'is' is defined but never used.","unusedVar",["196"],"'ok' is defined but never used.",["197"],"'throws' is defined but never used.",["198"],"'type' is defined but never used.",["199"],"'not' is defined but never used.",["200"],"'match' is defined but never used.",["201"],["202"],["203"],["204"],["205"],["206"],["207"],["208"],["209"],["210"],["211"],["212"],["213"],["214"],["215"],["216"],["217"],["218"],["219"],["220"],["221"],["222"],["223"],["224"],["225"],["226"],["227"],["228"],["229"],["230"],["231"],["232"],["233"],["234"],["235"],["236"],["237"],["238"],["239"],["240"],["241"],["242"],["243"],["244"],["245"],["246"],["247"],["248"],["249"],["250"],["251"],["252"],["253"],["254"],["255"],{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},{"kind":"256","justification":"257"},"directive",""]