@lsproxy/cli 0.3.0

package/dist/commands/move-symbol.js

@@ -0,0 +1,154 @@
+/**
+ * `lspeasy move-symbol <file> <line:col> <targetFile>`
+ *
+ * Moves the symbol at the given position into `targetFile`, updating all
+ * importers. Driven by `textDocument/codeAction` (kind `refactor.move`).
+ *
+ * Two server shapes are supported:
+ *  1. The code action (or its `codeAction/resolve`) returns a `WorkspaceEdit`
+ *     directly — applied as-is.
+ *  2. The action carries a `command`. We execute it via
+ *     `workspace/executeCommand`; many servers (notably
+ *     typescript-language-server's `_typescript.applyRefactoring`) then push
+ *     the edit back through a `workspace/applyEdit` request, which the session
+ *     captures. For TS, we inject the destination as
+ *     `interactiveRefactorArguments.targetFile` so the move targets an existing
+ *     file rather than prompting for a new one.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { pathToFileURL } from 'node:url';
+import { applyWorkspaceEdit, planWorkspaceEdit } from '../apply.js';
+import { emitResult, fail, parseLineCol, resolvePathArg, toLspPosition } from '../io.js';
+import { RefactorSession } from '../session.js';
+/**
+ * Normalize the `command` of a code action into an {@link LspCommand}, preserving
+ * arguments for BOTH shapes:
+ *  - nested object command → used as-is;
+ *  - raw `Command` (string `command`) → its top-level `arguments` are retained
+ *    (dropping them left command-only `_typescript.applyRefactoring` moves with
+ *    an empty arg list, so the refactor could not run).
+ */
+export function toLspCommand(action) {
+    if (!action.command)
+        return undefined;
+    if (typeof action.command === 'string') {
+        const cmd = { title: action.title, command: action.command };
+        if (action.arguments !== undefined)
+            cmd.arguments = action.arguments;
+        return cmd;
+    }
+    return action.command;
+}
+/**
+ * Resolve the ordered list of {@link WorkspaceEdit}s a `refactor.move` action
+ * produces, honoring the LSP `edit` + `command` contract:
+ *  - if the action has an inline `edit`, it is applied FIRST;
+ *  - if it also (or instead) has a `command`, the command is executed AFTER the
+ *    inline edit, and EVERY edit the server then pushes via `workspace/applyEdit`
+ *    (possibly several, in sequence) is appended in arrival order.
+ *
+ * Pure with respect to disk: it only sequences edits. `execute` runs the command
+ * (injecting the move target); `drainCapturedEdits` returns all server-pushed
+ * edits captured since the last drain.
+ */
+export async function resolveMoveEdits(action, targetFile, execute, drainCapturedEdits) {
+    const edits = [];
+    if (action.edit)
+        edits.push(action.edit);
+    const cmd = toLspCommand(action);
+    if (cmd) {
+        await execute(injectTargetFile(cmd, targetFile));
+        edits.push(...drainCapturedEdits());
+    }
+    return edits;
+}
+/** Inject the move destination into a tsserver `_typescript.applyRefactoring`
+ * command argument so the symbol lands in an existing target file. */
+function injectTargetFile(cmd, targetFile) {
+    if (cmd.command !== '_typescript.applyRefactoring' || !Array.isArray(cmd.arguments))
+        return cmd;
+    const arg0 = cmd.arguments[0];
+    if (arg0 && typeof arg0 === 'object') {
+        const obj = arg0;
+        return {
+            ...cmd,
+            arguments: [
+                {
+                    ...obj,
+                    refactor: 'Move to file',
+                    action: 'Move to file',
+                    interactiveRefactorArguments: { targetFile }
+                },
+                ...cmd.arguments.slice(1)
+            ]
+        };
+    }
+    return cmd;
+}
+export async function runMoveSymbol(args, flags) {
+    const file = resolvePathArg(args.file, flags);
+    const targetFile = resolvePathArg(args.targetFile, flags);
+    const oneBased = parseLineCol(args.position);
+    const pos = toLspPosition(oneBased);
+    if (!existsSync(file))
+        fail(`source file not found: ${file}`, flags.json);
+    const session = new RefactorSession({
+        serverCommand: flags.server,
+        root: flags.root,
+        indexWaitMs: flags.waitMs,
+        verbose: flags.verbose
+    });
+    try {
+        await session.start();
+        await session.openAndWait(file);
+        // Also open the target so the server knows its insertion context.
+        if (existsSync(targetFile)) {
+            await session.lsp.sendNotification('textDocument/didOpen', {
+                textDocument: {
+                    uri: pathToFileURL(targetFile).href,
+                    languageId: 'typescript',
+                    version: 1,
+                    text: readFileSync(targetFile, 'utf8')
+                }
+            });
+        }
+        const range = { start: pos, end: pos };
+        const actions = await session.requestWithRetry(() => session.lsp.sendRequest('textDocument/codeAction', {
+            textDocument: { uri: pathToFileURL(file).href },
+            range,
+            context: { diagnostics: [], only: ['refactor.move'] }
+        }));
+        if (!actions || actions.length === 0) {
+            fail('no refactor.move code action available at that position', flags.json);
+        }
+        // Prefer the move action; resolve it if it has no inline edit.
+        let action = actions.find((a) => a.kind?.startsWith('refactor.move')) ?? actions[0];
+        if (!action.edit && action.data !== undefined) {
+            const resolved = (await session.lsp.sendRequest('codeAction/resolve', action));
+            if (resolved)
+                action = resolved;
+        }
+        // Validate every server-returned edit against --root before applying.
+        const guard = { root: flags.root, allowOutsideRoot: flags.allowOutsideRoot };
+        const applyEdit = (e) => flags.dryRun ? planWorkspaceEdit(e, guard) : applyWorkspaceEdit(e, guard);
+        // Per the LSP spec, a CodeAction may carry BOTH an inline `edit` and a
+        // `command`: apply the edit FIRST, then execute the command (not either/or).
+        // The command may itself push further edits via workspace/applyEdit, possibly
+        // several in sequence — drain them ALL in order. (See resolveMoveEdits.)
+        const edits = await resolveMoveEdits(action, targetFile, async (cmd) => {
+            await session.lsp.sendRequest('workspace/executeCommand', {
+                command: cmd.command,
+                arguments: cmd.arguments ?? []
+            });
+        }, () => session.takeCapturedEdits());
+        if (edits.length === 0) {
+            fail('move-symbol produced no edit (server did not return or apply one)', flags.json);
+        }
+        const changes = edits.flatMap(applyEdit);
+        emitResult('move-symbol', changes, flags, { targetFile });
+    }
+    finally {
+        await session.stop();
+    }
+}
+//# sourceMappingURL=move-symbol.js.map

package/dist/commands/move-symbol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-symbol.js","sourceRoot":"","sources":["../../src/commands/move-symbol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAsB,MAAM,aAAa,CAAC;AACxF,OAAO,EACL,UAAU,EACV,IAAI,EACJ,YAAY,EACZ,cAAc,EACd,aAAa,EAGd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAyBhD;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,MAAkB;IAC7C,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACtC,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,GAAe,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QACzE,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;YAAE,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACrE,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAkB,EAClB,UAAkB,EAClB,OAA2C,EAC3C,kBAAyC;IAEzC,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,IAAI,MAAM,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,OAAO,CAAC,gBAAgB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;sEACsE;AACtE,SAAS,gBAAgB,CAAC,GAAe,EAAE,UAAkB;IAC3D,IAAI,GAAG,CAAC,OAAO,KAAK,8BAA8B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,GAAG,CAAC;IAChG,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAA+B,CAAC;QAC5C,OAAO;YACL,GAAG,GAAG;YACN,SAAS,EAAE;gBACT;oBACE,GAAG,GAAG;oBACN,QAAQ,EAAE,cAAc;oBACxB,MAAM,EAAE,cAAc;oBACtB,4BAA4B,EAAE,EAAE,UAAU,EAAE;iBAC7C;gBACD,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;aAC1B;SACF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAA4D,EAC5D,KAAkB;IAElB,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAqB,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,IAAI,CAAC,0BAA0B,IAAI,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAE1E,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC;QAClC,aAAa,EAAE,KAAK,CAAC,MAAM;QAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,kEAAkE;QAClE,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,MAAM,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,sBAAsB,EAAE;gBACzD,YAAY,EAAE;oBACZ,GAAG,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI;oBACnC,UAAU,EAAE,YAAY;oBACxB,OAAO,EAAE,CAAC;oBACV,IAAI,EAAE,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC;iBACvC;aACF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAC5C,GAAG,EAAE,CACH,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,yBAAyB,EAAE;YACjD,YAAY,EAAE,EAAE,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;YAC/C,KAAK;YACL,OAAO,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,eAAe,CAAC,EAAE;SACtD,CAAiC,CACrC,CAAC;QAEF,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,yDAAyD,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9E,CAAC;QAED,+DAA+D;QAC/D,IAAI,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAE,CAAC;QACrF,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAC7C,oBAAoB,EACpB,MAAe,CAChB,CAAsB,CAAC;YACxB,IAAI,QAAQ;gBAAE,MAAM,GAAG,QAAQ,CAAC;QAClC,CAAC;QAED,sEAAsE;QACtE,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAC7E,MAAM,SAAS,GAAG,CAAC,CAAgB,EAAE,EAAE,CACrC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAE5E,uEAAuE;QACvE,6EAA6E;QAC7E,8EAA8E;QAC9E,yEAAyE;QACzE,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAClC,MAAM,EACN,UAAU,EACV,KAAK,EAAE,GAAG,EAAE,EAAE;YACZ,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,0BAA0B,EAAE;gBACxD,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;aAC/B,CAAC,CAAC;QACL,CAAC,EACD,GAAG,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAClC,CAAC;QAEF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,mEAAmE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,UAAU,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5D,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/query.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `lspeasy query <op> <file> <line:col>`
+ *
+ * Read-only parity ops (definition / references / hover) exposed for terminals
+ * and CI that want the same position-driven interface as the write commands.
+ * Always emits JSON on stdout (these are data ops, not edits).
+ */
+import { type GlobalFlags } from '../io.js';
+export declare function runQuery(args: {
+    op: string;
+    file: string;
+    position: string;
+}, flags: GlobalFlags): Promise<void>;
+//# sourceMappingURL=query.d.ts.map

package/dist/commands/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAqD,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAK/F,wBAAsB,QAAQ,CAC5B,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EACpD,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAkCf"}

package/dist/commands/query.js

@@ -0,0 +1,46 @@
+/**
+ * `lspeasy query <op> <file> <line:col>`
+ *
+ * Read-only parity ops (definition / references / hover) exposed for terminals
+ * and CI that want the same position-driven interface as the write commands.
+ * Always emits JSON on stdout (these are data ops, not edits).
+ */
+import { pathToFileURL } from 'node:url';
+import { fail, parseLineCol, resolvePathArg, toLspPosition } from '../io.js';
+import { RefactorSession } from '../session.js';
+const OPS = new Set(['definition', 'references', 'hover']);
+export async function runQuery(args, flags) {
+    if (!OPS.has(args.op))
+        fail(`unknown query op "${args.op}" (definition | references | hover)`, true);
+    const file = resolvePathArg(args.file, flags);
+    const pos = toLspPosition(parseLineCol(args.position));
+    const session = new RefactorSession({
+        serverCommand: flags.server,
+        root: flags.root,
+        indexWaitMs: flags.waitMs,
+        verbose: flags.verbose
+    });
+    try {
+        await session.start();
+        await session.openAndWait(file);
+        const td = { textDocument: { uri: pathToFileURL(file).href }, position: pos };
+        let result;
+        if (args.op === 'definition') {
+            result = await session.lsp.sendRequest('textDocument/definition', td);
+        }
+        else if (args.op === 'references') {
+            result = await session.lsp.sendRequest('textDocument/references', {
+                ...td,
+                context: { includeDeclaration: true }
+            });
+        }
+        else {
+            result = await session.lsp.sendRequest('textDocument/hover', td);
+        }
+        process.stdout.write(JSON.stringify({ ok: true, op: args.op, result }) + '\n');
+    }
+    finally {
+        await session.stop();
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/commands/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAoB,MAAM,UAAU,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAoD,EACpD,KAAkB;IAElB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC,qBAAqB,IAAI,CAAC,EAAE,qCAAqC,EAAE,IAAI,CAAC,CAAC;IAChF,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEvD,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC;QAClC,aAAa,EAAE,KAAK,CAAC,MAAM;QAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAEhC,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAC9E,IAAI,MAAe,CAAC;QACpB,IAAI,IAAI,CAAC,EAAE,KAAK,YAAY,EAAE,CAAC;YAC7B,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;QACxE,CAAC;aAAM,IAAI,IAAI,CAAC,EAAE,KAAK,YAAY,EAAE,CAAC;YACpC,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,yBAAyB,EAAE;gBAChE,GAAG,EAAE;gBACL,OAAO,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE;aACtC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IACjF,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/rename.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `lspeasy rename <file> <line:col> <newName>`
+ *
+ * Drives `textDocument/rename` and applies the returned WorkspaceEdit. The LSP
+ * server finds every reference — including re-exports, aliased imports,
+ * type-only imports, and `{@link}` references — that a text search would miss.
+ */
+import { type GlobalFlags } from '../io.js';
+export declare function runRename(args: {
+    file: string;
+    position: string;
+    newName: string;
+}, flags: GlobalFlags): Promise<void>;
+//# sourceMappingURL=rename.d.ts.map

package/dist/commands/rename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../src/commands/rename.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,UAAU,CAAC;AAGlB,wBAAsB,SAAS,CAC7B,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EACzD,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAoCf"}

package/dist/commands/rename.js

@@ -0,0 +1,42 @@
+/**
+ * `lspeasy rename <file> <line:col> <newName>`
+ *
+ * Drives `textDocument/rename` and applies the returned WorkspaceEdit. The LSP
+ * server finds every reference — including re-exports, aliased imports,
+ * type-only imports, and `{@link}` references — that a text search would miss.
+ */
+import { pathToFileURL } from 'node:url';
+import { applyWorkspaceEdit, planWorkspaceEdit } from '../apply.js';
+import { emitResult, fail, parseLineCol, resolvePathArg, toLspPosition } from '../io.js';
+import { RefactorSession } from '../session.js';
+export async function runRename(args, flags) {
+    const file = resolvePathArg(args.file, flags);
+    const pos = toLspPosition(parseLineCol(args.position));
+    const session = new RefactorSession({
+        serverCommand: flags.server,
+        root: flags.root,
+        indexWaitMs: flags.waitMs,
+        verbose: flags.verbose
+    });
+    try {
+        await session.start();
+        await session.openAndWait(file);
+        const edit = await session.requestWithRetry(() => session.lsp.sendRequest('textDocument/rename', {
+            textDocument: { uri: pathToFileURL(file).href },
+            position: pos,
+            newName: args.newName
+        }));
+        if (!edit)
+            fail('rename returned no edit (symbol not renamable, or project not indexed)', flags.json);
+        // Validate the SERVER-RETURNED edit against --root: a server can return a
+        // URI/resource op outside the project; applying it unguarded would bypass
+        // the --root safety guarantee. The guard refuses unless --allow-outside-root.
+        const guard = { root: flags.root, allowOutsideRoot: flags.allowOutsideRoot };
+        const changes = flags.dryRun ? planWorkspaceEdit(edit, guard) : applyWorkspaceEdit(edit, guard);
+        emitResult('rename', changes, flags, { newName: args.newName });
+    }
+    finally {
+        await session.stop();
+    }
+}
+//# sourceMappingURL=rename.js.map

package/dist/commands/rename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.js","sourceRoot":"","sources":["../../src/commands/rename.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAsB,MAAM,aAAa,CAAC;AACxF,OAAO,EACL,UAAU,EACV,IAAI,EACJ,YAAY,EACZ,cAAc,EACd,aAAa,EAEd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAyD,EACzD,KAAkB;IAElB,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEvD,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC;QAClC,aAAa,EAAE,KAAK,CAAC,MAAM;QAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAEhC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,gBAAgB,CACzC,GAAG,EAAE,CACH,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,qBAAqB,EAAE;YAC7C,YAAY,EAAE,EAAE,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;YAC/C,QAAQ,EAAE,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAkC,CACtC,CAAC;QAEF,IAAI,CAAC,IAAI;YACP,IAAI,CAAC,wEAAwE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE7F,0EAA0E;QAC1E,0EAA0E;QAC1E,8EAA8E;QAC9E,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAC7E,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChG,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/connect.d.ts

@@ -0,0 +1,10 @@
+import { RefactorSession } from './session.js';
+export interface ConnectOptions {
+    root: string;
+    languageId: string;
+    serverCommand?: string;
+    indexWaitMs: number;
+    verbose: boolean;
+}
+export declare function connectViaProxy(opts: ConnectOptions): Promise<RefactorSession>;
+//# sourceMappingURL=connect.d.ts.map

package/dist/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAuB,MAAM,cAAc,CAAC;AAmCpE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CA0BpF"}

package/dist/connect.js

@@ -0,0 +1,63 @@
+// apps/cli/src/connect.ts
+import { spawn } from 'node:child_process';
+import { existsSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { createConnection } from 'node:net';
+import { SocketTransport } from '@lspeasy/core/node';
+import { socketPath } from '@lsproxy/proxy';
+import { RefactorSession } from './session.js';
+const PROXY_BIN = new URL('../../proxy/dist/main.js', import.meta.url).pathname;
+const POLL_INTERVAL_MS = 100;
+const POLL_TIMEOUT_MS = 5000;
+async function tryConnect(sockPath) {
+    return new Promise((resolve) => {
+        const socket = createConnection({ path: sockPath });
+        socket.once('connect', () => {
+            socket.destroy();
+            resolve(true);
+        });
+        socket.once('error', () => resolve(false));
+    });
+}
+async function pollForSocket(sockPath, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (existsSync(sockPath) && (await tryConnect(sockPath)))
+            return;
+        await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+    }
+    throw new Error(`Proxy daemon did not start within ${timeoutMs}ms (socket: ${sockPath})`);
+}
+function spawnDaemon(root, sockPath) {
+    mkdirSync(dirname(sockPath), { recursive: true });
+    const child = spawn(process.execPath, [PROXY_BIN, '--root', root, '--socket', sockPath], {
+        detached: true,
+        stdio: 'ignore'
+    });
+    child.unref();
+}
+export async function connectViaProxy(opts) {
+    const sockPath = socketPath(opts.root);
+    const alreadyUp = existsSync(sockPath) && (await tryConnect(sockPath));
+    if (!alreadyUp) {
+        if (opts.verbose)
+            process.stderr.write(`[lspeasy] spawning proxy daemon\n`);
+        spawnDaemon(opts.root, sockPath);
+        await pollForSocket(sockPath, POLL_TIMEOUT_MS);
+    }
+    if (opts.verbose)
+        process.stderr.write(`[lspeasy] connecting via proxy ${sockPath}\n`);
+    const transport = new SocketTransport({ path: sockPath });
+    await transport.waitForConnect();
+    const sessionOpts = {
+        root: opts.root,
+        languageId: opts.languageId,
+        indexWaitMs: opts.indexWaitMs,
+        verbose: opts.verbose,
+        transport
+    };
+    const session = new RefactorSession(sessionOpts);
+    await session.start();
+    return session;
+}
+//# sourceMappingURL=connect.js.map

package/dist/connect.js.map

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

package/dist/discover.d.ts

@@ -0,0 +1,17 @@
+export interface LspServerEntry {
+    command: string;
+    args?: string[];
+    fileExtensions: Record<string, string>;
+}
+export interface LspJson {
+    lspServers: Record<string, LspServerEntry>;
+}
+export interface ResolvedServer {
+    /** Full spawn command string passed to RefactorSession as serverCommand. */
+    serverCommand: string;
+    /** languageId for textDocument/didOpen (e.g. 'typescript', 'rust'). */
+    languageId: string;
+}
+export declare function selectServer(config: LspJson, fileExt: string): ResolvedServer | null;
+export declare function discoverServer(root: string, fileExt: string): ResolvedServer | null;
+//# sourceMappingURL=discover.d.ts.map

package/dist/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,OAAO;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;CACpB;AAaD,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAkBpF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAWnF"}

package/dist/discover.js

@@ -0,0 +1,46 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const SEARCH_PATHS = ['lsp.json', '.claude/lsp.json', '.github/lsp.json'];
+function findLspJsonPath(root) {
+    for (const rel of SEARCH_PATHS) {
+        const full = join(root, rel);
+        if (existsSync(full))
+            return full;
+    }
+    const global = join(homedir(), '.claude', 'lsp.json');
+    return existsSync(global) ? global : null;
+}
+export function selectServer(config, fileExt) {
+    for (const entry of Object.values(config.lspServers)) {
+        const languageId = entry.fileExtensions[fileExt];
+        if (languageId) {
+            const parts = [entry.command, ...(entry.args ?? [])].filter(Boolean);
+            // Quote tokens containing spaces so tokenizeCommand in session.ts can
+            // round-trip them without splitting on the embedded whitespace.
+            // Escape backslashes first, then double-quotes: tokenizeCommand treats \\
+            // inside double-quotes as a literal backslash, so a trailing backslash in a
+            // Windows path like "C:\Program Files\" must become "C:\Program Files\\"
+            // to avoid the closing " being consumed as \" (an escaped quote).
+            const quoted = parts.map((t) => t.includes(' ') ? `"${t.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"` : t);
+            return { serverCommand: quoted.join(' '), languageId };
+        }
+    }
+    return null;
+}
+export function discoverServer(root, fileExt) {
+    const lspJsonPath = findLspJsonPath(root);
+    if (!lspJsonPath)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(lspJsonPath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed['lspServers'] !== 'object')
+        return null;
+    return selectServer(parsed, fileExt);
+}
+//# sourceMappingURL=discover.js.map

package/dist/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAmBjC,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;AAE1E,SAAS,eAAe,CAAC,IAAY;IACnC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC7B,IAAI,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACpC,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IACtD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAe,EAAE,OAAe;IAC3D,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACrD,MAAM,UAAU,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACrE,sEAAsE;YACtE,gEAAgE;YAChE,0EAA0E;YAC1E,4EAA4E;YAC5E,yEAAyE;YACzE,kEAAkE;YAClE,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC7B,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAC3E,CAAC;YACF,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAe;IAC1D,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAQ,MAAkC,CAAC,YAAY,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAClG,OAAO,YAAY,CAAC,MAAiB,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `@lspeasy/cli` — programmatic entry point.
+ *
+ * Exposes the reusable refactor internals (session pipeline + WorkspaceEdit
+ * applier) so the same machinery can be embedded in scripts, not just invoked
+ * through the `lspeasy` bin.
+ *
+ * @packageDocumentation
+ */
+export { RefactorSession } from './session.js';
+export type { SessionOptions } from './session.js';
+export { applyWorkspaceEdit, applyTextEdits, planWorkspaceEdit } from './apply.js';
+export type { WorkspaceEdit, LspTextEdit, LspRange, LspPosition, AppliedChange } from './apply.js';
+export type { GlobalFlags } from './io.js';
+//# 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":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACnF,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACnG,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * `@lspeasy/cli` — programmatic entry point.
+ *
+ * Exposes the reusable refactor internals (session pipeline + WorkspaceEdit
+ * applier) so the same machinery can be embedded in scripts, not just invoked
+ * through the `lspeasy` bin.
+ *
+ * @packageDocumentation
+ */
+export { RefactorSession } from './session.js';
+export { applyWorkspaceEdit, applyTextEdits, planWorkspaceEdit } from './apply.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/io.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Shared CLI I/O helpers.
+ *
+ * Convention: **stdout is reserved for command output** (human summary or, with
+ * `--json`, a single JSON document). All progress/diagnostic chatter goes to
+ * **stderr** so piped `--json` consumers get clean input.
+ */
+import type { AppliedChange } from './apply.js';
+export interface GlobalFlags {
+    server: string;
+    root: string;
+    dryRun: boolean;
+    json: boolean;
+    verbose: boolean;
+    waitMs: number;
+    allowOutsideRoot: boolean;
+    /** Permit move-file to replace an existing destination (default: OFF). */
+    overwrite: boolean;
+    /** Bypass the proxy daemon and connect directly to the language server. */
+    noProxy: boolean;
+}
+/**
+ * Test whether an absolute path is contained within `root`, resolving symlinks
+ * in both the candidate and the root before comparing. A lexical-only check
+ * accepts `root/link/x` where `root/link -> /tmp/external`; canonicalizing the
+ * existing ancestors closes that escape.
+ */
+export declare function isInsideRoot(absPath: string, root: string): boolean;
+/**
+ * Resolve a file-path argument against the project `--root` and enforce that it
+ * stays inside that root.
+ *
+ * This is the single base both the server (spawn cwd / `rootUri`) and the file
+ * arguments share — they MUST agree. Relative args are resolved against `root`
+ * (NOT `process.cwd()`), so running the CLI from an unrelated directory (e.g. a
+ * different git worktree of the same project) cannot silently operate on the
+ * wrong checkout. Absolute args are used as-is.
+ *
+ * Unless `allowOutsideRoot` is set, any resolved path outside `root` is rejected
+ * (error + non-zero exit, no changes) — defense-in-depth against the wrong-repo
+ * incident relative-cwd resolution caused. Containment is symlink-aware (see
+ * {@link isInsideRoot}).
+ */
+export declare function resolvePathArg(arg: string, flags: Pick<GlobalFlags, 'root' | 'json' | 'allowOutsideRoot'>): string;
+/**
+ * Refuse a SERVER-RETURNED set of edit/resource targets that escape `--root`.
+ *
+ * The input-path guard ({@link resolvePathArg}) only validates CLI arguments;
+ * a language server can return a {@link WorkspaceEdit} whose URIs/resource ops
+ * point outside the project. Applying that unguarded would let a server
+ * modify, rename, or delete an external file — bypassing the `--root` safety
+ * guarantee. Every command routes server edits through this pre-flight check
+ * (via `apply.ts`), so all three inherit the boundary.
+ *
+ * Throws (rather than `fail()`/exit) so it composes inside the apply pipeline
+ * and is unit-testable; callers surface the message verbatim.
+ */
+export declare function assertTargetsInsideRoot(targets: readonly string[], flags: Pick<GlobalFlags, 'root' | 'allowOutsideRoot'>): void;
+/** Editor-style 1-based `line:col`. */
+export interface OneBasedPosition {
+    line: number;
+    character: number;
+}
+/** Parse `line:col` (1-based, editor style) into a 1-based position. */
+export declare function parseLineCol(input: string): OneBasedPosition;
+/** Convert a 1-based editor position to the 0-based position LSP expects. */
+export declare function toLspPosition(p: OneBasedPosition): {
+    line: number;
+    character: number;
+};
+export declare function fail(message: string, json: boolean): never;
+/** Render a list of applied/planned changes for human output. */
+export declare function summarizeChanges(changes: AppliedChange[], root: string, dryRun: boolean): string;
+/** Emit the result, either as JSON (stdout) or a human summary. */
+export declare function emitResult(op: string, changes: AppliedChange[], flags: Pick<GlobalFlags, 'json' | 'root' | 'dryRun'>, extra?: Record<string, unknown>): void;
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,SAAS,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAC;CAClB;AA8BD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAInE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,kBAAkB,CAAC,GAC7D,MAAM,CAOR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAAC,GACpD,IAAI,CAUN;AAED,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAO5D;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,CAAC,EAAE,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAEtF;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,KAAK,CAI1D;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAoBhG;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CACxB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,aAAa,EAAE,EACxB,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC,EACpD,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAClC,IAAI,CAQN"}