One day I'll figure this shit out

fix: bad exit logic
feat: field rename now supports renaming things with multiple widgets

.gitea/workflows/release.yml

@@ -30,7 +30,7 @@ jobs:
         uses: https://git.cyborggrizzly.com/bearmetal/ci-actions/deno-release@main
         with:
           entrypoint: main.ts
-          compile-flags: "--allow-read --allow-write --allow-env --allow-net"
+          compile-flags: "--allow-read --allow-write --allow-env --allow-net --include asciiart.txt"
         env:
           GITEA_TOKEN: ${{ secrets.GIT_PAT }}
 

.gitignore

@@ -4,3 +4,5 @@
 
 log.txt
 log
+
+test2.pdf

CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+## v1.0.2 (2025-05-20)
+
+<!-- auto-changelog -->
+
+## v1.0.1 (2025-05-7)
+
+<!-- auto-changelog -->
+
+### Known Issues
+
+- help flags can cause issues
+
+## v1.0.0 (2025-05-7)
+
+### Features
+
+- Check Code Tool
+  - reads supplied code files to see if form fields are present and represented
+    in a switch statement
+- Field Rename Tool
+  - provide a search and replace pattern to bulk rename form fields
+- List Form Fields
+  - Sometimes you just need to see what fields there are
+
+### Known Issues
+
+- Field rename does not represent full change applied to the field, only the
+  replaced text
+- help flags can cause issues
+- ascii art is broken (sad face)
+- banana doesn't work
+
+## v0.0.0 (never)
+
+this is just here for a reference to the auto-changelog
+
+<!-- auto-changelog -->

README.md

@@ -1,7 +1,16 @@
-# Emma's Simple Form Field Checker
+# BearMetal PDF Tools
 
-Compares a PDF form to a list of CS class files to see if all field names are
+A collection of tools for working with PDF forms.
-present, excluding signature fields.
+
+## Features
+
+- Check Code Tool
+  - reads supplied code files to see if form fields are present and represented
+    in a switch statement
+- Field Rename Tool
+  - provide a search and replace pattern to bulk rename form fields
+- List Form Fields
+  - Sometimes you just need to see what fields there are
 
 ## Prereqs
 
@@ -11,7 +20,8 @@ Deno >=2.2 (not required if downloading .exe)
 
 ### Deno install
 
-`deno task install` -> installs as global command `checkfields`
+`deno install -g --allow-read --allow-write --allow-net --allow-env jsr:@bearmetal/pdf-tools`
+-> installs as global command `pdf-tools`
 
 ### Compile
 
@@ -20,17 +30,51 @@ Deno >=2.2 (not required if downloading .exe)
 > If you want it to be a global command, create an executables directory and add
 > it to the PATH
 
+### Precompiled
+
+Download the latest release from the
+[releases page](https://git.cyborggrizzly.com/BearMetal/pdf-tools/releases)
+
 ## Usage
 
-`checkfields <path to PDF> <comma-separated list of paths to CS class files>`
+`pdf-tools <tool> <args>` -> `<tool>` is one of the following
--OR- `checkfields` and follow prompts.
 
-### Output
+- check-code
+- field-rename
+- list-form-fields
 
-> All form fields present!
+## Contributing
 
--OR-
+Contributions are welcome!
 
-> The following field names are not present in the CS code
+## License
 
-> \<list of missing form fields\>
+GPL 3.0
+
+---
+
+### About this project
+
+BearMetal PDF Tools is a collection of tools made to fix the current state of
+PDF form editing. Adobe Acrobat is a great tool, but it's not always the easiest
+to use, nor is it free. It also lacks some features that I find useful, such as
+bulk renaming of form fields. There's also a lack of powerful, free, and open
+source tools for PDF editing.
+
+This project aims to fill that gap by providing a set of tools that can be used
+to edit PDF forms. The tools are written in Deno, a modern and secure runtime
+for JavaScript and TypeScript. They are designed to be easy to use and to
+provide a great user experience.
+
+The tools are designed to be used in a terminal, and are not designed to be
+integrated into other applications. They are also not designed to be used as a
+library, but rather as a command line tool.
+
+### About BearMetal
+
+BearMetal is a project that aims to decrapify modern web development. It is a
+collection of tools, libraries, and resources that aim to make web development
+more accessible and less intimidating. The project is open source and free to
+use, and is designed to be used by anyone, regardless of skill level or
+experience. You can find a list of libraries and tools on
+[JSR](https://jsr.io/@bearmetal).

cli/InputManager.ts

@@ -0,0 +1,196 @@
+interface EventMap {
+  keypress: CLIKeypressEvent;
+  char: CLICharEvent;
+  activate: Event;
+  deactivate: Event;
+  exit: Event;
+  enter: Event;
+  backspace: Event;
+  delete: Event;
+  "arrow-left": Event;
+  "arrow-right": Event;
+  "arrow-up": Event;
+  "arrow-down": Event;
+  [key: string]: Event;
+}
+
+interface EventDetailMap {
+  keypress: {
+    key: number;
+    sequence?: Uint8Array;
+  };
+  char: EventDetailMap["keypress"] & {
+    char: string;
+  };
+}
+
+export type TypedEventTarget<EventMap extends object> = {
+  new (): IntermediateEventTarget<EventMap>;
+};
+
+export interface IntermediateEventTarget<EventMap> extends EventTarget {
+  addEventListener<K extends keyof EventMap>(
+    type: K,
+    listener: (
+      event: EventMap[K] extends Event ? EventMap[K] : Event,
+    ) => EventMap[K] extends Event ? void : never,
+    options?: boolean | AddEventListenerOptions,
+  ): void;
+
+  addEventListener(
+    type: string,
+    listener: EventListenerOrEventListenerObject,
+    options?: boolean | AddEventListenerOptions,
+  ): void;
+
+  removeEventListener<K extends keyof EventMap>(
+    type: K,
+    listener: (
+      event: EventMap[K] extends Event ? EventMap[K] : Event,
+    ) => EventMap[K] extends Event ? void : never,
+    options?: boolean | AddEventListenerOptions,
+  ): void;
+
+  removeEventListener(
+    type: string,
+    listener: EventListenerOrEventListenerObject,
+    options?: boolean | AddEventListenerOptions,
+  ): void;
+}
+
+const ManagerEventTarget = EventTarget as TypedEventTarget<EventMap>;
+
+export class CLICharEvent extends CustomEvent<EventDetailMap["char"]> {
+  constructor(detail: EventDetailMap["char"]) {
+    super("char", { detail, cancelable: true });
+  }
+}
+export class CLIKeypressEvent extends CustomEvent<EventDetailMap["keypress"]> {
+  constructor(detail: EventDetailMap["keypress"]) {
+    super("keypress", { detail, cancelable: true });
+  }
+}
+
+export class InputManager extends ManagerEventTarget {
+  private static instance = new InputManager();
+  private active = false;
+
+  static getInstance(): InputManager {
+    return this.instance ??= new InputManager();
+  }
+
+  static addEventListener = InputManager.prototype.addEventListener.bind(
+    this.instance,
+  );
+  static removeEventListener = InputManager.prototype.removeEventListener.bind(
+    this.instance,
+  );
+  static dispatchEvent = InputManager.prototype.dispatchEvent.bind(
+    this.instance,
+  );
+
+  activate({ raw = true }: { raw?: boolean } = {}) {
+    if (this.active) return;
+    this.active = true;
+    this.dispatchEvent(new Event("activate"));
+    this.listen(raw);
+  }
+
+  deactivate({ dactivateRaw = true }: { dactivateRaw?: boolean } = {}) {
+    if (!this.active) return;
+    this.active = false;
+    this.dispatchEvent(new Event("deactivate"));
+    if (dactivateRaw) Deno.stdin.setRaw(false);
+  }
+
+  once<T extends string>(type: T): Promise<Event> {
+    return new Promise((resolve) => {
+      const handler = (event: Event) => {
+        this.removeEventListener(type, handler);
+        resolve(event);
+      };
+      this.addEventListener(type, handler);
+    });
+  }
+
+  private async listen(raw: boolean) {
+    if (raw) await Deno.stdin.setRaw(true);
+    const buf = new Uint8Array(64);
+
+    while (this.active) {
+      const n = await Deno.stdin.read(buf);
+      if (n === null) break;
+
+      let i = 0;
+      while (i < n) {
+        const byte = buf[i];
+
+        // Ctrl+C
+        if (byte === 3) {
+          this.dispatchEvent(new Event("exit"));
+          await Deno.stdin.setRaw(false);
+          Deno.exit(130);
+        }
+
+        // Enter
+        if (byte === 13) {
+          this.dispatchEvent(new Event("enter"));
+          i++;
+          continue;
+        }
+
+        // Backspace
+        if (byte === 127 || byte === 8) {
+          this.dispatchEvent(new Event("backspace"));
+          i++;
+          continue;
+        }
+
+        // Escape sequences
+        if (byte === 27 && i + 1 < n && buf[i + 1] === 91) {
+          const code = buf[i + 2];
+          switch (code) {
+            case 65:
+              this.dispatchEvent(new Event("arrow-up"));
+              break;
+            case 66:
+              this.dispatchEvent(new Event("arrow-down"));
+              break;
+            case 67:
+              this.dispatchEvent(new Event("arrow-right"));
+              break;
+            case 68:
+              this.dispatchEvent(new Event("arrow-left"));
+              break;
+            case 51:
+              if (i + 3 < n && buf[i + 3] === 126) {
+                this.dispatchEvent(new Event("delete"));
+                i += 4;
+                continue;
+              }
+              break;
+          }
+          i += 3;
+          continue;
+        }
+
+        // Printable ASCII
+        if (byte >= 32 && byte <= 126) {
+          this.dispatchEvent(
+            new CLICharEvent({ key: byte, char: String.fromCharCode(byte) }),
+          );
+          i++;
+          continue;
+        }
+
+        // Unknown
+        this.dispatchEvent(
+          new CLIKeypressEvent({ key: byte, sequence: buf.slice(i, i + 1) }),
+        );
+        i++;
+      }
+    }
+
+    if (raw) await Deno.stdin.setRaw(false);
+  }
+}

cli/TerminalLayout.ts

@@ -22,7 +22,7 @@ export class TerminalLayout {
 
     Deno.addSignalListener("SIGINT", () => {
       this.clearAll();
-      Deno.exit(0);
+      // Deno.exit(0);
     });
   }
 
@@ -44,7 +44,9 @@ export class TerminalLayout {
       clearTimeout(this.debounceTimer);
     }
     this.debounceTimer = setTimeout(
-      () => this.renderLayout(),
+      () => {
+        this.renderLayout();
+      },
       this.debounceDelay,
     );
   }
@@ -76,6 +78,10 @@ export class TerminalLayout {
       block.renderInternal(usedLines + 1);
       usedLines += lines.length;
     }
+    for (const name of this.layoutOrder) {
+      const block = this.blocks[name];
+      block.runPostRenderAction?.();
+    }
   }
 
   clearAll() {
@@ -111,9 +117,12 @@ export class TerminalBlock {
   private renderHeight: number = 0;
   private lastRenderRow = 1;
 
+  private lastRendered: string[] = [];
+
   private preserveHistory = false;
 
-  constructor(private prepend: string = "") {}
+  constructor(private prepend: string = "") {
+  }
 
   setPreserveHistory(preserveHistory: boolean) {
     this.preserveHistory = preserveHistory;
@@ -193,27 +202,39 @@ export class TerminalBlock {
   }
 
   renderInternal(startRow?: number) {
-    this.lastRenderRow = startRow ?? this.lastRenderRow;
+    const outputLines: string[] = [];
-    this.clear(); // uses old renderedLineCount
 
-    const outputLines = this.renderLines.map((line) =>
+    for (let i = 0; i < this.renderLines.length; i++) {
-      `${this.prepend}${line}\x1b[K`
+      const line = `${this.prepend}${this.renderLines[i]}`;
-    );
+      const previous = this.lastRendered[i];
-    const output = outputLines.join("\n");
+      if (line !== previous) {
-    if (startRow !== undefined) {
+        const moveToLine = `\x1b[${(startRow ?? this.lastRenderRow) + i};1H`;
-      const moveCursor = `\x1b[${startRow};1H`;
+        outputLines.push(moveToLine + line + "\x1b[K");
-      Deno.stdout.writeSync(new TextEncoder().encode(moveCursor + output));
+      }
-    } else {
-      Deno.stdout.writeSync(new TextEncoder().encode(output));
     }
 
-    // update rendered line count *after* rendering
+    if (this.lastRendered.length > this.renderLines.length) {
-    this.renderedLineCount = outputLines.reduce(
+      const baseRow = startRow ?? this.lastRenderRow;
-      (count, line) =>
+      for (let i = this.renderLines.length; i < this.lastRendered.length; i++) {
-        count +
+        const moveToLine = `\x1b[${baseRow + i};1H\x1b[2K`;
-        Math.ceil((line.length) / (Deno.consoleSize().columns || 80)),
+        Deno.stdout.writeSync(new TextEncoder().encode(moveToLine));
-      0,
+      }
-    );
+    }
+
+    const baseRow = startRow ?? this.lastRenderRow;
+    const excessLines = this.renderHeight - this.renderLines.length;
+    for (let i = 0; i < excessLines; i++) {
+      const moveToLine = `\x1b[${
+        baseRow + this.renderLines.length + i
+      };1H\x1b[2K`;
+      Deno.stdout.writeSync(new TextEncoder().encode(moveToLine));
+    }
+
+    this.lastRendered = [...this.renderLines];
+    this.renderedLineCount = this.renderHeight;
+    this.lastRenderRow = baseRow;
+    const output = outputLines.join("\n");
+    Deno.stdout.writeSync(new TextEncoder().encode(output));
   }
 
   clear() {
@@ -242,6 +263,17 @@ export class TerminalBlock {
     return this.fixedHeight ?? 0;
   }
 
+  private _postRenderAction?: () => void;
+  setPostRenderAction(action: (this: TerminalBlock) => void) {
+    this._postRenderAction = action;
+  }
+  runPostRenderAction() {
+    if (this._postRenderAction) {
+      this._postRenderAction.call(this);
+      this._postRenderAction = undefined;
+    }
+  }
+
   get lineCount() {
     return this.renderLines.length;
   }

cli/index.ts

@@ -6,8 +6,7 @@ import { selectMenuInteractive } from "./selectMenu.ts";
 import { TerminalBlock, TerminalLayout } from "./TerminalLayout.ts";
 import { cliAlert, cliLog } from "./prompts.ts";
 import type { ITool } from "../types.ts";
-import { join, toFileUrl } from "@std/path";
+import { InputManager } from "./InputManager.ts";
-import { log } from "util/logfile.ts";
 
 // Register tools here (filename, no extension)
 const toolRegistry: [string, Promise<{ default: ITool }>][] = [
@@ -23,6 +22,7 @@ export class PdfToolsCli {
 
   private args = ArgParser.parse(Deno.args).setFlagDefs({
     help: ["-h", "--help"],
+    banana: ["-b", "--banana"],
   });
 
   async importTools() {
@@ -43,9 +43,7 @@ export class PdfToolsCli {
 
   private async banana() {
     const asciiArt = await getAsciiArt("banana");
-    const body = this.terminalLayout.getBlock("body");
+    this.closeMessage = colorize(asciiArt, "yellow");
-    body.clearAll();
-    cliLog(colorize(asciiArt, "yellow"), body);
   }
 
   private async help() {
@@ -58,12 +56,23 @@ export class PdfToolsCli {
   }
 
   public async run() {
+    const im = InputManager.getInstance();
+    im.activate();
+    im.addEventListener("exit", () => {
+      this.closeMessage = "Exiting...";
+      this.cleanup();
+    });
     try {
       await this.importTools();
       const titleBlock = new TerminalBlock();
       this.terminalLayout.register("title", titleBlock);
       const bodyBlock = new TerminalBlock();
       this.terminalLayout.register("body", bodyBlock);
+      if (this.args.getFlag("banana")) {
+        titleBlock.setFixedHeight(0);
+        await this.banana();
+        return;
+      }
       if (this.args.getFlag("help") && !this.args.task) {
         await this.help();
         return;
@@ -75,11 +84,17 @@ export class PdfToolsCli {
         await this.runTool(toCase(task, "title"));
       }
     } finally {
+      this.cleanup();
+      Deno.exit(0);
+    }
+  }
+
+  private cleanup() {
     this.terminalLayout.clearAll();
+    InputManager.getInstance().deactivate();
     Deno.stdin.setRaw(false);
     if (this.closeMessage) console.log(this.closeMessage);
   }
-  }
 
   private async toolMenu() {
     const tools = this.tools.keys().toArray();

cli/prompts.ts

@@ -2,6 +2,116 @@
 import { Cursor } from "./cursor.ts";
 import { colorize } from "./style.ts";
 import { TerminalBlock, TerminalLayout } from "./TerminalLayout.ts";
+import { type CLICharEvent, InputManager } from "./InputManager.ts";
+
+// export async function cliPrompt(
+//   message: string,
+//   block?: TerminalBlock,
+// ): Promise<string> {
+//   const encoder = new TextEncoder();
+//   const input: string[] = [];
+//   let cursorPos = 0;
+
+//   await Deno.stdin.setRaw(true);
+
+//   const cursorVisible = Cursor["visible"];
+//   Cursor.show();
+
+//   let range: [number, number] = [0, 1];
+//   if (block) {
+//     range = block.setLines([message + " "]);
+//   } else {
+//     Deno.stdout.writeSync(encoder.encode(message + " "));
+//   }
+
+//   const render = () => {
+//     const line = message + " " + input.join("");
+//     const moveTo = `\x1b[${message.length + 2 + cursorPos}G`;
+
+//     if (block) {
+//       block.setPostRenderAction(function () {
+//         Deno.stdout.writeSync(
+//           encoder.encode(`\x1b[${this["lastRenderRow"]};1H`),
+//         );
+//         Deno.stdout.writeSync(encoder.encode(moveTo));
+//       });
+//       range = block.setLines([line], range);
+//     } else {
+//       Deno.stdout.writeSync(encoder.encode("\x1b[K" + line + moveTo));
+//     }
+//   };
+
+//   render();
+
+//   const buf = new Uint8Array(64); // large enough for most pastes
+//   inputLoop:
+//   while (true) {
+//     const n = await Deno.stdin.read(buf);
+//     if (n === null) break;
+
+//     for (let i = 0; i < n; i++) {
+//       const byte = buf[i];
+
+//       // Ctrl+C
+//       if (byte === 3) {
+//         block?.clear();
+//         block?.["layout"]?.clearAll();
+//         await Deno.stdin.setRaw(false);
+//         Deno.exit(130);
+//       }
+
+//       if (byte === 13) { // Enter
+//         break inputLoop;
+//       }
+
+//       // Escape sequence?
+//       if (byte === 27 && i + 1 < n && buf[i + 1] === 91) {
+//         const third = buf[i + 2];
+//         if (third === 68 && cursorPos > 0) cursorPos--; // Left
+//         else if (third === 67 && cursorPos < input.length) cursorPos++; // Right
+//         else if (third === 51 && i + 3 < n && buf[i + 3] === 126) { // Delete
+//           if (cursorPos < input.length) input.splice(cursorPos, 1);
+//           i += 1; // consume tilde
+//         }
+//         i += 2; // consume ESC [ X
+//         continue;
+//       }
+
+//       // Backspace
+//       if (byte === 127 || byte === 8) {
+//         if (cursorPos > 0) {
+//           input.splice(cursorPos - 1, 1);
+//           cursorPos--;
+//         }
+//         continue;
+//       }
+
+//       // Delete (ASCII 46)
+//       if (byte === 46 && cursorPos < input.length) {
+//         input.splice(cursorPos, 1);
+//         continue;
+//       }
+
+//       // Printable
+//       if (byte >= 32 && byte <= 126) {
+//         input.splice(cursorPos, 0, String.fromCharCode(byte));
+//         cursorPos++;
+//       }
+
+//       // Other cases: ignore
+//     }
+
+//     render();
+//   }
+
+//   await Deno.stdin.setRaw(false);
+//   if (!cursorVisible) {
+//     Cursor.hide();
+//   }
+//   Deno.stdout.writeSync(encoder.encode("\n"));
+
+//   return input.join("");
+// }
 
 export async function cliPrompt(
   message: string,
@@ -9,70 +119,141 @@ export async function cliPrompt(
 ): Promise<string> {
   const encoder = new TextEncoder();
   const input: string[] = [];
+  let cursorPos = 0;
+  let range: [number, number] | undefined;
 
-  await Deno.stdin.setRaw(true);
-
-  const cursorVisible = Cursor["visible"];
   Cursor.show();
 
-  let range: [number, number] = [0, 1];
+  const im = InputManager.getInstance();
-  if (block) {
+  im.activate();
-    range = block.setLines([message + " "]);
-  } else {
-    Deno.stdout.writeSync(encoder.encode(message + " "));
-  }
-
-  const buf = new Uint8Array(1);
-  while (true) {
-    const n = await Deno.stdin.read(buf);
-    if (n === null) break;
-    const byte = buf[0];
-
-    if (byte === 3) { // Ctrl+C
-      Deno.stdin.setRaw(false);
-      block?.["layout"]?.clearAll();
-      block?.clear();
-      Deno.exit(130);
-    }
-
-    if (byte === 13) { // Enter
-      break;
-    } else if (byte === 127 || byte === 8) { // Backspace
-      input.pop();
-    } else if (byte >= 32 && byte <= 126) { // Printable chars
-      input.push(String.fromCharCode(byte));
-    }
 
+  const render = () => {
     const line = message + " " + input.join("");
+    const moveTo = `\x1b[${message.length + 2 + cursorPos}G`;
+
     if (block) {
+      block.setPostRenderAction(() => {
+        Deno.stdout.writeSync(encoder.encode(moveTo));
+      });
       range = block.setLines([line], range);
     } else {
-      Deno.stdout.writeSync(encoder.encode("\r\x1b[K" + line));
+      Deno.stdout.writeSync(encoder.encode("\r\x1b[K" + line + moveTo));
-    }
     }
+  };
 
-  await Deno.stdin.setRaw(false);
+  const exit = () => {
-  if (!cursorVisible) {
+    im.removeEventListener("enter", onEnter);
+    im.removeEventListener("backspace", onBackspace);
+    im.removeEventListener("delete", onDelete);
+    im.removeEventListener("arrow-left", onLeft);
+    im.removeEventListener("arrow-right", onRight);
+    im.removeEventListener("char", onKey);
     Cursor.hide();
-  }
+  };
-  Deno.stdout.writeSync(encoder.encode("\n"));
 
-  return input.join("");
+  let resolve: null | ((value: string) => void) = null;
+
+  const onEnter = () => {
+    exit();
+    resolve?.(input.join(""));
+  };
+
+  const onBackspace = () => {
+    if (cursorPos > 0) {
+      input.splice(cursorPos - 1, 1);
+      cursorPos--;
+      render();
+    }
+  };
+
+  const onDelete = () => {
+    if (cursorPos < input.length) {
+      input.splice(cursorPos, 1);
+      render();
+    }
+  };
+
+  const onLeft = () => {
+    if (cursorPos > 0) {
+      cursorPos--;
+      render();
+    }
+  };
+
+  const onRight = () => {
+    if (cursorPos < input.length) {
+      cursorPos++;
+      render();
+    }
+  };
+
+  const onKey = (e: Event) => {
+    const ke = (e as CLICharEvent).detail;
+    input.splice(cursorPos, 0, ke.char);
+    cursorPos++;
+    render();
+  };
+
+  render();
+
+  return await new Promise<string>((res) => {
+    resolve = res;
+    im.addEventListener("enter", onEnter);
+    im.addEventListener("backspace", onBackspace);
+    im.addEventListener("delete", onDelete);
+    im.addEventListener("arrow-left", onLeft);
+    im.addEventListener("arrow-right", onRight);
+    im.addEventListener("char", onKey);
+  });
 }
 
-export function cliConfirm(message: string, block?: TerminalBlock) {
+export async function cliConfirm(message: string, block?: TerminalBlock) {
-  return cliPrompt(message + " (y/n)", block).then((v) =>
+  const im = InputManager.getInstance();
-    v.toLowerCase() === "y"
+  let inpout = "";
+  function isValidInput(input: string) {
+    switch (input) {
+      case "y":
+      case "n":
+        return inpout.length === 0;
+      case "e":
+        return inpout === "y";
+      case "s":
+        return inpout === "ye";
+      case "o":
+        return inpout === "n";
+      default:
+        return false;
+    }
+  }
+
+  function onKey(e: CLICharEvent) {
+    const ke = e.detail;
+    const char = String.fromCharCode(ke.key);
+    if (isValidInput(char)) {
+      inpout += char;
+    } else {
+      e.stopImmediatePropagation();
+    }
+  }
+  im.addEventListener("char", onKey);
+  const value = await cliPrompt(message + " (y/n)", block).then((v) =>
+    v.charAt(0).toLowerCase() === "y"
   );
+  im.removeEventListener("char", onKey);
+  return value;
 }
 
-export function cliAlert(message: string, block?: TerminalBlock) {
+export async function cliAlert(message: string, block?: TerminalBlock) {
-  return cliPrompt(
+  const im = InputManager.getInstance();
+  const onKey = (e: CLICharEvent) => {
+    e.stopImmediatePropagation();
+  };
+  im.addEventListener("char", onKey);
+  await cliPrompt(
     message + colorize(" Press Enter to continue", "gray"),
     block,
-  ).then((v) => {
+  );
-    return v;
+  im.removeEventListener("char", onKey);
-  });
 }
 
 export function cliLog(
@@ -92,18 +273,29 @@ if (import.meta.main) {
   const layout = new TerminalLayout();
   const title = new TerminalBlock();
   const block = new TerminalBlock();
+  const footer = new TerminalBlock();
   block.setPreserveHistory(true);
   // ScrollManager.enable(block);
   title.setLines(["Hello, World!"]);
   title.setFixedHeight(1);
 
+  footer.setLines(["Press Ctrl+C to exit"]);
+  footer.setFixedHeight(1);
+
   layout.register("title", title);
   layout.register("block", block);
+  layout.register("footer", footer);
+
+  InputManager.addEventListener("exit", () => {
+    layout.clearAll();
+    // console.clear();
+    Deno.exit(0);
+  });
 
   Deno.addSignalListener("SIGINT", () => {
     layout.clearAll();
     // console.clear();
-    Deno.exit(0);
+    // Deno.exit(0);
   });
   const name = await cliPrompt("Enter your name:", block);
   cliLog(`Hello, ${name}!`, block);

cli/selectMenu.ts

@@ -1,6 +1,8 @@
 import type { callback } from "../types.ts";
+import { type CLICharEvent, InputManager } from "./InputManager.ts";
+import { cliLog } from "./prompts.ts";
 import { colorize } from "./style.ts";
-import { TerminalBlock } from "./TerminalLayout.ts";
+import { TerminalBlock, TerminalLayout } from "./TerminalLayout.ts";
 
 interface ISelectMenuConfig {
   terminalBlock?: TerminalBlock;
@@ -62,23 +64,37 @@ export async function selectMenuInteractive(
 
   let inputBuffer = "";
 
-  // Function to handle input
+  const im = InputManager.getInstance();
-  async function handleInput() {
+  im.activate();
-    const buf = new Uint8Array(3); // arrow keys send 3 bytes
+
-    while (true) {
+  const onUp = (e: Event) => {
+    e.stopImmediatePropagation();
+    selected = (selected - 1 + options.length) % options.length;
     renderMenu();
-      const n = await Deno.stdin.read(buf);
+  };
-      if (n === null) break;
 
-      const [a, b, c] = buf;
+  const onDown = (e: Event) => {
+    e.stopImmediatePropagation();
+    selected = (selected + 1) % options.length;
+    renderMenu();
+  };
 
-      if (a === 3) {
+  const onKey = (e: CLICharEvent) => {
-        Deno.stdin.setRaw(false);
+    e.stopImmediatePropagation();
-        terminalBlock?.["layout"]?.clearAll();
+    const ke = e.detail;
-        Deno.exit(130);
+    const char = String.fromCharCode(ke.key);
-      }
+    inputBuffer += char;
+  };
 
-      if (a === 13) { // Enter key
+  const onBackspace = (e: Event) => {
+    e.stopImmediatePropagation();
+    inputBuffer = inputBuffer.slice(0, -1);
+  };
+
+  let resolve: null | ((value: string) => void) = null;
+
+  const onEnter = (e: Event) => {
+    e.stopImmediatePropagation();
     if (inputBuffer) {
       const parsed = parseInt(inputBuffer);
       if (!isNaN(parsed)) {
@@ -86,26 +102,27 @@ export async function selectMenuInteractive(
       }
       inputBuffer = "";
     }
-        break;
+    im.removeEventListener("arrow-up", onUp);
-      } else if (a === 27 && b === 91) { // Arrow keys
+    im.removeEventListener("arrow-down", onDown);
-        inputBuffer = "";
+    im.removeEventListener("char", onKey);
-        if (c === 65) { // Up
+    im.removeEventListener("backspace", onBackspace);
-          selected = (selected - 1 + options.length) % options.length;
+    im.removeEventListener("enter", onEnter);
-        } else if (c === 66) { // Down
+    resolve?.(options[selected]);
-          selected = (selected + 1) % options.length;
+  };
-        }
+
-      } else if (a >= 48 && a <= 57) {
+  renderMenu();
-        inputBuffer += String.fromCharCode(a);
+  await new Promise<string>((res) => {
-      } else if (a === 8) {
+    resolve = res;
-        inputBuffer = inputBuffer.slice(0, -1);
+    im.addEventListener("char", onKey);
-      }
+    im.addEventListener("backspace", onBackspace);
-    }
+    im.addEventListener("enter", onEnter);
+    im.addEventListener("arrow-up", onUp);
+    im.addEventListener("arrow-down", onDown);
+  });
 
-    Deno.stdin.setRaw(false);
-    return options[selected];
-  }
   terminalBlock.setLines(["Selected: " + options[selected]], range);
-  return await handleInput();
+
+  return options[selected];
 }
 
 export async function multiSelectMenuInteractive(
@@ -117,9 +134,7 @@ export async function multiSelectMenuInteractive(
   let selected = 0;
   let selectedOptions: number[] = config?.initialSelections || [];
 
-  const rawValues = new Set(
+  const rawValues = options.map((i) => typeof i === "string" ? i : i[0]);
-    options.map((i) => typeof i === "string" ? i : i[0]),
-  ).values().toArray();
 
   if (rawValues.length !== options.length) {
     throw new Error("Duplicate options in multi-select menu");
@@ -158,44 +173,52 @@ export async function multiSelectMenuInteractive(
     range = terminalBlock.setLines(lines, range);
   }
 
-  // Function to handle input
+  const im = InputManager.getInstance();
-  async function handleInput() {
+  im.activate();
-    const buf = new Uint8Array(3); // arrow keys send 3 bytes
-    while (true) {
-      renderMenu();
-      const n = await Deno.stdin.read(buf);
-      if (n === null) break;
 
-      const [a, b, c] = buf;
+  let resolve = null as null | ((value: number[]) => void);
 
-      if (a === 3) {
+  const onUp = (e: Event) => {
-        Deno.stdin.setRaw(false);
+    e.stopImmediatePropagation();
-        terminalBlock?.["layout"]?.clearAll();
-        Deno.exit(130);
-      }
-
-      if (a === 13) { // Enter key
-        break;
-      } else if (a === 27 && b === 91) { // Arrow keys
-        if (c === 65) { // Up
     selected = (selected - 1 + options.length) % options.length;
-        } else if (c === 66) { // Down
+    renderMenu();
+  };
+
+  const onDown = (e: Event) => {
+    e.stopImmediatePropagation();
     selected = (selected + 1) % options.length;
-        }
+    renderMenu();
-      } else if (a === 32) { // Space
+  };
-        Deno.stdout.writeSync(new TextEncoder().encode("\x07"));
+
+  const onSpace = (e: CLICharEvent) => {
+    if (e.detail.char !== " ") return;
+    e.stopImmediatePropagation();
     if (selectedOptions.includes(selected)) {
       selectedOptions = selectedOptions.filter((i) => i !== selected);
     } else {
       selectedOptions.push(selected);
     }
-      }
+    renderMenu();
-    }
+  };
 
-    Deno.stdin.setRaw(false);
+  const onEnter = (e: Event) => {
-    return selectedOptions;
+    e.stopImmediatePropagation();
-  }
+    resolve?.(selectedOptions);
-  const selections = await handleInput();
+    im.removeEventListener("arrow-up", onUp);
+    im.removeEventListener("arrow-down", onDown);
+    im.removeEventListener("char", onSpace);
+    im.removeEventListener("enter", onEnter);
+  };
+
+  renderMenu();
+
+  const selections = await new Promise<number[]>((res) => {
+    resolve = res;
+    im.addEventListener("arrow-up", onUp);
+    im.addEventListener("arrow-down", onDown);
+    im.addEventListener("char", onSpace);
+    im.addEventListener("enter", onEnter);
+  });
   for (const optionI of selections) {
     const option = options[optionI];
     if (Array.isArray(option)) {
@@ -208,17 +231,17 @@ export async function multiSelectMenuInteractive(
 }
 
 if (import.meta.main) {
-  // const layout = new TerminalLayout();
+  const layout = new TerminalLayout();
-  // const block = new TerminalBlock();
+  const block = new TerminalBlock();
-  // const titleBlock = new TerminalBlock();
+  const titleBlock = new TerminalBlock();
-  // const postBlock = new TerminalBlock();
+  const postBlock = new TerminalBlock();
-  // titleBlock.setLines(["An incredible fruit menu!"]);
+  InputManager.addEventListener("exit", () => layout.clearAll());
-  // postBlock.setLines(["I'm here too!"]);
+  titleBlock.setLines(["An incredible fruit menu!"]);
-  // titleBlock.setFixedHeight(1);
+  postBlock.setLines(["I'm here too!"]);
-  // postBlock.setFixedHeight(1);
+  titleBlock.setFixedHeight(1);
-  // layout.register("title", titleBlock);
+  postBlock.setFixedHeight(1);
-  // layout.register("block", block);
+  layout.register("title", titleBlock);
-  // layout.register("post", postBlock);
+  layout.register("block", block);
 
   // const val = await selectMenuInteractive("choose a fruit", [
   //   "apple",
@@ -276,8 +299,8 @@ if (import.meta.main) {
     "ximenia",
     "yuzu",
     "zucchini",
-  ]);
+  ], { terminalBlock: block });
-  console.log(val);
+  cliLog(val || "No value");
 
   // Deno.stdout.writeSync(new TextEncoder().encode("\x07"));
 }

deno.json

@@ -1,10 +1,10 @@
 {
   "name": "@bearmetal/pdf-tools",
-  "version": "1.0.0",
+  "version": "1.0.8-l",
   "license": "GPL 3.0",
   "tasks": {
-    "dev": "deno run -A --env-file=.env --watch main.ts",
+    "dev": "deno run -A --env-file=.env main.ts",
-    "compile": "deno compile -o compare-form-fields.exe --target x86_64-pc-windows-msvc -R ./main.ts",
+    "compile": "deno compile -o pdf-tools.exe --target x86_64-pc-windows-msvc --include ./asciiart.txt -A ./main.ts",
     "install": "deno install -fgq --import-map ./deno.json -n checkfields -R ./main.ts",
     "debug": "deno run -A --env-file=.env --inspect-wait --watch main.ts"
   },
@@ -12,7 +12,8 @@
     "@std/assert": "jsr:@std/assert@1",
     "@std/path": "jsr:@std/path@^1.0.9",
     "pdf-lib": "npm:pdf-lib@^1.17.1",
-    "util/": "./util/"
+    "util/": "./util/",
+    "@/": "./"
   },
   "exports": {
     ".": "./main.ts"

main.ts

@@ -1,5 +1,10 @@
 /// <reference types="./types.ts" />
 import { PdfToolsCli } from "./cli/index.ts";
+// import { log } from "util/logfile.ts";
 
+// try {
 const app = new PdfToolsCli();
 app.run();
+// } catch (e) {
+//   // log(e);
+// }

tools/fieldRename.ts

@@ -1,81 +1,755 @@
-import { type PDFAcroField, type PDFField, PDFName, PDFString } from "pdf-lib";
+import {
-import { loadPdf, loadPdfForm, savePdf } from "util/saveLoadPdf.ts";
+  PDFAcroField,
-import { callWithArgPrompt } from "util/call.ts";
+  PDFAcroTerminal,
+  PDFArray,
+  PDFCheckBox,
+  PDFContext,
+  PDFDict,
+  type PDFDocument,
+  type PDFField,
+  PDFHexString,
+  PDFName,
+  PDFNumber,
+  type PDFObject,
+  PDFRadioGroup,
+  PDFRef,
+  PDFString,
+  PDFTextField,
+  type PDFWidgetAnnotation,
+} from "pdf-lib";
+import { loadPdf, savePdf } from "util/saveLoadPdf.ts";
 import { TerminalBlock } from "../cli/TerminalLayout.ts";
 import { forceArgs } from "../cli/forceArgs.ts";
 import { colorize } from "../cli/style.ts";
 import { cliAlert, cliLog, cliPrompt } from "../cli/prompts.ts";
 import { multiSelectMenuInteractive } from "../cli/selectMenu.ts";
 import type { callback, ITool } from "../types.ts";
+import { toCase } from "util/caseManagement.ts";
+import { log } from "util/logfile.ts";
 
-async function renameFields(
+function removeWidgetFromOldField(
-  path: string,
+  doc: PDFDocument,
-  pattern: string | RegExp,
-  change: string,
-) {
-  if (typeof pattern === "string") pattern = new RegExp(pattern);
-  const form = await loadPdfForm(path);
-  const fields = form.getFields();
-  let changesMade = false;
-  for (const field of fields) {
-    const name = field.getName();
-    if (pattern.test(name)) {
-      console.log(name + " %cfound", "color: red");
-      const segments = name.split(".");
-      const matchingSegments = segments.filter((s) => pattern.test(s));
-      let cField: PDFAcroField | undefined = field.acroField;
-      while (cField) {
-        if (
-          cField.getPartialName() &&
-          matchingSegments.includes(cField.getPartialName()!)
-        ) {
-          const mName = cField.getPartialName()?.replace(pattern, change);
-          if (mName) {
-            changesMade = true;
-            cField.dict.set(PDFName.of("T"), PDFString.of(mName));
-          }
-        }
-        cField = cField.getParent();
-      }
-    }
-  }
-  if (changesMade) {
-    savePdf(form.doc, path);
-  }
-}
-
-function applyRename(
   field: PDFField,
-  name: string,
+  widget: PDFWidgetAnnotation,
+) {
+  const maybeKids = field.acroField.dict.get(PDFName.of("Kids"));
+  if (!maybeKids || !(maybeKids instanceof PDFArray)) return;
+  const kids = maybeKids;
+  if (!kids) return;
+
+  const widgetRef = getWidgetRef(widget, doc);
+  if (!widgetRef) return;
+
+  const updatedKids = kids.asArray().filter((ref) => {
+    const dict = doc.context.lookup(ref);
+    return dict !== widget.dict;
+  });
+
+  if (updatedKids.length === 0) {
+    // Field is now empty, remove it from the AcroForm
+    const acroForm = doc.catalog.lookup(PDFName.of("AcroForm"), PDFDict);
+    const fields = acroForm.lookup(PDFName.of("Fields"), PDFArray);
+    const fieldRef = field.acroField.ref;
+    const newFields = fields.asArray().filter((ref) => ref !== fieldRef);
+    acroForm.set(PDFName.of("Fields"), doc.context.obj(newFields));
+  } else {
+    field.acroField.dict.set(PDFName.of("Kids"), doc.context.obj(updatedKids));
+  }
+}
+
+function moveWidgetToFlatField(
+  doc: PDFDocument,
+  field: PDFField,
+  widget: PDFWidgetAnnotation,
+  newName: string,
+) {
+  const form = doc.getForm();
+  const page = findPageForWidget(doc, widget);
+  if (!page) throw new Error("Widget's page not found");
+
+  const rect = widget.getRectangle();
+  if (!rect) throw new Error("Widget has no rectangle");
+
+  const fieldType = detectFieldType(field);
+  const widgetRef = getWidgetRef(widget, doc);
+  if (!widgetRef) throw new Error("Widget ref not found");
+
+  // 🔒 Extract value + style before any destructive ops
+  let value: string | undefined;
+  try {
+    if (fieldType === "/Tx" && field instanceof PDFTextField) {
+      value = field.getText();
+    }
+  } catch (_) {
+    log("Failed to extract value from field");
+  }
+
+  const sourceFieldDict = field.acroField.dict;
+  const sourceWidgetDict = widget.dict;
+
+  // 🔥 Remove widget from page + field
+  removeWidgetFromPage(widget, doc);
+  removeWidgetCompletely(doc, widget, field);
+
+  // 🔥 Carefully remove field + parents
+  try {
+    fullyDeleteFieldHierarchy(doc, field);
+  } catch (_) {
+    // fallback
+    log("Failed to remove field hierarchy");
+    removeFieldIfEmpty(doc, field);
+  }
+
+  sanitizeFieldsTree(doc);
+  removeDanglingParents(doc);
+  removeEmptyAncestors(doc, field);
+
+  // 🔁 Create replacement field
+  let newField: PDFField;
+
+  switch (fieldType) {
+    case "/Tx": {
+      const tf = form.createTextField(newName);
+      if (value) tf.setText(value);
+      tf.addToPage(page, rect);
+      newField = tf;
+      break;
+    }
+
+    case "/Btn": {
+      const isRadio = getFlag(field, 15);
+      if (isRadio) {
+        const rg = form.createRadioGroup(newName);
+        rg.addOptionToPage(newName, page, rect);
+        return;
+      } else {
+        const cb = form.createCheckBox(newName);
+        cb.addToPage(page, rect);
+        if (field instanceof PDFCheckBox && field.isChecked()) {
+          cb.check();
+        }
+        return;
+      }
+    }
+
+    case "/Ch": {
+      const ff = sourceFieldDict.get(PDFName.of("Ff"));
+      const isCombo = ff instanceof PDFNumber &&
+        ((ff.asNumber() & (1 << 17)) !== 0);
+      const opts = sourceFieldDict.lookupMaybe(PDFName.of("Opt"), PDFArray);
+      const values =
+        opts?.asArray().map((opt) =>
+          opt instanceof PDFString || opt instanceof PDFHexString
+            ? opt.decodeText()
+            : ""
+        ) ?? [];
+
+      if (isCombo) {
+        const dd = form.createDropdown(newName);
+        dd.addOptions(values);
+        dd.addToPage(page, rect);
+        newField = dd;
+      } else {
+        const ol = form.createOptionList(newName);
+        ol.addOptions(values);
+        ol.addToPage(page, rect);
+        newField = ol;
+      }
+      break;
+    }
+
+    default:
+      throw new Error(`Unsupported field type: ${fieldType}`);
+  }
+
+  // 🔧 Apply styles *after creation*
+  const targetWidgetDict = newField.acroField.getWidgets()[0].dict;
+  copyFieldAndWidgetStyles(
+    sourceFieldDict,
+    sourceWidgetDict,
+    newField.acroField.dict,
+    targetWidgetDict,
+  );
+}
+
+function removeDanglingParents(doc: PDFDocument) {
+  const context = doc.context;
+  const acroForm = doc.catalog.lookup(PDFName.of("AcroForm"), PDFDict);
+  const fields = acroForm.lookupMaybe(PDFName.of("Fields"), PDFArray);
+  if (!(fields instanceof PDFArray)) return;
+
+  function fixFieldDict(dict: PDFDict) {
+    const parentRef = dict.get(PDFName.of("Parent"));
+    if (!parentRef || !(parentRef instanceof PDFRef)) return;
+
+    try {
+      const parentDict = context.lookup(parentRef, PDFDict);
+      if (!parentDict) throw new Error("Missing parent");
+    } catch {
+      // Parent is broken — remove reference
+      dict.delete(PDFName.of("Parent"));
+      log("Broken parent reference removed");
+    }
+  }
+
+  const visited = new Set<string>();
+
+  function recurseKids(dict: PDFDict) {
+    const kids = dict.lookupMaybe(PDFName.of("Kids"), PDFArray);
+    if (!(kids instanceof PDFArray)) return;
+
+    for (const kidRef of kids.asArray()) {
+      if (!(kidRef instanceof PDFRef)) continue;
+      const key = kidRef.toString();
+      if (visited.has(key)) continue;
+      visited.add(key);
+
+      try {
+        const kidDict = context.lookup(kidRef, PDFDict);
+        fixFieldDict(kidDict);
+        recurseKids(kidDict);
+      } catch (e) {
+        context.delete(kidRef); // nuke broken reference
+        log("Broken kid reference removed");
+        log(e);
+      }
+    }
+  }
+
+  for (const ref of fields.asArray()) {
+    if (!(ref instanceof PDFRef)) continue;
+    try {
+      const dict = context.lookup(ref, PDFDict);
+      fixFieldDict(dict);
+      recurseKids(dict);
+    } catch {
+      context.delete(ref); // broken root
+      log("Broken root reference removed");
+    }
+  }
+}
+
+function removeFieldByName(doc: PDFDocument, fieldName: string) {
+  const form = doc.getForm();
+  const acroForm = doc.catalog.lookup(PDFName.of("AcroForm"), PDFDict);
+  const fields = acroForm.lookup(PDFName.of("Fields"), PDFArray);
+  const context = doc.context;
+
+  const remainingFields = fields.asArray().filter((ref) => {
+    const dict = context.lookup(ref, PDFDict);
+    const name = dict?.get(PDFName.of("T"));
+
+    if (name && (name.decodeText?.() === fieldName)) {
+      context.delete(ref as PDFRef);
+      return false;
+    }
+
+    return true;
+  });
+
+  acroForm.set(PDFName.of("Fields"), context.obj(remainingFields));
+}
+
+function sanitizeFieldsTree(doc: PDFDocument) {
+  const context = doc.context;
+  const acroForm = doc.catalog.lookup(PDFName.of("AcroForm"), PDFDict);
+  const fields = acroForm.lookupMaybe(PDFName.of("Fields"), PDFArray);
+  if (!(fields instanceof PDFArray)) return;
+
+  function pruneInvalidKids(dict: PDFDict, context: PDFContext) {
+    const kids = dict.lookupMaybe(PDFName.of("Kids"), PDFArray);
+    if (!(kids instanceof PDFArray)) return;
+
+    const validKids: PDFRef[] = [];
+
+    for (const ref of kids.asArray()) {
+      // 💥 Defensive: skip anything that's not a real PDFRef
+      if (!ref || !(ref instanceof PDFRef)) continue;
+
+      let child: PDFDict | undefined;
+      try {
+        child = context.lookup(ref, PDFDict);
+      } catch (e) {
+        context.delete(ref);
+        log("Broken kid reference removed");
+        log(e);
+        continue;
+      }
+
+      if (!child) {
+        context.delete(ref);
+        continue;
+      }
+
+      const t = child.get(PDFName.of("T"));
+      if (!(t instanceof PDFString || t instanceof PDFHexString)) {
+        context.delete(ref);
+        continue;
+      }
+
+      // Recurse, but protect inner layers too
+      pruneInvalidKids(child, context);
+      validKids.push(ref);
+    }
+
+    if (validKids.length > 0) {
+      dict.set(PDFName.of("Kids"), context.obj(validKids));
+    } else {
+      dict.delete(PDFName.of("Kids"));
+    }
+  }
+
+  const validFields: PDFRef[] = [];
+
+  for (const ref of fields.asArray()) {
+    if (!ref || !(ref instanceof PDFRef)) continue;
+
+    let dict: PDFDict | undefined;
+    try {
+      dict = context.lookup(ref, PDFDict);
+    } catch {
+      context.delete(ref);
+      log("Broken field reference removed");
+      continue;
+    }
+
+    if (!dict) {
+      context.delete(ref);
+      continue;
+    }
+
+    const t = dict.get(PDFName.of("T"));
+    if (!(t instanceof PDFString || t instanceof PDFHexString)) {
+      context.delete(ref);
+      continue;
+    }
+
+    pruneInvalidKids(dict, context);
+    validFields.push(ref);
+  }
+
+  acroForm.set(PDFName.of("Fields"), context.obj(validFields));
+}
+
+function fullyDeleteFieldHierarchy(doc: PDFDocument, rootField: PDFField) {
+  const context = doc.context;
+  const acroForm = doc.catalog.lookup(PDFName.of("AcroForm"), PDFDict);
+  const fields = acroForm.lookup(PDFName.of("Fields"), PDFArray);
+
+  function recurseDelete(dict: PDFDict, ref: PDFRef) {
+    const kids = dict.lookupMaybe(PDFName.of("Kids"), PDFArray);
+
+    if (kids instanceof PDFArray) {
+      for (const kidRef of kids.asArray()) {
+        const kidDict = context.lookup(kidRef, PDFDict);
+        if (kidDict) {
+          recurseDelete(kidDict, kidRef as PDFRef);
+        }
+      }
+    }
+
+    context.delete(ref);
+  }
+
+  recurseDelete(rootField.acroField.dict, rootField.acroField.ref);
+
+  // Remove root from AcroForm.Fields
+  const newFields = fields
+    .asArray()
+    .filter((ref) => ref !== rootField.acroField.ref);
+
+  acroForm.set(PDFName.of("Fields"), context.obj(newFields));
+}
+
+function removeEmptyAncestors(doc: PDFDocument, field: PDFField) {
+  let current: PDFAcroField | undefined = field.acroField;
+  const context = doc.context;
+
+  while (current) {
+    const parent = current.getParent();
+
+    const kids = parent?.dict.lookupMaybe(PDFName.of("Kids"), PDFArray);
+    if (kids instanceof PDFArray) {
+      const remaining = kids.asArray().filter((ref) => {
+        try {
+          const kidDict = context.lookup(ref, PDFDict);
+          return kidDict !== current?.dict;
+        } catch (e) {
+          log("Broken kid reference removed");
+          log(e);
+          return false;
+        }
+      });
+
+      if (remaining.length > 0) {
+        parent.dict.set(PDFName.of("Kids"), context.obj(remaining));
+        break;
+      } else {
+        parent.dict.delete(PDFName.of("Kids"));
+      }
+    }
+
+    context.delete(current.ref);
+    current = parent;
+  }
+}
+
+function removeWidgetCompletely(
+  doc: PDFDocument,
+  widget: PDFWidgetAnnotation,
+  field: PDFField,
+) {
+  const widgetRef = getWidgetRef(widget, doc);
+  if (!widgetRef) return;
+
+  // 1. Remove from field's /Kids array
+  const kidsRaw = field.acroField.dict.get(PDFName.of("Kids"));
+  if (kidsRaw instanceof PDFArray) {
+    const updatedKids = kidsRaw.asArray().filter((ref) => {
+      const dict = doc.context.lookup(ref);
+      return dict !== widget.dict;
+    });
+
+    if (updatedKids.length > 0) {
+      field.acroField.dict.set(
+        PDFName.of("Kids"),
+        doc.context.obj(updatedKids),
+      );
+    } else {
+      field.acroField.dict.delete(PDFName.of("Kids"));
+    }
+  }
+
+  // 2. Remove from page /Annots
+  for (const page of doc.getPages()) {
+    const annotsRaw = page.node.Annots()?.asArray();
+    if (!annotsRaw) continue;
+
+    const remainingAnnots = annotsRaw.filter((ref) => {
+      const dict = doc.context.lookup(ref);
+      return dict !== widget.dict;
+    });
+
+    page.node.set(PDFName.of("Annots"), doc.context.obj(remainingAnnots));
+  }
+
+  // Optional: delete the widget from the context
+  doc.context.delete(widgetRef);
+}
+function removeFieldIfEmpty(doc: PDFDocument, field: PDFField) {
+  const kids = field.acroField.getWidgets();
+  if (kids.length > 0) return;
+
+  const acroForm = doc.catalog.lookup(PDFName.of("AcroForm"), PDFDict);
+  const fieldsArray = acroForm.lookup(PDFName.of("Fields"), PDFArray);
+  const ref = field.acroField.ref;
+
+  const updatedFields = fieldsArray.asArray().filter((f) => f !== ref);
+  acroForm.set(PDFName.of("Fields"), doc.context.obj(updatedFields));
+
+  // Optional: remove field object entirely
+  doc.context.delete(ref);
+}
+
+function copyFieldAndWidgetStyles(
+  sourceFieldDict: PDFDict,
+  sourceWidgetDict: PDFDict,
+  targetFieldDict: PDFDict,
+  targetWidgetDict: PDFDict,
+) {
+  const fieldKeys = ["DA", "DR", "Q"];
+  const widgetKeys = ["MK", "BS", "Border"];
+
+  // Copy from field dict → field dict
+  for (const key of fieldKeys) {
+    const val = sourceFieldDict.get(PDFName.of(key));
+    if (val) {
+      targetFieldDict.set(PDFName.of(key), val);
+    }
+  }
+
+  // Copy from widget dict → widget dict
+  for (const key of widgetKeys) {
+    const val = sourceWidgetDict.get(PDFName.of(key));
+    if (val) {
+      targetWidgetDict.set(PDFName.of(key), val);
+    }
+  }
+}
+
+function findPageForWidget(
+  doc: PDFDocument,
+  widget: PDFWidgetAnnotation,
+) {
+  const pages = doc.getPages();
+  for (const page of pages) {
+    const annots = page.node.Annots();
+    if (!annots) continue;
+
+    const annotRefs = annots.asArray();
+    for (const ref of annotRefs) {
+      const annot = doc.context.lookup(ref);
+      if (annot === widget.dict) {
+        return page;
+      }
+    }
+  }
+  return undefined;
+}
+
+function detectFieldType(field: PDFField): string | undefined {
+  const ft = field.acroField.dict.get(PDFName.of("FT"));
+  return ft instanceof PDFName ? ft.asString() : undefined;
+}
+
+function getFlag(field: PDFField, bit: number): boolean {
+  const ff = field.acroField.dict.get(PDFName.of("Ff"));
+  return ff instanceof PDFNumber ? (ff.asNumber() & (1 << bit)) !== 0 : false;
+}
+
+function getWidgetRef(
+  widget: PDFWidgetAnnotation,
+  doc: PDFDocument,
+): PDFRef | undefined {
+  for (const page of doc.getPages()) {
+    const annots = page.node.Annots()?.asArray() ?? [];
+    for (const ref of annots) {
+      const maybeDict = doc.context.lookup(ref);
+      if (maybeDict === widget.dict) {
+        return ref as PDFRef;
+      }
+    }
+  }
+  return undefined;
+}
+
+function applyWidgetRename(
+  doc: PDFDocument,
+  field: PDFField,
+  widget: PDFWidgetAnnotation,
+  newName: string,
   pattern: RegExp,
   change: string,
 ) {
-  const segments = name.split(".");
+  try {
-  const matchingSegments = segments.filter((s) => pattern.test(s));
+    const form = doc.getForm();
-  let cField: PDFAcroField | undefined = field.acroField;
+    const widgets = field.acroField.getWidgets();
-  while (cField) {
+    const widgetDict = widget.dict;
-    if (
+    const widgetIndex = widgets.findIndex((w) => w.dict === widgetDict);
-      cField.getPartialName() &&
+    if (widgetIndex === -1) return;
-      matchingSegments.includes(cField.getPartialName()!)
+
-    ) {
+    const widgetRef = getWidgetRef(widget, doc);
-      const mName = cField.getPartialName()?.replace(pattern, change);
+    if (!widgetRef) return;
-      if (mName) {
+
-        cField.dict.set(PDFName.of("T"), PDFString.of(mName));
+    // Remove widget from internal widgets list
-        // console.log(cField.getPartialName())
+    widgets.splice(widgetIndex, 1);
+
+    // Remove from /Kids
+    const maybeKids = field.acroField.dict.get(PDFName.of("Kids"));
+    if (maybeKids instanceof PDFArray) {
+      const updatedKids = maybeKids.asArray().filter((ref) => {
+        const maybeDict = doc.context.lookup(ref);
+        return maybeDict !== widgetDict;
+      });
+      field.acroField.dict.set(
+        PDFName.of("Kids"),
+        doc.context.obj(updatedKids),
+      );
     }
+
+    const page = findPageForWidget(doc, widget);
+    if (!page) throw new Error("Widget's page not found");
+
+    const rect = widget.getRectangle();
+    if (!rect) throw new Error("Widget has no rectangle");
+
+    const finalName = newName.replace(pattern, change);
+    const fieldType = detectFieldType(field);
+
+    // Attempt to find an existing field with the new name
+    let targetField: PDFField | undefined;
+    try {
+      targetField = form.getField(finalName);
+    } catch {
+      //
+      log("Failed to find existing field");
     }
-    cField = cField.getParent();
+
-    // console.log(cField?.getPartialName())
+    if (targetField) {
+      const sourceType = detectFieldType(field);
+      const targetType = detectFieldType(targetField);
+      if (sourceType !== targetType) {
+        throw new Error(
+          `Field "${finalName}" already exists with a different type (${targetType} vs ${sourceType})`,
+        );
+      }
+
+      // Add widget to existing field
+      widget.dict.set(PDFName.of("Parent"), targetField.acroField.ref);
+
+      const kids = targetField.acroField.dict.lookup(
+        PDFName.of("Kids"),
+        PDFArray,
+      );
+      if (kids) {
+        kids.push(widgetRef);
+      } else {
+        targetField.acroField.dict.set(
+          PDFName.of("Kids"),
+          doc.context.obj([widgetRef]),
+        );
+      }
+
+      const annots = page.node.Annots()?.asArray() ?? [];
+      if (!annots.includes(widgetRef)) {
+        annots.push(widgetRef);
+        page.node.set(PDFName.of("Annots"), doc.context.obj(annots));
+      }
+
+      removeWidgetFromPage(widget, doc);
+      removeWidgetCompletely(doc, widget, field);
+      removeFieldIfEmpty(doc, field);
+
+      return;
+    }
+
+    // No existing field — create new one and move widget
+    removeWidgetFromPage(widget, doc);
+    removeWidgetCompletely(doc, widget, field);
+    removeFieldIfEmpty(doc, field);
+
+    let newField: PDFField;
+
+    switch (fieldType) {
+      case "/Tx": {
+        const tf = form.createTextField(finalName);
+        if (field instanceof PDFTextField) {
+          const val = field.getText();
+          if (val) tf.setText(val);
+        }
+        tf.addToPage(page, {
+          x: rect.x,
+          y: rect.y,
+          width: rect.width,
+          height: rect.height,
+        });
+        newField = tf;
+        break;
+      }
+
+      case "/Btn": {
+        const isRadio = getFlag(field, 15);
+        if (isRadio) {
+          const radio = form.createRadioGroup(finalName);
+          radio.addOptionToPage(finalName, page, {
+            x: rect.x,
+            y: rect.y,
+            width: rect.width,
+            height: rect.height,
+          });
+          if (field instanceof PDFRadioGroup) {
+            const selected = field.getSelected();
+            if (selected) radio.select(selected);
+          }
+          return;
+        } else {
+          const cb = form.createCheckBox(finalName);
+          cb.addToPage(page, {
+            x: rect.x,
+            y: rect.y,
+            width: rect.width,
+            height: rect.height,
+          });
+          if (field instanceof PDFCheckBox && field.isChecked()) {
+            cb.check();
+          }
+          return;
         }
       }
 
-function evaluateChange(change: string, match: RegExpExecArray) {
+      default:
+        throw new Error(`Unsupported field type: ${fieldType}`);
+    }
+
+    // Apply styles from old field/widget after creation
+    copyFieldAndWidgetStyles(
+      field.acroField.dict,
+      widget.dict,
+      newField.acroField.dict,
+      newField.acroField.getWidgets()[0].dict,
+    );
+  } catch (e) {
+    log("applyWidgetRename error:", e);
+  }
+}
+
+function removeWidgetFromPage(widget: PDFWidgetAnnotation, doc: PDFDocument) {
+  const pages = doc.getPages();
+
+  for (const page of pages) {
+    const annotsArray = page.node.Annots();
+    if (!annotsArray) continue;
+
+    const refs = annotsArray.asArray();
+    const newRefs = refs.filter((ref) => {
+      const maybeDict = doc.context.lookup(ref);
+      return maybeDict !== widget.dict;
+    });
+
+    // Replace /Annots with updated array
+    if (newRefs.length === refs.length) continue;
+    page.node.set(PDFName.of("Annots"), doc.context.obj(newRefs));
+  }
+}
+
+/***
+ * Evaluates the change string with the match array
+ *
+ * @description The change string can include the following variables:
+ *
+ * - $<int> - capture groups, indexed from 1
+ * - $<int>i - capture groups, indexed from 1, transforming an integer to an index
+ * - $<int>s - capture groups, indexed from 1, transforming a string to snake case
+ * - $<int>c - capture groups, indexed from 1, transforming a string to camel case
+ * - $<int>l - capture groups, indexed from 1, transforming a string to lower case
+ * - $<int>u - capture groups, indexed from 1, transforming a string to upper case
+ * - $<int>t - capture groups, indexed from 1, transforming a string to title case
+ */
+function evaluateChange(change: string, match: RegExpExecArray, index: number) {
   return change.replace(
-    /\$(\d+)(i?)/g,
+    /\$(\d+)([icslut]?)/g,
-    (_, i, indexed) =>
+    (_, i, indexed) => {
-      indexed
+      switch (indexed) {
-        ? (parseInt(match[i]) ? (parseInt(match[i]) - 1).toString() : match[i])
+        case "i":
-        : match[i],
+          return (parseInt(match[i])
+            ? (parseInt(match[i]) - 1).toString()
+            : match[i]);
+        case "s":
+          return toCase(match[i], "snake");
+        case "c":
+          return toCase(match[i], "camel");
+        case "t":
+          return toCase(match[i], "title");
+        case "l":
+          return match[i].toLowerCase();
+        case "u":
+          return match[i].toUpperCase();
+        default:
+          return match[i];
+      }
+    },
+  )
+    .replace(
+      /\$I{((\w+,?)+)}/,
+      (_, offset) => {
+        const options = offset.split(",");
+        return options[index % options.length];
+      },
+    )
+    .replace(
+      /\$I(-?\d+)?/,
+      (_, offset) =>
+        (parseInt(offset) ? index + parseInt(offset) : index).toString(),
     );
 }
 
@@ -103,37 +777,114 @@ class RenameFields implements ITool {
     [pdfPath, pattern, change] = await forceArgs(
       [pdfPath, pattern, change],
       [
-        ["Please provide path to PDF:", (p) => !!p && p.endsWith(".pdf")],
+        [
+          "Please provide path to PDF (comma separated for multiple):",
+          (p) => !!p && p.endsWith(".pdf"),
+        ],
         "Please provide search string:",
         "Please provide requested change:",
       ],
       this.block,
     );
 
+    const paths = pdfPath.split(",");
+
+    for (const pdfPath of paths) {
       const patternRegex = new RegExp(pattern);
 
       const pdf = await loadPdf(pdfPath);
       const form = pdf.getForm();
-    const fields = form.getFields();
+      const fields = form.getFields().sort((a, b) => {
+        const aWidgets = a.acroField.getWidgets();
+        const bWidgets = b.acroField.getWidgets();
+        const aWidget = aWidgets[0];
+        const bWidget = bWidgets[0];
+
+        const aPage = a.doc.findPageForAnnotationRef(a.acroField.ref);
+        const bPage = b.doc.findPageForAnnotationRef(b.acroField.ref);
+
+        if (aPage && bPage && aPage !== bPage) {
+          const pages = a.doc.getPages();
+          const aPageIndex = pages.indexOf(aPage);
+          const bPageIndex = pages.indexOf(bPage);
+
+          if (aPageIndex !== bPageIndex) return aPageIndex - bPageIndex;
+        }
+
+        const aRect = aWidget.Rect()?.asRectangle();
+        const bRect = bWidget.Rect()?.asRectangle();
+
+        if (aRect && bRect) {
+          const dy = bRect.y - aRect.y;
+          if (Math.abs(dy) > 5) return dy;
+
+          return aRect.x - bRect.x;
+        }
+
+        return a.getName().localeCompare(b.getName());
+      });
+      let badFields = 0;
+
+      for (const field of fields) {
+        if (field.acroField.getWidgets().length > 1) {
+          badFields++;
+        }
+      }
+
+      badFields && await cliLog(
+        colorize(
+          `Warning, ${badFields} fields with shared widgets found`,
+          "yellow",
+        ),
+        this.block,
+      );
 
       const foundUpdates: [string, callback][] = [];
+      let changesMade = false;
 
+      let i = 0;
       for (const field of fields) {
         const name = field.getName();
         const match = patternRegex.exec(name);
         if (match) {
-        const toChange = evaluateChange(change, match);
+          foundUpdates.push(
-        foundUpdates.push([
+            ...field.acroField.getWidgets()?.map<[string, callback]>((
-          `${colorize(name, "red")} -> ${colorize(toChange, "green")}`,
+              widget,
+            ) => {
+              const toChange = evaluateChange(change, match, i);
+              const preview = name.replace(
+                new RegExp(patternRegex),
+                toChange,
+              );
+              i++;
+              return [
+                `${colorize(name, "red")} -> ${colorize(preview, "green")}`,
                 () => {
-            applyRename(field, name, patternRegex, toChange);
+                  field.acroField.getWidgets().length > 1
+                    ? applyWidgetRename(
+                      pdf,
+                      field,
+                      widget,
+                      name,
+                      new RegExp(patternRegex),
+                      toChange,
+                    )
+                    : moveWidgetToFlatField(
+                      pdf,
+                      field,
+                      field.acroField.getWidgets()[0],
+                      preview,
+                    );
+                  changesMade = true;
                 },
-        ]);
+              ];
+            }),
+          );
         }
       }
 
       if (foundUpdates.length) {
-      cliLog("Found updates:", this.block);
+        await cliLog("Found updates:", this.block);
         await multiSelectMenuInteractive(
           "Please select an option to apply",
           foundUpdates,
@@ -141,23 +892,32 @@ class RenameFields implements ITool {
         );
       }
 
+      if (changesMade) {
         const path = await cliPrompt(
           "Save to path (or hit enter to keep current):",
           this.block,
         );
+        try {
           await savePdf(pdf, path || pdfPath);
+        } catch {
+          log(e);
+        }
+      } else {
+        cliLog("No changes made, skipping", this.block);
+      }
+    }
   }
 }
 export default new RenameFields();
 
-if (import.meta.main) {
+// if (import.meta.main) {
-  // await call(renameFields)
+//   // await call(renameFields)
-  // while (!path || !path.endsWith('.pdf')) path = prompt("Please provide path to PDF:") || '';
+//   // while (!path || !path.endsWith('.pdf')) path = prompt("Please provide path to PDF:") || '';
-  // while (!pattern) pattern = prompt("Please provide search string:") || '';
+//   // while (!pattern) pattern = prompt("Please provide search string:") || '';
-  // while (!change) change = prompt("Please provide requested change:") || '';
+//   // while (!change) change = prompt("Please provide requested change:") || '';
-  await callWithArgPrompt(renameFields, [
+//   await callWithArgPrompt(renameFields, [
-    ["Please provide path to PDF:", (p) => !!p && p.endsWith(".pdf")],
+//     ["Please provide path to PDF:", (p) => !!p && p.endsWith(".pdf")],
-    "Please provide search string:",
+//     "Please provide search string:",
-    "Please provide requested change:",
+//     "Please provide requested change:",
-  ]);
+//   ]);
-}
+// }

tools/listFormFields.ts

@@ -20,31 +20,10 @@ export class ListFormFields implements ITool {
 
     const form = await loadPdfForm(pdfPath);
     const fields = form.getFields();
-    const height = this.block.getRenderHeight() - 1;
+    const fieldNames = fields.map((f) => f.getName());
-    const fieldNames = fields.sort((a, b) => {
-      const aRect = a.acroField.getWidgets().find((e) => e.Rect())?.Rect()
-        ?.asRectangle();
-      const bRect = b.acroField.getWidgets().find((e) => e.Rect())?.Rect()
-        ?.asRectangle();
-
-      if (aRect && bRect) {
-        if (aRect.x !== bRect.x) {
-          return aRect.x - bRect.x; // Sort left to right
-        } else {
-          return bRect.y - aRect.y; // If x is equal, sort top to bottom
-        }
-      }
-      return a.getName().localeCompare(b.getName());
-    }).map((f) => f.getName());
-    const maxLength = Math.max(...fieldNames.map((f) => f.length)) + 4;
     const lines = [];
-    for (let i = 0; i < height; i++) {
+    for (const fieldName of fieldNames) {
-      let line = "";
+      lines.push(fieldName);
-      for (let j = 0; j < fieldNames.length; j += height) {
-        const fieldName = fieldNames[i + j] ?? "";
-        line += fieldName.padEnd(maxLength, " ");
-      }
-      lines.push(line);
     }
     this.block.setLines(lines, [0, 1]);
     await cliAlert("", this.block);

util/asciiArt.ts

@@ -1,12 +1,18 @@
+import { join } from "@std/path";
+
 export async function getAsciiArt(art: string) {
-  const artFilePath = Deno.env.get("BEARMETAL_ASCII_PATH") ||
+  try {
-    getBearmetalAsciiPath();
+    const artFilePath =
-  if (!artFilePath) return art;
+      Deno.env.get("BEARMETAL_ASCII_PATH") || import.meta.dirname
+        ? join(import.meta.dirname || "", "../asciiart.txt")
+        : "https://git.cyborggrizzly.com/BearMetal/pdf-tools/raw/branch/main/asciiart.txt";
     let artFileText: string;
-  if (artFilePath.startsWith("http")) {
+    if (artFilePath?.startsWith("http")) {
       artFileText = await fetch(artFilePath).then((res) => res.text());
     } else {
-    artFileText = await Deno.readTextFile(artFilePath);
+      artFileText = await Deno.readTextFile(
+        artFilePath,
+      );
     }
     const parserRX = /begin\s+(\w+)\s*\n([\s\S]*?)\s*end\s*/g;
     let result = parserRX.exec(artFileText);
@@ -16,15 +22,9 @@ export async function getAsciiArt(art: string) {
       if (name === art) return artText;
       result = parserRX.exec(artFileText);
     }
+  } catch (e) {
+    console.log(e);
+    alert();
+  }
   return art;
 }
-
-function getBearmetalAsciiPath() {
-  const filenameRX = /asciiarts?\.txt$/;
-  for (const filename of Deno.readDirSync(".")) {
-    if (filename.isFile && filenameRX.test(filename.name)) {
-      return filename.name;
-    }
-  }
-  return null;
-}

util/caseManagement.ts

@@ -11,9 +11,45 @@ function lowerToTrainCase(str: string) {
   );
 }
 
-function lowerToCamelCase(str: string) {
+/**
-  return str.trim().replace(/(?:\s)\w/g, (match) => match.toUpperCase())
+ * @param str
-    .replaceAll(" ", "");
+ * @returns camelCased string (single letter words are lower cased, e.g. SSN -> ssn)
+ */
+function lowerToCamelCase(str: string): string {
+  const words = str.trim().split(/\s+/);
+  const result: string[] = [];
+  let i = 0;
+
+  while (i < words.length) {
+    if (words[i].length === 1) {
+      // We’ve hit the start of a chain of single-letter words
+      let j = i;
+      while (j < words.length && words[j].length === 1) {
+        j++;
+      }
+      const chainIsAtStart = i === 0;
+      // Process that entire chain
+      for (let k = i; k < j; k++) {
+        result[k] = chainIsAtStart
+          ? words[k].toLowerCase()
+          : words[k].toUpperCase();
+      }
+      i = j;
+    } else {
+      // Normal multi-letter word
+      if (i === 0) {
+        // first word: all lower
+        result[i] = words[i].toLowerCase();
+      } else {
+        // subsequent words: capitalize first letter
+        result[i] = words[i][0].toUpperCase() +
+          words[i].slice(1).toLowerCase();
+      }
+      i++;
+    }
+  }
+
+  return result.join("");
 }
 
 function lowerToSnakeCase(str: string) {
@@ -88,10 +124,10 @@ function coerceCaseToLower(str: string, caseType: CaseType) {
     case "macro":
     case "snake":
     case "upper":
-      return str.replace("_", " ").toLowerCase();
+      return str.replaceAll("_", " ").toLowerCase();
     case "train":
     case "kebab":
-      return str.replace("-", " ").toLowerCase();
+      return str.replaceAll("-", " ").toLowerCase();
     default:
       return str.toLowerCase();
   }
@@ -124,3 +160,7 @@ export function toCase(str: string, toCase: CaseType) {
       return str;
   }
 }
+
+if (import.meta.main) {
+  console.log(toCase("SSN", "camel"));
+}

util/logfile.ts

@@ -7,9 +7,9 @@ const logFile = Deno.openSync("./log.txt", {
 
 logFile.truncateSync(0);
 
-export function log(message: any) {
+export function log(...message: any) {
   if (typeof message === "object") {
-    message = JSON.stringify(message);
+    message = Deno.inspect(message);
   }
   logFile.writeSync(new TextEncoder().encode(message + "\n"));
 }

util/saveLoadPdf.ts

@@ -15,10 +15,10 @@ export async function loadPdf(path: string) {
 export async function savePdf(doc: PDFDocument, path: string) {
   doc.getForm().getFields().forEach((field) => {
     if (field instanceof PDFTextField) {
-      field.disableRichFormatting();
+      field.disableRichFormatting?.();
     }
   });
-  const pdfBytes = await doc.save();
+  const pdfBytes = await doc.save({ updateFieldAppearances: true });
   if (Deno.env.get("DRYRUN") || path.includes("dryrun")) return;
   await Deno.writeFile(path, pdfBytes);
 }