@zgeoff/format-codemod 0.0.3 → 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,11 +49,23 @@ 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) {
   try {
-    const { values, positionals } = parseArgs({
+    const parsed = parseArgs({
       args: [...argv],
       options: {
         check: { type: "boolean", default: false },
@@ -68,13 +80,13 @@ function parseCLIArgs(argv) {
       strict: true
     });
     return {
-      mode: pickMode(values.check, values.dry),
-      quiet: values.quiet,
-      bench: values.bench,
-      help: values.help,
-      version: values.version,
-      ignore: values.ignore,
-      inputs: positionals
+      mode: pickMode(parsed.values.check, parsed.values.dry),
+      quiet: parsed.values.quiet,
+      bench: parsed.values.bench,
+      help: parsed.values.help,
+      version: parsed.values.version,
+      ignore: parsed.values.ignore,
+      inputs: parsed.positionals
     };
   } catch (error) {
     return error instanceof Error ? error.message : String(error);
@@ -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) {
@@ -222,11 +239,11 @@ function getStatementValues(node) {
   if (node.type === "VariableDeclaration") {
     return collectASTNodes(node["declarations"]).map((declarator) => declarator["init"]).filter((init) => isASTNode(init));
   }
-  const { expression } = node;
+  const expression = node["expression"];
   if (node.type !== "ExpressionStatement" || !isASTNode(expression)) {
     return [];
   }
-  const { right } = expression;
+  const right = expression["right"];
   if (expression.type === "AssignmentExpression" && isASTNode(right)) {
     return [right];
   }
@@ -291,7 +308,7 @@ function getStatementKind(node) {
   return isExpressionStatementOf(node, MUTATION_TYPES) ? "mutation" : null;
 }
 function isExpressionStatementOf(node, types) {
-  const { expression } = node;
+  const expression = node["expression"];
   return node.type === "ExpressionStatement" && isASTNode(expression) && types.includes(expression.type);
 }
 var VAR_DECL_KINDS = new Set(["const", "let", "var"]);
@@ -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) {
@@ -553,10 +570,11 @@ class MyersDiff {
     return ops.toReversed();
   }
   unwindRound(pos, d) {
-    const { prev, moveDown } = this.findPrevious(pos, d);
+    const previous = this.findPrevious(pos, d);
+    const prev = previous.prev;
     const ops = this.buildEqualOps(pos, prev);
     if (d > 0) {
-      const changeOp = moveDown ? { kind: "+", text: this.b[prev.y] ?? "" } : { kind: "-", text: this.a[prev.x] ?? "" };
+      const changeOp = previous.moveDown ? { kind: "+", text: this.b[prev.y] ?? "" } : { kind: "-", text: this.a[prev.x] ?? "" };
       ops.push(changeOp);
     }
     return { ops, pos: prev };
@@ -571,7 +589,8 @@ class MyersDiff {
   }
   buildEqualOps(pos, prev) {
     const ops = [];
-    let { x, y } = pos;
+    let x = pos.x;
+    let y = pos.y;
     while (x > prev.x && y > prev.y) {
       ops.push({ kind: " ", text: this.a[x - 1] ?? "" });
       x--;
@@ -601,12 +620,12 @@ function buildWindows(ops) {
   return windows;
 }
 function buildHunk(ops, w) {
-  const { aLine, bLine } = countPrecedingLines(ops, w.from);
+  const preceding = countPrecedingLines(ops, w.from);
   const slice = ops.slice(w.from, w.to);
   const aCount = slice.filter((o) => o.kind !== "+").length;
   const bCount = slice.filter((o) => o.kind !== "-").length;
   return {
-    header: `@@ -${formatRange(aLine, aCount)} +${formatRange(bLine, bCount)} @@
+    header: `@@ -${formatRange(preceding.aLine, aCount)} +${formatRange(preceding.bLine, bCount)} @@
 `,
     lines: slice.map((o) => `${o.kind}${o.text}
 `)
@@ -640,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) {
@@ -683,19 +702,23 @@ if (typeof parsedArgs === "string") {
   console.error(parsedArgs);
   process.exit(2);
 }
-var { mode, quiet, bench, help, version, ignore, inputs } = parsedArgs;
-if (help || inputs.length === 0 && !version) {
+var mode = parsedArgs.mode;
+var quiet = parsedArgs.quiet;
+var bench = parsedArgs.bench;
+var inputs = parsedArgs.inputs;
+if (parsedArgs.help || inputs.length === 0 && !parsedArgs.version) {
   const exitCode = inputs.length === 0 ? 2 : 0;
   printHelp();
   process.exit(exitCode);
 }
-if (version) {
+if (parsedArgs.version) {
   const pkgPath = fileURLToPath(new URL("../package.json", import.meta.url));
   process.stdout.write(`${readPackageVersion(pkgPath)}
 `);
   process.exit(0);
 }
 var t0 = Date.now();
+var ignore = [...loadFormatIgnore(process.cwd()), ...parsedArgs.ignore];
 var files = await expandInputs(inputs, ignore);
 if (files.length === 0) {
   console.error("no files matched");

package/dist/index.js

@@ -72,11 +72,11 @@ function getStatementValues(node) {
   if (node.type === "VariableDeclaration") {
     return collectASTNodes(node["declarations"]).map((declarator) => declarator["init"]).filter((init) => isASTNode(init));
   }
-  const { expression } = node;
+  const expression = node["expression"];
   if (node.type !== "ExpressionStatement" || !isASTNode(expression)) {
     return [];
   }
-  const { right } = expression;
+  const right = expression["right"];
   if (expression.type === "AssignmentExpression" && isASTNode(right)) {
     return [right];
   }
@@ -141,7 +141,7 @@ function getStatementKind(node) {
   return isExpressionStatementOf(node, MUTATION_TYPES) ? "mutation" : null;
 }
 function isExpressionStatementOf(node, types) {
-  const { expression } = node;
+  const expression = node["expression"];
   return node.type === "ExpressionStatement" && isASTNode(expression) && types.includes(expression.type);
 }
 var VAR_DECL_KINDS = new Set(["const", "let", "var"]);

package/package.json

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