zudojs-cli 0.0.1

package/dist/src/cliError/cliError.option.js

@@ -0,0 +1,84 @@
+/**
+ * zudojs-cli — Option Errors
+ *
+ * Error classes for option validation failures.
+ */
+import { ConflictError } from "@zudojs/errors";
+import { CLIError } from "./cliError.base.js";
+import { CLI_ERROR_CODES, CLI_EXIT_CODES, } from "../cliConstant/cliConstant.value.js";
+/* -------------------------------------------------------------------------- */
+/* Invalid Option                                                             */
+/* -------------------------------------------------------------------------- */
+/**
+ * Thrown when an unknown or invalid option is encountered.
+ */
+export class InvalidOptionError extends CLIError {
+    constructor(option, command) {
+        super(`Unknown or invalid option "${option}".`, {
+            code: CLI_ERROR_CODES.INVALID_OPTION,
+            exitCode: CLI_EXIT_CODES.INVALID_ARGUMENTS,
+            command,
+            option,
+            statusCode: 400,
+        });
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Invalid Option Name                                                        */
+/* -------------------------------------------------------------------------- */
+/**
+ * Thrown when an option name fails validation.
+ */
+export class InvalidOptionNameError extends CLIError {
+    constructor(option) {
+        super(`Invalid option name "${option}".`, {
+            code: CLI_ERROR_CODES.INVALID_OPTION_NAME,
+            exitCode: CLI_EXIT_CODES.INVALID_ARGUMENTS,
+            option,
+            statusCode: 400,
+        });
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Missing Option Value                                                       */
+/* -------------------------------------------------------------------------- */
+/**
+ * Thrown when a required option value is missing.
+ */
+export class MissingOptionValueError extends CLIError {
+    constructor(option, command) {
+        super(`Option "${option}" requires a value.`, {
+            code: CLI_ERROR_CODES.MISSING_OPTION_VALUE,
+            exitCode: CLI_EXIT_CODES.INVALID_ARGUMENTS,
+            command,
+            option,
+            statusCode: 400,
+        });
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Duplicate Option                                                           */
+/* -------------------------------------------------------------------------- */
+/**
+ * Thrown when an option name is already registered.
+ * Extends `ConflictError` from `@zudojs/errors`.
+ */
+export class DuplicateOptionError extends ConflictError {
+    exitCode;
+    constructor(option) {
+        super(`Option "${option}" is already registered.`, {
+            code: CLI_ERROR_CODES.DUPLICATE_OPTION,
+            statusCode: 409,
+            expose: true,
+            metadata: { option },
+        });
+        this.exitCode = CLI_EXIT_CODES.INVALID_ARGUMENTS;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            exitCode: this.exitCode,
+        };
+    }
+}
+//# sourceMappingURL=cliError.option.js.map

package/dist/src/cliError/cliError.option.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliError.option.js","sourceRoot":"","sources":["../../../src/cliError/cliError.option.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EACL,eAAe,EACf,cAAc,GACf,MAAM,qCAAqC,CAAC;AAE7C,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,MAAc,EAAE,OAAgB;QAC1C,KAAK,CAAC,8BAA8B,MAAM,IAAI,EAAE;YAC9C,IAAI,EAAE,eAAe,CAAC,cAAc;YACpC,QAAQ,EAAE,cAAc,CAAC,iBAAiB;YAC1C,OAAO;YACP,MAAM;YACN,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;CACF;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,QAAQ;IAClD,YAAY,MAAc;QACxB,KAAK,CAAC,wBAAwB,MAAM,IAAI,EAAE;YACxC,IAAI,EAAE,eAAe,CAAC,mBAAmB;YACzC,QAAQ,EAAE,cAAc,CAAC,iBAAiB;YAC1C,MAAM;YACN,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;CACF;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,QAAQ;IACnD,YAAY,MAAc,EAAE,OAAgB;QAC1C,KAAK,CAAC,WAAW,MAAM,qBAAqB,EAAE;YAC5C,IAAI,EAAE,eAAe,CAAC,oBAAoB;YAC1C,QAAQ,EAAE,cAAc,CAAC,iBAAiB;YAC1C,OAAO;YACP,MAAM;YACN,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;CACF;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IACrC,QAAQ,CAAS;IAEjC,YAAY,MAAc;QACxB,KAAK,CAAC,WAAW,MAAM,0BAA0B,EAAE;YACjD,IAAI,EAAE,eAAe,CAAC,gBAAgB;YACtC,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,EAAE,MAAM,EAAE;SACrB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC,iBAAiB,CAAC;IACnD,CAAC;IAEe,MAAM;QACpB,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,11 @@
+/**
+ * zudojs-cli — CLI Errors
+ *
+ * All CLI error types re-exported from their respective files.
+ */
+export { CLIError, isCLIError, normalizeCLIError, getCLIExitCode, getCLIErrorCode, type CLIErrorOptions, } from "./cliError.base.js";
+export { CommandNotFoundError, DuplicateCommandError, InvalidCommandNameError, } from "./cliError.command.js";
+export { InvalidArgumentsError, MissingArgumentError, } from "./cliError.argument.js";
+export { InvalidOptionError, InvalidOptionNameError, MissingOptionValueError, DuplicateOptionError, } from "./cliError.option.js";
+export { CLIExecutionError, CLIPermissionError, CLIInterruptedError, CLIConfigurationError, } from "./cliError.execution.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cliError/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC"}

package/dist/src/cliError/index.js

@@ -0,0 +1,11 @@
+/**
+ * zudojs-cli — CLI Errors
+ *
+ * All CLI error types re-exported from their respective files.
+ */
+export { CLIError, isCLIError, normalizeCLIError, getCLIExitCode, getCLIErrorCode, } from "./cliError.base.js";
+export { CommandNotFoundError, DuplicateCommandError, InvalidCommandNameError, } from "./cliError.command.js";
+export { InvalidArgumentsError, MissingArgumentError, } from "./cliError.argument.js";
+export { InvalidOptionError, InvalidOptionNameError, MissingOptionValueError, DuplicateOptionError, } from "./cliError.option.js";
+export { CLIExecutionError, CLIPermissionError, CLIInterruptedError, CLIConfigurationError, } from "./cliError.execution.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cliError/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,GAEhB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * zudojs-cli — CLI Parser
+ *
+ * Parses CLI arguments into structured commands, options, and positional
+ * arguments. Delegates option parsing to longOption and shortOption modules.
+ */
+import type { CLIArguments, CLICommand, ParsedCLIInput } from "../cliType/cliType.type.js";
+/** Configuration for the CLI parser. */
+export interface CLIParserOptions {
+    readonly allowUnknownOptions?: boolean;
+    readonly allowUnknownCommands?: boolean;
+    readonly stopAtFirstArgument?: boolean;
+}
+/**
+ * Parses CLI arguments into structured input.
+ */
+export declare class CLIParser {
+    private readonly allowUnknownOptions;
+    private readonly allowUnknownCommands;
+    private readonly stopAtFirstArgument;
+    constructor(options?: CLIParserOptions);
+    /** Parses an argument array into structured CLI input. */
+    parse(args: CLIArguments, command?: CLICommand): ParsedCLIInput;
+    private parseArguments;
+}
+//# sourceMappingURL=cliParser.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cliParser.core.d.ts","sourceRoot":"","sources":["../../../src/cliParser/cliParser.core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAEV,YAAY,EACZ,UAAU,EAEV,cAAc,EACf,MAAM,4BAA4B,CAAC;AAUpC,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACxC;AAMD;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAE9C,YAAY,OAAO,GAAE,gBAAqB,EAIzC;IAED,0DAA0D;IACnD,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,cAAc,CA6ErE;IAID,OAAO,CAAC,cAAc;CAgDvB"}

package/dist/src/cliParser/cliParser.core.js

@@ -0,0 +1,112 @@
+/**
+ * zudojs-cli — CLI Parser
+ *
+ * Parses CLI arguments into structured commands, options, and positional
+ * arguments. Delegates option parsing to longOption and shortOption modules.
+ */
+import { InvalidArgumentsError } from "../cliError/cliError.argument.js";
+import { isOption, isLongOption, isShortOption } from "./cliParser.helper.js";
+import { parseLongOption } from "./cliParser.longOption.js";
+import { parseShortOption } from "./cliParser.shortOption.js";
+/* -------------------------------------------------------------------------- */
+/* Parser                                                                     */
+/* -------------------------------------------------------------------------- */
+/**
+ * Parses CLI arguments into structured input.
+ */
+export class CLIParser {
+    allowUnknownOptions;
+    allowUnknownCommands;
+    stopAtFirstArgument;
+    constructor(options = {}) {
+        this.allowUnknownOptions = options.allowUnknownOptions ?? false;
+        this.allowUnknownCommands = options.allowUnknownCommands ?? false;
+        this.stopAtFirstArgument = options.stopAtFirstArgument ?? false;
+    }
+    /** Parses an argument array into structured CLI input. */
+    parse(args, command) {
+        const tokens = Array.from(args);
+        const commands = [];
+        const positional = [];
+        const options = {};
+        const definitions = command?.options ?? [];
+        const argumentsDefinitions = command?.arguments ?? [];
+        let index = 0;
+        while (index < tokens.length) {
+            const token = tokens[index];
+            if (token === "--") {
+                positional.push(...tokens.slice(index + 1));
+                break;
+            }
+            if (isLongOption(token)) {
+                index = parseLongOption(tokens, index, definitions, options, this.allowUnknownOptions);
+                continue;
+            }
+            if (isShortOption(token)) {
+                index = parseShortOption(tokens, index, definitions, options, this.allowUnknownOptions);
+                continue;
+            }
+            if (!this.stopAtFirstArgument &&
+                !command &&
+                commands.length === 0 &&
+                positional.length === 0) {
+                commands.push(token);
+                index++;
+                continue;
+            }
+            positional.push(token);
+            index++;
+        }
+        const parsedArguments = this.parseArguments(positional, argumentsDefinitions);
+        if (!this.allowUnknownCommands &&
+            !command &&
+            commands.length === 0 &&
+            tokens.length > 0) {
+            const firstToken = tokens.find((value) => !isOption(value));
+            if (firstToken) {
+                commands.push(firstToken);
+            }
+        }
+        return {
+            command: commands[0],
+            commands,
+            args: positional,
+            options: { ...options, ...parsedArguments },
+        };
+    }
+    /* ---- Arguments ---- */
+    parseArguments(values, definitions) {
+        const result = {};
+        if (definitions.length === 0)
+            return result;
+        let valueIndex = 0;
+        for (const definition of definitions) {
+            if (definition.variadic) {
+                const remaining = values.slice(valueIndex);
+                if (definition.required && remaining.length === 0) {
+                    throw new InvalidArgumentsError(`Missing required argument "${definition.name}".`);
+                }
+                result[definition.name] = remaining;
+                valueIndex = values.length;
+                continue;
+            }
+            const value = values[valueIndex];
+            if (value === undefined) {
+                if (definition.required) {
+                    throw new InvalidArgumentsError(`Missing required argument "${definition.name}".`);
+                }
+                if (definition.defaultValue !== undefined) {
+                    result[definition.name] = definition.defaultValue;
+                }
+                continue;
+            }
+            result[definition.name] = value;
+            valueIndex++;
+        }
+        if (valueIndex < values.length) {
+            throw new InvalidArgumentsError(`Unexpected argument "${values[valueIndex]}".`);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=cliParser.core.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cliParser.core.js","sourceRoot":"","sources":["../../../src/cliParser/cliParser.core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAa9D,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF;;GAEG;AACH,MAAM,OAAO,SAAS;IACH,mBAAmB,CAAU;IAC7B,oBAAoB,CAAU;IAC9B,mBAAmB,CAAU;IAE9C,YAAY,OAAO,GAAqB,EAAE;QACxC,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,IAAI,KAAK,CAAC;QAChE,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,KAAK,CAAC;QAClE,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,IAAI,KAAK,CAAC;IAClE,CAAC;IAED,0DAA0D;IACnD,KAAK,CAAC,IAAkB,EAAE,OAAoB;QACnD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,OAAO,GAA4B,EAAE,CAAC;QAC5C,MAAM,WAAW,GAAG,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;QAC3C,MAAM,oBAAoB,GAAG,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC;QAEtD,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,OAAO,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAE,CAAC;YAE7B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC5C,MAAM;YACR,CAAC;YAED,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,KAAK,GAAG,eAAe,CACrB,MAAM,EACN,KAAK,EACL,WAAW,EACX,OAAO,EACP,IAAI,CAAC,mBAAmB,CACzB,CAAC;gBACF,SAAS;YACX,CAAC;YAED,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,GAAG,gBAAgB,CACtB,MAAM,EACN,KAAK,EACL,WAAW,EACX,OAAO,EACP,IAAI,CAAC,mBAAmB,CACzB,CAAC;gBACF,SAAS;YACX,CAAC;YAED,IACE,CAAC,IAAI,CAAC,mBAAmB;gBACzB,CAAC,OAAO;gBACR,QAAQ,CAAC,MAAM,KAAK,CAAC;gBACrB,UAAU,CAAC,MAAM,KAAK,CAAC,EACvB,CAAC;gBACD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACrB,KAAK,EAAE,CAAC;gBACR,SAAS;YACX,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,KAAK,EAAE,CAAC;QACV,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,CACzC,UAAU,EACV,oBAAoB,CACrB,CAAC;QAEF,IACE,CAAC,IAAI,CAAC,oBAAoB;YAC1B,CAAC,OAAO;YACR,QAAQ,CAAC,MAAM,KAAK,CAAC;YACrB,MAAM,CAAC,MAAM,GAAG,CAAC,EACjB,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5D,IAAI,UAAU,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;YACpB,QAAQ;YACR,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,eAAe,EAAe;SACzD,CAAC;IACJ,CAAC;IAED,yBAAyB;IAEjB,cAAc,CACpB,MAAyB,EACzB,WAAmC;QAEnC,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QAE5C,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;gBACxB,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC3C,IAAI,UAAU,CAAC,QAAQ,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAClD,MAAM,IAAI,qBAAqB,CAC7B,8BAA8B,UAAU,CAAC,IAAI,IAAI,CAClD,CAAC;gBACJ,CAAC;gBACD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;gBACpC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;gBAC3B,SAAS;YACX,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;YAEjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;oBACxB,MAAM,IAAI,qBAAqB,CAC7B,8BAA8B,UAAU,CAAC,IAAI,IAAI,CAClD,CAAC;gBACJ,CAAC;gBACD,IAAI,UAAU,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;oBAC1C,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC;gBACpD,CAAC;gBACD,SAAS;YACX,CAAC;YAED,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YAChC,UAAU,EAAE,CAAC;QACf,CAAC;QAED,IAAI,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,IAAI,qBAAqB,CAC7B,wBAAwB,MAAM,CAAC,UAAU,CAAC,IAAI,CAC/C,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/src/cliParser/cliParser.helper.d.ts

@@ -0,0 +1,24 @@
+/**
+ * zudojs-cli — Parser Helpers
+ *
+ * Utility functions for parsing CLI arguments, options, and values.
+ */
+import type { CLIArguments, CLICommand, CLIOption, CLIValue, ParsedCLIInput } from "../cliType/cliType.type.js";
+import { type CLIParserOptions } from "./cliParser.core.js";
+/** Convenience function to parse CLI arguments. */
+export declare function parseCLIArguments(args: CLIArguments, command?: CLICommand, options?: CLIParserOptions): ParsedCLIInput;
+/** Parses a raw string value according to an option definition. */
+export declare function parseOptionValue(definition: CLIOption, value: string): CLIValue;
+/** Parses a string into a boolean. */
+export declare function parseBoolean(value: string, option?: string): boolean;
+/** Returns whether a token is any option (short or long). */
+export declare function isOption(token: string): boolean;
+/** Returns whether a token is a long option (e.g. `--verbose`). */
+export declare function isLongOption(token: string): boolean;
+/** Returns whether a token is a short option (e.g. `-v`). */
+export declare function isShortOption(token: string): boolean;
+/** Resolves a command name to a CLICommand. */
+export declare function resolveCommand(commands: readonly CLICommand[], name: string): CLICommand | undefined;
+/** Normalizes an unknown value into a CLIValue. */
+export declare function normalizeCLIValue(value: unknown): CLIValue;
+//# sourceMappingURL=cliParser.helper.d.ts.map

package/dist/src/cliParser/cliParser.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliParser.helper.d.ts","sourceRoot":"","sources":["../../../src/cliParser/cliParser.helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,SAAS,EACT,QAAQ,EACR,cAAc,EACf,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAMvE,mDAAmD;AACnD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,UAAU,EACpB,OAAO,CAAC,EAAE,gBAAgB,GACzB,cAAc,CAEhB;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,SAAS,EACrB,KAAK,EAAE,MAAM,GACZ,QAAQ,CAmBV;AAED,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAW,GAAG,OAAO,CAStE;AAMD,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKnD;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAMpD;AAMD,+CAA+C;AAC/C,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,SAAS,UAAU,EAAE,EAC/B,IAAI,EAAE,MAAM,GACX,UAAU,GAAG,SAAS,CAKxB;AAMD,mDAAmD;AACnD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAU1D"}

package/dist/src/cliParser/cliParser.helper.js

@@ -0,0 +1,84 @@
+/**
+ * zudojs-cli — Parser Helpers
+ *
+ * Utility functions for parsing CLI arguments, options, and values.
+ */
+import { CLI_OPTION_PREFIXES } from "../cliConstant/cliConstant.value.js";
+import { InvalidArgumentsError } from "../cliError/cliError.argument.js";
+import { CLIParser } from "./cliParser.core.js";
+/* -------------------------------------------------------------------------- */
+/* Parsing Helpers                                                            */
+/* -------------------------------------------------------------------------- */
+/** Convenience function to parse CLI arguments. */
+export function parseCLIArguments(args, command, options) {
+    return new CLIParser(options).parse(args, command);
+}
+/** Parses a raw string value according to an option definition. */
+export function parseOptionValue(definition, value) {
+    switch (definition.type) {
+        case "boolean":
+            return parseBoolean(value, definition.name);
+        case "number": {
+            const parsed = Number(value);
+            if (Number.isNaN(parsed)) {
+                throw new InvalidArgumentsError(`Option "${definition.name}" expects a number, received "${value}".`);
+            }
+            return parsed;
+        }
+        case "string":
+        default:
+            return value;
+    }
+}
+/** Parses a string into a boolean. */
+export function parseBoolean(value, option = "option") {
+    const normalized = value.trim().toLowerCase();
+    if (["true", "1", "yes", "on"].includes(normalized))
+        return true;
+    if (["false", "0", "no", "off"].includes(normalized))
+        return false;
+    throw new InvalidArgumentsError(`Option "${option}" expects a boolean value, received "${value}".`);
+}
+/* -------------------------------------------------------------------------- */
+/* Token Classification                                                       */
+/* -------------------------------------------------------------------------- */
+/** Returns whether a token is any option (short or long). */
+export function isOption(token) {
+    return ((token.startsWith(CLI_OPTION_PREFIXES.LONG) && token !== "--") ||
+        (token.startsWith(CLI_OPTION_PREFIXES.SHORT) &&
+            !token.startsWith(CLI_OPTION_PREFIXES.LONG) &&
+            token !== "-"));
+}
+/** Returns whether a token is a long option (e.g. `--verbose`). */
+export function isLongOption(token) {
+    return (token.startsWith(CLI_OPTION_PREFIXES.LONG) &&
+        token.length > CLI_OPTION_PREFIXES.LONG.length);
+}
+/** Returns whether a token is a short option (e.g. `-v`). */
+export function isShortOption(token) {
+    return (token.startsWith(CLI_OPTION_PREFIXES.SHORT) &&
+        !token.startsWith(CLI_OPTION_PREFIXES.LONG) &&
+        token.length > CLI_OPTION_PREFIXES.SHORT.length);
+}
+/* -------------------------------------------------------------------------- */
+/* Command Resolution                                                         */
+/* -------------------------------------------------------------------------- */
+/** Resolves a command name to a CLICommand. */
+export function resolveCommand(commands, name) {
+    const normalized = name.trim();
+    return commands.find((c) => c.name === normalized || c.aliases?.includes(normalized));
+}
+/* -------------------------------------------------------------------------- */
+/* Utility                                                                    */
+/* -------------------------------------------------------------------------- */
+/** Normalizes an unknown value into a CLIValue. */
+export function normalizeCLIValue(value) {
+    if (typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean" ||
+        value === undefined) {
+        return value;
+    }
+    return String(value);
+}
+//# sourceMappingURL=cliParser.helper.js.map

package/dist/src/cliParser/cliParser.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliParser.helper.js","sourceRoot":"","sources":["../../../src/cliParser/cliParser.helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,SAAS,EAAyB,MAAM,qBAAqB,CAAC;AAEvE,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,mDAAmD;AACnD,MAAM,UAAU,iBAAiB,CAC/B,IAAkB,EAClB,OAAoB,EACpB,OAA0B;IAE1B,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAC9B,UAAqB,EACrB,KAAa;IAEb,QAAQ,UAAU,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAE9C,KAAK,QAAQ,EAAE,CAAC;YACd,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,qBAAqB,CAC7B,WAAW,UAAU,CAAC,IAAI,iCAAiC,KAAK,IAAI,CACrE,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,QAAQ,CAAC;QACd;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,MAAM,GAAG,QAAQ;IAC3D,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE9C,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACjE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAEnE,MAAM,IAAI,qBAAqB,CAC7B,WAAW,MAAM,wCAAwC,KAAK,IAAI,CACnE,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,6DAA6D;AAC7D,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,CACL,CAAC,KAAK,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC;QAC9D,CAAC,KAAK,CAAC,UAAU,CAAC,mBAAmB,CAAC,KAAK,CAAC;YAC1C,CAAC,KAAK,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC;YAC3C,KAAK,KAAK,GAAG,CAAC,CACjB,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,CACL,KAAK,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC;QAC1C,KAAK,CAAC,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAC/C,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,CACL,KAAK,CAAC,UAAU,CAAC,mBAAmB,CAAC,KAAK,CAAC;QAC3C,CAAC,KAAK,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC;QAC3C,KAAK,CAAC,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAChD,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,+CAA+C;AAC/C,MAAM,UAAU,cAAc,CAC5B,QAA+B,EAC/B,IAAY;IAEZ,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/B,OAAO,QAAQ,CAAC,IAAI,CAClB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,CAChE,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,mDAAmD;AACnD,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS;QAC1B,KAAK,KAAK,SAAS,EACnB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/src/cliParser/cliParser.longOption.d.ts

@@ -0,0 +1,13 @@
+/**
+ * zudojs-cli — Long Option Parser
+ *
+ * Parses `--option`, `--option=value`, and `--no-option` style arguments.
+ */
+import type { CLIOption } from "../cliType/cliType.type.js";
+/** Parses a long option token from the token stream. */
+export declare function parseLongOption(tokens: readonly string[], index: number, definitions: readonly CLIOption[], values: Record<string, unknown>, allowUnknownOptions: boolean): number;
+/** Finds an option by name or short form. */
+export declare function findOption(name: string, definitions: readonly CLIOption[]): CLIOption | undefined;
+/** Assigns a parsed value to the option, handling multiples. */
+export declare function assignOptionValue(definition: CLIOption, rawValue: string, values: Record<string, unknown>): void;
+//# sourceMappingURL=cliParser.longOption.d.ts.map

package/dist/src/cliParser/cliParser.longOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliParser.longOption.d.ts","sourceRoot":"","sources":["../../../src/cliParser/cliParser.longOption.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAY5D,wDAAwD;AACxD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,SAAS,SAAS,EAAE,EACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,mBAAmB,EAAE,OAAO,GAC3B,MAAM,CAgER;AAED,6CAA6C;AAC7C,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,SAAS,SAAS,EAAE,GAChC,SAAS,GAAG,SAAS,CAEvB;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,SAAS,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAeN"}

package/dist/src/cliParser/cliParser.longOption.js

@@ -0,0 +1,86 @@
+/**
+ * zudojs-cli — Long Option Parser
+ *
+ * Parses `--option`, `--option=value`, and `--no-option` style arguments.
+ */
+import { CLI_OPTION_PREFIXES } from "../cliConstant/cliConstant.value.js";
+import { InvalidOptionError, MissingOptionValueError, } from "../cliError/cliError.option.js";
+import { isOption, parseBoolean, parseOptionValue, } from "./cliParser.helper.js";
+/** Parses a long option token from the token stream. */
+export function parseLongOption(tokens, index, definitions, values, allowUnknownOptions) {
+    const token = tokens[index];
+    const raw = token.slice(CLI_OPTION_PREFIXES.LONG.length);
+    if (raw === "") {
+        throw new InvalidOptionError(token);
+    }
+    const separatorIndex = raw.indexOf(CLI_OPTION_PREFIXES.VALUE_SEPARATOR);
+    let name = separatorIndex >= 0 ? raw.slice(0, separatorIndex) : raw;
+    let value = separatorIndex >= 0 ? raw.slice(separatorIndex + 1) : undefined;
+    let negated = false;
+    if (name.startsWith("no-")) {
+        const candidate = name.slice(3);
+        const definition = findOption(candidate, definitions);
+        if (definition?.type === "boolean") {
+            name = candidate;
+            negated = true;
+        }
+    }
+    const definition = findOption(name, definitions);
+    if (!definition && !allowUnknownOptions) {
+        throw new InvalidOptionError(token);
+    }
+    if (!definition) {
+        if (value === undefined &&
+            tokens[index + 1] &&
+            tokens[index + 1] !== "--" &&
+            !isOption(tokens[index + 1])) {
+            value = tokens[index + 1];
+            values[name] = value;
+            return index + 2;
+        }
+        values[name] = value ?? true;
+        return index + 1;
+    }
+    if (definition.type === "boolean") {
+        values[definition.name] = negated
+            ? false
+            : value === undefined
+                ? true
+                : parseBoolean(value, definition.name);
+        return index + 1;
+    }
+    if (value === undefined) {
+        if (tokens[index + 1] === undefined || tokens[index + 1] === "--") {
+            throw new MissingOptionValueError(token);
+        }
+        value = tokens[index + 1];
+        assignOptionValue(definition, value, values);
+        return index + 2;
+    }
+    assignOptionValue(definition, value, values);
+    return index + 1;
+}
+/** Finds an option by name or short form. */
+export function findOption(name, definitions) {
+    return definitions.find((d) => d.name === name || d.short === name);
+}
+/** Assigns a parsed value to the option, handling multiples. */
+export function assignOptionValue(definition, rawValue, values) {
+    const value = parseOptionValue(definition, rawValue);
+    if (definition.multiple) {
+        const existing = values[definition.name];
+        if (Array.isArray(existing)) {
+            existing.push(value);
+        }
+        else if (existing !== undefined) {
+            values[definition.name] = [existing, value];
+        }
+        else {
+            values[definition.name] = [value];
+        }
+    }
+    else {
+        values[definition.name] = value;
+    }
+}
+//# sourceMappingURL=cliParser.longOption.js.map

package/dist/src/cliParser/cliParser.longOption.js.map

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

package/dist/src/cliParser/cliParser.shortOption.d.ts

@@ -0,0 +1,9 @@
+/**
+ * zudojs-cli — Short Option Parser
+ *
+ * Parses `-v`, `-p 3000`, `-p3000`, and grouped `-abc` style arguments.
+ */
+import type { CLIOption } from "../cliType/cliType.type.js";
+/** Parses a short option token from the token stream. */
+export declare function parseShortOption(tokens: readonly string[], index: number, definitions: readonly CLIOption[], values: Record<string, unknown>, allowUnknownOptions: boolean): number;
+//# sourceMappingURL=cliParser.shortOption.d.ts.map

package/dist/src/cliParser/cliParser.shortOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliParser.shortOption.d.ts","sourceRoot":"","sources":["../../../src/cliParser/cliParser.shortOption.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAQ5D,yDAAyD;AACzD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,SAAS,SAAS,EAAE,EACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,mBAAmB,EAAE,OAAO,GAC3B,MAAM,CA6ER"}

package/dist/src/cliParser/cliParser.shortOption.js

@@ -0,0 +1,79 @@
+/**
+ * zudojs-cli — Short Option Parser
+ *
+ * Parses `-v`, `-p 3000`, `-p3000`, and grouped `-abc` style arguments.
+ */
+import { CLI_OPTION_PREFIXES } from "../cliConstant/cliConstant.value.js";
+import { InvalidOptionError, MissingOptionValueError, } from "../cliError/cliError.option.js";
+import { findOption, assignOptionValue } from "./cliParser.longOption.js";
+/** Parses a short option token from the token stream. */
+export function parseShortOption(tokens, index, definitions, values, allowUnknownOptions) {
+    const token = tokens[index];
+    const raw = token.slice(CLI_OPTION_PREFIXES.SHORT.length);
+    if (raw === "") {
+        throw new InvalidOptionError(token);
+    }
+    if (raw.length > 1) {
+        const firstChar = raw[0];
+        const firstDefinition = findShortOption(firstChar, definitions);
+        if (firstDefinition?.type !== "boolean") {
+            const attachedValue = raw.slice(1);
+            if (firstDefinition) {
+                assignOptionValue(firstDefinition, attachedValue, values);
+                return index + 1;
+            }
+            if (allowUnknownOptions) {
+                values[firstChar] = attachedValue;
+                return index + 1;
+            }
+            throw new InvalidOptionError(token);
+        }
+        for (let offset = 0; offset < raw.length; offset++) {
+            const short = raw[offset];
+            const definition = findShortOption(short, definitions);
+            if (!definition) {
+                if (!allowUnknownOptions) {
+                    throw new InvalidOptionError(`-${short}`);
+                }
+                values[short] = true;
+                continue;
+            }
+            if (definition.type !== "boolean") {
+                const attachedValue = raw.slice(offset + 1);
+                if (attachedValue) {
+                    assignOptionValue(definition, attachedValue, values);
+                    return index + 1;
+                }
+                if (tokens[index + 1] === undefined) {
+                    throw new MissingOptionValueError(`-${short}`);
+                }
+                assignOptionValue(definition, tokens[index + 1], values);
+                return index + 2;
+            }
+            values[definition.name] = true;
+        }
+        return index + 1;
+    }
+    const definition = findShortOption(raw, definitions);
+    if (!definition) {
+        if (!allowUnknownOptions) {
+            throw new InvalidOptionError(token);
+        }
+        values[raw] = true;
+        return index + 1;
+    }
+    if (definition.type === "boolean") {
+        values[definition.name] = true;
+        return index + 1;
+    }
+    if (tokens[index + 1] === undefined) {
+        throw new MissingOptionValueError(token);
+    }
+    assignOptionValue(definition, tokens[index + 1], values);
+    return index + 2;
+}
+/** Finds an option by its short flag. */
+function findShortOption(short, definitions) {
+    return definitions.find((d) => d.short === short);
+}
+//# sourceMappingURL=cliParser.shortOption.js.map

package/dist/src/cliParser/cliParser.shortOption.js.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * zudojs-cli — CLI Parser
+ *
+ * Argument parsing, option resolution, and token classification.
+ */
+export { CLIParser, type CLIParserOptions } from "./cliParser.core.js";
+export { parseLongOption, findOption, assignOptionValue, } from "./cliParser.longOption.js";
+export { parseShortOption } from "./cliParser.shortOption.js";
+export { parseCLIArguments, parseOptionValue, parseBoolean, isOption, isLongOption, isShortOption, resolveCommand, normalizeCLIValue, } from "./cliParser.helper.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cliParser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EACL,eAAe,EACf,UAAU,EACV,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,cAAc,EACd,iBAAiB,GAClB,MAAM,uBAAuB,CAAC"}

package/dist/src/cliParser/index.js

@@ -0,0 +1,10 @@
+/**
+ * zudojs-cli — CLI Parser
+ *
+ * Argument parsing, option resolution, and token classification.
+ */
+export { CLIParser } from "./cliParser.core.js";
+export { parseLongOption, findOption, assignOptionValue, } from "./cliParser.longOption.js";
+export { parseShortOption } from "./cliParser.shortOption.js";
+export { parseCLIArguments, parseOptionValue, parseBoolean, isOption, isLongOption, isShortOption, resolveCommand, normalizeCLIValue, } from "./cliParser.helper.js";
+//# sourceMappingURL=index.js.map