@johannes.latzel/terminal 0.1.0

package/dist/terminal-hook-builder.js

@@ -0,0 +1,48 @@
+class HookBuilder {
+    _reg;
+    constructor(_reg) {
+        this._reg = _reg;
+    }
+    do(callback) {
+        return this._reg(callback);
+    }
+}
+/**
+ * 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 class TerminalHookBuilder {
+    _regs;
+    constructor(_regs) {
+        this._regs = _regs;
+    }
+    beforeParse() {
+        return new HookBuilder(this._regs.beforeParse);
+    }
+    afterParse() {
+        return new HookBuilder(this._regs.afterParse);
+    }
+    beforeExecute() {
+        return new HookBuilder(this._regs.beforeExecute);
+    }
+    afterExecute() {
+        return new HookBuilder(this._regs.afterExecute);
+    }
+    beforeExit() {
+        return new HookBuilder(this._regs.beforeExit);
+    }
+    onError() {
+        return new HookBuilder(this._regs.onError);
+    }
+}
+//# sourceMappingURL=terminal-hook-builder.js.map

package/dist/terminal-hook-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-hook-builder.js","sourceRoot":"","sources":["../src/terminal-hook-builder.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW;IACO;IAApB,YAAoB,IAAqB;QAArB,SAAI,GAAJ,IAAI,CAAiB;IAAG,CAAC;IAC7C,EAAE,CAAC,QAAW;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;CACJ;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,mBAAmB;IACR;IAApB,YAAoB,KAAwB;QAAxB,UAAK,GAAL,KAAK,CAAmB;IAAG,CAAC;IAEhD,WAAW;QACP,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACnD,CAAC;IAED,UAAU;QACN,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IAED,aAAa;QAOT,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACrD,CAAC;IAED,YAAY;QACR,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACpD,CAAC;IAED,UAAU;QACN,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IAED,OAAO;QACH,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;CACJ"}

package/dist/terminal.d.ts

@@ -0,0 +1,86 @@
+import { Command, type TerminalOptions } from './types.js';
+import { TerminalHookBuilder } from './terminal-hook-builder.js';
+/**
+ * Interactive terminal/shell that reads input, resolves commands, and
+ * dispatches execution through the lifecycle-hook pipeline.
+ *
+ * Create one, {@link register} commands, then call {@link start}.
+ *
+ * @example
+ * ```ts
+ * const term = new Terminal({ prompt: '> ' });
+ * term.register(new MyCommand());
+ * await term.start();
+ * ```
+ */
+export declare class Terminal {
+    private rl;
+    private tree;
+    private _beforeParseHooks;
+    private _afterParseHooks;
+    private _beforeExecuteHooks;
+    private _afterExecuteHooks;
+    private _beforeExitHooks;
+    private _onErrorHooks;
+    private running;
+    private static readonly DEFAULT_OPTIONS;
+    private options;
+    private ctx;
+    private ctxState;
+    /**
+     * @param options - Prompt, I/O streams, history size, etc.
+     *                  Defaults to stdin/stdout with prompt `"> "`.
+     */
+    constructor(options?: TerminalOptions);
+    private createContext;
+    private registerBuiltins;
+    /**
+     * Register a command at the root level or as a subcommand of a
+     * parent container specified by a dot-separated path.
+     *
+     * @param command    - The command to register.
+     * @param parentPath - Optional dot-separated path to a parent
+     *                     container (e.g. `"config.set"`). All
+     *                     intermediate containers must already exist.
+     * @throws When the parent path does not resolve to a container.
+     *
+     * @example
+     * ```
+     * term.register(cmd)                  // root level
+     * term.register(cmd, 'config')         // under root "config"
+     * term.register(cmd, 'config.set')     // under config > set
+     * ```
+     */
+    register(command: Command, parentPath?: string): void;
+    /**
+     * Create a hook builder to register lifecycle callbacks.
+     *
+     * @example
+     * ```
+     * const h = term.hook()
+     *     .beforeExecute()
+     *     .do((command) => console.log(command.name()));
+     * // later: h.dispose();
+     * ```
+     */
+    hook(): TerminalHookBuilder;
+    private _addHook;
+    /** Returns all root-level registered commands. */
+    getRootCommands(): Command[];
+    /**
+     * Start the terminal loop. Idempotent — safe to call multiple times.
+     */
+    start(): Promise<void>;
+    private createReadline;
+    private bindEvents;
+    /**
+     * Stop the terminal loop. Closes the readline interface.
+     */
+    stop(): Promise<void>;
+    private handleLine;
+    private processInput;
+    private resolveCommand;
+    private executeWithHooks;
+    private handleError;
+}
+//# sourceMappingURL=terminal.d.ts.map

package/dist/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAyC,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAWlG,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAWjE;;;;;;;;;;;;GAYG;AACH,qBAAa,QAAQ;IACjB,OAAO,CAAC,EAAE,CAAmC;IAC7C,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,iBAAiB,CAAyB;IAClD,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,mBAAmB,CAA2B;IACtD,OAAO,CAAC,kBAAkB,CAA0B;IACpD,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAKrC;IAEF,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,GAAG,CAAiB;IAC5B,OAAO,CAAC,QAAQ,CAA+B;IAE/C;;;OAGG;gBACS,OAAO,CAAC,EAAE,eAAe;IAOrC,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,gBAAgB;IAMxB;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAwBrD;;;;;;;;;;OAUG;IACH,IAAI,IAAI,mBAAmB;IAW3B,OAAO,CAAC,QAAQ;IAahB,kDAAkD;IAClD,eAAe,IAAI,OAAO,EAAE;IAI5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,UAAU;IAsBlB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAYb,UAAU;YAqBV,YAAY;IAgB1B,OAAO,CAAC,cAAc;YAaR,gBAAgB;YAYhB,WAAW;CAmB5B"}

package/dist/terminal.js

@@ -0,0 +1,274 @@
+import * as readline from 'node:readline';
+import { CommandContainer } from './types.js';
+import { CommandTree } from './command-tree.js';
+import { tokenize } from './input/parser.js';
+import { parseFlags } from './input/args-parser.js';
+import { CommandArguments } from './command-arguments.js';
+import { Completer } from './completion/completer.js';
+import { CommandNotFoundError } from './errors.js';
+import { HelpCommand } from './commands/help.js';
+import { ExitCommand } from './commands/exit.js';
+import { ClearCommand } from './commands/clear.js';
+import { TerminalHookBuilder } from './terminal-hook-builder.js';
+import { TypedHook } from './hooks.js';
+/**
+ * Interactive terminal/shell that reads input, resolves commands, and
+ * dispatches execution through the lifecycle-hook pipeline.
+ *
+ * Create one, {@link register} commands, then call {@link start}.
+ *
+ * @example
+ * ```ts
+ * const term = new Terminal({ prompt: '> ' });
+ * term.register(new MyCommand());
+ * await term.start();
+ * ```
+ */
+export class Terminal {
+    rl = null;
+    tree;
+    _beforeParseHooks = [];
+    _afterParseHooks = [];
+    _beforeExecuteHooks = [];
+    _afterExecuteHooks = [];
+    _beforeExitHooks = [];
+    _onErrorHooks = [];
+    running = false;
+    static DEFAULT_OPTIONS = {
+        prompt: '> ',
+        stdin: process.stdin,
+        stdout: process.stdout,
+        historySize: 100
+    };
+    options;
+    ctx;
+    ctxState = {};
+    /**
+     * @param options - Prompt, I/O streams, history size, etc.
+     *                  Defaults to stdin/stdout with prompt `"> "`.
+     */
+    constructor(options) {
+        this.options = { ...Terminal.DEFAULT_OPTIONS, ...options };
+        this.tree = new CommandTree();
+        this.ctx = this.createContext();
+        this.registerBuiltins();
+    }
+    createContext() {
+        return {
+            terminal: this,
+            stdout: this.options.stdout,
+            stdin: this.options.stdin,
+            state: this.ctxState,
+            logger: console,
+            exit: () => {
+                void this.stop();
+            }
+        };
+    }
+    registerBuiltins() {
+        this.register(new HelpCommand());
+        this.register(new ExitCommand());
+        this.register(new ClearCommand());
+    }
+    /**
+     * Register a command at the root level or as a subcommand of a
+     * parent container specified by a dot-separated path.
+     *
+     * @param command    - The command to register.
+     * @param parentPath - Optional dot-separated path to a parent
+     *                     container (e.g. `"config.set"`). All
+     *                     intermediate containers must already exist.
+     * @throws When the parent path does not resolve to a container.
+     *
+     * @example
+     * ```
+     * term.register(cmd)                  // root level
+     * term.register(cmd, 'config')         // under root "config"
+     * term.register(cmd, 'config.set')     // under config > set
+     * ```
+     */
+    register(command, parentPath) {
+        if (!parentPath) {
+            this.tree.add(command);
+            return;
+        }
+        const segments = parentPath.split('.');
+        let container = this.tree;
+        let level = this.tree.commands();
+        for (const seg of segments) {
+            const parent = level.find((c) => c.name() === seg);
+            if (!parent || !(parent instanceof CommandContainer)) {
+                throw new Error(`Cannot register "${command.name()}": parent path "${parentPath}" does not resolve to a container at segment "${seg}"`);
+            }
+            container = parent;
+            level = parent.commands();
+        }
+        container.add(command);
+    }
+    /**
+     * Create a hook builder to register lifecycle callbacks.
+     *
+     * @example
+     * ```
+     * const h = term.hook()
+     *     .beforeExecute()
+     *     .do((command) => console.log(command.name()));
+     * // later: h.dispose();
+     * ```
+     */
+    hook() {
+        return new TerminalHookBuilder({
+            beforeParse: (fn) => this._addHook(this._beforeParseHooks, fn),
+            afterParse: (fn) => this._addHook(this._afterParseHooks, fn),
+            beforeExecute: (fn) => this._addHook(this._beforeExecuteHooks, fn),
+            afterExecute: (fn) => this._addHook(this._afterExecuteHooks, fn),
+            beforeExit: (fn) => this._addHook(this._beforeExitHooks, fn),
+            onError: (fn) => this._addHook(this._onErrorHooks, fn)
+        });
+    }
+    _addHook(arr, fn) {
+        let hook;
+        hook = new TypedHook(fn, () => {
+            const idx = arr.indexOf(hook);
+            arr.splice(idx, 1);
+        });
+        arr.push(hook);
+        return hook;
+    }
+    /** Returns all root-level registered commands. */
+    getRootCommands() {
+        return this.tree.getRoots();
+    }
+    /**
+     * Start the terminal loop. Idempotent — safe to call multiple times.
+     */
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.rl = this.createReadline();
+        this.bindEvents(this.rl);
+        this.rl.prompt();
+    }
+    createReadline() {
+        const completer = new Completer(this.tree);
+        return readline.createInterface({
+            input: this.options.stdin,
+            output: this.options.stdout,
+            prompt: this.options.prompt,
+            historySize: this.options.historySize,
+            completer: (line) => {
+                const { matches, partial } = completer.complete(line);
+                return [matches, partial];
+            },
+            terminal: this.options.stdin.isTTY
+        });
+    }
+    bindEvents(rl) {
+        rl.on('line', (line) => {
+            void this.handleLine(line);
+        });
+        rl.on('SIGINT', () => {
+            this.options.stdout.write('^C\n');
+            rl.prompt();
+        });
+        rl.on('close', () => {
+            if (this.running) {
+                this.options.stdout.write('\n');
+                void this.stop();
+            }
+        });
+        rl.on('error', (err) => {
+            this.options.stdout.write(`Readline error: ${err.message}\n`);
+        });
+    }
+    /**
+     * Stop the terminal loop. Closes the readline interface.
+     */
+    async stop() {
+        if (this.running) {
+            for (const hook of this._beforeExitHooks) {
+                await hook.exec();
+            }
+        }
+        this.running = false;
+        this.rl?.close();
+        this.rl = null;
+        this.options.stdin.pause();
+    }
+    async handleLine(input) {
+        try {
+            const tokens = await this.processInput(input);
+            if (tokens.length === 0) {
+                this.rl?.prompt();
+                return;
+            }
+            const resolved = this.resolveCommand(tokens);
+            const record = parseFlags(resolved.args, resolved.command.definitions());
+            const args = new CommandArguments(record, this.rl, resolved.command.definitions());
+            await this.executeWithHooks(resolved.command, args);
+        }
+        catch (error) {
+            await this.handleError(error);
+        }
+        finally {
+            if (this.running) {
+                this.rl?.prompt();
+            }
+        }
+    }
+    async processInput(input) {
+        let processed = input;
+        for (const hook of this._beforeParseHooks) {
+            processed = await hook.exec(processed);
+        }
+        const tokens = tokenize(processed);
+        let finalTokens = tokens;
+        for (const hook of this._afterParseHooks) {
+            finalTokens = await hook.exec(finalTokens);
+        }
+        return finalTokens;
+    }
+    resolveCommand(tokens) {
+        const resolved = this.tree.find(tokens);
+        if (!resolved) {
+            const suggestions = this.tree.findSuggestions(tokens[0]);
+            const msg = suggestions.length > 0
+                ? `Unknown command: ${tokens[0]}. Did you mean: ${suggestions.join(', ')}?`
+                : `Unknown command: ${tokens[0]}`;
+            throw new CommandNotFoundError(msg, suggestions);
+        }
+        return resolved;
+    }
+    async executeWithHooks(command, args) {
+        for (const hook of this._beforeExecuteHooks) {
+            if ((await hook.exec(command, this.ctx, args)) === false)
+                return;
+        }
+        const result = await command.execute(this.ctx, args);
+        for (const hook of this._afterExecuteHooks) {
+            await hook.exec(result);
+        }
+    }
+    async handleError(error) {
+        for (const hook of this._onErrorHooks) {
+            try {
+                if ((await hook.exec(error)) === true)
+                    return;
+            }
+            catch (hookError) {
+                this.options.stdout.write(`Error in onError hook: ${hookError.message}\n`);
+            }
+        }
+        if (error instanceof CommandNotFoundError) {
+            this.options.stdout.write(`${error.message}\n`);
+        }
+        else if (error instanceof Error) {
+            this.options.stdout.write(`Error: ${error.message}\n`);
+        }
+        else {
+            this.options.stdout.write(`Error: ${String(error)}\n`);
+        }
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/terminal.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+import type { Terminal } from './terminal.js';
+import type { CommandArguments, CommandArgumentDefinition } from './command-arguments.js';
+/**
+ * A leaf node in the command tree. Has no subcommand support.
+ * Subclasses must implement {@link execute}.
+ */
+export declare abstract class Command {
+    private _name;
+    private _description;
+    private _definitions;
+    /**
+     * @param name        - Command name used for matching input tokens.
+     * @param description - Short description shown in help output.
+     * @param argDefs     - Argument definitions for `--name value` pairs.
+     */
+    constructor(name: string, description?: string, argDefs?: CommandArgumentDefinition[]);
+    private _validatePositions;
+    /** Command name (used for matching input tokens). */
+    name(): string;
+    /** Shown in `help` output. */
+    description(): string | undefined;
+    /** Argument definitions for this command. */
+    definitions(): CommandArgumentDefinition[];
+    /**
+     * Execute the command.
+     * @param ctx - Execution context with streams, state, and lifecycle access.
+     * @param args - Parsed `--name value` pairs wrapped in an Args instance.
+     */
+    abstract execute(ctx: CommandContext, args: CommandArguments): void | Promise<void>;
+}
+/**
+ * A command that acts as a namespace for subcommands.
+ * Subcommands are registered via {@link add} and are used for
+ * tree traversal and help output.
+ *
+ * The default {@link execute} implementation prints detailed help
+ * for this container (description, arguments, subcommands).
+ * Subclasses may override `execute` to provide custom behavior.
+ */
+export declare class CommandContainer extends Command {
+    private _commands;
+    /** Register a child command. */
+    add(command: Command): void;
+    /** Returns all registered child commands. */
+    commands(): Command[];
+    execute(ctx: CommandContext, _args: CommandArguments): Promise<void>;
+}
+/** Context passed to every command's `execute()`. */
+export interface CommandContext {
+    /** The running Terminal instance. */
+    terminal: Terminal;
+    /** Output stream — write command results here. */
+    stdout: NodeJS.WriteStream;
+    /** Input stream. */
+    stdin: NodeJS.ReadStream;
+    /** Shared mutable state accessible to all commands. */
+    state: Record<string, unknown>;
+    /** Console-compatible logger. */
+    logger: Logger;
+    /** Shortcut for `terminal.stop()`. */
+    exit: () => void;
+}
+/** Console-compatible logger interface. */
+export interface Logger {
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}
+/** Options for the Terminal constructor. */
+export interface TerminalOptions {
+    /** Prompt string (default `"> "`). */
+    prompt?: string;
+    /** Input stream (default `process.stdin`). */
+    stdin?: NodeJS.ReadStream;
+    /** Output stream (default `process.stdout`). */
+    stdout?: NodeJS.WriteStream;
+    /** Readline history size (default `100`). */
+    historySize?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAG1F;;;GAGG;AACH,8BAAsB,OAAO;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,YAAY,CAA8B;IAElD;;;;OAIG;gBACS,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,EAAE;IAarF,OAAO,CAAC,kBAAkB;IA2B1B,qDAAqD;IACrD,IAAI,IAAI,MAAM;IAId,8BAA8B;IAC9B,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC,6CAA6C;IAC7C,WAAW,IAAI,yBAAyB,EAAE;IAI1C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CACtF;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,SAAQ,OAAO;IACzC,OAAO,CAAC,SAAS,CAAiB;IAElC,gCAAgC;IAChC,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI3B,6CAA6C;IAC7C,QAAQ,IAAI,OAAO,EAAE;IAIf,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAI7E;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC3B,qCAAqC;IACrC,QAAQ,EAAE,QAAQ,CAAC;IACnB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC;IAC3B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC;IACzB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,IAAI,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,2CAA2C;AAC3C,MAAM,WAAW,MAAM;IACnB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACnC;AAED,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC5B,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC1B,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/types.js

@@ -0,0 +1,85 @@
+import { InvalidArgumentsError } from './errors.js';
+/**
+ * A leaf node in the command tree. Has no subcommand support.
+ * Subclasses must implement {@link execute}.
+ */
+export class Command {
+    _name;
+    _description;
+    _definitions;
+    /**
+     * @param name        - Command name used for matching input tokens.
+     * @param description - Short description shown in help output.
+     * @param argDefs     - Argument definitions for `--name value` pairs.
+     */
+    constructor(name, description, argDefs) {
+        if (name.length === 0) {
+            throw new InvalidArgumentsError('Command name cannot be empty');
+        }
+        if (/\s/.test(name)) {
+            throw new InvalidArgumentsError(`Command name "${name}" must not contain whitespace`);
+        }
+        this._name = name;
+        this._description = description;
+        this._definitions = argDefs ?? [];
+        this._validatePositions(name);
+    }
+    _validatePositions(name) {
+        const positions = this._definitions
+            .map((d) => d.position)
+            .filter((p) => p !== undefined);
+        if (positions.length === 0)
+            return;
+        const seen = new Set();
+        for (const pos of positions) {
+            if (seen.has(pos)) {
+                throw new InvalidArgumentsError(`Duplicate position index ${pos} in command "${name}"`);
+            }
+            seen.add(pos);
+        }
+        const sorted = [...positions].sort((a, b) => a - b);
+        for (let i = 0; i < sorted.length; i++) {
+            if (sorted[i] !== i) {
+                throw new InvalidArgumentsError(`Positional arguments must form a contiguous sequence starting at 0. ` +
+                    `Expected position ${i}, got ${sorted[i]} in command "${name}"`);
+            }
+        }
+    }
+    /** Command name (used for matching input tokens). */
+    name() {
+        return this._name;
+    }
+    /** Shown in `help` output. */
+    description() {
+        return this._description;
+    }
+    /** Argument definitions for this command. */
+    definitions() {
+        return this._definitions;
+    }
+}
+/**
+ * A command that acts as a namespace for subcommands.
+ * Subcommands are registered via {@link add} and are used for
+ * tree traversal and help output.
+ *
+ * The default {@link execute} implementation prints detailed help
+ * for this container (description, arguments, subcommands).
+ * Subclasses may override `execute` to provide custom behavior.
+ */
+export class CommandContainer extends Command {
+    _commands = [];
+    /** Register a child command. */
+    add(command) {
+        this._commands.push(command);
+    }
+    /** Returns all registered child commands. */
+    commands() {
+        return this._commands;
+    }
+    async execute(ctx, _args) {
+        const { commandHelp } = await import('./commands/help.js');
+        ctx.stdout.write(commandHelp(this) + '\n');
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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