@aloth/olcli 0.11.0 → 0.13.0

package/dist/latexdiff.d.ts

@@ -0,0 +1,165 @@
+/**
+ * `latexdiff` integration for `olcli diff`.
+ *
+ * `diff` already computes both sides of the comparison - the project as it is
+ * on Overleaf right now, and the working directory - and prints them as
+ * unified patches. That is the right artifact for a developer and the wrong
+ * one for a thesis advisor, who expects the revision marked up in the document
+ * itself. `latexdiff` produces that, and the only parts a user cannot do by
+ * hand are getting the remote side onto disk and compiling the result without
+ * a local TeX installation.
+ *
+ * Everything decidable from data is decided here as a pure function so it can
+ * be unit-tested with no Overleaf account and no `latexdiff` binary; the spawn
+ * and the upload/compile/delete sequence stay in `cli.ts` with the rest of the
+ * IO. Same split as `diff.ts`.
+ *
+ * Orientation matches `diff.ts` and is not negotiable: **old is the remote,
+ * new is local**. Struck-through text in the markup is content a subsequent
+ * push would overwrite, underlined text is content it would upload.
+ */
+/** Binary looked up on PATH. Not configurable; `latexdiff` is its only name. */
+export declare const LATEXDIFF_BIN = "latexdiff";
+/**
+ * Directory the marked-up files are written to, relative to the target
+ * directory.
+ *
+ * Dotted on purpose. `scanLocalFiles` skips dotted entries unconditionally,
+ * before any ignore rule is consulted, so this is the one location whose
+ * contents cannot leak into a later `push`. A plain `main-diff.tex` next to
+ * the document would be uploaded to Overleaf on the next sync.
+ */
+export declare const DIFF_OUTPUT_DIR = ".olcli-diff";
+/**
+ * Name of the file `--pdf` uploads to the project for the duration of one
+ * compile.
+ *
+ * Fixed rather than randomized: a name a user can recognize and delete by hand
+ * is worth more than one that never collides, and a collision is refused
+ * rather than resolved anyway.
+ */
+export declare const REMOTE_SCRATCH_NAME = "olcli-latexdiff.tex";
+/**
+ * True when the file declares a document class outside of a comment.
+ *
+ * This is what separates a root document from the chapters it inputs. A
+ * commented-out `\documentclass` is common in subfiles - people leave the
+ * standalone preamble behind when they split a document up - and counting it
+ * would report every chapter as a candidate root.
+ */
+export declare function declaresDocumentClass(content: Buffer): boolean;
+export declare function isTexPath(path: string): boolean;
+/**
+ * Every `.tex` file in the tree that declares a document class, sorted by path
+ * so the list a user is shown is stable across runs.
+ */
+export declare function findRootCandidates(files: Map<string, Buffer>): string[];
+/** Raised when the root document cannot be determined; carries the advice. */
+export declare class RootDocumentError extends Error {
+    readonly candidates: string[];
+    constructor(message: string, candidates?: string[]);
+}
+/**
+ * Decide which document to mark up.
+ *
+ * An explicit `--main` always wins, including for layouts this heuristic
+ * cannot read. Otherwise the document class is the signal, and ambiguity is
+ * reported rather than guessed at: a project holding both `paper.tex` and
+ * `poster.tex` has no correct default, and marking up the wrong one produces a
+ * plausible PDF describing the wrong revision - the failure that is hardest to
+ * notice.
+ *
+ * @param files  The local tree, already filtered the same way `diff` filters it.
+ */
+export declare function resolveRootDocument(files: Map<string, Buffer>, explicit?: string): string;
+export interface LatexdiffArgsOptions {
+    /**
+     * Inline `\input` and `\include` before comparing. On by default; see
+     * `buildLatexdiffArgs`.
+     */
+    flatten?: boolean;
+    /** Verbatim `latexdiff` options from `--latexdiff-opt`, passed through. */
+    extra?: string[];
+}
+/**
+ * Build the `latexdiff` argument list.
+ *
+ * `--flatten` is the default, and the reason is the remote compile rather than
+ * taste. Without it the marked-up file still contains `\input{sections/intro}`,
+ * and compiling it on Overleaf resolves those against the files sitting in the
+ * project - the old content - so a multi-file thesis would produce a PDF that
+ * marks up the root document and silently shows every input file as unchanged.
+ * `--no-flatten` is there for anyone who wants the raw single-file markup.
+ *
+ * Extra options come before the file arguments because `latexdiff` reads the
+ * last two positional arguments as old and new.
+ */
+export declare function buildLatexdiffArgs(oldPath: string, newPath: string, options?: LatexdiffArgsOptions): string[];
+/**
+ * Where a marked-up artifact is written, relative to the target directory.
+ *
+ * Flat rather than mirroring the root document's folder: the output of a
+ * flattened run is a single self-contained file, and burying it under
+ * `.olcli-diff/chapters/` would only make it harder to find.
+ */
+export declare function diffOutputPath(rootPath: string, extension: string): string;
+/**
+ * Project path `--pdf` uploads the marked-up file to.
+ *
+ * Placed next to the root document rather than at the project root, so that
+ * relative `\includegraphics` and `\bibliography` paths in the flattened file
+ * resolve exactly as they do for the document it was built from.
+ */
+export declare function remoteScratchPath(rootPath: string): string;
+/**
+ * Write a file tree to a directory, for use as `latexdiff`'s old side.
+ *
+ * `latexdiff --flatten` resolves `\input` relative to each side's own file, so
+ * the remote tree has to exist on disk with its folder structure intact -
+ * handing it just the root document would break every input in a multi-file
+ * project.
+ *
+ * Entry names are re-checked against the destination even though `diff` has
+ * already filtered them against the target directory: this writes files, and a
+ * path that was safe relative to one base is not automatically safe relative
+ * to another. See #44.
+ */
+export declare function materializeTree(destination: string, files: Map<string, Buffer>): number;
+export interface LatexdiffResult {
+    /** The marked-up document, as printed to stdout. */
+    markup: string;
+    /** Warnings `latexdiff` printed while succeeding. */
+    stderr: string;
+}
+/**
+ * Raised when `latexdiff` could not be run or exited non-zero. `missing`
+ * separates "not installed" - a setup problem with a known fix - from a real
+ * failure on the documents, which needs the tool's own message.
+ */
+export declare class LatexdiffError extends Error {
+    readonly missing: boolean;
+    readonly stderr: string;
+    constructor(message: string, missing: boolean, stderr?: string);
+}
+/**
+ * Run `latexdiff`, returning its stdout.
+ *
+ * `execFile`, never a shell: the arguments include user-supplied paths and
+ * pass-through options, and an argv array cannot be talked into running
+ * something else.
+ *
+ * The default `maxBuffer` is 1 MB, which a flattened thesis passes without
+ * trying. Exceeding it truncates stdout and reports it as an error, which
+ * would read as "latexdiff failed" on exactly the documents this feature
+ * exists for.
+ */
+export declare function runLatexdiff(args: string[]): Promise<LatexdiffResult>;
+/**
+ * Install advice for a missing binary, by platform.
+ *
+ * `latexdiff` ships with TeX Live and MacTeX, so on most machines the answer
+ * is that the whole distribution is missing rather than this one tool - which
+ * is also the case where `--pdf` is most useful, since it needs no local TeX.
+ */
+export declare function latexdiffInstallHint(platform?: string): string;
+//# sourceMappingURL=latexdiff.d.ts.map

package/dist/latexdiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latexdiff.d.ts","sourceRoot":"","sources":["../src/latexdiff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAUH,gFAAgF;AAChF,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAsBzD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAK9D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG/C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAKvE;AAED,8EAA8E;AAC9E,qBAAa,iBAAkB,SAAQ,KAAK;IACb,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE;gBAA9C,OAAO,EAAE,MAAM,EAAW,UAAU,GAAE,MAAM,EAAO;CAIhE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CA4BzF;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,oBAAyB,GACjC,MAAM,EAAE,CAMV;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG1E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAUvF;AAED,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACV,QAAQ,CAAC,OAAO,EAAE,OAAO;IAAE,QAAQ,CAAC,MAAM;gBAA3D,OAAO,EAAE,MAAM,EAAW,OAAO,EAAE,OAAO,EAAW,MAAM,SAAK;CAI7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAsB3E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,MAAyB,GAAG,MAAM,CAShF"}

package/dist/latexdiff.js

@@ -0,0 +1,269 @@
+/**
+ * `latexdiff` integration for `olcli diff`.
+ *
+ * `diff` already computes both sides of the comparison - the project as it is
+ * on Overleaf right now, and the working directory - and prints them as
+ * unified patches. That is the right artifact for a developer and the wrong
+ * one for a thesis advisor, who expects the revision marked up in the document
+ * itself. `latexdiff` produces that, and the only parts a user cannot do by
+ * hand are getting the remote side onto disk and compiling the result without
+ * a local TeX installation.
+ *
+ * Everything decidable from data is decided here as a pure function so it can
+ * be unit-tested with no Overleaf account and no `latexdiff` binary; the spawn
+ * and the upload/compile/delete sequence stay in `cli.ts` with the rest of the
+ * IO. Same split as `diff.ts`.
+ *
+ * Orientation matches `diff.ts` and is not negotiable: **old is the remote,
+ * new is local**. Struck-through text in the markup is content a subsequent
+ * push would overwrite, underlined text is content it would upload.
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { resolveWithin } from './paths.js';
+const execFileAsync = promisify(execFile);
+/** Binary looked up on PATH. Not configurable; `latexdiff` is its only name. */
+export const LATEXDIFF_BIN = 'latexdiff';
+/**
+ * Directory the marked-up files are written to, relative to the target
+ * directory.
+ *
+ * Dotted on purpose. `scanLocalFiles` skips dotted entries unconditionally,
+ * before any ignore rule is consulted, so this is the one location whose
+ * contents cannot leak into a later `push`. A plain `main-diff.tex` next to
+ * the document would be uploaded to Overleaf on the next sync.
+ */
+export const DIFF_OUTPUT_DIR = '.olcli-diff';
+/**
+ * Name of the file `--pdf` uploads to the project for the duration of one
+ * compile.
+ *
+ * Fixed rather than randomized: a name a user can recognize and delete by hand
+ * is worth more than one that never collides, and a collision is refused
+ * rather than resolved anyway.
+ */
+export const REMOTE_SCRATCH_NAME = 'olcli-latexdiff.tex';
+/** Extensions treated as LaTeX source when looking for the root document. */
+const TEX_EXTENSIONS = ['.tex', '.ltx'];
+/**
+ * Drop the comment part of a single line of TeX.
+ *
+ * A `%` starts a comment unless it is escaped, and `\\%` is an escaped
+ * backslash followed by a comment, so the run of backslashes before the `%`
+ * has to be counted rather than just the character in front of it.
+ */
+function stripTexComment(line) {
+    for (let i = 0; i < line.length; i++) {
+        if (line[i] !== '%')
+            continue;
+        let backslashes = 0;
+        for (let j = i - 1; j >= 0 && line[j] === '\\'; j--)
+            backslashes++;
+        if (backslashes % 2 === 0)
+            return line.slice(0, i);
+    }
+    return line;
+}
+/**
+ * True when the file declares a document class outside of a comment.
+ *
+ * This is what separates a root document from the chapters it inputs. A
+ * commented-out `\documentclass` is common in subfiles - people leave the
+ * standalone preamble behind when they split a document up - and counting it
+ * would report every chapter as a candidate root.
+ */
+export function declaresDocumentClass(content) {
+    const text = content.toString('utf-8');
+    return text
+        .split('\n')
+        .some((line) => /\\documentclass\s*[[{]/.test(stripTexComment(line)));
+}
+export function isTexPath(path) {
+    const lower = path.toLowerCase();
+    return TEX_EXTENSIONS.some((ext) => lower.endsWith(ext));
+}
+/**
+ * Every `.tex` file in the tree that declares a document class, sorted by path
+ * so the list a user is shown is stable across runs.
+ */
+export function findRootCandidates(files) {
+    return [...files.keys()]
+        .filter((path) => isTexPath(path))
+        .filter((path) => declaresDocumentClass(files.get(path)))
+        .sort();
+}
+/** Raised when the root document cannot be determined; carries the advice. */
+export class RootDocumentError extends Error {
+    candidates;
+    constructor(message, candidates = []) {
+        super(message);
+        this.candidates = candidates;
+        this.name = 'RootDocumentError';
+    }
+}
+/**
+ * Decide which document to mark up.
+ *
+ * An explicit `--main` always wins, including for layouts this heuristic
+ * cannot read. Otherwise the document class is the signal, and ambiguity is
+ * reported rather than guessed at: a project holding both `paper.tex` and
+ * `poster.tex` has no correct default, and marking up the wrong one produces a
+ * plausible PDF describing the wrong revision - the failure that is hardest to
+ * notice.
+ *
+ * @param files  The local tree, already filtered the same way `diff` filters it.
+ */
+export function resolveRootDocument(files, explicit) {
+    if (explicit) {
+        if (!files.has(explicit)) {
+            throw new RootDocumentError(`Root document not found locally: ${explicit}\n` +
+                '  It must be a file in the target directory that diff also reports ' +
+                '(an ignore rule can hide it).');
+        }
+        return explicit;
+    }
+    const candidates = findRootCandidates(files);
+    if (candidates.length === 1)
+        return candidates[0];
+    if (candidates.length === 0) {
+        throw new RootDocumentError('No .tex file declaring \\documentclass was found, so there is no root document to mark up.\n' +
+            '  Pass --main <path> to name one.');
+    }
+    throw new RootDocumentError(`${candidates.length} files declare \\documentclass, so the root document is ambiguous.\n` +
+        '  Pass --main <path> to choose one.', candidates);
+}
+/**
+ * Build the `latexdiff` argument list.
+ *
+ * `--flatten` is the default, and the reason is the remote compile rather than
+ * taste. Without it the marked-up file still contains `\input{sections/intro}`,
+ * and compiling it on Overleaf resolves those against the files sitting in the
+ * project - the old content - so a multi-file thesis would produce a PDF that
+ * marks up the root document and silently shows every input file as unchanged.
+ * `--no-flatten` is there for anyone who wants the raw single-file markup.
+ *
+ * Extra options come before the file arguments because `latexdiff` reads the
+ * last two positional arguments as old and new.
+ */
+export function buildLatexdiffArgs(oldPath, newPath, options = {}) {
+    const args = [];
+    if (options.flatten !== false)
+        args.push('--flatten');
+    args.push(...(options.extra ?? []));
+    args.push(oldPath, newPath);
+    return args;
+}
+/**
+ * Where a marked-up artifact is written, relative to the target directory.
+ *
+ * Flat rather than mirroring the root document's folder: the output of a
+ * flattened run is a single self-contained file, and burying it under
+ * `.olcli-diff/chapters/` would only make it harder to find.
+ */
+export function diffOutputPath(rootPath, extension) {
+    const base = rootPath.split('/').pop().replace(/\.(tex|ltx)$/i, '');
+    return `${DIFF_OUTPUT_DIR}/${base}-diff.${extension}`;
+}
+/**
+ * Project path `--pdf` uploads the marked-up file to.
+ *
+ * Placed next to the root document rather than at the project root, so that
+ * relative `\includegraphics` and `\bibliography` paths in the flattened file
+ * resolve exactly as they do for the document it was built from.
+ */
+export function remoteScratchPath(rootPath) {
+    const folder = rootPath.includes('/') ? rootPath.slice(0, rootPath.lastIndexOf('/')) : '';
+    return folder ? `${folder}/${REMOTE_SCRATCH_NAME}` : REMOTE_SCRATCH_NAME;
+}
+/**
+ * Write a file tree to a directory, for use as `latexdiff`'s old side.
+ *
+ * `latexdiff --flatten` resolves `\input` relative to each side's own file, so
+ * the remote tree has to exist on disk with its folder structure intact -
+ * handing it just the root document would break every input in a multi-file
+ * project.
+ *
+ * Entry names are re-checked against the destination even though `diff` has
+ * already filtered them against the target directory: this writes files, and a
+ * path that was safe relative to one base is not automatically safe relative
+ * to another. See #44.
+ */
+export function materializeTree(destination, files) {
+    let written = 0;
+    for (const [path, data] of files) {
+        const target = resolveWithin(destination, path);
+        if (!target)
+            continue;
+        mkdirSync(dirname(target), { recursive: true });
+        writeFileSync(target, data);
+        written++;
+    }
+    return written;
+}
+/**
+ * Raised when `latexdiff` could not be run or exited non-zero. `missing`
+ * separates "not installed" - a setup problem with a known fix - from a real
+ * failure on the documents, which needs the tool's own message.
+ */
+export class LatexdiffError extends Error {
+    missing;
+    stderr;
+    constructor(message, missing, stderr = '') {
+        super(message);
+        this.missing = missing;
+        this.stderr = stderr;
+        this.name = 'LatexdiffError';
+    }
+}
+/**
+ * Run `latexdiff`, returning its stdout.
+ *
+ * `execFile`, never a shell: the arguments include user-supplied paths and
+ * pass-through options, and an argv array cannot be talked into running
+ * something else.
+ *
+ * The default `maxBuffer` is 1 MB, which a flattened thesis passes without
+ * trying. Exceeding it truncates stdout and reports it as an error, which
+ * would read as "latexdiff failed" on exactly the documents this feature
+ * exists for.
+ */
+export async function runLatexdiff(args) {
+    try {
+        const { stdout, stderr } = await execFileAsync(LATEXDIFF_BIN, args, {
+            encoding: 'utf-8',
+            maxBuffer: 256 * 1024 * 1024,
+        });
+        return { markup: stdout, stderr };
+    }
+    catch (error) {
+        // execFile rejects with the spawn error for a missing binary and with the
+        // captured streams for a non-zero exit; `code` carries the errno in the
+        // first case and the exit status in the second.
+        const failure = error;
+        if (failure.code === 'ENOENT') {
+            throw new LatexdiffError(`${LATEXDIFF_BIN} was not found on PATH`, true);
+        }
+        const stderr = typeof failure.stderr === 'string' ? failure.stderr.trim() : '';
+        throw new LatexdiffError(`${LATEXDIFF_BIN} exited with status ${failure.code ?? 'unknown'}`, false, stderr);
+    }
+}
+/**
+ * Install advice for a missing binary, by platform.
+ *
+ * `latexdiff` ships with TeX Live and MacTeX, so on most machines the answer
+ * is that the whole distribution is missing rather than this one tool - which
+ * is also the case where `--pdf` is most useful, since it needs no local TeX.
+ */
+export function latexdiffInstallHint(platform = process.platform) {
+    switch (platform) {
+        case 'darwin':
+            return 'Install MacTeX (brew install --cask mactex-no-gui) or brew install latexdiff';
+        case 'win32':
+            return 'Install MiKTeX or TeX Live; both ship latexdiff';
+        default:
+            return 'Install it from your TeX distribution (apt install latexdiff, or TeX Live)';
+    }
+}
+//# sourceMappingURL=latexdiff.js.map

package/dist/latexdiff.js.map

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

package/dist/prompt.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Interactive terminal prompts.
+ *
+ * Exists for one reason: reading a password without it appearing on the
+ * command line, and therefore in shell history. See issue #50.
+ *
+ * No dependency for this. A masked read is a raw-mode loop over stdin, and
+ * pulling in a prompt library to avoid writing it would cost more than it
+ * saves - the bar in this repo is low dependency count, not zero.
+ *
+ * The keystroke handling is a pure reducer (`applyChunk`) with the terminal
+ * wiring wrapped around it, for the same reason `diff.ts` is pure: a raw-mode
+ * loop cannot be exercised without a pty, and the part that can silently
+ * corrupt a password is the character handling, not the plumbing.
+ */
+/** Raised when the user aborts the prompt (Ctrl+C / Ctrl+D). */
+export declare class PromptCancelled extends Error {
+    constructor();
+}
+/** Raised when there is no terminal to prompt on. */
+export declare class NotATerminal extends Error {
+    constructor(message: string);
+}
+export interface KeyState {
+    /** What the user has typed so far. */
+    value: string;
+    /**
+     * Where we are in an ANSI escape sequence.
+     *
+     * 'none' - ordinary input
+     * 'esc'  - saw ESC, waiting to see whether a sequence follows
+     * 'csi'  - inside `ESC [` or `ESC O`, swallowing until the final byte
+     */
+    escape: 'none' | 'esc' | 'csi';
+    outcome: 'pending' | 'submit' | 'cancel';
+}
+export declare function initialKeyState(): KeyState;
+/**
+ * Fold one chunk of terminal input into the state.
+ *
+ * A chunk is not one keystroke: a paste arrives whole, and a single arrow key
+ * arrives as the three characters `ESC [ A`. Both have to be handled here.
+ *
+ * Escape sequences are swallowed rather than filtered character by character.
+ * Dropping only the ESC leaves `[` and `A` behind, and both are printable - so
+ * an arrow key pressed mid-entry would append "[A" to the password and the
+ * user would never see it. That is the failure this state machine exists to
+ * prevent; it was found by driving the prompt over a pty.
+ */
+export declare function applyChunk(state: KeyState, chunk: string): KeyState;
+/**
+ * Read a line from stdin without echoing it.
+ *
+ * Nothing is written back as the user types - not even asterisks. `sudo`
+ * behaves the same way, and echoing one character per keystroke leaks the
+ * length of the secret to anyone looking at the screen.
+ *
+ * Throws `NotATerminal` when stdin is piped or redirected. A masked read is
+ * impossible there, and silently falling back to an unmasked one would defeat
+ * the point; the caller is expected to name the scripted alternative instead.
+ */
+export declare function promptHidden(label: string): Promise<string>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,gEAAgE;AAChE,qBAAa,eAAgB,SAAQ,KAAK;;CAKzC;AAED,qDAAqD;AACrD,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,QAAQ;IACvB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAC/B,OAAO,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAC1C;AAED,wBAAgB,eAAe,IAAI,QAAQ,CAE1C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CA4CnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4C3D"}

package/dist/prompt.js

@@ -0,0 +1,146 @@
+/**
+ * Interactive terminal prompts.
+ *
+ * Exists for one reason: reading a password without it appearing on the
+ * command line, and therefore in shell history. See issue #50.
+ *
+ * No dependency for this. A masked read is a raw-mode loop over stdin, and
+ * pulling in a prompt library to avoid writing it would cost more than it
+ * saves - the bar in this repo is low dependency count, not zero.
+ *
+ * The keystroke handling is a pure reducer (`applyChunk`) with the terminal
+ * wiring wrapped around it, for the same reason `diff.ts` is pure: a raw-mode
+ * loop cannot be exercised without a pty, and the part that can silently
+ * corrupt a password is the character handling, not the plumbing.
+ */
+import { stdin, stdout } from 'node:process';
+const CTRL_C = '\u0003';
+const CTRL_D = '\u0004';
+const DEL = '\u007f';
+const ESC = '\u001b';
+/** Raised when the user aborts the prompt (Ctrl+C / Ctrl+D). */
+export class PromptCancelled extends Error {
+    constructor() {
+        super('Cancelled');
+        this.name = 'PromptCancelled';
+    }
+}
+/** Raised when there is no terminal to prompt on. */
+export class NotATerminal extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'NotATerminal';
+    }
+}
+export function initialKeyState() {
+    return { value: '', escape: 'none', outcome: 'pending' };
+}
+/**
+ * Fold one chunk of terminal input into the state.
+ *
+ * A chunk is not one keystroke: a paste arrives whole, and a single arrow key
+ * arrives as the three characters `ESC [ A`. Both have to be handled here.
+ *
+ * Escape sequences are swallowed rather than filtered character by character.
+ * Dropping only the ESC leaves `[` and `A` behind, and both are printable - so
+ * an arrow key pressed mid-entry would append "[A" to the password and the
+ * user would never see it. That is the failure this state machine exists to
+ * prevent; it was found by driving the prompt over a pty.
+ */
+export function applyChunk(state, chunk) {
+    let { value, escape, outcome } = state;
+    for (const ch of chunk) {
+        if (outcome !== 'pending')
+            break;
+        if (escape === 'csi') {
+            // Parameter and intermediate bytes continue the sequence; a final byte
+            // in @..~ ends it. `ESC [ 3 ~` (Delete) needs the parameter handling.
+            if (ch >= '@' && ch <= '~')
+                escape = 'none';
+            continue;
+        }
+        if (escape === 'esc') {
+            // `ESC [` is CSI, `ESC O` is the alternate cursor mode some terminals
+            // use for arrows. Anything else was a lone ESC plus a real character.
+            escape = ch === '[' || ch === 'O' ? 'csi' : 'none';
+            continue;
+        }
+        switch (ch) {
+            case '\r':
+            case '\n':
+                outcome = 'submit';
+                break;
+            case CTRL_C:
+            case CTRL_D:
+                outcome = 'cancel';
+                break;
+            case DEL:
+            case '\b':
+                value = value.slice(0, -1);
+                break;
+            case ESC:
+                escape = 'esc';
+                break;
+            default:
+                // Remaining control characters are not password material. Appending
+                // them would corrupt the value invisibly.
+                if (ch >= ' ')
+                    value += ch;
+        }
+    }
+    return { value, escape, outcome };
+}
+/**
+ * Read a line from stdin without echoing it.
+ *
+ * Nothing is written back as the user types - not even asterisks. `sudo`
+ * behaves the same way, and echoing one character per keystroke leaks the
+ * length of the secret to anyone looking at the screen.
+ *
+ * Throws `NotATerminal` when stdin is piped or redirected. A masked read is
+ * impossible there, and silently falling back to an unmasked one would defeat
+ * the point; the caller is expected to name the scripted alternative instead.
+ */
+export function promptHidden(label) {
+    return new Promise((resolve, reject) => {
+        if (!stdin.isTTY) {
+            reject(new NotATerminal('stdin is not a terminal, so a password cannot be prompted for'));
+            return;
+        }
+        // Restore whatever mode the caller was in rather than assuming cooked:
+        // olcli may be driven from a wrapper that set raw mode itself.
+        const wasRaw = stdin.isRaw;
+        let state = initialKeyState();
+        let settled = false;
+        const cleanup = () => {
+            if (settled)
+                return;
+            settled = true;
+            stdin.removeListener('data', onData);
+            stdin.setRawMode(wasRaw);
+            stdin.pause();
+            stdout.write('\n');
+        };
+        const onData = (chunk) => {
+            state = applyChunk(state, chunk);
+            if (state.outcome === 'submit') {
+                cleanup();
+                resolve(state.value);
+            }
+            else if (state.outcome === 'cancel') {
+                cleanup();
+                reject(new PromptCancelled());
+            }
+        };
+        // Raw mode goes on before the label is written. The terminal's line
+        // discipline echoes whatever arrives while ECHO is still set, so a caller
+        // that answers the instant the prompt appears - anything automated - would
+        // otherwise have its first keystrokes echoed to the screen.
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.setEncoding('utf8');
+        stdin.on('data', onData);
+        stdout.write(label);
+    });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

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