regoof 0.1.0

package/dist/global-options.js

@@ -0,0 +1,66 @@
+/**
+ * Extracts options that apply to every Regoof command before Stricli routes the
+ * remaining inputs. Add future CLI-wide options here instead of duplicating
+ * them in every command definition.
+ */
+export function extractGlobalOptions(inputs) {
+    const commandInputs = [];
+    let cacheMode = "default";
+    let projectPath;
+    let argumentsEscaped = false;
+    for (let index = 0; index < inputs.length; index += 1) {
+        const input = inputs[index];
+        if (input === undefined) {
+            continue;
+        }
+        if (argumentsEscaped) {
+            commandInputs.push(input);
+            continue;
+        }
+        if (input === "--") {
+            argumentsEscaped = true;
+            commandInputs.push(input);
+            continue;
+        }
+        if (input === "--project" || input === "-p") {
+            const value = inputs[index + 1];
+            if (value === undefined) {
+                throw new Error(`${input} requires a tsconfig path or project directory.`);
+            }
+            if (projectPath !== undefined) {
+                throw new Error("--project may only be provided once.");
+            }
+            projectPath = value;
+            index += 1;
+            continue;
+        }
+        if (input.startsWith("--project=")) {
+            const value = input.slice("--project=".length);
+            if (value.length === 0) {
+                throw new Error("--project requires a tsconfig path or project directory.");
+            }
+            if (projectPath !== undefined) {
+                throw new Error("--project may only be provided once.");
+            }
+            projectPath = value;
+            continue;
+        }
+        if (input === "--no-cache") {
+            if (cacheMode === "clear") {
+                throw new Error("--no-cache cannot be combined with --clear-cache.");
+            }
+            cacheMode = "bypass";
+            continue;
+        }
+        if (input === "--clear-cache") {
+            if (cacheMode === "bypass") {
+                throw new Error("--clear-cache cannot be combined with --no-cache.");
+            }
+            cacheMode = "clear";
+            continue;
+        }
+        commandInputs.push(input);
+    }
+    return { cacheMode, commandInputs, projectPath };
+}
+//# sourceMappingURL=global-options.js.map

package/dist/global-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-options.js","sourceRoot":"","sources":["../src/global-options.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAyB;IAEzB,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,IAAI,SAAS,GAA+B,SAAS,CAAC;IACtD,IAAI,WAA+B,CAAC;IACpC,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAE7B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QAED,IAAI,gBAAgB,EAAE,CAAC;YACrB,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,gBAAgB,GAAG,IAAI,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,iDAAiD,CAAC,CAAC;YAC7E,CAAC;YACD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YAC1D,CAAC;YACD,WAAW,GAAG,KAAK,CAAC;YACpB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC/C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;YAC9E,CAAC;YACD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YAC1D,CAAC;YACD,WAAW,GAAG,KAAK,CAAC;YACpB,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;YAC3B,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;YACvE,CAAC;YACD,SAAS,GAAG,QAAQ,CAAC;YACrB,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,eAAe,EAAE,CAAC;YAC9B,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;YACvE,CAAC;YACD,SAAS,GAAG,OAAO,CAAC;YACpB,SAAS;QACX,CAAC;QAED,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;AACnD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env bun
+import { type CommandContext } from "@stricli/core";
+import { type CacheMode } from "./find.js";
+export type RegoofContext = CommandContext & Readonly<{
+    cacheMode: CacheMode;
+    projectPath?: string;
+}>;
+export declare const app: import("@stricli/core").Application<RegoofContext>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,SAAS,EAEf,MAAM,WAAW,CAAC;AAInB,MAAM,MAAM,aAAa,GAAG,cAAc,GACxC,QAAQ,CAAC;IACP,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC;AAmKL,eAAO,MAAM,GAAG,oDAsBf,CAAC"}

package/dist/index.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env bun
+import { buildApplication, buildCommand, buildRouteMap, help, } from "@stricli/core";
+import { findDeclarations, } from "./find.js";
+import { peekSymbol } from "./peek.js";
+import { isPointerAmbiguity, renameSymbol } from "./rename.js";
+const findCommand = buildCommand({
+    docs: {
+        brief: "Find named TypeScript declarations in a project.",
+    },
+    parameters: {
+        flags: {
+            exact: {
+                kind: "boolean",
+                brief: "Match the declaration name exactly and case-sensitively.",
+            },
+            includePointers: {
+                kind: "boolean",
+                brief: "Include canonical stateless pointers in the results.",
+            },
+            json: {
+                kind: "boolean",
+                brief: "Print the matching declarations as JSON.",
+            },
+        },
+        positional: {
+            kind: "tuple",
+            parameters: [
+                {
+                    brief: "Case-insensitive declaration-name search term.",
+                    placeholder: "searchTerm",
+                    parse: (input) => input,
+                },
+                {
+                    brief: "Optional project-root-relative or absolute file path/glob.",
+                    placeholder: "filePath",
+                    optional: true,
+                    parse: (input) => input,
+                },
+            ],
+        },
+    },
+    func(flags, searchTerm, filePath) {
+        try {
+            const results = findDeclarations(searchTerm, {
+                cacheMode: this.cacheMode,
+                exact: flags.exact,
+                filePath,
+                includePointers: flags.includePointers,
+                projectPath: this.projectPath,
+            });
+            writeStructuredResult(this, results, flags.json);
+        }
+        catch (error) {
+            return error instanceof Error ? error : new Error(String(error));
+        }
+    },
+});
+const renameCommand = buildCommand({
+    docs: {
+        brief: "Rename a declaration selected by a stateless project pointer.",
+    },
+    parameters: {
+        flags: {
+            json: {
+                kind: "boolean",
+                brief: "Print the result or pointer candidates as JSON.",
+            },
+        },
+        positional: {
+            kind: "tuple",
+            parameters: [
+                {
+                    brief: "Project-relative symbol pointer.",
+                    placeholder: "pointer",
+                    parse: (input) => input,
+                },
+                {
+                    brief: "New TypeScript identifier name.",
+                    placeholder: "newName",
+                    parse: (input) => input,
+                },
+            ],
+        },
+    },
+    func(flags, pointer, newName) {
+        try {
+            const result = renameSymbol(pointer, newName, {
+                cacheMode: this.cacheMode,
+                projectPath: this.projectPath,
+            });
+            writeStructuredResult(this, isPointerAmbiguity(result) ? result.candidates : result, flags.json);
+        }
+        catch (error) {
+            return error instanceof Error ? error : new Error(String(error));
+        }
+    },
+});
+const peekCommand = buildCommand({
+    docs: {
+        brief: "Print syntax-highlighted source surrounding a project pointer.",
+    },
+    parameters: {
+        flags: {
+            json: {
+                kind: "boolean",
+                brief: "Print the result or pointer candidates as JSON.",
+            },
+        },
+        positional: {
+            kind: "tuple",
+            parameters: [
+                {
+                    brief: "Project-relative symbol pointer.",
+                    placeholder: "pointer",
+                    parse: (input) => input,
+                },
+                {
+                    brief: "Number of surrounding lines to print (default: 5).",
+                    placeholder: "radius",
+                    optional: true,
+                    parse: (input) => {
+                        const radius = Number(input);
+                        if (!Number.isSafeInteger(radius) || radius < 0) {
+                            throw new Error("radius must be a non-negative integer.");
+                        }
+                        return radius;
+                    },
+                },
+            ],
+        },
+    },
+    async func(flags, pointer, radius) {
+        try {
+            const result = await peekSymbol(pointer, radius, {
+                cacheMode: this.cacheMode,
+                projectPath: this.projectPath,
+            });
+            if (isPointerAmbiguity(result) || flags.json) {
+                writeStructuredResult(this, isPointerAmbiguity(result) ? result.candidates : result, flags.json);
+            }
+            else {
+                this.process.stdout.write(`${result.output}\n`);
+            }
+        }
+        catch (error) {
+            return error instanceof Error ? error : new Error(String(error));
+        }
+    },
+});
+export const app = buildApplication(buildRouteMap({
+    routes: { find: findCommand, peek: peekCommand, rename: renameCommand },
+    docs: {
+        brief: "TypeScript project refactoring tools.",
+        fullDescription: "Use --project <directory-or-tsconfig> (or -p) to select a project. Use --no-cache to bypass the local find index or --clear-cache to rebuild it.",
+    },
+}), {
+    name: "regoof",
+}, {
+    help: help({
+        brief: "Print help information and exit.",
+        formatting: {
+            caseStyle: "original",
+            onlyRequiredInUsageLine: false,
+            useAliasInUsageLine: false,
+        },
+    }),
+});
+function writeStructuredResult(context, value, json) {
+    if (json) {
+        context.process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+        return;
+    }
+    console.table(Array.isArray(value) ? value : [value]);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,IAAI,GAEL,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,gBAAgB,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAkB/D,MAAM,WAAW,GAAG,YAAY,CAA8C;IAC5E,IAAI,EAAE;QACJ,KAAK,EAAE,kDAAkD;KAC1D;IACD,UAAU,EAAE;QACV,KAAK,EAAE;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,0DAA0D;aAClE;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,sDAAsD;aAC9D;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,0CAA0C;aAClD;SACF;QACD,UAAU,EAAE;YACV,IAAI,EAAE,OAAO;YACb,UAAU,EAAE;gBACV;oBACE,KAAK,EAAE,gDAAgD;oBACvD,WAAW,EAAE,YAAY;oBACzB,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;iBACxB;gBACD;oBACE,KAAK,EAAE,4DAA4D;oBACnE,WAAW,EAAE,UAAU;oBACvB,QAAQ,EAAE,IAAI;oBACd,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;iBACxB;aACF;SACF;KACF;IACD,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ;QAC9B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,EAAE;gBAC3C,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,QAAQ;gBACR,eAAe,EAAE,KAAK,CAAC,eAAe;gBACtC,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;YACH,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,YAAY,CAA6C;IAC7E,IAAI,EAAE;QACJ,KAAK,EAAE,+DAA+D;KACvE;IACD,UAAU,EAAE;QACV,KAAK,EAAE;YACL,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,iDAAiD;aACzD;SACF;QACD,UAAU,EAAE;YACV,IAAI,EAAE,OAAO;YACb,UAAU,EAAE;gBACV;oBACE,KAAK,EAAE,kCAAkC;oBACzC,WAAW,EAAE,SAAS;oBACtB,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;iBACxB;gBACD;oBACE,KAAK,EAAE,iCAAiC;oBACxC,WAAW,EAAE,SAAS;oBACtB,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;iBACxB;aACF;SACF;KACF;IACD,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO;QAC1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE;gBAC5C,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;YACH,qBAAqB,CACnB,IAAI,EACJ,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,EACvD,KAAK,CAAC,IAAI,CACX,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,YAAY,CAA8C;IAC5E,IAAI,EAAE;QACJ,KAAK,EAAE,gEAAgE;KACxE;IACD,UAAU,EAAE;QACV,KAAK,EAAE;YACL,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,iDAAiD;aACzD;SACF;QACD,UAAU,EAAE;YACV,IAAI,EAAE,OAAO;YACb,UAAU,EAAE;gBACV;oBACE,KAAK,EAAE,kCAAkC;oBACzC,WAAW,EAAE,SAAS;oBACtB,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;iBACxB;gBACD;oBACE,KAAK,EAAE,oDAAoD;oBAC3D,WAAW,EAAE,QAAQ;oBACrB,QAAQ,EAAE,IAAI;oBACd,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE;wBACf,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;wBAC7B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;4BAChD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;wBAC5D,CAAC;wBACD,OAAO,MAAM,CAAC;oBAChB,CAAC;iBACF;aACF;SACF;KACF;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE;gBAC/C,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;YACH,IAAI,kBAAkB,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC7C,qBAAqB,CACnB,IAAI,EACJ,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,EACvD,KAAK,CAAC,IAAI,CACX,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,GAAG,GAAG,gBAAgB,CACjC,aAAa,CAAC;IACZ,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE;IACvE,IAAI,EAAE;QACJ,KAAK,EAAE,uCAAuC;QAC9C,eAAe,EACb,kJAAkJ;KACrJ;CACF,CAAC,EACF;IACE,IAAI,EAAE,QAAQ;CACf,EACD;IACE,IAAI,EAAE,IAAI,CAAC;QACT,KAAK,EAAE,kCAAkC;QACzC,UAAU,EAAE;YACV,SAAS,EAAE,UAAU;YACrB,uBAAuB,EAAE,KAAK;YAC9B,mBAAmB,EAAE,KAAK;SAC3B;KACF,CAAC;CACH,CACF,CAAC;AAEF,SAAS,qBAAqB,CAC5B,OAAsB,EACtB,KAAuF,EACvF,IAAa;IAEb,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACpE,OAAO;IACT,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/peek.d.ts

@@ -0,0 +1,14 @@
+import type { DeclarationIndexOptions } from "./declaration-index.js";
+import { type PointerAmbiguity } from "./rename.js";
+export type PeekOptions = DeclarationIndexOptions;
+export type PeekResult = Readonly<{
+    endLine: number;
+    filePath: string;
+    line: number;
+    output: string;
+    pointer: string;
+    startLine: number;
+}>;
+/** Renders a syntax-highlighted source window around a stateless project pointer. */
+export declare function peekSymbol(pointer: string, radius?: number, options?: PeekOptions): Promise<PeekResult | PointerAmbiguity>;
+//# sourceMappingURL=peek.d.ts.map

package/dist/peek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peek.d.ts","sourceRoot":"","sources":["../src/peek.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,uBAAuB,EAAqB,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAMrB,MAAM,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAEH,qFAAqF;AACrF,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,SAAiB,EACvB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,GAAG,gBAAgB,CAAC,CAsCxC"}

package/dist/peek.js

@@ -0,0 +1,58 @@
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, relative } from "node:path";
+import { highlightANSI } from "@speed-highlight/core";
+import theme from "@speed-highlight/core/themes/default.js";
+import { isPointerAmbiguity, resolveSinglePointer, } from "./rename.js";
+const DEFAULT_RADIUS = 5;
+const TARGET_LINE_BACKGROUND = "\u001B[48;5;236m";
+const RESET = "\u001B[0m";
+/** Renders a syntax-highlighted source window around a stateless project pointer. */
+export async function peekSymbol(pointer, radius = DEFAULT_RADIUS, options = {}) {
+    if (!Number.isSafeInteger(radius) || radius < 0) {
+        throw new Error("radius must be a non-negative integer.");
+    }
+    const resolution = resolveSinglePointer(pointer, options);
+    if (isPointerAmbiguity(resolution)) {
+        return resolution;
+    }
+    const source = readCurrentSource(resolution.declaration);
+    const lines = source.split(/\r\n|\r|\n/);
+    const line = resolution.declaration.line;
+    const startLine = Math.max(1, line - radius);
+    const endLine = Math.min(lines.length, line + radius);
+    const snippet = lines.slice(startLine - 1, endLine).join("\n");
+    const highlightedLines = (await highlightANSI(snippet, "ts", theme)).split("\n");
+    const lineNumberWidth = String(endLine).length;
+    const filePath = relative(dirname(resolution.rootTsConfigPath), resolution.declaration.filePath);
+    const renderedLines = highlightedLines.map((highlightedLine, index) => {
+        const sourceLine = startLine + index;
+        const isTarget = sourceLine === line;
+        const marker = isTarget ? "\u001B[1;33m>\u001B[0m" : " ";
+        const gutter = `${marker} ${String(sourceLine).padStart(lineNumberWidth)} | `;
+        return `${gutter}${isTarget ? highlightTargetLine(highlightedLine) : highlightedLine}`;
+    });
+    return Object.freeze({
+        pointer: resolution.pointer,
+        filePath,
+        line,
+        startLine,
+        endLine,
+        output: `${filePath}:${line}\n${renderedLines.join("\n")}`,
+    });
+}
+function readCurrentSource(declaration) {
+    if (!existsSync(declaration.filePath)) {
+        throw new Error("The file recorded for this declaration no longer exists.");
+    }
+    const source = readFileSync(declaration.filePath, "utf8");
+    const contentHash = createHash("sha256").update(source).digest("hex");
+    if (contentHash !== declaration.contentHash) {
+        throw new Error("The declaration file changed while resolving its pointer. Try again.");
+    }
+    return source;
+}
+function highlightTargetLine(highlightedLine) {
+    return `${TARGET_LINE_BACKGROUND}${highlightedLine.replaceAll(RESET, `${RESET}${TARGET_LINE_BACKGROUND}`)}${RESET}`;
+}
+//# sourceMappingURL=peek.js.map

package/dist/peek.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peek.js","sourceRoot":"","sources":["../src/peek.ts"],"names":[],"mappings":"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"}

package/dist/pointer.d.ts

@@ -0,0 +1,24 @@
+import { type DeclarationIndexOptions, type DeclarationRecord } from "./declaration-index.js";
+export type ParsedPointer = Readonly<{
+    filePattern?: string;
+    line?: number;
+    name: string;
+}>;
+export type PointerCandidate = Readonly<{
+    filePath: string;
+    line: number;
+    name: string;
+    pointer: string;
+}>;
+export type ResolvedPointer = PointerCandidate & Readonly<{
+    declaration: DeclarationRecord;
+    rootTsConfigPath: string;
+}>;
+/** Parses a self-contained pointer into its optional file and line selectors. */
+export declare function parsePointer(pointer: string): ParsedPointer;
+/** Resolves a pointer against the current project declaration index. */
+export declare function resolvePointer(pointer: string, options?: DeclarationIndexOptions): readonly ResolvedPointer[];
+/** Creates an unambiguous, project-root-relative pointer for a declaration. */
+export declare function createCanonicalPointer(filePath: string, declaration: Pick<DeclarationRecord, "line" | "name">): string;
+export declare function toPointerCandidate(candidate: ResolvedPointer): PointerCandidate;
+//# sourceMappingURL=pointer.d.ts.map

package/dist/pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../src/pointer.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAC5C,QAAQ,CAAC;IACP,WAAW,EAAE,iBAAiB,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC,CAAC;AAEL,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA6B3D;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAA4B,GACpC,SAAS,eAAe,EAAE,CA0B5B;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAAC,GACpD,MAAM,CAER;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,eAAe,GAAG,gBAAgB,CAG/E"}

package/dist/pointer.js

@@ -0,0 +1,72 @@
+import { relative } from "node:path";
+import { minimatch } from "minimatch";
+import { getDeclarationIndex, } from "./declaration-index.js";
+/** Parses a self-contained pointer into its optional file and line selectors. */
+export function parsePointer(pointer) {
+    if (pointer.length === 0 || pointer.includes("\0")) {
+        throw new Error("pointer must contain a symbol name and no null bytes.");
+    }
+    const nameSeparator = pointer.lastIndexOf(":");
+    if (nameSeparator === -1) {
+        return { name: pointer };
+    }
+    const name = pointer.slice(nameSeparator + 1);
+    const prefix = pointer.slice(0, nameSeparator);
+    if (name.length === 0 || prefix.length === 0) {
+        throw new Error("pointer must use SymbolName, globPattern:SymbolName, or globPattern:line:SymbolName.");
+    }
+    const lineSeparator = prefix.lastIndexOf(":");
+    if (lineSeparator === -1) {
+        return { filePattern: prefix, name };
+    }
+    const possibleLine = prefix.slice(lineSeparator + 1);
+    if (!/^\d+$/.test(possibleLine)) {
+        return { filePattern: prefix, name };
+    }
+    const line = Number(possibleLine);
+    const filePattern = prefix.slice(0, lineSeparator);
+    if (!Number.isSafeInteger(line) || line < 1 || filePattern.length === 0) {
+        throw new Error("pointer line numbers must be positive integers.");
+    }
+    return { filePattern, line, name };
+}
+/** Resolves a pointer against the current project declaration index. */
+export function resolvePointer(pointer, options = {}) {
+    const parsed = parsePointer(pointer);
+    const index = getDeclarationIndex(options);
+    return index.declarations
+        .flatMap((declaration) => {
+        const filePath = relative(index.rootDirectory, declaration.filePath);
+        if (declaration.name !== parsed.name ||
+            (parsed.line !== undefined && declaration.line !== parsed.line) ||
+            (parsed.filePattern !== undefined && !minimatch(filePath, parsed.filePattern))) {
+            return [];
+        }
+        return [
+            Object.freeze({
+                declaration,
+                rootTsConfigPath: index.rootTsConfigPath,
+                filePath,
+                line: declaration.line,
+                name: declaration.name,
+                pointer: createCanonicalPointer(filePath, declaration),
+            }),
+        ];
+    })
+        .sort(compareCandidates);
+}
+/** Creates an unambiguous, project-root-relative pointer for a declaration. */
+export function createCanonicalPointer(filePath, declaration) {
+    return `${filePath}:${declaration.line}:${declaration.name}`;
+}
+export function toPointerCandidate(candidate) {
+    const { declaration: _declaration, rootTsConfigPath: _rootTsConfigPath, ...result } = candidate;
+    return Object.freeze(result);
+}
+function compareCandidates(left, right) {
+    return (left.filePath.localeCompare(right.filePath) ||
+        left.declaration.start - right.declaration.start ||
+        left.name.localeCompare(right.name) ||
+        left.declaration.kind.localeCompare(right.declaration.kind));
+}
+//# sourceMappingURL=pointer.js.map

package/dist/pointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.js","sourceRoot":"","sources":["../src/pointer.ts"],"names":[],"mappings":"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"}

package/dist/rename.d.ts

@@ -0,0 +1,18 @@
+import { type DeclarationIndexOptions } from "./declaration-index.js";
+import { type PointerCandidate, type ResolvedPointer } from "./pointer.js";
+export type RenameOptions = DeclarationIndexOptions;
+export type RenameResult = Readonly<{
+    filesChanged: number;
+    newName: string;
+    oldName: string;
+    referencesRenamed: number;
+    pointer: string;
+}>;
+export type PointerAmbiguity = Readonly<{
+    candidates: readonly PointerCandidate[];
+}>;
+export declare function isPointerAmbiguity(result: unknown): result is PointerAmbiguity;
+/** Renames the declaration selected by a stateless project pointer. */
+export declare function renameSymbol(pointer: string, newName: string, options?: RenameOptions): RenameResult | PointerAmbiguity;
+export declare function resolveSinglePointer(pointer: string, options?: DeclarationIndexOptions): ResolvedPointer | PointerAmbiguity;
+//# sourceMappingURL=rename.d.ts.map

package/dist/rename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../src/rename.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,uBAAuB,EAE7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAEpD,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACzC,CAAC,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,gBAAgB,CAM9E;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,aAAkB,GAC1B,YAAY,GAAG,gBAAgB,CAoDjC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAA4B,GACpC,eAAe,GAAG,gBAAgB,CAWpC"}

package/dist/rename.js

@@ -0,0 +1,104 @@
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
+import { Project, Node, ts } from "ts-morph";
+import { clearDeclarationIndexCache, getProjectSourceFiles, } from "./declaration-index.js";
+import { resolvePointer, toPointerCandidate, } from "./pointer.js";
+export function isPointerAmbiguity(result) {
+    return (result !== null &&
+        typeof result === "object" &&
+        "candidates" in result);
+}
+/** Renames the declaration selected by a stateless project pointer. */
+export function renameSymbol(pointer, newName, options = {}) {
+    if (!isTypeScriptIdentifier(newName)) {
+        throw new Error(`'${newName}' is not a valid TypeScript identifier.`);
+    }
+    const resolution = resolveSinglePointer(pointer, options);
+    if (isPointerAmbiguity(resolution)) {
+        return resolution;
+    }
+    const { declaration } = resolution;
+    ensureDeclarationIsCurrent(declaration);
+    const project = new Project({
+        tsConfigFilePath: declaration.ownerTsConfigPath,
+        skipAddingFilesFromTsConfig: true,
+    });
+    for (const sourceFile of getProjectSourceFiles(resolution.rootTsConfigPath)) {
+        project.addSourceFileAtPath(sourceFile.filePath);
+    }
+    const target = findTarget(project, declaration);
+    if (target === undefined) {
+        throw new Error(`Pointer '${pointer}' no longer identifies the recorded declaration.`);
+    }
+    if (!Node.isRenameable(target)) {
+        throw new Error(`The declaration for pointer '${pointer}' cannot be renamed.`);
+    }
+    const referencesRenamed = project
+        .getLanguageService()
+        .findReferencesAsNodes(target).length;
+    target.rename(newName, {
+        renameInComments: false,
+        renameInStrings: false,
+        usePrefixAndSuffixText: true,
+    });
+    const filesChanged = project.getSourceFiles().filter((sourceFile) => !sourceFile.isSaved());
+    project.saveSync();
+    clearDeclarationIndexCache({
+        cacheDirectory: options.cacheDirectory,
+        cwd: options.cwd,
+        projectPath: resolution.rootTsConfigPath,
+    });
+    return Object.freeze({
+        pointer: resolution.pointer,
+        oldName: declaration.name,
+        newName,
+        filesChanged: filesChanged.length,
+        referencesRenamed,
+    });
+}
+export function resolveSinglePointer(pointer, options = {}) {
+    const candidates = resolvePointer(pointer, options);
+    if (candidates.length === 0) {
+        throw new Error(`No declaration matches pointer '${pointer}'.`);
+    }
+    if (candidates.length > 1) {
+        return Object.freeze({
+            candidates: Object.freeze(candidates.map(toPointerCandidate)),
+        });
+    }
+    return candidates[0];
+}
+function isTypeScriptIdentifier(value) {
+    const scanner = ts.createScanner(ts.ScriptTarget.Latest, false, ts.LanguageVariant.Standard, value);
+    return (scanner.scan() === ts.SyntaxKind.Identifier &&
+        scanner.getTokenText() === value &&
+        scanner.scan() === ts.SyntaxKind.EndOfFileToken);
+}
+function ensureDeclarationIsCurrent(declaration) {
+    if (!existsSync(declaration.filePath)) {
+        throw new Error("The file recorded for this declaration no longer exists.");
+    }
+    const contentHash = createHash("sha256")
+        .update(readFileSync(declaration.filePath))
+        .digest("hex");
+    if (contentHash !== declaration.contentHash) {
+        throw new Error("The declaration file changed while resolving its pointer. Try again.");
+    }
+}
+function findTarget(project, declaration) {
+    const sourceFile = project.getSourceFile(declaration.filePath);
+    if (sourceFile === undefined) {
+        return undefined;
+    }
+    return sourceFile
+        .getDescendants()
+        .find((node) => isRecordedDeclaration(node, declaration));
+}
+function isRecordedDeclaration(node, declaration) {
+    return (node.getKindName() === declaration.kind &&
+        node.getStart() === declaration.start &&
+        "getName" in node &&
+        typeof node.getName === "function" &&
+        node.getName() === declaration.name);
+}
+//# sourceMappingURL=rename.js.map

package/dist/rename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.js","sourceRoot":"","sources":["../src/rename.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "regoof",
+  "version": "0.1.0",
+  "description": "TypeScript project refactoring tools",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/isaacwasserman/regoof.git"
+  },
+  "homepage": "https://github.com/isaacwasserman/regoof#readme",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "bin": {
+    "regoof": "./dist/bin.js"
+  },
+  "files": ["dist", "README.md"],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "cli": "bun run src/bin.ts",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "changeset": "changeset",
+    "prepack": "bun run build"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^26.4.1",
+    "@changesets/cli": "^2.30.0",
+    "typescript": "^7.0.2"
+  },
+  "peerDependencies": {
+    "typescript": "^7"
+  },
+  "dependencies": {
+    "@stricli/core": "^1.3.0",
+    "@speed-highlight/core": "^2.1.0",
+    "env-paths": "^4.0.0",
+    "minimatch": "^10.2.6",
+    "ts-morph": "^28.0.0"
+  }
+}