@zgeoff/format-codemod 0.0.4 → 0.0.5

package/README.md

@@ -50,10 +50,11 @@ no "never" rules.
 ```bash
 format-codemod [options] <file|dir|glob> ...
 
-  --check     exit 1 if any file would change; do not write
-  --dry       print unified diff to stdout; do not write
-  --bench     print parse stats as JSON to stderr
-  --quiet     only print files that would change
+  --check            exit 1 if any file would change; do not write
+  --dry              print unified diff to stdout; do not write
+  --bench            print parse stats as JSON to stderr
+  --quiet            only print files that would change
+  --ignore <glob>    skip files matching the glob (repeatable)
   --version
   --help
 ```
@@ -79,6 +80,24 @@ file is processed once.
 `--dry` prints a real unified diff — `@@` hunk headers with three lines of context — that applies
 cleanly with `patch(1)`.
 
+### Ignoring files
+
+A `.formatignore` file in the working directory supplies ignore globs without bloating the command
+line — one per line, with blank lines and `#`-prefixed comment lines skipped:
+
+```gitignore
+# committed codegen
+src/generated/**
+
+# build output
+dist/**
+```
+
+Each line uses the same glob semantics as `--ignore` (Node's `path.matchesGlob`, tried against both
+the expanded path and the path relative to the working directory). It is not a gitignore dialect:
+`!` negation and directory-anchoring rules are not supported. `--ignore` flags remain available and
+merge additively with the file's globs.
+
 ## Dialect handling
 
 The filename picks the parse dialect: `.tsx` enables JSX, everything else parses as plain

package/dist/cli/load-format-ignore.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Reads `.formatignore` from the given directory: one glob per line, blank
+ * lines and `#`-prefixed comment lines skipped. Lines share --ignore's glob
+ * semantics — this is not a gitignore dialect, so `!` negation and directory
+ * anchoring don't apply. A missing file yields an empty list, so callers
+ * merge unconditionally.
+ */
+export declare function loadFormatIgnore(dir: string): readonly string[];

package/dist/cli.js

@@ -49,6 +49,18 @@ function isIgnored(file, patterns) {
   return patterns.some((pattern) => path.matchesGlob(file, pattern) || path.matchesGlob(relative, pattern));
 }
 
+// src/cli/load-format-ignore.ts
+import fs2 from "node:fs";
+import path2 from "node:path";
+function loadFormatIgnore(dir) {
+  const file = path2.join(dir, ".formatignore");
+  if (!fs2.existsSync(file)) {
+    return [];
+  }
+  return fs2.readFileSync(file, "utf8").split(`
+`).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+}
+
 // src/cli/parse-cli-args.ts
 import { parseArgs } from "node:util";
 function parseCLIArgs(argv) {
@@ -103,6 +115,11 @@ options:
   --version
   --help
 
+files:
+  .formatignore      read from the working directory when present: one glob per
+                     line, blank lines and # comments skipped, merged with
+                     --ignore
+
 exit codes:
   0  clean
   1  files would change (--check)
@@ -133,9 +150,9 @@ function printReport(file, report, quiet) {
 }
 
 // src/cli/read-package-version.ts
-import fs2 from "node:fs";
+import fs3 from "node:fs";
 function readPackageVersion(pkgPath) {
-  const parsed = JSON.parse(fs2.readFileSync(pkgPath, "utf8"));
+  const parsed = JSON.parse(fs3.readFileSync(pkgPath, "utf8"));
   if (!isPackageJSON(parsed)) {
     throw new TypeError("Invalid package.json");
   }
@@ -146,7 +163,7 @@ function isPackageJSON(value) {
 }
 
 // src/cli/check-file.ts
-import fs4 from "node:fs";
+import fs5 from "node:fs";
 
 // src/transform/apply-edits.ts
 function applyEdits(src, edits) {
@@ -478,7 +495,7 @@ function transform(src, options) {
 }
 
 // src/cli/apply-diff-mode.ts
-import fs3 from "node:fs";
+import fs4 from "node:fs";
 
 // src/cli/build-unified-diff.ts
 function buildUnifiedDiff(before, after, label) {
@@ -642,13 +659,13 @@ function applyDiffMode(edit, mode) {
   if (mode === "dry") {
     return { message: null, stdout: buildUnifiedDiff(edit.src, edit.result.output, edit.file) };
   }
-  fs3.writeFileSync(edit.file, edit.result.output);
+  fs4.writeFileSync(edit.file, edit.result.output);
   return { message: `WROTE ${edit.file}  ${edit.result.edits} edit(s)`, stdout: null };
 }
 
 // src/cli/check-file.ts
 function checkFile(file, mode) {
-  const src = fs4.readFileSync(file, "utf8");
+  const src = fs5.readFileSync(file, "utf8");
   const bytes = Buffer.byteLength(src);
   const result = transform(src, { filename: file });
   if (result.parseError !== null) {
@@ -701,7 +718,8 @@ if (parsedArgs.version) {
   process.exit(0);
 }
 var t0 = Date.now();
-var files = await expandInputs(inputs, parsedArgs.ignore);
+var ignore = [...loadFormatIgnore(process.cwd()), ...parsedArgs.ignore];
+var files = await expandInputs(inputs, ignore);
 if (files.length === 0) {
   console.error("no files matched");
   process.exit(2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zgeoff/format-codemod",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Enforce blank-line padding conventions in TypeScript via a fast text-splice codemod",
   "license": "MIT",
   "repository": {