@johannes.latzel/terminal 0.1.0

package/dist/commands/help.js

@@ -0,0 +1,136 @@
+import { Command, CommandContainer } from '../types.js';
+import { z } from 'zod';
+/** Left-pad a string with spaces to a minimum width. */
+function leftPad(str, len) {
+    return str + ' '.repeat(Math.max(0, len - str.length));
+}
+/**
+ * Render a global help listing for a set of root commands.
+ * Each command is shown as `name   description`, names are
+ * left-aligned to the longest command name.
+ */
+export function globalHelp(commands) {
+    const maxNameLen = Math.max(...commands.map((c) => c.name().length), 0);
+    const lines = ['Commands:'];
+    for (const cmd of commands) {
+        const desc = cmd.description() ?? '';
+        lines.push(`  ${leftPad(cmd.name(), maxNameLen)}  ${desc}`);
+    }
+    return lines.join('\n');
+}
+function renderCommandArgumentDefinitions(argDefs) {
+    if (argDefs.length === 0)
+        return [];
+    const lines = ['', 'Arguments:'];
+    const maxNameLen = Math.max(...argDefs.map((a) => a.name.length));
+    for (const arg of argDefs) {
+        const label = `--${arg.name}`;
+        const required = arg.required ? ' (required)' : '';
+        const desc = arg.description ?? '';
+        lines.push(`  ${leftPad(label, maxNameLen + 2)}  ${desc}${required}`);
+    }
+    return lines;
+}
+/**
+ * Render detailed help for a single command, including its
+ * name, description, argument definitions, and subcommands.
+ */
+export function commandHelp(command) {
+    const lines = [];
+    const globalDesc = command.description();
+    if (globalDesc) {
+        lines.push(`${command.name()} - ${globalDesc}`);
+    }
+    else {
+        lines.push(command.name());
+    }
+    lines.push(...renderCommandArgumentDefinitions(command.definitions()));
+    if (command instanceof CommandContainer) {
+        const subs = command.commands();
+        if (subs.length > 0) {
+            const maxNameLen = Math.max(...subs.map((c) => c.name().length));
+            lines.push('');
+            lines.push('Subcommands:');
+            for (const sub of subs) {
+                const desc = sub.description() ?? '';
+                lines.push(`  ${leftPad(sub.name(), maxNameLen)}  ${desc}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Resolve a token path against a command list and render
+ * help for the resolved command. Returns an error message
+ * if the path does not match any command.
+ */
+export function scopedHelp(commands, pathTokens) {
+    const resolved = resolveCommand(commands, pathTokens);
+    if (!resolved) {
+        return `Unknown command: ${pathTokens.join(' ')}`;
+    }
+    return commandHelp(resolved);
+}
+/**
+ * Walk the command tree matching each token to a command name.
+ * Returns the deepest matching command, or `undefined` if a token
+ * cannot be matched or extra tokens trail a leaf node.
+ */
+export function resolveCommand(commands, tokens) {
+    let level = commands;
+    let matched;
+    for (const token of tokens) {
+        matched = level.find((c) => c.name() === token);
+        if (!matched)
+            return undefined;
+        if (matched instanceof CommandContainer) {
+            const subs = matched.commands();
+            if (subs.length > 0) {
+                level = subs;
+                continue;
+            }
+        }
+        if (token !== tokens[tokens.length - 1]) {
+            return undefined;
+        }
+    }
+    return matched;
+}
+/**
+ * Built-in `help` command. Lists all commands or shows detailed
+ * help for a specific command by name.
+ *
+ * @example
+ * ```
+ * > help                     # list all commands
+ * > help --command config    # show help for the "config" command
+ * ```
+ */
+export class HelpCommand extends Command {
+    constructor() {
+        super('help', 'Show help', [
+            {
+                name: 'command',
+                description: 'Show help for a specific command',
+                required: false,
+                schema: z.string()
+            }
+        ]);
+    }
+    async execute(ctx, args) {
+        const roots = ctx.terminal.getRootCommands();
+        if (args.has('command')) {
+            const cmdName = await args.require('command');
+            const cmd = roots.find((c) => c.name() === cmdName);
+            if (!cmd) {
+                ctx.stdout.write(`Unknown command: ${cmdName}\n`);
+                return;
+            }
+            ctx.stdout.write(commandHelp(cmd) + '\n');
+        }
+        else {
+            ctx.stdout.write(globalHelp(roots) + '\n');
+        }
+    }
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

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

package/dist/completion/completer.d.ts

@@ -0,0 +1,22 @@
+import { CommandTree } from '../command-tree.js';
+export interface Completion {
+    /** Matching command names. */
+    matches: string[];
+    /** The partial token that was matched against. */
+    partial: string;
+}
+/**
+ * Tab-completion engine powered by the command tree.
+ * Walks the tree to find commands matching the current input
+ * prefix, supporting multi-level completion through containers
+ * and --flag completion for commands with argument definitions.
+ */
+export declare class Completer {
+    private tree;
+    constructor(tree: CommandTree);
+    /**
+     * Compute completions for a partial input line.
+     */
+    complete(line: string): Completion;
+}
+//# sourceMappingURL=completer.d.ts.map

package/dist/completion/completer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completer.d.ts","sourceRoot":"","sources":["../../src/completion/completer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,WAAW,UAAU;IACvB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACN,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,WAAW;IAErC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;CAwCrC"}

package/dist/completion/completer.js

@@ -0,0 +1,55 @@
+import { CommandContainer } from '../types.js';
+import { tokenize } from '../input/parser.js';
+/**
+ * Tab-completion engine powered by the command tree.
+ * Walks the tree to find commands matching the current input
+ * prefix, supporting multi-level completion through containers
+ * and --flag completion for commands with argument definitions.
+ */
+export class Completer {
+    tree;
+    constructor(tree) {
+        this.tree = tree;
+    }
+    /**
+     * Compute completions for a partial input line.
+     */
+    complete(line) {
+        const tokens = tokenize(line);
+        const trailingSpace = line.endsWith(' ');
+        if (tokens.length === 0 && !trailingSpace) {
+            return { matches: this.tree.getRoots().map((c) => c.name()), partial: '' };
+        }
+        const partial = trailingSpace ? '' : tokens[tokens.length - 1];
+        const prefix = trailingSpace ? tokens : tokens.slice(0, -1);
+        let lastMatched = null;
+        let commands = this.tree.getRoots();
+        for (const token of prefix) {
+            if (token.startsWith('--'))
+                continue;
+            const cmd = commands.find((command) => command.name() === token);
+            if (!cmd)
+                return { matches: [], partial: line };
+            lastMatched = cmd;
+            if (!(cmd instanceof CommandContainer))
+                break;
+            commands = cmd.commands();
+        }
+        if (lastMatched && !(lastMatched instanceof CommandContainer)) {
+            const flagPartial = partial.startsWith('--') ? partial : partial === '' ? '--' : null;
+            if (flagPartial !== null) {
+                const matches = lastMatched
+                    .definitions()
+                    .filter((a) => `--${a.name}`.startsWith(flagPartial))
+                    .map((a) => `--${a.name}`);
+                return { matches, partial };
+            }
+            return { matches: [], partial };
+        }
+        const matches = commands
+            .filter((command) => command.name().startsWith(partial))
+            .map((c) => c.name());
+        return { matches, partial };
+    }
+}
+//# sourceMappingURL=completer.js.map

package/dist/completion/completer.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,18 @@
+/** Thrown when no command matches the input tokens. */
+export declare class CommandNotFoundError extends Error {
+    readonly suggestions: string[];
+    /**
+     * @param message - Human-readable error description.
+     * @param suggestions - Prefix-matched command names to suggest.
+     */
+    constructor(message: string, suggestions?: string[]);
+}
+/** Thrown when a command receives invalid arguments. */
+export declare class InvalidArgumentsError extends Error {
+    constructor(message: string);
+}
+/** Thrown when input cannot be tokenized (e.g. unclosed quotes). */
+export declare class ParseError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,qBAAa,oBAAqB,SAAQ,KAAK;aAOvB,WAAW,EAAE,MAAM,EAAE;IANzC;;;OAGG;gBAEC,OAAO,EAAE,MAAM,EACC,WAAW,GAAE,MAAM,EAAO;CAKjD;AAED,wDAAwD;AACxD,qBAAa,qBAAsB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI9B;AAED,oEAAoE;AACpE,qBAAa,UAAW,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI9B"}

package/dist/errors.js

@@ -0,0 +1,28 @@
+/** Thrown when no command matches the input tokens. */
+export class CommandNotFoundError extends Error {
+    suggestions;
+    /**
+     * @param message - Human-readable error description.
+     * @param suggestions - Prefix-matched command names to suggest.
+     */
+    constructor(message, suggestions = []) {
+        super(message);
+        this.suggestions = suggestions;
+        this.name = 'CommandNotFoundError';
+    }
+}
+/** Thrown when a command receives invalid arguments. */
+export class InvalidArgumentsError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidArgumentsError';
+    }
+}
+/** Thrown when input cannot be tokenized (e.g. unclosed quotes). */
+export class ParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ParseError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAOvB;IANpB;;;OAGG;IACH,YACI,OAAe,EACC,cAAwB,EAAE;QAE1C,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,gBAAW,GAAX,WAAW,CAAe;QAG1C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACvC,CAAC;CACJ;AAED,wDAAwD;AACxD,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACxC,CAAC;CACJ;AAED,oEAAoE;AACpE,MAAM,OAAO,UAAW,SAAQ,KAAK;IACjC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC7B,CAAC;CACJ"}

package/dist/hook.d.ts

@@ -0,0 +1,11 @@
+/** Base class for all hooks. Call {@link dispose} to unsubscribe. */
+export declare abstract class Hook {
+    private _disposed;
+    /** Unsubscribe this hook. Safe to call multiple times. */
+    dispose(): void;
+    /** Whether this hook has been disposed. */
+    protected isDisposed(): boolean;
+    /** Override to clean up subscriptions. Called once by {@link dispose}. */
+    protected abstract onDispose(): void;
+}
+//# sourceMappingURL=hook.d.ts.map

package/dist/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../src/hook.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,8BAAsB,IAAI;IACtB,OAAO,CAAC,SAAS,CAAS;IAE1B,0DAA0D;IAC1D,OAAO,IAAI,IAAI;IAMf,2CAA2C;IAC3C,SAAS,CAAC,UAAU,IAAI,OAAO;IAI/B,0EAA0E;IAC1E,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,IAAI;CACvC"}

package/dist/hook.js

@@ -0,0 +1,16 @@
+/** Base class for all hooks. Call {@link dispose} to unsubscribe. */
+export class Hook {
+    _disposed = false;
+    /** Unsubscribe this hook. Safe to call multiple times. */
+    dispose() {
+        if (this._disposed)
+            return;
+        this._disposed = true;
+        this.onDispose();
+    }
+    /** Whether this hook has been disposed. */
+    isDisposed() {
+        return this._disposed;
+    }
+}
+//# sourceMappingURL=hook.js.map

package/dist/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../src/hook.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,OAAgB,IAAI;IACd,SAAS,GAAG,KAAK,CAAC;IAE1B,0DAA0D;IAC1D,OAAO;QACH,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,SAAS,EAAE,CAAC;IACrB,CAAC;IAED,2CAA2C;IACjC,UAAU;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;CAIJ"}

package/dist/hooks.d.ts

@@ -0,0 +1,21 @@
+import { Hook } from './hook.js';
+import type { Command, CommandContext } from './types.js';
+import type { CommandArguments } from './command-arguments.js';
+export declare class TypedHook<TArgs extends any[], TReturn> extends Hook {
+    private readonly fn;
+    private readonly onDisposeCb;
+    constructor(fn: (...args: TArgs) => TReturn, onDisposeCb: () => void);
+    exec(...args: TArgs): TReturn;
+    protected onDispose(): void;
+}
+export type BeforeParseHook = TypedHook<[string], string | Promise<string>>;
+export type AfterParseHook = TypedHook<[string[]], string[] | Promise<string[]>>;
+export type BeforeExecuteHook = TypedHook<[
+    Command,
+    CommandContext,
+    CommandArguments
+], void | false | Promise<void | false>>;
+export type AfterExecuteHook = TypedHook<[unknown], void | Promise<void>>;
+export type BeforeExitHook = TypedHook<[], void | Promise<void>>;
+export type OnErrorHook = TypedHook<[Error], void | boolean | Promise<void | boolean>>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,qBAAa,SAAS,CAAC,KAAK,SAAS,GAAG,EAAE,EAAE,OAAO,CAAE,SAAQ,IAAI;IAEzD,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,EAC/B,WAAW,EAAE,MAAM,IAAI;IAK5C,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,GAAG,OAAO;IAI7B,SAAS,CAAC,SAAS,IAAI,IAAI;CAG9B;AAED,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5E,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AACjF,MAAM,MAAM,iBAAiB,GAAG,SAAS,CACrC;IAAC,OAAO;IAAE,cAAc;IAAE,gBAAgB;CAAC,EAC3C,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,CACvC,CAAC;AACF,MAAM,MAAM,gBAAgB,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1E,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACjE,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC"}

package/dist/hooks.js

@@ -0,0 +1,17 @@
+import { Hook } from './hook.js';
+export class TypedHook extends Hook {
+    fn;
+    onDisposeCb;
+    constructor(fn, onDisposeCb) {
+        super();
+        this.fn = fn;
+        this.onDisposeCb = onDisposeCb;
+    }
+    exec(...args) {
+        return this.fn(...args);
+    }
+    onDispose() {
+        this.onDisposeCb();
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,MAAM,OAAO,SAAwC,SAAQ,IAAI;IAExC;IACA;IAFrB,YACqB,EAA+B,EAC/B,WAAuB;QAExC,KAAK,EAAE,CAAC;QAHS,OAAE,GAAF,EAAE,CAA6B;QAC/B,gBAAW,GAAX,WAAW,CAAY;IAG5C,CAAC;IAED,IAAI,CAAC,GAAG,IAAW;QACf,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5B,CAAC;IAES,SAAS;QACf,IAAI,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;CACJ"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { Terminal } from './terminal.js';
+export { CommandArguments } from './command-arguments.js';
+export { InvalidArgumentsError, CommandNotFoundError, ParseError } from './errors.js';
+export { Hook } from './hook.js';
+export { TerminalHookBuilder } from './terminal-hook-builder.js';
+export { Command, CommandContainer } from './types.js';
+export { command, container, arg } from './command-factory.js';
+export type { CommandArgumentDefinition } from './command-arguments.js';
+export type { CommandContext, Logger, TerminalOptions } from './types.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,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { Terminal } from './terminal.js';
+export { CommandArguments } from './command-arguments.js';
+export { InvalidArgumentsError, CommandNotFoundError, ParseError } from './errors.js';
+export { Hook } from './hook.js';
+export { TerminalHookBuilder } from './terminal-hook-builder.js';
+export { Command, CommandContainer } from './types.js';
+export { command, container, arg } from './command-factory.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,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/input/args-parser.d.ts

@@ -0,0 +1,22 @@
+import type { CommandArgumentDefinition } from '../command-arguments.js';
+/**
+ * Parse an array of tokens into a record of `--name value` pairs.
+ *
+ * - `--name value` produces `{ name: "value" }`
+ * - `--flag` (no next token or next token starts with `--`) produces
+ *   `{ flag: "true" }` (boolean-shorthand)
+ * - When `argDefs` is provided, tokens not starting with `--` are
+ *   matched against argument definitions with a `position` index
+ *   and consumed in position order.
+ *
+ * @param tokens - Tokens remaining after command matching.
+ * @param argDefs - Optional argument definitions; those with a
+ *   `position` field are treated as positional (bare token) args.
+ * @returns A record mapping argument names (without `--` prefix) to
+ *   their string values.
+ * @throws {InvalidArgumentsError} When a token does not start with
+ *   `--` (and no positional definition matches), or an empty `--`
+ *   is encountered.
+ */
+export declare function parseFlags(tokens: string[], argDefs?: CommandArgumentDefinition[]): Record<string, string>;
+//# sourceMappingURL=args-parser.d.ts.map

package/dist/input/args-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args-parser.d.ts","sourceRoot":"","sources":["../../src/input/args-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEzE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CACtB,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE,yBAAyB,EAAE,GACtC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkCxB"}

package/dist/input/args-parser.js

@@ -0,0 +1,52 @@
+import { InvalidArgumentsError } from '../errors.js';
+/**
+ * Parse an array of tokens into a record of `--name value` pairs.
+ *
+ * - `--name value` produces `{ name: "value" }`
+ * - `--flag` (no next token or next token starts with `--`) produces
+ *   `{ flag: "true" }` (boolean-shorthand)
+ * - When `argDefs` is provided, tokens not starting with `--` are
+ *   matched against argument definitions with a `position` index
+ *   and consumed in position order.
+ *
+ * @param tokens - Tokens remaining after command matching.
+ * @param argDefs - Optional argument definitions; those with a
+ *   `position` field are treated as positional (bare token) args.
+ * @returns A record mapping argument names (without `--` prefix) to
+ *   their string values.
+ * @throws {InvalidArgumentsError} When a token does not start with
+ *   `--` (and no positional definition matches), or an empty `--`
+ *   is encountered.
+ */
+export function parseFlags(tokens, argDefs) {
+    const args = {};
+    const positionalDefs = (argDefs ?? [])
+        .filter((d) => d.position !== undefined)
+        .sort((a, b) => a.position - b.position);
+    let positionalIdx = 0;
+    for (let i = 0; i < tokens.length; i++) {
+        const token = tokens[i];
+        if (!token.startsWith('--')) {
+            if (positionalIdx < positionalDefs.length) {
+                args[positionalDefs[positionalIdx].name] = token;
+                positionalIdx++;
+                continue;
+            }
+            throw new InvalidArgumentsError(`Unexpected token "${token}", expected --argument`);
+        }
+        const name = token.slice(2);
+        if (name.length === 0) {
+            throw new InvalidArgumentsError('Empty argument name (--)');
+        }
+        const next = tokens[i + 1];
+        if (next !== undefined && !next.startsWith('--')) {
+            args[name] = next;
+            i++;
+        }
+        else {
+            args[name] = 'true';
+        }
+    }
+    return args;
+}
+//# sourceMappingURL=args-parser.js.map

package/dist/input/args-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args-parser.js","sourceRoot":"","sources":["../../src/input/args-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGrD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,UAAU,CACtB,MAAgB,EAChB,OAAqC;IAErC,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,MAAM,cAAc,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;SACjC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC;SACvC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAS,GAAG,CAAC,CAAC,QAAS,CAAC,CAAC;IAC/C,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QAEzB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,aAAa,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC;gBACxC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAE,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;gBAClD,aAAa,EAAE,CAAC;gBAChB,SAAS;YACb,CAAC;YACD,MAAM,IAAI,qBAAqB,CAAC,qBAAqB,KAAK,wBAAwB,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,qBAAqB,CAAC,0BAA0B,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3B,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YAClB,CAAC,EAAE,CAAC;QACR,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;QACxB,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/input/parser.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Split a raw input line into tokens, respecting single and double quotes.
+ * Leading and trailing whitespace is trimmed; empty or whitespace-only
+ * input produces an empty array.
+ *
+ * Quoted segments are treated as a single token (quotes stripped).
+ * Both quote types support `\` escapes and are treated identically.
+ * Adjacent non-whitespace characters around quotes are rejected.
+ *
+ * @param input - Raw input string from the terminal.
+ * @throws {ParseError} When quotes are unclosed or adjacent to non-whitespace.
+ */
+export declare function tokenize(input: string): string[];
+//# sourceMappingURL=parser.d.ts.map

package/dist/input/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/input/parser.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA0DhD"}

package/dist/input/parser.js

@@ -0,0 +1,65 @@
+import { ParseError } from '../errors.js';
+/**
+ * Split a raw input line into tokens, respecting single and double quotes.
+ * Leading and trailing whitespace is trimmed; empty or whitespace-only
+ * input produces an empty array.
+ *
+ * Quoted segments are treated as a single token (quotes stripped).
+ * Both quote types support `\` escapes and are treated identically.
+ * Adjacent non-whitespace characters around quotes are rejected.
+ *
+ * @param input - Raw input string from the terminal.
+ * @throws {ParseError} When quotes are unclosed or adjacent to non-whitespace.
+ */
+export function tokenize(input) {
+    const trimmed = input.trim();
+    if (trimmed.length === 0)
+        return [];
+    const tokens = [];
+    let current = '';
+    let inQuote = null;
+    for (let i = 0; i < trimmed.length; i++) {
+        const ch = trimmed[i];
+        if (inQuote && ch === '\\' && i + 1 < trimmed.length) {
+            current += trimmed[++i];
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            if (inQuote === null && current.length > 0) {
+                throw new ParseError(`Unexpected characters before quote: "${current}"`);
+            }
+            if (inQuote === ch) {
+                inQuote = null;
+                tokens.push(current);
+                current = '';
+                const next = trimmed[i + 1];
+                if (next !== undefined && !/\s/.test(next)) {
+                    throw new ParseError(`Unexpected character "${next}" after closing quote`);
+                }
+                continue;
+            }
+            if (inQuote === null) {
+                inQuote = ch;
+                continue;
+            }
+            current += ch;
+            continue;
+        }
+        if (/\s/.test(ch) && inQuote === null) {
+            if (current.length > 0) {
+                tokens.push(current);
+                current = '';
+            }
+            continue;
+        }
+        current += ch;
+    }
+    if (current.length > 0) {
+        tokens.push(current);
+    }
+    if (inQuote !== null) {
+        throw new ParseError(`Unclosed ${inQuote} quote`);
+    }
+    return tokens;
+}
+//# sourceMappingURL=parser.js.map

package/dist/input/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/input/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa;IAClC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,OAAO,GAAqB,IAAI,CAAC;IAErC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QAEvB,IAAI,OAAO,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YACnD,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC,CAAE,CAAC;YACzB,SAAS;QACb,CAAC;QAED,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAC3B,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,UAAU,CAAC,wCAAwC,OAAO,GAAG,CAAC,CAAC;YAC7E,CAAC;YACD,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;gBACjB,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrB,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC5B,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzC,MAAM,IAAI,UAAU,CAAC,yBAAyB,IAAI,uBAAuB,CAAC,CAAC;gBAC/E,CAAC;gBACD,SAAS;YACb,CAAC;YACD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACnB,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS;YACb,CAAC;YACD,OAAO,IAAI,EAAE,CAAC;YACd,SAAS;QACb,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACpC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrB,OAAO,GAAG,EAAE,CAAC;YACjB,CAAC;YACD,SAAS;QACb,CAAC;QAED,OAAO,IAAI,EAAE,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,UAAU,CAAC,YAAY,OAAO,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/terminal-hook-builder.d.ts

@@ -0,0 +1,42 @@
+import { Hook } from './hook.js';
+import type { Command, CommandContext } from './types.js';
+import type { CommandArguments } from './command-arguments.js';
+type HookRegistrations = {
+    beforeParse: (fn: (input: string) => string | Promise<string>) => Hook;
+    afterParse: (fn: (tokens: string[]) => string[] | Promise<string[]>) => Hook;
+    beforeExecute: (fn: (command: Command, ctx: CommandContext, args: CommandArguments) => void | false | Promise<void | false>) => Hook;
+    afterExecute: (fn: (result: unknown) => void | Promise<void>) => Hook;
+    beforeExit: (fn: () => void | Promise<void>) => Hook;
+    onError: (fn: (error: Error) => void | boolean | Promise<void | boolean>) => Hook;
+};
+declare class HookBuilder<T extends (...args: any[]) => any> {
+    private _reg;
+    constructor(_reg: (fn: T) => Hook);
+    do(callback: T): Hook;
+}
+/**
+ * Entry point for registering terminal lifecycle hooks.
+ *
+ * Created by calling {@link Terminal.hook}. Select an event with one of the
+ * selector methods, then call {@link do} to register the callback.
+ *
+ * @example
+ * ```ts
+ * const h = term.hook()
+ *     .beforeExecute()
+ *     .do((command) => console.log(command.name()));
+ * // later: h.dispose();
+ * ```
+ */
+export declare class TerminalHookBuilder {
+    private _regs;
+    constructor(_regs: HookRegistrations);
+    beforeParse(): HookBuilder<(input: string) => string | Promise<string>>;
+    afterParse(): HookBuilder<(tokens: string[]) => string[] | Promise<string[]>>;
+    beforeExecute(): HookBuilder<(command: Command, ctx: CommandContext, args: CommandArguments) => void | false | Promise<void | false>>;
+    afterExecute(): HookBuilder<(result: unknown) => void | Promise<void>>;
+    beforeExit(): HookBuilder<() => void | Promise<void>>;
+    onError(): HookBuilder<(error: Error) => void | boolean | Promise<void | boolean>>;
+}
+export {};
+//# sourceMappingURL=terminal-hook-builder.d.ts.map

package/dist/terminal-hook-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-hook-builder.d.ts","sourceRoot":"","sources":["../src/terminal-hook-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,KAAK,iBAAiB,GAAG;IACrB,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACvE,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7E,aAAa,EAAE,CACX,EAAE,EAAE,CACA,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,gBAAgB,KACrB,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,KACxC,IAAI,CAAC;IACV,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IACtE,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IACrD,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC;CACrF,CAAC;AAEF,cAAM,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG;IACnC,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI;IACzC,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI;CAGxB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAmB;IAChB,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,iBAAiB;IAE5C,WAAW,IAAI,WAAW,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAIvE,UAAU,IAAI,WAAW,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAI7E,aAAa,IAAI,WAAW,CACxB,CACI,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,gBAAgB,KACrB,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,CAC5C;IAID,YAAY,IAAI,WAAW,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAItE,UAAU,IAAI,WAAW,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAIrD,OAAO,IAAI,WAAW,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;CAGrF"}