zudojs-cli 0.0.1

package/dist/src/bin/zudolib.js

@@ -0,0 +1,233 @@
+#!/usr/bin/env node
+/**
+ * Zudojs CLI entry point.
+ *
+ * @module bin/zudojs
+ */
+import { createCLI } from "../cliApplication/index.js";
+import { CLI_DEFAULTS } from "../cliConstant/cliConstant.value.js";
+import { createCommand } from "../cliCommand/index.js";
+import { runCreateCommand } from "../commands/create.command.js";
+import { runDevCommand } from "../commands/dev.command.js";
+import { runGenerateCommand } from "../commands/generate.command.js";
+import { runAddCommand } from "../commands/add.command.js";
+import { runBuildCommand } from "../commands/build.command.js";
+import { runDoctorCommand } from "../commands/doctor.command.js";
+import { runInfoCommand } from "../commands/info.command.js";
+const app = createCLI({
+    name: "Zudojs",
+    version: "0.1.0",
+    description: "Command-line interface for the Zudojs framework.",
+});
+app.register(createCommand({
+    name: "create",
+    description: "Create a new Zudojs project",
+    arguments: [
+        {
+            name: "project-name",
+            description: "The name of the project to create",
+            required: false,
+        },
+    ],
+    options: [
+        {
+            name: "type",
+            short: "t",
+            description: "Project type (backend, frontend, fullstack)",
+            type: "string",
+            defaultValue: "backend",
+        },
+        {
+            name: "architecture",
+            short: "a",
+            description: "Backend architecture (monolith, modular-monolith, microservice)",
+            type: "string",
+            defaultValue: "monolith",
+        },
+        {
+            name: "package-manager",
+            short: "p",
+            description: "Package manager (npm, pnpm, yarn, bun)",
+            type: "string",
+            defaultValue: "pnpm",
+        },
+        {
+            name: "database",
+            short: "d",
+            description: "Database engine (postgresql, mysql, sqlite, mongodb)",
+            type: "string",
+            defaultValue: "postgresql",
+        },
+        {
+            name: "api",
+            description: "API style (rest, graphql, rpc)",
+            type: "string",
+            defaultValue: "rest",
+        },
+        {
+            name: "frontend",
+            short: "f",
+            description: "Frontend framework (react, next, vue, nuxt, angular, svelte, sveltekit, astro, vanilla, flutter, react-native)",
+            type: "string",
+            defaultValue: "none",
+        },
+        {
+            name: "frontend-architecture",
+            short: "fa",
+            description: "Frontend architecture (zudojs-standard, feature-based, minimal, framework-default)",
+            type: "string",
+            defaultValue: "zudojs-standard",
+        },
+        {
+            name: "language",
+            short: "l",
+            description: "Language (typescript, javascript)",
+            type: "string",
+            defaultValue: "typescript",
+        },
+        {
+            name: "no-install",
+            description: "Skip dependency installation",
+            type: "boolean",
+            defaultValue: false,
+        },
+        {
+            name: "no-git",
+            description: "Skip git initialization",
+            type: "boolean",
+            defaultValue: false,
+        },
+        {
+            name: "services",
+            description: "Comma-separated service names (microservice architecture only)",
+            type: "string",
+            defaultValue: "gateway,api",
+        },
+    ],
+    execute: async (context) => {
+        await runCreateCommand(context);
+    },
+}));
+app.register(createCommand({
+    name: "dev",
+    description: "Start development servers",
+    aliases: ["d"],
+    options: [
+        {
+            name: "frontend-only",
+            description: "Start only the frontend dev server",
+            type: "boolean",
+            defaultValue: false,
+        },
+        {
+            name: "backend-only",
+            description: "Start only the backend dev server",
+            type: "boolean",
+            defaultValue: false,
+        },
+        {
+            name: "port",
+            short: "p",
+            description: "Port for the backend server",
+            type: "number",
+        },
+    ],
+    execute: async (context) => {
+        await runDevCommand(context);
+    },
+}));
+app.register(createCommand({
+    name: "generate",
+    description: "Generate files within a Zudojs project",
+    aliases: ["g"],
+    arguments: [
+        {
+            name: "schematic",
+            description: "The schematic to generate (service, module, command, query, controller, repository)",
+            required: true,
+        },
+        {
+            name: "name",
+            description: "The name of the file/resource to generate",
+            required: true,
+        },
+    ],
+    options: [
+        {
+            name: "service",
+            short: "s",
+            description: "The service name (for CQRS commands/queries)",
+            type: "string",
+        },
+        {
+            name: "module",
+            short: "m",
+            description: "The module name",
+            type: "string",
+        },
+        {
+            name: "dry-run",
+            description: "Show what would be generated without writing files",
+            type: "boolean",
+            defaultValue: false,
+        },
+    ],
+    execute: async (context) => {
+        await runGenerateCommand(context);
+    },
+}));
+app.register(createCommand({
+    name: "add",
+    description: "Add a feature package to a Zudojs project",
+    arguments: [
+        {
+            name: "feature",
+            description: "The feature to add (database, queue, messaging, openapi, observability, security)",
+            required: true,
+        },
+    ],
+    options: [
+        {
+            name: "adapter",
+            short: "a",
+            description: "Specific adapter to use",
+            type: "string",
+        },
+        {
+            name: "skip-install",
+            description: "Skip dependency installation",
+            type: "boolean",
+            defaultValue: false,
+        },
+    ],
+    execute: async (context) => {
+        await runAddCommand(context);
+    },
+}));
+app.register(createCommand({
+    name: "doctor",
+    description: "Run diagnostics on a Zudojs project",
+    execute: async (context) => {
+        await runDoctorCommand(context);
+    },
+}));
+app.register(createCommand({
+    name: "build",
+    description: "Build a Zudojs project",
+    aliases: ["b"],
+    execute: async (context) => {
+        await runBuildCommand(context);
+    },
+}));
+app.register(createCommand({
+    name: "info",
+    description: "Show information about the Zudojs CLI and project",
+    execute: async (context) => {
+        await runInfoCommand(context);
+    },
+}));
+const exitCode = await app.run(process.argv.slice(2));
+if (exitCode !== 0) {
+    process.exit(exitCode);
+}
+//# sourceMappingURL=zudolib.js.map

package/dist/src/bin/zudolib.js.map

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

package/dist/src/cliApplication/cliApplication.builtins.d.ts

@@ -0,0 +1,19 @@
+/**
+ * zudojs-cli — Built-in Commands
+ *
+ * Help and version request detection and output.
+ */
+import type { CLIArguments, CLIWriter } from "../cliType/cliType.type.js";
+/** Returns whether the args contain a help request. */
+export declare function isHelpRequest(args: CLIArguments): boolean;
+/** Returns whether the args contain a version request. */
+export declare function isVersionRequest(args: CLIArguments): boolean;
+/** Prints the version string. */
+export declare function printVersion(writer: CLIWriter, version?: string): void;
+/** Prints application help. */
+export declare function printHelp(writer: CLIWriter, name: string, version?: string, description?: string, commands?: readonly {
+    name: string;
+    aliases?: readonly string[];
+    description?: string;
+}[]): void;
+//# sourceMappingURL=cliApplication.builtins.d.ts.map

package/dist/src/cliApplication/cliApplication.builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliApplication.builtins.d.ts","sourceRoot":"","sources":["../../../src/cliApplication/cliApplication.builtins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EAEZ,SAAS,EACV,MAAM,4BAA4B,CAAC;AAMpC,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAIzD;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAK5D;AAED,iCAAiC;AACjC,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAEtE;AAED,+BAA+B;AAC/B,wBAAgB,SAAS,CACvB,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,GAAE,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,EAAO,GACP,IAAI,CA6BN"}

package/dist/src/cliApplication/cliApplication.builtins.js

@@ -0,0 +1,39 @@
+/**
+ * zudojs-cli — Built-in Commands
+ *
+ * Help and version request detection and output.
+ */
+import { CLI_COMMANDS, CLI_DEFAULTS, } from "../cliConstant/cliConstant.value.js";
+/** Returns whether the args contain a help request. */
+export function isHelpRequest(args) {
+    return args.some((arg) => arg === CLI_COMMANDS.HELP || arg === "-h" || arg === "--help");
+}
+/** Returns whether the args contain a version request. */
+export function isVersionRequest(args) {
+    return args.some((arg) => arg === CLI_COMMANDS.VERSION || arg === "-v" || arg === "--version");
+}
+/** Prints the version string. */
+export function printVersion(writer, version) {
+    writer.writeLine(version ?? CLI_DEFAULTS.VERSION);
+}
+/** Prints application help. */
+export function printHelp(writer, name, version, description, commands = []) {
+    const lines = [];
+    lines.push(`${name} ${version ? `v${version}` : ""}`.trim());
+    if (description)
+        lines.push(description);
+    lines.push("", "Usage:", `  ${name} <command> [options]`, "", "Commands:");
+    const sorted = commands.slice().sort((a, b) => a.name.localeCompare(b.name));
+    if (sorted.length === 0) {
+        lines.push("  No commands registered.");
+    }
+    else {
+        for (const cmd of sorted) {
+            const aliases = cmd.aliases?.length ? ` (${cmd.aliases.join(", ")})` : "";
+            lines.push(`  ${cmd.name}${aliases}${cmd.description ? `  ${cmd.description}` : ""}`);
+        }
+    }
+    lines.push("", "Options:", "  -h, --help     Show help.", "  -v, --version  Show version.");
+    writer.writeLine(lines.join("\n"));
+}
+//# sourceMappingURL=cliApplication.builtins.js.map

package/dist/src/cliApplication/cliApplication.builtins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliApplication.builtins.js","sourceRoot":"","sources":["../../../src/cliApplication/cliApplication.builtins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EACL,YAAY,EACZ,YAAY,GACb,MAAM,qCAAqC,CAAC;AAE7C,uDAAuD;AACvD,MAAM,UAAU,aAAa,CAAC,IAAkB;IAC9C,OAAO,IAAI,CAAC,IAAI,CACd,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,YAAY,CAAC,IAAI,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ,CACvE,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,gBAAgB,CAAC,IAAkB;IACjD,OAAO,IAAI,CAAC,IAAI,CACd,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,KAAK,YAAY,CAAC,OAAO,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,WAAW,CACtE,CAAC;AACJ,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,YAAY,CAAC,MAAiB,EAAE,OAAgB;IAC9D,MAAM,CAAC,SAAS,CAAC,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,SAAS,CACvB,MAAiB,EACjB,IAAY,EACZ,OAAgB,EAChB,WAAoB,EACpB,QAAQ,GAIF,EAAE;IAER,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IAE7D,IAAI,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAEzC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,IAAI,sBAAsB,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;IAE3E,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAE7E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,KAAK,CAAC,IAAI,CACR,KAAK,GAAG,CAAC,IAAI,GAAG,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CACR,EAAE,EACF,UAAU,EACV,6BAA6B,EAC7B,gCAAgC,CACjC,CAAC;IAEF,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACrC,CAAC"}

package/dist/src/cliApplication/cliApplication.core.d.ts

@@ -0,0 +1,45 @@
+/**
+ * zudojs-cli — CLI Application
+ *
+ * Main CLI application class that orchestrates command registration,
+ * parsing, execution, and built-in help/version handling.
+ */
+import type { CLIApplication, CLIApplicationOptions, CLIArguments, CLICommand, CLIHooks, CLIWriter } from "../cliType/cliType.type.js";
+import { CLICommandRegistry } from "../cliCommand/cliCommand.registry.js";
+import { CLIParser } from "../cliParser/index.js";
+/**
+ * Main CLI application that registers commands, parses arguments,
+ * and executes handlers.
+ */
+export declare class ZudojsCLI implements CLIApplication {
+    readonly name: string;
+    readonly version?: string;
+    readonly description?: string;
+    readonly commands: CLICommandRegistry;
+    readonly parser: CLIParser;
+    readonly writer: CLIWriter;
+    private readonly cwd;
+    private readonly env;
+    private readonly logger;
+    private readonly hooks;
+    private running;
+    constructor(options?: CLIApplicationOptions);
+    /** Registers a single command. */
+    register(command: CLICommand): this;
+    /** Registers multiple commands. */
+    registerMany(commands: readonly CLICommand[]): this;
+    /** Sets lifecycle hooks. */
+    use(hooks: CLIHooks): this;
+    /** Runs the CLI application. */
+    run(args?: CLIArguments): Promise<number>;
+    private findCommand;
+    private getCommandArguments;
+    private createContext;
+    /** Whether the application is currently running. */
+    get isRunning(): boolean;
+    /** Number of registered commands. */
+    get commandCount(): number;
+}
+/** Creates a new CLI application. */
+export declare function createCLI(options?: CLIApplicationOptions): ZudojsCLI;
+//# sourceMappingURL=cliApplication.core.d.ts.map

package/dist/src/cliApplication/cliApplication.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliApplication.core.d.ts","sourceRoot":"","sources":["../../../src/cliApplication/cliApplication.core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,UAAU,EAGV,QAAQ,EACR,SAAS,EACV,MAAM,4BAA4B,CAAC;AAOpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE1E,OAAO,EAAE,SAAS,EAAkB,MAAM,uBAAuB,CAAC;AAclE;;;GAGG;AACH,qBAAa,SAAU,YAAW,cAAc;IAC9C,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjC,SAAgB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrC,SAAgB,QAAQ,EAAE,kBAAkB,CAAC;IAC7C,SAAgB,MAAM,EAAE,SAAS,CAAC;IAClC,SAAgB,MAAM,EAAE,SAAS,CAAC;IAElC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,OAAO,CAAS;IAExB,YAAY,OAAO,GAAE,qBAA0B,EAW9C;IAED,kCAAkC;IAC3B,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAGzC;IAED,mCAAmC;IAC5B,YAAY,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI,CAGzD;IAED,4BAA4B;IACrB,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAKhC;IAED,gCAAgC;IACnB,GAAG,CACd,IAAI,GAAE,YAAoC,GACzC,OAAO,CAAC,MAAM,CAAC,CAwEjB;IAID,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,aAAa;IAYrB,oDAAoD;IACpD,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED,qCAAqC;IACrC,IAAW,YAAY,IAAI,MAAM,CAEhC;CACF;AAMD,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,OAAO,GAAE,qBAA0B,GAAG,SAAS,CAExE"}

package/dist/src/cliApplication/cliApplication.core.js

@@ -0,0 +1,162 @@
+/**
+ * zudojs-cli — CLI Application
+ *
+ * Main CLI application class that orchestrates command registration,
+ * parsing, execution, and built-in help/version handling.
+ */
+import { CLI_DEFAULTS, CLI_EXIT_CODES, } from "../cliConstant/cliConstant.value.js";
+import { CLIExecutionError, normalizeCLIError } from "../cliError/index.js";
+import { CommandNotFoundError } from "../cliError/cliError.command.js";
+import { CLICommandRegistry } from "../cliCommand/cliCommand.registry.js";
+import { executeCommand } from "../cliCommand/cliCommand.factory.js";
+import { CLIParser, resolveCommand } from "../cliParser/index.js";
+import { createDefaultLogger } from "@zudojs/logger";
+import { createCLIWriter } from "./cliApplication.writer.js";
+import { isHelpRequest, isVersionRequest, printVersion, printHelp, } from "./cliApplication.builtins.js";
+/* -------------------------------------------------------------------------- */
+/* Application                                                                */
+/* -------------------------------------------------------------------------- */
+/**
+ * Main CLI application that registers commands, parses arguments,
+ * and executes handlers.
+ */
+export class ZudojsCLI {
+    name;
+    version;
+    description;
+    commands;
+    parser;
+    writer;
+    cwd;
+    env;
+    logger;
+    hooks;
+    running = false;
+    constructor(options = {}) {
+        this.name = options.name ?? CLI_DEFAULTS.NAME;
+        this.version = options.version ?? CLI_DEFAULTS.VERSION;
+        this.description = options.description ?? CLI_DEFAULTS.DESCRIPTION;
+        this.cwd = options.cwd ?? process.cwd();
+        this.env = options.env ?? process.env;
+        this.logger = options.logger ?? createDefaultLogger();
+        this.commands = new CLICommandRegistry();
+        this.parser = new CLIParser();
+        this.writer = createCLIWriter();
+        this.hooks = {};
+    }
+    /** Registers a single command. */
+    register(command) {
+        this.commands.register(command);
+        return this;
+    }
+    /** Registers multiple commands. */
+    registerMany(commands) {
+        this.commands.registerMany(commands);
+        return this;
+    }
+    /** Sets lifecycle hooks. */
+    use(hooks) {
+        if (hooks.beforeRun)
+            this.hooks.beforeRun = hooks.beforeRun;
+        if (hooks.afterRun)
+            this.hooks.afterRun = hooks.afterRun;
+        if (hooks.onError)
+            this.hooks.onError = hooks.onError;
+        return this;
+    }
+    /** Runs the CLI application. */
+    async run(args = process.argv.slice(2)) {
+        if (this.running) {
+            throw new CLIExecutionError("The CLI application is already running.");
+        }
+        this.running = true;
+        try {
+            if (isHelpRequest(args)) {
+                printHelp(this.writer, this.name, this.version, this.description, this.commands.list());
+                return CLI_EXIT_CODES.SUCCESS;
+            }
+            if (isVersionRequest(args)) {
+                printVersion(this.writer, this.version);
+                return CLI_EXIT_CODES.SUCCESS;
+            }
+            const command = this.findCommand(args);
+            if (!command) {
+                if (args.length === 0) {
+                    printHelp(this.writer, this.name, this.version, this.description, this.commands.list());
+                    return CLI_EXIT_CODES.SUCCESS;
+                }
+                throw new CommandNotFoundError(String(args[0]));
+            }
+            const commandArgs = this.getCommandArguments(args, command);
+            const commandContext = this.createContext(commandArgs, command);
+            if (this.hooks.beforeRun) {
+                await this.hooks.beforeRun(commandContext);
+            }
+            await executeCommand(command, commandContext);
+            if (this.hooks.afterRun) {
+                await this.hooks.afterRun(commandContext, CLI_EXIT_CODES.SUCCESS);
+            }
+            return CLI_EXIT_CODES.SUCCESS;
+        }
+        catch (error) {
+            const normalized = normalizeCLIError(error);
+            const command = this.findCommand(args);
+            const commandArgs = command
+                ? this.getCommandArguments(args, command)
+                : args;
+            const fallbackContext = this.createContext(commandArgs, command);
+            if (this.hooks.onError) {
+                await this.hooks.onError(normalized, fallbackContext);
+            }
+            this.writer.errorLine(normalized.message);
+            return normalized.exitCode;
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    /* ---- Internal ---- */
+    findCommand(args) {
+        for (const arg of args) {
+            if (arg.startsWith("-"))
+                continue;
+            const command = resolveCommand(this.commands.list(), arg);
+            if (command)
+                return command;
+        }
+        return undefined;
+    }
+    getCommandArguments(args, command) {
+        const index = args.findIndex((arg) => arg === command.name || command.aliases?.includes(arg));
+        if (index < 0)
+            return args;
+        return args.slice(index + 1);
+    }
+    createContext(args, command) {
+        const parsed = this.parser.parse(args, command);
+        return {
+            args,
+            values: parsed.options,
+            command: command?.name,
+            cwd: this.cwd,
+            env: this.env,
+            logger: this.logger,
+        };
+    }
+    /** Whether the application is currently running. */
+    get isRunning() {
+        return this.running;
+    }
+    /** Number of registered commands. */
+    get commandCount() {
+        return this.commands.size;
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Factory                                                                    */
+/* -------------------------------------------------------------------------- */
+/** Creates a new CLI application. */
+export function createCLI(options = {}) {
+    return new ZudojsCLI(options);
+}
+//# sourceMappingURL=cliApplication.core.js.map

package/dist/src/cliApplication/cliApplication.core.js.map

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

package/dist/src/cliApplication/cliApplication.writer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * zudojs-cli — CLI Writer
+ *
+ * Writer factory and signal handling for the CLI application.
+ */
+import type { CLIWriter } from "../cliType/cliType.type.js";
+/** Creates a CLIWriter that writes to stdout/stderr. */
+export declare function createCLIWriter(): CLIWriter;
+/** Registers a SIGINT handler and returns an unsubscribe function. */
+export declare function registerCLIInterruptHandler(onInterrupt: () => void | Promise<void>): () => void;
+//# sourceMappingURL=cliApplication.writer.d.ts.map

package/dist/src/cliApplication/cliApplication.writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliApplication.writer.d.ts","sourceRoot":"","sources":["../../../src/cliApplication/cliApplication.writer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAO5D,wDAAwD;AACxD,wBAAgB,eAAe,IAAI,SAAS,CAkB3C;AAMD,sEAAsE;AACtE,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACtC,MAAM,IAAI,CAcZ"}

package/dist/src/cliApplication/cliApplication.writer.js

@@ -0,0 +1,45 @@
+/**
+ * zudojs-cli — CLI Writer
+ *
+ * Writer factory and signal handling for the CLI application.
+ */
+import { CLI_EXIT_CODES } from "../cliConstant/cliConstant.value.js";
+/* -------------------------------------------------------------------------- */
+/* Writer Factory                                                             */
+/* -------------------------------------------------------------------------- */
+/** Creates a CLIWriter that writes to stdout/stderr. */
+export function createCLIWriter() {
+    return {
+        write(message) {
+            process.stdout.write(message);
+        },
+        writeLine(message = "") {
+            process.stdout.write(`${message}\n`);
+        },
+        error(message) {
+            process.stderr.write(message);
+        },
+        errorLine(message = "") {
+            process.stderr.write(`${message}\n`);
+        },
+    };
+}
+/* -------------------------------------------------------------------------- */
+/* Signal Handling                                                            */
+/* -------------------------------------------------------------------------- */
+/** Registers a SIGINT handler and returns an unsubscribe function. */
+export function registerCLIInterruptHandler(onInterrupt) {
+    const handler = async () => {
+        try {
+            await onInterrupt();
+        }
+        finally {
+            process.exit(CLI_EXIT_CODES.INTERRUPTED);
+        }
+    };
+    process.on("SIGINT", handler);
+    return () => {
+        process.off("SIGINT", handler);
+    };
+}
+//# sourceMappingURL=cliApplication.writer.js.map

package/dist/src/cliApplication/cliApplication.writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliApplication.writer.js","sourceRoot":"","sources":["../../../src/cliApplication/cliApplication.writer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAErE,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,wDAAwD;AACxD,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,KAAK,CAAC,OAAe;YACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QAED,SAAS,CAAC,OAAO,GAAG,EAAE;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,OAAe;YACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QAED,SAAS,CAAC,OAAO,GAAG,EAAE;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACvC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,sEAAsE;AACtE,MAAM,UAAU,2BAA2B,CACzC,WAAuC;IAEvC,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,WAAW,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE9B,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/cliApplication/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * zudojs-cli — CLI Application
+ *
+ * Main application class, factory, built-in commands, and signal handling.
+ */
+export { ZudojsCLI, createCLI } from "./cliApplication.core.js";
+export { createCLIWriter, registerCLIInterruptHandler, } from "./cliApplication.writer.js";
+export { isHelpRequest, isVersionRequest, printVersion, printHelp, } from "./cliApplication.builtins.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/cliApplication/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cliApplication/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EACL,eAAe,EACf,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,SAAS,GACV,MAAM,8BAA8B,CAAC"}

package/dist/src/cliApplication/index.js

@@ -0,0 +1,9 @@
+/**
+ * zudojs-cli — CLI Application
+ *
+ * Main application class, factory, built-in commands, and signal handling.
+ */
+export { ZudojsCLI, createCLI } from "./cliApplication.core.js";
+export { createCLIWriter, registerCLIInterruptHandler, } from "./cliApplication.writer.js";
+export { isHelpRequest, isVersionRequest, printVersion, printHelp, } from "./cliApplication.builtins.js";
+//# sourceMappingURL=index.js.map

package/dist/src/cliApplication/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cliApplication/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EACL,eAAe,EACf,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,SAAS,GACV,MAAM,8BAA8B,CAAC"}

package/dist/src/cliCommand/cliCommand.builder.d.ts

@@ -0,0 +1,29 @@
+/**
+ * zudojs-cli — Command Builder
+ *
+ * Fluent builder for constructing CLI commands.
+ */
+import type { CLICommand } from "../cliType/cliType.type.js";
+/**
+ * Fluent builder for constructing CLI commands.
+ */
+export declare class CLICommandBuilder {
+    private nameValue;
+    private descriptionValue?;
+    private aliasesValue;
+    private optionsValue;
+    private argumentsValue;
+    private commandsValue;
+    private executeValue?;
+    name(value: string): this;
+    description(value: string): this;
+    alias(value: string): this;
+    aliases(values: readonly string[]): this;
+    options(values: CLICommand["options"]): this;
+    arguments(values: CLICommand["arguments"]): this;
+    commands(values: CLICommand["commands"]): this;
+    execute(handler: CLICommand["execute"]): this;
+    /** Builds the CLI command. */
+    build(): CLICommand;
+}
+//# sourceMappingURL=cliCommand.builder.d.ts.map