@lsproxy/cli 0.3.0

package/dist/io.js

@@ -0,0 +1,150 @@
+/**
+ * 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 { existsSync, realpathSync } from 'node:fs';
+import { dirname, isAbsolute, relative, resolve, sep } from 'node:path';
+/**
+ * Resolve a path's longest EXISTING ancestor through `realpath`, then rejoin the
+ * non-existing tail. This makes containment checks symlink-aware even for
+ * destinations that do not exist yet (e.g. a move target): if any existing
+ * ancestor is a symlink escaping `--root`, the canonical path reflects it, while
+ * a not-yet-created leaf cannot be `realpath`'d directly (it would throw).
+ *
+ * Walks up to a fixed-point so a chain like `root/link -> /tmp/ext` + `ext/sub`
+ * is fully canonicalized via the first existing ancestor.
+ */
+function canonicalize(absPath) {
+    let existing = absPath;
+    const tail = [];
+    while (!existsSync(existing)) {
+        const parent = dirname(existing);
+        if (parent === existing)
+            break; // reached filesystem root
+        tail.unshift(existing.slice(parent.length + 1));
+        existing = parent;
+    }
+    try {
+        const real = realpathSync(existing);
+        return tail.length ? resolve(real, ...tail) : real;
+    }
+    catch {
+        // realpath can still fail on permission errors; fall back to the lexical path.
+        return absPath;
+    }
+}
+/**
+ * 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 function isInsideRoot(absPath, root) {
+    const realRoot = canonicalize(resolve(root));
+    const realPath = canonicalize(absPath);
+    return realPath === realRoot || realPath.startsWith(realRoot + sep);
+}
+/**
+ * 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 function resolvePathArg(arg, flags) {
+    const root = resolve(flags.root);
+    const abs = isAbsolute(arg) ? resolve(arg) : resolve(root, arg);
+    if (!flags.allowOutsideRoot && !isInsideRoot(abs, root)) {
+        fail(`refusing: ${abs} is outside --root ${root}`, flags.json);
+    }
+    return abs;
+}
+/**
+ * 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 function assertTargetsInsideRoot(targets, flags) {
+    if (flags.allowOutsideRoot)
+        return;
+    const root = resolve(flags.root);
+    for (const abs of targets) {
+        if (!isInsideRoot(abs, root)) {
+            throw new Error(`refusing server edit: ${abs} is outside --root ${root} (pass --allow-outside-root to permit)`);
+        }
+    }
+}
+/** Parse `line:col` (1-based, editor style) into a 1-based position. */
+export function parseLineCol(input) {
+    const m = /^(\d+):(\d+)$/.exec(input.trim());
+    if (!m)
+        throw new Error(`Invalid position "${input}" — expected line:col (1-based), e.g. 12:7`);
+    const line = Number(m[1]);
+    const character = Number(m[2]);
+    if (line < 1 || character < 1)
+        throw new Error(`Position is 1-based; got "${input}"`);
+    return { line, character };
+}
+/** Convert a 1-based editor position to the 0-based position LSP expects. */
+export function toLspPosition(p) {
+    return { line: p.line - 1, character: p.character - 1 };
+}
+export function fail(message, json) {
+    if (json)
+        process.stdout.write(JSON.stringify({ ok: false, error: message }) + '\n');
+    else
+        process.stderr.write(`error: ${message}\n`);
+    process.exit(1);
+}
+/** Render a list of applied/planned changes for human output. */
+export function summarizeChanges(changes, root, dryRun) {
+    // Use path.relative so the root prefix is stripped with the platform
+    // separator (a hardcoded '/' left Windows paths un-shortened). Fall back to
+    // the absolute path for anything that resolves outside root.
+    const resolvedRoot = resolve(root);
+    const rel = (p) => relative(resolvedRoot, p) || p;
+    const lines = [];
+    const verb = dryRun ? 'would change' : 'changed';
+    const totalEdits = changes.reduce((n, c) => n + (c.editCount ?? 0), 0);
+    lines.push(`${dryRun ? '[dry-run] ' : ''}${changes.length} file(s) ${verb}, ${totalEdits} text edit(s)`);
+    for (const c of changes) {
+        if (c.kind === 'edit')
+            lines.push(`  edit   ${c.editCount}\t${rel(c.path)}`);
+        else if (c.kind === 'create')
+            lines.push(`  create  \t${rel(c.path)}`);
+        else if (c.kind === 'delete')
+            lines.push(`  delete  \t${rel(c.path)}`);
+        else if (c.kind === 'rename')
+            lines.push(`  rename  \t${rel(c.path)} -> ${rel(c.toPath ?? '')}`);
+    }
+    return lines.join('\n');
+}
+/** Emit the result, either as JSON (stdout) or a human summary. */
+export function emitResult(op, changes, flags, extra = {}) {
+    if (flags.json) {
+        process.stdout.write(JSON.stringify({ ok: true, op, dryRun: flags.dryRun, changes, ...extra }) + '\n');
+    }
+    else {
+        process.stdout.write(summarizeChanges(changes, flags.root, flags.dryRun) + '\n');
+    }
+}
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Thin session wrapper around `@lspeasy/client` for one-shot refactor commands.
+ *
+ * Encapsulates the proven recipe: spawn the language server, connect (which
+ * performs the `initialize` / `initialized` handshake with a generous set of
+ * client capabilities), open an anchor file, wait for the project to index,
+ * then run a request with a single null-result retry.
+ *
+ * All diagnostic logging goes to **stderr** so that `--json` output on stdout
+ * stays machine-parseable.
+ */
+import { LSPClient } from '@lspeasy/client';
+import { type ServerCapabilities, type Transport } from '@lspeasy/core';
+import type { WorkspaceEdit } from './apply.js';
+export interface SessionOptions {
+    /** Server launch command, e.g. `typescript-language-server --stdio`. Required unless `transport` is supplied. */
+    serverCommand?: string;
+    /** Absolute project root directory. */
+    root: string;
+    /** languageId for textDocument/didOpen (e.g. 'typescript', 'rust'). */
+    languageId?: string;
+    /** Milliseconds to wait for the server to index before the first request. */
+    indexWaitMs?: number;
+    /** Emit `[lspeasy] …` progress lines to stderr. */
+    verbose?: boolean;
+    /**
+     * Pre-built transport to use instead of spawning a server process.
+     *
+     * When supplied, `serverCommand` is ignored and no child process is spawned.
+     * Used by the proxy path to reuse all downstream session logic unchanged.
+     */
+    transport?: Transport;
+}
+/**
+ * An ordered queue of edits the server pushed via `workspace/applyEdit`.
+ *
+ * A server implementing `executeCommand` may send MORE THAN ONE sequential
+ * applyEdit request for a single command. The old "single field" capture
+ * overwrote earlier edits while still acking each `applied: true`, silently
+ * dropping every edit but the last. This queue preserves them all in arrival
+ * order; {@link drain} returns and clears the batch.
+ */
+export declare class CapturedEdits {
+    private edits;
+    /** Record an edit the server pushed (handler must NOT drop it). */
+    push(edit: WorkspaceEdit): void;
+    /** Return all captured edits in order and reset the queue. */
+    drain(): WorkspaceEdit[];
+}
+export declare class RefactorSession {
+    private readonly opts;
+    private proc?;
+    private client?;
+    /**
+     * Edits pushed by the server via `workspace/applyEdit`, in arrival order. A
+     * server implementing `executeCommand` may send MORE THAN ONE sequential
+     * applyEdit; we queue them all (rather than overwriting) so none is dropped
+     * after the server was told `applied: true`.
+     */
+    private readonly capturedEdits;
+    constructor(opts: SessionOptions);
+    private log;
+    /** Spawn the server (or reuse a pre-built transport) and complete the LSP handshake. */
+    start(): Promise<void>;
+    /** Notify the server that an anchor file is open. */
+    open(anchorFile: string): Promise<void>;
+    /**
+     * Run a request immediately and retry with exponential backoff while the
+     * server returns null (i.e. it is still indexing). Gives up after
+     * `indexWaitMs` total elapsed time and returns null.
+     *
+     * Initial retry delay: 250 ms, doubling each round, capped at 5 s per
+     * attempt. The first attempt is always immediate so fast servers pay no
+     * extra latency at all.
+     */
+    requestWithRetry<R>(run: () => Promise<R | null | undefined>): Promise<R | null>;
+    /**
+     * Drain ALL edits pushed by the server via `workspace/applyEdit` since the
+     * last drain, in arrival order. Returns an empty array if none were pushed.
+     * Callers apply them in order so a multi-applyEdit command is fully honored.
+     */
+    takeCapturedEdits(): WorkspaceEdit[];
+    get lsp(): LSPClient;
+    get capabilities(): ServerCapabilities;
+    private requireClient;
+    /** Shut down the client and kill the server process. */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAKL,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACf,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,iHAAiH;IACjH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAwFD;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAuB;IACpC,mEAAmE;IACnE,IAAI,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAE9B;IACD,8DAA8D;IAC9D,KAAK,IAAI,aAAa,EAAE,CAIvB;CACF;AAgCD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAiC;IAC9C,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;IAErD,YAAY,IAAI,EAAE,cAAc,EAO/B;IAED,OAAO,CAAC,GAAG;IAIX,wFAAwF;IAClF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA8C3B;IAED,qDAAqD;IAC/C,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5C;IAED;;;;;;;;OAQG;IACG,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAarF;IAED;;;;OAIG;IACH,iBAAiB,IAAI,aAAa,EAAE,CAEnC;IAED,IAAI,GAAG,IAAI,SAAS,CAEnB;IAED,IAAI,YAAY,IAAI,kBAAkB,CAErC;IAED,OAAO,CAAC,aAAa;IAKrB,wDAAwD;IAClD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAO1B;CACF"}

package/dist/session.js

@@ -0,0 +1,286 @@
+/**
+ * Thin session wrapper around `@lspeasy/client` for one-shot refactor commands.
+ *
+ * Encapsulates the proven recipe: spawn the language server, connect (which
+ * performs the `initialize` / `initialized` handshake with a generous set of
+ * client capabilities), open an anchor file, wait for the project to index,
+ * then run a request with a single null-result retry.
+ *
+ * All diagnostic logging goes to **stderr** so that `--json` output on stdout
+ * stays machine-parseable.
+ */
+import { spawn } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { basename, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { LSPClient } from '@lspeasy/client';
+import { NullLogger, tokenizeCommand } from '@lspeasy/core';
+import { StdioTransport } from '@lspeasy/core/node';
+// Advertise the full set of capabilities the CLI can dispatch so servers do
+// not gate their ServerCapabilities on a narrow client declaration. Each entry
+// corresponds to a ClientCapability path used by getCapabilityForRequestMethod;
+// a missing entry silently suppresses the matching command from the command tree.
+const CLIENT_CAPABILITIES = {
+    textDocument: {
+        synchronization: { dynamicRegistration: false },
+        // Navigation
+        definition: { dynamicRegistration: false },
+        declaration: { dynamicRegistration: false },
+        typeDefinition: { dynamicRegistration: false },
+        implementation: { dynamicRegistration: false },
+        references: { dynamicRegistration: false },
+        documentHighlight: { dynamicRegistration: false },
+        documentSymbol: { dynamicRegistration: false },
+        // Hover / completion / signature
+        hover: { dynamicRegistration: false },
+        completion: { dynamicRegistration: false },
+        signatureHelp: { dynamicRegistration: false },
+        // Refactor / actions / rename
+        rename: { dynamicRegistration: false, prepareSupport: true },
+        codeAction: {
+            dynamicRegistration: false,
+            codeActionLiteralSupport: {
+                codeActionKind: {
+                    valueSet: [
+                        '',
+                        'quickfix',
+                        'refactor',
+                        'refactor.extract',
+                        'refactor.inline',
+                        'refactor.move',
+                        'refactor.rewrite',
+                        'source',
+                        'source.organizeImports',
+                        'source.fixAll'
+                    ]
+                }
+            },
+            resolveSupport: { properties: ['edit'] },
+            dataSupport: true
+        },
+        codeLens: { dynamicRegistration: false },
+        // Formatting
+        formatting: { dynamicRegistration: false },
+        rangeFormatting: { dynamicRegistration: false },
+        onTypeFormatting: { dynamicRegistration: false },
+        // Semantic tokens — needed for servers to advertise semanticTokensProvider
+        semanticTokens: {
+            dynamicRegistration: false,
+            requests: { full: { delta: true }, range: true },
+            tokenTypes: [],
+            tokenModifiers: [],
+            formats: ['relative'],
+            overlappingTokenSupport: false,
+            multilineTokenSupport: false
+        },
+        // Hierarchy / navigation
+        callHierarchy: { dynamicRegistration: false },
+        typeHierarchy: { dynamicRegistration: false },
+        selectionRange: { dynamicRegistration: false },
+        foldingRange: { dynamicRegistration: false },
+        linkedEditingRange: { dynamicRegistration: false },
+        // Lenses / hints
+        inlayHint: { dynamicRegistration: false, resolveSupport: { properties: [] } },
+        inlineValue: { dynamicRegistration: false },
+        // Diagnostics / misc
+        diagnostic: { dynamicRegistration: false },
+        colorProvider: { dynamicRegistration: false },
+        documentLink: { dynamicRegistration: false },
+        moniker: { dynamicRegistration: false }
+    },
+    workspace: {
+        applyEdit: true,
+        executeCommand: { dynamicRegistration: false },
+        symbol: { dynamicRegistration: false },
+        workspaceEdit: {
+            documentChanges: true,
+            resourceOperations: ['create', 'rename', 'delete']
+        },
+        fileOperations: { dynamicRegistration: false, willRename: true }
+    }
+};
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/**
+ * An ordered queue of edits the server pushed via `workspace/applyEdit`.
+ *
+ * A server implementing `executeCommand` may send MORE THAN ONE sequential
+ * applyEdit request for a single command. The old "single field" capture
+ * overwrote earlier edits while still acking each `applied: true`, silently
+ * dropping every edit but the last. This queue preserves them all in arrival
+ * order; {@link drain} returns and clears the batch.
+ */
+export class CapturedEdits {
+    edits = [];
+    /** Record an edit the server pushed (handler must NOT drop it). */
+    push(edit) {
+        this.edits.push(edit);
+    }
+    /** Return all captured edits in order and reset the queue. */
+    drain() {
+        const out = this.edits;
+        this.edits = [];
+        return out;
+    }
+}
+/**
+ * Logger that routes everything to **stderr**, keeping stdout clean for the
+ * CLI's own output (critical for `--json`).
+ */
+class StderrLogger {
+    error(message, ...args) {
+        this.write('error', message, args);
+    }
+    warn(message, ...args) {
+        this.write('warn', message, args);
+    }
+    info(message, ...args) {
+        this.write('info', message, args);
+    }
+    debug(message, ...args) {
+        this.write('debug', message, args);
+    }
+    trace(message, ...args) {
+        this.write('trace', message, args);
+    }
+    write(level, message, args) {
+        const extra = args.length ? ' ' + args.map((a) => JSON.stringify(a)).join(' ') : '';
+        process.stderr.write(`[lsp:${level}] ${message}${extra}\n`);
+    }
+}
+export class RefactorSession {
+    opts;
+    proc;
+    client;
+    /**
+     * Edits pushed by the server via `workspace/applyEdit`, in arrival order. A
+     * server implementing `executeCommand` may send MORE THAN ONE sequential
+     * applyEdit; we queue them all (rather than overwriting) so none is dropped
+     * after the server was told `applied: true`.
+     */
+    capturedEdits = new CapturedEdits();
+    constructor(opts) {
+        this.opts = {
+            indexWaitMs: 15000,
+            verbose: false,
+            languageId: 'plaintext',
+            ...opts
+        };
+    }
+    log(msg) {
+        if (this.opts.verbose)
+            process.stderr.write(`[lspeasy] ${msg}\n`);
+    }
+    /** Spawn the server (or reuse a pre-built transport) and complete the LSP handshake. */
+    async start() {
+        // Derive the workspace root URI + folders from --root so the server indexes
+        // the right project (rootUri:null is fragile for non-tsserver servers).
+        const rootDir = resolve(this.opts.root);
+        const rootUri = pathToFileURL(rootDir).href;
+        let transport;
+        if (this.opts.transport) {
+            transport = this.opts.transport;
+            this.log(`using pre-built transport (proxy)`);
+        }
+        else {
+            const [cmd, ...args] = tokenizeCommand(this.opts.serverCommand ?? '');
+            if (!cmd)
+                throw new Error('Empty --server command');
+            this.log(`spawning: ${this.opts.serverCommand} (cwd ${this.opts.root})`);
+            const proc = spawn(cmd, args, { cwd: this.opts.root });
+            this.proc = proc;
+            proc.on('error', (e) => {
+                process.stderr.write(`[lspeasy] server spawn error: ${e.message}\n`);
+            });
+            transport = new StdioTransport({ input: proc.stdout, output: proc.stdin });
+        }
+        const client = new LSPClient({
+            name: 'lspeasy-cli',
+            version: '0.1.0',
+            capabilities: CLIENT_CAPABILITIES,
+            rootUri,
+            workspaceFolders: [{ uri: rootUri, name: basename(rootDir) }],
+            initializationOptions: { languageId: this.opts.languageId },
+            // Keep stdout clean; route the SDK's own logging to stderr (or silence it).
+            logger: this.opts.verbose ? new StderrLogger() : new NullLogger()
+        });
+        this.client = client;
+        // Intercept server-pushed edits (tsserver's refactor.move applies this way).
+        // Queue every pushed edit in order — a server may send several sequential
+        // applyEdit requests for one command, and acking `applied:true` for an edit
+        // we then dropped would be a lie that loses changes.
+        client.onRequest('workspace/applyEdit', (params) => {
+            this.capturedEdits.push(params.edit);
+            return { applied: true };
+        });
+        await client.connect(transport);
+        this.log('connected (initialize/initialized handshake complete)');
+    }
+    /** Notify the server that an anchor file is open. */
+    async open(anchorFile) {
+        const client = this.requireClient();
+        await client.sendNotification('textDocument/didOpen', {
+            textDocument: {
+                uri: pathToFileURL(anchorFile).href,
+                languageId: this.opts.languageId,
+                version: 1,
+                text: readFileSync(anchorFile, 'utf8')
+            }
+        });
+        this.log(`didOpen ${anchorFile}`);
+    }
+    /**
+     * Run a request immediately and retry with exponential backoff while the
+     * server returns null (i.e. it is still indexing). Gives up after
+     * `indexWaitMs` total elapsed time and returns null.
+     *
+     * Initial retry delay: 250 ms, doubling each round, capped at 5 s per
+     * attempt. The first attempt is always immediate so fast servers pay no
+     * extra latency at all.
+     */
+    async requestWithRetry(run) {
+        const deadline = Date.now() + this.opts.indexWaitMs;
+        let delay = 250;
+        while (true) {
+            const res = await run();
+            if (res !== null && res !== undefined)
+                return res;
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                return null;
+            const wait = Math.min(delay, remaining);
+            this.log(`null result — retrying in ${wait}ms (${remaining}ms remaining)`);
+            await sleep(wait);
+            delay = Math.min(delay * 2, 5000);
+        }
+    }
+    /**
+     * Drain ALL edits pushed by the server via `workspace/applyEdit` since the
+     * last drain, in arrival order. Returns an empty array if none were pushed.
+     * Callers apply them in order so a multi-applyEdit command is fully honored.
+     */
+    takeCapturedEdits() {
+        return this.capturedEdits.drain();
+    }
+    get lsp() {
+        return this.requireClient();
+    }
+    get capabilities() {
+        return this.requireClient().getServerCapabilities() ?? {};
+    }
+    requireClient() {
+        if (!this.client)
+            throw new Error('Session not started — call start() first');
+        return this.client;
+    }
+    /** Shut down the client and kill the server process. */
+    async stop() {
+        try {
+            await this.client?.disconnect();
+        }
+        catch {
+            /* ignore shutdown races */
+        }
+        this.proc?.kill();
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/zod-to-commander.d.ts

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+import { z } from 'zod';
+import type { GlobalFlags } from './io.js';
+import type { RefactorSession } from './session.js';
+import { type AppliedChange } from './apply.js';
+export type ArgPattern = 'file-position-newname' | 'file-position' | 'file-range' | 'file' | 'query' | 'raw';
+export declare function detectArgPattern(schema: z.ZodType<unknown>): ArgPattern;
+export declare function marshalParams(pattern: ArgPattern, positional: string[], opts: Record<string, unknown>, flags: GlobalFlags): unknown;
+export declare function printAppliedChanges(changes: AppliedChange[], method: string, dryRun: boolean, json: boolean): void;
+export declare function zodToCommander(method: string, schema: z.ZodType<unknown>, session: RefactorSession, flags: GlobalFlags): Command;
+//# sourceMappingURL=zod-to-commander.d.ts.map

package/dist/zod-to-commander.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-commander.d.ts","sourceRoot":"","sources":["../src/zod-to-commander.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAIL,KAAK,aAAa,EAEnB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,UAAU,GAClB,uBAAuB,GACvB,eAAe,GACf,YAAY,GACZ,MAAM,GACN,OAAO,GACP,KAAK,CAAC;AAsHV,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,UAAU,CAUvE;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,WAAW,GACjB,OAAO,CAwCT;AA8BD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EAAE,EACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,OAAO,GACZ,IAAI,CAeN;AAoBD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAC1B,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,WAAW,GACjB,OAAO,CA4JT"}