zudojs-cli 0.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"cliCommand.builder.d.ts","sourceRoot":"","sources":["../../../src/cliCommand/cliCommand.builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,UAAU,EAEX,MAAM,4BAA4B,CAAC;AAOpC;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,YAAY,CAAC,CAAwB;IAEtC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG/B;IAEM,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGtC;IAEM,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGhC;IAEM,OAAO,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAG9C;IAEM,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC,GAAG,IAAI,CAGlD;IAEM,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,IAAI,CAGtD;IAEM,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,IAAI,CAGpD;IAEM,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,GAAG,IAAI,CAGnD;IAED,8BAA8B;IACvB,KAAK,IAAI,UAAU,CAczB;CACF"}

package/dist/src/cliCommand/cliCommand.builder.js

@@ -0,0 +1,69 @@
+/**
+ * zudojs-cli — Command Builder
+ *
+ * Fluent builder for constructing CLI commands.
+ */
+import { createCommand } from "./cliCommand.factory.js";
+/* -------------------------------------------------------------------------- */
+/* Command Builder                                                            */
+/* -------------------------------------------------------------------------- */
+/**
+ * Fluent builder for constructing CLI commands.
+ */
+export class CLICommandBuilder {
+    nameValue = "";
+    descriptionValue;
+    aliasesValue = [];
+    optionsValue = [];
+    argumentsValue = [];
+    commandsValue = [];
+    executeValue;
+    name(value) {
+        this.nameValue = value;
+        return this;
+    }
+    description(value) {
+        this.descriptionValue = value;
+        return this;
+    }
+    alias(value) {
+        this.aliasesValue.push(value);
+        return this;
+    }
+    aliases(values) {
+        this.aliasesValue.push(...values);
+        return this;
+    }
+    options(values) {
+        this.optionsValue = values ?? [];
+        return this;
+    }
+    arguments(values) {
+        this.argumentsValue = values ?? [];
+        return this;
+    }
+    commands(values) {
+        this.commandsValue = values ?? [];
+        return this;
+    }
+    execute(handler) {
+        this.executeValue = handler;
+        return this;
+    }
+    /** Builds the CLI command. */
+    build() {
+        if (!this.executeValue) {
+            throw new TypeError("A command execute handler is required.");
+        }
+        return createCommand({
+            name: this.nameValue,
+            description: this.descriptionValue,
+            aliases: this.aliasesValue,
+            options: this.optionsValue,
+            arguments: this.argumentsValue,
+            commands: this.commandsValue,
+            execute: this.executeValue,
+        });
+    }
+}
+//# sourceMappingURL=cliCommand.builder.js.map

package/dist/src/cliCommand/cliCommand.builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliCommand.builder.js","sourceRoot":"","sources":["../../../src/cliCommand/cliCommand.builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACpB,SAAS,GAAG,EAAE,CAAC;IACf,gBAAgB,CAAU;IAC1B,YAAY,GAAa,EAAE,CAAC;IAC5B,YAAY,GAA0B,EAAE,CAAC;IACzC,cAAc,GAA4B,EAAE,CAAC;IAC7C,aAAa,GAA2B,EAAE,CAAC;IAC3C,YAAY,CAAyB;IAEtC,IAAI,CAAC,KAAa;QACvB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,WAAW,CAAC,KAAa;QAC9B,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,KAAa;QACxB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,OAAO,CAAC,MAAyB;QACtC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,OAAO,CAAC,MAA6B;QAC1C,IAAI,CAAC,YAAY,GAAG,MAAM,IAAI,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,SAAS,CAAC,MAA+B;QAC9C,IAAI,CAAC,cAAc,GAAG,MAAM,IAAI,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,QAAQ,CAAC,MAA8B;QAC5C,IAAI,CAAC,aAAa,GAAG,MAAM,IAAI,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,OAAO,CAAC,OAA8B;QAC3C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8BAA8B;IACvB,KAAK;QACV,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,aAAa,CAAC;YACnB,IAAI,EAAE,IAAI,CAAC,SAAS;YACpB,WAAW,EAAE,IAAI,CAAC,gBAAgB;YAClC,OAAO,EAAE,IAAI,CAAC,YAAY;YAC1B,OAAO,EAAE,IAAI,CAAC,YAAY;YAC1B,SAAS,EAAE,IAAI,CAAC,cAAc;YAC9B,QAAQ,EAAE,IAAI,CAAC,aAAa;YAC5B,OAAO,EAAE,IAAI,CAAC,YAAY;SAC3B,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,13 @@
+/**
+ * zudojs-cli — Command Factory
+ *
+ * Factory functions for creating and executing CLI commands.
+ */
+import type { CLICommand, CLICommandDefinition, CLIContext } from "../cliType/cliType.type.js";
+/** Creates a validated CLICommand from a definition. */
+export declare function createCommand(definition: CLICommandDefinition): CLICommand;
+/** Shorthand factory for simple commands. */
+export declare function command(name: string, execute: CLICommand["execute"]): CLICommand;
+/** Executes a CLI command with the given context. */
+export declare function executeCommand(command: CLICommand, context: CLIContext): Promise<void>;
+//# sourceMappingURL=cliCommand.factory.d.ts.map

package/dist/src/cliCommand/cliCommand.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliCommand.factory.d.ts","sourceRoot":"","sources":["../../../src/cliCommand/cliCommand.factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,UAAU,EACX,MAAM,4BAA4B,CAAC;AAOpC,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,UAAU,EAAE,oBAAoB,GAAG,UAAU,CAQ1E;AAED,6CAA6C;AAC7C,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,GAC7B,UAAU,CAEZ;AAMD,qDAAqD;AACrD,wBAAsB,cAAc,CAClC,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/src/cliCommand/cliCommand.factory.js

@@ -0,0 +1,30 @@
+/**
+ * zudojs-cli — Command Factory
+ *
+ * Factory functions for creating and executing CLI commands.
+ */
+import { validateCommand } from "./cliCommand.validator.js";
+/* -------------------------------------------------------------------------- */
+/* Factory                                                                    */
+/* -------------------------------------------------------------------------- */
+/** Creates a validated CLICommand from a definition. */
+export function createCommand(definition) {
+    validateCommand(definition);
+    return {
+        ...definition,
+        name: definition.name.trim(),
+        aliases: definition.aliases?.map((alias) => alias.trim()).filter(Boolean),
+    };
+}
+/** Shorthand factory for simple commands. */
+export function command(name, execute) {
+    return createCommand({ name, execute });
+}
+/* -------------------------------------------------------------------------- */
+/* Execution                                                                  */
+/* -------------------------------------------------------------------------- */
+/** Executes a CLI command with the given context. */
+export async function executeCommand(command, context) {
+    await command.execute(context);
+}
+//# sourceMappingURL=cliCommand.factory.js.map

package/dist/src/cliCommand/cliCommand.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliCommand.factory.js","sourceRoot":"","sources":["../../../src/cliCommand/cliCommand.factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,UAAgC;IAC5D,eAAe,CAAC,UAAU,CAAC,CAAC;IAE5B,OAAO;QACL,GAAG,UAAU;QACb,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;QAC5B,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,OAAO,CACrB,IAAY,EACZ,OAA8B;IAE9B,OAAO,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAmB,EACnB,OAAmB;IAEnB,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * zudojs-cli — Command Registry
+ *
+ * Registry for managing CLI commands and their aliases.
+ */
+import type { CLICommand } from "../cliType/cliType.type.js";
+/**
+ * Manages registration, lookup, and unregistration of CLI commands.
+ */
+export declare class CLICommandRegistry {
+    private readonly commands;
+    private readonly aliases;
+    /** Registers a single command. */
+    register(command: CLICommand): this;
+    /** Registers multiple commands. */
+    registerMany(commands: readonly CLICommand[]): this;
+    /** Unregisters a command by name or alias. */
+    unregister(name: string): boolean;
+    /** Resolves a name (or alias) to a command. */
+    resolve(name: string): CLICommand | undefined;
+    /** Returns whether a command exists. */
+    has(name: string): boolean;
+    /** Returns all registered commands. */
+    list(): readonly CLICommand[];
+    /** Returns all registered command names. */
+    names(): readonly string[];
+    /** Returns a copy of the alias map. */
+    aliasesMap(): ReadonlyMap<string, string>;
+    /** Clears all registrations. */
+    clear(): void;
+    /** Returns the number of registered commands. */
+    get size(): number;
+}
+//# sourceMappingURL=cliCommand.registry.d.ts.map

package/dist/src/cliCommand/cliCommand.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliCommand.registry.d.ts","sourceRoot":"","sources":["../../../src/cliCommand/cliCommand.registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAO7D;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD,kCAAkC;IAC3B,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAyBzC;IAED,mCAAmC;IAC5B,YAAY,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI,CAKzD;IAED,8CAA8C;IACvC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAYvC;IAED,+CAA+C;IACxC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CASnD;IAED,wCAAwC;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhC;IAED,uCAAuC;IAChC,IAAI,IAAI,SAAS,UAAU,EAAE,CAEnC;IAED,4CAA4C;IACrC,KAAK,IAAI,SAAS,MAAM,EAAE,CAEhC;IAED,uCAAuC;IAChC,UAAU,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAE/C;IAED,gCAAgC;IACzB,KAAK,IAAI,IAAI,CAGnB;IAED,iDAAiD;IACjD,IAAW,IAAI,IAAI,MAAM,CAExB;CACF"}

package/dist/src/cliCommand/cliCommand.registry.js

@@ -0,0 +1,92 @@
+/**
+ * zudojs-cli — Command Registry
+ *
+ * Registry for managing CLI commands and their aliases.
+ */
+import { DuplicateCommandError } from "../cliError/cliError.command.js";
+/* -------------------------------------------------------------------------- */
+/* Command Registry                                                           */
+/* -------------------------------------------------------------------------- */
+/**
+ * Manages registration, lookup, and unregistration of CLI commands.
+ */
+export class CLICommandRegistry {
+    commands = new Map();
+    aliases = new Map();
+    /** Registers a single command. */
+    register(command) {
+        const name = command.name.trim();
+        if (this.commands.has(name) || this.aliases.has(name)) {
+            throw new DuplicateCommandError(name);
+        }
+        this.commands.set(name, command);
+        for (const alias of command.aliases ?? []) {
+            const normalizedAlias = alias.trim();
+            if (!normalizedAlias)
+                continue;
+            if (this.commands.has(normalizedAlias) ||
+                this.aliases.has(normalizedAlias)) {
+                this.commands.delete(name);
+                throw new DuplicateCommandError(normalizedAlias);
+            }
+            this.aliases.set(normalizedAlias, name);
+        }
+        return this;
+    }
+    /** Registers multiple commands. */
+    registerMany(commands) {
+        for (const command of commands) {
+            this.register(command);
+        }
+        return this;
+    }
+    /** Unregisters a command by name or alias. */
+    unregister(name) {
+        const normalized = name.trim();
+        const resolved = this.resolve(normalized);
+        if (!resolved)
+            return false;
+        this.commands.delete(resolved.name);
+        for (const alias of resolved.aliases ?? []) {
+            this.aliases.delete(alias);
+        }
+        return true;
+    }
+    /** Resolves a name (or alias) to a command. */
+    resolve(name) {
+        const normalized = name.trim();
+        const direct = this.commands.get(normalized);
+        if (direct)
+            return direct;
+        const canonical = this.aliases.get(normalized);
+        if (!canonical)
+            return undefined;
+        return this.commands.get(canonical);
+    }
+    /** Returns whether a command exists. */
+    has(name) {
+        return Boolean(this.resolve(name));
+    }
+    /** Returns all registered commands. */
+    list() {
+        return Array.from(this.commands.values());
+    }
+    /** Returns all registered command names. */
+    names() {
+        return Array.from(this.commands.keys());
+    }
+    /** Returns a copy of the alias map. */
+    aliasesMap() {
+        return new Map(this.aliases);
+    }
+    /** Clears all registrations. */
+    clear() {
+        this.commands.clear();
+        this.aliases.clear();
+    }
+    /** Returns the number of registered commands. */
+    get size() {
+        return this.commands.size;
+    }
+}
+//# sourceMappingURL=cliCommand.registry.js.map

package/dist/src/cliCommand/cliCommand.registry.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * zudojs-cli — Command Validator
+ *
+ * Validation logic and utility functions for CLI commands.
+ */
+import type { CLICommand } from "../cliType/cliType.type.js";
+/** Validates a CLI command definition. */
+export declare function validateCommand(command: CLICommand): void;
+/** Type guard for CLICommand. */
+export declare function isCLICommand(value: unknown): value is CLICommand;
+/** Returns a sorted copy of the commands array. */
+export declare function sortCommands(commands: readonly CLICommand[]): CLICommand[];
+//# sourceMappingURL=cliCommand.validator.d.ts.map

package/dist/src/cliCommand/cliCommand.validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliCommand.validator.d.ts","sourceRoot":"","sources":["../../../src/cliCommand/cliCommand.validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAU7D,0CAA0C;AAC1C,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAiDzD;AAMD,iCAAiC;AACjC,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAOhE;AAED,mDAAmD;AACnD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,CAE1E"}

package/dist/src/cliCommand/cliCommand.validator.js

@@ -0,0 +1,60 @@
+/**
+ * zudojs-cli — Command Validator
+ *
+ * Validation logic and utility functions for CLI commands.
+ */
+import { InvalidCommandNameError, DuplicateCommandError, } from "../cliError/cliError.command.js";
+/* -------------------------------------------------------------------------- */
+/* Validation                                                                 */
+/* -------------------------------------------------------------------------- */
+/** Validates a CLI command definition. */
+export function validateCommand(command) {
+    if (!command || typeof command !== "object") {
+        throw new TypeError("CLI command must be an object.");
+    }
+    if (typeof command.name !== "string" || !command.name.trim()) {
+        throw new InvalidCommandNameError(String(command.name ?? ""));
+    }
+    if (!/^[a-zA-Z0-9][a-zA-Z0-9:_-]*$/.test(command.name.trim())) {
+        throw new InvalidCommandNameError(command.name);
+    }
+    if (command.description !== undefined &&
+        typeof command.description !== "string") {
+        throw new TypeError(`Description for command "${command.name}" must be a string.`);
+    }
+    if (command.aliases) {
+        const seen = new Set();
+        for (const alias of command.aliases) {
+            if (typeof alias !== "string" || !alias.trim()) {
+                throw new InvalidCommandNameError(String(alias));
+            }
+            const normalized = alias.trim();
+            if (normalized === command.name.trim()) {
+                throw new DuplicateCommandError(normalized);
+            }
+            if (seen.has(normalized)) {
+                throw new DuplicateCommandError(normalized);
+            }
+            seen.add(normalized);
+        }
+    }
+    if (typeof command.execute !== "function") {
+        throw new TypeError(`Command "${command.name}" must define an execute function.`);
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Utilities                                                                  */
+/* -------------------------------------------------------------------------- */
+/** Type guard for CLICommand. */
+export function isCLICommand(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const candidate = value;
+    return (typeof candidate.name === "string" &&
+        typeof candidate.execute === "function");
+}
+/** Returns a sorted copy of the commands array. */
+export function sortCommands(commands) {
+    return [...commands].sort((a, b) => a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=cliCommand.validator.js.map

package/dist/src/cliCommand/cliCommand.validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliCommand.validator.js","sourceRoot":"","sources":["../../../src/cliCommand/cliCommand.validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AAEzC,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,0CAA0C;AAC1C,MAAM,UAAU,eAAe,CAAC,OAAmB;IACjD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7D,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,uBAAuB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,IACE,OAAO,CAAC,WAAW,KAAK,SAAS;QACjC,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,EACvC,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,4BAA4B,OAAO,CAAC,IAAI,qBAAqB,CAC9D,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/B,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC/C,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACnD,CAAC;YAED,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAEhC,IAAI,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBACvC,MAAM,IAAI,qBAAqB,CAAC,UAAU,CAAC,CAAC;YAC9C,CAAC;YAED,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,qBAAqB,CAAC,UAAU,CAAC,CAAC;YAC9C,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAC1C,MAAM,IAAI,SAAS,CACjB,YAAY,OAAO,CAAC,IAAI,oCAAoC,CAC7D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,iCAAiC;AACjC,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,SAAS,GAAG,KAA4B,CAAC;IAC/C,OAAO,CACL,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;QAClC,OAAO,SAAS,CAAC,OAAO,KAAK,UAAU,CACxC,CAAC;AACJ,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,YAAY,CAAC,QAA+B;IAC1D,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACpE,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * zudojs-cli — CLI Commands
+ *
+ * Command registry, builder, factory, and validation utilities.
+ */
+export { CLICommandRegistry } from "./cliCommand.registry.js";
+export { CLICommandBuilder } from "./cliCommand.builder.js";
+export { createCommand, command, executeCommand, } from "./cliCommand.factory.js";
+export { validateCommand, isCLICommand, sortCommands, } from "./cliCommand.validator.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cliCommand/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACL,aAAa,EACb,OAAO,EACP,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,eAAe,EACf,YAAY,EACZ,YAAY,GACb,MAAM,2BAA2B,CAAC"}

package/dist/src/cliCommand/index.js

@@ -0,0 +1,10 @@
+/**
+ * zudojs-cli — CLI Commands
+ *
+ * Command registry, builder, factory, and validation utilities.
+ */
+export { CLICommandRegistry } from "./cliCommand.registry.js";
+export { CLICommandBuilder } from "./cliCommand.builder.js";
+export { createCommand, command, executeCommand, } from "./cliCommand.factory.js";
+export { validateCommand, isCLICommand, sortCommands, } from "./cliCommand.validator.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cliCommand/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACL,aAAa,EACb,OAAO,EACP,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,eAAe,EACf,YAAY,EACZ,YAAY,GACb,MAAM,2BAA2B,CAAC"}

package/dist/src/cliConstant/cliConstant.value.d.ts

@@ -0,0 +1,114 @@
+/**
+ * zudojs-cli — CLI Constants
+ *
+ * Default values, limits, and magic strings used across the CLI package.
+ */
+/** CLI application name. */
+export declare const CLI_NAME = "zudojs";
+/** Default application configuration. */
+export declare const CLI_DEFAULTS: {
+    readonly NAME: "zudojs";
+    readonly VERSION: "0.1.0";
+    readonly DESCRIPTION: "Command-line interface for the Zudojs framework.";
+    readonly COMMAND_PREFIX: "zudojs";
+    readonly DEFAULT_CWD: string;
+    readonly EXIT_CODE: 0;
+};
+/** Built-in command names. */
+export declare const CLI_COMMANDS: {
+    readonly HELP: "help";
+    readonly VERSION: "version";
+};
+/** Built-in command aliases. */
+export declare const CLI_ALIASES: {
+    readonly HELP: readonly ["-h", "--help"];
+    readonly VERSION: readonly ["-v", "--version"];
+};
+/** Characters used to prefix options. */
+export declare const CLI_OPTION_PREFIXES: {
+    readonly SHORT: "-";
+    readonly LONG: "--";
+    readonly VALUE_SEPARATOR: "=";
+};
+/** Internal symbolic names for CLI elements. */
+export declare const CLI_SYMBOLS: {
+    readonly COMMAND: "command";
+    readonly OPTION: "option";
+    readonly ARGUMENT: "argument";
+    readonly HELP: "help";
+    readonly VERSION: "version";
+};
+/** Standard CLI messages. */
+export declare const CLI_MESSAGES: {
+    readonly COMMAND_NOT_FOUND: "Command not found.";
+    readonly INVALID_ARGUMENTS: "Invalid command arguments.";
+    readonly PERMISSION_DENIED: "Permission denied.";
+    readonly INTERRUPTED: "Process interrupted.";
+    readonly UNKNOWN_ERROR: "An unexpected error occurred.";
+    readonly MISSING_COMMAND: "A command is required.";
+};
+/** Labels used in help output. */
+export declare const CLI_HELP: {
+    readonly USAGE: "Usage:";
+    readonly COMMANDS: "Commands:";
+    readonly OPTIONS: "Options:";
+    readonly ARGUMENTS: "Arguments:";
+    readonly ALIASES: "Aliases:";
+    readonly DESCRIPTION: "Description:";
+    readonly EXAMPLES: "Examples:";
+};
+/** Environment variable names. */
+export declare const CLI_ENVIRONMENT: {
+    readonly NODE_ENV: "NODE_ENV";
+    readonly DEBUG: "DEBUG";
+    readonly CI: "CI";
+};
+/** Formatting constants. */
+export declare const CLI_FORMAT: {
+    readonly INDENT: "  ";
+    readonly COMMAND_INDENT: "    ";
+    readonly OPTION_INDENT: "    ";
+    readonly NEWLINE: "\n";
+    readonly EMPTY: "";
+};
+/** Validation limits. */
+export declare const CLI_LIMITS: {
+    readonly MAX_COMMAND_NAME_LENGTH: 100;
+    readonly MAX_DESCRIPTION_LENGTH: 500;
+    readonly MAX_ALIAS_LENGTH: 50;
+    readonly MAX_OPTION_NAME_LENGTH: 100;
+    readonly MAX_ARGUMENT_NAME_LENGTH: 100;
+};
+/** CLI-specific error code constants. */
+export declare const CLI_ERROR_CODES: {
+    readonly COMMAND_NOT_FOUND: "CLI_COMMAND_NOT_FOUND";
+    readonly INVALID_ARGUMENTS: "CLI_INVALID_ARGUMENTS";
+    readonly INVALID_OPTION: "CLI_INVALID_OPTION";
+    readonly MISSING_ARGUMENT: "CLI_MISSING_ARGUMENT";
+    readonly MISSING_OPTION_VALUE: "CLI_MISSING_OPTION_VALUE";
+    readonly DUPLICATE_COMMAND: "CLI_DUPLICATE_COMMAND";
+    readonly DUPLICATE_OPTION: "CLI_DUPLICATE_OPTION";
+    readonly INVALID_COMMAND_NAME: "CLI_INVALID_COMMAND_NAME";
+    readonly INVALID_OPTION_NAME: "CLI_INVALID_OPTION_NAME";
+    readonly EXECUTION_FAILED: "CLI_EXECUTION_FAILED";
+    readonly INTERRUPTED: "CLI_INTERRUPTED";
+    readonly PERMISSION_DENIED: "CLI_PERMISSION_DENIED";
+    readonly CONFIGURATION_ERROR: "CLI_CONFIGURATION_ERROR";
+    readonly UNKNOWN_ERROR: "CLI_UNKNOWN_ERROR";
+};
+/** CLI exit codes. */
+export declare const CLI_EXIT_CODES: {
+    readonly SUCCESS: 0;
+    readonly GENERAL_ERROR: 1;
+    readonly INVALID_ARGUMENTS: 2;
+    readonly COMMAND_NOT_FOUND: 3;
+    readonly PERMISSION_DENIED: 4;
+    readonly INTERRUPTED: 130;
+};
+/** CLI exit code type. */
+export type CLIExitCode = (typeof CLI_EXIT_CODES)[keyof typeof CLI_EXIT_CODES];
+/** CLI error code type. */
+export type CLIErrorCode = (typeof CLI_ERROR_CODES)[keyof typeof CLI_ERROR_CODES];
+/** CLI command name type. */
+export type CLICommandName = (typeof CLI_COMMANDS)[keyof typeof CLI_COMMANDS];
+//# sourceMappingURL=cliConstant.value.d.ts.map

package/dist/src/cliConstant/cliConstant.value.d.ts.map

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

package/dist/src/cliConstant/cliConstant.value.js

@@ -0,0 +1,138 @@
+/**
+ * zudojs-cli — CLI Constants
+ *
+ * Default values, limits, and magic strings used across the CLI package.
+ */
+/* -------------------------------------------------------------------------- */
+/* Application Defaults                                                       */
+/* -------------------------------------------------------------------------- */
+/** CLI application name. */
+export const CLI_NAME = "zudojs";
+/** Default application configuration. */
+export const CLI_DEFAULTS = {
+    NAME: "zudojs",
+    VERSION: "0.1.0",
+    DESCRIPTION: "Command-line interface for the Zudojs framework.",
+    COMMAND_PREFIX: "zudojs",
+    DEFAULT_CWD: process.cwd(),
+    EXIT_CODE: 0,
+};
+/* -------------------------------------------------------------------------- */
+/* Built-in Commands                                                          */
+/* -------------------------------------------------------------------------- */
+/** Built-in command names. */
+export const CLI_COMMANDS = {
+    HELP: "help",
+    VERSION: "version",
+};
+/** Built-in command aliases. */
+export const CLI_ALIASES = {
+    HELP: ["-h", "--help"],
+    VERSION: ["-v", "--version"],
+};
+/* -------------------------------------------------------------------------- */
+/* Option Prefixes                                                            */
+/* -------------------------------------------------------------------------- */
+/** Characters used to prefix options. */
+export const CLI_OPTION_PREFIXES = {
+    SHORT: "-",
+    LONG: "--",
+    VALUE_SEPARATOR: "=",
+};
+/* -------------------------------------------------------------------------- */
+/* Symbolic Names                                                             */
+/* -------------------------------------------------------------------------- */
+/** Internal symbolic names for CLI elements. */
+export const CLI_SYMBOLS = {
+    COMMAND: "command",
+    OPTION: "option",
+    ARGUMENT: "argument",
+    HELP: "help",
+    VERSION: "version",
+};
+/* -------------------------------------------------------------------------- */
+/* User-Facing Messages                                                       */
+/* -------------------------------------------------------------------------- */
+/** Standard CLI messages. */
+export const CLI_MESSAGES = {
+    COMMAND_NOT_FOUND: "Command not found.",
+    INVALID_ARGUMENTS: "Invalid command arguments.",
+    PERMISSION_DENIED: "Permission denied.",
+    INTERRUPTED: "Process interrupted.",
+    UNKNOWN_ERROR: "An unexpected error occurred.",
+    MISSING_COMMAND: "A command is required.",
+};
+/* -------------------------------------------------------------------------- */
+/* Help Labels                                                                */
+/* -------------------------------------------------------------------------- */
+/** Labels used in help output. */
+export const CLI_HELP = {
+    USAGE: "Usage:",
+    COMMANDS: "Commands:",
+    OPTIONS: "Options:",
+    ARGUMENTS: "Arguments:",
+    ALIASES: "Aliases:",
+    DESCRIPTION: "Description:",
+    EXAMPLES: "Examples:",
+};
+/* -------------------------------------------------------------------------- */
+/* Environment                                                                */
+/* -------------------------------------------------------------------------- */
+/** Environment variable names. */
+export const CLI_ENVIRONMENT = {
+    NODE_ENV: "NODE_ENV",
+    DEBUG: "DEBUG",
+    CI: "CI",
+};
+/* -------------------------------------------------------------------------- */
+/* Formatting                                                                 */
+/* -------------------------------------------------------------------------- */
+/** Formatting constants. */
+export const CLI_FORMAT = {
+    INDENT: "  ",
+    COMMAND_INDENT: "    ",
+    OPTION_INDENT: "    ",
+    NEWLINE: "\n",
+    EMPTY: "",
+};
+/* -------------------------------------------------------------------------- */
+/* Limits                                                                     */
+/* -------------------------------------------------------------------------- */
+/** Validation limits. */
+export const CLI_LIMITS = {
+    MAX_COMMAND_NAME_LENGTH: 100,
+    MAX_DESCRIPTION_LENGTH: 500,
+    MAX_ALIAS_LENGTH: 50,
+    MAX_OPTION_NAME_LENGTH: 100,
+    MAX_ARGUMENT_NAME_LENGTH: 100,
+};
+/* -------------------------------------------------------------------------- */
+/* Error Codes                                                                */
+/* -------------------------------------------------------------------------- */
+/** CLI-specific error code constants. */
+export const CLI_ERROR_CODES = {
+    COMMAND_NOT_FOUND: "CLI_COMMAND_NOT_FOUND",
+    INVALID_ARGUMENTS: "CLI_INVALID_ARGUMENTS",
+    INVALID_OPTION: "CLI_INVALID_OPTION",
+    MISSING_ARGUMENT: "CLI_MISSING_ARGUMENT",
+    MISSING_OPTION_VALUE: "CLI_MISSING_OPTION_VALUE",
+    DUPLICATE_COMMAND: "CLI_DUPLICATE_COMMAND",
+    DUPLICATE_OPTION: "CLI_DUPLICATE_OPTION",
+    INVALID_COMMAND_NAME: "CLI_INVALID_COMMAND_NAME",
+    INVALID_OPTION_NAME: "CLI_INVALID_OPTION_NAME",
+    EXECUTION_FAILED: "CLI_EXECUTION_FAILED",
+    INTERRUPTED: "CLI_INTERRUPTED",
+    PERMISSION_DENIED: "CLI_PERMISSION_DENIED",
+    CONFIGURATION_ERROR: "CLI_CONFIGURATION_ERROR",
+    UNKNOWN_ERROR: "CLI_UNKNOWN_ERROR",
+};
+/** CLI exit codes. */
+export const CLI_EXIT_CODES = {
+    SUCCESS: 0,
+    GENERAL_ERROR: 1,
+    INVALID_ARGUMENTS: 2,
+    COMMAND_NOT_FOUND: 3,
+    PERMISSION_DENIED: 4,
+    INTERRUPTED: 130,
+};
+//# sourceMappingURL=cliConstant.value.js.map